Sign in

v3

OpenAPI 3.1.0MIT2026-07-31192456807.8 KB
GPUClusterService

Update a GPU cluster

Update the configuration of an existing GPU cluster.

put/compute/clusters/{cluster_id}

Path parameters

cluster_idstring required

The ID of the cluster to update

Request body

cluster_type'KUBERNETES' | 'SLURM'

Type of cluster to update.

num_gpusinteger

Target GPU count for the cluster. When omitted, the server keeps the current GPU count from cluster metadata (use for config-only or decommission-time-only updates).

reservation_end_timestring date-time

Timestamp at which the cluster should be decommissioned. Only accepted for prepaid clusters.

num_reserved_gpusinteger

Number of reserved GPUs to update to. This field is only applicable for clusters with RESERVED billing type.

num_preemptible_gpusinteger

Updated desired number of preemptible GPUs for the cluster. When omitted, the current value is preserved. Must be a multiple of 8.

num_capacity_pool_gpusinteger

Number of GPUs to draw from the cluster's capacity pool. Only valid for clusters created with a capacity_pool_id. Must be a multiple of 8 and not exceed num_gpus. When omitted, the current value is preserved.

Response

OK

cluster_idstring required
cluster_type'KUBERNETES' | 'SLURM' required

Type of cluster.

regionstring required
gpu_type'H100_SXM' | 'H200_SXM' | 'RTX_6000_PCI' | 'L40_PCIE' | 'B200_SXM' | 'H100_SXM_INF' required
cluster_namestring required
duration_hoursinteger
status'WaitingForControlPlaneNodes' | 'WaitingForDataPlaneNodes' | 'WaitingForSubnet' | 'WaitingForSharedVolume' | 'InstallingDrivers' | 'RunningAcceptanceTests' | 'Paused' | 'OnDemandComputePaused' | 'Ready' | 'Degraded' | 'Deleting' required

Current status of the GPU cluster.

kube_configstring required
num_gpusinteger required
slurm_shm_size_gibinteger
capacity_pool_idstring
reservation_start_timestring date-time
reservation_end_timestring date-time
install_traefikboolean
cuda_versionstring required
nvidia_driver_versionstring required
created_atstring date-time
project_idstring required
num_cpu_workersinteger required

Number of CPU-only worker nodes in the cluster.

desired_preemptible_gpusinteger required

Customer's requested number of preemptible GPUs. Set on cluster create or update; persists until changed.

allocated_preemptible_gpusinteger required

Actual number of preemptible GPUs currently allocated to the cluster. Updated asynchronously by the fulfillment and reclamation workers; may be less than desired_preemptible_gpus when capacity is constrained.

billing_type'RESERVED' | 'ON_DEMAND' | 'SCHEDULED_CAPACITY' required

Billing type for the cluster (RESERVED, ON_DEMAND, or SCHEDULED_CAPACITY).

machine_cluster_idstring

ID of the machine cluster backing this GPU cluster.

first_ready_atstring date-time

Timestamp when the cluster first reached the Ready phase.

is_in_substrateboolean

Whether the cluster is managed inside a substrate environment.

control_plane_readyboolean

Whether the control plane is currently ready.

ums_project_idstring

UMS project ID associated with this cluster.

ums_org_idstring

UMS organization ID associated with this cluster.

os_imagestring

Data-volume image name for GPU worker nodes.

nvidia_driver_version_idstring

Internal NVIDIA version ID for this cluster's driver and CUDA combination.

num_capacity_pool_gpusinteger required

Number of GPUs to draw from a capacity pool. A component of the overall num_gpus, alongside num_reserved_gpus.

num_reserved_gpusinteger required

Number of prepaid reserved GPUs for this cluster. A component of the overall num_gpus, alongside num_capacity_pool_gpus.