设置访问IP控制
更新时间：2021-01-25
接口
本接口用于设置域名的IP控制。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/dsa/domain/{domain}/config?action=setIPAcl | 设置访问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/dsa/domain/myself.baidu.com/config?action=setIPAcl 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/dsa/domain/myself.baidu.com/config?action=setIPAcl 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"}