更新时间：2026-09-02 GMT+08:00

查询指定集群的标签

标签是集群的标识。为集群添加标签，可以方便用户识别和管理拥有的集群资源。您可以在创建集群时添加标签，也可以在集群创建完成后，在集群的详情页添加标签。该接口用于查询指定集群的标签信息，方便用户对集群进行管理。

GET /v1.0/{project_id}/{resource_type}/{cluster_id}/tags

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID。获取方法请参见获取项目ID和名称。约束限制：不涉及取值范围：账户的项目ID。默认取值：不涉及
cluster_id	是	String	参数解释：指定查询的集群ID。获取方法请参见获取集群ID。约束限制：不涉及取值范围：集群ID。默认取值：不涉及
resource_type	是	String	参数解释：集群资源类型，当前固定值为“css-cluster”，表示是集群类型。约束限制：不涉及取值范围： css-cluster：表示是集群类型。默认取值：不涉及

无

状态码：200

表2 响应Body参数
参数	参数类型	描述
tags	Array of ShowTagsTagsResp objects	参数解释：集群标签列表。取值范围：不涉及

表3 ShowTagsTagsResp
参数	参数类型	描述
key	String	参数解释：集群标签的key值。取值范围：不涉及
value	String	参数解释：集群标签的value值。取值范围：不涉及

查询集群的标签。

GET https://{Endpoint}/v1.0/{project_id}/css-cluster/4f3deec3-efa8-4598-bf91-560aad1377a3/tags

状态码：200

请求成功。

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

状态码	描述
200	请求成功。
400	非法请求。建议直接修改该请求，不要重试该请求。
404	所请求的资源不存在。建议直接修改该请求，不要重试该请求。

描述

200

请求成功。

400

非法请求。

建议直接修改该请求，不要重试该请求。

404

所请求的资源不存在。

建议直接修改该请求，不要重试该请求。

请参见错误码。

父主题： 标签管理