Create a VPC

Create a new VPC and optionally associated VPC Subnets. A successful request triggers a vpc_create event and subnet_create events for any created VPC Subnets.

After you create a VPC, you can attach it to a Linode by assigning a VPC subnet to one of the Linode's network interfaces. To do this, you can run the following operations:

You can also attach managed databases and NodeBalancers to a subnet.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.

    • Permissions: create_vpc
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: vpc:read_write

CLI

linode-cli vpcs create \
  --description "A description of my VPC." \
  --label cool-vpc \
  --region us-east \
  --subnets.label cool-vpc-subnet \
  --subnets.ipv4 10.0.1.0/24

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
Body Params

VPC Create request object.

An object describing a VPC belonging to the Account.

subnets
array of objects

A list of subnets associated with the VPC.

subnets
string
length ≤ 255

A written description to help distinguish the VPC.

string
required
length between 1 and 64

Filterable The VPC's label, for display purposes only.

  • Needs to be unique among the Account's VPCs.
  • Can only contain ASCII letters, numbers, and hyphens (-). You can't use two consecutive hyphens (--).
string
required

Filterable The Region for the VPC.

Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json