Skip to main content
PUT
Choose a VM disk for a reservation
Copy a disk ID from Disks in the console, or list your disks and use an entry’s id. The CLI does not set reservation disks. For the full flow, see Use the API.

Authorizations

Authorization
string
header
required

Create an organization API key in Account Settings > Developer. Do not send this key to the Kubernetes API server.

Path Parameters

reservationId
string<uuid>
required

Reservation ID.

Body

application/json
vmDiskId
string<uuid> | null

An Ornn disk or one of your organization's disks. Null clears the choice.

Response

The saved choice. The reservation now carries the disk in vmDiskId.

reservationId
string<uuid>
required
status
enum<string>
required
Available options:
confirmed,
active,
completed,
cancelled
isSpot
boolean
required

Whether this is an hourly Spot or On-demand reservation. Use kind to distinguish the rental types.

kind
enum<string> | null
required

Saved rental type. Null when no rental type was recorded for a historical reservation.

Available options:
reserved,
spot,
on-demand,
null
reservedNodeCount
integer
required
reservedGpuCount
integer
required

GPUs reserved; 0 for CPU capacity.

startsAt
string<date-time>
required
endsAt
string<date-time> | null
required
customerId
string<uuid>
listingId
string<uuid>
listingTermId
string<uuid>
provisioningType
enum<string>
Available options:
virtual-machine,
bare-metal,
kubernetes,
slurm
facilityId
string<uuid>
gpuSlug
string | null

Catalog GPU slug. Null for CPU capacity, nodes without GPUs.

gpusPerNode
integer

GPUs per node; 0 for CPU capacity.

coresPerNode
integer | null

CPU capacity only. Cores per node, at least 1; each core is 2 vCPUs. Null for GPU capacity.

Required range: x >= 1
cores
integer | null

CPU capacity only. Cores reserved, at least 1; each core is 2 vCPUs, so the reservation holds twice as many vCPUs, and pricePerGpuHourMicroUsd is per vCPU-hour. Null for GPU capacity.

Required range: x >= 1
pricePerGpuHourMicroUsd
integer<int64>

Your agreed reservation rate in integer micro-USD per unit-hour (GPU-hour, or vCPU-hour for CPU capacity), including any fee you pay. Historical reservations without a saved rate show the linked listing term price.

durationHours
number | null

Original agreed duration in hours, separate from operational start and end dates. Renewable reservations retain this duration with a null end date. Null when no duration was agreed.

renewable
boolean | null

Whether the reservation contract permits renewal.

downPaymentCents
integer<int64> | null
pendingOperation
string | null

Reservation reads report pending transfer or node maintenance actions only and do not poll activation or stopping progress. A lifecycle mutation response may include its accepted command. Null alone does not confirm that machine changes have completed.

pendingOperationId
string<uuid>
vmDiskId
string<uuid> | null
deployedAt
string<date-time> | null
endReason
string | null
preemptNoticeSeconds
integer | null

Spot and On-demand only. The notice, in seconds, this VM gets before its seller can take its node back, fixed when you bought it. Null for reserved bookings.

allNodesInterruptionAt
string<date-time>

Scheduled reclaim time for all nodes in this buyer's running hourly reservation, when its listed capacity ends.

nodeInterruptions
object

Earliest pending reclaim time for each affected host node ID in this buyer's running hourly reservation. A VM on that node is reclaimed at the earlier of its node deadline and the reservation-wide deadline.

interruptionAt
string<date-time>

Earliest scheduled node reclaim or listed-capacity end for a running Spot or On-demand reservation. Shown only to the buyer. A node reclaim may affect only part of the reservation. Omitted when no deadline is scheduled or the reservation has ended; shutdown and cleanup may finish later.

failure
object

Present when a Spot or On-demand reservation ended because an hour could not be paid (payment_failed) or its VMs could not start (provisioning_failed). Shown only to the buyer.

transactionId
string<uuid>
createdAt
string<date-time>
updatedAt
string<date-time>
relistableNodeCount
integer
relistUnavailableReason
string | null