latestOpenAPI 3.1.02026-08-19151182242.8 KB

b75b478564cc

Reservations

Take released GPU units back off the market, evicting spot workloads

Returns the named units to exclusive use AND terminates the spot workloads running on them, in one call. Everything evicted was bought at the spot tier, whose terms are exactly that the capacity owner can reclaim without notice. Pass dryRun to see what would be terminated without changing anything. Callable by a platform operator, the org that owns the node, or an org in the reservation's managingOrgIds.

post/v1/nodes/{nodeId}/reservations/{id}/reclaim

Path parameters

nodeIdstring required

idstring required

Request body

dryRunboolean

Report which spot workloads would be terminated, and change nothing: no terminations, and the capacity boundary stays where it is.

reasonstring

Recorded in the audit trail.

unitIdsstring[] required

Response

allowedOrgIdsstring[] required

The audience: orgs that may place workloads on the reserved units.

contractRefstring

createdAtstring

endsAtstring

Absent = open-ended until cancelled

idstring required

managingOrgIdsstring[]

Orgs that may release these units to the market, reclaim them, and terminate the spot workloads on them, on the node owner's behalf. Being in the audience does not confer this.

nodeIdstring required

reasonstring

releasedUnitIdsstring[]

The subset of reservedUnitIds currently on the spot market (double sell). Still this reservation's capacity, sellable to anyone at tier=spot only, and reclaimable at any time.

reservedUnitIdsstring[] required

skippedstring[]

Reclaim only: VM ids left running because they are not spot.

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.

terminatedstring[]

Reclaim only: spot VM ids terminated to free the reclaimed units.

topologyGeninteger

Node topology generation this reservation was written against

updatedAtstring

wouldSkipstring[]

Reclaim dry run only: VM ids that would be left running.

wouldTerminatestring[]

Reclaim dry run only: the spot VM ids this call would terminate.