| 说明 | 查看或延长云端沙箱的 TTL |
| 用法 | sbx ttl [+DURATION] SANDBOX [flags] |
描述
查看或延长云端沙箱的 TTL。
只带一个参数时，打印当前的过期时间，以及距离「自创建起 24 小时」这一硬性上限还剩多少时间。
带两个参数时 — 一个以 '+' 开头的时间长度，后面跟沙箱 ID 或名称 — 会把 TTL 延长相应的时长，但不会超过服务端强制执行的上限。服务端无法缩短过期时间，因此 DURATION 必须为正。单位使用 Go 的时长单位（h、m、s、ms、us、ns），大小写均可（+2h、+2H、+1h30m）。
SANDBOX 可以是 ID（sbx_*）或名称，名称如 "sbx --cloud ls" 所示。
仅限云端：本地沙箱不由 TTL 管理。
选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--format | 输出格式：table、json 或 yaml | |
--json | 以 JSON 格式输出 |
全局选项
| 选项 | 默认值 | 说明 |
|---|---|---|
--cloud | 改为调用 Docker Cloud Sandboxes API，而不是本地 sandboxd（支持的动词正在逐步增加，运行 sbx --cloud --help 查看当前列表） | |
-D, --debug | 启用调试日志 | |
--no-input | 从不提示；需要应答的命令会直接失败，并给出应当运行的命令 |
示例
console
# 显示剩余的 TTL
sbx --cloud ttl my-sandbox
# 延长两小时
sbx --cloud ttl +2h my-sandbox参见
sbx— 管理 AI 编程智能体沙箱。