Updated on 2025-10-21 GMT+08:00

Deleting Tags in Batches

This API is used to delete tags in batches.

Parameter description

**Table 1** Parameters
Parameter	Mandatory	Description
project_id	Yes	Definition Project ID of a tenant in a region. To obtain the value, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
instance_id	Yes	Definition Instance ID. Constraints N/A Range N/A Default Value N/A

**Table 2** Parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Definition Operation identifier. Constraints N/A Range The value is case-sensitive and is delete for tag deletion. Default Value N/A
tags	Yes	Array of objects	Definition Tag list. For details, see Table 3. Constraints N/A

**Table 3** tags field data structure description
Parameter	Mandatory	Type	Description
key	Yes	String	Definition Tag key. Constraints N/A 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_. Default Value N/A
value	Yes	String	Definition Tag value. Constraints N/A Range It can be left blank or contain a maximum of 255 Unicode characters. It can contain letters, digits, spaces, and special characters _.:=+-@(). Default Value N/A

Delete tags key1 and key2 from a DB instance.

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

For details, see Error Codes.

Parent Topic: Tag Management