Querying Subnet Tags in a Specified Project

Function

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

URI

GET /v2.0/{project_id}/subnets/tags

Table 1 describes the parameters.

Table 1 Parameter description

Name	Mandatory	Description
project_id	Yes	Specifies the project ID.

Request Parameters

None

Example Request

GET https://{Endpoint}/v2.0/{project_id}/subnets/tags

Response Parameters

Table 2 Response parameter

Parameter	Type	Description
tags	Array of tag objects	Specifies the tag object list. For details, see Table 3.

Table 3 Description of the tag field

Name	Type	Description
key	String	Specifies the tag key. Cannot be left blank. Contain up to 128 characters (36 characters on the console). Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_)
values	Array of strings	Specifies the tag value list. Contain up to 255 characters (43 characters on the console). Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_)

Example Response

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

Status Code

See Status Codes.

Error Code

See Error Codes.

last updated: 2024-05-05 00:07