Setting the Priority of an ACL Protection Rule

Function

This API is used to set the priority of an ACL protection rule.

URI

PUT /v1/{project_id}/acl-rule/order/{acl_rule_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID
acl_rule_id	Yes	String	Rule ID

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise project id, the id generated by the enterprise project after the user supports the enterprise project.
fw_instance_id	No	String	Firewall instance ID, which is automatically generated after a CFW instance is created. You can obtain the ID by calling the API used for querying a firewall instance. For details, see the API Explorer and Help Center FAQ.By default, if fw_instance_Id is not specified, information about the first firewall under the account is returned. If fw_instance_Id is specified, information about the firewall with this fw_instance_Id is returned.If object_Id is specified, information about the firewall with this object_Id is returned by default. If both fw_instance_Id and object_Id are specified, the specified object_Id must belong to the specified firewall.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. It 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 a token.

**Table 4** Request body parameters
Parameter	Mandatory	Type	Description
dest_rule_id	No	String	ID of the rule that the added rule will follow. This parameter cannot be left blank if the rule is not pinned on top, and is empty when the added rule is pinned on top.
top	No	Integer	Whether to pin on top. The options are as follows: 0: no; 1: yes.
bottom	No	Integer	Whether to pin on bottom. The options are as follows: 0: no; 1: yes.

Response Parameters

Status code: 200

**Table 5** Response body parameters
Parameter	Type	Description
data	RuleId object	Rule ID list

**Table 6** RuleId
Parameter	Type	Description
id	String	id
name	String	name

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code Minimum: 8 Maximum: 36
error_msg	String	Description Minimum: 2 Maximum: 512

Example Requests

Set the rule with the rule id of ffe9af47-d893-483b-86e3-ee5242e8cb15 in the project id9d80d070b6d44942af73c9c3d38e0429 under the rule with the id of 69c32dc5-f801-4294-98ee-978b51f97d35

https://{Endpoint}/v1/9d80d070b6d44942af73c9c3d38e0429/acl-rule/order/ffe9af47-d893-483b-86e3-ee5242e8cb15

{
  "top" : 0,
  "dest_rule_id" : "69c32dc5-f801-4294-98ee-978b51f97d35"
}

Example Responses

Status code: 200

Rule sorting response

{
  "data" : {
    "id" : "ffe9af47-d893-483b-86e3-ee5242e8cb15"
  }
}

Status code: 400

Bad Request

{
  "error_code" : "CFW.00200005",
  "error_msg" : "operation content does not exist"
}

Status Codes

Status Code	Description
200	Rule sorting response
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error

Error Codes

See Error Codes.

Parent topic: ACL Rule Management

14 KiB Raw Blame History