设置区域封禁配置
更新时间：2026-04-27
接口
本接口用于设置域名的区域封禁配置。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/domain/{domain}/config?geoAcl |
设置区域封禁配置 |
domain：CDN 加速域名
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| geoAcl | 必选 | Object / null | 区域封禁配置规则，设为 null 表示关闭区域封禁。参数项解释如下：- blackList：可选，list 类型，区域黑名单列表，列表中的区域将被禁止访问。- whiteList：可选，list 类型，区域白名单列表，仅列表中的区域允许访问。- use_x_real_ip：可选，bool 类型，是否使用 X-Real-IP 头进行区域判断，默认为 false。 |
注意：
blackList和whiteList不可同时存在，且必须至少指定其中一个。- 区域代码为 ISO 3166-1 alpha-2 标准的小写国家/地区代码，如
cn（中国）、us（美国）、jp（日本）等。 - 可通过
GET /v2/utils/geoList接口获取所有支持的区域代码及名称。 geoAcl设置为null时，表示关闭区域封禁配置。
请求示例1——设置黑名单（禁止指定区域访问）
Http
1PUT /v2/domain/example.baidu.com/config?geoAcl HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: application/json
4
5{
6 "geoAcl": {
7 "blackList": ["cn", "us"]
8 }
9}请求示例2——设置白名单（仅允许指定区域访问）
Http
1PUT /v2/domain/example.baidu.com/config?geoAcl HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: application/json
4
5{
6 "geoAcl": {
7 "whiteList": ["cn", "jp", "kr"]
8 }
9}请求示例3——使用 X-Real-IP 进行区域判断
Http
1PUT /v2/domain/example.baidu.com/config?geoAcl HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: application/json
4
5{
6 "geoAcl": {
7 "blackList": ["us"],
8 "use_x_real_ip": true
9 }
10}请求示例4——关闭区域封禁
Http
1PUT /v2/domain/example.baidu.com/config?geoAcl HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: application/json
4
5{
6 "geoAcl": null
7}响应示例
Http
1HTTP/1.1 200 OK
2Content-Type: application/json
3x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
4
5{
6 "status": "RUNNING"
7}评价此篇文章