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.

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

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.
cluster_id	Yes	String	Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI.

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Message body type (format).
X-Auth-Token	Yes	String	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.

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
tags	Yes	Array of ResourceDeleteTag objects	List of cluster resource tags to be deleted

**Table 4** ResourceDeleteTag
Parameter	Mandatory	Type	Description
key	No	String	The key value of the resource tag It cannot be null. It can contain a maximum of 128 characters. It can contain letters, digits, and spaces in UTF-8 format. It can contain the following special characters: _.:/=+-@. It cannot start with _sys_.

None

Deleting 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	No Content

Parent topic: Tag Management

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.