All Products
Search
Document Center

ApsaraDB for MongoDB:Set a maintenance window

Last Updated:Aug 13, 2026

To ensure the stability of ApsaraDB for MongoDB instances, Alibaba Cloud performs periodic maintenance. A maintenance window is a user-defined time period during which these maintenance operations can occur. We recommend that you schedule the maintenance window during off-peak hours to minimize potential impact on your services.

Precautions

  • Before maintenance begins, Alibaba Cloud sends SMS and email notifications to the contacts associated with your Alibaba Cloud account. Please check for these notifications.

  • On the day of maintenance, the instance status changes to Maintaining Instance within the specified maintenance window to ensure a stable process. While the instance is in this state, normal data access and query operations, such as performance monitoring, are not affected. However, in the ApsaraDB for MongoDB console, most management operations that modify the instance, such as upgrades, downgrades, and restarts, are temporarily unavailable. The only available operations are account management, database management, and adding IP addresses to the whitelist.

  • During the maintenance window, one or two transient disconnections may occur. Ensure that your application has an automatic reconnection mechanism. The instance returns to a normal state immediately after these interruptions.

  • If you run a task that requires an instance restart, such as a configuration change, a version upgrade, or an SSL certificate update, outside the configured maintenance window, the task enters a waiting state. This is expected behavior. In the console, the task may show a loading spinner, a status of Paused, or Updating SSL. While the task is waiting, the instance remains available for normal reads and writes, so your workloads are not affected. However, some change operations are temporarily blocked until the task completes, including releasing the instance, unsubscribing from the instance, and submitting another configuration change. If you cannot release or unsubscribe from the instance, or if a configuration change stays pending, check whether a task is waiting for the maintenance window before you try to forcibly terminate it. When the configured maintenance window starts, the system automatically resumes the task and completes the switchover or update. No manual intervention is required. If you want the task to run immediately instead of waiting, follow the procedure in this topic to temporarily change the maintenance window to the nearest period after the current time.

Procedure

  1. Log on to the ApsaraDB for MongoDB console.

  2. In the navigation pane on the left, click Replica Set Instances or Sharded Cluster Instances, depending on the instance type.

  3. In the upper-left corner of the page, select the resource group and region where the instance is located.

  4. Find the target instance and click its ID, or click Manage in the Actions column.

  5. In the Specification Information section, click Edit next to Maintenance Window.

  6. From the drop-down list, select a maintenance window for the instance.

    Note

    The maintenance window is displayed in your local time zone.

  7. Click OK.