调用ModifyControlPolicyPosition接口,修改互联网边界防火墙IPv4访问控制策略(表示访问控制策略中的访问源IP、目的IP使用IPv4格式)的优先级。

使用说明

本接口一般用于修改互联网边界防火墙IPv4访问控制策略的优先级。暂不支持以调用接口的方式修改互联网边界防火墙IPv6访问控制策略的优先级。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyControlPolicyPosition

系统规定参数。取值:ModifyControlPolicyPosition

SourceIp String 192.0.XX.XX

访问者源IP地址。

Lang String zh

接收消息的语言类型。取值:

  • zh(默认):中文。
  • en:英文。
Direction String in

互联网边界防火墙IPv4访问控制策略的流量方向。取值:

  • in:外对内流量。
  • out:内对外流量。
NewOrder String 1

为互联网边界防火墙IPv4访问控制策略设置一个新的优先级。

优先级使用数字表示,输入数字1表示优先级最高,数字越大优先级越低。

说明 新的优先级数字不能超出您已创建的互联网边界防火墙IPv4策略优先级的范围,否则会导致调用该接口时出错。

建议您在调用该接口前,先调用DescribePolicyPriorUsed查询互联网边界防火墙指定流量方向的IPv4策略优先级范围。

OldOrder String 5

要修改的互联网边界防火墙IPv4访问控制策略当前的优先级。

返回数据

名称 类型 示例值 描述
RequestId String 850A84D6-0DE4-4797-A1E8-00090125EEB1

本次请求的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyControlPolicyPosition
&SourceIp=192.0.XX.XX
&Lang=zh
&Direction=in
&NewOrder=1
&OldOrder=5
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 ErrorParametersUid The aliUid parameter is invalid. aliUid 不合法
400 ErrorParameterIpVersion The IP version is invalid. IP版本参数错误
400 ErrorParametersDirection The direction is invalid. 无效的方向
400 ErrorDBSelect An error occurred while querying database. 内部错误:数据库查询错误
400 ErrorParameters A parameter error occurred. 参数错误
400 ErrorParametersNewOrder The newOrder is invalid. 无效的newOrder
400 ErrorParametersOldOrder The oldOrder is invalid. 无效的oldOrder
400 ErrorDBDelete An error occurred while deleting the database. 内部错误:数据库删除错误
400 ErrorDBInsert An error occurred while performing an insert operation in the database. 内部错误:数据库插入错误
400 ErrorRecordLog An error occurred while updating the operation log. 写日志失败

访问错误中心查看更多错误码。