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

Adding a Tag to a VPC

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

POST /v2.0/{project_id}/vpcs/{vpc_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.
vpc_id	Yes	Specifies the VPC ID that uniquely identifies the VPC.

**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 (-).

Create a tag for a VPC. The key is key1, and the value is value1.

POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags

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

None

None