查询域名详情接口
更新时间:2024-05-23
接口
本接口用于查询域名详情。
查询域名的所有配置项:
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段 |
请求示例
GET /v2/abroad/domain/test.bcecdn.com/config HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 0
Authorization: bce-auth-v2...
响应示例
{
"domain": "test.bcecdn.com",
"cname": "test.bcecdn.com.g0.bdydns.com",
"status": "RUNNING",
"createTime": "2024-01-12 16:10:45",
"lastModifyTime": "2024-04-24 17:27:12",
"originConfig": [
{
"type": "IP",
"backup": false,
"addr": "182.61.128.134"
}
],
"cacheTtl": [
{
"ttl": 0,
"type": "path",
"value": "/",
"weight": 2,
"override_origin": true
},
{
"ttl": 0,
"type": "suffix",
"value": ".php;.jsp;.asp",
"weight": 3,
"override_origin": true
}
],
"originProtocol": "http",
"https": {
"enabeld": false
},
"ipACL": {
"blackList": [
"1.1.1.2",
"64.8.12.3/25"
]
},
"refererACL": {
"blackList": [
"www.example.com"
],
"allowEmpty": true
},
"originHost": "test.bcecdn.com",
"cacheFullUrl": false,
"tags": [
{
"tagKey": "abroad",
"tagValue": "test"
}
]
}