doc-exports/docs/mrs/api-ref/mrs_02_0073.html
Yang, Tong bd2b57f749 MRS API 2.0.38.SP20 version
Reviewed-by: gtema <artem.goncharov@gmail.com>
Co-authored-by: Yang, Tong <yangtong2@huawei.com>
Co-committed-by: Yang, Tong <yangtong2@huawei.com>
2022-11-16 15:06:08 +00:00

9.2 KiB

Querying Tags of a Specified Cluster

Function

This API is used to query tags of a specified cluster.

URI

  • Format

    GET /v1.1/{project_id}/clusters/{cluster_id}/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.

    cluster_id

    Yes

    Cluster 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

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", 
                "value": "value1" 
            }, 
            { 
                "key": "key2", 
                "value": "value3" 
            } 
        ] 
    } 

Status Code

Table 4 describes the status code of this API.

Table 4 Status code

Status Code

Description

200

The operation is successful.