Edit

Restore Azure Cosmos DB account by using Azure portal

This article describes how to restore an Azure Cosmos DB account backed up by using Azure portal.

You can restore to a target Azure Cosmos DB account in the same region as the Backup vault, or to the Azure paired secondary region by using Cross Region Restore.

Prerequisites

Before you restore from Azure Cosmos DB backups by using Azure portal, ensure that you meet the following prerequisites:

  • Check the supported scenarios and known limitations.
  • Review the access permission if present to assign Cosmos DB Long Term Retention Restore Role on the target Cosmos DB account to the Backup Vault for the restore operation.
  • To restore to a secondary region, ensure that the Backup vault uses geo-redundant storage (GRS) and that Cross Region Restore is enabled on the vault.
  • For cross region restore, Backup vault's managed identity must have the required permissions on the target Azure Cosmos DB account in the secondary region.

Restore Azure Cosmos DB account

To restore Azure Cosmos DB account, follow these steps:

  1. Go to Resiliency, and then select Overview > Recover.

    Alternatively, to restore backup from the Backup vault pane, go to the Backup vault > Overview, and select Restore.

  2. On the Recover pane, select Resource managed by as Azure, Datasource type as Azure Cosmos DB, and Solution as Azure Backup.

  3. Select the protected item for which you want to restore the backup, and then select Continue.

  4. On the Basics pane, select restore region as Primary region.

    Screenshot shows the primary region selection.

    Note

    Select restore region as Secondary region, to restore backup to the Azure paired region. For more information, see Restore Azure Cosmos DB account to a secondary region.

  5. On the Restore pane, on the Restore point tab, select Select restore point and choose the restore point you want to restore.

    The latest restore point is pre-populated.

    Screenshot shows the restore point selection.

    Note

    When you select an incremental recovery point, Azure Backup automatically restores the full backup chain - the parent full backup and every incremental backup up to the point you select. Azure Backup verifies that all dependent recovery points are present before the restore begins. Restores from an incremental recovery point can take longer than restores from a full backup because the chain is reconstructed.

  6. On the Restore parameters tab, for Restore configuration, choose the target Azure Cosmos DB account details by selecting Select.

    Screenshot shows the restore parameters selection.

  7. Select the subscription and resource group and then choose the target Azure Cosmos DB account.

    Screenshot shows the selected restore parameters.

  8. To check the restore parameters permissions before the final review and restore, select Validate. After validation is successful, select Review + restore.

  9. On the Review + restore tab, select Restore to restore the selected Azure Cosmos DB account backup in a target Azure Cosmos DB account.

You can track the restore job under Backup and recovery > Jobs.

Restore Azure Cosmos DB account to a secondary region

Use Cross Region Restore to restore vaulted backups of an Azure Cosmos DB account to the Azure paired region.

To restore an Azure Cosmos DB account to the secondary region, follow these steps:

  1. Go to Resiliency, and then select Overview > Recover.

  2. Select Datasource type as Azure Cosmos DB, and select the protected item that you want to restore.

  3. On the Basics pane, select Restore to secondary region.

    Screenshot shows the secondary region selection.

  4. On the Restore point tab, select the restore point. You see only recovery points that are available in the secondary region.

    Screenshot shows the restore points in secondary region.

    Note

    Recovery points replicate asynchronously to the secondary region. A recovery point can take up to 12 hours after it's created in the primary region to become available in the secondary region.

  5. On the Restore parameters tab, select the subscription, resource group, and target Azure Cosmos DB account in the secondary region.

    Note

    The deployment region and the primary write region of the target Azure Cosmos DB account must be same as the secondary region of the Backup vault.

  6. Select Validate to check the permissions, and then select Review + restore.

  7. On the Review + restore tab, select Restore.

To monitor the restore, go to Backup and recovery > Jobs, and filter Datasource type to Azure Cosmos DB.

Next steps

Manage vaulted backup of Azure Cosmos DB account by using Azure portal.

  • Last updated on