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