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