Help Center/ Cloud Container Engine/ API Reference/ APIs/ Tag Management/ Deleting Resource Tags of a Specified Cluster in Batches

Updated on 2024-03-22 GMT+08:00

View PDF

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 Chinese characters, 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.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel