接口描述:调用本接口批量新增加速域名
请求方式:post
请求路径:/domain/batch-create-domain
使用说明:
- 添加域名之前,您需要先开通对应产品类型的服务;
- 该域名必须已成功备案;
- 该域名之前未创建过,没有在途工单;
- 单个用户一分钟限制调用10次;
- 调用本接口批量新增时仅支持最简单配置,若需要对域名进行更复杂配置,请创建后再调用批量更新域名配置接口。
请求参数说明:
参数名 | 类型 | 是否必填 | 名称 | 说明 |
---|---|---|---|---|
domain | list< string> | 是 | 域名列表 | 单次调用域名个数最多不超过20个,相同域名去重 |
product_code | string | 是 | 产品业务类型 | “001”(静态加速),“003”:(下载加速), “004”(视频点播加速),“008”(CDN加速),“014”(下载加速闲时) |
area_scope | int | 否 | 加速范围 | 1(国内);2(海外); 3(国内+海外),不填默认为1 |
origin | list | 是 | 源站信息 | |
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,其他返回异常信息描述 |
success_number | int | 否 | 操作成功的个数 |
domain_details | list< object> | 否 | 每个域名操作结果 |
domain_details[*].domain | string | 否 | 单个域名 |
domain_details[*].code | string | 否 | 单个域名操作的状态码,成功100000 |
domain_details[*].message | string | 否 | 单个域名操作的描述信息,成功返回success,其他返回异常信息描述 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/domain/batch-create-domain
示例1:
请求参数:
{
"domain": [
"a.a1.ctyun.cn",
"a.a2.ctyun.cn",
"a.a3.ctyun.cn",
"a.a4.ctyun.cn"
],
"product_code": "008",
"origin": [
{
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
},
{
"role": "master",
"port": 80,
"origin": "test.hnoss.xstore.ctyun.cn",
"weight": 10
}
],
"xos_origin_is": 1,
"xos_origin": {
"origin": "test.hnoss.xstore.ctyun.cn",
"ak": "akxxx",
"sk": "skxxx"
}
}
返回结果:
{
"code": 100000,
"message": "success",
"success_number": 4,
"domain_details": [
{
"code": 100000,
"message": "success",
"domain": "a.a1.ctyun.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a2.ctyun.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a3.ctyun.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a4.ctyun.cn"
}
]
}
错误码请参考:参数code和message含义