Skip to content

Commit 19df173

Browse files
authored
Merge pull request #301295 from AbhishekMallick01/Jun-13-2025-BlobBkpTSG
Blob backup - TSG updates - 20 added, 3 removed
2 parents 470b9e1 + 809ab8c commit 19df173

File tree

1 file changed

+179
-31
lines changed

1 file changed

+179
-31
lines changed

articles/backup/backup-azure-troubleshoot-blob-backup.md

Lines changed: 179 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Troubleshoot Blob backup and restore issues
33
description: In this article, learn about symptoms, causes, and resolutions of Azure Backup failures related to the Azure Blob backups and restore.
44
ms.topic: troubleshooting
5-
ms.date: 05/21/2025
5+
ms.date: 06/13/2025
66
ms.service: azure-backup
77
ms.reviewer: geg
88
author: jyothisuri
@@ -151,7 +151,7 @@ This article provides troubleshooting information to address issues you encounte
151151

152152
**Error message**: Incorrect containers selected for operation.
153153

154-
**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 you to re-trigger the operation after modifying the protected container list using the edit backup instance option.
154+
**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 you to retrigger the operation after modifying the protected container list using the edit backup instance option.
155155

156156
### UserErrorPitrRestoreInProgress
157157

@@ -250,30 +250,6 @@ This article provides troubleshooting information to address issues you encounte
250250

251251
**Recommended action**: Track further progress on the operation in storage account activity log.
252252

253-
### UserErrorVaultedBackupFeatureNotEnabled
254-
255-
**Error code**: `UserErrorVaultedBackupFeatureNotEnabled`
256-
257-
**Error message**: The subscription must be registered for the required features to use vaulted backup for blobs.
258-
259-
**Recommended action**: Register your subscription for Microsoft.Storage/HardenBackup and Microsoft.DataProtection/BlobVaultedBackup.
260-
261-
### ObjectReplicationPolicyCreationFailure
262-
263-
**Error code**: `ObjectReplicationPolicyCreationFailure`
264-
265-
**Error message**: Failed to create object replication policy on the storage account.
266-
267-
**Recommended action**: Failed to create object replication policy. Wait for a few minutes and then try the operation again. If the issue persists, please contact Microsoft support.
268-
269-
### UserErrorRequiredStorageFeaturesDisabled
270-
271-
**Error code**: `UserErrorRequiredStorageFeaturesDisabled`
272-
273-
**Error message**: The operation failed due to required storage feature(s) being disabled on the storage account.
274-
275-
**Recommended action**: Enable required features for Azure backup on source Storage account.
276-
277253
### UserErrorSelectedContainerPartOfAnotherORPolicy
278254

279255
**Error code**: `UserErrorSelectedContainerPartOfAnotherORPolicy`
@@ -312,31 +288,31 @@ This article provides troubleshooting information to address issues you encounte
312288

313289
**Error message**: Requested operation failed due to throttling by the Azure service. Azure Storage account management list operations limit reached.
314290

315-
**Recommended action&&: Wait for a few minutes and then try the operation again.
291+
**Recommended action**: Wait for a few minutes and then try the operation again.
316292

317293
### UserErrorBlobVersionDeletedDuringBackup
318294

319295
**Error code**: `UserErrorBlobVersionDeletedDuringBackup`
320296

321297
**Error message**: The backup failed due to one or more blob versions getting deleted in the backup job duration.
322298

323-
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is 7 days.
299+
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is seven days.
324300

325301
### UserErrorBlobVersionArchivedDuringBackup
326302

327303
**Error code**: `UserErrorBlobVersionArchivedDuringBackup`
328304

329305
**Error message**: The backup failed due to one or more blob versions moving to the archive tier in the backup job duration.
330306

331-
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is *7 days*.
307+
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is *seven days*.
332308

333309
### UserErrorBlobVersionArchivedAndDeletedDuringBackup
334310

335311
**Error code**: `UserErrorBlobVersionArchivedAndDeletedDuringBackup`
336312

337313
**Error message**: The backup failed due to one or more blob versions moving to the archive tier or getting deleted in the backup job duration.
338314

339-
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is 7 days.
315+
**Recommended action**: We recommend you to avoid tampering with blob versions while a backup job is in progress. Ensure the minimum retention configured for versions in the life cycle management policy is seven days.
340316

341317
### UserErrorContainerHasImmutabilityPolicyDuringRestore
342318

