批量修改IPA域名配置
更新時間 2023-11-02 15:19:48
最近更新時間: 2023-11-02 15:19:48
分享文章
接口描述:調用本接口可批量修改應用加速產品的域名配置
請求方式:post
請求路徑:/ipa/domain/batch-update-domain-configuration-information
使用說明:
- 修改域名之前,您需要先開通對應產品類型的服務,且保證按需服務有效;
- 該域名沒有在途工單;
- 單個用戶一分鐘限制調用10次
請求參數說明:
| 參數名 | 類型 | 是否必選 | 名稱 | 描述 |
|---|---|---|---|---|
| product_code | string | 是 | 產品類型 | 固定值:“009”(應用加速) |
| domain | list< string > | 是 | 域名列表 | 單次調用域名個數最多不超過20個 |
| origin | object | 否 | 回源信息 | 未傳代表不修改 |
| origin.origin_type | int | 否 | 回源方式 | 1:擇優回源方式,2:輪訓回源方式,3:保持登錄回源方式。未傳代表不修改。 |
| origin.probe_port | string | 否 | 探測端口 | |
| origin.detail | list< object > | 否 | 回源角色信息 | 不允許傳空值 |
| origin.detail[*].address | string | 是 | 回源地址 | |
| origin.detail[*].weight | int | 是 | 權重 | |
| origin.detail[*].role | int | 是 | 源站角色 | 1:主,2:備 |
| origin.detail[*].level | int | 是 | 層級 | 角色為主時,層級取值為1;角色為備時,層級取值為1-5 |
| dynamic_cfg | object | 否 | 動態配置 | 未傳代表不修改 |
| dynamic_cfg.route_type | int | 否 | 選路方式 | 1:快速選路,2:穩健選路 |
| dynamic_cfg.kcp | int | 否 | kcp轉發開關 | 1:開啟,2:關閉 |
| dynamic_cfg.package_loss | float | 否 | 丟包率閾值 | 范圍0-1 |
| access_control | object | 否 | 訪問控制 | 未傳代表不修改 |
| access_control.control_switch | int | 是 | ip黑白名單開關 | 1:開啟,2:關閉 |
| access_control.match_type | int | 否 | 匹配方式 | 1:掩碼和ip段匹配,2:字符串匹配;若ip黑白名單開關開啟,則該字段必填 |
| access_control.control_type | int | 否 | 訪問控制類型 | 1:ip黑名單,2:ip白名單;若ip黑白名單開關開啟,則需填寫該字段 |
| access_control.ip_list | string | 否 | ip黑/白名單 | 若ip黑白名單開關開啟,則需填寫該字段,多ip以逗號分隔 |
返回參數說明:
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| 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/ipa/domain/batch-update-domain-configuration-information
請求參數:
{
"product_code": "009",
"domain": [
"a.a1.daliqc.cn",
"a.a2.daliqc.cn",
"a.a3.daliqc.cn",
"a.a4.daliqc.cn"
],
"origin": {
"origin_type": 1,
"detail": [
{
"address": "bbb.daliqc.cn",
"weight": 90,
"role": 1,
"level": 1
}
]
},
"dynamic_cfg": {
"route_type": 1,
"kcp": 1,
"package_loss": 0.8
},
"access_control": {
"control_switch": 1,
"match_type": 2,
"control_type": 1,
"ip_list": "1.1.1.1,2.2.2.2"
}
}
返回結果:
{
"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含義