Updated on 2025-08-18 GMT+08:00

Querying Tags of a Project

Function

This API is used to query all user tags in a project. Before calling this API:

Learn how to authenticate this API.

URI

GET https://{Endpoint}/v3/{project_id}/tags

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Explanation: Project ID of a tenant in a region. For details about how to obtain the project ID, see Obtaining a Project ID. Restrictions: None Value range: The value can contain 32 characters. Only letters and digits are allowed. Default value: None

Request Parameters

None

Response Parameters

**Table 2** Parameter description
Parameter	Type	Description
tags	Array of objects	All tags. For details, see Table 3.

**Table 3** tags field data structure description
Parameter	Type	Description
key	String	Tag key. It can contain up to 36 Unicode characters and cannot be blank. Only digits, uppercase letters, lowercase letters, underscores (_), and hyphens (-) are allowed.
value	Array of strings	Tag value. It can contain up to 43 Unicode characters and can be an empty string. Only digits, uppercase letters, lowercase letters, underscores (_), periods (.), and hyphens (-) are allowed.

Example Request

GET https://gaussdb-opengauss.eu-west-101.myhuaweicloud.eu/v3/0483b6b16e954cb88930a360d2c4e663/tags

Example Response

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

Status Code

Normal
200
Abnormal
For details, see Status Codes.

Error Code

For details, see Error Codes.

Parent topic: Tag Management