Коды ошибок для API OneNote в Microsoft Graph

Статья
03/26/2023

В этой статье описываются коды ошибок, возвращаемые API OneNote в Microsoft Graph при сбое запроса, отправляемого через API.

Пример ответа об ошибке

Если при отправке запроса возникает ошибка, API OneNote перестает выполнять запрос и возвращает ответ об ошибке в виде объекта 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

API OneNote не удалось создать страницу в указанном разделе, потому что раздел поврежден.

10007

Сервер слишком занят, чтобы обработать входящий запрос в данный момент. Повторите попытку позже.

10008

Одна или несколько библиотек документов в хранилище OneDrive пользователя или группы содержит более 5000 элементов OneNote (записных книжек, разделов, групп разделов), и к ней невозможно отправлять запросы с помощью 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

В запросе отсутствует необходимый раздел Presentation. Он должен быть только один.

20002

Запрос содержит две или более части Presentation. Он должен быть только один.

20003

В разделе Presentation допускаются только типы контента text/HTML и application/XHTML+XML.

20004

HTML-код раздела Presentation содержит тег image, в котором заданы свойства src и data-render-src. API проигнорирует свойство src и будет использовать свойство data-render-src.

20005

URI запроса слишком длинный. Максимальный размер URI (включая все параметры и данные) составляет 16 КБ или 16 384 символов.

20006

HTML-код раздела Presentation содержит тег image, в котором не заданы свойства src и data-render-src. API проигнорирует тег image.

20007

HTML-код раздела Presentation содержит строку даты и времени создания, которая не соответствует ни одному из допустимых форматов.

20008

Размер запроса превышает допустимый.

20009

Запрос содержит разделы с повторяющимися именами. Имена разделов должны быть уникальными.

20010

Для указанного типа контента не предоставлен заголовок Content-Disposition.

20011

Запрос содержит составные полезные данные неправильного формата. К возможным причинам этой ошибки относятся пустые строки, отсутствие последней строки, неправильно отформатированные разделители частей и т. д. Если вы создаете составное сообщение вручную, внимательно проверьте логику или используйте стороннюю библиотеку.

20012

В запросе не предоставлен тип контента для указанной части.

20013

В запросе не предоставлены заголовки Content-Type и Content-Disposition для указанной части.

20014

Длина части составного сообщения превышает максимальную (25 МБ).

20015

Количество частей составного сообщения превышает максимальное (500).

20016

Длина составного сообщения превышает максимальную (75 МБ).

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

Для запросов на создание страниц с частями данных необходимо составное содержимое с разделом Presentation.

20111

В запросе используется неподдерживаемая функция OData.

20112

Запрос содержит недопустимый идентификатор для целевой сущности записной книжки, группы разделов, раздела или страницы.

20113

Ресурс, заданный в запросе, был удален.

20115

Имя содержит недопустимые символы. Имя записной книжки не может содержать следующие символы: ? * \ / : < > | ' "

20117

Элемент с таким именем уже существует в указанном месте.

20119

HTML-код в разделе Presentation содержит атрибут data-attachment, который либо неправильно отформатирован либо содержит какие-либо из следующих недопустимых символов для имени файла: \ / : * ? < > | ". Запрос заменил значение, указанное в сообщении об ошибке.

20120

В запросе указан целевой объект операции PATCH, который не удается найти.

20121

Запрос содержит недопустимый аргумент PATCH. См. статью Обновление содержимого страницы.

20122

Запрос указывает неподдерживаемое действие PATCH. См. статью Обновление содержимого страницы.

20123

PATCH-запросу не удается изменить указанную страницу.

20124

Составной запрос PATCH не содержит раздела commands со структурой JSON действия PATCH. См. статью Обновление содержимого страницы.

20125

Запрос PATCH не содержит действий. См. статью Обновление содержимого страницы.

20126

Текст сообщения содержит неправильно отформатированный JSON или поля, неподдерживаемые для этой операции.

