Knowledge BaseTroubleshootingZSphere migration fails API connectivity validation when adding the target environment

ZSphere migration fails API connectivity validation when adding the target environment

TroubleshootingZVF · ZMigrateVersions4.x / 5.xArticle IDKB-200035Updated2026-09-16

Issue/Introduction

This article helps troubleshoot failures in API connectivity validation when adding a target environment for ZSphere migration.

Symptoms

  • A ZMigrate synchronization task fails the connectivity test after the target ZSphere environment is added.
  • The page reports that the target environment API connection cannot be verified and indicates that the target environment address, account, port, and management service status must be checked.

Environment

  • Product: ZVF
  • Version: 4.x, 5.x
  • Component: ZMigrate
  • Affected object: ZMigrate
  • Scenario: For migration and cloning issues, confirm the current version, deployment type, storage type, and operation timeline.

Possible causes

Sign in to view the rest of this article, plus more troubleshooting and solution know-how.

ZSphere migration fails API connectivity validation when adding the target environment | KB-200035 | ZStack Resource Center