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

This operation modifies the priority of an IPv4 access control policy for an Internet firewall. You cannot use this operation to modify the priority of an IPv6 access control policy.

QPS limit

This operation has a queries per second (QPS) limit of 10 for each user. If you exceed this limit, API calls are throttled. This throttling can affect your business. Call this operation at a reasonable rate.

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.	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. Priorities are represented by numbers. A smaller number indicates a higher priority. The value 1 indicates the highest priority. Note The new priority must be within the range of existing priorities for IPv4 policies. If the new priority is outside this range, the API call fails. Before calling this API, call DescribePolicyPriorUsed to query the priority range for IPv4 policies in the specified 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.