调用AddIpControlPolicyItem向某个已存在的IP访问控制增加一条策略。
调用该接口时请注意:
- 此功能面向API提供者。
- 增加该策略后,所有绑定该访问控制的API,即时生效。
- 一个IP访问控制下最多添加100条策略。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
CidrIp | String | 是 | 113.125.1.101;101.11.1.1 |
具体策略的IP或者IP段,多个请用英文分号(;)分割,最多添加10个。 |
IpControlId | String | 是 | 7ea91319a34d48a09b5c9c871d9768b1 |
IP访问控制的ID,代表了唯一的IP控制策略。 |
Action | String | 否 | AddIpControlPolicyItem |
操作接口名,系统规定参数,取值:AddIpControlPolicyItem。 |
AppId | String | 否 | 1111111 |
指定策略限制的AppId,只有控制类型为白名单(即IpControlType为ALLOW)时,才可同时增加AppId的限制。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PolicyItemId | String | P151617000829241 |
该策略的唯一ID |
RequestId | String | CEF72CEB-54B6-4AE8-B225-F876FF7BZ004 |
请求ID |
示例
请求示例
https://apigateway.cn-qingdao.aliyuncs.com/?Action=AddIpControlPolicyItem
&IpControlId=7ea91319a34d48a09b5c9c871d9768b1
&CidrIp=113.125.1.101;101.11.1.1
&AppId=1111111
&<公共请求参数>
正常返回示例
XML
格式
<AddIpControlPolicyItemResponse>
<RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BZ004</RequestId>
<PolicyItemId>P151617000829241</PolicyItemId>
</AddIpControlPolicyItemResponse>
JSON
格式
{
"PolicyItemId":"P151617000829241",
"RequestId":"CEF72CEB-54B6-4AE8-B225-F876FF7BZ004"
}
错误码
访问错误中心查看更多错误码。