对 Azure Blob 备份进行故障排除

本文提供故障排除信息以帮助你解决在使用 Azure 备份服务配置备份或还原 Azure Blob 时遇到的问题。

常见配置错误

UserErrorMissingRequiredPermissions

错误代码UserErrorMissingRequiredPermissions

错误消息:缺少执行操作的适当权限。

建议:确保已向你授予 适当权限

UserErrorUnsupportedStorageAccountType

错误代码UserErrorUnsupportedStorageAccountType

错误消息:不支持存储帐户类型进行备份。

建议:确保为备份选择的存储帐户受支持。 了解详细信息

UserErrorMaxOrsPolicyExistOnStorageAccount

错误代码UserErrorMaxOrsPolicyExistOnStorageAccount

错误消息:源存储帐户上存在最大对象复制策略。

建议:确保未达到存储帐户上支持的复制规则限制。

常见的备份或还原错误

UserErrorAzureResourceNotFoundByPlugin

错误代码UserErrorAzureResourceNotFoundByPlugin

错误消息:无法找到指定的 Azure 资源。

建议:对于备份操作,请确保为备份配置的源帐户有效且未删除。 对于还原,检查源存储帐户和目标存储帐户是否都存在。

UserErrorStorageAccountInLockedState

错误代码UserErrorStorageAccountInLockedState

错误消息:操作失败,因为存储帐户处于锁定状态。

建议:确保存储帐户上没有只读锁。 了解详细信息

UserErrorInvalidRecoveryPointInTime

错误代码UserErrorInvalidRecoveryPointInTime

错误消息:还原时间点无效。

建议:确保为还原提供的恢复时间存在且格式正确。

UserErrorInvalidRestorePrefixRange

错误代码UserErrorInvalidRestorePrefixRange

错误消息:用于项级别还原的还原前缀范围无效。

建议:如果备份服务无法破译为还原传递的前缀范围,可能会发生此错误。 确保为还原提供的前缀范围有效。

UserErrorPitrDisabledOnStorageAccount

错误代码UserErrorPitrDisabledOnStorageAccount

错误消息:存储帐户上已禁用所需的 PITR 设置。

建议:在存储帐户上启用还原点设置。 了解详细信息

UserErrorImmutabilityPolicyConfigured

错误代码UserErrorImmutabilityPolicyConfigured

错误消息:在阻止操作的一个或多个容器上配置不可变性策略。

建议:如果已在尝试还原的容器上配置不可变策略,可能会发生此错误。 需要删除不可变性策略或从还原意向中删除受影响的容器,然后重试该操作。 了解 如何删除解锁的策略

UserErrorRestorePointNotFound

错误代码UserErrorRestorePointNotFound

错误消息:还原点在备份保管库中不可用。

建议:确保还原点 ID 正确,并且不会根据备份保留设置删除还原点。 对于最近的恢复点,请确保相应的备份作业已完成。 建议使用有效的还原点再次触发操作。 如果问题持续出现,请联系 Microsoft 支持。

UserErrorContainerNotFoundForPointInTimeRestore

错误代码UserErrorContainerNotFoundForPointInTimeRestore

错误消息:针对所选时间点在存储帐户中找不到为还原选择的容器。

建议:对帐户中存在的容器使用特定的容器还原或前缀匹配还原。 我们还建议为存储帐户启用保管库备份,以便全面防止容器删除。 如果已进行配置,则可以使用恢复点来恢复所删除的容器。

UserErrorTargetContainersExistOnAccount

错误代码UserErrorTargetContainersExistOnAccount

错误消息:属于还原请求的容器不应存在于目标存储帐户上。

建议:确保目标存储帐户没有与正在尝试还原的名称相同的容器。 选择另一个存储目标,或者在删除同名容器后重试还原操作。

UserErrorBackupRequestThrottled

错误代码UserErrorBackupRequestThrottled

错误消息:备份请求受到限制,因为一天内已达到给定备份实例上的最大备份数限制。

建议:等待一天,然后触发新的备份操作。

UserErrorRestorePointNotFoundInBackupVault

错误代码UserErrorRestorePointNotFoundInBackupVault

错误消息:备份保管库中找不到还原点。

建议:确保还原点 ID 正确,并且不会根据备份保留设置删除还原点。 使用有效的还原点再次触发还原。

UserErrorOriginalLocationRestoreNotSupported

错误代码UserErrorOriginalLocationRestoreNotSupported

