Querying Tags of a Specified Cluster

Updated on 2025-05-22 GMT+08:00

View PDF

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

GET /v1.0/{project_id}/{resource_type}/{cluster_id}/tags

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Parameter description: The project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name. Constraints: N/A Options: For details about how to obtain the project ID and name, see Obtaining the Project ID and Name. Default value: N/A
cluster_id	Yes	String	Parameter description: ID of the cluster you want to query. Constraints: N/A Options: For details about how to obtain the cluster ID, see Obtaining the Cluster ID. Default value: N/A
resource_type	Yes	String	Parameter description: Resource type. Currently, its value can only be css-cluster. Constraints: N/A Options: css-cluster Default value: N/A

None

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
tags	Array of ShowTagsTagsResp objects	Parameter description: List of cluster tags

**Table 3** ShowTagsTagsResp
Parameter	Type	Description
key	String	Parameter description: Tag key.
value	String	Parameter description: Tag value.

Query the tags of a cluster.

GET https://{Endpoint}/v1.0/{project_id}/{resource_type}/{resource_id}/tags

Status code: 200

Request succeeded.

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


Status Code	Description
200	Request succeeded.
400	Invalid request. The client should modify the request instead of re-initiating it.
404	The requested resource could not be found. The client should not repeat the request without modifications.