查询域名详情接口
更新时间：2025-08-21
接口
本接口用于查询域名详情。
查询域名的所有配置项：
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/abroad/domain/{domain}/config | 查询域名的所有配置项 |
响应码(Http Status Code)
| Http Status Code | 说明 |
|---|---|
| 200 | 查询成功 |
| 400 | 不属于当前用户 |
响应体(Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| domain | string | 加速域名 |
| cname | string | 为加速域名生成的一个CNAME域名，需要在域名解析服务商处将加速域名CNAME解析到该域名 |
| status | string | 加速域名运行状态:RUNNING、STOPPED、OPERATING |
| createTime | Timestamp | 域名创建时间 |
| lastModifyTime | Timestamp | 上次修改时间 |
| originConfig | OriginConfig[] | 源站配置 |
| cacheTtl | cacheTtl[] | 缓存配置 |
| originHost | string | 回源Host |
| refererACL | refererACL | referer黑白名单 |
| ipACL | ipACL | ip黑白名单 |
| cacheFullUrl | boolean | 缓存参数规则 |
| originProtocol | string | 回源协议，http或https |
OriginConfig 类型如下:
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| type | 必选 | string | 源站类型，合法值为 IP 和 DOMAIN |
| backup | 必选 | boolean | 是否为备选源站 |
| addr | 必选 | string | 源站地址 |
cacheTtl类型如下:
| 字段 | 可选 | 类型 | 说明 |
|---|---|---|---|
| type | 否 | string | 规则类型，合法值为 path（目录）、exactPath（具体uri）、suffix（后缀） |
| vlaue | 否 | string | 路径值 |
| ttl | 否 | int | 缓存时间（秒） |
| weight | 否 | int | 权重。当存在规则覆盖且权重相同时，随机生效一个规则，否则权重较大的规则生效 |
| override_origin | 是 | boolean | 是否覆盖源站的缓存规则 |
refererACL 类型如下:
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| blackList | 否 | list | 黑名单 |
| whiteList | 否 | list | 白名单 |
| allowEmpty | 否 | boolean | 允许空referer |
ipACL 类型如下:
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| whiteList | 必选 | String类型list | ip白名单列表 |
| blackList | 必选 | String类型list | ip黑名单列表,支持CIDR格式表示的IP段 |
请求示例
Plain Text
1GET /v2/abroad/domain/test.bcecdn.com/config HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 0
4Authorization: bce-auth-v2...响应示例
Plain Text
1{
2 "domain": "test.bcecdn.com",
3 "cname": "test.bcecdn.com.g0.bdydns.com",
4 "status": "RUNNING",
5 "createTime": "2024-01-12 16:10:45",
6 "lastModifyTime": "2024-04-24 17:27:12",
7 "originConfig": [
8 {
9 "type": "IP",
10 "backup": false,
11 "addr": "182.61.128.134"
12 }
13 ],
14 "cacheTtl": [
15 {
16 "ttl": 0,
17 "type": "path",
18 "value": "/",
19 "weight": 2,
20 "override_origin": true
21 },
22 {
23 "ttl": 0,
24 "type": "suffix",
25 "value": ".php;.jsp;.asp",
26 "weight": 3,
27 "override_origin": true
28 }
29 ],
30 "originProtocol": "http",
31 "https": {
32 "enabeld": false
33 },
34 "ipACL": {
35 "blackList": [
36 "1.1.1.2",
37 "64.8.12.3/25"
38 ]
39 },
40 "refererACL": {
41 "blackList": [
42 "www.example.com"
43 ],
44 "allowEmpty": true
45 },
46 "originHost": "test.bcecdn.com",
47 "cacheFullUrl": false,
48 "tags": [
49 {
50 "tagKey": "abroad",
51 "tagValue": "test"
52 }
53 ]
54}