问题说明
本文用于排查“ZSphere 备份创建的单个快照无法在 UI 快照组中删除”类问题。
现象
- UI 快照组页面看不到备份软件或 CLI 创建的单个卷快照。
- 存储容量或克隆任务显示仍存在卷快照，用户希望删除单个快照。
- 通过 CLI/API 能查询到 volume snapshot uuid，但 UI 无对应快照组。
适用环境
- 产品：ZVF
- 版本：4.10.x
- 组件：ZSphere
- 涉及对象：快照/备份
- 场景：快照与备份类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- 备份软件、迁移、克隆或 CLI 创建的是卷快照对象，不一定归属 UI 快照组视图。
- 快照仍被备份链、克隆链、镜像制作任务或回收/回滚链依赖。
- 快照组删除与单个卷快照删除属于不同对象层级，直接删除可能破坏备份链。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 先确认快照来源：UI 快照组、备份软件、迁移/克隆任务，还是 CLI/API 手工创建。
- 记录 volumeUuid、volumeSnapshotUuid、虚拟机 uuid、备份任务 ID 和创建时间。
- 使用只读查询确认该快照是否有 children、是否被备份任务或镜像制作任务引用。
- 若属于备份系统创建，优先通过备份系统完成删除和链路清理；若需 ZSphere CLI/API 删除，必须由 ZStack 官方技术支持确认 DeleteVolumeSnapshot 等受管接口可用性。
- 禁止在未确认依赖关系时直接从底层存储删除快照对象；生产处理前需备份数据库并申请变更窗口。
处理方法
- 由创建该快照的备份系统完成删除和快照链路清理。
- 需要通过 ZSphere CLI/API 删除时，先由 ZStack 官方技术支持确认受管接口和依赖关系，再执行删除操作。
验证方法
- 快照引用关系已清理，相关备份、克隆和镜像任务不受影响。
- UI、CLI/API 与底层存储的快照信息一致，容量占用恢复到预期状态。