|
2 | 2 | title: Troubleshoot Blob backup and restore issues
|
3 | 3 | description: In this article, learn about symptoms, causes, and resolutions of Azure Backup failures related to the Azure Blob backups and restore.
|
4 | 4 | ms.topic: troubleshooting
|
5 |
| -ms.date: 05/21/2025 |
| 5 | +ms.date: 06/13/2025 |
6 | 6 | ms.service: azure-backup
|
7 | 7 | ms.reviewer: geg
|
8 | 8 | author: jyothisuri
|
@@ -151,7 +151,7 @@ This article provides troubleshooting information to address issues you encounte
|
151 | 151 |
|
152 | 152 | **Error message**: Incorrect containers selected for operation.
|
153 | 153 |
|
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. |
155 | 155 |
|
156 | 156 | ### UserErrorPitrRestoreInProgress
|
157 | 157 |
|
@@ -250,30 +250,6 @@ This article provides troubleshooting information to address issues you encounte
|
250 | 250 |
|
251 | 251 | **Recommended action**: Track further progress on the operation in storage account activity log.
|
252 | 252 |
|
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 |
| - |
277 | 253 | ### UserErrorSelectedContainerPartOfAnotherORPolicy
|
278 | 254 |
|
279 | 255 | **Error code**: `UserErrorSelectedContainerPartOfAnotherORPolicy`
|
@@ -312,31 +288,31 @@ This article provides troubleshooting information to address issues you encounte
|
312 | 288 |
|
313 | 289 | **Error message**: Requested operation failed due to throttling by the Azure service. Azure Storage account management list operations limit reached.
|
314 | 290 |
|
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. |
316 | 292 |
|
317 | 293 | ### UserErrorBlobVersionDeletedDuringBackup
|
318 | 294 |
|
319 | 295 | **Error code**: `UserErrorBlobVersionDeletedDuringBackup`
|
320 | 296 |
|
321 | 297 | **Error message**: The backup failed due to one or more blob versions getting deleted in the backup job duration.
|
322 | 298 |
|
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. |
324 | 300 |
|
325 | 301 | ### UserErrorBlobVersionArchivedDuringBackup
|
326 | 302 |
|
327 | 303 | **Error code**: `UserErrorBlobVersionArchivedDuringBackup`
|
328 | 304 |
|
329 | 305 | **Error message**: The backup failed due to one or more blob versions moving to the archive tier in the backup job duration.
|
330 | 306 |
|
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*. |
332 | 308 |
|
333 | 309 | ### UserErrorBlobVersionArchivedAndDeletedDuringBackup
|
334 | 310 |
|
335 | 311 | **Error code**: `UserErrorBlobVersionArchivedAndDeletedDuringBackup`
|
336 | 312 |
|
337 | 313 | **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.
|
338 | 314 |
|
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. |
340 | 316 |
|
341 | 317 | ### UserErrorContainerHasImmutabilityPolicyDuringRestore
|
342 | 318 |
|
@@ -396,8 +372,180 @@ This article provides troubleshooting information to address issues you encounte
|
396 | 372 |
|
397 | 373 | ### LinkedAuthorizationFailed
|
398 | 374 |
|
399 |
| -*Error code**: `LinkedAuthorizationFailed` |
| 375 | +**Error code**: `LinkedAuthorizationFailed` |
400 | 376 |
|
401 | 377 | **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].
|
402 | 378 |
|
403 | 379 | **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