Delete a NodeBalancer

Deletes a NodeBalancer.

This is a destructive action and cannot be undone.

A NodeBalancer can't be deleted if it has a cannot_delete or a cannot_delete_with_subresources lock. Only account administrators can remove locks using the Delete a resource lock operation.

Deleting a NodeBalancer also deletes all associated configurations and nodes. However, the backend servers represented by these nodes are not changed or removed.

When you delete a NodeBalancer, you lose access to the ephemeral IP addresses assigned to it. When a NodeBalancer is deleted, any assigned reserved IP remains on your account in an unassigned state, preserving the address for future use. Conversely, ephemeral IPs are released and can't be recovered.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

  • Identity and access permissions. Your user needs a role with these permissions. Learn more.

    • Permissions: delete_nodebalancer
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: nodebalancers:read_write

CLI

linode-cli nodebalancers delete 12345

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

Responses

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