Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
Skip to Content
CLICommands

orl kubernetes node-pool update

Update a node pool (asks for confirmation; --yes to skip), part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl kubernetes node-pool update <id> <pool-id>

Replaces supplied public ports, labels, annotations, and taints; omitted fields stay unchanged. Returns the pool with HTTP 202. Each node's host applies the new list within about a minute, and a removed port cuts the connections it carries. Each node takes the new labels, annotations, and taints within about a minute. A pool taint it drops is removed from its nodes, while taints set by others are preserved unless they use the same key and effect as a desired pool taint. A body that changes nothing answers 202 and writes nothing. A cluster that is deleting answers 409 INVALID_CLUSTER_STATE, a pool that is deleting 409 INVALID_NODE_POOL_STATE, and a list with a refused port, an overlap or too many sources 400 INVALID_PUBLIC_PORTS. A taint schema violation, including an unknown effect, a key over 317 characters, a value over 63 characters, more than 32 taints or an unknown field, answers 400 BAD_REQUEST. Invalid taint key or value syntax, a reserved key, or a repeated key and effect pair answers 400 INVALID_NODE_METADATA naming its entry. A refused label or annotation also answers 400 INVALID_NODE_METADATA. A legacy API key needs clusters:write.

Flags

FlagTypeRequired
--annotationsmap[string]stringnoThe pool's new annotations, replacing the ones it holds, as labels does.
--expected-public-portsjsonnoOptional list the caller reviewed, compared with the pool's list as a set. If they differ, answers 409 CONCURRENT_UPDATE without changing anything, so a change made since the review is not undone. The comparison and write are atomic.
--labelsmap[string]stringnoThe pool's new labels, replacing the ones it holds; an empty map removes them. Absent leaves them as they are. Each of the pool's nodes follows within about a minute. A key the pool drops is removed from its nodes unless something else, such as kubectl, last set it.
--public-portsjsonnoThe pool's new public ports, replacing the list it holds; an empty list forwards no port. Absent leaves the list as it is. Each node's public IP follows within about a minute, without restarting the node, and a removed port cuts the connections it carries.
--taintsjsonnoThe pool's new taints, replacing the ones it holds. An empty list clears them, and an absent field leaves them unchanged. Each node follows within about a minute. A taint the pool drops is removed from its nodes; taints set by others are preserved unless they use the same key and effect as a desired pool taint.
--bodystringnoa JSON object of request body fields, merged under any of this command's own flags that are also set, e.g. {"key":"value"}
--body-filestringnoread the --body JSON object from a file (- for stdin)
--yesboolnoskip the confirmation prompt
--forceboolnoalias for --yes

This wraps the updateKubernetesNodePool API operation.

On this page