Adding Tags to a Specified Cluster

Function

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

A cluster has a maximum of 20 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 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 the MRS Cluster Information.

Request Parameters

Table 2 Request body parameter
Parameter	Mandatory	Type	Description
tag	Yes	Tag object	The cluster tag.

Table 3 tags parameters
Parameter	Mandatory	Type	Description
key	Yes	String	Key. A tag key cannot contain special characters (=*<>\,\|/) or start or end with a space.
value	Yes	String	Tag value. A tag value cannot contain special characters (=*<>\,\|/) or start or end with a space.

Response Parameters

None

Example Request

Add a tag to a specified cluster.

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

Example response

None

Status Codes

Table 4 describes the status code.

Table 4 Status code
Status Code	Description
204	The operation is successful.

Error Codes

See Error Codes.

Parent topic: Tag Management APIs

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

Tag Management APIs

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

Querying Tags of a Specified Cluster

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

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