连接沙箱实例
更新时间：2026-08-14
接口描述
连接并续期一个沙箱实例，必要时恢复实例。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口。
请求结构
Plain Text
1POST /sandboxes/{sandboxID}/connect HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| sandboxID | String | 是 | URL参数 | 沙箱实例 ID。 |
| timeout | Integer | 是 | RequestBody参数 | 续期时间，单位秒；-1 表示永久。 |
| snapshotID | String | 否 | RequestBody参数 | 恢复时使用的快照 ID。 |
返回状态码
成功返回 200 或 201，失败返回公共错误码。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| sandboxID | String | 沙箱实例 ID。 |
| templateID | String | 模板 ID。 |
| envdAccessToken | String | envd 访问令牌。 |
| domain | String | 沙箱访问域名。 |
请求示例
Plain Text
1POST /sandboxes/sandbox-1/connect HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "timeout": 3600,
8 "snapshotID": "snapshot-1"
9}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json
3
4{
5 "sandboxID": "sandbox-1",
6 "templateID": "openclaw-lite",
7 "envdAccessToken": "",
8 "domain": "sandbox-1.example.com"
9}评价此篇文章