Updated on 2026-09-30 GMT+08:00

Deleting Resource Tags of a Specified Cluster in Batches

This API is used to delete resource tags of a specified cluster in batches.

This API is idempotent. If the tag key of the to-be-deleted tag does not exist, the tag will be deleted.

For details, see Calling APIs.

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/delete

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Details: Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Project IDs of the account Default value: N/A
cluster_id	Yes	String	Details: Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Definition: Type (or format) of the request body. The default value is application/json. Other values of this field will be provided for specific APIs, if any. Constraints: GET requests are not validated. Range: N/A Default Value: N/A
X-Auth-Token	Yes	String	Details: Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. Constraints: None Options: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	Array of ResourceDeleteTag objects	Definition: List of cluster resource tags to be deleted Constraints: When deleting a tag, you only need to specify the key, and the value will be ignored. Range: 1 to 20 ResourceDeleteTag objects Default Value: N/A

**Table 4** ResourceDeleteTag
Parameter	Mandatory	Type	Description
key	No	String	Definition: Tag key Constraints: The tag key cannot be an empty string and can contain a maximum of 128 characters. Only letters, digits, and spaces in UTF-8 format are allowed. The following special characters are allowed: _.:/=+-@ The tag key cannot start with *sys. Range: N/A Default Value*: N/A

Status code: 204

None

Delete resource tags of a specified cluster in batches.

POST /api/v3/projects/{project_id}/clusters/{cluster_id}/tags/delete

{
  "tags" : [ {
    "key" : "key1"
  }, {
    "key" : "key2"
  } ]
}

None

Status Code	Description
204	Batch deleting specified cluster resource tags succeeded.

Parent topic: Tag Management