createVpc

Available in VPC

Create a VPC environment by specifying the IPv4 CIDR.

Syntax

The createVpc syntax is as follows:

./ncloud vpc createVpc \
    --ipv4CidrBlock <ipv4-cidr-block> \
    [--vpcName <vpc-name>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

Options

This section describes the options available when running createVpc.

Required options

The following options are required for createVpc.

Options	Type	Required	Description
`--ipv4CidrBlock`	String	Required	Private IPv4 address range of the VPC `/16`-`/28` within `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`

Optional options

These are the optional options for createVpc. Options that are not specified will use their default values.

Options	Type	Required	Description
`--vpcName`	String	Optional	VPC name Enter 3-15 characters, including lowercase English letters, numbers, and special character `-`. The string must begin with an English letter and end with an English letter or number. If not entered, NAVER Cloud Platform will assign one automatically.

Common options

For information about the options common to all vpc subcommands, see VPC options.

Examples

If the request to create an VPC is successful, the VPC's configuration information and creation status are returned.

Command

The command example is as follows:

./ncloud vpc createVpc \
    --ipv4CidrBlock 10.0.0.0/16 \
    --vpcName test-vpc-01 \
    --regionCode KR \
    --output json

Output

The output example is as follows:

{
  "createVpcResponse": {
    "totalRows": 1,
    "vpcList": [
      {
        "vpcNo": "12345678",
        "vpcName": "test-vpc-01",
        "ipv4CidrBlock": "10.0.0.0/16",
        "vpcStatus": {
          "code": "INIT",
          "codeName": "Under preparation"
        },
        "regionCode": "KR",
        "vpcType": "NORMAL",
        "createDate": "2026-07-07T14:07:27+0900"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}