一、能力概述
创建数据卷时,系统会将这些配置固化到数据卷中,避免为每个数据卷重复配置。存储模板名称在账号内唯一。
二、适用场景
当你需要多次创建具有相同存储类型、存储路径、访问模式和回收策略的数据卷时,可以先创建存储模板,再基于该模板创建数据卷,从而复用同一套存储配置。
三、工作方式
存储模板保存数据卷的存储配置配方。创建数据卷时,模板中的存储类型、存储路径、访问模式和回收策略被固化到数据卷中,存储配置展开为数据卷的实际存储配置。数据卷创建后,修改存储模板不会追溯覆盖已派生的数据卷。
派生数据卷的名称由存储模板名称和数据卷名称模板共同生成,模板名始终作为名称前缀,具体规则见“配置说明”中的“数据卷名称模板”。
四、存储模板参数
| 参数 | 说明 |
| 名称 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} 变量(可重复出现);禁止控制字符、反斜杠(\\)、重复斜杠、尾部斜杠(根路径除外)、空分段、. 和 .. 分段。
十一、控制台
在控制台的 存储 中,可通过“存储模板”入口对存储模板进行列表、详情、创建、更新和删除操作;列表页会轮询 CREATING 和 DELETING 中间态。