20127

Запрос указывает имя неизвестного свойства.

20128

Запрос содержит ошибку синтаксиса OData в месте, указанном в сообщении.

20129

Запрос содержит параметр строки запроса top со слишком большим значением. Для запросов страниц максимальное значение составляет 100, а значение по умолчанию — 20.

20130

Запрос содержит URI, указывающий на HTTP-ресурс, который не удается найти.

20131

Запрос содержит недопустимое значение Content-Type. Используйте значение, указанное в сообщении.

20132

Запрос содержит недопустимый контент. Распространенные причины этой проблемы — отсутствие заголовка запроса Content-Type и/или отсутствие содержимого в теле запроса.

20133

В запросе указан неподдерживаемый целевой объект операции PATCH. См. статью Обновление содержимого страницы.

20134

Запрос указывает недопустимый элемент в качестве целевого объекта действия PATCH. Если целевой объект использует идентификатор data-id , убедитесь, что он имеет префикс символа #. См. статью Обновление содержимого страницы.

20135

В запросе указан тип объекта, не поддерживаемый для операции PATCH. См. статью Обновление содержимого страницы.

20136

Запрос содержит недопустимый атрибут data-render-src или data-render-method, либо этот атрибут отсутствует. См. статью Извлечение данных из записей.

20137

Конечная страница не поддерживает PATCH-запросы.

20138

Тип целевого элемента в запросе PATCH не поддерживает действие добавления . См. статью Обновление содержимого страницы.

20139

Запрос содержит недопустимое значение атрибута data-tag . См. статью Использование тегов заметок.

20140

Запрос содержит недопустимое значение состояния data-tag. Теги заметок для флажков могут находиться в состоянии completed.

Пример.

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

См. статью Использование тегов заметок.

20141

Целевой объект в запросе PATCH не поддерживает указанное действие. См. статью Обновление содержимого страницы.

20142

Запрос содержит выражение expand для родительского объекта дочерних сущностей или дочернего объекта родительских сущностей. Такие выражения не поддерживаются. См. раздел Поддерживаемые параметры строки запроса OData.

20143

Недопустимый запрос OData.

20144

Запрос содержит выражение expand для свойства, не связанного с навигацией. Расширять можно только свойства навигации.

20145

Запрос содержит выражение select или expand с недопустимым термином.

20146

Для элемента указан атрибут style="position:absolute", но в элементе body не указан атрибут data-absolute-enabled="true", необходимый для поддержки позиционирования. Все параметры положения будут игнорироваться. См. статью Создание элементов с абсолютным положением.

20147

Атрибут style="position:absolute" указан для элемента, не являющегося непосредственным дочерним объектом элемента body. Этот атрибут не поддерживается для таких элементов. Если это элемент div, img или object, сделайте его непосредственным дочерним объектом основного текста. В противном случае параметры положения будут проигнорированы, а содержимое будет отображаться внутри разделителя с абсолютным положением. См. статью Создание элементов с абсолютным положением.

20148

Атрибут style="position:absolute" указан для элемента, тип которого не поддерживает этот атрибут. Позиционирование поддерживается только для элементов div, img и object, являющихся непосредственными дочерними элементами основного текста. См. статью Создание элементов с абсолютным положением.

20149

Запрос указывает целевой элемент, который не удается найти.

20150

Недопустимый запрос для этого типа проверки подлинности. Используйте путь ../me/onenote/.

20151

Недопустимый запрос для этого типа проверки подлинности. Используйте конечную точку ../me/onenote/section/{id}/pages, чтобы создать страницу в определенном разделе.

20152

Не указано значение name для элемента. Имя должно быть определено, и оно не может содержать только пробелы.

20153

Имя объекта содержит недопустимые символы. Имя не может содержать следующие символы: ? * \ / : < > | & # " % ~

20154

Имя объекта не может начинаться с пробела.

20155

