Skip to main content

Availability

Get the cluster availability for a specific region.

Instance Availability Schema​

  • type String - The type of resource for which to check the availability. In this case it will be instances.
  • region String - The region identifier for which the cluster availability is checked (eg. NORD-NO-KRS-1).
  • instance_types Array - An array of instance types with their availability.

List Availability of Instance Types​

To list all the instance availabilities, send a GET request to /compute/v1/availability/{region}/instances.

GET /compute/v1/availability/{region}/instance (HTTP 200 - OK)

Query parameters

  • region String - The region identifier for which to check the availability (eg. NORD-NO-KRS-1).

Response body

The response will be a JSON object that contains the availability attributes, see Instance Availability Schema:

{
  "availability": {
    "type": "instances",
    "region": "NORD-NO-KRS-1",
    "instance_types": [
      {
        "type": "vcpu-8_memory-48g_nvidia-rtx-3090-1",
        "available": true,
      },
      {
        "type": "vcpu-16_memory-96g_nvidia-rtx-3090-2",
        "available": true,
      },
      {
        "type": "vcpu-24_memory-144g_nvidia-rtx-3090-3",
        "available": false,
      },
      ...
    ],
  }
}

Examples (cURL)​

# List instance availability
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.genesiscloud.com/compute/v1/availability/NORD-NO-KRS-1/instances"