Sign in
Clusters

Deploy cluster

Deploy a new cluster.

Before deploying add at least one SSH key to enable access to your cluster.

Cluster types can be listed using the GET /v1/cluster-types endpoint. Image types can be listed using the GET /v1/images/cluster endpoint.

post/v1/clusters

Headers

user-agentstring required
cf-connecting-ipstring required

Request body

cluster_typestring required

Cluster instance type. Can be listed using the GET /v1/cluster-types endpoint.

imagestring required

OS image specification for the cluster. For a list of supported images, check GET /v1/images/cluster endpoint, "image_type" property.

startup_script_idstring nullable

Startup script ID to run on cluster initialization

hostnamestring required
descriptionstring nullable
location_codestring required

Location code for the cluster and its shared volume

contract'PAY_AS_YOU_GO' | 'LONG_TERM' nullable

Contract type. For clusters, only PAY_AS_YOU_GO currently supported.

extension_settings'auto_renew' | 'pay_as_you_go' | 'end_contract' nullable

Extension settings for long-term contracts. Takes priority over auto_rental_extension and turn_to_pay_as_you_go.

auto_rental_extensionboolean nullable

Deprecated: use extension_settings instead. Enable automatic rental extension for long-term contracts.

turn_to_pay_as_you_goboolean nullable

Deprecated: use extension_settings instead. Automatically convert to pay-as-you-go after the long-term period ends.

Example request

{
  "cluster_type": "16H200",
  "image": "ubuntu-22.04-cuda-12.4-cluster",
  "startup_script_id": "d73909a3-5dd6-40d1-8b85-26de31b44744",
  "hostname": "dark-vm-shrinks-fin-01",
  "description": "ubuntu-22-04-cuda-12-4-16b200-fin-01",
  "tags": [
    {
      "key": "environment",
      "value": "production"
    },
    {
      "key": "benchmark"
    }
  ],
  "location_code": "FIN-01",
  "contract": "PAY_AS_YOU_GO",
  "shared_volume": {
    "name": "SFS-pmAna3o2",
    "size": 30000
  },
  "existing_volumes": []
}

Response

Cluster deployed

idstring required

Example response

{
  "id": "8575039f-b82d-4d60-bb39-3f571ada8bfa"
}

Changes