Clusters

Get cluster by id

Changed on
get/v1/clusters/{id}

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/clusters/{id}
  • Auth: HTTP bearer

Path parameters

idstring required
Example:dd808a52-1bad-4e43-962b-fd9a9f980260

Response

Cluster details

idstring required
ipobject required

Jump host IP address

status'running' | 'provisioning' | 'offline' | 'discontinued' | 'unknown' | 'ordered' | 'notfound' | 'new' | 'error' | 'deleting' | 'validating' | 'no_capacity' | 'installation_failed' required
created_atstring required
created_by_user_idobject
cpuobject required
gpuobject required
gpu_memoryobject required
memoryobject required
hostnamestring required
descriptionstring required

Cluster description; an empty string when none was supplied.

locationstring required
price_per_hournumber required
cluster_typestring required
imageobject required

OS image used to deploy the cluster nodes

os_nameobject required
startup_script_idobject
ssh_key_idsstring[] required

SSH key IDs used to access the cluster jump host

contract'LONG_TERM' | 'PAY_AS_YOU_GO' required

Contract type used for this cluster

auto_rental_extensionboolean

Deprecated: use extension_settings instead.

turn_to_pay_as_you_goboolean

Deprecated: use extension_settings instead.

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

Extension settings for long-term contracts

long_term_periodstring

Long-term rental period for this cluster, e.g. 1 week etc.

worker_nodesstring[]

Worker nodes of this cluster. You can access them from the jump host by executing ssh <hostname>

shared_volumesstring[]

Shared volumes attached to this cluster. There is always one shared volume mounted as /home.

Example response

{
  "id": "8aa5bb1b-40ea-49fa-9b45-2843e83bc905",
  "status": "running",
  "created_at": "2023-07-15T14:10:26.654Z",
  "cpu": {
    "description": "176 CPU",
    "number_of_cores": 176,
    "model": "AMD Genoa"
  },
  "gpu": {
    "description": "8x A100",
    "number_of_gpus": 8
  },
  "gpu_memory": {
    "description": "80GB GPU RAM",
    "size_in_gigabytes": 80
  },
  "memory": {
    "description": "640GB RAM",
    "size_in_gigabytes": 640
  },
  "hostname": "hazy-star-swims-fin-01",
  "description": "ubuntu-22-04-cuda-12-0-docker-fin-01",
  "tags": [
    {
      "id": "tag_0aB1cD2eF3gH4iJ5kL6mN7",
      "key": "environment",
      "value": "production"
    }
  ],
  "location": "FIN-01",
  "price_per_hour": 2.481,
  "cluster_type": "16H200",
  "ssh_key_ids": [
    "dd50b622-1c36-48c2-a485-f4d4937a3ea1"
  ],
  "contract": "LONG_TERM",
  "long_term_period": "1 week",
  "worker_nodes": [
    {
      "id": "1",
      "hostname": "worker-1",
      "public_ip": "1.2.3.4",
      "private_ip": "1.2.3.4",
      "status": "running"
    }
  ],
  "shared_volumes": [
    {
      "id": "1",
      "name": "shared-volume-1",
      "mount_point": "/home",
      "size_in_gigabytes": 100
    }
  ]
}

Changes

  • 416768e2fdd7Revision changes
    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

    • breaking

      the response's property type changed from string to object for status

  • c6bc656333bdRevision changes
    • info

      added the required property to the response with the status