文档首页/ MapReduce服务 MRS/ API参考/ API V1.1/ 标签管理接口/ 查询指定集群的标签-ListClusterTags
更新时间：2026-01-12 GMT+08:00
查看PDF
分享

查询指定集群的标签-ListClusterTags

功能介绍

查询指定集群的标签信息。

接口约束

无

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和受限项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1.1/{project_id}/clusters/{cluster_id}/tags
表1 URI参数说明

名称

是否必选

参数类型

说明

project_id

是

String

参数解释：

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

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

cluster_id

是

String

参数解释：

集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

请求参数

无。

响应参数

状态码： 200

表2 响应参数说明

参数名

参数类型

说明

tags

Array of TagPlain objects

参数解释：

标签列表，请参见表3。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 TagPlain参数说明

参数

参数类型

描述

key

String

参数解释：

标签的键。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

value

String

参数解释：

标签的值。

约束限制：

不涉及

取值范围：

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

默认取值：

不涉及

请求示例

GET /v1.1/{project_id}/clusters/{cluster_id}/tags

响应示例

状态码： 200

操作成功。

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value3"
  } ]
}

状态码

状态码如表4所示。

表4 状态码

状态码

描述

200

操作成功。

错误码

请参见错误码。

父主题： 标签管理接口