VMs
Restart a VM
A running VM reboots in place. A stopped or failed VM is started again. For a pod: from stopped or failed, starts it again on the node that holds its volume, re-claiming GPUs there (409 POD_NODE_BUSY when that node's GPUs are taken, POD_NODE_OFFLINE when the node is offline, POD_NODE_NO_INFINIBAND when the org is enabled for InfiniBand but the node's agent predates it, POD_STOPPING while the previous run is still tearing down); from running, recreates the container (the container filesystem resets, /workspace is kept).
Command line
The orl CLI wraps this endpoint:
orl vms restart <id>Authorization
apiKey AuthorizationBearer <token>
OpenRelay API key. Send it as Authorization: Bearer or_… (legacy vl_… keys still work).
In: header
Path Parameters
id*string
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/vms/string/restart"{ "id": "string", "organizationId": "string", "name": "string", "status": "string", "statusReason": "string", "gpuModelId": "string", "gpuCount": 0, "endpointUrl": "string", "volumeGb": 0, "public": true, "createdAt": "string", "provisioningStage": "string", "resourceSize": "string", "tier": "string", "diskSizeGb": 0, "gpuModelName": "string", "pricePerHourCents": 0, "serviceType": "string", "managedBy": "string", "capabilityTier": "string", "computeClass": "string", "imageUrl": "string"}