查询沙箱快照列表
更新时间:2026-11-17
接口描述
查询指定沙箱实例在暂停过程中产生的快照记录列表。快照 ID 可在“连接沙箱实例”接口中通过 snapshotID 指定恢复点。Kata 快照还会额外返回 kata 字段(平台内部结构,不属于稳定契约,请勿依赖)。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口。
请求结构
Plain Text
1GET /sandboxes/{sandboxID}/snapshots HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
请求头域
除公共头域外,无其他特殊头域。Authorization 支持 IAM API Key(Bearer bce-v3/ALTAK-...)或 AK/SK 签名(bce-auth-v1/...)。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| sandboxID | String | 是 | URL参数 | 沙箱实例 ID。 |
返回状态码
成功返回 200。沙箱没有快照记录返回 404(sandbox snapshot not found);认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sandboxId | String | 沙箱实例 ID。 |
| snapshots | List |
快照列表,可能为 null。 |
请求示例
Plain Text
1GET /sandboxes/sandbox-1/snapshots HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3
4{
5 "sandboxId": "sandbox-1",
6 "snapshots": [
7 {
8 "snapshotId": "3f6c2b1e-8a2d-4c1e-9b7a-1d2e3f4a5b6c",
9 "status": "succeeded",
10 "createTime": "2026-11-16T14:00:00+08:00",
11 "finishedTime": "2026-11-16T14:00:05+08:00"
12 }
13 ]
14}
评价此篇文章
