所有文档

          内容分发网络 CDN

          更新加速域名回源地址

          接口

          本接口用于更新指定加速域名回源地址。此域名必须是本用户的,否则会返回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回源