能力概述
存储模板（VolumeTemplate）是可复用的存储配置模板，本身不直接占用存储资源。创建存储模板时，您可以定义数据卷的存储类型、存储路径、访问模式和回收策略。
创建数据卷时，系统会将这些配置固化到数据卷中，避免为每个数据卷重复配置。存储模板名称在账号内唯一。
适用场景
当您需要多次创建具有相同存储类型、存储路径、访问模式和回收策略的数据卷时，可以先创建存储模板，再基于该模板创建数据卷，从而复用同一套存储配置。
工作方式
存储模板保存数据卷的存储配置配方。创建数据卷时，模板中的存储类型、存储路径、访问模式和回收策略被固化到数据卷中，存储配置展开为数据卷的实际存储配置。数据卷创建后，修改存储模板不会追溯覆盖已派生的数据卷。
派生数据卷的名称由存储模板名称和数据卷名称模板共同生成，模板名始终作为名称前缀，具体规则见“配置说明”中的“数据卷名称模板”。
配置说明
存储模板参数
参数 | 说明 |
名称 VolumeTemplateName | 存储模板名称，账号内唯一，最长 128 个字符；必须以小写字母或数字开头，且只能包含小写字母、数字、连字符（-）和下划线（_）。 |
存储类型 StorageType | 后端类型，支持 Cos 或 Cfs。 |
存储配置 StorageSpec | 必填。 StorageSpec.Cos 与 StorageSpec.Cfs 二选一，且需与 StorageType 匹配。 |
数据卷名称模板 VolumeNamePattern | 可选，最长 256 个字符；生成派生数据卷名称，仅支持 ${reuse_key} 占位符且至多出现一次；替换后生成的名称仍须以小写字母或数字开头，且只能包含小写字母、数字、连字符（-）和下划线（_）。 |
访问模式 AccessMode | ReadWriteOnce、ReadWriteMany 或 ReadOnlyMany。 |
回收策略 ReclaimPolicy | Retain 或 Delete。 |
容量 DefaultCapacity | 可选，预留字段，当前 COS 与 CFS 后端下不生效。 |
创建 COS 存储模板
创建 COS 存储模板时：
1. 将
StorageType 设置为 Cos。2. 在
StorageSpec.Cos 中填写必填字段：Endpoint：COS 服务地址。BucketName：存储桶名称。BucketPathPattern：路径模式，可包含 ${reuse_key}。3. 其余参数按存储模板参数表配置。
创建 CFS 存储模板
创建 CFS 存储模板时：
1. 将
StorageType 设置为 Cfs。2. 在
StorageSpec.Cfs 中填写必填字段：FileSystemId：文件系统 ID，必须以 cfs- 开头。PathPattern：路径模式，可包含 ${reuse_key}。3. 其余参数按存储模板参数表配置。
创建 CFS 存储模板时，系统会校验文件系统是否存在且至少有一个挂载点。
生命周期
存储模板状态
存储模板可能处于以下状态：
状态 | 说明 |
CREATING | 创建中 |
ACTIVE | 创建完成，可用 |
DELETING | 删除中 |
FAILED | 创建失败 |
创建存储模板后，其状态可能先显示为
CREATING，随后变为 ACTIVE；若创建失败，状态变为 FAILED。控制台会对 CREATING 和 DELETING 中间态进行轮询。更新存储模板
存储模板创建后，仅支持更新标签
Tags 和容量字段 DefaultCapacity；存储类型、存储路径、名称模板、访问模式和回收策略不支持修改。更新时，通过存储模板 ID（VolumeTemplateId）或存储模板名称（VolumeTemplateName）定位目标模板，二者二选一。删除存储模板
存储模板可以手动删除。删除前，如果存在由该模板派生的活跃数据卷，系统会拒绝删除并提示先删除派生数据卷。
使用限制
存储类型当前仅支持 COS 与 CFS；其他存储类型暂不支持。
存储模板名称在账号内唯一；删除存储模板后，该名称可被再次使用。
存储路径模式最长 512 个字符；仅支持
${reuse_key} 变量（可重复出现）；禁止控制字符、反斜杠（\\）、重复斜杠、尾部斜杠（根路径除外）、空分段、. 和 .. 分段。
