设置回源地址（新版）
更新时间：2025-01-23
接口描述
本接口用于设置回源地址。
请求结构
Plain Text
1PUT /v2/domain/{domain}/config?originConfig HTTP/1.1
2Host: cdn.baidubce.com
3Authorization: authorization string
4
5{
6 "originConfig": [
7 {
8 "addr": "test1.com",
9 "type": "DOMAIN",
10 "weight": 10,
11 "upstreamProtocol": "http",
12 "host": "test1.baidu.com",
13 "backup": false
14 },
15 {
16 "addr": "220.181.38.148",
17 "type": "IP",
18 "weight": 10,
19 "upstreamProtocol": "*",
20 "host": "test2.baidu.com",
21 "backup": true
22 }
23 ]
24}请求头域
除公共头域外，无其它特殊头域。
请求参数
RequestBody参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| originConfig | list<OriginItem> | 是 | 源站地址列表。 • 主源站至少有一个，可以没有备源站； • 当数组中存在 type 为 BUCKET 类型的源站时，不能混配，且主备最多各有一个； • 当数组中不存在 type 为 BUCKET 类型的源站时，支持混配，且主备加起来最多10个。 |
OriginItem类型说明：
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| addr | string | 是 | 源站地址。支持 IPv4、IPv6 形式的 IP 地址，或者域名，不能重复。 |
| type | string | 是 | 源站类型。可选值为 IP、DOMAIN、BUCKET，值为 DOMAIN 时，会忽略 isp 配置；值为 BUCKET 时，addr 要填写 BUCKET 的完整地址，并且会忽略 weight、isp 的配置。 |
| httpPort | int | 否 | http 回源端口。默认80。 |
| httpsPort | int | 否 | https 回源端口。默认443。 |
| host | string | 否 | 回源时使用的 host 值。 |
| upstreamProtocol | string | 否 | 回源协议。可选值为 http、https、*， 其中 * 表示协议跟随。 |
| weight | int | 否 | 源站权重，值为1-100之间的整数。举例：按照权重分配回源的流量，假设某加速域名有两个源站，一个源站 A 权重是80，另一个 B 是20，总的回源量是1G，那么其中A源站大约会有800M的回源，B大约会有200M的回源。 |
| backup | bool | 否 | 是否为备源站。true 表示备源站，false 表示主源站，默认为 false。 |
| isp | string | 否 | 源站所属的运营商。默认无，可选值为un（联通）、ct（电信）、cm（移动）。 |
| probeUrl | string | 否 | 探测地址。配置了 probeUrl，表明配置对源站进行应用层探测，百度智能云 CDN 会定期给源站发送 GET /{probeUrl} 请求进行探测，如果源站响应的 HTTP 状态码小于500，那么认为源站正常；否则，认为源站异常，在探测恢复正常前不会选择异常源站进行回源。如果你希望探测的资源为 scheme://$addr:$http(s)Port/1.gif，那么此处的 probeUrl 应设置为"1.gif"，而不是"/1.gif"。需要注意，probeUrl 设置为空字符串表示不开启源站探测。 |
响应参数
响应码
| HTTP Status Code | 描述 |
|---|---|
| 200 | 成功 |
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | string | 刚更新成功返回的 status 是 RUNNING |
请求示例
JSON
1PUT /v2/domain/myself.baidu.com/config?originConfig HTTP/1.1
2Host: cdn.baidubce.com
3Content-Type: text/json;utf-8
4
5{
6 "originConfig": [
7 {
8 "addr": "test1.com",
9 "type": "DOMAIN",
10 "weight": 10,
11 "upstreamProtocol": "*",
12 "host": "test1.baidu.com",
13 "backup": false
14 },
15 {
16 "addr": "test2.com",
17 "type": "DOMAIN",
18 "weight": 10,
19 "upstreamProtocol": "http",
20 "host": "test2.baidu.com",
21 "backup": false
22 },
23 {
24 "addr": "11.23.40.5",
25 "type": "IP",
26 "weight": 10,
27 "upstreamProtocol": "https",
28 "host": "test3.baidu.com",
29 "backup": false
30 }
31 ]
32}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json;utf-8
3x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
4Server: BCE-CDN
5
6{
7 "status": "RUNNING"
8}