Updated on 2023-07-17 GMT+08:00

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.

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

Example Request

Query all tags attached to a specified ECS.

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

Example Response

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