Delete an Azure Backup Recovery Services vault

This article describes how to delete an Azure Backup Recovery Services vault. It contains instructions for removing dependencies and then deleting a vault.

Before you start

You can't delete a Recovery Services vault with any of the following dependencies:

  • You can't delete a vault that contains protected data sources (for example, IaaS VMs, SQL databases, Azure file shares, etc.)
  • You can't delete a vault that contains backup data. Once backup data is deleted, it will go into the soft deleted state.
  • You can't delete a vault that contains backup data in the soft deleted state.
  • You can't delete a vault that has registered storage accounts.

If you try to delete the vault without removing the dependencies, you'll encounter one of the following error messages:

  • Vault cannot be deleted as there are existing resources within the vault. Please ensure there are no backup items, protected servers, or backup management servers associated with this vault. Unregister the following containers associated with this vault before proceeding for deletion.

  • Recovery Services vault cannot be deleted as there are backup items in soft deleted state in the vault. The soft deleted items are permanently deleted after 14 days of delete operation. Please try vault deletion after the backup items are permanently deleted and there is no item in soft deleted state left in the vault. For more information, see Soft delete for Azure Backup.

Proper way to delete a vault

Warning

The following operation is destructive and can't be undone. All backup data and backup items associated with the protected server will be permanently deleted. Proceed with caution.

To properly delete a vault, you must follow the steps in this order:

  • Step 1: Disable the soft delete feature. See here for the steps to disable soft delete.

  • Step 2: After disabling soft delete, check if there are any items previously remaining in the soft deleted state. If there are items in soft deleted state, then you need to undelete and delete them again. Follow these steps to find soft delete items and permanently delete them.

  • Step 3: You must check all of the following three places to verify if there are any protected items:

    • Cloud protected items: Go to the vault dashboard menu > Backup Items. All items listed here must be removed with Stop Backup or Delete Backup Data along with their backup data. Follow these steps to remove those items.
    • MARS protected servers: Go to the vault dashboard menu > Backup Infrastructure > Protected Servers. If you have MARS protected servers, then all items listed here must be deleted along with their backup data. Follow these steps to delete MARS protected servers.
    • MABS or DPM management servers: Go to the vault dashboard menu > Backup Infrastructure > Backup Management Servers. If you have DPM or Azure Backup Server (MABS), then all items listed here must be deleted or unregistered along with their backup data. Follow these steps to delete the management servers.
  • Step 4: You must ensure all registered storage accounts are deleted. Go to the vault dashboard menu > Backup Infrastructure > Storage Accounts. If you have storage accounts listed here, then you must unregister all of them. To learn how to unregister the account, see Unregister a storage account.

After you've completed these steps, you can continue to delete the vault.

If you don't have any protected items on-premises or cloud, but are still getting the vault deletion error, perform the steps in Delete the Recovery Services vault by using Azure Resource Manager

Delete protected items in the cloud

First, read the Before you start section to understand the dependencies and vault deletion process.

To stop protection and delete the backup data, perform the following steps:

  1. From the portal, go to Recovery Services vault, and then go to Backup items. Then, choose the protected items in the cloud (for example, Azure Virtual Machines, Azure Storage [the Azure Files service], or SQL Server on Azure Virtual Machines).

    Select the backup type.

  2. Right-click to select the backup item. Depending on whether the backup item is protected or not, the menu displays either the Stop Backup pane or the Delete Backup Data pane.

    • If the Stop Backup pane appears, select Delete Backup Data from the drop-down menu. Enter the name of the backup item (this field is case-sensitive), and then select a reason from the drop-down menu. Enter your comments, if you have any. Then, select Stop backup.

      The Stop Backup pane.

    • If the Delete Backup Data pane appears, enter the name of the backup item (this field is case-sensitive), and then select a reason from the drop-down menu. Enter your comments, if you have any. Then, select Delete.

      The Delete Backup Data pane.

  3. Check the Notification icon: The Notification icon. After the process finishes, the service displays the following message: Stopping backup and deleting backup data for "Backup Item". Successfully completed the operation.

  4. Select Refresh on the Backup Items menu, to make sure the backup item was deleted.

    The Delete Backup Items page.

Delete protected items on premises

First, read the Before you start section to understand the dependencies and vault deletion process.

  1. From the vault dashboard menu, select Backup Infrastructure.

  2. Depending on your on-premises scenario, choose the one of the following options:

    • For MARS, select Protected Servers and then Azure Backup Agent. Then, select the server that you want to delete.

      For MARS, select your vault to open its dashboard.

    • For MABS or DPM, select Backup Management Servers. Then, select the server that you want to delete.

      For MABS or DPM, select your vault to open its dashboard.

  3. The Delete pane appears with a warning message.

    The delete pane.

    Review the warning message and the instructions in the consent check box.

    Note

    • If the protected server is synced with Azure services and backup items exist, the consent check box will display the number of dependent backup items and the link to view the backup items.
    • If the protected server is not synced with Azure services and backup items exist, the consent check box will display only the number of backup items.
    • If there are no backup items, the consent check box will ask for deletion.
  4. Select the consent check box, and then select Delete.

  5. Check the Notification icon delete backup data. After the operation finishes, the service displays the message: Stopping backup and deleting backup data for "Backup Item." Successfully completed the operation.

  6. Select Refresh on the Backup Items menu, to make sure the backup item is deleted.

