文档首页/ 分布式消息服务Kafka版/ API参考(巴黎区域)/ API V2（推荐）/ 标签管理/ 批量添加或删除实例标签
更新时间：2023-08-16 GMT+08:00
查看PDF
分享

批量添加或删除实例标签

功能介绍

批量添加或删除实例标签。

URI

POST /v2/{project_id}/kafka/{instance_id}/tags/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID，获取方式请参见获取项目ID。

instance_id

是

String

实例ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

action

否

String

操作标识（仅支持小写）:

  • create（创建）

  • delete（删除）

tags

否

Array of TagEntity objects

标签列表。
表3 TagEntity

参数

是否必选

参数类型

描述

key

否

String

键。

key不能为空，长度1~128个字符（中文也可以输入128个字符）。

可用UTF-8格式表示的字母、数字和空格，以及以下字符： _ . : = + - @

key两头不能有空格字符。

value

否

String

值。

长度0~255个字符（中文也可以输入255个字符）。

可用UTF-8格式表示的字母、数字和空格，以及以下字符： _ . : / = + - @。

value可以为空字符串。

响应参数

无

请求示例

创建实例标签，标签名为key1、key2，值为value1、value2。

POST https://{endpoint}/v2/{project_id}/kafka/{instance_id}/tags/action

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value2"
  } ]
}

响应示例

无

状态码

状态码

描述

204

批量添加或删除实例标签成功。

错误码

请参见错误码。

父主题： 标签管理