Querying Subnet Tags

Function

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

URI

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

Table 1 describes the parameters.

Table 1 Parameter description

Name	Mandatory	Description
project_id	Yes	Specifies the project ID.
subnet_id	Yes	Specifies the subnet ID, which uniquely identifies the subnet. If you use the management console, the value of this parameter is the Network ID value.

Request Parameters

None

Example Request

GET https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/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 tag objects

Attribute	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 (_) The tag key of a VPC must be unique.
value	String	Specifies the tag value. 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",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}

Status Code

See Status Codes.

Error Code

See Error Codes.

last updated: 2024-05-18 01:04