Create a VPC

Create a new VPC and optionally define new subnets within it. A successful request triggers a vpc_create event, and subnet_create events for any created VPC subnets.

Permissions and scopes

To call this operation, you need the following:

  • Identity and access permissions. Your user needs a role with these permissions assigned. 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

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