Set a deadline at create
Both deadlines are optional. For no deadline, omit the field or send0.
The CLI sets
deleteAfterSeconds with instabox create --delete-after (a duration).
instabox run --timeout sets both from its timeout. The TypeScript SDK takes archiveMs.
The archive deadline is one-shot
The archive deadline is one-shot
Resume does not clear
archiveAt. Once the deadline passes, running or not, archiveAt is cleared. A
machine that was already paused or stopped at that moment is not archived on a later start.Wait for storage sync
Right after a stop or pause, the newest disk state exists only on the host while it uploads. Until then,storage.synced on GET /v1/machines/{id} is false, and a start may only place the machine on
that same host. A snapshot save waits for the upload by itself.
To wait for the upload, poll until synced is true. You can also stop or pause the machine again. On
a machine that is not synced, the second call uploads at once and returns when the machine is synced.
How long the upload takes
How long the upload takes
The upload runs in the background. It takes about ten seconds, plus any wait behind other machines’
uploads, so after many pauses at once it can take minutes. There is no fixed bound.
Machines have no region
A machine has noregion field, and create does not take one. A region in the body is refused as
400 unknown_field. Placement is the platform’s.
Snapshots
Save a machine once and start new ones from it.
Limits
Machines, disk and snapshots per plan.