错误消息:保管库 Blob 备份不支持原始位置还原。

建议:选择备用目标存储帐户并触发还原操作。

UserErrorNoContainersSelectedForOperation

错误代码UserErrorNoContainersSelectedForOperation

错误消息:没有为操作选择任何容器。

建议:确保已提供要还原的有效容器列表。

UserErrorIncorrectContainersSelectedForOperation

错误代码UserErrorIncorrectContainersSelectedForOperation

错误消息:没有为操作选择任何容器。

建议:如果保护范围中包含的一个或多个容器不再存在于受保护存储帐户中,则可能会发生此错误。 建议在使用“编辑备份实例”选项修改受保护的容器列表后重新触发该操作。

UserErrorCrossTenantOrsPolicyDisabled

错误代码UserErrorCrossTenantOrsPolicyDisabled

错误消息:已禁用跨租户对象复制策略。

建议:在存储帐户上启用跨租户对象复制策略,并再次触发操作。 要检查此项,请转到“存储帐户”>“对象复制”>“高级设置”,并确保选中该复选框。

UserErrorPitrRestoreInProgress

错误代码UserErrorPitrRestoreInProgress

错误消息:当源帐户上正在进行还原时,无法执行该操作。

建议:完成正在进行的还原后,需要重新尝试该操作。

Azure Blob 保管库备份的常见错误

UserErrorInvalidParameterInRequest

错误代码UserErrorInvalidParameterInRequest

错误消息:请求参数无效。

建议操作:使用有效输入重试操作。

UserErrorRequestDisallowedByAzurePolicy

错误代码UserErrorRequestDisallowedByAzurePolicy

错误消息:资源上配置了 Azure Policy,阻止了此操作。

建议操作:更正策略并重试操作。

LongRunningRestoreTrackingFailure

错误代码LongRunningRestoreTrackingFailure

错误消息:无法跟踪长时间运行的还原操作。 该操作仍在运行,并有望完成数据还原。

建议操作:使用存储帐户的活动日志跟踪此操作的进一步进度,以便执行还原 blob 范围操作。

LongRunningBackupTrackingFailure

错误代码LongRunningBackupTrackingFailure

错误消息:无法跟踪长时间运行的备份操作。 该操作仍在运行,并有望完成数据备份。

建议操作:使用存储帐户的活动日志跟踪此操作的进一步进度,或检查 Blob 复制状态。

LongRunningOperationTrackingFailure

错误代码LongRunningOperationTrackingFailure

错误消息:无法跟踪长时间运行的操作。 该操作仍在运行,并有望完成。

建议操作:在存储帐户活动日志中跟踪此操作的进一步进度。

UserErrorVaultedBackupFeatureNotEnabled

错误代码UserErrorVaultedBackupFeatureNotEnabled

错误消息:必须为所需的功能注册订阅才能对 Blob 使用保管库备份。

建议操作:为 Microsoft.Storage/HardenBackup 和 Microsoft.DataProtection/BlobVaultedBackup 注册订阅。

ObjectReplicationPolicyCreationFailure

错误代码ObjectReplicationPolicyCreationFailure

错误消息:无法在存储帐户上创建对象复制策略。

建议操作:无法创建对象复制策略。 等候几分钟时间,并重试操作。 如果该问题仍然存在,请联系 Microsoft 支持部门。

UserErrorRequiredStorageFeaturesDisabled

错误代码UserErrorRequiredStorageFeaturesDisabled

错误消息:由于存储帐户上禁用了所需的存储功能,操作失败。

建议操作:在源存储帐户上启用 Azure 备份所需的功能。

UserErrorSelectedContainerPartOfAnotherORPolicy

错误代码UserErrorSelectedContainerPartOfAnotherORPolicy

错误消息:所选容器存在于另一个对象复制策略中。 给定容器每次只能属于一个 OR 策略。

建议操作:使用属于其他 OR 策略的容器。 或更改保护意向。

UserErrorTooManyRestoreCriteriaGivenForBlobRestore

错误代码UserErrorTooManyRestoreCriteriaGivenForBlobRestore

错误消息:还原请求中传递的容器数量超出了支持的上限。

建议操作:减少项目级还原请求中的容器数量以遵守限制。

UserErrorTooManyPrefixesGivenForBlobRestore

错误代码UserErrorTooManyPrefixesGivenForBlobRestore

错误消息:由于为容器提供了过多的 blob 前缀,还原操作失败

建议操作:限制每个容器的 blob 前缀数以降低此数量。

