Updated on 2024-12-03 GMT+08:00

Querying Project Tags

Function

This API is used to query all tags of a specified resource type in a specified project of a tenant.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/{resource_type}/tags

Table 1 Parameter description

Parameter

Type

Mandatory

Description

project_id

String

Yes

Specifies a project ID. You can obtain the project ID by referring to Obtaining the Project ID.

resource_type

String

Yes

  • Specifies the resource type.
  • The value can be one of the following: vpn-gateway, customer-gateway, vpn-connection, p2c-vpn-gateways.

Request

  • Request parameters

    None

  • Example request
    GET https://{Endpoint}/v5/{project_id}/{resource_type}/tags

Response

  • Response parameters

    Returned status code 200: successful query

    Table 2 Parameters in the response body

    Parameter

    Type

    Description

    tags

    Array of ResourceTag objects

    Specifies the list of resource tags.

    Table 3 ResourceTag

    Parameter

    Type

    Description

    key

    String

    Indicates a tag key.

    values

    Array of String

    Indicates a tag value.

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

Status Codes

For details, see Status Codes.