查询加速域名回源地址
更新时间:2022-08-05
接口
本接口用于查询指定加速域名的回源地址。
Method | Path | 说明 |
---|---|---|
GET | /v2/domain/{domain}/config?origin | 查询回源地址 |
domain: 需要查询CDN的加速域名
响应体
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
origin | 必选 | OriginPeer[]类型,OriginPeer表示一个源站 | 源站列表 |
requestHostAsOriginHost | 可选 | bool | 首先区分“请求域名”和“CDN域名”的关系。“CDN域名”指在CDN系统创建的域名,“请求域名”指CDN节点接收到请求时从请求头host中拿到的值。如果“CDN域名”不是泛域名,“请求域名”一定是“CDN域名”;如果“CDN域名”是泛域名,“请求域名”大概率不是“CDN域名”。 • 当requestHostAsOriginHost为true时,表示使用“请求域名”作为回源host,其优先级低于源站的回源host(即OriginPeer[i].host)。 • 当requestHostAsOriginHost为false时,使用defaultHost作为回源host,其优先级也低于源站的回源host(即OriginPeer[i].host) |
defaultHost | 可选 | string | 域名级别回源host,默认为加速域名。优先级低于源站的回源host(即OriginPeer[i].host)。 当requestHostAsOriginHost为true时此配置无效 |
follow302 | 可选 | bool | 开启/关闭回源follow 302 |
OriginPeer类型如下:
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
peer | 必选 | string | 格式为 ${protocol}://${address}:${port},其中protocol可选,合法值为http和https,默认为http,;port可选,分http回源端口以及https回源端口,当protocol为https时设置的是https回源端口,反之则设置的是http回源端口;address必须为ip或者域名,当address为IPv6地址时,必须为用中括号[]扩起来。当address为域名时,表示DOMAIN类型源站;当address为IP时,表示IP类型源站。 示例: 1、IPv4类型源站:https://171.107.86.35:443 2、IPv6类型源站:http://[240e:00a5:4200:0100::171.107.86.35]:80 3、域名类型源站:http://myself.baidu.com:8080 |
host | 可选 | string | 回源时使用的host值,该host为源站级别的host,每个源站可以配置一个host |
backup | 可选 | bool | 是否为备份源站,true表示备份源站,false表示主源站,默认为false |
weight | 可选 | int | 源站权重,值为1-100之间的整数。当源站为DOMAIN类型时此项无意义。举例:按照权重分配回源的流量。假设某加速域名有2个IP类型的源站,一个IP源站权重是80,另一个是20,总的回源量是1G,那么,其中一个IP源站大约会有800M的回源,另一个大约会有200M的回源 |
isp | 可选 | string | 源站所属的运营商。默认无,可选值为un(联通)、ct(电信)、cm(移动) |
probeUrl | 可选 | string | 配置了probeUrl,表明配置对源站进行应用层探测,百度智能云CDN会定期给源站发送GET /{probeUrl}请求进行探测,如果源站响应的HTTP状态码小于500,那么认为源站正常;否则,认为源站异常,在探测恢复正常前不会选择异常源站进行回源。如果你希望探测的资源为 scheme//$origin/1.gif,那么此处的probeUrl应设置为"1.gif",而不是"/1.gif"。需要注意,probeUrl设置为空字符串表示不开启源站探。 |
请求/响应示例
GET /v2/domain/test.baidu.com/config?origin HTTP/1.1
Host: cdn.baidubce.com
x-bce-date: 2022-04-11T08:36:22Z
x-bce-request-id: 54c29322-b905-47bf-9ab7-6feb7434402c
HTTP/1.1 200 OK
Server: nginx/1.14.0
Date: Mon, 11 Apr 2022 08:36:28 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunkedConnection: keep-alive
X-Powered-By: PHP/5.6.36
x-bce-request-id: 54c29322-b905-47bf-9ab7-6feb7434402c
{
"origin":[
{
"peer":"http://111.206.76.1:80",
"backup":false,
"weight":20,
"isp":"ct"
},
{
"peer":"https://111.206.76.1:443",
"backup":false,
"weight":20,
"isp":"ct"
},
{
"peer":"http://111.206.76.2:8080",
"host":"specified.origin.baidu.com",
"backup":false,
"weight":30,
"isp":"ct"
},
{
"peer":"https://111.206.76.2:443",
"host":"specified.origin.baidu.com",
"backup":false,
"weight":30,
"isp":"ct"
},
{
"peer":"http://111.206.76.3:80",
"backup":false,
"weight":20,
"isp":"cm"
},
{
"peer":"https://111.206.76.3:443",
"backup":false,
"weight":20,
"isp":"cm"
}
],
"requestHostAsOriginHost": true,
"follow302": false
}