Zaoxu, Li 4edaa4a4cc ECS API 20231016 version

Reviewed-by: Pristromskaia, Margarita <margarita.pristromskaia@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>

2024-04-29 11:04:13 +00:00

7.1 KiB

Raw Blame History

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

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"]
}

Returned Values

See Returned Values for General Requests.

Parent topic: Tag Management

7.1 KiB Raw Blame History