doc-exports/docs/mrs/api-ref/mrs_02_0075.html

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 can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).
value	String	Tag value. A tag value can contain only uppercase letters, lowercase letters, digits, hyphens (-), and underscores (_).

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.

Parent topic: Tag Management APIs