Updated on 2026-09-10 GMT+08:00

Querying All 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.

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. For details about how to obtain the ID, see Obtaining a 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.

Query all tags attached to a specified ECS.

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

Example response

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

Parent topic: Tag Management