Note

If you delete an on-premises protected item from a portal that contains dependencies, you'll receive a warning saying "Deleting server's registration is a destructive operation and cannot be undone. All backup data (recovery points required to restore the data) and Backup items associated with protected server will be permanently deleted."

After this process finishes, you can delete the backup items from management console:

Delete backup items from the MARS management console

Note

If you deleted or lost the source machine without stopping the backup, the next scheduled backup will fail. The old recovery point expires according to the policy, but the last single recovery point is always retained until you stop the backup and delete the data. You can do this by following the steps in this section.

  1. Open the MARS management console, go to the Actions pane, and select Schedule Backup.

  2. From the Modify or Stop a Scheduled Backup page, select Stop using this backup schedule and delete all the stored backups. Then, select Next.

    Modify or stop a scheduled backup.

  3. From the Stop a Scheduled Backup page, select Finish.

    Stop a scheduled backup.

  4. You are prompted to enter a security PIN (personal identification number), which you must generate manually. To do this, first sign in to the Azure portal.

  5. Go to Recovery Services vault > Settings > Properties.

  6. Under Security PIN, select Generate. Copy this PIN. The PIN is valid for only five minutes.

  7. In the management console, paste the PIN, and then select OK.

    Generate a security PIN.

  8. In the Modify Backup Progress page, the following message appears: Deleted backup data will be retained for 14 days. After that time, backup data will be permanently deleted.

    Delete the backup infrastructure.

After you delete the on-premises backup items, follow the next steps from the portal.

Delete backup items from the MABS or DPM management console

Note

If you deleted or lost the source machine without stopping the backup, the next scheduled backup will fail. The old recovery point expires according to the policy, but the last single recovery point is always retained until you stop the backup and delete the data. You can do this by following the steps in this section.

There are two methods you can use to delete backup items from the MABS or DPM management console.

Method 1

To stop protection and delete backup data, do the following steps:

  1. Open the DPM Administrator Console, and then select Protection on the navigation bar.

  2. In the display pane, select the protection group member that you want to remove. Right-click to select the Stop Protection of Group Members option.

  3. From the Stop Protection dialog box, select Delete protected data, and then select the Delete storage online check box. Then, select Stop Protection.

    Select Delete protected data from the Stop Protection pane.

    The protected member status changes to Inactive replica available.

  4. Right-click the inactive protection group and select Remove inactive protection.

    Remove inactive protection.

  5. From the Delete Inactive Protection window, select the Delete online storage check box, and then select OK.

    Delete online storage.

Method 2

Open the MABS management or DPM management console. Under Select data protection method, clear the I want online protection check box.

Select the data protection method.

After you delete the on-premises backup items, follow the next steps from the portal.

Delete the Recovery Services vault

  1. When all dependencies have been removed, scroll to the Essentials pane in the vault menu.

  2. Verify that there aren't any backup items, backup management servers, or replicated items listed. If items still appear in the vault, refer to the Before you start section.

  3. When there are no more items in the vault, select Delete on the vault dashboard.

    Select Delete on the vault dashboard.

  4. Select Yes to verify that you want to delete the vault. The vault is deleted. The portal returns to the New service menu.

Delete the Recovery Services vault by using PowerShell

First, read the Before you start section to understand the dependencies and vault deletion process.

