Instances

Get instances

Changed on

Return all instances of the project, optionally filtered by status and/or tags.

Tag filters: tag=key matches instances carrying the key with any value, tag=key=value matches the value exactly (split at the first =). Repeat the parameter to require multiple tags at once.

Rate limits

This endpoint is rate limited to 120 requests per minute per project.

get/v1/instances

Request

  • Base URL: https://api.verda.com
  • URL: https://api.verda.com/v1/instances
  • Auth: HTTP bearer

Query parameters

status'running' | 'provisioning' | 'offline' | 'discontinued' | 'unknown' | 'ordered' | 'notfound' | 'new' | 'error' | 'deleting' | 'validating' | 'no_capacity' | 'installation_failed'

Get compute deployments with selected status. Optional

computeIdstring

Get one compute by computeId. Optional

tagstring[]

Return only deployments carrying every listed tag: key matches any value, key=value matches the value exactly (split at the first =). Repeat the parameter to require multiple tags.

[
  "environment=production",
  "benchmark"
]

Response

Instance or a list of instances

idstring required
ipobject nullable required

Public address; null when the instance is not reachable from the internet

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
storageobject required
hostnamestring required
descriptionstring required

Instance description; an empty string when none was supplied.

locationstring required
price_per_hournumber required
is_spotboolean required
instance_typestring required
imageobject required
os_nameobject required
startup_script_idobject required
ssh_key_idsstring[] required
os_volume_idobject required
jupyter_tokenobject required
contract'LONG_TERM' | 'PAY_AS_YOU_GO' | 'SPOT' required
pricing'DYNAMIC_PRICE' | 'FIXED_PRICE' required
volume_idsstring[] required

Example response

[
  {
    "id": "22a4a7ac-7c9d-42cd-943b-1d7f0008689e",
    "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
    },
    "storage": {
      "description": "dynamic"
    },
    "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,
    "instance_type": "8A100.176V",
    "ssh_key_ids": [
      "dd50b622-1c36-48c2-a485-f4d4937a3ea1"
    ],
    "contract": "PAY_AS_YOU_GO",
    "pricing": "FIXED_PRICE",
    "volume_ids": [
      "95cec4c3-af69-42eb-a790-fcacebfdfcea",
      "dd50b622-1c36-48c2-a485-f4d4937a3ea1"
    ]
  }
]

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

    • 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

  • 35386fd1e538Revision changes
    • breaking

      removed the required property / from the response with the status