doc-exports/docs/dws/api-ref/dws_02_0049.html

Querying Cluster Tags

Function

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

URI

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

Table 1 URI parameters

Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. To obtain the value, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
cluster_id	Yes	String	Definition Cluster ID. To obtain the value, see Obtaining the Cluster ID. Constraints N/A Range N/A Default Value N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter	Type	Description
tags	Array of ResourceTag objects	Definition Tag list. Range N/A

Table 3 ResourceTag

Parameter	Type	Description
key	String	Definition Tag key. Range N/A
value	String	Definition Tag value. Range N/A

Example Request

GET https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/4ca46bf1-5c61-48ff-b4f3-0ad4e5e3ba90/tags

Example Responses

Status code: 200

The cluster tags are queried successfully.

{
  "tags" : [ {
    "key" : "key",
    "value" : "value"
  } ]
}

Status Code

Status Code	Description
200	The cluster tags are queried successfully.
400	Request error.
401	Authorization failed.
403	No operation permission.
404	No resources found.
500	Internal service error.
503	Service unavailable.

Parent topic: Tag Management