数据卷（Volume）是 Tencent Cloud Agent Runtime 提供的存储资源实例。本文介绍数据卷的参数构成、创建方式、更新与删除规则、使用限制及相关操作入口。
能力概述
数据卷用于为沙箱提供持久化存储。您可以直接创建独立数据卷，也可以由沙箱工具通过存储模板派生数据卷，并将数据卷挂载到沙箱工具或沙箱实例。
适用场景
需要为沙箱工具或沙箱实例挂载持久化存储时。
需要将已有的 COS 存储桶或 CFS 文件系统挂载到沙箱中复用时。
工作方式
数据卷可挂载到沙箱工具或沙箱实例，为沙箱提供持久化存储。
数据卷后端支持 COS 或 CFS 两种存储类型。
数据卷有两种来源：独立创建，或由存储模板派生。
数据卷参数
参数 | 说明 |
名称 VolumeName | 数据卷名称，账号内唯一，最长 128 个字符；必须以小写字母或数字开头，且只能包含小写字母、数字、连字符（-）和下划线（_）。 |
存储类型 StorageType | 后端类型，支持 COS 或 CFS。 |
存储 Storage | 必填。 Storage.Cos 与 Storage.Cfs 二选一，且需与 StorageType 匹配。 |
访问模式 AccessMode | ReadWriteOnce、ReadWriteMany 或 ReadOnlyMany。 |
挂载实例 MountedInstanceID | 只读字段，读写一次（ReadWriteOnce）数据卷挂载的实例 ID。 |
创建独立数据卷时不能指定回收策略，独立数据卷的回收策略默认为
Retain；派生数据卷的回收策略由存储模板定义并固定。生命周期
创建数据卷
数据卷可以通过以下两种来源创建：
直接创建：在控制台填写完整配置创建独立数据卷。
模板派生：沙箱工具通过
StorageMounts 引用存储模板后，沙箱实例启动阶段系统按模板与复用键解析或创建数据卷。创建或派生完成后，可在数据卷列表中查看数据卷状态。
方式一：添加 COS 数据卷
创建 COS 数据卷时：
将
StorageType 设置为 Cos。在
Storage.Cos 中填写以下必填字段：Endpoint：COS 服务地址。BucketName：存储桶名称。BucketPath：实际存储路径。其余参数按数据卷参数表配置。
方式二：添加 CFS 数据卷
创建 CFS 数据卷时：
将
StorageType 设置为 Cfs。在
Storage.Cfs 中填写以下必填字段：FileSystemId：文件系统 ID，必须以 cfs- 开头。Path：实际存储路径。其余参数按数据卷参数表配置。
更新数据卷
独立数据卷创建后仅支持更新标签
Tags；名称、存储类型、实际存储路径和访问模式不支持修改。派生数据卷不可更新，其标签由存储模板投影。
删除与回收数据卷
手动删除：可删除数据卷；仍被沙箱实例挂载的读写一次（ReadWriteOnce）数据卷不可删除。独立数据卷的回收策略默认为
Retain。自动回收：由存储模板派生、访问模式为读写一次（ReadWriteOnce）且回收策略为
Delete 的数据卷，随沙箱终止自动删除；自动回收只移除数据卷资源本身，不删除 COS 或 CFS 中的实际数据。使用限制
当前仅支持 COS 与 CFS；其他存储类型暂不支持。
独立数据卷创建时不能指定回收策略，回收策略默认为
Retain；派生数据卷的回收策略由存储模板固定。独立数据卷仅支持更新
Tags，派生数据卷不可更新。仍被沙箱实例挂载的读写一次（ReadWriteOnce）数据卷不可删除。
创建数据卷时会校验配额，配额不足时创建失败。
相关操作
控制台
存储菜单中的“数据卷”入口支持列表、详情、创建（仅独立数据卷）、更新和删除，并可查看派生数据卷列表。
