Querying Tags of a Specified Cluster

Function

This API is used to query tags of a specified cluster.

URI

  • Format

    GET /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

Request parameters

None.

Response

Table 2 Response parameter description

Parameter

Type

Description

tags

Array of objects

Tag list. For details, see Table 3.

Table 3 tags parameter description

Parameter

Type

Description

key

String

Key. A tag key can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).

value

String

Tag value. A tag value can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).

Example

  • Example request

    None.

  • Example response

    {
           "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value3"
            }
        ]
    }
    

Status Code

Table 4 describes the status code of this API.

Table 4 Status code

Status Code

Description

200

The operation is successful.