设置访问IP控制
更新时间：2025-08-04
百度 “以前办这个许可证，要到镇里交材料，材料不全，还得来回跑。
接口
本接口用于设置域名的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。
Text
1PUT /v2/domain/myself.baidu.com/config?ipACL HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 45
4Content-Type: text/json;utf-8
5
6{
7 "ipACL":{
8 "blackList":[
9 "1.1.1.2",
10 "1.1.1.3"
11 ]
12 }
13}请求示例2
设置IP白名单，CDN获取客户端IP，发现客户端IP包含在白名单列表里面，则允许请求，以下示例展示了添加一个CIDR形式的IP添加到白名单列表中。
Text
1PUT /v2/domain/myself.baidu.com/config?ipACL HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 38
4Content-Type: text/json;utf-8
5
6{
7 "ipACL":{
8 "whiteList":[
9 "1.2.3.4/24"
10 ]
11 }
12}响应示例
Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Transfer-Encoding: chunked
4
5{"status":"RUNNING"}