更新加速域名回源地址
更新时间：2022-04-11
接口
本接口用于更新加速域名回源地址。此域名必须是本账户的，否则会返回403失败。
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/domain/{domain}/config?origin | 修改加速域名的源站 |
请求体（Request Body）
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| origin | 必选 | OriginPeer[]类型，OriginPeer表示一个源站。 | 源站配置 |
| defaultHost | 可选 | String | 域名级别回源host，默认为加速域名。优先级低于源站的回源host（即OriginPeer.host） |
| 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（移动） |
其他限制：
- 多个源站的类型必须保持统一，不能一个源站为IP类型，另一个源站为DOMAIN类型。
- DOMAIN类型的主或备源站个数不超过1个。
- IP类型的主或备源站个数分别不超过20个。
- 必须包含一个主源站，可以没有备源站。
响应码 (Http Status Code)
| HTTP Status Code | 说明 |
|---|---|
| 200 | 成功 |
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| status | String | 刚更新成功返回的status是RUNNING |
请求示例
以下请求对域名myself.baidu.com设置两个源站，源站1的是HTTP协议类型源站，IP为1.1.1.1，端口为8888，CDN节点回源会带上的请求头部"Host: www.baiducdn.com"，没有设置backup字段则取默认是也就是false表示这是一个主源站。源站二是HTTPS协议类型源站，IP为2.2.2.2，端口为设置则默认端口443，回源Host也是www.baiducdn.com，这是个备份源站。
PUT /v2/domain/myself.baidu.com/config?origin HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 178
Content-Type: text/json;utf-8
{
"origin":[
{
"peer":"http://1.1.1.1:8888",
"host":"www.baiducdn.com"
},
{
"peer":"https://2.2.2.2",
"host":"www.baiducdn.com",
"backup":true
}
],
"defaultHost":"www.baidu.com",
"follow302":true
}响应示例
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 20 Jun 2019 10:19:38 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.1.5
x-bce-request-id: e38a0c7d-388e-ac0b-6238-b674b4ea7bfc
{"status":"RUNNING"}请求示例——同时配置ipv4和ipv6源站
PUT /v2/domain/myself.baidu.com/config?origin HTTP/1.1
Host: cdn.baidubce.com
Accept: */*
Content-Length: 77
Content-Type: application/x-www-form-urlencoded
{
"origin": [
{
"peer": "http:\/\/[2001:250:3003:13::94]",
"host": "ipv6.stu.edu.cn"
},
{
"peer": "http:\/\/129.226.184.12",
"host": "aonetest"
}
]
}响应示例
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 20 Jun 2019 10:19:38 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
X-Powered-By: PHP/7.1.5
x-bce-request-id: e38a0c7d-388e-ac0b-6238-b674b4ea7bfc
{"status":"RUNNING"}