Querying All Tags¶

Function¶

This API is used to query all tags in a specified region.

URI¶

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

**Table 1** Parameter description¶
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID and Name.

Request¶

None

Response¶

Table 2 describes the response parameters.

**Table 2** Response parameters¶
Parameter	Type	Description
tags	Array of tag objects	Tags in a cluster. For details, see Table 3.

**Table 3** **tags** field description¶
Parameter	Type	Description
key	String	Tag key.
values	Array of strings	Tag value.

Examples¶

Example request

GET v1.0/458d905f22da49c39f609e3347d65723/css-cluster/tags

Example response

{
    "tags": [
        {
            "key": "key1",
            "values": [
                "value1",
                "value2"
            ]
        },
        {
            "key": "key2",
            "values": [
                "value1",
                "value2"
            ]
        }
    ]
}

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