| Name | Type | Description |
|---|---|---|
sandbox_name* | str | Name of the sandbox to capture from. |
name* | str | Snapshot name. |
tag | Optional[str] | Default: NoneTag to publish the snapshot under, within |
docker_image | Optional[str] | Default: None |
fs_capacity_bytes | Optional[int] | Default: None |
run_config | Optional[Union[RunConfig, dict[str, Any]]] | Default: None |
timeout | int | Default: 60 |
Capture a snapshot from a running sandbox.
Blocks until the snapshot is ready (polls with 2s interval).
Optional Docker image tag inside the sandbox to export into the snapshot instead of capturing the live root filesystem.
Filesystem capacity in bytes for Docker image export.
Override applied over the configuration the captured
sandbox was running with: user and work_dir replace,
env_vars merge. The captured sandbox's own env_vars
are a per-sandbox layer and are not carried into the snapshot.
Timeout in seconds when waiting for ready.
