使用英语阅读

通过


Microsoft Graph 中 OneNote API 的错误代码

本文介绍当通过 API 发送的请求失败时,Microsoft Graph 中的 OneNote API 返回的错误代码。

错误响应示例

请求生成错误时,OneNote API 将停止执行此请求并将错误响应作为 JSON 对象返回。 错误响应将包含相关的错误代码、消息和本文相应部分的链接。 以下示例演示了错误响应的外观。

{
   "error":{
      "code":"10002",
      "message":"The service is currently unavailable. Please try again later.",
      "innerError": {
        "requestId": "request-id",
        "date": "date-time"
      }
   }
}

有关 Microsoft Graph 错误的详细信息,请参阅 Microsoft Graph 错误响应和资源类型

从 10001 到 19999 的代码

服务遇到问题,或向应用程序发送信息。

10001

出现意外错误,请求失败。

10002

服务当前不可用。

10003

当前用户的帐户超出了活动请求的最大数目。 应用需要重复该请求。

10004

服务无法在请求的部分创建页面,因为该部分受密码保护。

10005

请求包含超过最大数量的图像标记,其中 data-render-src 属性包含 PDF。 请参阅添加图像和文件

10006

OneNote API 程序无法在指定部分创建页面,因为该部分已损坏。

10007

服务器太忙,目前无法处理传入的请求。 请稍后重试。

10008

用户或组的 OneDrive 上的一个或多个文档库包含的 OneNote 项目数(笔记本、分区、分区组)超过 5000 个,无法使用 API 查询。 确保用户或组的文档库不包含超过 5000 个 OneNote 项。 请参阅 OneNote 开发博客获取缓解步骤。

10012

无法创建或更新实体,因为包含笔记本的库要求先将项目签出然后才能编辑这些项。 有关详细信息,请参阅设置库以请求签出文件

可从库中删除签出要求,也可以移动笔记本。

10013

用户或组的 OneDrive 上的一个或多个文档库包含的项目数超过 20,000 个,无法使用 API 编制索引用于查询。 确保用户或组的文档库不包含超过 20,000 项。 请参阅 OneNote 开发博客获取缓解步骤。

10014

Azure Key Vault 太忙,目前无法处理传入的请求。 请稍后重试。

10015

SharePoint 当前不可用。 请稍后重试。

10016

用户或组的 OneDrive 上的文档库超出了唯一安全范围阈值限制。 为库设置的唯一安全作用域的最大数量不能超过 50,000 个。

10017

错误的请求。

19999

请求失败,因为发生无法确定的错误。

从 20001 到 29999 的代码

应用程序代码出错。

20001

请求缺少必需的“演示”部分。 只需要一个。

20002

请求包含两个或更多个“演示”部分。 只需要一个。

20003

“演示”部分的内容类型只能是文本/HTML 或应用程序/XHTML+XML。

20004

“演示”部分 HTML 包含同时设置了 srcdata-render-src 属性的图像标记。 API 忽略 src 属性并使用 data-render-src 属性。

20005

请求 URI 太长。 URI 的最大大小(包括所有参数和数据)为 16 KB 或 16,384 个字符。

20006

“演示”部分 HTML 包含未设置 src 和 data-render-src 属性的图像标记。 API 忽略 映像 标记。

20007

“演示文稿”部分 HTML 包含与任何允许的格式均不匹配的创建日期/时间字符串。

20008

请求大小太大。

20009

请求包含使用重复名称的部分。 部分名称必须是唯一的。

20010

未提供指定内容类型的内容处置标头。

20011

请求包含格式错误的多部分有效负载。 问题可能包括缺少空行、缺少末行、部分分隔符格式不正确等。 如果正在手动生成多部分消息,请仔细检查逻辑,或者考虑使用第三方库。

20012

请求未提供指定部分的内容类型。

20013

请求未提供指定部分的内容类型和内容处置标头。

20014

多部分消息中的某个部分的长度超过最大大小 25 MB。

20015

多部分消息中的部分计数超过 500 个的限制。

20016

多部分消息的长度超过 75 MB 的限制。

20017

