设置回源地址（新版）
更新时间：2025-01-23
接口描述
本接口用于设置回源地址。
请求结构
PUT /v2/domain/{domain}/config?originConfig HTTP/1.1
Host: cdn.baidubce.com
Authorization: authorization string
{
"originConfig": [
{
"addr": "test1.com",
"type": "DOMAIN",
"weight": 10,
"upstreamProtocol": "http",
"host": "test1.baidu.com",
"backup": false
},
{
"addr": "220.181.38.148",
"type": "IP",
"weight": 10,
"upstreamProtocol": "*",
"host": "test2.baidu.com",
"backup": true
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
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 |
请求示例
PUT /v2/domain/myself.baidu.com/config?originConfig HTTP/1.1
Host: cdn.baidubce.com
Content-Type: text/json;utf-8
{
"originConfig": [
{
"addr": "test1.com",
"type": "DOMAIN",
"weight": 10,
"upstreamProtocol": "*",
"host": "test1.baidu.com",
"backup": false
},
{
"addr": "test2.com",
"type": "DOMAIN",
"weight": 10,
"upstreamProtocol": "http",
"host": "test2.baidu.com",
"backup": false
},
{
"addr": "11.23.40.5",
"type": "IP",
"weight": 10,
"upstreamProtocol": "https",
"host": "test3.baidu.com",
"backup": false
}
]
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"status": "RUNNING"
}