创建加速域名接口

更新时间：2026-10-15

接口

本接口用于在百度智能云GEO产品中创建加速域名，在请求该接口时必须已经开通GEO，购买的套餐仍有子域名额度，且不允许创建未完成归属验证的域名。

您可以通过请求查询域名归属权验证方法接口查询如何验证归属权。

当您在自己的域名托管服务商中设置对应的DNS TXT完成验证之后，生效时间大概是0-5分钟，可通过请求查询域名是否可添加接口查询百度智能云侧是否已认可验证。

请求接口

Method	Path	说明
POST	/v2/geo/domain?action=create	创建一个加速域名

请求体

参数	类型	可选	说明
domain	String	必选	站点对应的加速域名。假设站点为 test.com，此 domain 的合法值示例： • www.test.com • a.test.com • b.test.com • test.com • *.test.com 不合法值示例： • a.b.test.com
siteId	Int	必选	对应的站点ID。
originConfig	Array<OriginConfig>	可选	源站配置。
originPoolId	String	可选	源站池id。表示域名使用源站池作为源站配置。
upstreamProtocol	String	可选	回源协议。其合法值为：‘http’、‘https’、‘*’。使用源站池或负载均衡配置时必传。
ipv6Dispatch	Object<Ipv6Dispatch>	可选	域名的 ipv6 配置。
httpPort	Int	可选	http 回源端口。使用源站池或负载均衡配置时必传。回源协议为 ‘*’ 时，必传。
httpsPort	Int	可选	https 回源端口。使用源站池或负载均衡配置时必传。回源协议为 ‘*’ 时，必传。
loadBalanceId	String	可选	负载均衡id。表示域名使用负载均衡作为源站配置。

OriginConfig 类型说明

(1) IP 或域名源站类型

字段名称	类型	是否必须	说明
addr	String	是	源站地址。支持 IPv4、IPv6 形式的 IP 地址，或者域名，不能重复
type	String	是	源站类型。可选值为 “IP”、“DOMAIN”
host	String	否	回源时使用的 host 值
upstreamProtocol	String	是	回源协议。其合法值为：‘http’、‘https’、‘*’。
httpPort	Int	否	http 回源端口。回源协议为 ‘*’ 时，必传。
httpsPort	Int	否	https 回源端口。回源协议为 ‘*’ 时，必传。

(2)对象存储类型

字段名称	类型	是否必须	说明
addr	String	是	BOS 的 bucket 名称或 S3 对象存储的源站地址
type	String	是	源站类型。可选值为 “BUCKET”、“DOMAIN”，BOS 使用 “BUCKET”，S3 使用 “DOMAIN”
host	String	否	回源时使用的 host 值
upstreamProtocol	String	是	回源协议。其合法值为：‘http’、‘https’、‘*’。
httpPort	Int	否	http 回源端口。回源协议为 ‘*’ 时，必传。
httpsPort	Int	否	https 回源端口。回源协议为 ‘*’ 时，必传。
thirdBucketAuth	Object<ThirdBucketAuth>	是	对象存储的鉴权配置

ThirdBucketAuth 类型说明

字段名称	类型	是否必须	说明
authType	String	是	鉴权类型，当前支持 AWS S3 以及 BOS。其合法值为：“aws_v2”、“aws_v4”、“bos”
enabled	Bool	是	私有访问鉴权的开关，其合法值为 “true”、“false”
ak	String	否	只针对 S3 鉴权类型生效，开启私有访问鉴权时必须输入该值，对象存储的访问密钥 Access Key
sk	String	否	只针对 S3 鉴权类型生效，开启私有访问鉴权时必须输入该值，对象存储的私有访问密钥 Secret Access Key
bucket	String	否	只针对 S3 鉴权类型生效，对象存储的 bucket。 • aws_v2：必须设置 • aws_v4：无需设置
region	String	否	只针对 S3 鉴权类型生效，对象存储的区域。 • aws_v2：无需设置 • aws_v4：选填，默认区域为 “us-east-1”
service	String	否	只针对 S3 鉴权类型生效，对象存储的服务。 • aws_v2：无需设置 • aws_v4：选填，默认服务为 “s3”

