设置回源地址（新版）

更新时间：2025-12-16

接口描述

本接口用于设置回源地址。

请求结构

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个。 • 当数组中存在 type 为 DOMAIN 类型的源站时，支持配置第三方对象存储的源站，仅支持配置主源站，且源站个数最多有一个。

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（移动）。
thirdBucketAuth	ThirdBucketAuth[]	否	第三方对象存储的源站配置。
probeUrl	String	否	探测地址。配置了 probeUrl，表明配置对源站进行应用层探测，百度智能云 CDN 会定期给源站发送 GET /{probeUrl} 请求进行探测，如果源站响应的 HTTP 状态码小于500，那么认为源站正常；否则，认为源站异常，在探测恢复正常前不会选择异常源站进行回源。如果你希望探测的资源为 scheme://$addr:$http(s)Port/1.gif，那么此处的 probeUrl 应设置为"1.gif"，而不是"/1.gif"。需要注意，probeUrl 设置为空字符串表示不开启源站探测。

ThirdBucketAuth[]类型说明：

参数	类型	是否必选	说明
authType	String	是	表示第三方的对象存储来源类型，当前支持 AWS S3、腾讯云 COS、阿里云 OSS、华为云 OBS。其合法值为："aws_v2"、"aws_v4"、"cos"、"oss"、"obs"。
enabled	Bool	否	启用第三方私有bucket鉴权的开关，默认值为 flase。
ak	String	是	第三方对象存储的访问密钥 Access Key。
sk	String	是	第三方对象存储的私有访问密钥 Secret Access Key。
bucket	String	否	第三方对象存储的 bucket。注: • 当对象存储来源类型为 "aws_v2" 时，必须设置 bucket。 • 当对象存储来源类型为 "aws_v4" 时，无需设置 bucket。 • 当对象存储来源类型为 "cos" 时，无需设置 bucket。 • 当对象存储来源类型为 "oss" 时，必须设置 bucket。 • 当对象存储来源类型为 "obs" 时，无需设置 bucket。
region	String	否	第三方对象存储的区域。注: • 当对象存储来源类型为 "aws_v2" 时，无需设置区域。 • 当对象存储来源类型为 "aws_v4" 时，选填，默认区域为 "us-east-1"。 • 当对象存储来源类型为 "cos" 时，无需设置区域。 • 当对象存储来源类型为 "oss" 时，选填，默认区域为 "cn-hangzhou"。 • 当对象存储来源类型为 "obs" 时，无需设置区域。
service	String	否	第三方对象存储的服务。注: • 当对象存储来源类型为 "aws_v2" 时，无需设置服务。 • 当对象存储来源类型为 "aws_v4" 时，选填，默认服务为 "s3"。 • 当对象存储来源类型为 "cos" 时，无需设置服务。 • 当对象存储来源类型为 "oss" 时，无需设置服务。 • 当对象存储来源类型为 "obs" 时，无需设置服务。

注：当 “无需设置” 用于描述某字段时，指的是该字段无效，即使在第三方对象存储配置中设置了值，也不会生效。

响应参数

响应码

HTTP Status Code	描述
200	成功

响应体

参数名称	类型	描述
status	string	刚更新成功返回的 status 是 RUNNING

请求示例 1：常规源站配置

                JSON
                
            

                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
        }
    ]
}
            

请求示例 2：第三方对象存储源站配置

                JSON
                
            

                PUT /v2/domain/myself.baidu.com/config?originConfig HTTP/1.1
Host: cdn.baidubce.com
Content-Type: text/json;utf-8

{
    "originConfig": [
        {
            "type": "DOMAIN",
            "addr": "test1.com",
            "backup": false,
            "host": "test1.baidu.com",
            "upstreamProtocol": "http",
            "thirdBucketAuth": {
                "authType": "aws_v4",
                "enabled":true,
                "ak":"xxx",
                "sk":"xxx",
                "bucket":"mybucket",
                "region":"us-east-1",
                "service":"s3"
            }
        }
    ]
}
            

响应示例

                JSON
                
            

                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"
}
            

访问控制接口

查询回源地址（新版）

百度智能云

内容分发网络 CDN

内容分发网络 CDN

设置回源地址（新版）

接口描述

请求结构

请求头域

请求参数

RequestBody参数

响应参数

响应码

响应体

请求示例 1：常规源站配置

请求示例 2：第三方对象存储源站配置

响应示例