VMs

A VM is the running Firecracker microVM that backs an instance. Instances are durable; VMs are ephemeral — you start one to do work, stop it when you're done, and the instance's disk state persists either way. A VM lives at /v1/instances/:id/vm.

For background on the durable side, see Instances.

Lifecycle

• POST /v1/instances/:id/vm — start the VM
• GET /v1/instances/:id/vm — current VM state (running, stopped, …)
• POST /v1/instances/:id/vm/restart — soft reboot
• DELETE /v1/instances/:id/vm — stop the VM (instance state persists)
• POST /v1/instances/:id/vm/flush — force-write dirty disk pages to R2

What you can do with a running VM

• Exec commands
• Read and write files
• Open SSH sessions
• Forward ports
• Capture snapshots and checkpoints