更新加速域名回源地址

更新时间：2020-11-25

接口

本接口用于更新指定加速域名回源地址。此域名必须是本用户的，否则会返回403失败。

Method	Path	说明
PUT	/v2/domain/{domain}/config?origin	修改加速域名的配置

请求体（Request Body）

参数	可选	类型	说明
origin	必选	list类型，表示OriginPeer。	源站配置
defaultHost	可选	String	默认回源host，当源站级别host不存在时，使用域名级别的默认host
follow302	可选	Bool	开启回源follow 302

OriginPeer类型如下：

参数	可选	类型	说明
peer	必选	String	格式为{protocol://}{address}{:port}，其中protocol可选，目前只支持https；port可选，分http回源端口以及https回源端口，当protocol为https时设置的是https回源端口，反之则设置的是http回源端口，默认设置的是http回源端口；address必须为ip或者域名，目前address已经支持ipv6地址，ipv6地址必须为'[ipv6]'的格式
host	可选	String	回源时使用的host值，该host为源站级别的host，每个源站可以配置一个host
backup	可选	Bool	是否为备份源站，true表示主源站，false表示备份源站，默认为false
weight	可选	int	源站权重，值为0-100之间的整数，表该源站的回源权重，默认等权重回源。注意：所有源站的权重和不能大于100，在没有默认值的情况下所有源站权重和必须等于100，DOMAIN类型的源站只能有一主一备，设置该参数不具有实际意义。举例：按照权重分配回源的流量。比如1G回源流量，2个ip，一个ip权重是80%，一个是20%，那一个ip就大约会有800M的回源，另一个大约会有200M的回源

响应码 (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"}

访问控制接口

设置Range回源

内容分发网络 CDN

更新加速域名回源地址