恢复沙箱实例
更新时间:2026-11-17
接口描述
E2B 兼容接口,不建议使用。当前实现并不恢复原沙箱:校验原沙箱处于 paused 状态后,使用原沙箱的模板新建一个沙箱实例并返回,返回的 sandboxID 与请求中的 sandboxID 不同,原沙箱的运行状态和文件不会带到新实例,原沙箱也不会被删除。恢复已暂停的沙箱请使用“连接沙箱实例”接口。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes/{sandboxID}/resume HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
请求头域
除公共头域外,无其他特殊头域。Authorization 支持 IAM API Key(Bearer bce-v3/ALTAK-...)或 AK/SK 签名(bce-auth-v1/...)。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| sandboxID | String | 是 | URL参数 | 处于 paused 状态的原沙箱实例 ID。 |
| timeout | Integer | 否 | RequestBody参数 | 新实例的存活时间,单位秒;不传或 0 为 300,-1 为永久,最大 604800。 |
| autoPause | Boolean | 否 | RequestBody参数 | 已废弃。新实例超时后是否自动暂停。 |
返回状态码
成功返回 201。原沙箱查询失败或处于 killing 状态返回 404(Sandbox can't be resumed, no snapshot found);原沙箱处于 running 状态返回 409;请求体非法返回 400;其它失败返回 500;认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sandboxID | String | 新创建的沙箱实例 ID(不是请求中的 sandboxID)。 |
| templateID | String | 模板 ID。 |
| alias | String | 模板别名。 |
| clientID | String | 客户端 ID,已废弃,固定为空字符串。 |
| state | String | 沙箱状态,固定为 running。 |
| cpuCount | Integer | CPU 核数。 |
| memoryMB | Integer | 内存大小,单位 MiB。 |
| diskSizeMB | Integer | 磁盘大小,单位 MiB。 |
| startedAt | DateTime | 启动时间,RFC3339 格式。 |
| endAt | DateTime | 预计过期时间,RFC3339 格式。 |
| domain | String | 沙箱访问根域名。 |
| envdAccessToken | String | envd 访问令牌,本接口固定为空字符串。 |
| envdVersion | String | envd 版本号。 |
请求示例
Plain Text
1POST /sandboxes/sandbox-1/resume HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "timeout": 3600
8}
响应示例
Plain Text
1HTTP/1.1 201 Created
2Content-Type: application/json
3
4{
5 "sandboxID": "sandbox-new-1",
6 "templateID": "openclaw-lite",
7 "alias": "openclaw-lite",
8 "clientID": "",
9 "state": "running",
10 "cpuCount": 2,
11 "memoryMB": 2048,
12 "diskSizeMB": 10240,
13 "startedAt": "2026-11-16T14:00:00+08:00",
14 "endAt": "2026-11-16T15:00:00+08:00",
15 "domain": "sandbox-execute.bj.baidubce.com",
16 "envdAccessToken": "",
17 "envdVersion": "0.1.4"
18}
评价此篇文章
