设置访问IP控制
更新时间:2020-10-13
接口
本接口用于设置域名的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"}