Update a Linode interface

Update the configuration of a Linode interface.

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: update_linode
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: linodes:read_write

CLI

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"}]'

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 Linode.

integer
required

The id of the Linode interface.

Body Params

Modifies an existing Linode public interface. The public interface can't be changed to a VLAN or VPC interface type.

If Network Helper is enabled, the Linode must be shut down before updating the address, or primary setting.

default_route
object

Defines whether IPv4 and IPv6 default routes are enabled for this interface. Public interfaces can have both an IPv4 and IPv6 default_route, provided they have at least one IP address of the corresponding type. If the default_route is omitted, (or set to null), no changes are made to the default_route configuration.

public
object | null

Public interface settings.

Responses

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