Get a VPC subnet

Get information about a single VPC Subnet.


CLI

linode-cli vpcs subnet-view $vpcId $vpcSubnetId

Learn more...

Path Params
string
required

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

integer
required

The id of the VPC.

integer
required

The id of the VPC Subnet.

Responses

Response body
object
date-time

Filterable, Read-only The date-time of VPC Subnet creation.

integer

Filterable, Read-only The unique ID of the VPC Subnet.

string

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
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 (--).
linodes
array of objects

Read-only An array of Linode IDs assigned to the VPC Subnet.

A Linode is assigned to a VPC Subnet if it has a Configuration Profile with a vpc purpose interface with the subnet's subnet_id. Even if the Configuration Profile is not active, meaning the Linode does not have access to the Subnet, the Linode still appears in this array.

linodes
object
integer

ID of a Linode assigned to the VPC Subnet.

interfaces
array of objects

VPC purpose interfaces with the subnet's subnet_id assigned to the Linode.

interfaces
object
boolean

Returns true if the Interface is in use, meaning that the Linode was powered on using the Configuration Profile to which the Interface belongs. Otherwise returns false.

integer | null

The globally general entity identifier for the Linode configuration profile that includes the VPC. If this is a VPC Linode interface, the value is null.

integer

ID of the interface.

date-time | null

Filterable, Read-only The date-time of the most recent VPC Subnet update.

Language
Credentials