通过

备份存储 API 错误响应

合作伙伴可以使用 Microsoft Graph 中的 Microsoft 365 备份 存储 API 来创建自己的应用程序来管理备份。 应用程序将成为部署应用程序的租户中的Microsoft 365 备份存储控制器。

除了适用于 Microsoft Graph 的 常规错误 外，某些错误条件特定于备份存储 API。 本主题提供使用备份存储 API 时可能遇到的常见错误条件的列表。

创建保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidCreateRequest 无法处理请求，因为它格式不正确或不正确。 创建请求为 null、无效或其大小过大。
400 InvalidDisplayName 当策略显示名称超过字符限制或为空/null 时引发。 请确保策略名称长度应为 > 0 个字符，且 <= 1024 个字符。
400 InvalidProtectionUnitId 当其中一个保护单元 ID 无效时引发。 保护单元 ID 无效。
413 ProtectionUnitsLimitBreached 当用户尝试添加的保护单元数超过一个请求中支持的单位数时引发。 每个请求中的保护单元数不得超过 50 个。
409 PolicyCreationNotAllowed 当服务已存在活动保护策略并且用户尝试创建新策略时引发。 无法创建策略。 另一个活动策略已存在。
409 ProtectionUnitAlreadyExists ArtifactId 不符合保护条件，因为它已在 policy PolicyId 下受到保护。 当项目已受到另一个策略的保护时引发。
500 PolicySaveFailed M365 备份服务中发生暂时性错误时引发。 出现未知错误。 请再试。

获取保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPolicyId 当请求中的策略 ID 无效、null 或空时引发。 策略 ID 无效。
404 PolicyNotFound 当 ID 有效但策略不存在时引发。 无法获取保护策略。

修补保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
200 ProtectionUnitNotFound 这是当用户请求删除保护单元时返回的增量修补程序 ProtectionUnit 级别错误，该服务中不存在此错误。 ProtectionUnit 级别错误：ProtectionUnit 不存在。
200 ProtectionUnitAlreadyExists ArtifactId 不符合保护条件，因为它已在 policy PolicyId 下受到保护。 当项目已受到另一个策略的保护时引发。
400 DuplicateProtectionUnitInList 这是当请求在列表中具有重复项目时返回的保护单元级别错误。 保护单元级别错误：列表中的保护单元重复。
400 ProtectionUnitActionNotAllowed 具有给定保护单元 ID 的项目无法删除，因为它受动态规则的保护。 无法手动删除通过动态规则保护的保护单元。
404 PolicyNotFound 当 ID 有效但策略不存在时引发。 无法获取保护策略。

删除非活动保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPolicyId 当请求中的策略 ID 无效、null 或空时引发。 策略 ID 不存在。
404 PolicyNotFound 当 ID 有效但策略不存在时引发。 找不到策略。
403 PolicyActionNotAllowed 当策略不处于非活动状态时引发。 无法删除策略。 只能删除处于非活动状态的策略。

停用主动保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPolicyId 当请求中的策略 ID 无效、null 或空时引发。 策略 ID 不存在。
403 PolicyActionNotAllowed 当策略不处于活动状态时引发。 策略状态不正确。 等待，直到它移动到活动状态。
404 PolicyNotFound 当 ID 有效但策略不存在时引发。 无法获取保护策略。

激活非活动保护策略 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPolicyId 当请求中的策略 ID 无效、null 或空时引发。 策略 ID 不存在。
403 PolicyActionNotAllowed 当策略不处于非活动状态时引发。 无法激活策略。 策略未处于正确状态。 确保策略处于非活动状态。
404 PolicyNotFound 当 ID 有效但策略不存在时引发。 无法获取保护策略。

列出保护策略 API 错误下的所有保护单元

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPolicyId 策略 ID 无效、null 或空。 策略 ID 无效。
400 FilterLengthExceeded 当客户端尝试在单个请求中同时发送过多的筛选器或查询（包括“和”和“或”筛选器查询）时，会发生此错误。 筛选器长度超出允许的限制。
400 InvalidProtectionUnitId 保护单元 ID 无效或 ID 为空。 保护单元 ID 无效。
404 PolicyNotFound 策略不存在或找不到。 无法获取保护策略。

获取保护单元 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
200 UnknownError 发生未知错误。 出现未知错误。 请重试。 如果问题仍然存在，请联系支持人员。
200 ProtectionUnitNotFound 保护单元不存在。 请求的保护单元不存在、已删除或找不到。 请重新检查保护单元 ID，然后重试。
200 InvalidArtifactId 保护单元 ID 无效或不存在。 找不到要删除的保护单元。
200 QuotaExceeded 超出备份大小配额 (专门针对 Exo) 。 已超出备份配额。
400 InvalidProtectionUnitId 保护单元 ID 无效或 ID 为空。 保护单元 ID 无效。

