设置ip访问规则接口
更新时间：2025-08-21
接口
本接口用于设置ip访问规则接口。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/abroad/domain/{domain}/config?ipACL | 设置访问ip控制 |
请求体(Request Body)
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| ipACL | 必选 | ipACL | 设置ip访问规则 |
- ipACL字段说明：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| whiteList | 必选 | String类型list | ip白名单列表,支持CIDR格式表示的IP段 |
| blackList | 必选 | String类型list | ip黑名单列表,支持CIDR格式表示的IP段 |
- 配置网段时，网段“IP/掩码”中的IP必须是该网段IP区间首个主机IP地址
- blackList和whiteList不可同时存在。
响应码(Http Status Code)
| Http Status Code | 说明 |
|---|---|
| 200 | 配置成功 |
| 400 | 格式错误 |
请求示例1：设置IP白名单
Plain Text
1PUT /v2/abroad/domain/test.bcecdn.com/config?ipACL HTTP/1.1
2Host: cdn.baidubce.com
3User-Agent: curl/7.73.0
4Accept: */*
5Authorization: bce-auth-v1/e2824756xxxx4718add0cd7e7db47101/2021-03-05T09:04:01Z/1800/host/f55efb709f63ccda8c4619cee52efaf443ce929422c1c713007330bf3a3ad433
6x-bce-date: 2021-03-05T09:04:01Z
7x-bce-request-id: 4d0826ef-2296-4b46-bf46-18d6285024c8
8Content-Length: 67
9Content-Type: application/x-www-form-urlencoded
10
11{
12 "ipACL": {
13 "whiteList": ["1.1.1.1"]
14 }
15}请求示例2：设置IP黑名单
Plain Text
1PUT /v2/abroad/domain/test.coding365x24.com/config?ipACL HTTP/1.1
2Host: cdn.baidubce.com
3User-Agent: curl/7.73.0
4Accept: */*
5Authorization: bce-auth-v1/e2824756cd114718add0cd7e7db47101/2021-03-05T09:12:56Z/1800/host/7b96ec731cc8fe68f323169a8d6cf6489aab84692e280e4b78a98ee2479fc07c
6x-bce-date: 2021-03-05T09:12:56Z
7x-bce-request-id: 19a4c10c-cd81-4dda-9dda-bcfbd645998e
8Content-Length: 90
9Content-Type: application/x-www-form-urlencoded
10
11{
12 "ipACL": {
13 "blackList": ["1.1.1.1", "64.8.12.0/24"]
14 }
15}响应示例
Plain Text
1HTTP/1.1 200 OK
2Server: nginx/1.12.0
3Date: Fri, 05 Mar 2021 09:05:22 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7X-Powered-By: PHP/7.1.5
8x-bce-request-id: 4d0826ef-2296-4b46-bf46-18d6285024c8
9
10{
11 "status": "RUNNING"
12}