- API Reference
- Native OpenStack Nova APIs
- Tag Management
- Querying Tags of an ECS
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.
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.
Parameter | Type | Description |
---|---|---|
tags | Array of strings | Specifies ECS tags. Tag functions have been upgraded on the cloud platform. After the upgrade, the tag values returned by the system comply with the following rules:
For more details about upgraded tag functions, see Tag Types. |
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"]
}