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.

Debugging

You can debug this API in API Explorer.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
If you are using identity policy-based authorization, the permissions listed below are required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
ecs:cloudServers:listServerTags	list	-	-	ecs:cloudServers:list	-

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. For details about how to obtain the ID, see Obtaining a 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.
values	Array of strings	Specifies the tag value. Contains a maximum of 43 Unicode characters. Can be left blank.

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