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.
nscale reservations list [flags]
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 nscale reservations list --org < org-i d > --region < region-i d >
get Get details for a specific reservation.
nscale reservations get --id < reservation-i d > --org < org-i d >
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: unitsnscale reservations capacity [flags]
Flags 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 nscale reservations capacity --region < region-i d > --accelerator GB300
create Create a new reservation. Accepts input from a JSON file or stdin.
nscale reservations create [flags]
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 nscale reservations create --file reservation.json nscale reservations create --stdin < reservation.json cat reservation.json | nscale reservations create --stdin
delete Delete an existing reservation.
nscale reservations delete --id < reservation-i d > --org < org-i d > [flags]
Flags Flag Description --id stringReservation ID --org stringOrganization ID --dry-runPreview the request payload without persisting -y, --yesAutomatically confirm deletion
Example nscale reservations delete --id < reservation-i d > --org < org-i d > --yes
Placements Place workloads onto reserved capacity and manage their servers.
