Adding Tags in Batches

Function

This API is used to add tags in batches.

Before calling an API, you need to understand the API in Authentication.

URI

URI format
POST /v3/{project_id}/instances/{instance_id}/tags/action

Parameter description

**Table 1** Parameter description
Name	Mandatory	Description
project_id	Yes	Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID.
instance_id	Yes	Specifies the DB instance ID.

Request

**Table 2** Parameter description
Name	Mandatory	Type	Description
action	Yes	String	Specifies the operation identifier (case sensitive), which is create during the creation operation.
tags	Yes	Array of objects	Specifies the tag list. A maximum of 20 tags can be added for each instance. For details, see Table 3.

**Table 3** tags field data structure description
Name	Mandatory	Type	Description
key	Yes	String	Tag key. It must consist of 1 to 128 Unicode characters, including letters, digits, spaces, and special characters _.:=+-@. However, it cannot start or end with a space, or start with _sys_.
value	Yes	String	Tag value. It can be left blank or contain a maximum of 255 Unicode characters, including letters, digits, spaces, and special characters _.:=+-@.

Example Request

Add tags key1 and key2 for a DB instance.

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action

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