虚拟私有云 VPC-查询子网资源实例:请求参数

时间:2023-11-01 16:25:15

请求参数

表2 请求参数

参数名称

类型

是否必选

说明

tags

Array of tag objects

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

limit

Integer

查询记录数(action为count时无此参数)如果action为filter默认为1000,limit最多为1000,不能为负数,最小值为1

offset

Integer

(索引位置), 从offset指定的下一条数据开始查询。 查询第一页数据时,不需要传入此参数,查询后续页码数据时,将查询前一页数据时响应体中的值带入此参数(action为count时无此参数)如果action为filter默认为0,必须为数字,不能为负数

action

String

操作标识(仅限于filter,count):filter(过滤),count(查询总条数)

如果是filter就是分页查询,如果是count只需按照条件将总条数返回即可。

matches

Array of match objects

搜索字段,key为要匹配的字段,当前仅支持resource_name。value为匹配的值。此字段为固定字典值。

表3 tag字段数据结构说明

名称

是否必选

参数类型

说明

key

String

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

values

Array of strings

值列表。每个值最大长度255个unicode字符,如果values为空列表,则表示any_value。value之间为或的关系。

表4 match字段数据结构说明

名称

是否必选

参数类型

说明

key

String

键。当前仅限定为resource_name

value

String

值。每个值最大长度255个unicode字符。

support.huaweicloud.com/api-vpc/subnet_tag_0005.html