Files

wanghuijuan738 8f024b87ae ECS API 20251204 version. Adding an API Document.

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

2025-12-17 11:05:14 +00:00

9.6 KiB

Raw Blame History

Listing Project Tags

Function

Projects are used to group and isolate OpenStack resources, which include computing, storage, and network resources. A project can be a department or a team. Multiple projects can be created for the same account.

This API is used to list all tags attached to a specified project.

URI

GET /v1/{project_id}/cloudservers/tags

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID.

Request

None

Response

Table 2 describes the response parameters.

**Table 2** Response parameters
Parameter	Type	Description
tags	Array of objects	Specifies the tag list. For details, see Table 3.

**Table 3** **tag** field description
Parameter	Type	Description
key	String	Specifies the tag key. Contains a maximum of 36 Unicode characters. Can only consist of digits, letters, hyphens (-), and underscores (_).
values	Array of strings	Specifies the tag value. Contains a maximum of 43 Unicode characters. Can be left blank. Can only consist of digits, letters, hyphens (-), and underscores (_).

Example Request

List all tags attached to a specified project.

GET https://{endpoint}/v1/{project_id}/cloudservers/tags

Example Response

{
      "tags": [
        {
            "key": "key1",
            "values": [
                "value1",
                "value2"
            ]
        },
        {
            "key": "key2",
            "values": [
                "value1",
                "value2"
            ]
        }
    ]
}

Returned Values

See Returned Values for General Requests.

Error Codes

See Error Codes.

Parent topic: Tag Management

9.6 KiB Raw Blame History