Help Center/ Virtual Private Cloud/ API Reference/ VPC APIs (V1/V2)/ Subnet Tag Management/ Querying Subnet Tags
Updated on 2025-10-30 GMT+08:00
View PDF

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

Parameter

Mandatory

Description

project_id

Yes

Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

subnet_id

Yes

Specifies the subnet ID that 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

Parameter

Type

Description

key

String
  • Specifies the tag key.
  • Cannot be left blank.
  • Can contain a maximum of 128 characters.
  • Can contain letters, digits, underscores (_), and hyphens (-).
  • The tag key of a VPC must be unique.

value

String
  • Specifies the tag value.
  • Can contain a maximum of 255 characters.
  • Can contain letters, digits, underscores (_), periods (.), and hyphens (-).

Example Response

{
    "tags": [
        {
            "key": "key1",
            "value": "value1"
        },
        {
            "key": "key2",
            "value": "value3"
        }
    ]
}

Status Code

See Status Codes.

Error Code

See Error Codes.

Parent Topic: Subnet Tag Management