v2

latestOpenAPI 3.1.02026-08-07139158192.4 KB

Reservations

Reserve GPU units on a node for a set of orgs (platform admin)

Grants exclusive placement rights over specific GPU units for a term. Reserved units disappear from every other org's catalog and cannot be placed on by them. Overlap with an existing reservation is rejected atomically.

post/v1/nodes/{nodeId}/reservations

Path parameters

nodeIdstring required

Request body

allowedOrgIdsstring[] required

The audience. The platform ops org is added automatically so we can validate the node.

contractRefstring

endsAtstring

Omit for open-ended

reasonstring

startsAtstring

Defaults to now

unitIdsstring[] required

GPU unit ids to reserve (from the node's inventory). Must be vfio-group units.

Response

Created

allowedOrgIdsstring[] required

contractRefstring

createdAtstring

endsAtstring

Absent = open-ended until cancelled

idstring required

nodeIdstring required

reasonstring

reservedUnitIdsstring[] required

startsAtstring required

status'pending' | 'active' | 'expired' | 'cancelled' | 'needs-review' required

needs-review means the node's GPU topology changed under the reservation: it grants nothing (and withholds its units from everyone) until an operator re-affirms it.

topologyGeninteger

Node topology generation this reservation was written against

updatedAtstring