Skip to content
OpenRelay is in early access, and the /v1 API is stable. New capabilities ship in the changelog.
CLICommands

orl reservations unit list

List a node's reservable GPU units, part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing. Usage, every flag and an example.

orl reservations unit list <node-id>

Returns the allocatable GPU units on one node, with the unit ids that create, release, and reclaim take, and whether each unit can be reserved. Without this those calls are unusable: they are unit-scoped by design, and nothing else on the API returns a unit id, so the first reservation on a node could not be written at all. Each unit is one IOMMU group and is indivisible: a paired unit sells its GPUs together. Sellable units of a reservable class (vfio-group for VMs, device-request for pods) are reservable, and the response says which, and why not, rather than leaving the caller to infer it from a rejection. Readable by a platform operator, the org that owns the node, and any org managing a reservation on it. Anyone else gets 404, so the fleet stays unenumerable.

This wraps the listReservationUnits API operation.