更新时间:2026-01-12 GMT+08:00
查询指定集群的标签
功能介绍
标签是集群的标识。为集群添加标签,可以方便用户识别和管理拥有的集群资源。您可以在创建集群时添加标签,也可以在集群创建完成后,在集群的详情页添加标签。该接口用于查询指定集群的标签信息,方便用户对集群进行管理。
调用方法
请参见如何调用API。
URI
GET /v1.0/{project_id}/{resource_type}/{cluster_id}/tags
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID。获取方法请参见获取项目ID和名称。 约束限制: 不涉及 取值范围: 账户的项目ID。 默认取值: 不涉及 |
| cluster_id | 是 | String | 参数解释: 指定查询的集群ID。获取方法请参见获取集群ID。 约束限制: 不涉及 取值范围: 集群ID。 默认取值: 不涉及 |
| resource_type | 是 | String | 参数解释: 集群资源类型,当前固定值为“css-cluster”,表示是集群类型。 约束限制: 不涉及 取值范围: css-cluster:表示是集群类型。 默认取值: 不涉及 |
请求参数
无
请求示例
查询集群的标签。
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 | 所请求的资源不存在。 建议直接修改该请求,不要重试该请求。 |
错误码
请参见错误码。
父主题: 集群管理