弹性伸缩 AS-查询资源实例:请求参数

时间:2024-07-22 11:16:34

请求参数

表2 请求参数

参数

是否必选

参数类型

描述

tags

Array of Tag objects

过滤条件,包含标签,最多包含10个Key,结构体不能缺失,详情请见表 Tag字段数据结构说明

tags_any

Array of Tag objects

过滤条件,包含任意标签,最多包含10个Key,详情请见表 Tag字段数据结构说明

not_tags

Array of Tag objects

过滤条件,不包含标签,最多包含10个Key,详情请见表 Tag字段数据结构说明

not_tags_any

Array of Tag objects

过滤条件,不包含任意标签,最多包含10个Key,详情请见表 Tag字段数据结构说明

limit

String

查询记录数,最大值为1000,不能为负数,最小值为1。

  • 如果action的值为count,此参数无效。
  • 如果action的值为filter,limit默认为1000。

marker

String

分页位置标识(索引位置)。推荐使用offset字段设置索引位置。

分页位置标识(资源ID或索引位置)。

action

String

操作标识,包括filter和count两种。

  • filter(过滤):表示按标签过滤资源,返回符合条件的资源列表。此时,为分页查询。
  • count(查询总条数):表示按标签搜索资源,返回符合条件的资源个数。

offset

String

索引位置,从offset指定的下一条数据开始查询。必须为数字,不能为负数。

查询第一页数据时,不需要传入此参数。查询后续页码数据时,将查询前一页数据时响应体中的offset值带入此参数。

  • 如果action的值为count,此参数无效。
  • 如果action的值为filter,offset默认为0。

matches

Array of match objects

模糊搜索字段,详情请见表 match字段数据结构说明

表3 Tag字段数据结构说明

参数

是否必选

参数类型

描述

key

String

资源标签键。最大长度36个unicode字符。key不能为空。(搜索时不对此参数做校验)。最多为10个,不能为空或者空字符串。且不能重复。

values

Array of strings

资源标签值列表,每个值最大长度43个unicode字符,每个key下最多为10个,同一个key中values不能重复。

  • “*”为系统保留字符,如果value是以“*”开头表示按照“*”后面的值全模糊匹配。不能只传入“*”。
  • 如果values为空列表但不可缺省,则表示any_value(查询任意value)。value之间为或的关系。
表4 match字段数据结构说明

参数

是否必选

参数类型

描述

key

String

键,表示要匹配的字段。

当前key的参数值只能取“resource_name”。

value

String

值。为固定字典值。每个值最大长度255个unicode字符。若为空字符串、resource_id时为精确匹配。

support.huaweicloud.com/api-as/as_06_1004.html