Aliases: reservations, reservation, resReservations are gated behind a feature flag. The reservations command is hidden and unavailable unless the feature is enabled for your organization.
Subcommands
list — List reservationsget — Get reservation detailscapacity — List available reservation unitscreate — Create a new reservationdelete — Delete a reservation
list List reservations, optionally filtered by organization, project, or region.
Flags Flag Description —org stringOrganization ID —project stringProject ID —region stringRegion ID —jsonEmit the full JSON payload (mutually exclusive with -q) -q, —query stringArrayjq filter for value extraction (see Query output with -q )
Example get Get details for a specific reservation.
Flags Flag Description —id stringReservation ID —org stringOrganization ID —jsonEmit the full JSON payload (mutually exclusive with -q) -q, —query stringArrayjq filter for value extraction (see Query output with -q )
capacity List available reservation units, optionally filtered by region, accelerator model, or unit type. Useful for checking capacity before creating a reservation.
Alias: unitsFlags Flag Description —region stringRegion ID —accelerator stringAccelerator model, for example GB300 —unit stringReservation unit, for example NVL72 —jsonEmit the full JSON payload (mutually exclusive with -q) -q, —query stringArrayjq filter for value extraction (see Query output with -q )
Example create Create a new reservation. Accepts input from a JSON file or stdin.
Flags Flag Description -f, —file stringPath to a JSON file —stdinRead JSON from standard input —dry-runPreview the request payload without persisting -y, —yesAutomatically confirm creation —jsonEmit the full JSON payload (mutually exclusive with -q) -q, —query stringArrayjq filter for value extraction (see Query output with -q )
Examples delete Delete an existing reservation.
Flags Example
Placements Place workloads onto reserved capacity and manage their servers.
