Sign in

v1

latestOpenAPI 3.0.02026-07-13288558.3 KB

/clusters/create

Create a new GPU cluster.

post/clusters/create

Request body

namestring required

The name of the cluster.

cloudstring required

The cloud provider for the cluster.

regionstring required

The region where the cluster will be deployed.

cluster_typestring required

The type of GPU cluster to create.

num_instancesinteger required

The number of instances in the cluster.

ssh_key_idstring

The SSH key ID to use for the cluster instances.

osstring

The operating system for the cluster.

Example request

{
  "name": "protestant-aquamarine-cluster",
  "cloud": "denvr",
  "region": "houston-usa-1",
  "cluster_type": "H100_sxm5x8",
  "num_instances": 2,
  "ssh_key_id": "f0c6ac6d-7240-4968-8eb7-a11c4a0a5dc6",
  "os": "ubuntu20.04"
}

Response

Returns a CreateClusterResponse object

idstring uuid required

The unique identifier for the newly created cluster.

Example response

{
  "id": "8eda86fe-0f36-41ed-9837-0ccf8f6e0fcb"
}