Skip to main content

Ephemeral Instances

Ephemeral instances have a temporary boot disk that does not persist between instance stop and start. Ephemeral instances are well-suited for stateless worker nodes on inference clusters.

Create a Ephemeral Instance

To create a ephemeral instance via the REST API, send a POST request to the /instances endpoint with the ephemeral field set to true:

POST /instances HTTP/1.1
Host: <your-cluster-url>
Authorization: Bearer <your-auth-token>
Content-Type: application/json

{
"name": "example",
"type": "cpu.8x",
"ephemeral": true,
}