客户云桌面显示快照为空，os也是，但是cas显示有

一、先理清两个平台权限与快照边界
CAS 平台（CVM）：底层虚拟化层
CAS 看到快照 = 存储 qcow2 磁盘快照真实存在，属于底层虚拟化快照；
但是！直接在 CAS 界面给云桌面虚拟机创建的快照，Workspace 云桌面管理界面无法识别、不会同步展示。
Workspace（CloudOS 云桌面平台）：上层业务管控层
Workspace 只识别通过 Workspace 自身界面创建的快照；
在 CAS 后台直接创建 / 删除虚拟机快照，上下层元数据不同步 → Workspace 页面快照列表为空。
规范操作要求：云桌面虚拟机的快照统一在 Workspace 界面操作，禁止直接登录 CAS 给云桌面虚拟机打快照。
二、现象根因总结
CAS 有快照，Workspace 显示快照为空
上下两层快照元数据隔离、不同步。CAS 底层快照不受 Workspace 管控，上层业务平台无法读取。
三、处理方案（按优先级）
规范方式（推荐）
① 先在 CAS 后台确认快照可用；
② 关机云桌面虚拟机；
③ 如果需要使用这份快照恢复：只能在 CAS 层面直接恢复虚拟机磁盘；
⚠️ 恢复完成后，Workspace 上层无快照记录，后续不要再在 CAS 操作快照。
消除数据不一致（治本）
不建议长期 CAS/Workspace 交叉操作快照。
后续所有云桌面快照：仅在 Workspace 界面创建、删除。
临时同步没有一键刷新按钮，底层 CAS 手工快照无法自动同步到 Workspace。
四、第二个问题：OS 模板创建快照，一直提示【快照名称不规范】
1、命名强制规范（Workspace/CloudOS 统一规则）
快照名称约束：
只能包含：英文大小写字母、数字、下划线_、短横线 -
❌ 禁止：中文、空格、顿号、斜杠、括号、特殊符号！
部分版本强制不能以数字开头，长度有区间限制。
2、快速自测
错误示例：桌面模板 2026.07备份（中文 + 空格 + 点号，直接拦截）
正确示例：os_template_20260724
3、额外踩坑点
1）名称首尾不要使用- _；
2）不要带任何中文；
3）复制粘贴名称容易带入隐藏不可见字符，建议手动输入；
4）OS 模板必须处于关机状态才能正常创建快照。
五、排查顺序（现场操作清单）
区分操作入口：
日常云桌面运维快照管理优先登录 Workspace 云桌面平台操作；CAS 仅应急故障恢复使用，禁止日常打快照。
针对 “快照为空”：
确认历史快照是管理员在 CAS 页面创建 → 属于跨平台操作，上层无法展示，属于产品机制，不是 bug。
针对 “名称不规范”：
清空输入框，纯英文 + 数字 + 下划线手动输入名称测试，规避中文、空格、特殊字符。

这种情况，问题很可能出在上层云管理平台（CloudOS/Workspace）与底层虚拟化平台（CAS）之间的数据同步出现了故障。

🔍 问题根源分析

这通常是因为在CAS（底层虚拟化平台）上直接操作了虚拟机（如创建、删除快照等），而CloudOS（上层云管理平台）未能同步感知这些变化。

• 数据不一致：CloudOS有自己的数据库来记录虚拟机信息。当你在CAS上操作时，CAS的数据库更新了，但CloudOS的数据库没有变，导致两边“各说各话”。

• 快照机制差异：H3Cloud OS创建快照时，会先让CAS生成一个“外部快照”再上传。如果这个过程中断（如存储空间不足），就可能产生一个在CAS上“看得见”、但在CloudOS上“用不了”的“孤儿”快照。

🛠️ 排查与解决步骤

可以按照从易到难的顺序，尝试以下步骤：

第一步：在CloudOS上手动同步（最推荐）

这是解决问题最直接、风险最低的方法。

1. UI界面同步：登录CloudOS或Workspace管理界面，找到对应的虚拟机，查看是否有 “同步状态” 或 “刷新” 的按钮，点击尝试手动同步。

2. 命令行同步：如果界面没有同步按钮，可以尝试在CloudOS后台执行同步命令：

   bash

   /opt/cloudos/backend/cloudos/utils/sync_tool.py --sync vms

第二步：检查同步服务与对接配置

如果手动同步无效，需要检查底层服务是否正常。

1. 检查服务状态：在CloudOS管理节点执行以下命令，确保同步服务正常运行：

   bash

   systemctl status hcm-service systemctl status cloudos-syncservice

2. 检查CAS对接配置：登录CloudOS管理界面，进入 “基础设施” -> “虚拟化资源”，检查CAS平台的对接状态、地址、端口及凭据是否正确。尤其要确认对接CAS的账户密码没有过期或被修改。

第三步：排查存储空间

CAS在创建快照时，需要临时缓存空间。如果存储空间不足，会导致快照创建失败。

• 登录CAS后台，检查虚拟机的存储路径（如 /vms/tmp）是否被占满。

• 如果空间不足，可以尝试清理无用文件或扩容该目录。

第四步：检查快照命名规范

你提到“快照名不规范”的提示，可以尝试以下方法：

• 使用纯英文和数字：避免使用特殊字符、空格或中文。

• 名称要简短：过长的名称也可能导致校验失败。