Batch Adding or Deleting Tags

Function

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

URI

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain it, 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	Key. A key can contain 1 to 128 characters. Include UTF-8 letters, digits, spaces, or the following special characters _.:=+-@ Do not use spaces to start or end the key.
value	No	String	Value. A value can contain 0 to 255 characters. Include UTF-8 letters, digits, spaces, or the following special characters _.:/=+-@ A value can be an empty string.

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}/kafka/{instance_id}/tags/action

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