delete
https://api.linode.com//linode/instances//interfaces/
Deletes a Linode interface on a specific Linode. Consider these points when deleting a Linode interface:
-
You can't delete an active interface. First, you need to shut down the associated Linode.
-
You can't delete a Linode interface from a Linode that has a
cannot_delete_with_subresourcesresource lock set for it. -
NAT Gateway downscaling (VPC interfaces only)
- If you delete a VPC interface on a subnet with an active NAT Gateway, and it was the last active portset utilizing a specific IP address on an autoscaled NAT Gateway, that IP address is immediately deallocated and returned to the shared platform pool.
- Because autoscaled NAT Gateway IPs are released automatically, you may permanently lose ownership of these public IP addresses when deleting VPC interfaces. If your external systems rely on allowlisting these specific egress IPs, configure your NAT Gateway to use manual address management.
- Powering down or shutting down a Linode doesn't free its NAT Gateway portset. Outbound ports remain strictly reserved for the VPC interface while it exists. To free up the portset and trigger downscaling, you must explicitly delete the VPC 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
- Permissions:
-
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes:
linodes:read_write
- Scopes:
CLI
linode-cli linodes interface-delete $linodeId $interfaceId