doctl compute load-balancer update
Generated on 9 Apr 2025
from doctl version
v1.124.0
Usage
doctl compute load-balancer update <load-balancer-id> [flags]Aliases
uDescription
Use this command to update the configuration of a specified load balancer. Using all applicable flags, the command should contain a full representation of the load balancer including existing attributes, such as the load balancer’s name, region, forwarding rules, and Droplet IDs. Any attribute that is not provided is reset to its default value.
Flags
| Option | Description |
|---|---|
--algorithm |
This field has been deprecated. You can no longer specify an algorithm for load balancers. Default: round_robin |
--allow-list |
A comma-separated list of ALLOW rules for the load balancer, e.g.: ip:1.2.3.4,cidr:1.2.0.0/16 |
--deny-list |
A comma-separated list of DENY rules for the load balancer, e.g.: ip:1.2.3.4,cidr:1.2.0.0/16 |
--disable-lets-encrypt-dns-records |
disable automatic DNS record creation for Let’s Encrypt certificates that are added to the load balancer Default: false |
--domains |
A comma-separated list of domains required to ingress traffic to a global load balancer, e.g.: title:test-domain-1 is_managed:true certificate_id:test-cert-id-1 |
--droplet-ids |
A comma-separated list of Droplet IDs, e.g.: 215,378 |
--enable-backend-keepalive |
enable keepalive connections to backend target droplets Default: false |
--enable-proxy-protocol |
enable proxy protocol Default: false |
--forwarding-rules |
A comma-separated list of key-value pairs representing forwarding rules, which define how traffic is routed, e.g.: entry_protocol:tcp,entry_port:3306,target_protocol:tcp,target_port:3306. |
--glb-cdn-settings |
CDN cache settings global load balancer, e.g.: is_enabled:true |
--glb-settings |
Target protocol and port settings for ingressing traffic to a global load balancer, e.g.: target_protocol:http,target_port:80 |
--health-check |
A comma-separated list of key-value pairs representing recent health check results, e.g.: protocol:http, port:80, path:/index.html, check_interval_seconds:10, response_timeout_seconds:5, healthy_threshold:5, unhealthy_threshold:3 |
--help, -h |
Help for this command |
--name |
The load balancer’s name |
--project-id |
Indicates which project to associate the Load Balancer with. If not specified, the Load Balancer will be placed in your default project. |
--redirect-http-to-https |
Flag to redirect HTTP requests to the load balancer on port 80 to HTTPS on port 443 Default: false |
--region |
The load balancer’s region, e.g.: nyc1 |
--size |
The load balancer’s size, e.g.: lb-small. Only one of size and size-unit should be used |
--size-unit |
The load balancer’s size, e.g.: 1. Only one of size-unit and size should be used Default: 0 |
--sticky-sessions |
A comma-separated list of key-value pairs representing a list of active sessions, e.g.: type:cookies, cookie_title:DO-LB, cookie_ttl_seconds:5 |
--tag-name |
Assigns Droplets with the specified tag to the load balancer |
--target-lb-ids |
A comma-separated list of Load Balancer IDs to add as target to the global load balancer |
--vpc-uuid |
The UUID of the VPC to create the load balancer in |
Related Commands
| Command | Description |
|---|---|
| doctl compute load-balancer | Display commands to manage load balancers |
Global Flags
| Option | Description |
|---|---|
--access-token, -t |
API V2 access token |
--api-url, -u |
Override default API endpoint |
--config, -c |
Specify a custom config file Default: |
--context |
Specify a custom authentication context name |
--http-retry-max |
Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5 |
--http-retry-wait-max |
Set the minimum number of seconds to wait before retrying a failed request
Default: 30 |
--http-retry-wait-min |
Set the maximum number of seconds to wait before retrying a failed request
Default: 1 |
--interactive |
Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false |
--output, -o |
Desired output format [text|json] Default: text |
--trace |
Show a log of network activity while performing a command Default: false |
--verbose, -v |
Enable verbose output Default: false |