创建加速域名接口
更新时间：2025-12-11
接口
本接口用于在百度智能云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 | OriginConfig[] | 必选 | 源站列表。必须携带一个源站才能创建加速域名成功。 |
| originProtocol | String | 可选 | 回源使用的协议，默认为协议跟随回源，其合法值为三种： • http：强制使用 HTTP 协议回源； • https：强制使用 HTTPS 协议回源; • *：根据客户端的请求协议跟随回源。 |
OriginConfig 类型如下：
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| type | String | 必选 | 源站地址的类型，有三种： • IP • DOMAIN • BUCKET |
| addr | String | 必选 | 源站地址，可以为 IP 或者域名格式，不能携带端口。如果为IPv6地址，请不要带上中括号。不支持CIDR格式的IP地址。 合法地址示例： • 1.1.1.1 • origin.com • 1::1 • a.bj.bcebos.com 非法地址示例： • ()sdas.com • 1.1.1.1:80 |
| httpPort | Int | 可选 | 源站 HTTP 服务的端口，默认值为 80。 |
| httpsPort | Int | 可选 | 源站 HTTPS 服务的端口，默认值为 443。 |
响应码
| HTTP Status Code | 说明 |
|---|---|
| 200 | 创建成功 |
| 400 | 源站列表或回源协议请求参数无效。 |
| 403 | 加速域名已经存在。 |
| 404 | 站点Id请求参数无效。 |
响应体
| 参数 | 类型 | 说明 |
|---|---|---|
| status | String | 刚创建成功返回的 status 是 OPERATING。 |
| cname | String | 生成的 CNAME 域名，用户通过将加速域名 CNAME 至该域名实现加速。 |
请求示例
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":"IP",
13 "addr":"1.1.1.1"
14 }
15 ]
16}响应示例
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}评价此篇文章