1
0
forked from docs/doc-exports
doc-exports/docs/ecs/api-ref/en-us_topic_0065820822.html
Artem Goncharov 3196b64bfc
move doc sources to other location (#3)
move doc sources to other location

Reviewed-by: OpenTelekomCloud Bot <None>
2022-04-27 16:24:25 +00:00

7.0 KiB

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