Updated on 2025-05-22 GMT+08:00

Querying All Tags

Function

This API is used to query all tags in a specified region.

URI

GET /v1.0/{project_id}/{resource_type}/tags

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Parameter description:

The project ID. For details about how to obtain the project ID and name, see Obtaining the Project ID and Name.

Constraints:

N/A

Options:

For details about how to obtain the project ID and name, see Obtaining the Project ID and Name.

Default value:

N/A.

resource_type

Yes

String

Parameter description:

Resource type. Currently, its value can only be css-cluster.

Options:

  • css-cluster: cluster type.

Default value:

N/A.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

tags

Array of ShowAllTagsTagsResp objects

Parameter description:

List of cluster tags

Table 3 ShowAllTagsTagsResp

Parameter

Type

Description

key

String

Parameter description:

Tag key.

values

Array of strings

Parameter description:

Tag values.

Example Requests

Query all CSS cluster tags in a project.

GET https://{Endpoint}/v1.0/{project_id}/{resource_type}/tags

Example Responses

Status code: 200

Request succeeded.

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

Status Codes

Status Code

Description

200

Request succeeded.

400

Invalid request.

The client should modify the request instead of re-initiating it.

404

The requested resource could not be found.

The client should not repeat the request without modifications.

Error Codes

See Error Codes.