Skip to main content
GET
/
api
/
v2
/
reservation-units
List reservation units
curl --request GET \
  --url https://reservation.nks.europe-west4.nscale.com/api/v2/reservation-units \
  --header 'Authorization: Bearer <token>'
[
  {
    "regionId": "uk-lon-1",
    "accelerator": "GB300",
    "unit": "NVL72",
    "machineFlavorId": "g.72.gb300.pinned",
    "deviceTypeResourceClass": "GB300_HOST",
    "hostsPerUnit": 18,
    "cpusPerUnit": 2592,
    "gpusPerUnit": 72,
    "gpuMemoryPerUnit": 20736,
    "memoryPerUnit": 17280,
    "host": {
      "cpus": 144,
      "memory": 960,
      "disk": 0,
      "gpu": {
        "vendor": "NVIDIA",
        "model": "GB300",
        "physicalCount": 4,
        "logicalCount": 4,
        "memory": 288
      }
    },
    "availableUnitCount": 4,
    "largestContiguousUnitCount": 3,
    "totalCount": 8
  },
  {
    "regionId": "us-chi-1",
    "accelerator": "GB300",
    "unit": "NVL72",
    "machineFlavorId": "gb300-nvl72-metal",
    "deviceTypeResourceClass": "GB300_HOST",
    "hostsPerUnit": 18,
    "cpusPerUnit": 2592,
    "gpusPerUnit": 72,
    "gpuMemoryPerUnit": 20736,
    "memoryPerUnit": 17280,
    "host": {
      "cpus": 144,
      "memory": 960,
      "disk": 0,
      "gpu": {
        "vendor": "NVIDIA",
        "model": "GB300",
        "physicalCount": 4,
        "logicalCount": 4,
        "memory": 288
      }
    },
    "availableUnitCount": 2,
    "largestContiguousUnitCount": 2,
    "totalCount": 6
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
regionID
string[]

Allows resources to be filtered by region.

​
accelerator
string[]

Allows reservation units to be filtered by accelerator model or family.

​
unit
string[]

Allows reservation units to be filtered by reservation granularity.

Response

A list of reservation units.

​
regionId
string
required

The region where this reservation unit is offered.

​
accelerator
string
required

Public accelerator model or family, for example GB300.

​
unit
string
required

Public reservation granularity, for example NVL72.

​
machineFlavorId
string
required

Region machine flavor resolved for this reservation unit.

​
deviceTypeResourceClass
string
required

Expected Fleet Manager device type resource class for selected hosts.

​
hostsPerUnit
integer
required

Number of hosts claimed by one reservation unit.

Required range: x >= 1
​
cpusPerUnit
integer
required

Total CPUs claimed by one reservation unit.

Required range: x >= 0
​
gpusPerUnit
integer
required

Total GPUs claimed by one reservation unit.

Required range: x >= 0
​
gpuMemoryPerUnit
integer
required

Total GPU memory in GiB claimed by one reservation unit.

Required range: x >= 0
​
memoryPerUnit
integer
required

Total memory in GiB claimed by one reservation unit.

Required range: x >= 0
​
host
object
required

Region flavor capacity for one host in a reservation unit.

​
availableUnitCount
integer
required

Number of complete, currently unclaimed reservation units.

Required range: x >= 0
​
largestContiguousUnitCount
integer
required

Largest contiguous reservation-unit count currently satisfiable.

Required range: x >= 0
​
totalCount
integer
required

Number of complete reservation units in the regional offering.

Required range: x >= 0