批量释放沙箱实例
更新时间:2026-11-17
接口描述
批量释放沙箱实例:删除实例并保留 sandboxID 与恢复参数。释放后可通过“连接沙箱实例”接口按原 sandboxID 恢复(重新创建实例,返回 201)。注意释放不保留沙箱内的数据。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes/batchRelease 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/...)。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| sandboxIds | List |
是 | RequestBody参数 | 要释放的沙箱实例 ID 列表,1~100 个。 |
返回状态码
请求合法时总是返回 200,逐个沙箱的结果见 results。sandboxIds 为空、超过 100 个或请求体非法返回 400;认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| results | List |
每个沙箱实例的释放结果,顺序与请求一致。 |
请求示例
Plain Text
1POST /sandboxes/batchRelease HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "sandboxIds": ["sandbox-1", "sandbox-2"]
8}
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3
4{
5 "results": [
6 {"sandboxId": "sandbox-1", "success": true},
7 {"sandboxId": "sandbox-2", "success": false, "error": "sandbox not owned by user"}
8 ]
9}
评价此篇文章
