根据传入参数获取地址配置信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
alidns:DescribeCloudGtmAddress |
get |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
AcceptLanguage |
string |
否 |
返回结果显示的语言。取值:
|
en-US |
ClientToken |
string |
否 |
用户生成的请求 token。用于保证请求的幂等性。注意 由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符。 |
1ae05db4-10e7-11ef-b126-00163e24**** |
AddressId |
string |
是 |
地址 ID,地址唯一标识码。 |
addr-89518218114368**** |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
唯一请求识别码。 |
B57C121B-A45F-44D8-A9B2-13E5A5044195 |
AddressId |
string |
地址 ID,地址唯一标识码。 |
addr-89518218114368**** |
CreateTime |
string |
地址创建时间。 |
2024-03-23T13:09Z |
CreateTimestamp |
integer |
创建时间(时间戳)。 |
1527690629357 |
UpdateTime |
string |
地址配置的最后修改时间。 |
2024-03-29T13:20Z |
UpdateTimestamp |
integer |
修改时间(时间戳)。 |
1527690629357 |
Name |
string |
地址名称。 |
test |
Type |
string |
地址类型:
|
IPv4 |
Address |
string |
IP 地址或者域名。 |
223.5.XX.XX |
AttributeInfo |
string |
地址归属信息。 |
当前版本不支持此参数,不会返回地址归属信息。 |
Remark |
string |
备注。 |
test1 |
EnableStatus |
string |
表示该地址当前启用状态: enable:启用状态 disable:禁用状态 |
enable |
AvailableMode |
string |
地址探测异常切换方式:
|
auto |
ManualAvailableStatus |
string |
当地址探测异常切换模式为 manual 时,地址设置的可用状态:
|
available |
AvailableStatus |
string |
地址可用状态:
|
available |
HealthStatus |
string |
地址健康检查探测结果:
|
ok |
HealthJudgement |
string |
地址健康状态判定条件:
|
p50_ok |
HealthTasks |
object |
||
HealthTask |
array<object> |
健康探测任务列表。 |
|
object |
地址引用的健康探测任务列表。 |
||
Port |
integer |
健康检查探测的目标地址服务端口,当健康检查选择 Ping 协议时,不支持服务端口的配置。 |
80 |
TemplateId |
string |
地址关联的健康探测模板 ID。 |
mtp-89518052425100**** |
TemplateName |
string |
健康探测模板名称。 |
Ping-IPv4 |
MonitorStatus |
string |
健康探测模板探测任务状态:
|
ok |
示例
正常返回示例
JSON
格式
{
"RequestId": "B57C121B-A45F-44D8-A9B2-13E5A5044195",
"AddressId": "addr-89518218114368****\n",
"CreateTime": "2024-03-23T13:09Z",
"CreateTimestamp": 1527690629357,
"UpdateTime": "2024-03-29T13:20Z",
"UpdateTimestamp": 1527690629357,
"Name": "test",
"Type": "IPv4",
"Address": "223.5.XX.XX",
"AttributeInfo": "当前版本不支持此参数,不会返回地址归属信息。",
"Remark": "test1",
"EnableStatus": "enable",
"AvailableMode": "auto",
"ManualAvailableStatus": "available",
"AvailableStatus": "available",
"HealthStatus": "ok",
"HealthJudgement": "p50_ok",
"HealthTasks": {
"HealthTask": [
{
"Port": 80,
"TemplateId": "mtp-89518052425100****",
"TemplateName": "Ping-IPv4",
"MonitorStatus": "ok"
}
]
}
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。