Ограничения API соединителей Microsoft Graph

  • Статья

В этой статье описаны реализация и эксплуатационные ограничения для соединителей Microsoft Graph. При разработке соединителей помните об этих ограничениях.

Ограничения подключений

Тип ограничения Ограничение
Ресурсы подключения для каждого клиента Microsoft 365 30
Элементов на соединение 5 000 000
Размер соединения в байтах 500 ГБ
Элементы на клиента 50,000,000

Ограничения схемы

Тип ограничения Ограничение
Свойства, которые можно определить в схеме, характеризующие данные, получаемые через соединение. 128

Ограничения для групп

Тип ограничения Ограничение
Внешние группы на каждого клиента Microsoft 365 100,000
Разрешенные запросы в секунду (запросы/сек) в пороге регулирования количества запросов группового администрирования 1 000
Внешние группы на пользователя для поискового запроса 10,000

Прием элементов

Тип ограничения Ограничение
Ограничение пропускной способности для приема элементов через соединение 25 элементов/с
Размер элемента; это ограничение применяется к телу запроса при приеме и индексировании элемента. 4 МБ
Количество мероприятий; это пороговое значение регулирования для каждого вызова действий 20 мероприятий
Размер свойства Недоступно

Примечание: Ограничение на размер элемента в 4 МБ относится к общему размеру проанализированного текстового содержимого , который обычно составляет 10 % от исходного размера файла для распространенных форматов (например, docx, ppt и PDF). Для контекстуализации 4 МБ равно 4 000 000 байт, что переводится примерно в 600–700 тыс. слов или 1400 страниц (в среднем 500 слов на страницу).

Регулирование

При превышении порогового значения регулирования Microsoft Graph ограничивает все дальнейшие запросы от этого клиента на определенный период времени. При регулировании Microsoft Graph возвращает код состояния HTTP 429 (слишком много запросов), и запросы завершаются ошибкой. Рекомендуемое время ожидания возвращается в заголовке ответа неудачного запроса.

Поведение регулирования может зависеть от типа и количества запросов. Например, если у вас большой объем запросов, все типы запросов регулируются. Пороговые ограничения зависят от типа запроса. Таким образом, можно столкнуться с сценарием, в котором запись регулируется, но чтение по-прежнему разрешено.