创建还原会话 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidPathType 路径类型 (新的/就地) 对于项目并不为人所知。 还原路径类型不存在。
400 InvalidArtifactRequest 空或 null 还原项目列表。 应至少有一个还原项目。
400 InvalidRestorePoint 提供的还原点无效。 还原点 ID 无效或为空。
400 DifferentRestoreDestinationType 请求中项目的不同目标类型。 不同的还原目标类型。
413 RestoreArtifactsLimitBreached 请求超出最大项目数限制。 已违反还原项目限制。
400 DuplicateArtifactInList 列表中的重复项目。 请求的还原项目已存在。

获取还原会话 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidRestoreSessionId 还原会话 ID 无效、null 或空。 还原会话 ID 不存在。
404 RestoreSessionNotFound 找不到有效 ID，但找不到会话。 找不到还原会话。

修补还原会话 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidRestoreSessionId 还原会话 ID 无效、null 或空。 还原会话 ID 不存在。
400 InvalidPatchRequest 无法处理请求，因为它格式不正确或不正确。 无法处理请求，因为它格式不正确或不正确。
400 InvalidRestorePoint 提供的还原点无效。 还原点无效。
400 RestoreArtifactsLimitBreached 超出了单个请求的最大项目数限制 50。 已违反还原项目限制。
400 InvalidArtifactRequest 空或 null 还原项目列表。 还原项目为 null。
403 RestoreSessionActionNotAllowed 尝试修补活动还原会话。 还原会话只能在草稿状态下进行修补。
404 RestoreSessionNotFound 找不到有效 ID，但找不到会话。 无法获取还原会话。
400 DuplicateArtifactInList 请求中的重复项目。 请求的还原项目已存在。

删除还原会话 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidRestoreSessionId 还原会话 ID 无效、null 或空。 RestoreSessionId 不存在。
403 RestoreSessionActionNotAllowed 尝试删除活动还原会话。 还原会话只能在草稿状态下删除。
404 RestoreSessionNotFound 找不到有效 ID，但找不到会话。 无法获取还原会话。
500 IncompleteArtifactDeletion 服务无法删除所有请求的项目。 无法删除会话，请重试。

激活还原会话 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidRestoreSessionId 还原会话 ID 无效、null 或空。 RestoreSessionId 不存在。
403 RestoreSessionActionNotAllowed 尝试激活活动还原会话。 还原会话只能在草稿状态下激活。
404 RestoreSessionNotFound 找不到有效 ID，但找不到会话。 无法获取还原会话。
500 TooManyActiveRestoreSessions 尝试同时激活超过 25 个会话。 临时错误：活动还原会话过多。

列出还原会话 API 错误下的还原项目

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
200 UnknownError 出现未知错误或提供程序端错误。 出现未知错误。 请重试。 如果问题仍然存在，请联系支持人员。
200 ArtifactNotFound 还原项目不存在。 找不到用于还原的请求还原项目。
200 InvalidRestoreTime 无效或超出边界的还原时间。 还原项目无法还原到此时间戳，提供的还原时间无效或超过保留期。
200 ArtifactCannotBeRestored 还原项目状态不允许还原。 还原项目处于意外状态，例如正在阻止还原的保留锁定或 TenantDivestiture。
200 DuplicateArtifactRestoreRequest 并发还原同一还原项目。 为给定的还原项目找到了正在进行的还原。 请等到完成，然后重试。
400 InvalidRestoreSessionId 还原会话 ID 无效、null 或空。 RestoreSession ID 无效。

创建包含规则 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleCreateRequest 无法处理请求，因为它格式不正确或不正确。 创建请求无效。
400 InvalidRuleExpression 值不能为 null 或无效表达式。 表达式无效，无法分析。
413 InvalidRuleExpressionGroupLimitExceeded 不允许包含超过 100 个组 ID 的规则表达式。 表达式包含的组 ID 数超过所施加的限制。

