Коды ошибок для API OneNote в Microsoft Graph
В этой статье описываются коды ошибок, которые 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 игнорирует тег изображения .
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 или объект, сделайте его прямым дочерним элементом тела; В противном случае параметры позиции игнорируются, а его содержимое отрисовывается в абсолютном расположении div. См. статью Создание элементов с абсолютным положением.
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
Источник видео, указанный в запросе, не поддерживается. См. актуальный список поддерживаемых сайтов с видео.
20266
Для этого запроса превышено максимальное число разделов. Чтобы получить страницы для учетных записей с большим количеством разделов, рекомендуется получать страницы для одного раздела за раз (используйте API страниц списка ).
Коды от 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
Контейнер уже используется другим ресурсом.