Querying Tags of an ECS¶

This API is used to query all tags of an ECS.

You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the microversion on the client.

URI¶

GET /v2.1/{project_id}/servers/{server_id}/tags

Table 1 describes the parameters in the URI.

**Table 1** Parameter description¶
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID.
server_id	Yes	Specifies the ECS ID.

None

Table 2 describes the response parameters.

**Table 2** Response parameters¶
Parameter	Type	Description
tags	Array of strings	Specifies ECS tags. Tag functions have been upgraded on the cloud service platform. After the upgrade, the tag values returned by the system comply with the following rules: The key and value of a tag are connected using an equal sign (=), for example, key=value. If the value is empty, only the key is returned. For more details about upgraded tag functions, see Tag Types.

GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/tags

Example response

{
    "tags": ["baz=xyy", "foo", "qux"]
}

last updated: 2024-04-26 03:01