Deleting Tags in Batches

Function

This API is used to delete 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 delete during the deletion operation.
tags	Yes	Array of objects	Specifies the tag list. 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	No	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

Delete tags key1 and key2 from a DB instance.

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

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