Help Center/ Cloud Container Engine/ API Reference (Ankara Region)/ APIs/ Tag Management/ Deleting Resource Tags of a Specified Cluster in Batches
Updated on 2024-12-04 GMT+08:00

Deleting Resource Tags of a Specified Cluster in Batches

Function

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.

URI

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.

Request Parameters

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_.

Response Parameters

None

Example Requests

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

Example Responses

None

Status Codes

Status Code

Description

204

No Content

Error Codes

See Error Codes.