更新时间:2022-02-22 GMT+08:00

批量添加/删除集群标签

功能介绍

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

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

此接口为幂等接口:

  • 创建时,同一个集群不允许重复key,如果数据库存在就覆盖。
  • 删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。Key长度36个unicode字符,value为43个unicode字符。删除时tags结构体不能缺失,key不能为空,或者空字符串。

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    参数

    是否必选

    描述

    project_id

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

    cluster_id

    集群ID。

请求消息

表2 请求参数说明

参数

是否必选

参数类型

描述

action

String

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

tags

List<resource_tag>

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

表3 tags参数说明

参数

是否必选

参数类型

描述

key

String

键。标签的key值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”,且首尾字符不能为空格。

value

String

值。标签的value值不能包含“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”,且首尾字符不能为空格。

说明:

  • 当添加标签时,该参数必选。
  • 当删除标签时,该参数非必选。

响应消息

响应参数

无。

示例

  • 请求示例
{ 
    "action": "create", 
    "tags": [ 
        { 
            "key": "key1", 
            "value": "value1" 
        }, 
        { 
            "key": "key", 
            "value": "value3" 
        } 
    ] 
} 
  • 响应示例

    无。

状态码

状态码如表4所示。

表4 状态码

状态码

描述

204

操作成功。