创建域名接口
更新时间：2025-08-21
接口
本接口用于创建海外加速域名。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/abroad/domain/{domain} | 创建加速域名 |
domain：表示需要创建的加速域名。
请求体(Request Body)
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| originConfig | 必选 | OriginConfig[] | 源站配置 |
| tags | 可选 | Tag[] | 希望关联到的标签集合，标签个数最多为 10 个，且不允许对同一个域名绑定两个相同的 tagKey。 |
OriginConfig类型如下:
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| type | 必选 | string | 源站类型(IP | DOMAIN) |
| backup | 必选 | boolean | 是否为备份源站，true表示备份源站，false表示主源站，默认为false |
| addr | 必选 | string | 源站地址 |
Tag 类型如下：
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| tagKey | 必选 | string | 标签的键，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度 1-65 |
| tagValue | 可选 | string | 标签的值，可包含大小写字母、数字、中文以及-_ /.特殊字符，长度 0-65 |
响应码(Http Status Code)
| Http Status Code | 说明 |
|---|---|
| 201 | 创建成功 |
| 400 | 域名已经存在、域名检查失败、缺乏必要参数、参数值错误、域名被封禁 |
| 403 | quota不够 |
响应体(Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| status | string | 刚创建成功返回的status是OPERATING |
| cname | string | 生成的CNAME域名，用户通过将加速域名CNAME至该域名实现加速 |
请求实例
Plain Text
1POST /v2/abroad/domain/test.bcecdn.com HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 76
4Content-Type: application/x-www-form-urlencoded
5
6{
7 "originConfig":[
8 {
9 "type": "IP",
10 "backup": false,
11 "addr": "1.1.1.1"
12 }
13 ]
14}请求实例-关联标签
Plain Text
1POST /v2/abroad/domain/test.bcecdn.com HTTP/1.1
2Host: cdn.baidubce.com
3Content-Length: 76
4Content-Type: application/x-www-form-urlencoded
5
6{
7 "originConfig":[
8 {
9 "type": "IP",
10 "backup": false,
11 "addr": "1.1.1.1"
12 }
13 ],
14 "tags": [
15 {
16 "tagKey": "abroad",
17 "tagValue": "test"
18 }
19 ]
20}响应示例
Plain Text
1HTTP/1.1 201 Created
2Server: nginx
3Content-Type: application/json; charset=utf-8
4Connection: keep-alive
5x-bce-request-id: 8eb227da-55b6-87ac-3388-7fa3df2c09e5
6
7{
8 "status":"OPERATING",
9 "cname":"test.bcecdn.com.g0.dbydns.com"
10}