更新时间:2023-08-16 GMT+08:00

批量添加或删除实例标签

功能介绍

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

URI

POST /v2/{project_id}/rocketmq/{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}/rocketmq/{instance_id}/tags/action

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

响应示例

状态码

状态码

描述

204

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

错误码

请参见错误码