All Products
Search

This Product

    :Migrate local disk instances to cloud disk

    Document Center

    :Migrate local disk instances to cloud disk

    Last Updated:Jul 23, 2026

    ApsaraDB for MongoDB supports migrating local disk instances to cloud disk instances. After migration, the instance runs on the cloud disk architecture, benefiting from elastic storage and snapshot backup capabilities.

    Prerequisites

    • The instance architecture is a replica set.

    • The instance currently uses the local disk architecture (physical machine).

    • The instance major version is 4.2, and the minor version is 4.0.37 or later.

    • The instance is in the Running state.

    • The instance is not locked.

    • The instance uses pay-as-you-go billing. Subscription instances must be converted to pay-as-you-go first.

    • This feature is available through an allowlist. Submit a ticket to apply for access.

    Notes

    • Cross-architecture migration is a one-way operation. You cannot migrate from cloud disk back to local disk.

    • During migration, the instance remains accessible during the data synchronization phase. During the switchover phase, there will be 1 to 2 brief disconnections, each lasting less than 1 minute. Ensure your application has high-availability connection strings and retry mechanisms. We recommend performing the switchover during off-peak hours.

    • After migration, the backup policy automatically switches to cloud disk snapshot backup. Previous full physical backups and logs will be cleared, and you cannot restore to a point before migration. To retain historical backups, use the Download backup files feature to save backups locally before migration.

    • Migration does not change the instance connection address, port, account, or other configured information.

    • Cross-architecture migration is not supported for instances with TDE encryption, SSL certificates, or multi-AZ deployments. Multi-AZ instances must migrate to single-AZ instances.

    • Two switchover modes are supported: Immediate switchover and Maintenance window switchover.

    Billing

    For billing details, see Configuration change fees.

    Procedure

    1. Go to the Replica Set Instances page. In the top navigation bar, select the resource group and region to which the desired instance belongs. Then, find the instance and click the instance ID.

    2. In the Instance Information section, click Cross-Architecture Migration.

    3. In the Cross-architecture Migration dialog box, configure the following parameters:

      • Target Storage Type: Select the cloud disk storage type after migration. For disk sizing rules, see Change disk configuration.

      • Switchover Time:

        • Switch Immediately after Migration: The switchover is executed immediately after data synchronization completes.

        • Switch within Maintenance Window: The switchover is executed during the instance maintenance window.

    4. Click OK.

      During cross-architecture migration, the instance status changes from Migrating to Running. When the status changes to Running, the migration is complete.