Updated on 2026-01-06 GMT+08:00

Querying Project Tags

Function

This API is used to query project tags.

URI

  • URI format

    GET /v3/{project_id}/tags

  • Parameter description
    Table 1 Parameters

    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.

    Constraints:

    N/A

    Value range:

    N/A

    Default value:

    N/A

Request

  • Request parameters

    None

  • URI example

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/tags

Response

  • Normal response
    Table 2 Parameters

    Parameter

    Type

    Description

    tags

    Array of objects

    Explanation:

    Specifies the tag list. If there is no tag in the list, an empty array is returned.

    For details, see Table 3.

    Table 3 tags field data structure description

    Parameter

    Type

    Description

    key

    String

    Explanation:

    Specifies the tag key.

    Value range:

    N/A

    values

    List<String>

    Explanation:

    Specifies the tag value.

    Value range:

    N/A

  • Example normal response
    {
    	"tags": [{
    		"key": "key1",
    		"values": ["value1"]
    	}, {
    		"key": "key2",
    		"values": ["value2"]
    	}]
    }
  • Abnormal response

    For details, see Abnormal Request Results.

Status Code

Error Code

For details, see Error Codes.