Adding or Deleting Instance Tags in Batches

Function

This API is used to add or delete instance tags in batches.

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
action	No	String	Operation. Only lowercase letters are supported. create: Tags are created. delete: Tags are deleted.
tags	No	Array of TagEntity objects	Tag list.

**Table 3** TagEntity
Parameter	Mandatory	Type	Description
key	No	String	Tag key. Must be specified. Must be unique for the same instance. Can contain 1 to 128 characters. Can contain letters, digits, spaces, and special characters _.:=+-@ Cannot start or end with a space.
value	No	String	Tag value. Can contain 0 to 255 characters. Can contain letters, digits, spaces, and special characters _.:=+-@ Cannot start or end with a space.

Response Parameters

None

Example Requests

Creating instance tags with tag keys key1 and key2 and tag values value1 and value2

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

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