reservations, reservation, res
Commands that act on one reservation take its ID either as a positional argument or with --id. If you omit it, the CLI opens an interactive picker, so always pass it in scripts.
Subcommands
- list — List reservations
- get — Get reservation details
- capacity — List available reservation units
- topology — Show organization topology
- create — Create a new reservation
- delete — Delete a reservation
list
List reservations, optionally filtered by organization, project, or region.Flags
| Flag | Description |
|---|---|
| Organization ID | |
| Project ID | |
| Region ID | |
Emit the full JSON payload (mutually exclusive with -q) | |
jq filter for value extraction (see Query output with -q) |
Example
get
Get details for a specific reservation.Flags
| Flag | Description |
|---|---|
| Reservation ID | |
| Organization ID | |
Emit the full JSON payload (mutually exclusive with -q) | |
jq 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:units
Flags
| Flag | Description |
|---|---|
| Region ID | |
Accelerator model, for example GB300 | |
Reservation unit, for example NVL72 | |
Emit the full JSON payload (mutually exclusive with -q) | |
jq filter for value extraction (see Query output with -q) |
Example
topology
Show the bare-metal capacity allocated to your organization, laid out by region, pod, NVLink domain, and host, with the reservations and placements that hold it. This is the CLI counterpart to the Console’s Topology View. Filter by project, region, reservation, accelerator model, or unit type to narrow the output. In human output, each reservation unit names its machine flavor, including pinned-only flavors that only reserved capacity can use.Organization-level access required. Like the Topology View, this command needs organization-level read access to reservation topology, for example the reservation-capacity-reader role assigned at organization level. See Roles and groups. If topology isn’t enabled for your organization, the command fails with
the "topology" command is not available for organization <org-id>.Flags
| Flag | Description |
|---|---|
| Project ID | |
| Region ID | |
| Reservation ID | |
Accelerator model, for example GB300 | |
Reservation unit, for example NVL72 | |
Human output view: tree or grid (default tree). Has no effect on or -q output | |
Emit the full JSON payload (mutually exclusive with -q) | |
jq filter for value extraction (see Query output with -q) |
Examples
create
Create a new reservation. Accepts input from a JSON file or stdin.Flags
| Flag | Description |
|---|---|
| Path to a JSON file | |
| Read JSON from standard input | |
| Preview actions and payload without persisting | |
| Automatically confirm creation | |
Emit the full JSON payload (mutually exclusive with -q) | |
jq filter for value extraction (see Query output with -q) |
Examples
delete
Delete an existing reservation.Flags
Example
Related
Placements
Place workloads onto reserved capacity and manage their servers.
Topology View
See allocated capacity as a map in the Console.