Skip to content

Commit bda4ba0

Browse files
denreadenrea
authored
Merge pull request #286764 from AbhishekMallick-MS/Sep-16-2024-BlobTSG
Azure Blob vaulted backup - TSG updates
2 parents 89eb3c2 + ecb03c3 commit bda4ba0

File tree

1 file changed

+199
-3
lines changed

1 file changed

+199
-3
lines changed

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

Lines changed: 199 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
title: Troubleshoot Blob backup and restore issues
3-
description: In this article, learn about symptoms, causes, and resolutions of Azure Backup failures related to Blob backup and restore.
3+
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: 07/24/2024
5+
ms.date: 09/16/2024
66
ms.service: azure-backup
77
ms.reviewer: geg
88
author: AbhishekMallick-MS
@@ -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 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 re-trigger the operation after modifying the protected container list using the edit backup instance option.
155155

156156
### UserErrorCrossTenantOrsPolicyDisabled
157157

@@ -168,3 +168,199 @@ This article provides troubleshooting information to address issues you encounte
168168
**Error message**: The operation can't be performed while a restore is in progress on the source account.
169169

170170
**Recommendation**: You need to retrigger the operation once the in-progress restore completes.
171+
172+
## Common errors for Azure Blob vaulted backup
173+
174+
### UserErrorInvalidParameterInRequest
175+
176+
**Error code**: `UserErrorInvalidParameterInRequest`
177+
178+
**Error message**: Request parameter is invalid.
179+
180+
**Recommended action**: Retry the operation with valid inputs.
181+
182+
183+
### UserErrorRequestDisallowedByAzurePolicy
184+
185+
**Error code**: `UserErrorRequestDisallowedByAzurePolicy`
186+
187+
**Error message**: An Azure Policy is configured on the resource which is preventing the operation.
188+
189+
**Recommended action**: Correct the policy and retry the operation.
190+
191+
### LongRunningRestoreTrackingFailure
192+
193+
**Error code**: `LongRunningRestoreTrackingFailure`
194+
195+
196+
**Error message**: Failed to track the long-running restore operation. The operation is still running and is expected to complete the restore of data.
197+
198+
**Recommended action**: Track further progress of this operation using the storage account's activity log for Restore blob ranges operation.
199+
200+
### LongRunningBackupTrackingFailure
201+
202+
**Error code**: `LongRunningBackupTrackingFailure`
203+
204+
**Error message**: Failed to track the long-running backup operation. The operation is still running and is expected to complete the backup of data.
205+
206+
**Recommended action**: Track further progress of this operation using the storage account's activity log or check the blob replication status.
207+
208+
### LongRunningOperationTrackingFailure
209+
210+
**Error code**: `LongRunningOperationTrackingFailure`
211+
212+
**Error message**: Failed to track the long-running operation. The operation is still running and is expected to complete.
213+
214+
**Recommended action**: Track further progress on the operation in storage account activity log.
215+
216+
### UserErrorVaultedBackupFeatureNotEnabled
217+
218+
**Error code**: `UserErrorVaultedBackupFeatureNotEnabled`
219+
220+
**Error message**: The subscription must be registered for the required features to use vaulted backup for blobs.
221+
222+
**Recommended action**: Register your subscription for Microsoft.Storage/HardenBackup and Microsoft.DataProtection/BlobVaultedBackup.
223+
224+
### ObjectReplicationPolicyCreationFailure
225+
226+
**Error code**: `ObjectReplicationPolicyCreationFailure`
227+
228+
**Error message**: Failed to create object replication policy on the storage account.
229+
230+
**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.
231+
232+
### UserErrorRequiredStorageFeaturesDisabled
233+
234+
**Error code**: `UserErrorRequiredStorageFeaturesDisabled`
235+
236+
**Error message**: The operation failed due to required storage feature(s) being disabled on the storage account.
237+
238+
**Recommended action**: Enable required features for Azure backup on source Storage account.
239+
240+
### UserErrorSelectedContainerPartOfAnotherORPolicy
241+
242+
**Error code**: `UserErrorSelectedContainerPartOfAnotherORPolicy`
243+
244+
**Error message**: The selected container is present in another Object replication policy. A given container can be part of only one OR policy at a time.
245+
246+
**Recommended action**: The container from other OR policy. Or change protection intent.
247+
248+
### UserErrorTooManyRestoreCriteriaGivenForBlobRestore
249+
250+
**Error code**: `UserErrorTooManyRestoreCriteriaGivenForBlobRestore`
251+
252+
**Error message**: The count of containers passed in the restore request exceeds the supported limit.
253+
254+
**Recommended action**: Reduce the number of containers in item level restore request to adhere to the limit.
255+
256+
### UserErrorTooManyPrefixesGivenForBlobRestore
257+
258+
**Error code**: `UserErrorTooManyPrefixesGivenForBlobRestore `
259+
260+
**Error message**: Restore operation failed as too many blob prefixes were given for a container
261+
262+
**Recommended action**: Limit the number of blob prefixes to lower it on a per-container basis.
263+
264+
### UserErrorStopProtectionNotSupportedForBlobOperationalBackup
265+
266+
**Error code**: `UserErrorStopProtectionNotSupportedForBlobOperationalBackup`
267+
268+
**Error message**: Stop protection is not supported for operational tier blob backups
269+
270+
**Recommended action**: Operational tier blob backups cannot be stopped.up
271+
272+
### UserErrorAzureStorageAccountManagementOperationLimitReached
273+
274+
**Error code**: `UserErrorAzureStorageAccountManagementOperationLimitReached`
275+
276+
**Error message**: Requested operation failed due to throttling by the Azure service. Azure Storage account management list operations limit reached.
277+
278+
**Recommended action&&: Wait for a few minutes and then try the operation again.
279+
280+
### UserErrorBlobVersionDeletedDuringBackup
281+
282+
**Error code**: `UserErrorBlobVersionDeletedDuringBackup`
283+
284+
**Error message**: The backup failed due to one or more blob versions getting deleted in the backup job duration.
285+
286+
**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.
287+
288+
### UserErrorBlobVersionArchivedDuringBackup
289+
290+
**Error code**: `UserErrorBlobVersionArchivedDuringBackup`
291+
292+
**Error message**: The backup failed due to one or more blob versions moving to the archive tier in the backup job duration.
293+
294+
**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*.
295+
296+
### UserErrorBlobVersionArchivedAndDeletedDuringBackup
297+
298+
**Error code**: `UserErrorBlobVersionArchivedAndDeletedDuringBackup`
299+
300+
**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.
301+
302+
**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.
303+
304+
### UserErrorContainerHasImmutabilityPolicyDuringRestore
305+
306+
**Error code**: `UserErrorContainerHasImmutabilityPolicyDuringRestore`
307+
308+
**Error message**: One or more containers selected for the restore has an immutability policy.
309+
310+
**Recommended action**: Remove the immutability policy from the container and retry the operation.
311+
312+
### UserErrorArchivedRecoveryPointsRequestedForRestore
313+
314+
**Error code**: `UserErrorArchivedRecoveryPointsRequestedForRestore`
315+
316+
**Error message**: One or more containers selected for the restore have archived recovery points.
317+
318+
**Recommended action**: Re-hydrate archived recovery points or remove containers with archived recovery points from request and retry the operation.
319+
320+
### UserErrorObjectReplicationPolicyDeletionFailureOnRestoreTarget
321+
322+
**Error code**: `UserErrorObjectReplicationPolicyDeletionFailureOnRestoreTarget`
323+
324+
**Error message**: Failed to delete object replication policy on the restore target storage account.
325+
326+
**Recommended action**: Check if a resource lock is preventing deletion. The restore has succeeded but the object replication policy created during restore operation was not cleaned up after restore completion. You must delete the policy to prevent issues in future restores.
327+
328+
### UserErrorRestoreFailurePreviousObjectReplicationPolicyNotDeleted
329+
330+
**Error code**: `UserErrorRestoreFailurePreviousObjectReplicationPolicyNotDeleted`
331+
332+
**Error message**: Failed to restore the backup instance because an object replication policy from a previous restore is still on the restore target storage account
333+
334+
**Recommended action**: Remove the old object replication policy from the restore target and retry.
335+
336+
### UserErrorKeyVaultKeyWasNotFound
337+
338+
**Error code**: `UserErrorKeyVaultKeyWasNotFound`
339+
340+
**Error message**: Operation failed because key vault key is not found to unwrap the encryption key.
341+
342+
**Recommended action**: Check the key vault settings.
343+
344+
### UserErrorInvalidResourceUriInRequest
345+
346+
**Error code**: `UserErrorInvalidResourceUriInRequest`
347+
348+
**Error message**: Operation failed due to invalid Resource Uri in the request.
349+
350+
**Recommended action**: Fix the Resource Uri format in the request object and trigger the operation again.
351+
352+
### UserErrorDatasourceAndBackupVaultLocationMismatch
353+
354+
**Error code**: `UserErrorDatasourceAndBackupVaultLocationMismatch`
355+
356+
**Error message**: Operation failed because the datasource location is different from the Backup Vault location.
357+
358+
**Recommended action**: Ensure that the datasource and the Backup Vault are in the same location.
359+
360+
### LinkedAuthorizationFailed
361+
362+
*Error code**: `LinkedAuthorizationFailed`
363+
364+
**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].
365+
366+
**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.

0 commit comments

Comments
 (0)