Слишком длинное имя объекта. Максимальная длина для имен записных книжек составляет 128 символов. Максимальная длина имен других объектов составляет 50 символов.

20156

Указанный идентификатор ресурса назначения не существует.

20157

Указан недопустимый идентификатор объекта назначения.

20158

Не удалось получить метаданные для URL-адреса сайта, указанного в запросе. Проверьте формат предоставленного URL-адреса. К поддерживаемым форматам относятся https://domain.sharepoint.com/site-a и https://domain.com/sites/site-a.

20160

Не удается найти единую группу Office 365 с указанным ИД.

20161

В контексте не указан действительный ИД пользователя. Одна из распространенных ошибок — передача PUID/CID в виде значения типа long, а не hex.

20166

Приложение отправило слишком много запросов от имени пользователя за короткий период времени. Чтобы гарантировать стабильность и оперативность работы API OneNote, API возвращает код состояния 429 и это сообщение об ошибке, если обнаруживается, что приложение использует слишком много ресурсов.

Дополнительные сведения см. в руководстве по регулированию для служб Microsoft Graph.

20168

Источник видео, указанный в запросе, не поддерживается. См. актуальный список поддерживаемых сайтов с видео.

Коды от 30001 до 39999

Что-то не так с учетной записью пользователя.

30101

Для учетной записи пользователя превышена квота OneDrive. См. страницу OneDrive.

30102

В запрошенные раздел невозможно что-либо добавить, так как он достиг своего максимального размера.

30103

Для выполнения запроса используется слишком много ресурсов. Либо целевая учетная запись пользователя содержит слишком большой набор данных, либо служба получает слишком много одновременных запросов для одного сайта (например, личного сайта пользователя или сайта группы).

30104

Работа учетной записи пользователя была приостановлена.

30105

Личный сайт пользователя в OneDrive для бизнеса не подготовлен к работе. Это необходимо для доступа к записным книжкам. Служба OneNote подготовит сайт к работе. Этот процесс может занять несколько минут.

30106

OneDrive для бизнеса подготавливается к работе для пользователя.

30108

Не удалось получить личное хранилище пользователя в OneDrive для бизнеса. В приведенной ниже таблице перечислены некоторые возможные причины.

Причина	Решение
Личный сайт пользователя не подготовлен к работе.	Пользователь должен открыть OneDrive для бизнеса и следовать указаниям по подготовке сайта к работе. В случае сбоя следует обратиться к администратору клиента Microsoft 365.
В данный момент личный сайт пользователя подготавливается к работе.	Попробуйте отправить запрос позже.
У пользователя нет действительной лицензии на OneDrive для бизнеса.	Пользователю следует обратиться к администратору клиента Microsoft 365.
Не удается отправить запрос из-за проблем с сетью.	Попробуйте отправить запрос позже.

30109

Некоторые пользователи, указанные в запросе, не существуют.

30110

Для этого клиента не зарегистрированы службы сведений об учащихся.

30111

Возникла общая ошибка служб сведений об учащихся.

30112

Запрос влияет на нескольких пользователей с одинаковыми именами.

30113

Для записной книжки не разрешены приглашения.

30114

Отсутствует обязательный параметр.

Коды от 40001 до 49999

У пользователя или приложения нет необходимых разрешений.

40001

Запрос не содержит действительный маркер OAuth. См. раздел Разрешения для заметок.

40002

У пользователя нет разрешения на запись в указанном расположении.

40003

У пользователя нет разрешения на доступ к запрашиваемому ресурсу.

40004

Область действия маркера OAuth недостаточна для выполнения запрашиваемого действия. См. раздел Разрешения для заметок.

40006

Область действия маркера OAuth недостаточна для выполнения запрашиваемого действия. В частности, это относится к разрешению на редактирование. См. раздел Разрешения для заметок.

40007

У пользователя нет разрешений на доступ к этому ресурсу.

40008

Доступ к этому ресурсу запрещен.

40009

Контейнер уже используется другим ресурсом.