Adding Tags to a Cluster in Batches

Function

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

A cluster can have a maximum of 20 tags.

This API is idempotent. If a tag to be created has the same key as an existing tag in a cluster, the tag will overwrite the existing one.

URI

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

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
cluster_id	Yes	String	Explanation Cluster ID If this parameter is specified, the latest metadata of the cluster that has been patched will be obtained. For details about how to obtain the cluster ID, see Obtaining a Cluster ID. Constraints N/A Value range The value can contain 1 to 64 characters, including only letters, digits, underscores (_), and hyphens (-). Default value N/A
project_id	Yes	String	Explanation Project ID. For details about how to obtain the project ID, see Obtaining a Project ID. Constraints N/A Value range The value must consist of 1 to 64 characters. Only letters and digits are allowed. Default value N/A

Request Parameters

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Explanation Operation to be performed. The value can be create only. Constraints N/A Value range create: Create a tag. Default value N/A
tags	Yes	Array of tag objects	Explanation Tag list. For details, see Table 3. Constraints N/A

**Table 3** tags parameters
Parameter	Mandatory	Type	Description
key	Yes	String	Explanation Tag key. Constraints N/A Value range The value can contain a maximum of 128 characters and cannot be an empty string. The tag key of a resource must be unique. A tag key can contain letters, digits, spaces, and special characters (_.:=+-@), but cannot start or end with a space or start with _sys_. Default value N/A
value	Yes	String	Explanation Tag value. Constraints N/A Value range The value can contain a maximum of 255 characters and can be an empty string. A tag value can contain letters, digits, spaces, and special characters (_.:=+-@), but cannot start or end with a space or start with _sys_. Default value N/A

Response Parameters

None

Example Request

Add tags to a cluster in batches.

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

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