Returns a list of all Virtual Local Area Networks (VLANs) on your account. VLANs provide a mechanism for secure communication between two or more Linodes that are assigned to the same VLAN, and are both within the same Layer 2 broadcast domain.

For legacy configuration profile interfaces, you can use the following operations to create, attach, detach, and delete VLANs on a Linode:

• Create a Linode
• Create a config profile
• Update a config profile
• Update the active Configuration Profile to remove the VLAN Interface, then reboot the Linode.
• Create a config profile without the VLAN Interface, then reboot the Linode into the new Configuration Profile.
• Delete the Linode.

For Linode interfaces, you can use the following operations to create, attach, detach, and delete VLANs on a Linode:

• Create a Linode
• Add a Linode interface
• Update a Linode interface
• Delete a Linode interface from a Linode.

📘

• Only Next Generation Network (NGN) data centers support VLANs. Run the List regions operation to view the capabilities of data center regions. If a VLAN is attached to your Linode and you attempt to migrate or clone it to a non-NGN data center, the migration or cloning won't initiate. If a Linode cannot be migrated because of an incompatibility, you will be prompted to select a different data center or contact support.

• See the VLANs Overview to view additional specifications and limitations.

Permissions and scopes

To call this operation, you need the following:

• OAuth scopes. Your user needs these scopes assigned. Learn more.

  • Scopes: linodes:read_only

CLI

linode-cli vlans list

Learn more