电子邮件 MIME 格式不正确。

20018

会议 MIME 或 ICal 格式不正确。

20019

找不到 ICal。

20020

在请求正文中遇到格式不正确的 Json。

20100

请求的语法有问题。

20101

所请求的属性不存在。

20102

所请求的资源不存在。

20103

此请求不支持 expand 查询。 请参阅受支持的 OData 查询字符串选项

20104

仅当查询某个部分中的网页集或查询特定页时,才支持 pagelevel 查询选项。 例如:

GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true

20106

你的请求包含不受支持的查询运算符。

20108

您的请求包含不受支持的 OData 查询参数。

20109

PATCH 请求中的有效负载构建不正确。

20110

包含数据部分的页面创建请求要求内容为多部分,并包含“演示”部分。

20111

你的请求使用不受支持的 OData 功能。

20112

您的请求包含无效的目标笔记本、节组、节或页面实体 ID。

20113

请求中指定的资源已删除。

20115

名称包含无效字符。 笔记本名称中不能包含下列任意字符:? * \ / : < > | ' "

20117

在您指定的位置中已存在指定名称的项。

20119

“演示”部分的 HTML 包含一个 data-attachment 属性,该属性不为有效格式,或者包含一个或多个对文件名无效的字符:\ / : * ? < > | "。 请求替代了错误消息中指示的值。

20120

找不到你的请求指定的 PATCH 目标。

20121

您的请求包含无效的 PATCH 参数。 请参阅更新页面内容

20122

您的请求指定的 PATCH 操作不受支持。 请参阅更新页面内容

20123

PATCH 请求无法修改指定页面。

20124

你的多部分 PATCH 请求不包含使用 PATCH 操作 JSON 结构的“命令”部分。 请参阅更新页面内容

20125

您的 PATCH 请求不包含任何操作。 请参阅更新页面内容

20126

邮件正文包含格式错误的 JSON 或此操作不支持的字段。

20127

您的请求指定了未知属性的名称。

20128

您的请求在消息中指示的位置包含 OData 语法错误。

20129

你的请求包含值过高的 top 查询字符串选项。 对于页面查询,最大值为 100,默认值为 20。

20130

你的请求包含指向找不到的 HTTP 资源的 URI。

20131

你的请求包含无效的内容类型值。 请使用消息中指示的值。

20132

你的请求包含无效的内容。 此问题的常见原因是缺少内容类型请求标头和/或请求正文中没有内容。

20133

请求指定不支持的 PATCH 目标。 请参阅更新页面内容

20134

您的请求将无效元素指定为 PATCH 操作的目标。 如果目标使用 数据 ID 标识符,请确保在它前面加上 # 符号。 请参阅更新页面内容

20135

请求指定 PATCH 操作不支持的实体类型。 请参阅更新页面内容

20136

你的请求包含无效的 data-render-srcdata-render-method 属性或缺失这些属性。 请参阅从捕获内容中提取数据

20137

目标页面不支持 PATCH 请求。

20138

PATCH 请求中的目标元素类型不支持 append 操作。 请参阅更新页面内容

20139

您的请求包含无效的 data-tag 属性值。 请参阅使用笔记标记

20140

你的请求包含无效的 data-tag 状态值。 复选框笔记标记可以包含已完成状态。

示例:

    <p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>

请参阅使用笔记标记

20141

PATCH 请求中的目标不支持指定操作。 请参阅更新页面内容

20142

你的请求包含子实体的父级或父实体的子级(不支持)的 扩展 表达式。 请参阅受支持的 OData 查询字符串选项

20143

OData 查询无效。

20144

你的请求包含非导航属性的 expand 表达式。 只能扩展导航属性。

20145

你的请求中的 selectexpand 表达式包含无效条件。

20146

元素上指定了 style="position:absolute" 属性,但是 body 元素未指定支持定位所需的 data-absolute-enabled="true"。 将忽略所有的定位设置。 请参阅创建绝对定位的元素

20147

