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 with GET /v1/orchestrator/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
reservedNodeCount
integer
required
reservedGpuCount
integer
required
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
gpusPerNode
integer
pricePerGpuHourMicroUsd
integer<int64>

Your agreed reservation rate in integer micro-USD per GPU-hour, 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
pendingOperationId
string<uuid>
vmDiskId
string<uuid> | null
deployedAt
string<date-time> | null
endReason
string | null
transactionId
string<uuid>
createdAt
string<date-time>
updatedAt
string<date-time>
relistableNodeCount
integer
relistUnavailableReason
string | null
relistableNodeIds
string<uuid>[]