UserErrorStopProtectionNotSupportedForBlobOperationalBackup

错误代码UserErrorStopProtectionNotSupportedForBlobOperationalBackup

错误消息:操作层 Blob 备份不支持停止保护

建议操作:操作层 blob 备份不能是 stopped.up

UserErrorAzureStorageAccountManagementOperationLimitReached

错误代码UserErrorAzureStorageAccountManagementOperationLimitReached

错误消息:请求的操作由于 Azure 服务的限制而失败。 已达到 Azure 存储帐户管理列表的操作数量上限。

建议操作**&&:等待几分钟,然后重试操作。

UserErrorBlobVersionDeletedDuringBackup

错误代码UserErrorBlobVersionDeletedDuringBackup

错误消息:由于备份作业期间删除了一个或多个 Blob 版本,因此备份失败。

建议操作:建议在备份作业正在进行时避免篡改 Blob 版本。 确保为生命周期管理策略中的版本配置的最短保留期为 7 天。

UserErrorBlobVersionArchivedDuringBackup

错误代码UserErrorBlobVersionArchivedDuringBackup

错误消息:由于在备份作业持续时间内将一个或多个 Blob 版本移动到存档层,备份失败。

建议操作:建议在备份作业正在进行时避免篡改 Blob 版本。 确保为生命周期管理策略中的版本配置的最短保留期为 7 天

UserErrorBlobVersionArchivedAndDeletedDuringBackup

错误代码UserErrorBlobVersionArchivedAndDeletedDuringBackup

错误消息:由于在备份作业持续时间中将一个或多个 Blob 版本移动到存档层或删除一个或多个 Blob 版本,备份失败。

建议操作:建议在备份作业正在进行时避免篡改 Blob 版本。 确保为生命周期管理策略中的版本配置的最短保留期为 7 天。

UserErrorContainerHasImmutabilityPolicyDuringRestore

错误代码UserErrorContainerHasImmutabilityPolicyDuringRestore

错误消息:为还原选择的一个或多个容器具有不可变性策略。

建议操作:从容器中删除不可变性策略,然后重试操作。

UserErrorArchivedRecoveryPointsRequestedForRestore

错误代码UserErrorArchivedRecoveryPointsRequestedForRestore

错误消息:选择用于还原的一个或多个容器已存档还原点。

建议操作:为已存档的还原点解除冻结或从请求中删除包含已存档还原点的容器,然后重试该操作。

UserErrorObjectReplicationPolicyDeletionFailureOnRestoreTarget

错误代码UserErrorObjectReplicationPolicyDeletionFailureOnRestoreTarget

错误消息:无法删除还原目标存储帐户上的对象复制策略。

建议操作:检查资源锁是否阻止删除。 还原已成功,但在还原完成后,未清理还原操作期间创建的对象复制策略。 必须删除该策略,以避免将来的还原出现问题。

UserErrorRestoreFailurePreviousObjectReplicationPolicyNotDeleted

错误代码UserErrorRestoreFailurePreviousObjectReplicationPolicyNotDeleted

错误消息:无法还原备份实例,因为先前还原的对象复制策略仍在还原目标存储帐户上

建议操作:从还原目标中删除旧的对象复制策略,然后重试。

UserErrorKeyVaultKeyWasNotFound

错误代码UserErrorKeyVaultKeyWasNotFound

错误消息:操作失败,因为未找到用于解开加密密钥的密钥保管库密钥。

建议操作:检查密钥保管库设置。

UserErrorInvalidResourceUriInRequest

错误代码UserErrorInvalidResourceUriInRequest

错误消息:操作失败,因为请求中的资源 URI 无效。

建议操作:修复请求对象中的资源 URI 格式,并再次触发操作。

UserErrorDatasourceAndBackupVaultLocationMismatch

错误代码UserErrorDatasourceAndBackupVaultLocationMismatch

错误消息:操作失败,因为数据源位置与备份保管库位置不同。

建议操作:确保数据源和备份保管库位于同一位置。

LinkedAuthorizationFailed

错误代码*LinkedAuthorizationFailed

错误消息:具有对象 ID 的客户端 [user name] 有权针对 [vault name] 范围执行所需的 [operation name] 操作,但是,它没有针对链接范围 [datasource name] 执行 [operation name] 操作所需的权限。

建议操作:确保对与此备份实例关联的数据源具有读取访问权限,以便能够触发还原操作。 提供所需的权限后,请重试该操作。