更新时间:2022-12-14 GMT+08:00

批量删除集群标签

功能介绍

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

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

此接口为幂等接口:

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

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目编号。获取方法,请参见获取项目ID

cluster_id

String

集群ID。获取方法,请参见获取集群ID

请求参数

表2 请求参数说明

参数

是否必选

参数类型

描述

action

String

操作标识:仅限于create(创建)、delete(删除)。

tags

Array of tag objects

标签列表,参数说明,请参见表3

表3 tags参数说明

参数

是否必选

参数类型

描述

key

String

键。

  • 最大长度36个unicode字符,不能为空字符串。
  • 同一资源的key值不能重复。

value

String

值。

  • 最大长度43个unicode字符,可以为空字符串。

响应参数

请求示例

批量刪除

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

{
  "action" : "delete",
  "tags" : [ {
    "tag" : null,
    "key" : "DEV1",
    "value" : "DEV1"
  }, {
    "tag" : null,
    "key" : "DEV2",
    "value" : "DEV2"
  } ],
  "x-request-examples-text-1" : "{\n    \"action\":\"create\",\n    \"tags\":[\n        {\n            \"key\":\"DEV1\",\n            \"value\":\"DEV1\"\n        }.{\n            \"key\":\"DEV2\",\n            \"value\":\"DEV2\"\n        }]\n}"
}

响应示例

状态码

状态码请参见状态码

错误码

请参见错误码