本文介绍通过这些 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 对象的第一级中的可选错误代码示例,请参阅 可选的二级错误代码示例。
Note: innerError 对象可能以递归方式包含更深的 innerError 对象,并包含其他更具体的错误代码。 这些更深入的 innerError 代码仅用于诊断目的。
另请参阅
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 grangeryy)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
