接口描述:调用本接口可修改应用加速产品的域名配置
请求方式: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,其他返回异常信息描述 |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/ipa/domain/update-domain
请求参数:
{
"product_code": "009",
"domain": "aaa.ctyun.cn",
"origin": {
"origin_type": 1,
"tcp_ports": [
{
"origin": "80",
"req": "80"
}
],
"udp_ports": [
{
"origin": "90",
"req": "90"
}
],
"detail": [
{
"address": "bbb.ctyun.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含义