工作簿和图表 API 的错误代码

本文介绍通过这些 API 发送的请求失败时,Microsoft Graph 中的工作簿和图表 API 返回的错误代码。 有关在 Microsoft Graph 中处理工作簿和图表 API 的错误响应的详细信息,请参阅 Microsoft Graph 中 Excel API 的错误处理。 有关 Microsoft Graph 中的错误响应和资源类型的详细信息,请参阅 Microsoft Graph 错误响应和资源类型

错误代码和消息

下表列出了当前的错误代码和消息。 该服务可能随时添加新错误代码。

状态代码 错误代码 错误消息
400 badRequest 该请求格式有误或不正确。
401 unauthorized 调用方未进行身份验证。
403 forbidden 调用方没有执行该操作的权限。
404 notFound 找不到资源。
405 methodNotAllowed 资源上不允许使用请求中的 HTTP 方法。
409 conflict 当前状态与请求预期的状态的冲突。
413 payloadTooLarge 请求的大小超出最大限制。
429 tooManyRequests 应用或用户已被限制。
500 internalServerError 处理请求时发生内部服务器错误。
501 notImplemented 所请求的功能未实现。
502 badGateway 服务器遇到临时错误,无法完成请求。
503 serviceUnavailable 该服务不可用。 请重试请求。
504 gatewayTimeout 服务器在充当代理时,未及时收到来自上游服务器的响应以完成请求。

详细的错误代码

以下是应用在第一级嵌套 的 innerError 对象中可能会遇到的必需错误代码。 该服务可能随时添加新错误代码。

  • accessConflict
  • badRequestUncategorized
  • conflictUncategorized
  • forbiddenUncategorized
  • gatewayTimeoutUncategorized
  • internalServerErrorUncategorized
  • invalidSessionAccessConflict
  • invalidSessionAuthentication
  • invalidSessionNotFound
  • invalidSessionReCreatable
  • invalidSessionRestricted
  • invalidSessionUnexpected
  • invalidSessionUnsupportedWorkbook
  • methodNotAllowedUncategorized
  • notFoundUncategorized
  • notImplementedUncategorized
  • payloadTooLargeUncategorized
  • serviceUnavailableUncategorized
  • tooManyRequestsUncategorized
  • transientFailure
  • unauthorizedUncategorized
  • unsupportedWorkbook

有关嵌套 innerError 对象的第一级中的可选错误代码的示例,请参阅 可选的第二级错误代码示例

注意

innerError 对象可能以递归方式包含更深的 innerError 对象,并带有其他更具体的错误代码。 这些更深的 innerError 代码仅用于诊断目的。