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.
Before calling this API, learn about request header parameters.

URI

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

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Explanation: Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID. Constraints: N/A Value range: N/A Default value: N/A
instance_id	Yes	Explanation: Instance ID. Constraints: N/A Value range: N/A Default value: N/A

Request

**Table 2** Parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Explanation: Operation identifier. Constraints: N/A Value range: The value is case-sensitive and is create for tag creation. Default value: N/A
tags	Yes	Array of objects	Explanation: Tag list. A maximum of 10 tags can be added for each instance. For details, see Table 3. Constraints: N/A

**Table 3** tags field data structure description
Parameter	Mandatory	Type	Description
key	Yes	String	Explanation: Tag key. Constraints: N/A Value range: The value must consist of 1 to 128 Unicode characters. It can contain letters, digits, spaces, and special characters _.:=+-@. However, it cannot start or end with a space, or start with _sys_. It can contain uppercase and lowercase letters, digits, hyphens (-), underscores (_), and Unicode characters (\u4E00-\u9FFF). Default value: N/A
value	Yes	String	Explanation: Tag value. Constraints: N/A Value range: It can be left blank or contain a maximum of 255 Unicode characters. It can contain letters, digits, spaces, and special characters _.:=+-@. It can contain uppercase and lowercase letters, digits, periods (.), hyphens (-), underscores (_), and Unicode characters (\u4E00-\u9FFF). Default value: N/A

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"
	}]
}