全部产品
云市场

增加IP访问控制策略 (AddIpControlPolicyItem)

更新时间:2018-02-25 10:47:05

描述

向某个已存在的IP访问控制增加一条策略

  • 此功能面向API提供者
  • 增加该策略后,所有绑定该访问控制的API,即时生效
  • 一个IP访问控制下最多添加100条策略

请求参数

名称 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:AddIpControlPolicyItem
IpControlId String IP访问控制的ID,代表了唯一的IP控制策略
CidrIp String 具体策略的IP或者IP段,多个请用英文分号(;)分割,最多添加10个
AppId String 指定策略限制的AppId,只有控制类型为白名单(即 IpControlType为ALLOW)时,才可同时增加AppId的限制。
  • 一次只能增加一个;
  • 为空表示没有AppId的限制;
  • 当该值不为空,表示在有IP限制的同时,还限制访问的AppId;
  • 请注意:当该值不为空,如果API的安全认证为“无认证”,将限制所有的API调用;
  • 当黑名单(IpControlType为REFUSE)时,该值不为空,API网关会自动忽略该值,只设置IP的限制;

返回参数

名称 类型 描述
RequestId String 本次请求编号
PolicyItemId String 该策略的唯一ID

示例

请求示例

  1. https://apigateway.cn-qingdao.aliyuncs.com/?Action=AddIpControlPolicyItem
  2. &IpControlId=7ea91319a34d48a09b5c9c871d9768b1
  3. &CidrIp=113.125.1.101;101.11.1.1
  4. &AppId=1111111
  5. &<公共请求参数>

返回示例

XML格式

  1. <CreateSignatureResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BZ004</RequestId>
  3. <PolicyItemId>P151617000829241</PolicyItemId>
  4. </CreateSignatureResponse>

JSON格式

  1. {
  2. "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BZ004",
  3. "PolicyItemId":"P151617000829241"
  4. }