通过

备份存储 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 当服务已存在活动保护策略并且用户尝试创建新策略时引发。 无法创建策略。 另一个活动策略已存在。
500 PolicySaveFailed M365 备份服务中发生暂时性错误时引发。 出现未知错误。 请再试。

获取保护策略 API 错误

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

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

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

修补保护策略 API 错误

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

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

HTTP 状态代码 错误代码 错误消息 说明
200 ProtectionUnitAlreadyExists 这是当请求在服务中已存在的列表中具有重复的保护单元时返回的增量修补程序 ProtectionUnit 级别错误。 ProtectionUnit 级别错误：ProtectionUnit 已存在。
200 ProtectionUnitNotFound 这是当用户请求删除保护单元时返回的增量修补程序 ProtectionUnit 级别错误，该服务中不存在此错误。 ProtectionUnit 级别错误：ProtectionUnit 不存在。
400 DuplicateProtectionUnitInList 这是当请求在列表中具有重复项目时返回的保护单元级别错误。 保护单元级别错误：列表中的保护单元重复。
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 无法处理请求，因为它格式不正确或不正确。 创建请求无效。

按 ID API 错误获取包含规则

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

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

HTTP 状态代码 错误代码 错误消息 说明
400 InvalidInclusionRuleId 请求中的规则 ID 无效、null 或空。 规则 ID 无效。

获取还原点 API 错误

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

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

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

启用服务 API 错误

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

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

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