Troubleshooting backup failures in Azure Disk Backup
This article provides troubleshooting information on backup and restore issues faced with Azure Disk. For more information on the Azure Disk backup region availability, supported scenarios and limitations, see the support matrix.
Common issues faced with Azure Disk Backup
Error Code: UserErrorSnapshotRGSubscriptionMismatch
Error Message: Invalid subscription selected for Snapshot Data store
Recommended Action: Disks and disk snapshots are stored in the same subscription. You can choose any resource group to store the disk snapshots within the subscription. Select the same subscription as that of the source disk. For more information, see the support matrix.
Error Code: UserErrorSnapshotRGNotFound
Error Message: Could not perform the operation as Snapshot Data store Resource Group does not exist.
Recommended Action: Create the resource group and provide the required permissions on it. For more information, see configure backup.
Error Code: UserErrorManagedDiskNotFound
Error Message: Could not perform the operation as Managed Disk no longer exists.
Recommended Action: The backups are failing because the source disk may be deleted or moved to a different location. Use the existing restore point to restore the disk if it is deleted by mistake. If the disk is moved to a different location, configure backup for the disk.
UserErrorSnapshotResourceGroupHasLocks
Error Message: This error code appears when a Delete or Read Lock has been applied on the Snapshot Resource Group provided as input for Backup Extension.
Recommended Action: In case if you are configuring a new backup instance, use a resource group without a delete or read lock. If the backup instance already configured then remove the lock from the snapshot resource group.
Error Code: UserErrorNotEnoughPermissionOnDisk
Error Message: Azure Backup Service requires additional permissions on the Disk to do this operation.
Recommended Action: Grant the Backup vault's managed identity the appropriate permissions on the disk. Refer to the documentation to understand what permissions are needed to be assigned to the Backup Vault managed identity and how to provide it.
Error Code: UserErrorNotEnoughPermissionOnSnapshotRG
Error Message: Azure Backup Service requires additional permissions on the Snapshot Data store Resource Group to do this operation.
Recommended Action: Grant the Backup vault's managed identity the appropriate permissions on the snapshot data store resource group. The snapshot data store resource group is the location where the disk snapshots are stored. Refer to the documentation to understand what permissions are required by the Backup Vault managed identity over the resource group and how to provide them.
Error Code: UserErrorDiskBackupDiskOrMSIPermissionsNotPresent
Error Message: Invalid disk or Azure Backup Service requires additional permissions on the Disk to do this operation
Recommended Action: The backups are failing as the source disk may be deleted or moved to a different location. Use the existing restore point to restore the disk if it deleted by mistake. If the disk is moved to a different location, configure backup for the disk. If the disk isn't deleted or moved, grant the Backup vault's managed identity the appropriate permissions on the disk. Refer to the documentation to understand what permissions are to be assigned to the Backup vault's managed identity.
Error Code: UserErrorDiskBackupSnapshotRGOrMSIPermissionsNotPresent
Error Message: Could not perform the operation as Snapshot Data store Resource Group no longer exists. Or Azure Backup Service requires additional permissions on the Snapshot Data store Resource Group to do this operation.
Recommended Action: Create a resource group and grant the Backup vault's managed identity the appropriate permissions on the snapshot data store resource group. The snapshot data store resource group is the location where the disk snapshots are stored. Refer to the documentation to understand what permissions are to be assigned to the Backup vault's managed identity over the resource group.
Error Code: UserErrorDiskBackupAuthorizationFailed
Error Message: Backup Vault managed identity is missing the necessary permissions to do this operation.
Recommended Action: Grant the Backup vault's managed identity the appropriate permissions on the disk to be backed up and on the snapshot data store resource group where the snapshots are stored. Refer to the documentation to understand what permissions are to be assigned to the Backup vault's managed identity.
Error Code: UserErrorSnapshotRGOrMSIPermissionsNotPresent
Error Message: Could not perform the operation as Snapshot Data store Resource Group no longer exists. Or, Azure Backup Service requires additional permissions on the Snapshot Data store Resource Group to do this operation.
Recommended Action: Create the resource group and grant the Backup vault's managed identity the appropriate permissions on the snapshot data store resource group. The snapshot data store resource group is the location where the snapshots are stored. Refer to the documentation to understand what permissions are to be assigned to the Backup vault's managed identity over resource group.
Error Code: UserErrorOperationalStoreParametersNotProvided
Error Message: Could not perform the operation as Snapshot Data store Resource Group parameter is not provided
Recommended Action: Provide the snapshot data store resource group parameter. The snapshot data store resource group is the location where the disk snapshots are stored. For more information, see the documentation.
Error Code: UserErrorInvalidOperationalStoreResourceGroup
Error Message: Snapshot Data store Resource Group provided is invalid
Recommended Action: Provide a valid resource group for the snapshot data store. The snapshot data store resource group is the location where the disk snapshots are stored. For more information, see the documentation.
Error Code: UserErrorDiskBackupDiskTypeNotSupported
Error Message: Unsupported disk type
Recommended Action: Refer to the support matrix on unsupported scenarios and limitations.
Error Code: UserErrorSameNameDiskAlreadyExists
Error Message: Could not restore as a Disk with same name already exists in the selected target resource group
Recommended Action: Provide a different disk name for restore. For more information, see Restore Azure Managed Disks.
Error Code: UserErrorRestoreTargetRGNotFound
Error Message: Operation failed as the Target Resource Group does not exist.
Recommended Action: Provide a valid resource group to restore. For more information, see Restore Azure Managed Disks.
Error Code: UserErrorNotEnoughPermissionOnTargetRG
Error Message: Azure Backup Service requires additional permissions on the Target Resource Group to do this operation.
Recommended Action: Grant the Backup vault's managed identity the appropriate permissions on the target resource group. The target resource group is the selected location where the disk is to be restored. Refer to the restore documentation to understand what permissions are to be assigned to the Backup vault's managed identity.
Error Code: UserErrorSubscriptionDiskQuotaLimitReached
Error Message: Operation is failed as the maximum limit for disk quota is reached for the subscription.
Recommended Action: Refer to the Azure subscription and service limits and quota documentation or contact Microsoft Support for further guidance.
Error Code: UserErrorDiskBackupRestoreRGOrMSIPermissionsNotPresent
Error Message: Operation failed as the Target Resource Group doesn't exist. Or Azure Backup Service requires additional permissions on the Target Resource Group to do this operation.
Recommended Action: Provide a valid resource group to restore, and grant the Backup vault's managed identity the appropriate permissions on the target resource group. The target resource group is the selected location where the disk is to be restored. Refer to the restore documentation to understand what permissions are required to be assigned to the Backup vault's managed identity.
Error Code: UserErrorDESKeyVaultKeyDisabled
Error Message: The key vault key used for disk encryption set is not in enabled state.
Recommended Action: Enable the key vault key used for disk encryption set. Refer to the limitations in the support matrix.
Error Code: UserErrorMSIPermissionsNotPresentOnDES
Error Message: Azure Backup Service needs permission to access the disk encryption set used with the disk.
Recommended Action: Provide Reader access to the Backup vault's managed identity to the disk encryption set (DES).
Error Code: UserErrorDESKeyVaultKeyNotAvailable
Error Message: The key vault key used for disk encryption set is not available.
Recommended Action: Ensure that the key vault key used for disk encryption set isn't disabled or deleted.
Error Code: UserErrorDiskSnapshotNotFound
Error Message: The disk snapshot for this Restore point is not accessible.
Recommended Action: Snapshots are stored in the snapshot data store resource group within your subscription. The snapshot related to the selected restore point is either deleted or moved from this resource group. Consider using another Recovery point to restore. Also, follow the recommended guidelines for choosing Snapshot resource group mentioned in the restore documentation.
Error Code: UserErrorSnapshotMetadataNotFound
Error Message: The disk snapshot metadata for this Restore point is deleted
Recommended Action: Consider using another recovery point to restore. For more information, see the restore documentation.
Error Code: BackupAgentPluginHostValidateProtectionError
Error Message: Disk Backup is not yet available in the region of the Backup Vault under which Configure Protection is being tried.
Recommended Action: Backup Vault must be in a supported region. For region availability, see the the support matrix.
Error Code: UserErrorDppDatasourceAlreadyHasBackupInstance
Error Message: The disk you're trying to configure backup is already being protected. Disk is already associated with a backup instance in a Backup vault.
Recommended Action: This disk is already associated with a backup instance in a Backup vault. If you want to reprotect this disk, then delete the backup instance from the Backup vault where it was protected and reprotect the disk in any other vault.
Error Code: UserErrorDppDatasourceAlreadyProtected
Error Message: The disk you're trying to configure backup is already being protected. Disk is already associated with a backup instance in a Backup vault.
Recommended Action: This disk is already associated with a backup instance in a Backup vault. If you want to reprotect this disk, then delete the backup instance from the Backup vault where it is currently protected and reprotect the disk in any other vault.
Error Code: UserErrorMaxConcurrentOperationLimitReached
Error Message: Unable to start the operation as maximum number of allowed concurrent backups is reached.
Recommended Action: Wait until the previous running backup completes.
Error Code: UserErrorMissingSubscriptionRegistration
Error Message: The subscription isn't registered to use namespace Microsoft.Compute
Recommended Action: The required resource provider is not registered for your subscription. Register both the resource providers' namespace (Microsoft.Compute and Microsoft.Storage) using the steps in Solution 3.