Troubleshoot Azure Blob backup
This article provides troubleshooting information to address issues you encounter while configuring backup or restoring Azure Blob using the Azure Backup Service.
Common configuration errors
UserErrorMissingRequiredPermissions
Error code: UserErrorMissingRequiredPermissions
Error message: Appropriate permissions to perform the operation are missing.
Recommendation: Ensure that you've granted appropriate permissions.
UserErrorUnsupportedStorageAccountType
Error code: UserErrorUnsupportedStorageAccountType
Error message: The storage account type isn't supported for backup.
Recommendation: Ensure that the storage account you've selected for backup is supported. Learn more.
UserErrorMaxOrsPolicyExistOnStorageAccount
Error code: UserErrorMaxOrsPolicyExistOnStorageAccount
Error message: Maximum object replication policy exists on the source storage account.
Recommendation: Ensure that you haven't reached the limit of replication rules supported on a storage account.
Common backup or restore errors
UserErrorAzureResourceNotFoundByPlugin
Error code: UserErrorAzureResourceNotFoundByPlugin
Error message: Unable to find the specified Azure resource.
Recommendation: For a backup operation, ensure that the source account configured for backup is valid and not deleted. For restoration, check if both source and target storage accounts are existing.
UserErrorStorageAccountInLockedState
Error code: UserErrorStorageAccountInLockedState
Error message: Operation failed because storage account is in locked state.
Recommendation: Ensure that there's no read only lock on the storage account. Learn more.
UserErrorInvalidRecoveryPointInTime
Error code: UserErrorInvalidRecoveryPointInTime
Error message: Restore point in time is invalid.
Recommendation: Ensure that the recovery time provided for restore exists and is in the correct format.
UserErrorInvalidRestorePrefixRange
Error code: UserErrorInvalidRestorePrefixRange
Error message: Restore Prefix Range for item-level restore is invalid.
Recommendation: This error may occur if the backup service can't decipher the prefix range passed for the restore. Ensure that the prefix range provided for the restore is valid.
UserErrorPitrDisabledOnStorageAccount
Error code: UserErrorPitrDisabledOnStorageAccount
Error message: The required setting PITR is disabled on storage account.
Recommendation: Enable that the point-in-restore setting on the storage account. Learn more.
UserErrorImmutabilityPolicyConfigured
Error code: UserErrorImmutabilityPolicyConfigured
Error message: An Immutability Policy is configured on one or more containers, which is preventing the operation.
Recommendation: This error may occur if you've configured an immutable policy on the container you're trying to restore. You need to remove the immutability policy or remove the impacted container from the restore intent, and then retry the operation. Learn how to delete an unlocked policy.
UserErrorRestorePointNotFound
Error code: UserErrorRestorePointNotFound
Error message: The restore point isn't available in backup vault.
Recommendation: Ensure that the restore point ID is correct and the restore point didn't get deleted based on the backup retention settings. For a recent recovery point, ensure that the corresponding backup job is complete. We recommend you triggering the operation again using a valid restore point. If the issue persists, contact Microsoft support.
UserErrorContainerNotFoundForPointInTimeRestore
Error code: UserErrorContainerNotFoundForPointInTimeRestore
Error message: A container selected for the restore was not found in the storage account for the selected point in time.
Recommendation: Use specific container restore or prefix match restore for containers that are present in the account. We also recommend enabling vaulted backup for your storage account to get comprehensive protection against deletion of containers. If you already have it configured, you can use a recovery point for performing recovery of deleted containers.
UserErrorTargetContainersExistOnAccount
Error code: UserErrorTargetContainersExistOnAccount
Error message: The containers that are part of restore request shouldn't exist on target storage account.
Recommendation: Ensure that the target storage account doesn't have containers with the same name you're trying to restore. Choose another storage target or retry the restore operation after removing containers with the same name.
UserErrorBackupRequestThrottled
Error code: UserErrorBackupRequestThrottled
Error message: The backup request is being throttled as you've reached the limit for maximum number of backups on a given backup instance in a day.
Recommendation: Wait for a day before triggering a new backup operation.
UserErrorRestorePointNotFoundInBackupVault
Error code: UserErrorRestorePointNotFoundInBackupVault
Error message: The restore point wasn't found in the Backup vault.
Recommendation: Ensure that the restore point ID is correct and the restore point didn't get deleted based on the backup retention settings. Trigger the restore again using a valid restore point.
UserErrorOriginalLocationRestoreNotSupported
Error code: UserErrorOriginalLocationRestoreNotSupported
Error message: Original location restores not supported for vaulted blob backup.
Recommendation: Choose an alternate target storage account and trigger the restore operation.
UserErrorNoContainersSelectedForOperation
Error code: UserErrorNoContainersSelectedForOperation
Error message: No containers selected for operation.
Recommendation: Ensure that you've provided a valid list of containers to restore.
UserErrorIncorrectContainersSelectedForOperation
Error code: UserErrorIncorrectContainersSelectedForOperation
Error message: Incorrect containers selected for operation.
Recommendation: This error may occur if one or more containers included in the scope of protection no longer exist in the protected storage account. We recommend to re-trigger the operation after modifying the protected container list using the edit backup instance option.
UserErrorCrossTenantOrsPolicyDisabled
Error code: UserErrorCrossTenantOrsPolicyDisabled
Error message: Cross tenant object replication policy disabled.
Recommendation: Enable cross-tenant object replication policy on storage account and trigger the operation again. To check this, go to the storage account > Object replication > Advanced settings, and ensure that the checkbox is enabled.
UserErrorPitrRestoreInProgress
Error code: UserErrorPitrRestoreInProgress
Error message: The operation can't be performed while a restore is in progress on the source account.
Recommendation: You need to retrigger the operation once the in-progress restore completes.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for