派生沙箱实例
更新时间:2026-11-17
接口描述
基于运行中的源沙箱派生(fork)一个新的沙箱实例。新实例继承源沙箱的运行状态与出网策略,返回新的 sandboxID。调用方必须是源沙箱的所有者。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes/{sandboxID}/fork 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/...)。请求无需携带 body。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| sandboxID | String | 是 | URL参数 | 源沙箱实例 ID。 |
返回状态码
成功返回 201。源沙箱不存在或不属于当前账号返回 404;其它失败按后端错误的状态码返回;认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sandboxID | String | 新派生的沙箱实例 ID。 |
| templateID | String | 模板 ID。 |
| alias | String | 模板别名。 |
| clientID | String | 客户端 ID,已废弃,固定为空字符串。 |
| domain | String | 沙箱访问根域名。 |
| envdAccessToken | String | envd 访问令牌。 |
| envdVersion | String | envd 版本号。 |
请求示例
Plain Text
1POST /sandboxes/sandbox-1/fork HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
响应示例
Plain Text
1HTTP/1.1 201 Created
2Content-Type: application/json
3
4{
5 "sandboxID": "forked-sandbox-id",
6 "templateID": "openclaw-lite",
7 "alias": "openclaw-lite",
8 "clientID": "",
9 "domain": "sandbox-execute.bj.baidubce.com",
10 "envdAccessToken": "xxxxxxxx",
11 "envdVersion": "0.1.4"
12}
评价此篇文章
