Updated on 2024-08-20 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 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.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/tags

Example Response

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

Status Code

Error Code

For details, see Error Codes.