# 概述
<subtitle>独立于沙箱存在、可挂载到多个沙箱的持久化存储。</subtitle>

> **内测说明**：Volume 目前处于内测阶段，默认不开放。如需体验，请联系我们的技术支持开通。

Volume 提供独立于沙箱生命周期的持久化存储。写入 Volume 的数据在沙箱关闭后依然保留，同一个 Volume 也可以先后挂载到不同的沙箱。

**多个沙箱共享同一个 Volume**

```mermaid
graph LR
  V1[Volume A] --- S1[沙箱 1]
  V1 --- S2[沙箱 2]
  V1 --- S3[沙箱 3]
```

**每个沙箱使用各自的 Volume**

```mermaid
graph LR
  V2[Volume A] --- S4[沙箱 1]
  V3[Volume B] --- S5[沙箱 2]
```

**不挂载沙箱，直接通过 SDK 访问**

```mermaid
graph LR
  SDK[SDK] --- V4[Volume A]
  SDK --- V5[Volume B]
```

Volume 挂载到沙箱后，可以直接在挂载路径下读写文件。SDK 提供的 Volume 文件操作方法适用于 Volume 未挂载到任何沙箱的场景。

使用 UCloud Sandbox SDK，您可以：
- [管理 Volume。](/docs/agent-sandbox/storage/volume/manage.md)
- [将 Volume 挂载到沙箱。](/docs/agent-sandbox/storage/volume/mount.md)
- [读写 Volume 中的文件。](/docs/agent-sandbox/storage/volume/read-write.md)
- [获取文件或目录信息。](/docs/agent-sandbox/storage/volume/info.md)
- [上传数据到 Volume。](/docs/agent-sandbox/storage/volume/upload.md)
- [从 Volume 下载数据。](/docs/agent-sandbox/storage/volume/download.md)
- [在 Volume 之间迁移数据。](/docs/agent-sandbox/storage/volume/migrate.md)

## 基本用法

```python
from ucloud_sandbox import Volume, Sandbox

volume = Volume.create('my-volume')

sandbox = Sandbox.create(
    volume_mounts={
        '/mnt/my-data': volume,
    },
)
```