批量新增域名
更新時間 2025-04-20 19:26:49
最近更新時間: 2025-04-20 19:26:49
分享文章
接口描述:調用本接口批量新增加速域名
請求方式: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 |
| ipv6_enable | int | 否 | ipv6啟用 | 1(啟用); 2(關閉),不傳默認開啟 |
| 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,其他返回異常信息描述 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/domain/batch-create-domain
示例1:
請求參數:
{
"domain": [
"a.a1.daliqc.cn",
"a.a2.daliqc.cn",
"a.a3.daliqc.cn",
"a.a4.daliqc.cn"
],
"product_code": "008",
"origin": [
{
"role": "master",
"port": 80,
"origin": "1.1.1.1",
"weight": 10
},
{
"role": "master",
"port": 80,
"origin": "test.hnoss.xstore.daliqc.cn",
"weight": 10
}
],
"xos_origin_is": 1,
"xos_origin": {
"origin": "test.hnoss.xstore.daliqc.cn",
"ak": "akxxx",
"sk": "skxxx"
}
}
返回結果:
{
"code": 100000,
"message": "success",
"success_number": 4,
"domain_details": [
{
"code": 100000,
"message": "success",
"domain": "a.a1.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a2.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a3.daliqc.cn"
},
{
"code": 100000,
"message": "success",
"domain": "a.a4.daliqc.cn"
}
]
}
錯誤碼請參考:參數code和message含義