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

查询指定集群的标签

功能介绍

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

接口约束

无

调试

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

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

操作成功。

错误码

请参见错误码。

父主题： 标签管理接口