查询加速域名详情接口
更新时间：2025-08-21
接口
本接口用于查询加速域名的详细配置信息。
| Method | Path | Action |
|---|---|---|
| GET | /v2/domain/{domain}/config | 获取指定加速域名配置的基本信息 |
domain:需要查询CDN的加速域名。
响应码 (Http Status Code)
| HTTP Status Code | 说明 |
|---|---|
| 200 | 查询成功 |
| 400 | 请求错误 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| domain | string | 接入CDN进行加速的域名 |
| cname | string | 为加速域名生成的一个CNAME域名，需要在域名解析服务商处将加速域名CNAME解析到该域名 |
| status | string | 加速域名运行状态:RUNNING、STOPPED |
| createTime | timestamp | 域名创建时间，UTC时间 |
| lastModifyTime | timestamp | 最近修改时间，UTC时间 |
| isBan | string | 是否封禁：NO表示未封禁，YES表示已封禁 |
| form | string | "default"表示默认类型，"image"表示图片小文件，"download"表示大文件下载，"media"表示流媒体点播，"dynamic"表示动静态加速 |
| origin | list |
源站配置 |
| defaultHost | string | 默认回源host，当源站级别host不存在时，使用域名级别的默认host |
| cacheTTL | list |
文件类型与路径的缓存策略 |
| limitRate | int | 下载限速，单位Byte/s |
| requestAuth | requestAuth | 访问鉴权配置 |
| https | HTTPSConfig | HTTPS加速配置 |
| followProtocol | bool | 是否开启了协议跟随回源 |
| seoSwitch | seoSwitch | seo 开关配置 |
| tags | list |
关联到的标签 |
其中 HTTPSConfig 类型如下：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| enabled | 必选 | bool | 是否开启了HTTPS加速，默认为false |
| certId | 可选 | string | 当enabled=true时为必选，为SSL证书服务返回的证书ID |
| httpRedirect | 可选 | bool | 为true时将HTTP请求302重定向到HTTPS，默认为false |
| httpRedirectCode | 可选 | int | 重定向状态码，默认为302 |
| httpsRedirect | 可选 | bool | 为true时将HTTPS请求302重定向到HTTP，默认为false |
| httpsRedirectCode | 可选 | int | 重定向状态码，默认为302 |
| noRedirectedUAs | 可选 | list<string> | 重定向时，排除包含特定UA的请求 |
| http2Enabled | 可选 | bool | 是否开启HTTP2特性，默认为true |
| verifyClient | 可选 | bool | 是否开启了HTTPS双向认证，默认为false |
| sslProtocols | 可选 | list<string> | 访问TLS版本。在主动设置为"TLSv1.0"、"TLSv1.1"、"TLSv1.2"、"TLSv1.3"四个中的一个或多个后显示为设置的版本，否则为默认值["TLSv1.0","TLSv1.1","TLSv1.2","TLSv1.3"] |
其中 Tag 类型如下：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| tagKey | 必选 | string | 标签的键，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度 1-65 |
| tagValue | 可选 | string | 标签的值，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度 0-65 |
请求示例
Text
1GET /v2/domain/myself.baidu.com/config HTTP/1.1
2Host: cdn.baidubce.com响应示例
Text
1HTTP/1.1 200 OK
2Content-Length: 190
3Content-Type: application/json;utf-8
4x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
5Server: BCE-CDN
6
7{
8 "domain":"myself.baidu.com",
9 "cname":"myself.baidu.com.jomodns.com",
10 "status": "RUNNING",
11 "createTime":"2014-06-17T18:10:22Z",
12 "lastModifyTime": "2014-06-17T18:10:22Z",
13 "form": "image",
14 "origin": [
15 {"peer":"http://1.2.3.4"},
16 {"peer":"http://1.2.3.5"}
17 ],
18 "cacheTTL" : [
19 {"type": "suffix", "value": ".jpg", "ttl":36000, "weight": 30},
20 {"type": "suffix", "value": ".mp4", "ttl":36000, "weight": 30},
21 {"type": "path", "value": "/path/to/my/file", "ttl":1800, "weight": 5}
22 ],
23 "cacheFullUrl": true,
24 "limitRate": 1024000
25}