Advanced
Тема интерфейса

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