Skip to main content
PUT
Update node-group autoscaling

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-ankra-organisation-id
string

PAT organisation override.

Path Parameters

cluster_id
string<uuid>
required
group_name
string
required

Body

application/json
enabled
boolean
required
min_count
integer
default:0
max_count
integer
default:100

Response

Successful response

enabled
boolean
required
group_name
string
required
max_count
integer
required
min_count
integer
required
message
string

PUT only. What the write does to the group's node count, in words.

node_count
integer

PUT only. The group's node count when the write was made.

operation_id
string<uuid> | null

PUT only, and always answered by it. The operation this write started for the group's nodes, created in the same transaction as the write: it moves the node count to target_count and writes the node-group label onto the existing nodes. Poll it on /api/v1/org/executions/{execution_id}. When the nodes needed no operation and enabling started the cluster autoscaler's install, it is that install, which moves no node, and dispatch_reason says so. Null when the write started none; dispatch says why.

dispatch
enum<string>

PUT only. What the write did about the operation that applies it, as on the other node-group writes. started: operation_id names it. deferred: the change is stored but no operation was started for it now (an operation already working on the cluster, or a stopped cluster, whose start applies it); dispatch_reason says why and what applies it. none: the write left nothing for an operation to apply (autoscaling turned off; a node count already within the bounds, on workers that already carry the node-group label; a stopped cluster's scale-down that wrote the label onto none of the workers it keeps, which the write applies to the group's records itself). A stopped cluster's scale-down that wrote the label onto a worker it keeps is deferred: the label waits for the cluster's start.

Available options:
started,
deferred,
none
dispatch_reason
string

PUT only. Why no operation was started (deferred, none), what a started operation leaves to the reconcile loop, and, when enabling started the cluster autoscaler's install as a second operation, which one that is. Absent when a started operation carries the whole change and the write started no other.

target_count
integer

PUT only. The node count the write moves the group to: max_count when the group had more nodes, min_count when it had fewer (while autoscaling is enabled), node_count otherwise. A group above max_count scales down through the guarded removal of its least busy nodes, each drained once the pipeline steps on it finish.