属性 style="position:absolute" 在不是 body 元素的直接子元素的元素上指定,不支持该元素。 如果元素是 divimg对象,则使其成为正文的直接子元素;否则,将忽略位置设置,其内容呈现在绝对定位 div 内。 请参阅创建绝对定位的元素

20148

在不支持 style="position:absolute" 属性的元素类型上指定了此属性。 仅属于页面正文直接子级的 divimg、和 object 元素支持定位。 请参阅创建绝对定位的元素

20149

您的请求指定的目标元素找不到。

20150

请求对于此身份验证类型无效。 请改用 ../me/onenote/ 路径。

20151

请求对于此身份验证类型无效。 请使用 ../me/onenote/section/{id}/pages 终结点在特定分区中创建页面。

20152

没有为实体指定任何 name 值。 必须定义名称,并且其中不能仅包含空格。

20153

实体名称包含无效字符。 名称中不能包含下列字符:? * \ / : < > | & # " % ~

20154

实体名称不能以空格开头。

20155

实体名称太长。 笔记本名称的字符数限制为 128 个。 其他实体名称的字符数限制为 50 个。

20156

目标资源的指定 ID 不存在。

20157

目标实体的指定 ID 无效。

20158

无法获取请求中指定的网站 URL 的元数据。 请检查所提供的 URL 的格式。 支持的格式包括 https://domain.sharepoint.com/site-ahttps://domain.com/sites/site-a

20160

找不到具有指定 ID 的 Office 365 统一组。

20161

此上下文没有指定有效的用户 ID。 一个常见错误是 PUID/CID 作为 long 而不是作为 hex 传入。

20166

应用程序在短时间内以用户身份发出的请求过多。 当 API 检测到应用程序使用的资源过多时,它会返回 429 状态代码和此错误,以帮助确保 OneNote API 保持稳定和可响应状态。

有关详细信息,请参阅 特定于 Microsoft Graph 服务的限制指南

20168

不支持请求中指定的视频源。 请参阅支持的视频网站获取最新列表。

20266

超出此请求的最大节数。 若要获取包含大量分区的帐户的页面,我们建议一次获取一个分区的页面, (使用 列表页 API) 。

从 30001 到 39999 的代码

用户的帐户有问题。

30101

用户帐户超出了其 OneDrive 配额。 请参阅 OneDrive

30102

不能再向请求的节添加任何内容,因为它已经达到其最大大小。

30103

此请求的资源消耗过高。 目标用户帐户的数据集过大或服务将过多数量的并发请求接收到同一个网站(例如,用户的个人网站或团队网站)。

30104

用户帐户已暂停。

30105

用户的个人 OneDrive for Business 网站未预配,这是访问笔记本所必需的。 OneNote 服务将立即设置此网站。 此进程可能需要几分钟。

30106

正在为用户设置 OneDrive for Business。

30108

无法检索用户的个人 OneDrive for Business。 下表列出了部分可能的原因。

原因 解决方案
尚未设置用户的个人网站。 用户应打开 OneDrive for Business,并按照任意说明设置此网站。 如果此操作失败,他们应联系其 Microsoft 365 租户管理员。
当前正在设置用户的个人网站。 稍后再尝试请求。
用户没有有效的 OneDrive for Business 许可证。 用户应联系其 Microsoft 365 租户管理员。
网络问题使请求无法成功发送。 稍后再尝试请求。

30109

请求中的某些用户不存在。

30110

此租户尚未注册学生信息服务。

30111

学生信息服务出现一般性错误。

30112

受请求影响的多个用户具有相同的用户名。

30113

笔记本未配置为允许邀请。

30114

缺少必需的参数。

从 40001 到 49999 的代码

用户或应用程序没有正确的权限。

40001

请求不包含有效的 OAuth 标记。 请参阅注释权限

40002

用户在所请求的位置没有写入权限。

40003

用户没有权限访问所请求的资源。

40004

OAuth 令牌没有所需的作用域来执行所请求的操作。 请参阅注释权限

40006

OAuth 令牌没有所需的作用域来执行所请求的操作。 尤其是编辑权限。 请参阅注释权限

40007

用户没有权限访问此资源。

40008

禁止访问此资源。

40009

容器已被其他资源使用。