批量删除集群标签-BatchDeleteClusterTags

功能介绍

为指定集群批量删除标签。

一个集群上最多有20个标签。

此接口为幂等接口：

删除时，如果删除的标签不存在，默认处理成功，删除时不对标签字符集范围做校验。Key长度128个unicode字符，value为255个unicode字符。删除时tags结构体不能缺失，key不能为空，或者空字符串。

接口约束

无

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和受限项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

POST /v1.1/{project_id}/clusters/{cluster_id}/tags/action

表1 参数说明
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目编号。获取方法，请参见获取项目ID。约束限制：不涉及取值范围：只能由英文字母和数字组成，且长度为[1-64]个字符。默认取值：不涉及
cluster_id	是	String	参数解释：集群ID。如果指定集群ID，则获取该集群做过补丁更新的最新版本元数据。获取方法，请参见获取集群ID。约束限制：不涉及取值范围：只能由英文字母、数字以及“_”和“-”组成，且长度为[1-64]个字符。默认取值：不涉及

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
action	是	String	参数解释：操作标识：仅限于delete（删除）。约束限制：不涉及取值范围： delete：删除标签。默认取值：不涉及
tags	是	Array of tag objects	参数解释：标签列表，参数说明，请参见表3。约束限制：不涉及取值范围：不涉及默认取值：不涉及

表3 Tag
参数	是否必选	参数类型	描述
key	是	String	标签的键。最大长度128个字符，不能为空字符串。同一资源的key值不能重复。标签的key值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。
value	是	String	参数解释：标签的键。约束限制：不涉及取值范围：最大长度128个字符，不能为空字符串。同一资源的key值不能重复。标签的key值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。默认取值：不涉及参数解释：标签的值。约束限制：不涉及取值范围：最大长度255个字符，可以为空字符串。标签的value值可以包含任意语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。默认取值：不涉及

响应参数

无

请求示例

批量删除

POST /v1.1/{project_id}/clusters/{cluster_id}/tags/action

{
  "action" : "delete",
  "tags" : [ {
    "key" : "DEV1",
    "value" : "DEV1"
  }, {
    "key" : "DEV2",
    "value" : "DEV2"
  } ]
}