Create a VPC subnet

Create a VPC Subnet. A successful request triggers a subnet_create event.

After you create a VPC subnet, you can attach it to a Linode by assigning the 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_subnet
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: vpc:read_write

CLI

linode-cli vpcs subnet-create $vpcId \
  --label cool-vpc-subnet \
  --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:
integer
required

The id of the VPC.

Body Params

VPC Subnet Create request object.

VPC Subnet Create request object.

string
required

IPv4 range in CIDR canonical form.

  • The range must belong to a private address space as defined in RFC1918.
  • Allowed prefix lengths: 1-29.
  • The range must not overlap with 192.168.128.0/17.
  • The range must not overlap with other Subnets on the same VPC.
string
required
length between 1 and 64

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

  • Must be unique among the VPC's Subnets.
  • Can only contain ASCII letters, numbers, and hyphens (-). You can't use two consecutive hyphens (--).
Responses

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