Updated on 2022-12-14 GMT+08:00

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 10 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

project_id

Yes

String

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

cluster_id

Yes

String

Cluster ID For details about how to obtain the cluster ID, see Obtaining a Cluster ID.

Request Parameters

Table 2 Request parameters

Parameter

Mandatory

Type

Description

action

Yes

String

Operation to be performed. The value can be set to create or delete only.

tags

Yes

Array of tag objects

Tag list. For details about the parameter, see Table 3.

Table 3 tags parameters

Parameter

Mandatory

Type

Description

key

Yes

String

The tag key.

  • It contains a maximum of 36 Unicode characters and cannot be an empty string.
  • The tag key of a resource must be unique.

value

Yes

String

The value.

  • The value contains a maximum of 43 Unicode characters and can be an empty string.

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

Example Response

None

Status Codes

See Status Codes.

Error Codes

See Error Codes.