Options for creating a sandbox.
interface CreateSandboxOptionsSeconds after the sandbox enters the stopped state before it (and
its filesystem clone) are permanently deleted. Must be a multiple of
60. Pass 0 to disable stop-anchored deletion (manual cleanup
required). When omitted, the server applies its configured default
(typically 14 days).
Root filesystem capacity in bytes.
Idle timeout in seconds. The launcher stops the sandbox after this many
seconds of inactivity. Must be a multiple of 60. Pass 0 to disable
the idle stop. When omitted, the server applies a default of 600
seconds (10 minutes).
Memory in bytes.
A human-readable name for the run.
Per-sandbox proxy configuration. Use
{ access_control: { allow_list: ["github.com", "*.example.com"] } }
to restrict outbound HTTPS to a set of host patterns. Forwarded to the
server as-is on the wire.
Optional snapshot name to boot from. Mutually exclusive with the positional
snapshotId.
Resolved server-side to a snapshot owned by the caller's tenant.
Number of vCPUs allocated.
Whether to wait for the sandbox to be ready before returning. When false, returns immediately with status "provisioning". Use getSandboxStatus() or waitForSandbox() to poll for readiness. Default: true.