Modifies the priority of an IPv4 access control policy for the Internet firewall. An IPv4 access control policy indicates that the source and destination IP addresses of requests are IPv4 CIDR blocks.

Description

You can call the ModifyControlPolicyPosition operation to modify the priority of an IPv4 access control policy for the Internet firewall. No API operations are provided for you to modify the priority of an IPv6 access control policy for the Internet firewall.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyControlPolicyPosition

The operation that you want to perform. Set the value to ModifyControlPolicyPosition.

Direction String Yes in

The direction of the traffic to which the IPv4 access control policy applies. Valid values:

  • in: inbound traffic
  • out: outbound traffic
NewOrder String Yes 1

The new priority of the IPv4 access control policy.

You must specify a numeric value for this parameter. The value 1 indicates the highest priority. A larger value indicates a lower priority.

Note The value of this parameter must be within the priority range of existing IPv4 access control policies. Otherwise, an error occurs when you call this operation.

We recommend that you first call the DescribePolicyPriorUsed operation to query the priority range of existing IPv4 access control policies that apply to the traffic of the specified direction.

OldOrder String Yes 5

The original priority of the IPv4 access control policy.

SourceIp String No 192.0.XX.XX

The source IP address of the request.

Lang String No zh

The natural language of the request and response. Valid values:

  • zh: Chinese (default)
  • en: English

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
RequestId String 850A84D6-0DE4-4797-A1E8-00090125EEB1

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ModifyControlPolicyPosition
&Direction=in
&NewOrder=1
&OldOrder=5
&<Common request parameters>

Sample success responses

XML format

<ModifyControlPolicyPositionResponse>
  <RequestId>850A84D6-0DE4-4797-A1E8-00090125EEB1</RequestId>
</ModifyControlPolicyPositionResponse>

JSON format

{
    "RequestId": "850A84D6-0DE4-4797-A1E8-00090125EEB1"
}