Hanzo
OpenapiVisor

Resizes a node pool to an absolute node count and returns the pool as Visor…

Resizes a node pool to an absolute node count and returns the pool as Visor reports it after the change.

POST /v1/visor/clusters/{clusterId}/pools/{poolId}/scale

Addresshttps://api.hanzo.ai/v1/visor/clusters/{clusterId}/pools/{poolId}/scale
MethodPOST
OperationscaleNodePool
AuthAuthorization: Bearer $HANZO_API_KEY

Resizes a node pool to an absolute node count and returns the pool as Visor reports it after the change.

Request

6 fields, body application/json (required).

FieldInTypeRequiredDescription
clusterIdpathstringyesClusterID is the cluster holding the pool, from the URL path.
poolIdpathstringyesPoolID is the pool to resize, from the URL path — the poolId a cluster read reports for it.
clusterIdbodystringClusterID is the cluster holding the pool, from the URL path.
countbodyintegerCount is the node count to scale TO — an absolute target, not a delta, and never negative.
poolIdbodystringPoolID is the pool to resize, from the URL path — the poolId a cluster read reports for it.
providerbodystringProvider is the cloud the cluster lives on.

Response

StatusBodyMeaning
200nodePoolViewok

200 body — 7 fields.

FieldInTypeAlwaysDescription
autoScalebodybooleanAutoScale reports whether the provider's cluster autoscaler owns this pool's size, moving Count between MinNodes and MaxNodes as workloads demand.
countbodyintegerCount is how many nodes the pool has right now.
maxNodesbodyintegerMaxNodes is the ceiling the autoscaler will not grow the pool past, and so the bound on what this pool can cost.
minNodesbodyintegerMinNodes is the floor the autoscaler will not shrink the pool below.
namebodystringName is the pool's name as the provider knows it.
poolIdbodystringPoolID is the provider's id for the pool — the value the scale and delete routes address it by.
sizebodystringSize is the provider size slug every node in the pool runs at ("s-4vcpu-8gb", "gpu-h100x8-640gb").

Failure carries the platform error shape — see Errors.

Examples

hanzo has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


Visor API · All Hanzo APIs · Interactive reference

How is this guide?

On this page