Update a node pool
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.
Required permission
Requires the kubernetes.write permission. See Permissions for the roles and API key permissions that include it.
Command line
The orl CLI wraps this endpoint:
orl kubernetes node-pool update <id> <pool-id>apiKeyAuthorizationBearer <token>OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).
id*stringpoolId*stringapplication/json- body
1 <= propertiespublicPorts?array<>The 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.
items <= 32labels?The 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.
properties <= 64annotations?The pool's new annotations, replacing the ones it holds, as labels does.
properties <= 64taints?array<>The 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.
items <= 32expectedPublicPorts?array<>Optional 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.
items <= 32Update accepted
application/json- response
A set of identical nodes in one cluster.
id*stringclusterId*stringname*stringsku*What every node in a pool is: exactly one of gpuModelId or resourceSize. A GPU node is a whole host of that model with every GPU passed through to it. A CPU node is a VM of that size alone on a host that sells no GPU, billed as a CPU VM of the size; the rest of the host is left unused. A cluster mixes SKUs through several pools.
1 <= properties <= 1diskSizeGb?integerA CPU pool's data disk per node, in GB, beside the node's 100 GB root disk. Absent on a GPU pool, whose nodes take their host's free disk.
count*integerNodes the pool holds once it converges.
readyCount*integerNodes that joined the cluster and are Ready.
status*string"creating""ready""scaling""deleting""failed"publicPorts*array<>The ports each node's public IP forwards to the node, empty when none does. Every other port on the node's public IP answers nothing.
items <= 32labels*The labels on each of the pool's nodes, empty when the pool sets none.
properties <= 64annotations*The annotations on each of the pool's nodes, empty when the pool sets none.
properties <= 64taints*array<>The taints on each of the pool's nodes, empty when the pool sets none.
items <= 32conditions?array<>The conditions that hold on the pool, each while it holds: why the pool is short of its count, for example WaitingForCapacity (reason NoEligibleHost: no host in the cluster's data center has room for another node of the pool) or CreateRefused (the organization cannot add nodes now, for example its balance), and PublicPortsPending (reason HostsNotApplied) while some of its nodes have not applied its public ports. Absent while none holds.
createdAt*stringcurl -X PATCH 'https://api.openrelay.inc/v1/kubernetes/clusters/string/node-pools/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "clusterId": "string", "name": "string", "sku": { "gpuModelId": "string" }, "diskSizeGb": 0, "count": 0, "readyCount": 0, "status": "creating", "publicPorts": [ { "protocol": "tcp", "port": 1, "endPort": 1, "sources": [ "string" ] } ], "labels": { "property1": "string", "property2": "string" }, "annotations": { "property1": "string", "property2": "string" }, "taints": [ { "key": "string", "value": "string", "effect": "NoSchedule" } ], "conditions": [ { "type": "string", "status": "True", "reason": "string", "message": "string", "lastTransitionTime": "string" } ], "createdAt": "string"}Get a node pool GET
Returns one node pool of the cluster: its name, its SKU, the node count it converges to, its Ready count, its status and conditions. The SKU is a GPU model or a CPU size, and a CPU pool also carries its data disk. The conditions say what holds on the pool, chiefly why it is short of its count. A legacy API key needs clusters:read.
Delete a node pool DELETE
Starts draining and removing every node in the pool, then the pool, and answers 202 with the pool's id and status deleting. A pool with no nodes is deleted at once. Poll getKubernetesNodePool, which answers 404 once the pool is removed. A cluster that is deleting answers 409 INVALID_CLUSTER_STATE. A legacy API key needs clusters:write.