更新时间：2026-09-02 GMT+08:00
添加集群标签
功能介绍
标签是集群的标识。为集群添加标签，可以方便用户识别和管理拥有的集群资源。
该接口用于给指定集群添加标签。
接口约束
每个集群最多可以设置20个标签。
调用方法
请参见如何调用API。
URI
POST /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：表示是集群类型。 默认取值： 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| tag | 是 | Tag object | 参数解释： 待添加的标签对象。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
响应参数
状态码：204
请求成功。
无
请求示例
添加集群标签。
POST https://{Endpoint}/v1.0/{project_id}/css-cluster/4f3deec3-efa8-4598-bf91-560aad1377a3/tags
{
"tag" : {
"key" : "K1",
"value" : "V1"
}
} 响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 204 | 请求成功。 |
| 400 | 非法请求。 建议直接修改该请求，不要重试该请求。 |
| 409 | 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 |
| 412 | 未满足前提条件，服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。
父主题： 标签管理
