Updated on 2022-12-14 GMT+08:00

Querying All Tags

Function

This API is used to query all tag sets of a specified region.

URI

  • Format

    GET /v1.1/{project_id}/clusters/tags

  • Parameter description
    Table 1 URI parameter description

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Project ID. For details on how to obtain the project ID, see Obtaining a Project ID.

Request

Request parameters

None.

Response

Table 2 Response parameter description

Parameter

Type

Description

tags

Array of objects

Tag list. For details, see Table 3.

Table 3 tags parameter description

Parameter

Type

Description

key

String

Tag key. A tag key cannot contain special characters (=*<>\,|/) or start or end with a space.

value

String

Tag value. A tag value cannot contain special characters (=*<>\,|/) or start or end with a space.

Example

  • Example request

None.

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

Status Code

Table 4 describes the status code of this API.

Table 4 Status code

Status Code

Description

200

The operation is successful.