DescribeDNSAliases
可根据资源 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.qingcloud.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
}