Updated on 2025-08-11 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:

URI

GET /v3/{project_id}/tags

Table 1 Parameter description

Parameter

Mandatory

Description

project_id

Yes

Definition

Project ID of a tenant in a region.

To obtain the value, see Obtaining a Project ID.

Constraints

N/A

Range

The value can contain 32 characters. Only letters and digits are allowed.

Default Value

N/A

Request Parameters

None

Response Parameters

Table 2 Parameter description

Parameter

Type

Description

tags

Array of objects

Definition

All tags.

For details, see Table 3.

Table 3 tags field data structure description

Parameter

Type

Description

key

String

Definition

Tag key.

Range

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

Definition

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.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/tags

Example Response

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

Status Codes

Error Codes

For details, see Error Codes.