问题说明
本文用于排查“ZSphere 迁移添加目标云平台 API 连通性校验失败”类问题。
现象
- ZMigrate 创建同步任务，执行到添加目标端 ZSphere 云平台后测试连通失败。
- 页面提示无法验证云平台 API 连接，需检查目标平台地址、账号、端口和管理服务状态。
适用环境
- 产品：ZVF
- 版本：4.x, 5.x
- 组件：ZMigrate
- 涉及对象：ZMigrate
- 场景：迁移与克隆类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- ZMigrate 管理服务到 ZSphere 管理节点 API 端口不通或地址填写不一致。
- 目标平台账号、权限、证书、端口或反向代理配置异常。
- 迁移管理服务自身状态异常，导致连接测试未实际发起或超时。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 确认 ZSphere 管理地址、协议、端口、账号和密码是否与当前 UI 登录入口一致。
- 在 ZMigrate 节点上验证到 ZSphere 管理节点的网络连通性和 API 端口可达性。
- 检查 ZMigrate 管理服务和 ZSphere 管理服务状态，记录失败时间点对应日志。
- 若使用 HTTPS 或非默认端口，确认迁移工具侧是否已同步更新端口和证书信任配置。
处理方法
- 修正迁移工具中配置的 ZSphere 管理地址、协议、端口或账号信息，使其与实际管理入口一致。
- 对 HTTPS 或非默认端口场景，补齐证书信任和网络访问策略后重新执行连通性校验。
验证方法
- 迁移工具可以成功验证目标云平台 API 连通性。
- 可以创建迁移任务并正常加载目标端资源。