mirror of
https://github.com/docker/docs.git
synced 2026-11-04 10:01:00 +00:00
sbx: describe cloud ttl output for stopped sandboxes
sbx --cloud ttl no longer reports a stopped sandbox as expired. Explain that resuming starts a new time-to-live period and describe the stopped and ttl_paused JSON fields. Source: docker/sandboxes#6388 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com>
This commit is contained in:
1 parent
5a4fb43d50
commit
9b52188052
1 file changed
+9
-2
@@ -201,6 +201,12 @@ $ sbx --cloud ttl cloud-project
|
||||
$ sbx --cloud ttl +30m cloud-project
|
||||
```
|
||||
|
||||
A stopped sandbox has no running time-to-live, so `sbx --cloud ttl` reports
|
||||
that it is stopped instead of showing an expiration time. Its time-to-live
|
||||
starts again when the sandbox resumes. In `--json` output, `stopped` and
|
||||
`ttl_paused` are `true`, and the expiry fields still hold the previous
|
||||
deadline. While the sandbox is resuming, only `ttl_paused` is `true`.
|
||||
|
||||
## Stop or remove a sandbox
|
||||
|
||||
Stop a cloud sandbox while preserving its memory and filesystem:
|
||||
@@ -223,8 +229,9 @@ You can also use `sbx --cloud run claude --name cloud-project`, or run the agent
|
||||
without `--name` and select the sandbox when prompted. Add `--detached` to a
|
||||
named run to resume without attaching.
|
||||
|
||||
Resuming keeps the sandbox ID and state. Check its expiration with
|
||||
`sbx --cloud ttl cloud-project` after resuming.
|
||||
Resuming keeps the sandbox ID and state, and starts a new time-to-live
|
||||
period. Check its expiration with `sbx --cloud ttl cloud-project` after
|
||||
resuming.
|
||||
|
||||
If stop or resume reports that an existing sandbox was not found, the operation
|
||||
may be disabled for your account.
|
||||
|
||||
Reference in new issue
Block a user