创建沙箱实例
更新时间：2026-08-14
接口描述
创建一个新的沙箱实例。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| templateID | String | 是 | RequestBody参数 | 沙箱模板 ID。 |
| timeout | Integer | 否 | RequestBody参数 | 沙箱超时时间，单位秒。 |
| metadata | Map<String,String> | 否 | RequestBody参数 | 沙箱标签元数据。 |
| envVars | Map<String,String> | 否 | RequestBody参数 | 沙箱环境变量。 |
| secure | Boolean | 否 | RequestBody参数 | 是否对沙箱的全部系统通信进行加密。 |
| allow_internet_access | Boolean | 否 | RequestBody参数 | 是否允许沙箱访问公网。 |
| autoPause | Boolean | 否 | RequestBody参数 | 超时后是否自动暂停沙箱。 |
| autoResume | Map<String,Object> | 否 | RequestBody参数 | 暂停沙箱后的自动恢复配置，含 enabled（Boolean）字段。 |
| runtimeType | String | 否 | RequestBody参数 | 沙箱运行时类型，可选 kata；仅白名单用户可指定，默认空为 CRIU。 |
| mcp | Map<String,Object> | 否 | RequestBody参数 | 沙箱的 MCP 配置。 |
| volumeMounts | List<Map<String,Object>> | 否 | RequestBody参数 | 挂载到沙箱的 NFS 卷列表，元素含 name、path、subPath、readOnly 字段。 |
返回状态码
成功返回 200，失败返回公共错误码。
返回头域
除公共头域外，无其他特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sandboxID | String | 新建沙箱实例 ID。 |
| templateID | String | 使用的模板 ID。 |
| envdAccessToken | String | envd 访问令牌。 |
| domain | String | 沙箱访问域名。 |
| alias | String | 模板别名。 |
| clientID | String | 客户端 ID。 |
| envdVersion | String | envd 版本号。 |
| vpcDomain | String | 沙箱 VPC 访问域名。 |
请求示例
Plain Text
1POST /sandboxes HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "templateID": "openclaw-lite",
8 "timeout": 3600,
9 "metadata": {
10 "app": "agent"
11 },
12 "envVars": {
13 "FOO": "bar"
14 },
15 "allow_internet_access": false,
16 "autoPause": false,
17 "runtimeType": "kata",
18 "mcp": {
19 "endpoint": "https://example.com/mcp"
20 },
21 "volumeMounts": [
22 {
23 "name": "data",
24 "path": "/mnt/data"
25 }
26 ]
27}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3
4{
5 "alias": "openclaw-lite",
6 "clientID": "",
7 "domain": "sandbox-execute.gz.baidubce.com",
8 "envdAccessToken": "gray_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
9 "envdVersion": "0.1.4",
10 "sandboxID": "xaf6kcuqt8808tkt04o2",
11 "templateID": "openclaw-lite"
12}评价此篇文章