新增域名
更新时间 2025-04-17 09:15:12
最近更新时间: 2025-04-17 09:15:12
接口描述:调用本接口新增加速域名
请求方式:post
请求路径:/domain/create-domain
使用说明:
添加域名之前,您需要先开通对应产品类型的服务;
该域名必须已成功备案;
该域名已完成域名归属权验证,若域名归属权验证失败,则接口会返回校验内容,具体可参考验证域名归属权,校验成功后才可以新增该域名;
该域名之前未创建过,没有在途工单,该域名没有叠加其余产品;
单个用户一分钟限制调用10次;
调用本接口新增时仅支持最简单配置,若需要对域名进行更复杂配置,请创建后再调用增量修改域名接口(路径:/domain/update-domain)
请求参数说明:
参数 | 类型 | 是否必填 | 名称 | 说明 |
|---|---|---|---|---|
| action | int | 是 | 域名操作动作 | 固定值1 |
| domain | string | 是 | 域名,仅支持单个域名新增 | |
| product_code | string | 是 | 产品类型 | “006”(全站加速) |
| waf_enable | int | 否 | 是否开启安全WAF防护 | 1(启用); 2(关闭)。仅适用product_code 为"007"(安全加速)时才生效,且product_code 为"007"(安全加速)时,waf_enable和ddos_enable至少启用一个 |
| ddos_enable | int | 否 | 是否开启安全抗D服务 | 1(启用); 2(关闭)。仅适用product_code 为"007"(安全加速)时才生效,且product_code 为"007"(安全加速)时,waf_enable和ddos_enable至少启用一个,且调用本接口开启安全抗D服务后,仍需人工处理,请创建后联系专属售后运营人员处理。 |
| area_scope | int | 否 | 加速范围 | 1(国内);2(海外); 3(国内+海外),不填默认为1 |
| ipv6_enable | int | 否 | ipv6启用 | 1(启用); 2(关闭),不传默认开启 |
| origin | list<object> | 是 | 源站信息 | |
| origin[*].origin | string | 是 | 源站ip或域名 | |
| origin[*].port | int | 是 | 源站端口 | 支持http自定义端口,http不支持下发443端口,多个源站时,源站端口需保持一致 |
| origin[*].weight | int | 是 | 权重 | 范围:1-100 |
| origin[*].role | string | 是 | 源站角色 | 取值: master, slave |
| xos_origin_is | int | 否 | 是否开启云存储XOS源站配置功能 | 枚举值:0(关闭), 1(开启);默认0 |
| xos_origin | object | 否 | 云存储XOS源站信息 | 当xos_origin_is为1的时候,xos_origin必传 |
| xos_origin[*].origin | string | 是 | 云存储XOS源站 | |
| xos_origin[*].ak | string | 否 | 云存储XOS源站加密ak | ak与sk必须同时填写 |
| xos_origin[*].sk | string | 否 | 云存储XOS源站加密sk | ak与sk必须同时填写 |
返回参数说明:
| 参数 | 类型 | 是否必传 | 名称及描述 |
|---|---|---|---|
| code | int | 是 | 状态码,成功100000 |
| message | string | 是 | 描述信息,成功返回success,其他返回异常信息描述 |
| domain_zone | string | 否 | 主域名zone,域名校验失败时,域名对应的主域名zone |
| zone_type | string | 否 | 记录类型,域名校验失败时,生成的记录类型,如TXT |
| zone_host | string | 否 | 主机记录,域名校验失败时,生成的主机记录,如dnsverify |
| zone_record | string | 否 | 记录值,域名校验失败时,生成的记录值,如202208201502416f4431f54f7b441b9425dc0e1a6b9d853a8fcd1119e142429 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/domain/create-domain
请求参数:
{
"action": 1,
"domain": "aaa.ctyun.cn",
"product_code": "006",
"origin": [
{
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
},
{
"role": "master",
"port": 80,
"origin": "test.hnoss.xstore.ctyun.cn",
"weight": 10
}
]
}返回结果:
{
"code": 100000,
"message": "success"
}错误码请参考:参数code和message含义