文档首页> MapReduce服务 MRS> API参考> API V1.1> 标签管理接口> 查询特定标签的集群列表
更新时间：2023-10-16 GMT+08:00
查看PDF

查询特定标签的集群列表

功能介绍

使用标签过滤集群。

集群默认按照创建时间倒序，集群tag也按照创建时间倒序。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

  • URI格式

    POST /v1.1/{project_id}/clusters/resource_instances/action

  • 参数说明
    表1 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    是

    String

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

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of TagWithMultiValue objects

返回结果包含该参数中所有标签对应的资源，该参数最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。参数说明请参见表3。

tags_any

否

Array of TagWithMultiValue objects

返回结果包含该参数中任意一个标签对应的资源，该参数最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。参数说明请参见表3。

not_tags

否

Array of TagWithMultiValue objects

返回结果不包含该参数中所有标签对应的资源，该参数最多包含10个key，每个key下面的value最多10个, 结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。参数说明请参见表3。

not_tags_any

否

Array of TagWithMultiValue objects

返回结果不包含该参数中任意一个标签对应的资源，该参数最多包含10个key，每个key下面的value最多10个，结构体不能缺失，key不能为空或者空字符串。Key不能重复，同一个key中values不能重复。参数说明请参见表3。

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为匹配的值。此字段为固定字典值。

根据不同的字段确认是否需要模糊匹配，如resource_name默认为模糊搜索，如果value为空字符串精确匹配。参数说明请参见表4。
表3 TagWithMultiValue

名称

是否必选

参数类型

说明

key

是

String

键。标签的key值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”，且首尾字符不能为空格。

values

否

Array of strings

值列表。

标签的value值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”，且首尾字符不能为空格。
表4 Match

名称

是否必选

参数类型

说明

key

否

String

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

value

否

String

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

响应参数

表5 响应参数说明

参数名

参数类型

说明

resources

Array of MRSResource objects

资源详情，请参见表6。

total_count

Integer

资源总数。
表6 MRSResource

参数名

参数类型

说明

resource_detail

String

资源详情。

resource_id

String

资源ID。

resource_name

String

资源名称。

tags

Array of TagPlain objects

标签列表，请参见表7。
表7 TagPlain

参数

参数类型

描述

key

String

键。标签的key值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”，且首尾字符不能为空格。

value

String

值。标签的value值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”，且首尾字符不能为空格。

请求示例

  • 查询action为filter时的集群列表
    POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action

{
  "offset" : "100",
  "limit" : "100",
  "action" : "filter",
  "matches" : [ {
    "key" : "resource_name",
    "value" : "clusterA"
  } ],
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ]
}
  • 查询action为count时的集群列表
    POST https://{endpoint}/v1.1/{project_id}/{resource_type}/resource_instances/action

{
  "action" : "count",
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "matches" : [ {
    "key" : "resource_name",
    "value" : "clusterA"
  } ]
}

响应示例

状态码：200

操作成功。

{
  "resources" : [ {
    "resource_detail" : null,
    "resource_id" : "cdfs_cefs_wesas_12_dsad",
    "resource_name" : "clusterA",
    "tags" : [ {
      "key" : "key1",
      "value" : "value1"
    }, {
      "key" : "key2",
      "value" : "value1"
    } ]
  } ],
  "total_count" : "1000"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： 标签管理接口