To stop protection and delete the backup data:

  • If you're using SQL in Azure VMs backup and enabled auto-protection for SQL instances, first disable the auto-protection.

        Disable-AzRecoveryServicesBackupAutoProtection
           [-InputItem] <ProtectableItemBase>
           [-BackupManagementType] <BackupManagementType>
           [-WorkloadType] <WorkloadType>
           [-PassThru]
           [-VaultId <String>]
           [-DefaultProfile <IAzureContextContainer>]
           [-WhatIf]
           [-Confirm]
           [<CommonParameters>]
    

    Learn more on how to disable protection for an Azure Backup-protected item.

  • Stop protection and delete data for all backup-protected items in cloud (for example: IaaS VM, Azure file share, and so on):

       Disable-AzRecoveryServicesBackupProtection
       [-Item] <ItemBase>
       [-RemoveRecoveryPoints]
       [-Force]
       [-VaultId <String>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
    

    Learn more about disables protection for a Backup-protected item.

  • For on-premises Files and Folders protected using Azure Backup Agent (MARS) backing up to Azure, use the following PowerShell command to delete the backed-up data from each MARS PowerShell module:

    Get-OBPolicy | Remove-OBPolicy -DeleteBackup -SecurityPIN <Security Pin>
    

    Post where the following prompt would appear:

    Microsoft Azure Backup Are you sure you want to remove this backup policy? Deleted backup data will be retained for 14 days. After that time, backup data will be permanently deleted.
    [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

  • For on-premises machines protected using MABS (Microsoft Azure Backup Server) or DPM (System Center Data Protection Manager) to Azure, use the following command to delete the backed-up data in Azure.

    Get-OBPolicy | Remove-OBPolicy -DeleteBackup -SecurityPIN <Security Pin>
    

    Post where the following prompt would appear:

    Microsoft Azure Backup Are you sure you want to remove this backup policy? Deleted backup data will be retained for 14 days. After that time, backup data will be permanently deleted.
    [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):*

After deleting the backed-up data, un-register any on-premises containers and management servers.

  • For on-premises Files and Folders protected using Azure Backup Agent (MARS) backing up to Azure:

    Unregister-AzRecoveryServicesBackupContainer
              [-Container] <ContainerBase>
              [-PassThru]
              [-VaultId <String>]
              [-DefaultProfile <IAzureContextContainer>]
              [-WhatIf]
              [-Confirm]
              [<CommonParameters>]
    

    Learn more about un-registering a Windows Server or other container from the vault.

  • For on-premises machines protected using MABS (Microsoft Azure Backup Server) or DPM to Azure (System Center Data Protection Manage:

        Unregister-AzRecoveryServicesBackupManagementServer
          [-AzureRmBackupManagementServer] <BackupEngineBase>
          [-PassThru]
          [-VaultId <String>]
          [-DefaultProfile <IAzureContextContainer>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
    

    Learn more about un-registering a Backup management container from the vault.

After permanently deleting backed up data and un-registering all containers, proceed to delete the vault.

To delete a Recovery Services vault:

    Remove-AzRecoveryServicesVault
   -Vault <ARSVault>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Learn more about deleting a recovery services vault.

Delete the Recovery Services vault by using CLI

First, read the Before you start section to understand the dependencies and vault deletion process.

Note

Currently, Azure Backup CLI supports managing only Azure VM backups, so the following command to delete the vault works only if the vault contains Azure VM backups. You cannot delete a vault using Azure Backup CLI, if the vault contains any backup item of type other than Azure VMs.

To delete existing Recovery services vault, perform the below:

  • To stop protection and delete the backup data

    az backup protection disable --container-name
                             --item-name
                             [--delete-backup-data {false, true}]
                             [--ids]
                             [--resource-group]
                             [--subscription]
                             [--vault-name]
                             [--yes]
    

    For more information, see this article.

  • Delete an existing Recovery services vault:

    az backup vault delete [--force]
                       [--ids]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--yes]
    

    For more information, see this article

Delete the Recovery Services vault by using Azure Resource Manager

This option to delete the Recovery Services vault is recommended only if all of the dependencies are removed and you're still getting the Vault deletion error. Try any or all of the following tips:

  • From the Essentials pane in the vault menu, verify that there aren't any backup items, backup management servers, or replicated items listed. If there are backup items, refer the Before you start section.
  • Try deleting the vault from the portal again.
  • If all of the dependencies are removed and you're still getting the Vault deletion error, use the ARMClient tool to perform the following steps (after the note).
  1. Go to chocolatey.org to download and install Chocolatey. Then, install ARMClient by running the following command:

    choco install armclient --source=https://chocolatey.org/api/v2/

  2. Sign in to your Azure account, and then run the following command:

    ARMClient.exe login [environment name]

  3. In the Azure portal, gather the subscription ID and resource group name for the vault you want to delete.

For more information on the ARMClient command, see ARMClient README.

Use the Azure Resource Manager client to delete a Recovery Services vault

  1. Run the following command by using your subscription ID, resource group name, and vault name. If you don't have any dependencies, the vault is deleted when you run the following command:

    ARMClient.exe delete /subscriptions/<subscriptionID>/resourceGroups/<resourcegroupname>/providers/Microsoft.RecoveryServices/vaults/<recovery services vault name>?api-version=2015-03-15
    
  2. If the vault isn't empty, you'll receive the following error message: Vault cannot be deleted as there are existing resources within this vault. To remove a protected item or container within a vault, run the following command:

    ARMClient.exe delete /subscriptions/<subscriptionID>/resourceGroups/<resourcegroupname>/providers/Microsoft.RecoveryServices/vaults/<recovery services vault name>/registeredIdentities/<container name>?api-version=2016-06-01
    
  3. In the Azure portal, make sure that the vault is deleted.

Next steps

Learn about Recovery Services vaults Learn about monitoring and managing Recovery Services vaults