批量添加指定集群的资源标签
功能介绍
该API用于批量添加指定集群的资源标签。

-
每个集群支持最多20个资源标签。
-
此接口为幂等接口:创建时,如果创建的标签已经存在(key/value均相同视为重复),默认处理成功;key相同,value不同时会覆盖原有标签。
URI
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/create
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID,获取方式请参见如何获取接口URI中参数。 约束限制: 不涉及 取值范围: 账号的项目ID 默认取值: 不涉及 |
cluster_id |
是 |
String |
参数解释: 集群ID,获取方式请参见如何获取接口URI中参数。 约束限制: 不涉及 取值范围: 集群ID 默认取值: 不涉及 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
参数解释: 消息体的类型(格式) 约束限制: GET方法不做校验 取值范围:
默认取值: 不涉及 |
X-Auth-Token |
是 |
String |
参数解释: 调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
tags |
是 |
Array of ResourceTag objects |
待创建的集群资源标签列表。单集群资源标签总数上限为20。 |
响应参数
状态码:204
No Content
无
请求示例
批量添加指定集群的资源标签
POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/create { "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value3" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
No Content |
错误码
请参见错误码。