更新包含规则 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidProtectionRulePatchRequest 修补程序请求不支持 isAutoApplyEnabled 参数。 isAutoApplyEnabled 参数只能在创建时提供。 不允许在静态规则和动态规则之间进行转换，反之亦然。
400 InvalidProtectionRuleStatusForUpdation 不允许在当前状态下执行更新作。 用于调用更新作的无效状态。
400 InvalidRuleExpression 值不能为 null 或无效表达式 表达式无效，无法分析。
400 PatchNotAllowedForStaticRule 静态规则不允许执行修补作。 更新请求无效。
404 ProtectionRuleNotFound 不存在具有给定 ID 的保护规则。 给定的规则 ID 不正确，或者该规则已被删除。
413 InvalidRuleExpressionGroupLimitExceeded 不允许包含超过 100 个组 ID 的规则表达式。 表达式包含的组 ID 数超过所施加的限制。
422 InvalidProtectionRuleStatusForDynamicRuleEdit 不允许在当前状态下执行修补作。 不允许在 状态中 deleteRequested 执行修补作。

删除和取消保护包含规则 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleId 请求中的规则 ID 无效、null 或空。 规则 ID 无效。
404 ProtectionRuleNotFound 不存在具有给定 ID 的保护规则。 给定的规则 ID 不正确，或者该规则已被删除。
422 InvalidProtectionRuleStatusForDynamicRuleDeleteAndUnprotectAll 当前状态中不允许 deleteAndUnprotect 作。 用于调用 deleteAndUnprotect 作的无效状态。

运行包含规则 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleId 请求中的规则 ID 无效、null 或空。 规则 ID 无效。
400 ProtectionRuleActionNotAllowed 保护规则不允许运行作。 调用运行作的状态无效。
400 RunNotAllowedForDynamicRule 动态规则不允许运行作。 动态规则的作无效。
404 ProtectionRuleNotFound 不存在具有给定 ID 的保护规则。 给定的规则 ID 不正确，或者该规则已被删除。

按 ID API 错误获取包含规则

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleId 请求中的规则 ID 无效、null 或空。 规则 ID 无效。
404 ProtectionRuleNotFound 不存在具有给定 ID 的保护规则。 给定的规则 ID 不正确，或者该规则已被删除。

按 ID API 错误删除包含规则

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleId 请求中的规则 ID 无效、null 或空。 规则 ID 无效。
400 InvalidProtectionRuleStatusForDeletion 当前状态不允许执行删除作。 用于调用删除作的无效状态。
404 ProtectionRuleNotFound 不存在具有给定 ID 的保护规则。 给定的规则 ID 不正确，或者该规则已被删除。
422 InvalidProtectionRuleStatusForDynamicRuleDeletion 当前状态不允许执行删除作。 对动态规则调用删除作的无效状态。

获取还原点 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 FilterLengthExceeded 筛选器长度超出允许的限制。 筛选器长度超出允许的限制。
400 InvalidSearchRequest 请求的日期时间限制或保护单元 ID 无效。 还原点输入无效。
400 InvalidProtectionUnitId 请求中的保护单元 ID 无效。 保护单元 ID 无效。

启用服务 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
403 UnableToReadBillingProfile 无法从计费配置文件提供程序读取计费配置文件。 无法从计费配置文件提供程序读取计费配置文件。
402 InvalidBillingProfile 从提供商收到的计费配置文件无效。 从提供商收到的计费配置文件无效。
400 InvalidAppOwnerTenantId 找不到拥有租户 ID 从用户收到的应用所有者租户 ID 无效。

创建批量添加请求以还原项目 API 错误

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidBulkRestoreArtifactId 批量还原请求 ID 无效。 URI 中提供的 GUID 无效。
400 BulkRestoreInvalidCreateRequest BulkRestoreCreateRequest 为 null。 创建请求为 null 或无效。
400 BulkRestoreRestorationResourcesCountExceedsLimit 超出批量还原输入限制。 输入大小太大。
400 BulkRestoreInvalidCreateRequestSiteUrl 批量还原网站 URL 无效。 网站 URL 为 null、空或格式不正确。
400 BulkRestoreInvalidCreateRequestUserEmail 批量还原用户电子邮件无效。 Email为 null、空或格式不正确。

获取用于还原项目 API 错误的批量添加请求

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
404 BulkRestoreArtifactsNotFound 没有具有给定 bulkRestoreArtifactId 的 bulkRestoreArtifact 项。 没有与 URI 中提供的 bulkRestoreArtifactId 关联的 restoreArtifactBulkAdditionRequest。

删除用于还原项目 API 错误的批量添加请求

本部分中的错误代码适用于以下 API：

下表列出了可返回的可能错误和响应代码。

HTTP 状态代码 错误代码 错误消息 说明
403 InvalidStateForBulkRequestDeletion 当还原会话的服务类型和创建请求不同时，验证失败。 仅当批量请求的状态为 completed 或 completedWithErrors时，才能删除该请求。
  • Last updated on