云解析服务 DNS-使用标签查询资源实例:请求参数

时间:2023-11-20 15:56:42

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

tags

Array of tagValues objects

包含标签。 最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。

tags_any

Array of tagValues objects

最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。

not_tags

Array of tagValues objects

最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。

not_tags_any

Array of tagValues objects

最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。

limit

Integer

每页返回的资源个数。 取值范围:1~1000 参数取值说明: 如果action为filter时,默认为1000。 如果action为count时,无此参数。

offset

Integer

分页查询起始偏移量,表示从偏移量的下一个资源开始查询。 取值范围:0~2147483647 默认值为0。 参数取值说明: 查询第一页数据时,不需要传入此参数。 查询后续页码数据时,将查询前一页数据时响应体中的值带入此参数。 如果action为filter时,默认为0,必须为数字,不能为负数。 如果action为count时,无此参数。

action

String

操作标识(区分大小写)。 取值范围: filter:分页过滤查询 count:查询总条数

matches

Array of match objects

key为要匹配的字段,value为匹配的值。 如果value为空字符串则精确匹配,否则模糊匹配。

表4 tagValues

参数

是否必选

参数类型

描述

key

String

键。最大长度127个unicode字符。 key不能为空。(搜索时不对此参数做校验)

values

Array of strings

值列表。每个值最大长度255个unicode字符。为系统保留字符。如果里面的value是以开头时,表示按照*后面的值全模糊匹配。如果values缺失,则表示匹配任意值。value之间为或的关系。

表5 match

参数

是否必选

参数类型

描述

key

String

键。当前值限定为resource_name。

value

String

值。每个值最大长度255个unicode字符。不能包含“_”,“%”特殊字符。

support.huaweicloud.com/api-dns/ListTag.html