Updated on 2025-10-30 GMT+08:00

Adding a Tag to a Subnet

This API is used to add a tag to a subnet.

POST /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, which uniquely identifies the subnet. If you use the management console, the value of this parameter is the Network ID value.

**Table 2** Request parameter
Parameter	Type	Mandatory	Description
tag	tag object	Yes	Specifies the tag objects. For details, see Table 3.

**Table 3** **tag** objects
Parameter	Type	Mandatory	Description
key	String	Yes	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	Yes	Specifies the tag value. Can contain a maximum of 255 characters. Can contain letters, digits, underscores (_), periods (.), and hyphens (-).

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

{
    "tag": {
        "key": "key1",
        "value": "value1"
    }
}

None

None