Create a NodeBalancer

Creates a NodeBalancer in the requested Region. Only available in regions with "NodeBalancers" in their capabilities.

NodeBalancers require a port config with at least one backend node to start serving requests.

When using the Linode CLI to create a NodeBalancer, first create a NodeBalancer without any configs. Then, create configs and nodes for that NodeBalancer with the respective Create a config and Create a node operations.

After creating a NodeBalancer, account administrators can add a lock to prevent accidental NodeBalancer deletion by using the Create a resource lock operation.

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: create_nodebalancer

• OAuth scopes. Your user needs these scopes assigned. Learn more.

  • Scopes: nodebalancers:read_write

CLI

linode-cli nodebalancers create \
  --region us-east \
  --label balancer12345 \
  --client_conn_throttle 0

Learn more