doctl compute load-balancer update

Go to Navigation

Usage

doctl compute load-balancer update <load-balancer-id> [flags]

Aliases

u

Description

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
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:
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--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