创建沙箱快照
更新时间:2026-11-17
接口描述
基于运行中的沙箱当前状态创建一个持久化快照模板。快照名称同时作为模板 ID,可直接作为 templateID 创建新沙箱。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes/{sandboxID}/snapshots 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参数 | 沙箱实例 ID。 |
| name | String | 是 | RequestBody参数 | 快照模板名称,同时作为模板 ID。 |
| resourceGroupId | String | 否 | RequestBody参数 | 快照模板归属的资源管理资源组 ID,可选。 |
返回状态码
成功返回 201。name 为空或请求体非法返回 400;name 与官方模板 ID 冲突返回 409;其它失败按后端错误的状态码返回;认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| snapshotID | String | 快照模板 ID,与请求中的 name 相同,可作为 templateID 创建沙箱。 |
| names | List |
快照模板名称列表,当前仅包含 name 一项。 |
请求示例
Plain Text
1POST /sandboxes/sandbox-1/snapshots HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "name": "sandbox-template-1"
8}
响应示例
Plain Text
1HTTP/1.1 201 Created
2Content-Type: application/json
3
4{
5 "snapshotID": "sandbox-template-1",
6 "names": ["sandbox-template-1"]
7}
评价此篇文章
