ModifyControlPolicyPosition - Cloud Firewall - Alibaba Cloud Documentation Center

Note

This API has been deprecated. We recommend migrating to Cloudfw(2017-12-07) - ModifyControlPolicyPriority for enhanced functionality and continued support. While the deprecated API remains temporarily accessible, no further updates or bug fixes will be provided.

Operation description

You can call this operation to modify the priority of an IPv4 access control policy for the Internet firewall. This operation does not support modifying the priority of IPv6 access control policies.

QPS limit

The queries per second (QPS) limit for this operation is 10 for each user. If you exceed the limit, API calls are throttled, which can affect your business. We recommend that you call this operation within this limit.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
SourceIp `deprecated`	string	No	The source IP address of the visitor.	192.0.XX.XX
Lang	string	No	The language of the response message. Valid values: zh (default): Chinese. en: English.	zh
Direction	string	Yes	The traffic direction of the IPv4 access control policy for the Internet firewall. Valid values: in: inbound traffic. out: outbound traffic.	in
NewOrder	string	Yes	The new priority for the IPv4 access control policy of the Internet firewall. The priority is a number. A smaller number indicates a higher priority. The value 1 indicates the highest priority. Note The new priority value cannot be outside the range of existing priorities for IPv4 policies. Otherwise, the API call fails. Before you call this operation, call DescribePolicyPriorUsed to query the priority range of IPv4 policies for a specific traffic direction.	1
OldOrder	string	Yes	The current priority of the IPv4 access control policy that you want to modify.	5

Response elements

Element	Type	Description	Example
	object
RequestId	string	The ID of the request.	850A84D6-0DE4-4797-A1E8-00090125EEB1

Examples

Success response

JSON format

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

Error codes

HTTP status code	Error code	Error message	Description
400	ErrorParametersUid	The aliUid parameter is invalid.	The aliUid parameter is invalid.
400	ErrorParameterIpVersion	The IP version is invalid.	The IP version is invalid.
400	ErrorParametersDirection	The direction is invalid.	The direction is invalid.
400	ErrorDBSelect	An error occurred while querying database.	An error occurred while querying database.
400	ErrorParameters	A parameter error occurred.	A parameter error occurred.
400	ErrorParametersNewOrder	The newOrder is invalid.	The newOrder is invalid.
400	ErrorParametersOldOrder	The oldOrder is invalid.	The oldOrder is invalid.
400	ErrorDBDelete	An error occurred while deleting the database.	An error occurred while deleting the database.
400	ErrorDBInsert	An error occurred while performing an insert operation in the database.	An error occurred while performing an insert operation in the database.
400	ErrorRecordLog	An error occurred while updating the operation log.	An error occurred while updating the operation log.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.