设置ip访问规则接口
更新时间：2024-10-22
接口
本接口用于设置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白名单
PUT /v2/abroad/domain/test.bcecdn.com/config?ipACL HTTP/1.1
Host: cdn.baidubce.com
User-Agent: curl/7.73.0
Accept: */*
Authorization: bce-auth-v1/e2824756xxxx4718add0cd7e7db47101/2021-03-05T09:04:01Z/1800/host/f55efb709f63ccda8c4619cee52efaf443ce929422c1c713007330bf3a3ad433
x-bce-date: 2021-03-05T09:04:01Z
x-bce-request-id: 4d0826ef-2296-4b46-bf46-18d6285024c8
Content-Length: 67
Content-Type: application/x-www-form-urlencoded
{
"ipACL": {
"whiteList": ["1.1.1.1"]
}
}请求示例2：设置IP黑名单
PUT /v2/abroad/domain/test.coding365x24.com/config?ipACL HTTP/1.1
Host: cdn.baidubce.com
User-Agent: curl/7.73.0
Accept: */*
Authorization: bce-auth-v1/e2824756cd114718add0cd7e7db47101/2021-03-05T09:12:56Z/1800/host/7b96ec731cc8fe68f323169a8d6cf6489aab84692e280e4b78a98ee2479fc07c
x-bce-date: 2021-03-05T09:12:56Z
x-bce-request-id: 19a4c10c-cd81-4dda-9dda-bcfbd645998e
Content-Length: 90
Content-Type: application/x-www-form-urlencoded
{
"ipACL": {
"blackList": ["1.1.1.1", "64.8.12.0/24"]
}
}响应示例
HTTP/1.1 200 OK
Server: nginx/1.12.0
Date: Fri, 05 Mar 2021 09:05:22 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.1.5
x-bce-request-id: 4d0826ef-2296-4b46-bf46-18d6285024c8
{
"status": "RUNNING"
}