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

orl reservations unit reclaim

Reclaim released GPU units from spot (asks for confirmation; --yes to skip), part of the orl CLI for OpenRelay GPU VMs, pods, batches and billing.

orl reservations unit reclaim <node-id> <id> --unit-ids <unit-ids>

Returns the named units to the reservation's exclusive use and terminates the spot workloads running on them, in one call. Everything evicted was bought at the spot tier, whose terms are exactly that the capacity owner can reclaim without notice. Pass dryRun to see what would be terminated without changing anything. Callable by a platform operator, the org that owns the node, or an org in the reservation's managingOrgIds while the reservation is active and inside its term.

Flags

FlagTypeRequired
--dry-runboolnoReport which spot workloads would be terminated, and change nothing: no terminations, and the capacity boundary stays where it is.
--reasonstringnoRecorded in the audit trail.
--unit-ids[]stringyes
--bodystringnoa JSON object of request body fields, merged under any of this command's own flags that are also set, e.g. {"key":"value"}
--body-filestringnoread the --body JSON object from a file (- for stdin)
--yesboolnoskip the confirmation prompt
--forceboolnoalias for --yes

This wraps the reclaimReservationUnits API operation.

On this page