Querying Tags in a Specified Project

Function

This API is used to query all tags of instances in a specified project.

URI

URI format
GET /v3/{project_id}/tags

Parameter description

**Table 1** Parameter description
Name	Mandatory	Description
project_id	Yes	Specifies the project ID of a tenant in a region.

Requests

Request header

GET https://DDS endpoint/v3/{project_id}/tags

Request body
N/A

Responses

Parameter description

**Table 2** Parameter description
Name	Mandatory	Type	Description
tags	Yes	Array of objects	Indicates the tag list. For more information, see Table 3.

**Table 3** tags field data structure description
Name	Mandatory	Type	Description
key	Yes	String	Indicates the tag key. The value contains 36 Unicode characters and cannot be blank. Character set: 0-9, A-Z, a-z, "_", and "-".
values	Yes	Array of strings	Lists the tag values. The value contains a maximum of 43 Unicode characters and can also be an empty string. Character set: 0-9, A-Z, a-z, "_", and "-".

Response example

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