> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建和使用存储卷

> 购买存储配额后，创建 Volume，并将存储卷挂载到开发环境、训练任务或推理服务中使用。

存储资源 Volume 是人工智能平台中的持久化存储卷。您可以将 Volume 挂载到开发环境、训练任务和推理服务中，用于保存代码、数据、模型文件、训练输出和服务依赖文件。

使用存储资源通常分为三步：先在订单中购买存储配额，再在存储资源中创建具体的 Volume，最后将 Volume 授权并挂载到工作负载中使用。

## 存储配额与 Volume 关系

存储配额和 Volume 是两个不同对象：

| 对象     | 说明                                   |
| ------ | ------------------------------------ |
| 存储配额   | 通过订单购买或续费的可用存储容量。                    |
| Volume | 在存储配额范围内创建的具体存储卷，可挂载到开发环境、训练任务或推理服务。 |

购买的是存储配额。使用前还需要在存储资源中创建具体 Volume，否则工作负载无法挂载使用。

进入 **所用资源 > 存储资源** 后，可以通过页面上方的配额、容量和使用率图表判断当前存储水位：

| 目标           | 关注信息                                 |
| ------------ | ------------------------------------ |
| 判断是否还有可用配额   | 查看存储配额的已用和可用情况。                      |
| 识别容量分布       | 查看各 Volume 的容量占比，判断容量是否集中在少数 Volume。 |
| 排查高占用 Volume | 查看使用率较高的 Volume，必要时调整容量、清理数据或迁移数据。   |

## 购买存储资源

存储资源需要先以配额形式购买。购买的是可用容量，使用前还需要创建具体 Volume。

购买前，请先关注以下信息：

| 项目     | 说明                   |
| ------ | -------------------- |
| 最小申购单位 | 1 Gi。                |
| 计费方式   | 按申购容量和使用天数计费。        |
| 配额用途   | 存储配额可用于创建或扩容 Volume。 |

1. 进入 **所用资源 > 订单**。
2. 选择 **存储资源** 页签，单击 **购买**。
3. 配置购买容量和时长。
4. 提交购买。
5. 返回订单列表，确认订单状态变为 `active`。
6. 回到 **所用资源 > 存储资源**，确认存储配额已经增加。

如果可用存储配额不足，请先购买或续费存储资源，或者删除不再使用的 Volume 释放配额。更多信息，请参考[查看和续费资源订单](./manage-resource-orders)。

## 创建 Volume

创建 Volume 后，开发环境、训练任务和推理服务才能挂载使用该存储卷。

创建前，请确认当前账号具有创建或管理存储卷的权限，并且当前区域和集群下有足够可用存储配额。

1. 进入 **所用资源 > 存储资源**。
2. 在 **配额管理** 页签，单击 **创建**。
3. 配置 Volume。

| 参数      | 说明                               |
| ------- | -------------------------------- |
| 区域      | Volume 所属区域。                     |
| 集群      | Volume 所属集群。                     |
| 名称      | Volume 名称，需在租户内唯一。               |
| 项目组     | Volume 所属项目组。                    |
| 在项目组内公开 | 控制 Volume 是否在所属项目组内公开。           |
| 目录级权限   | 控制是否启用按子目录授权和挂载鉴权。开启后，请继续配置目录权限。 |
| 资源管理员   | 指定负责管理该 Volume 的用户。              |
| 总容量     | Volume 容量，可选择容量单位。               |

4. 单击 **新建**。

创建完成后，当 Volume 状态变为 `Ready` 时，您可以在开发环境、训练任务或推理服务中挂载该 Volume。

## 查看 Volume 状态和用量

在 **所用资源 > 存储资源** 中，可以按名称和项目组筛选 Volume，并查看状态、文件系统类型、授权用户、资源管理员、总容量和已使用容量。

| 目标       | 关注信息                         |
| -------- | ---------------------------- |
| 确认是否可挂载  | 查看 Volume 状态是否为 `Ready`。     |
| 判断容量是否充足 | 对比总容量和已使用容量，结合使用率图表判断是否需要扩容。 |
| 确认访问范围   | 查看授权用户、资源管理员和项目组可见性。         |

如果 Volume 长时间不进入 `Ready` 状态，请确认订单和配额是否有效；如果仍未恢复，请联系平台管理员确认处理。

## 使用 Volume

如果 Volume 状态为 `Ready`，您可以在以下场景中挂载：

* 开发环境：用于保存代码、Notebook、依赖缓存和调试数据。
* 训练任务：用于读取训练数据、保存 checkpoint 和输出模型文件。
* 推理服务：用于挂载模型文件、配置文件或服务依赖文件。

挂载时需要选择 Volume，并指定容器内挂载路径。同一个 Volume 可以被多个开发环境、训练任务或推理服务复用。

如果 Volume 开启了目录级权限，请按可挂载目录选择子路径，而不是直接挂载整卷。

## 管理 Volume

已创建的 Volume 支持以下管理操作。不同账号权限、Volume 状态和项目组可见性下，可用操作可能不同。

* **调整**：修改项目组公开范围、目录级权限、资源管理员或总容量。调整总容量时，请确认当前可用存储配额充足。
* **批量调整容量**：对多个 Volume 批量调整容量。调整前，请确认这些 Volume 都需要相同的容量变更。
* **用户授权**：将 Volume 授权给租户内用户，并可为用户设置只读权限。未设置为只读的授权用户按读写权限使用。在私有模式下，如果为用户授权后需要平台生成底层资源，生效可能存在分钟级延迟。
* **用户默认配额**：通过页面右上角的 **用户默认配额** 入口，调整用户目录的默认配额。
* **调整项目组**：修改 Volume 所属项目组和可见性。
* **删除**：删除不再使用的 Volume，并释放占用的配额。删除会影响已挂载该 Volume 的开发环境、训练任务或推理服务；删除前，请确认不再需要其中的数据，并已完成备份或迁移。

## 配置目录级权限

当多个用户需要共享同一个大容量 Volume，但只能访问其中部分目录时，可以启用目录级权限。目录级权限支持公共目录、自定义子目录和用户目录，并可为不同用户设置只读或读写权限。

目录级权限会影响任务提交时的挂载鉴权。启用后，请在 **目录权限** 页签配置可挂载目录和授权用户。具体配置方式请参见[配置 Volume 目录级权限](./configure-volume-directory-permissions)。

## 相关文档

* [配置 Volume 目录级权限](./configure-volume-directory-permissions)
* [查看和续费资源订单](./manage-resource-orders)