沙箱实例暂停和恢复用于对运行中的沙箱实例执行暂停（Pause）与恢复（Resume）操作。暂停后，实例进入暂停状态，其计算资源被释放并停止计费，运行状态被完整保存。本文为您介绍该功能的背景信息、使用场景及操作方法。

注意

暂停和恢复能力当前处于邀测阶段，如需开通请提交工单。

暂停和恢复能力仅对开通该功能之后新创建的沙箱实例生效。

## 背景信息在许多场景下，沙箱实例创建后并非始终满负荷运行，而是存在大量等待用户输入、等待外部事件的空闲时段。若实例在空闲期间持续运行，会带来不必要的资源占用与成本。沙箱实例暂停和恢复支持您在实例空闲时主动将其暂停，停止计费并保存运行状态，需要继续使用时再将其恢复，从暂停前的状态继续运行。 ### 状态流转沙箱实例在 **运行中** 与 **已暂停** 两种状态间切换。暂停时释放资源（停止计费），恢复时重新分配资源。您可通过控制台操作，也可调用 [PauseSandbox](https://www.volcengine.com/docs/6662/2544749?lang=zh)、[ResumeSandbox](https://www.volcengine.com/docs/6662/2288382?lang=zh) 接口分别完成暂停与恢复。状态流转如下图所示。

说明

暂停后，实例的计算资源（CPU / 内存）被释放，恢复时系统重新分配资源。处于暂停状态的实例同样支持查询与终止操作。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0093c1671200e30a58cf6e1b8199c173.png) ### 暂停时资源保留情况 * 文件系统（含文件内容）：保留，以文件系统快照形式保存，恢复后与暂停前一致。 * 内存数据: 不保留，进程内存中的数据、运行中的进程、已建立的网络连接等在恢复后需重新初始化。 ## 使用场景沙箱实例暂停和恢复适用于以下使用场景。 |**场景** |**说明** | |---|---| |长会话 AI Agent |Agent 在等待用户下一轮输入时往往长时间空闲，暂停后停止计费，用户回话时恢复续跑，可降低单会话的闲置成本。 | |交互式开发 / 在线 IDE |开发者离开期间暂停环境，返回时无需重建即可继续，在降低成本的同时保留完整上下文。 | |按需触发的任务型沙箱 |任务间歇期暂停实例，按需恢复执行，避免为低频任务长期保有运行实例。 | |成本敏感型批量场景 |大量实例存在错峰空闲时，通过暂停回收闲置资源，在保留状态的同时降低整体资源占用。 | ## 前提条件已创建沙箱实例，操作详情参见 [沙箱实例](https://www.volcengine.com/docs/6662/1802882?lang=zh)。 ## 操作步骤 ### 第一步：暂停沙箱实例 1. 登录 [函数服务控制台](https://console.volcengine.com/vefaas)。 2. 在顶部导航栏，选择目标地域。 3. 在左侧导航栏选择 **云沙箱 \> 沙箱应用**，单击目标应用名称进入详情页，选择 **沙箱实例** 页签。 4. 找到目标实例，在 **操作** 列中单击 **... \> 暂停**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_536ec376e2252996612df724d4cc1b04.png) 5. 在二次确认页面，单击 **确定**，完成操作。 ### 第二步：恢复沙箱实例 1. 在 **沙箱实例** 页签，单击 **查看已暂停实例**，展示已暂停的沙箱实例。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_6afbf43a5329b2df10486b806925de8e.png) 2. 在目标沙箱实例的 **操作** 列，单击 **恢复。** 3. 在二次确认页面，单击 **确定**，实例恢复运行状态。