- API Reference
- API Description
- Tag Management APIs
- Querying Resource Tags
Querying Resource Tags¶
Function¶
This API is used to query tags of a specified resource.
URI¶
GET /v1.0/{project_id}/clusters/{resource_id}/tags
Parameter | Mandatory | Type | Description |
---|---|---|---|
project_id | Yes | String | Project ID. For details about how to obtain the project ID, see Obtaining a Project ID. |
resource_id | Yes | String | Resource ID, for example, 7d85f602-a948-4a30-afd4-e84f47471c15. |
Request Parameters¶
None
Response Parameters¶
Parameter | Mandatory | Type | Description |
---|---|---|---|
tags | Yes | List<resource_tag> | Tag list. |
Parameter | Mandatory | Type | Description |
---|---|---|---|
key | Yes | String | Key. A tag key can contain a maximum of 36 Unicode characters, which cannot be null. The first and last characters cannot be spaces. It can contain uppercase letters (A to Z), lowercase letters (a to z), digits (0-9), hyphens (-), and underscores (_). |
value | Yes | String | Key value. A tag value can contain a maximum of 43 Unicode characters, which can be null. The first and last characters cannot be spaces. It can contain uppercase letters (A to Z), lowercase letters (a to z), digits (0-9), hyphens (-), and underscores (_). |
Example Request¶
GET /v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/7d85f602-a948-4a30-afd4-e84f47471c15/tags
Example Responses¶
{
"tags": [
{
"key": "Flower",
"value": "rose"
},
{
"key": "Food",
"value": "pie"
}
]
}
Status Code¶
Returned Value | Description |
---|---|
200 | OK |
400 | Invalid parameter. |
401 | Authentication failed. |
403 | Insufficient permission. |
404 | No resources found. |
500 | Internal service error. |