Volume

Volume独立于任何 Workspace 存在的持久卷。一个 Workspace 最多绑定一个 Volume，默认挂载在 /data。 让 sandbox 的数据跨暂停保留，sandbox 删除后也不丢失。本页介绍按名称创建 Volume、把它挂进 sandbox、删除它，以及查询返回的内容。

概述复制标题链接

网关支持下面这些 Volume 接口：

• 每个 sandbox 最多挂载一个独立 Volume，在创建时用 volumeMounts 指定。
• 创建时没带 volumeMounts 的 sandbox 有自己的 /data Volume，删除 sandbox 时连同数据一起删除。
• 删除 sandbox 不删除用 volumeMounts 挂载的独立 Volume，需要显式删除。
• 暂停保留 Volume，需要跨暂停保留的文件写入 Volume，见暂停与恢复。

按名称创建 Volume复制标题链接

POST /volumes 按名称创建独立 Volume。同一名称同时只由一个 Volume 持有，结果取决于名下最新的、未删除的那个：

Volume 可用期间，用同一名称重复调用 POST /volumes 得到的是同一个 Volume，因此可以在每次创建 sandbox 之前调用它。

把 Volume 挂进 sandbox复制标题链接

创建 sandbox 时在 volumeMounts 里指定 Volume。一个 sandbox 最多挂载一个独立 Volume。

volumeMounts 指向失败的 Volume 时，创建返回 409，消息带失败原因，见失败的 Volume。

失败的 Volume复制标题链接

失败的 Volume 怎样处理，取决于它是否可能还有数据：

下一次创建替换创建失败的 Volume 时：

• 新建成功返回 201。
• 容量仍不足返回 503，消息含 resource_exhausted。容量恢复后，同一个请求即返回 201。
• 其他原因失败按原因返回 409 或 502，消息带原因。

要重建扩容或删除失败的 Volume，先用 DELETE /volumes/{id} 删除它。

删除 Volume复制标题链接

DELETE /volumes/{id} 删除 Volume。删除 sandbox 会留下它的 Volume，不再需要的 Volume 要自己删除。

查询结果里的 Volume 挂载复制标题链接

GET /sandboxes/{id} 与列表接口返回的 volumeMounts 使用稳定的 Volume 名称和挂载路径。

• Volume 已被删除、处于非可用状态或映射不完整时，GET /sandboxes/{id} 返回 500，不会误报为 sandbox 不存在。
• 列表接口对同一种情况返回空的 volumeMounts 数组。
• SDK 的列表调用只保留 volumeMounts 这一个字段，其他字段需要通过 getInfo() 读取，见 sandbox 信息。

下一步复制标题链接

• Sandbox 与生命周期：暂停、恢复与到期时间。
• 命令与文件：把文件写进 Volume。
• Volume 与导出恢复：Workspace 的 Volume 怎样工作。