查询特定标签的集群列表

project_id

是

String

参数解释：

项目编号。获取方法，请参见获取项目ID。

约束限制：

不涉及

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及

tags

否

Array of TagWithMultiValue objects

参数解释：

返回结果包含该参数中所有标签对应的资源。

约束限制：

该参数最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。

tags_any

否

Array of TagWithMultiValue objects

参数解释：

返回结果包含该参数中任意一个标签对应的资源。

约束限制：

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

not_tags

否

Array of TagWithMultiValue objects

参数解释：

返回结果不包含该参数中所有标签对应的资源。

约束限制：

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

not_tags_any

否

Array of TagWithMultiValue objects

参数解释：

返回结果不包含该参数中任意一个标签对应的资源。

约束限制：

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

action

是

String

参数解释：

操作标识（仅限于filter，count），如果是filter则为分页查询，如果是count会按照条件将总条数返回。

约束限制：

不涉及

取值范围：

• filter：过滤

• count：查询总条数

默认取值：

不涉及

limit

否

Integer

参数解释：

查询记录数。

约束限制：

action为count时无此参数。如果action为filter默认为1000。

取值范围：

1-1000

默认取值：

不涉及

offset

否

Integer

参数解释：

索引位置，从offset指定的下一条数据开始查询。查询第一页数据时，不需要传入此参数，查询后续页码数据时，将查询前一页数据时响应体中的值带入此参数。

约束限制：

action为count时无此参数。如果action为filter默认为0。

取值范围：

≥0

默认取值：

不涉及

matches

否

Array of Match objects

参数解释：

搜索字段，key为要匹配的字段，如resource_name等。value为匹配的值。此字段为固定字典值。根据不同的字段确认是否需要模糊匹配，如resource_name默认为模糊搜索，如果value为空字符串精确匹配。

约束限制：

不涉及

key

是

String

参数解释：

标签的键。

约束限制：

不涉及

取值范围：

标签的key值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。

默认取值：

不涉及

values

否

Array of strings

参数解释：

标签的值。

约束限制：

标签的value值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。

key

否

String

参数解释：

键。当前只有resource_name可用，表示集群的名称，后续扩展。

约束限制：

不涉及

取值范围：

长度为[1-64]个字符。

默认取值：

不涉及

value

否

String

参数解释：

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

约束限制：

不涉及

取值范围：

长度为[0-64]个字符。

默认取值：

不涉及

resources

Array of MRSResource objects

参数解释：

资源列表。

total_count

Integer

参数解释：

资源总数。

取值范围：

不涉及

resource_id

String

参数解释：

资源ID。

取值范围：

不涉及

resource_detail

String

参数解释：

资源详情。

取值范围：

不涉及

tags

Array of TagPlain objects

参数解释：

标签。

resource_name

String

参数解释：

资源名称。

取值范围：

不涉及

key

String

参数解释：

标签的键。

取值范围：

标签的key值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。

value

String

参数解释：

标签的值。

取值范围：

标签的value值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。

200

操作成功。