Updated on 2022-01-25 GMT+08:00

Creating a Tag for a VPC

Function

This API is used to create a tag for a VPC.

URI

POST /v2.0/{project_id}/vpcs/{vpc_id}/tags

Table 1 describes the parameters.

Table 1 Parameter description

Name

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, which uniquely identifies the VPC.

Request Message

  • Request parameter
    Table 2 Request parameter

    Parameter

    Type

    Mandatory

    Description

    tag

    Object

    Yes

    Specifies the tag objects. For details, see Table 3.

    Table 3 tag objects

    Attribute

    Type

    Mandatory

    Description

    key

    String

    Yes

    • Specifies the tag key.
    • Cannot be left blank.
    • Can contain a maximum of 36 characters.
    • The tag key of a VPC must be unique.

    value

    String

    Yes

    • Specifies the tag value.
    • Can contain a maximum of 43 characters.
  • Example request
    POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags
    
    {
        "tag": {
            "key": "key1",
            "value": "value1"
        }
    }

Response Message

  • Response parameter

    None

  • Example response

    None

Status Code

See Status Codes.

Error Code

See Error Codes.