Skip to main content
Before you start, ensure you have set your API keys and SSH key path as outlined in the CLI introduction.

Retrieving GPU Availability Data

To see all available GPU types and their current pricing across all regions, simply run:
This command will display a table showing all available GPU configurations, including details like GPU type, count, location, price per hour, and stock status.

Retrieving Disk Availability Data

To see all available disk storage options across providers and datacenters:
This displays available persistent storage configurations with pricing, maximum capacity, and multinode support information.

Retrieving Filtered GPU Availability Data

You can then use filters like --gpu-type, --regions, or --gpu-count to narrow down the results. Here are all available filters:

GPU Availability Filters

  • --gpu-type: Filter by specific GPU model
    • Example: --gpu-type H100_80GB
    • Optional string value
  • --gpu-count: Filter by number of GPUs
    • Example: --gpu-count 2
    • Optional integer value
  • --regions: Filter by geographic regions
    • Example: --regions united_states,canada or --regions united_states --regions canada
    • Optional, can specify multiple regions
  • --socket: Filter by socket type
    • Example: --socket PCIe
    • Accepts values: PCIe, SXM2, SXM3, SXM4, SXM5
    • Optional string value
  • --disks: Filter GPUs by disk IDs (shows GPUs in same location as disks)
    • Example: --disks disk-id-1 --disks disk-id-2
    • Optional, can specify multiple disk IDs
    • Useful for finding GPUs compatible with your existing disks
  • --group-similar: Group similar configurations from same provider
    • Example: --no-group-similar
    • Default: true
    • Optional boolean flag

Example with Multiple Filters

Finding GPUs Compatible with Your Disks

If you have existing disks and want to find GPUs in the same datacenter/region:
This ensures you see only GPU configurations that can access your existing disks.

Retrieving Filtered Disk Availability Data

Disk Availability Filters

  • --regions: Filter by geographic regions
    • Example: --regions united_states,eu_north
    • Optional, can specify multiple regions
  • --data-center-id: Filter by specific datacenter
    • Example: --data-center-id US-1
    • Optional string value
  • --cloud-id: Filter by cloud configuration ID
    • Example: --cloud-id "Provider Storage A"
    • Optional string value

Example with Filters

Understanding the Terminal Output

GPU Availability Output

Here’s an example of what the command output looks like: Each row represents a unique GPU configuration available for deployment. The output includes:
  • A unique ID for the configuration
  • GPU specifications (type, count, socket)
  • Provider and location information
  • Current stock status
  • Pricing and hardware details

Disk Availability Output

For disk availability, the output includes: Each row represents available disk storage with:
  • A unique ID for the configuration
  • Provider offering the storage
  • Location (country and datacenter)
  • Stock availability status
  • Price per GB per hour
  • Maximum disk size supported
  • Whether the disk supports multinode (can be attached to multiple instances)