Below are examples of all of the CLI operations available for use with Linode interfaces.

Add a Linode interface

For information on the available fields, run linode-cli linodes interface-add --help from the command line or see this documentation.

Public interface

linode-cli linodes interface-add $linodeId \
  --firewall_id 123 \
  --default_route.ipv4 true \
  --default_route.ipv6 true \
  --public.ipv4.addresses '[{"address": "192.0.2.141", "primary": true}, {"address": "auto", "primary": false}]' \
  --public.ipv6.ranges '[{"range": "2001:0db8::1/64"}, {"range": "/64"}]'

VLAN interface

linode-cli linodes interface-add $linodeId \
  --vlan.vlan_label my-vlan \
  --vlan.ipam_address 192.168.2.2/24

VPC interface

linode-cli linodes interface-add $linodeId \
  --firewall_id 123 \
  --default_route.ipv4 true \
  --vpc.subnet_id 321 \
  --vpc.ipv4.addresses '[{"address": "10.0.0.1", "primary": true, "nat_1_1_address": "auto"}, {"address": "auto", "primary": false, "nat_1_1_address": null}]' \
  --vpc.ipv4.ranges '[{"range": "/28"}, {"range": "10.11.12.0/24"}]'

List Linode interfaces

For information on the available fields, run linode-cli linodes interfaces-list --help from the command line or see this documentation.

linode-cli linodes interfaces-list $linodeId

List Linode interface settings

For information on the available fields, run linode-cli linodes interfaces-settings --help from the command line or see this documentation.

linode-cli linodes interfaces-settings-list $linodeId

List a Linode's network interface history

For information on the available fields, run linode-cli linodes interface-history --help from the command line or see this documentation.

linode-cli linodes interface-history-list $linodeId

Update Linode interface settings

For information on the available fields, run linode-cli linodes interface-settings-update --help from the command line or see this documentation.

Public interface

linode-cli linodes interface-settings-update $linodeId \
  --network_helper true \
  --default_route.ipv4_interface_id 4527 \
  --default_route.ipv6_interface_id 4541 \
  --default_route.ipv4_eligible_interface_ids 4527 \
  --default_route.ipv4_eligible_interface_ids 4541 \
  --default_route.ipv6_eligible_interface_ids 4527 \
  --default_route.ipv6_eligible_interface_ids 4541

VLAN interface

linode-cli linodes interface-settings-update $linodeId \
  --network_helper true

VPC interface

linode-cli linodes interface-settings-update $linodeId \
  --network_helper true

Get a Linode interface

For information on the available fields, run linode-cli linodes interface-view --help from the command line or see this documentation.

linode-cli linodes interface-view $linodeId $interfaceId

Update a Linode interface

For information on the available fields, run linode-cli linodes interface-update --help from the command line or see this documentation.

Public interface

linode-cli linodes interface-update $linodeId $interfaceId \
  --default_route.ipv4 true \
  --default_route.ipv6 false \
  --public.ipv4.addresses '[{"address": "192.0.2.141", "primary": true}, {"address": "auto", "primary": false}]' \
  --public.ipv6.ranges '[{"range": "2001:0db8"::1/64"}, {"range": "/64"}]'

VLAN interface

linode-cli linodes interface-update $linodeId $interfaceId \
  --vlan.vlan_label my-vlan \
  --vlan.ipam_address 192.168.2.2/24

VPC interface

linode-cli linodes interface-update $linodeId $interfaceId \
  --default_route.ipv4 true \
  --vpc.subnet_id 321 \
  --vpc.ipv4.addresses '[{"address": "10.0.0.1", "primary": true, "nat_1_1_address": "auto"}, {"address": "auto", "primary": false, "nat_1_1_address": null}]' \
  --vpc.ipv4.ranges '[{"range": "/28"}, {"range": "10.11.12.0/24"}]'

Delete a Linode interface

For information on the available fields, run linode-cli linodes interface-delete --help from the command line or see this documentation.

linode-cli linodes interface-delete $linodeId $interfaceId

List Linode interface firewalls

For information on the available fields, run linode-cli linodes interface-firewalls-list --help from the command line or see this documentation.

linode-cli linodes interface-firewalls-list $linodeId $interfaceId

Upgrade to Linode interfaces

For information on the available fields, run linode-cli linodes interfaces-upgrade --help from the command line or see this documentation.

❗️

This upgrade is irreversible

Once you upgrade a Linode to use Linode interfaces, you can't use legacy config interfaces. This means you can no longer use the Linode with any Akamai Cloud services that require private IPs, such as NodeBalancer.

linode-cli linodes interfaces-upgrade $linodeId