更新时间:2026-01-12 GMT+08:00

查询所有标签

功能介绍

该接口用于查询用户在当前项目下所有标签的集合,包括键key、值value,方便用户使用标签对集群进行分组管理。

调用方法

请参见如何调用API

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID

默认取值

不涉及

resource_type

String

参数解释

资源类型,当前固定值为“css-cluster”,表示是集群类型。

约束限制

不涉及

取值范围

css-cluster:表示是集群类型。

默认取值

不涉及

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

tags

Array of ShowAllTagsTagsResp objects

参数解释

集群的标签列表。

取值范围

不涉及

表3 ShowAllTagsTagsResp

参数

参数类型

描述

key

String

参数解释

集群标签的key值。

取值范围

不涉及

values

Array of strings

参数解释

集群标签的value值列表。

取值范围

不涉及

请求示例

查询该项目下所有的集群标签。

GET https://{Endpoint}/v1.0/{project_id}/css-cluster/tags

响应示例

状态码:200

请求已成功。

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ]
}

状态码

状态码

描述

200

请求已成功。

400

非法请求。

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

404

所请求的资源不存在。

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

错误码

请参见错误码