DescribeDNSAliases
更新时间:2023-12-27 03:24:15
可根据资源 ID 作过滤条件,获取内网域名别名列表。 如果不指定任何过滤条件,默认返回你所拥有的所有内网域名别名。
请求参数
参数 | 参数类型 | 描述 | 是否必选 |
---|---|---|---|
dns_aliases.n |
String |
内网域名别名 ID |
No |
resource_id |
String |
按资源 ID 过滤 |
No |
search_word |
String |
搜索关键词,支持内网域名别名ID,内网域名别名名称 |
No |
offset |
Integer |
数据偏移量,默认为0 |
No |
limit |
Integer |
返回数据长度,默认为20,最大100 |
No |
zone |
String |
区域 ID,注意要小写 |
Yes |
返回数据
参数 | 参数类型 | 描述 |
---|---|---|
action |
String |
响应动作 |
dns_alias_set |
Array |
JSON 格式的内网域名别名数据列表,每项数据可见下面 ResponseItemType |
total_count |
Integer |
根据过滤条件得到的内网域名别名总数 |
ret_code |
Integer |
执行成功与否,0 表示成功,其他值则为错误代码 |
ResponseItemType
参数 | 参数类型 | 描述 |
---|---|---|
status |
String |
内网域名别名状态 |
dns_alias_id |
String |
内网域名别名 ID |
resource_id |
String |
内网域名别名关联的资源 ID |
dns_alias_name |
String |
内网域名别名名称 |
create_time |
TimeStamp |
创建时间,为UTC时间,格式可参见 ISO8601. |
示例
请求示例:
https://api.shanhe.com/iaas/?action=DescribeDNSAliases
&dns_aliases.1=da-xxxxxxxx
&COMMON_PARAMS
返回示例:
{
"action":"DescribeDNSAliasesResponse",
"total_count":1,
"dns_alias_set":[
{
"create_time":"2013-08-27T10:02:25Z",
"dns_alias_id":"da-xxxxxxxx",
"dns_alias_name":"",
"resource_id":"i-xxxxxxxx",
"status":"available"
}
],
"ret_code":0
}