注：

每个站点最多支持创建50个源站池，每个源站池最多支持创建20个源站。
针对 BOS 对象存储类型：ak、sk、bucket、region、service 这几个字段创建时无需传值。
关于“无需设置”：指该字段无效，即使在配置中设置了值，也不会生效。

Ipv6Dispatch 类型如下：

参数	类型	可选	说明
enable	String	必选	ipv6 配置开关。开启为 "ON"，关闭为 "OFF"。

## 响应码

HTTP Status Code	说明
200	创建成功
400	源站列表或回源协议请求参数无效。
403	加速域名已经存在。
404	站点Id请求参数无效。

响应体

参数	类型	说明
status	String	刚创建成功返回的 status 是 OPERATING。
cname	String	生成的 CNAME 域名，用户通过将加速域名 CNAME 至该域名实现加速。

请求示例1：设置 IP 类型源站

Plain Text

1POST /v2/geo/domain?action=create HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json;charset=utf-8
5Accept-Encoding: gzip
6
7{
8    "siteId":1,
9    "domain":"a.test.com",
10    "originConfig": [
11        {
12            "addr": "1.2.3.4",
13            "httpPort": 80,
14            "type": "IP",
15            "upstreamProtocol": "http",
16            "host":"test.eo.com"
17        }
18    ]
19}

请求示例2：设置域名类型源站

Plain Text

1POST /v2/geo/domain?action=create HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json;charset=utf-8
5Accept-Encoding: gzip
6
7{
8    "siteId":1,
9    "domain":"a.test.com",
10    "originConfig": [
11        {
12            "addr": "test.origin.com",
13            "httpPort": 80,
14            "type": "IP",
15            "upstreamProtocol": "http",
16            "host":"test.eo.com"
17        }
18    ]
19}

请求示例3：设置对象存储类型源站

Plain Text

1POST /v2/geo/domain?action=create HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json;charset=utf-8
5Accept-Encoding: gzip
6
7{
8    "siteId":1,
9    "domain":"a.test.com",
10    "originConfig": [
11        {
12            "type": "BUCKET",
13            "addr": "test.bucket",
14            "backup": false,
15            "host": "test.eo.com",
16            "upstreamProtocol": "http",
17            "thirdBucketAuth": {
18                "authType": "bos",
19                "enabled":true
20            },
21            "httpPort":80
22        }
23    ]
24}

请求示例4：设置源站池类型源站

Plain Text

1POST /v2/geo/domain?action=create HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json;charset=utf-8
5Accept-Encoding: gzip
6
7{
8    "siteId": 1,
9    "domain": "a.test.com",
10    "originPoolId": "geo_30RjuhwJ7anZ",
11    "upstreamProtocol":"http",
12    "httpPort":80
13}

请求示例5：设置负载均衡类型源站

Plain Text

1POST /v2/geo/domain?action=create HTTP/1.1
2Host: geo.baidubce.com
3Authorization: xxx
4Content-Type: application/json;charset=utf-8
5Accept-Encoding: gzip
6
7{
8    "siteId": 1,
9    "domain": "a.test.com",
10    "loadBalanceId": "eo_lb_30RjuhwJ7anZ",
11    "upstreamProtocol":"http",
12    "httpPort":80
13}

响应示例

Plain Text

1HTTP/1.1 200 OK
2Server: nginx/1.16.1
3Content-Type: application/json; charset=utf-8
4Transfer-Encoding: chunked
5Connection: keep-alive
6
7{   
8    "status":"OPERATING",
9    "cname":"a.test.com.a.bdydns.com"
10}

评价此篇文章

有帮助没帮助

站点管理

查询域名配置接口

百度智能云

边缘安全加速 EO

边缘安全加速 EO

创建加速域名接口

接口

请求接口

请求体

响应体

请求示例1：设置 IP 类型源站

请求示例2：设置域名类型源站

请求示例3：设置对象存储类型源站

请求示例4：设置源站池类型源站

请求示例5：设置负载均衡类型源站

响应示例