Function

This API is used to add a tag to a specified cluster.

A cluster has a maximum of 10 tags. This API is idempotent. If a tag to be created has the same key as an existing tag, the tag will overwrite the existing one.

URI

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

Parameter description

**Table 1** URI parameter description
Parameter	Mandatory	Description
project_id	Yes	Project ID. For details on how to obtain the project ID, see Obtaining a Project ID.
cluster_id	Yes	Cluster ID

Request

**Table 2** **tags** parameter description
Parameter	Mandatory	Type	Description
key	Yes	String	Key. A tag key can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).
value	Yes	String	Tag value. A tag value can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).

Response

Response parameters

None.

Example

Example request

{ 
    "tag": 
        { 
            "key":"DEV", 
            "value":"DEV1" 
        } 
}

Example response
None.

Status Code

Table 3 describes the status code of this API.

**Table 3** Status code
Status Code	Description
204	The operation is successful.

Adding a Tag to a Specified Cluster

Function

URI

Request

Response

Example

Status Code