Deleting Tags from a Cluster in Batches

Function

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

A cluster can have a maximum of 20 tags.

This API is idempotent.

When tags are being deleted and some tags do not exist, the operation is considered to be successful by default. The character set of the tags will not be checked. A key and a value can respectively contain up to 128 and 255 Unicode characters. The tags structure cannot be missing. The key cannot be empty or an empty string.

URI

POST /v1.1/{project_id}/clusters/{cluster_id}/tags/action

Table 1 URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	The project ID. For details about how to obtain the project ID, see Obtaining a Project ID.
cluster_id	Yes	String	The cluster ID. For details about how to obtain the cluster ID, see Obtaining a Cluster ID.

Request Parameters

Table 2 Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Operation to be performed. The value can be create or delete only.
tags	Yes	Array of tag objects	The tag list. For details about the parameter, see Table 3.

Table 3 Tag
Parameter	Mandatory	Type	Description
key	Yes	String	The tag key. The tag key cannot start or end with spaces or contain non-printable ASCII characters (0–31) and special characters (=*<>\,\|/). It can contain a maximum of 128 Unicode characters and cannot be an empty string. The tag key of a resource must be unique.
value	Yes	String	The value. The tag value cannot start or end with spaces or contain non-printable ASCII characters (0–31) and special characters (=*<>\,\|/). The value can contain a maximum of 255 Unicode characters and can be an empty string.

Response Parameters

None

Example Request

Delete tags from a cluster in batches.

POST /v1.1/{project_id}/clusters/{cluster_id}/tags/action

{
  "action" : "delete",
  "tags" : [ {
    "key" : "DEV1",
    "value" : "DEV1"
  }, {
    "key" : "DEV2",
    "value" : "DEV2"
  } ]
}

Example Response

None

Status Codes

See Status Codes.

Error Codes

See Error Codes.

Parent topic: Tag Management APIs

Предыдущая статья

Adding Tags to a Cluster in Batches

Следующая статья

Querying All Tags

Была ли эта статья полезна?

Поддержка Юридические документы