Edit

Share via

Restore a cluster in Azure Cosmos DB for MongoDB vCore

  • Article

APPLIES TO: MongoDB vCore

Azure Cosmos DB for MongoDB vCore provides automatic backups that enable point-in-time recovery (PITR) without any action required from users. Backups allow customers to restore a server to any point in time within the retention period.

Note

The backup and restore feature is designed to protect against data loss, but it doesn't provide a complete disaster recovery solution. You should ensure that you already have your own disaster recovery plan in place to protect against larger scale outages.

Prerequisites

Backups

Backups are performed automatically in the background. Backups are retained for 35 days for active clusters and 7 days for deleted clusters. All backups are encrypted using AES 256-bit encryption.

Note

Backup files can't be exported. They may only be used for restore operations in Azure Cosmos DB for MongoDB vCore.

In Azure regions that support availability zones, backup snapshots are stored in three availability zones. As long as at least one availability zone is online, the cluster is restorable.

Restore from a backup

Important

Restore in Azure Cosmos DB for MongoDB vCore is currently in preview. This preview version is provided without a service level agreement (SLA), and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities.

To enable restore functionality preview in the Azure portal for a subscription, follow these steps:

  1. Open Preview features in Azure portal.
  2. Make sure that Azure subscription with your Azure Cosmos DB for MongoDB vCore cluster is selected in the Subscription list.
  3. Search for Azure Cosmos DB for MongoDB vCore previews by typing MongoDB vCore in the search box.
  4. Select Azure Cosmos DB for MongoDB vCore Point-In-Time Database Restore in the list of previews.
  5. Select Register.

The restore process creates a new cluster with the same configuration in the same Azure region, subscription, and resource group as the original. Follow these steps to restore data.

  1. Select an existing Azure Cosmos DB for MongoDB vCore cluster in the subscription where the restore preview is enabled.
  2. On the cluster sidebar, under Settings, select Point In Time Restore.
  3. Select a date and provide a time (in UTC time zone) in the date and time fields.
  4. Enter a cluster name in the Restore target cluster name field.
  5. Enter a cluster admin name for the restored cluster in the Admin user name field.
  6. Enter a password for the admin role in the Password and Confirm password fields.
  7. Select Submit to initiate cluster restore.

Note

Cluster backups are stored for 35 days. If your cluster was created 35 days or more ago and you don't see the desired date in the restore date field, you might need to open a support request to restore the cluster to that point.

To create an Azure support request, follow these steps:

  1. Select an existing Azure Cosmos DB for MongoDB vCore cluster that you need to restore.
  2. On the cluster sidebar, under Help, select Support + Troubleshooting. For more information, see create an Azure support request.

Next steps

In this guide, we covered the backup and restore features for Azure Cosmos DB for MongoDB vCore.

Review cross-region replication capabilities in Azure Cosmos DB for MongoDB vCore