修改IPA域名配置
更新時間 2023-11-02 15:19:37
最近更新時間: 2023-11-02 15:19:37
分享文章
接口描述:調用本接口可修改應用加速產品的域名配置
請求方式:post
請求路徑:/ipa/domain/update-domain
使用說明:
- 修改域名之前,您需要先開通對應產品類型的服務,且保證資源包/按需服務有效;
- 該域名沒有在途工單;
- 單個用戶一分鐘限制調用10次
請求參數說明:
| 參數名 | 類型 | 是否必選 | 名稱 | 描述 |
|---|---|---|---|---|
| product_code | string | 是 | 產品類型 | 固定值:“009”(應用加速) |
| domain | string | 是 | 加速域名 | 需要修改的IPA加速域名,僅支持修改單個域名。 |
| origin | obj | 否 | 回源信息 | 未傳代表不修改 |
| origin.origin_type | int | 否 | 回源方式 | 1:擇優回源方式,2:輪訓回源方式,3:保持登錄回源方式。未傳代表不修改。 |
| origin.tcp_ports | list< object > | 否 | tcp端口列表 | 未傳代表不修改,有傳代表整個數組維度全量修改 |
| origin.tcp_ports[*].origin | str | 否 | tcp回源端口 | 沒傳代表刪除,有傳代表修改 |
| origin.tcp_ports[*].req | str | 是 | tcp請求端口 | tcp端口列表有傳時,該字段必傳,并且不能為空 |
| origin.udp_ports | list< object > | 否 | udp端口列表 | 未傳代表不修改;有傳代表整個數組維度全量修改;傳空數組代表刪除整個udp端口列表;udp數組中如果有元素,那么該元素中的req參數不能是空字符串,即origin: udp_ports不能為空 |
| origin.udp_ports[*].origin | str | 否 | udp回源端口 | 沒傳代表刪除,有傳代表修改 |
| origin.udp_ports[*].req | str | 否 | udp請求端口 | udp回源端口有傳時,該字段必傳,并且不能為空字符串。 |
| origin.probe_port | str | 否 | 探測端口 | |
| origin.detail | list< object > | 否 | 回源角色信息 | 不允許傳空值 |
| origin.detail[*].address | str | 是 | 回源地址 | |
| origin.detail[*].weight | int | 是 | 權重 | |
| origin.detail[*].role | int | 是 | 源站角色 | 1:主,2:備 |
| origin.detail[*].level | int | 是 | 層級 | 角色為主時,層級取值為1;角色為備時,層級取值為1-5 |
| dynamic_cfg | obj | 否 | 動態配置 | 未傳代表不修改 |
| dynamic_cfg.route_type | int | 否 | 選路方式 | 1:快速選路,2:穩健選路 |
| dynamic_cfg.kcp | int | 否 | kcp轉發開關 | 1:開啟,2:關閉 |
| dynamic_cfg.package_loss | float | 否 | 丟包率閾值 | 范圍0-1 |
| access_control | obj | 否 | 訪問控制 | 未傳代表不修改 |
| 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 | str | 否 | ip黑/白名單 | 若ip黑白名單開關開啟,則需填寫該字段,多ip以逗號分隔 |
返回參數說明:
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| code | int | 是 | 狀態碼,成功100000 |
| message | string | 是 | 描述信息,成功返回success,其他返回異常信息描述 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/ipa/domain/update-domain
請求參數:
{
"product_code": "009",
"domain": "aaa.daliqc.cn",
"origin": {
"origin_type": 1,
"tcp_ports": [
{
"origin": "80",
"req": "80"
}
],
"udp_ports": [
{
"origin": "90",
"req": "90"
}
],
"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"
}
錯誤碼請參考:參數code和message含義