所有文档

          内容分发网络 CDN

          设置访问IP控制

          接口

          本接口用于设置域名的IP控制。

          Method Path 说明
          PUT /v2/domain/{domain}/config?ipACL 设置访问IP配置

          domain:修改配置的CDN加速域名。

          请求体(Request Body)

          参数 可选 类型 说明
          ipACL 必选 ipACL 访问IP配置规则

          ipACL类型如下:

          参数 可选 类型 说明
          blackList 可选 list IP黑名单列表,支持CIDR格式表示的IP段
          whiteList 可选 list IP白名单列表,支持CIDR格式表示的IP段

          blackList和whiteList不可同时存在。

          响应码 (Http Status Code)

          HTTP Status Code 说明
          200 成功
          400 更新失败,参数错误等

          请求示例1

          设置IP黑名单,CDN获取客户端IP,发现客户端IP包含在黑名单列表里面,则对请求进行拒绝,以下示例展示了设置"1.1.1.2"和"1.1.1.3"为2个黑名单IP。

          PUT /v2/domain/myself.baidu.com/config?ipACL HTTP/1.1
          Host: cdn.baidubce.com
          Content-Length: 45
          Content-Type: text/json;utf-8
           
          {
              "ipACL":{
                  "blackList":[
                      "1.1.1.2",
                      "1.1.1.3"
                  ]
              }
          }

          请求示例2

          设置IP白名单,CDN获取客户端IP,发现客户端IP包含在白名单列表里面,则允许请求,以下示例展示了添加一个CIDR形式的IP添加到白名单列表中。

          PUT /v2/domain/myself.baidu.com/config?ipACL HTTP/1.1
          Host: cdn.baidubce.com
          Content-Length: 38
          Content-Type: text/json;utf-8
           
          {
              "ipACL":{
                  "whiteList":[
                      "1.2.3.4/24"
                  ]
              }
          }

          响应示例

          HTTP/1.1 200 OK
          Content-Type: application/json; charset=utf-8
          Transfer-Encoding: chunked
          
          {"status":"RUNNING"}
          上一篇
          查询访问Referer控制
          下一篇
          查询访问IP控制