接口描述:调用本接口查询IP可用状态
请求方式:get
请求路径:/ip/query-ip-status
使用说明: 单个用户一分钟限制调用10000次,并发不超过100
请求参数说明:
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
vips | 是 | string | vip列表,最多支持10个ip查询,多IP使用逗号分隔。若超过限制,则只返回最前面的10个。 | 1.1.1.1 |
返回参数说明:
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
code | 是 | int | 状态码 | 成功100000 | |
message | 是 | string | 信息描述 | 成功返回success,其他返回异常信息描述 | |
result | 否 | list< object> | 节点IP地址状态列表 | result_single |
表result_single
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
ip | 否 | string | 节点ip地址 | 1.1.1.1 | |
status | 否 | string | ip状态,normal(正常),abnormal(非正常),no_ctyun(非天翼云ip) | normal |
示例:
请求路径:https://cdnapi-global.ctapi.ctyun.cn/ip/query-ip-status
请求:https://cdnapi-global.ctapi.ctyun.cn/ip/query-ip-status?vips=1.1.1.1,2.2.2.2
返回结果:
{
"result": [
{
"ip": "1.1.1.1",
"status": "no_ctyun"
},
{
"ip": "2.2.2.2",
"status": "no_ctyun"
}
],
"code": 100000,
"message": "success"
}
错误码请参考:参数code和message含义