# 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.

#### Request

None

#### Response

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 public cloud. 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.

#### Example Request

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

#### Example Response

Example response

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

#### Returned Values

See Returned Values for General Requests.

Parent topic: Tag Management