Querying Tags of a Specified Cluster¶

Function¶

This API is used to query the tag information about a specified cluster.

URI¶

GET /v1.0/{project_id}/css-cluster/{cluster_id}/tags

**Table 1** Parameter description¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.
cluster_id	Yes	String	ID of the cluster to be queried.

Request¶

None

Response¶

Table 2 describes the response parameters.

**Table 2** Response¶
Parameter	Type	Description
tags	Array of tag objects	Tags in a cluster.

**Table 3** **tags** field description¶
Parameter	Type	Description
key	String	Tag key.
value	String	Tag value.

Examples¶

Example request

GET v1.0/458d905f22da49c39f609e3347d65723/css-cluster/4f3deec3-efa8-4598-bf91-560aad1377a3/tags

Example response

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

Status Code¶

Table 4 describes the status code.

**Table 4** Status code¶
Status Code	Message	Description
400	BadRequest	Invalid request. Modify the request instead of retrying.
404	NotFound	The requested resource cannot be found. Modify the request instead of retrying.
200	OK	The request is processed successfully.

last updated: 2024-09-07 00:07