设置沙箱实例超时时间
更新时间:2026-11-17
接口描述
设置沙箱实例的空闲超时时间,从当前时间起计算。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口,运行成功后可自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /sandboxes/{sandboxID}/timeout 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。 |
| timeout | Integer | 是 | RequestBody参数 | 从当前时间起的存活时间,单位秒,取值范围 (0, 604800]。本接口不支持 -1(永久沙箱请在创建或连接时指定)。 |
返回状态码
成功返回 204,无响应体。timeout 不在取值范围或请求体非法返回 400;其它失败按后端错误的状态码返回(例如沙箱不存在 404);认证失败返回 403。
返回头域
除公共头域外,无其他特殊头域。
返回参数
无返回参数
请求示例
Plain Text
1POST /sandboxes/sandbox-1/timeout HTTP/1.1
2Host: api.sandbox-execute.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
5
6{
7 "timeout": 3600
8}
响应示例
Plain Text
1HTTP/1.1 204 No Content
评价此篇文章
