Rebuilds a NodeBalancer config and its nodes that you have permission to modify.
Use this operation to update a NodeBalancer's config and nodes with a single request.
You can't rebuild a NodeBalancer config if it has a cannot_delete_with_subresources lock. Only account administrators can remove locks using the Delete a resource lock operation.
You can configure UDP on the same NodeBalancer that also uses TCP, HTTP, or HTTPS, but only when managing it through the API. If UDP is configured and you make changes to the TCP, HTTP or HTTPS settings in Cloud Manager, the existing UDP configuration will be overwritten. This is because Cloud Manager doesn't currently support UDP.
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:
rebuild_nodebalancer_config
- Permissions:
-
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes:
nodebalancers:read_write
- Scopes:
CLI
HTTPS
linode-cli nodebalancers config-rebuild \
12345 4567 \
--port 443 \
--protocol https \
--algorithm roundrobin \
--stickiness http_cookie \
--check http_body \
--check_interval 90 \
--check_timeout 10 \
--check_attempts 3 \
--check_path "/test" \
--check_body "it works" \
--check_passive true \
--proxy_protocol "none" \
--ssl_cert "-----BEGIN CERTIFICATE-----
CERTIFICATE_INFORMATION
-----END CERTIFICATE-----" \
--ssl_key "-----BEGIN PRIVATE KEY-----
PRIVATE_KEY_INFORMATION
-----END PRIVATE KEY-----" \
--cipher_suite recommended \
--nodes.label "node1" --nodes.address "192.168.210.120:80" --nodes.mode "accept" --nodes.weight 50 \
--nodes '[{"address":"192.168.210.122:80","label":"node2","weight":50,"mode":"accept"}]' \
--nodes '[{"address":"10.0.0.45:80","label":"vpc-node","weight":10,"mode":"accept","subnet_id:1"}]'UDP
linode-cli nodebalancers config-rebuild \
12345 4567 \
--port 80 \
--protocol udp \
--algorithm ring_hash \
--udp_check_port 80 \
--nodes.label "node1" --nodes.address "192.168.210.120:80" --nodes.mode "accept" --nodes.weight 50 \
--nodes '[{"address":"192.168.210.122:80","label":"node2","weight":50}]' \
--nodes '[{"address":"10.0.0.45:80","label":"vpc-node","weight":10,"mode":"accept","subnet_id:1"}]'TCP
linode-cli nodebalancers config-rebuild \
12345 4567 \
--port 80 \
--protocol tcp \
--algorithm roundrobin \
--stickiness none \
--proxy_protocol "v2"
--nodes.label "node1" --nodes.address "192.168.210.120:80" --nodes.mode "accept" --nodes.weight 50 \
--nodes '[{"address":"192.168.210.122:80","label":"node2","weight":50,"mode":"accept"}]' \
--nodes '[{"address":"10.0.0.45:80","label":"vpc-node","weight":10,"mode":"accept","subnet_id:1"}]'HTTP
linode-cli nodebalancers config-rebuild \
12345 4567 \
--port 440 \
--protocol http \
--algorithm roundrobin \
--stickiness none \
--check http_body \
--check_interval 90 \
--check_timeout 10 \
--check_attempts 3 \
--check_path "/test" \
--check_body "it works" \
--nodes.label "node1" --nodes.address "192.168.210.120:80" --nodes.mode "accept" --nodes.weight 50 \
--nodes '[{"address":"192.168.210.122:80","label":"node2","weight":50,"mode":"accept"}]' \
--nodes '[{"address":"10.0.0.45:80","label":"vpc-node","weight":10,"mode":"accept","subnet_id:1"}]'