添加指定集群标签
功能介绍
标签是集群的标识。为集群添加标签,可以方便用户识别和管理拥有的集群资源。
该接口用于给指定集群添加标签。
接口约束
每个集群最多可以设置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 |
参数解释: 待添加的标签对象。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
key |
是 |
String |
参数解释: 集群标签的key值。 约束限制:
取值范围: 不涉及 默认取值: 不涉及 |
|
value |
是 |
String |
参数解释: 集群标签的value值。 约束限制:
取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码: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 |
未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。 |
错误码
请参见错误码。