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 错误响应和资源类型。
服务遇到问题,或向应用程序发送信息。
出现意外错误,请求失败。
服务当前不可用。
当前用户的帐户超出了活动请求的最大数目。 应用需要重复该请求。
服务无法在请求的部分创建页面,因为该部分受密码保护。
请求包含超过最大数量的图像标记,其中 data-render-src 属性包含 PDF。 请参阅添加图像和文件。
OneNote API 程序无法在指定部分创建页面,因为该部分已损坏。
服务器太忙,目前无法处理传入的请求。 请稍后重试。
用户或组的 OneDrive 上的一个或多个文档库包含的 OneNote 项目数(笔记本、分区、分区组)超过 5000 个,无法使用 API 查询。 确保用户或组的文档库不包含超过 5000 个 OneNote 项。 请参阅 OneNote 开发博客获取缓解步骤。
无法创建或更新实体,因为包含笔记本的库要求先将项目签出然后才能编辑这些项。 有关详细信息,请参阅设置库以请求签出文件。
可从库中删除签出要求,也可以移动笔记本。
用户或组的 OneDrive 上的一个或多个文档库包含的项目数超过 20,000 个,无法使用 API 编制索引用于查询。 确保用户或组的文档库不包含超过 20,000 项。 请参阅 OneNote 开发博客获取缓解步骤。
Azure Key Vault 太忙,目前无法处理传入的请求。 请稍后重试。
SharePoint 当前不可用。 请稍后重试。
用户或组的 OneDrive 上的文档库超出了唯一安全范围阈值限制。 为库设置的唯一安全作用域的最大数量不能超过 50,000 个。
错误的请求。
请求失败,因为发生无法确定的错误。
应用程序代码出错。
请求缺少必需的“演示”部分。 只需要一个。
请求包含两个或更多个“演示”部分。 只需要一个。
“演示”部分的内容类型只能是文本/HTML 或应用程序/XHTML+XML。
“演示”部分 HTML 包含同时设置了 src 和 data-render-src 属性的图像标记。 API 忽略 src 属性并使用 data-render-src 属性。
请求 URI 太长。 URI 的最大大小(包括所有参数和数据)为 16 KB 或 16,384 个字符。
“演示”部分 HTML 包含未设置 src 和 data-render-src 属性的图像标记。 API 忽略 映像 标记。
“演示文稿”部分 HTML 包含与任何允许的格式均不匹配的创建日期/时间字符串。
请求大小太大。
请求包含使用重复名称的部分。 部分名称必须是唯一的。
未提供指定内容类型的内容处置标头。
请求包含格式错误的多部分有效负载。 问题可能包括缺少空行、缺少末行、部分分隔符格式不正确等。 如果正在手动生成多部分消息,请仔细检查逻辑,或者考虑使用第三方库。
请求未提供指定部分的内容类型。
请求未提供指定部分的内容类型和内容处置标头。
多部分消息中的某个部分的长度超过最大大小 25 MB。
多部分消息中的部分计数超过 500 个的限制。
多部分消息的长度超过 75 MB 的限制。
电子邮件 MIME 格式不正确。
会议 MIME 或 ICal 格式不正确。
找不到 ICal。
在请求正文中遇到格式不正确的 Json。
请求的语法有问题。
所请求的属性不存在。
所请求的资源不存在。
此请求不支持 expand 查询。 请参阅受支持的 OData 查询字符串选项。
仅当查询某个部分中的网页集或查询特定页时,才支持 pagelevel 查询选项。 例如:
GET ../sections/{id}/pages?pagelevel=true
GET ../pages/{id}?pagelevel=true
你的请求包含不受支持的查询运算符。
您的请求包含不受支持的 OData 查询参数。
PATCH 请求中的有效负载构建不正确。
包含数据部分的页面创建请求要求内容为多部分,并包含“演示”部分。
你的请求使用不受支持的 OData 功能。
您的请求包含无效的目标笔记本、节组、节或页面实体 ID。
请求中指定的资源已删除。
名称包含无效字符。 笔记本名称中不能包含下列任意字符:? * \ / : < > | ' "
在您指定的位置中已存在指定名称的项。
“演示”部分的 HTML 包含一个 data-attachment 属性,该属性不为有效格式,或者包含一个或多个对文件名无效的字符:\ / : * ? < > | "
。 请求替代了错误消息中指示的值。
找不到你的请求指定的 PATCH 目标。
您的请求包含无效的 PATCH 参数。 请参阅更新页面内容。
您的请求指定的 PATCH 操作不受支持。 请参阅更新页面内容。
PATCH 请求无法修改指定页面。
你的多部分 PATCH 请求不包含使用 PATCH 操作 JSON 结构的“命令”部分。 请参阅更新页面内容。
您的 PATCH 请求不包含任何操作。 请参阅更新页面内容。
邮件正文包含格式错误的 JSON 或此操作不支持的字段。
您的请求指定了未知属性的名称。
您的请求在消息中指示的位置包含 OData 语法错误。
你的请求包含值过高的 top 查询字符串选项。 对于页面查询,最大值为 100,默认值为 20。
你的请求包含指向找不到的 HTTP 资源的 URI。
你的请求包含无效的内容类型值。 请使用消息中指示的值。
你的请求包含无效的内容。 此问题的常见原因是缺少内容类型请求标头和/或请求正文中没有内容。
请求指定不支持的 PATCH 目标。 请参阅更新页面内容。
您的请求将无效元素指定为 PATCH 操作的目标。 如果目标使用 数据 ID 标识符,请确保在它前面加上 # 符号。 请参阅更新页面内容。
请求指定 PATCH 操作不支持的实体类型。 请参阅更新页面内容。
你的请求包含无效的 data-render-src 或 data-render-method 属性或缺失这些属性。 请参阅从捕获内容中提取数据。
目标页面不支持 PATCH 请求。
PATCH 请求中的目标元素类型不支持 append 操作。 请参阅更新页面内容。
您的请求包含无效的 data-tag 属性值。 请参阅使用笔记标记。
你的请求包含无效的 data-tag 状态值。 复选框笔记标记可以包含已完成状态。
示例:
<p data-tag="to-do:completed">To-do note tag in completed state (checked box in the UI)</p>
请参阅使用笔记标记。
PATCH 请求中的目标不支持指定操作。 请参阅更新页面内容。
你的请求包含子实体的父级或父实体的子级(不支持)的 扩展 表达式。 请参阅受支持的 OData 查询字符串选项。
OData 查询无效。
你的请求包含非导航属性的 expand 表达式。 只能扩展导航属性。
你的请求中的 select 或 expand 表达式包含无效条件。
元素上指定了 style="position:absolute"
属性,但是 body 元素未指定支持定位所需的 data-absolute-enabled="true"
。 将忽略所有的定位设置。 请参阅创建绝对定位的元素。
属性 style="position:absolute"
在不是 body 元素的直接子元素的元素上指定,不支持该元素。 如果元素是 div、 img 或 对象,则使其成为正文的直接子元素;否则,将忽略位置设置,其内容呈现在绝对定位 div 内。 请参阅创建绝对定位的元素。
在不支持 style="position:absolute"
属性的元素类型上指定了此属性。 仅属于页面正文直接子级的 div、img、和 object 元素支持定位。 请参阅创建绝对定位的元素。
您的请求指定的目标元素找不到。
请求对于此身份验证类型无效。 请改用 ../me/onenote/
路径。
请求对于此身份验证类型无效。 请使用 ../me/onenote/section/{id}/pages
终结点在特定分区中创建页面。
没有为实体指定任何 name 值。 必须定义名称,并且其中不能仅包含空格。
实体名称包含无效字符。 名称中不能包含下列字符:? * \ / : < > | & # " % ~
实体名称不能以空格开头。
实体名称太长。 笔记本名称的字符数限制为 128 个。 其他实体名称的字符数限制为 50 个。
目标资源的指定 ID 不存在。
目标实体的指定 ID 无效。
无法获取请求中指定的网站 URL 的元数据。 请检查所提供的 URL 的格式。 支持的格式包括 https://domain.sharepoint.com/site-a
和 https://domain.com/sites/site-a
。
找不到具有指定 ID 的 Office 365 统一组。
此上下文没有指定有效的用户 ID。 一个常见错误是 PUID/CID 作为 long 而不是作为 hex 传入。
应用程序在短时间内以用户身份发出的请求过多。 当 API 检测到应用程序使用的资源过多时,它会返回 429 状态代码和此错误,以帮助确保 OneNote API 保持稳定和可响应状态。
有关详细信息,请参阅 特定于 Microsoft Graph 服务的限制指南。
不支持请求中指定的视频源。 请参阅支持的视频网站获取最新列表。
超出此请求的最大节数。 若要获取包含大量分区的帐户的页面,我们建议一次获取一个分区的页面, (使用 列表页 API) 。
用户的帐户有问题。
用户帐户超出了其 OneDrive 配额。 请参阅 OneDrive。
不能再向请求的节添加任何内容,因为它已经达到其最大大小。
此请求的资源消耗过高。 目标用户帐户的数据集过大或服务将过多数量的并发请求接收到同一个网站(例如,用户的个人网站或团队网站)。
用户帐户已暂停。
用户的个人 OneDrive for Business 网站未预配,这是访问笔记本所必需的。 OneNote 服务将立即设置此网站。 此进程可能需要几分钟。
正在为用户设置 OneDrive for Business。
无法检索用户的个人 OneDrive for Business。 下表列出了部分可能的原因。
原因 | 解决方案 |
---|---|
尚未设置用户的个人网站。 | 用户应打开 OneDrive for Business,并按照任意说明设置此网站。 如果此操作失败,他们应联系其 Microsoft 365 租户管理员。 |
当前正在设置用户的个人网站。 | 稍后再尝试请求。 |
用户没有有效的 OneDrive for Business 许可证。 | 用户应联系其 Microsoft 365 租户管理员。 |
网络问题使请求无法成功发送。 | 稍后再尝试请求。 |
请求中的某些用户不存在。
此租户尚未注册学生信息服务。
学生信息服务出现一般性错误。
受请求影响的多个用户具有相同的用户名。
笔记本未配置为允许邀请。
缺少必需的参数。
用户或应用程序没有正确的权限。
请求不包含有效的 OAuth 标记。 请参阅注释权限。
用户在所请求的位置没有写入权限。
用户没有权限访问所请求的资源。
OAuth 令牌没有所需的作用域来执行所请求的操作。 请参阅注释权限。
OAuth 令牌没有所需的作用域来执行所请求的操作。 尤其是编辑权限。 请参阅注释权限。
用户没有权限访问此资源。
禁止访问此资源。
容器已被其他资源使用。