本文介绍当通过这些 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 对象中可能会遇到的必需错误代码。 该服务可能随时添加新错误代码。
accessConflictbadRequestUncategorizedconflictUncategorizedforbiddenUncategorizedgatewayTimeoutUncategorizedinternalServerErrorUncategorizedinvalidSessionAccessConflictinvalidSessionAuthenticationinvalidSessionNotFoundinvalidSessionReCreatableinvalidSessionRestrictedinvalidSessionUnexpectedinvalidSessionUnsupportedWorkbookmethodNotAllowedUncategorizednotFoundUncategorizednotImplementedUncategorizedpayloadTooLargeUncategorizedserviceUnavailableUncategorizedtooManyRequestsUncategorizedtransientFailureunauthorizedUncategorizedunsupportedWorkbook
有关嵌套 innerError 对象的第一级中的可选错误代码的示例,请参阅 可选的第二级错误代码示例。
注意
innerError 对象可能以递归方式包含更深的 innerError 对象,并带有其他更具体的错误代码。 这些更深的 innerError 代码仅用于诊断目的。