Querying a List of Rules
Function
This API is used to query all rules.
URI
GET /v2/{project_id}/routemgr/rules?{name=xxx,limit=xxx,offset=xxx}
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
name |
No |
String |
Rule name. |
limit |
No |
Integer |
Maximum number of records that can be returned. |
offset |
No |
Integer |
Offset. The records after this offset will be queried. |
Request
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
Content-Type |
Yes |
String |
Message body type (format). The default value application/json is recommended. |
X-Auth-Token |
Yes |
String |
User token. The token can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. |
Response
When the status code is 200, the response parameters are as follows:
Parameter |
Type |
Description |
---|---|---|
count |
Long |
Number of rules that meet the conditions. |
rules |
Array of RuleResponse objects |
Rule list. |
Parameter |
Type |
Description |
---|---|---|
created_at |
String |
Creation time. |
description |
String |
Rule description. The value contains a maximum of 255 characters. The following characters are not allowed: ^~#$%&*<>()[]{}'"\ |
fail_messages |
Integer |
Number of messages that fail to be forwarded. |
id |
String |
Rule ID. |
ief_instance_id |
String |
Platinum edition instance ID. This parameter is left blank for a professional edition instance. |
in_using |
Boolean |
Whether to enable the rule. The default value is true, indicating that the rule is enabled. |
name |
String |
Rule name. The value contains a maximum of 64 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. The rule name must be unique in the account. |
project_id |
String |
Project ID. |
source |
EndpointResponse object |
Source endpoint information. |
source_resource |
Map<String,Object> |
Source endpoint resource. Example:
|
success_messages |
Integer |
Number of messages that are successfully forwarded. |
target |
EndpointResponse object |
Destination endpoint information. |
target_resource |
Map<String,Object> |
Destination endpoint resource. Example:
|
updated_at |
String |
Update time. |
Parameter |
Type |
Description |
---|---|---|
created_at |
String |
Creation time. |
description |
String |
Endpoint description. The value contains a maximum of 255 characters. The following characters are not allowed: ^~#$%&*<>()[]{}'"\ |
id |
String |
Endpoint ID. |
ief_instance_id |
String |
Platinum edition instance ID. This parameter is left blank for a professional edition instance. |
is_shared |
Boolean |
Whether the endpoint is shared. |
name |
String |
Endpoint name. The value contains a maximum of 64 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. The endpoint name must be unique in the account. |
project_id |
String |
Project ID. |
properties |
Map<String,Object> |
Endpoint properties to be displayed. Example:
|
type |
String |
Endpoint type. The options are as follows:
|
updated_at |
String |
Update time. |
When the status code is 401, the response parameters are as follows.
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. |
error_message |
String |
Error message. |
When the status code is 500, the response parameters are as follows:
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. |
error_message |
String |
Error message. |
Example Request
None
Example Response
None
Status Codes
Status Code |
Description |
---|---|
200 |
Query succeeded. |
401 |
Error response. |
500 |
Error response. |
Error Codes
For details, see Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot