Updated on 2024-06-07 GMT+08:00

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

Response

Status Code

Error Code

For details, see Error Codes.