@@ -396,8 +372,180 @@ This article provides troubleshooting information to address issues you encounte
396372

397373
### LinkedAuthorizationFailed
398374

399-
*Error code**: `LinkedAuthorizationFailed`
375+
**Error code**: `LinkedAuthorizationFailed`
400376

401377
**Error message**: The client [user name] with object ID has permissions to perform the required action [operation name] on scope [vault name], however, it does not have the required permissions to perform action(s) [operation name] on the linked scope [datasource name].
402378

403379
**Recommended action**: Ensure that you have read access on the datasource associated with this backup instance to be able to trigger the restore operation. Once the required permissions are provided, retry the operation.
380+
381+
## UserErrorConflictingOperationInProgress
382+
383+
**Error code**: `UserErrorConflictingOperationInProgress`
384+
385+
**Error message**: This operation on Storage Account requires exclusive access.
386+
387+
**Recommended action**: Ensure that there is no conflicting operation in progress, and then retry the operation.
388+
389+
## UserErrorStorageAccountContainerNotFound
390+
391+
**Error code**: `UserErrorStorageAccountContainerNotFound`
392+
393+
**Error message**: The specified container isn't found.
394+
395+
**Cause**: This error can occur if required container is deleted while operation is in progress.
396+
397+
**Recommended action**: Retry the operation and wait for completion before attempting container delete operation.
398+
399+
## UserErrorBlobContainerDeletedDuringBackup
400+
401+
**Error code**: `UserErrorBlobContainerDeletedDuringBackup`
402+
403+
**Error message**: The backup failed due to one or more blob containers deleted in the backup job duration.
404+
405+
**Recommended action**: We recommend to avoid tampering with blob containers while a backup job is in progress.
406+
407+
## UserErrorBlobVersionArchivedAndContainerDeletedDuringBackup
408+
409+
**Error code**: `UserErrorBlobVersionArchivedAndContainerDeletedDuringBackup`
410+
411+
**Error message**: The backup failed due to one or more blob versions are moving to the archive tier and one or more containers deleted in the backup job duration.
412+
413+
**Recommended action**: We recommend to avoid tampering with blob versions and blob containers while a backup job is in progress.
414+
415+
## UserErrorBlobVersionDeletedAndContainerDeletedDuringBackup
416+
417+
**Error code**: `UserErrorBlobVersionDeletedAndContainerDeletedDuringBackup`
418+
419+
**Error message** - The backup failed due to one or more blob versions getting deleted or container getting deleted in the backup job duration.
420+
421+
**Recommended action**: We recommend to avoid tampering with blob versions and containers while a backup job is in progress. Ensure the minimum retention configured for versions in lifecycle management policy is seven days.
422+
423+
## UserErrorBlobVersionArchivedDeletedAndContainerDeletedDuringBackup
424+
425+
**Error code**: `UserErrorBlobVersionArchivedDeletedAndContainerDeletedDuringBackup`
426+
427+
**Error message**: The backup failed due to one or more blob versions moving to the archive tier, blob version getting deleted, and container getting deleted in the backup job duration.
428+
429+
**Recommended action**: We recommend to avoid tampering with blob versions and containers while a backup job is in progress. Ensure the minimum retention configured for versions in lifecycle management policy is seven days.
430+
431+
## LongRunningOperationTrackingFailure
432+
433+
**Error code**: `LongRunningOperationTrackingFailure`
434+
435+
**Error message**: Failed to track the long-running operation. The operation is still running and is expected to complete.
436+
437+
This error is usually seen for operational tier restore failure due to PITR still running in background. And potentially should complete.
438+
439+
**Recommended action**: Track further progress on the operation in storage account activity log.
440+
441+
## UserErrorConflictingFeatureHardDeleteEnabled
442+
443+
**Error code**: `UserErrorConflictingFeatureHardDeleteEnabled `
444+
445+
**Error message**: Conflicting feature permanent delete is enabled which is causing the operation failure.
446+
447+
**Recommended action**: Please disable permanent delete setting on the storage account and retry the operation. [Learn more](https://aka.ms/UserErrorConflictingFeatureHardDeleteEnabled).
448+
449+
## UserErrorConflictingFeatureNSPEnabled
450+
451+
**Error code**: `UserErrorConflictingFeatureNSPEnabled`
452+
453+
**Error message**: Conflicting feature network security perimeter is enabled which is causing the operation failure.
454+
455+
**Recommended action**: Remove network security perimeter from the storage account and retry the operation.
456+
457+
## 641508, UserErrorConflictingOperationInProgress
458+
459+
**Error code**: `641508, UserErrorConflictingOperationInProgress`
460+
461+
**Error message**: This operation on Storage Account requires exclusive access.
462+
463+
**Recommended action**: Retry after ensuring there is no conflicting operation in progress.
464+
465+
## 641539, UserErrorCrossTenantOrsPolicyDisabled
466+
467+
**Error code**: `641539, UserErrorCrossTenantOrsPolicyDisabled`
468+
469+
**Error message**: Cross tenant object replication policy is disabled.
470+
471+
**Recommended action**: Enable cross tenant object replication policy on storage account and trigger the operation again.
472+
473+
## 641541, UserErrorPitrRestoreFailedLeasedBlob
474+
475+
**Error code**: `641541, UserErrorPitrRestoreFailedLeasedBlob`
476+
477+
**Error message**: The point in time operation failed because of a lease on the blob.
478+
479+
**Recommended action**: Break the lease on blob before retrying.
480+
481+
## 641560, UserErrorStorageAccountAndDatasourceLocationNotSame
482+
483+
**Error code**: `641560, UserErrorStorageAccountAndDatasourceLocationNotSame`
484+
485+
**Error message**: Operation failed because, Storage Account and Datasource are not in the same location.
486+
487+
**Recommended action**: Check the DataSource location in protection input and make sure it is same as the location of Storage account
488+
489+
## 641561, UserErrorKeyVaultWasNotFound
490+
491+
**Error code**: `641561, UserErrorKeyVaultWasNotFound`
492+
493+
**Error message**: Operation failed because key vault is not found to unwrap the encryption key for storage account.
494+
495+
**Recommended action**: Check the key vault settings used for storage account encryption.
496+
497+
## 641562, UserErrorBackupOperationNotSupportedOnOperationalTier
498+
499+
**Error code**: `641562, UserErrorBackupOperationNotSupportedOnOperationalTier`
500+
501+
**Error message**: Backup isn't supported on this tier.
502+
503+
**Recommended action**: Change policy to allow backups to run only on supported tiers.
504+
505+
## 641563, UserErrorMaxLimitReachedForObjectReplicationPoliciesOnStorageAccount
506+
507+
**Error code**: `641563, UserErrorMaxLimitReachedForObjectReplicationPoliciesOnStorageAccount`
508+
509+
**Error message**: Number of Object Replication Policies exceeded the max limit on a given storage account.
510+
511+
**Recommended action**: Remove at least one object replication policy.
512+
513+
## 641564, UserErrorLegalHoldOnContainer
514+
515+
**Error code**: `641564, UserErrorLegalHoldOnContainer`
516+
517+
**Error message**: Operation failed because the container(s) have legal hold.
518+
519+
**Recommended action**: Remove legal hold from containers or remove container with legal hold from protection for operation to succeed.
520+
521+
## 641565, UserErrorSubscriptionFrozen
522+
523+
**Error code**: `641565, UserErrorSubscriptionFrozen`
524+
525+
**Error message**: Operation failed because subscription frozen due to inactivity.
526+
527+
**Recommended action**: Contact Microsoft support to unfreeze the subscription.
528+
529+
## 641566, UserErrorDenyAssignmentWithBlueprint
530+
531+
**Error code**: `641566, UserErrorDenyAssignmentWithBlueprint`
532+
533+
**Error message**: Operation failed because the access is denied due to deny assigmented created by Azure blueprint assignment.
534+
535+
**Recommended action**: Remove the deny assignment created by Azure blueprint assignment.
536+
537+
## 641568, UserErrorRestoreObjectReplicationPolicyCreationFailure
538+
539+
**Error code**: `641568, UserErrorRestoreObjectReplicationPolicyCreationFailure`
540+
541+
**Error message**: Failed to create object replication policy on the storage account, restore storage account or the object replication policy created by Azure Backup may have been deleted.
542+
543+
**Recommended action**: Use the valid restore storage account then try the operation again.
544+
545+
## UserErrorMaxSubmissionLimitReached
546+
547+
**Error code**: `UserErrorMaxSubmissionLimitReached`
548+
549+
**Error message**: Limit reached for maximum number of operations within a time range is reached.
550+
551+
**Recommended action**: The daily backup count has reached the maximum limit of five for the instance. Trigger a new backup after 24 hours.

0 commit comments

Comments
 (0)