创建域名接口
更新时间：2024-04-24
接口
本接口用于创建海外加速域名。
| 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至该域名实现加速 |
请求实例
POST /v2/abroad/domain/test.bcecdn.com HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 76
Content-Type: application/x-www-form-urlencoded
{
"originConfig":[
{
"type": "IP",
"backup": false,
"addr": "1.1.1.1"
}
]
}请求实例-关联标签
POST /v2/abroad/domain/test.bcecdn.com HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 76
Content-Type: application/x-www-form-urlencoded
{
"originConfig":[
{
"type": "IP",
"backup": false,
"addr": "1.1.1.1"
}
],
"tags": [
{
"tagKey": "abroad",
"tagValue": "test"
}
]
}响应示例
HTTP/1.1 201 Created
Server: nginx
Content-Type: application/json; charset=utf-8
Connection: keep-alive
x-bce-request-id: 8eb227da-55b6-87ac-3388-7fa3df2c09e5
{
"status":"OPERATING",
"cname":"test.bcecdn.com.g0.dbydns.com"
}