查询回源地址（旧版）

更新时间：2025-08-21

接口

本接口用于查询指定加速域名的回源地址。

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设置为空字符串表示不开启源站探。

请求/响应示例

Plain Text

1GET /v2/domain/test.baidu.com/config?origin HTTP/1.1
2Host: cdn.baidubce.com
3x-bce-date: 2022-04-11T08:36:22Z
4x-bce-request-id: 54c29322-b905-47bf-9ab7-6feb7434402c
5
6HTTP/1.1 200 OK
7Server: nginx/1.14.0
8Date: Mon, 11 Apr 2022 08:36:28 GMT
9Content-Type: application/json; charset=utf-8
10Transfer-Encoding: chunkedConnection: keep-alive
11X-Powered-By: PHP/5.6.36
12x-bce-request-id: 54c29322-b905-47bf-9ab7-6feb7434402c
13
14{
15    "origin":[
16        {
17            "peer":"http://111.206.76.1:80",
18            "backup":false,
19            "weight":20,
20            "isp":"ct"
21        },
22        {
23            "peer":"https://111.206.76.1:443",
24            "backup":false,
25            "weight":20,
26            "isp":"ct"
27        },
28        {
29            "peer":"http://111.206.76.2:8080",
30            "host":"specified.origin.baidu.com",
31            "backup":false,
32            "weight":30,
33            "isp":"ct"
34        },
35        {
36            "peer":"https://111.206.76.2:443",
37            "host":"specified.origin.baidu.com",
38            "backup":false,
39            "weight":30,
40            "isp":"ct"
41        },
42        {
43            "peer":"http://111.206.76.3:80",
44            "backup":false,
45            "weight":20,
46            "isp":"cm"
47        },
48        {
49            "peer":"https://111.206.76.3:443",
50            "backup":false,
51            "weight":20,
52            "isp":"cm"
53        }
54    ],
55    "requestHostAsOriginHost": true,
56    "follow302": false
57}

设置Range回源

设置同运营商回源

内容分发网络 CDN

内容分发网络 CDN

查询回源地址（旧版）

接口

响应体

请求/响应示例