Delete a NodeBalancer's node

Deletes a node from a configuration. This backend will no longer receive traffic for the configured port of this NodeBalancer.

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

This does not change or remove the Linode whose address was used in the creation of this node.

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

    • Scopes: nodebalancers:read_write

CLI

linode-cli nodebalancers node-delete \
  12345 4567 54321

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.

integer
required

The ID of the Config to access.

string
required

The ID of the Node to access.

Responses

Language
Credentials
Response
Choose an example:
application/json