Ограничения регулирования для служб, связанных с Microsoft Graph

Microsoft Graph позволяет получать доступ к данным в нескольких службах, таких как Outlook или Microsoft Entra ID. В этих службах применяются собственные ограничения, которые влияют на работу приложений, использующих Microsoft Graph для доступа к ним.

Любой запрос можно оценивать с учетом нескольких ограничений, в зависимости от области применения ограничения (для каждого приложения во всех клиентах, по клиенту для всех приложений, для каждого приложения по отдельному клиенту и т. д.), типа запроса (GET, POST, PATCH и т. д.) и других факторов. Первое достигнутое ограничение запускает действие регулирования. Помимо специальных ограничений для служб, описанных в этом разделе, применяются следующие глобальные ограничения:

Тип запроса Для каждого приложения во всех клиентах
Любой 130 000 запросов за 10 секунд

Примечание.

Описанные здесь отдельные ограничения могут изменяться.

В этом разделе термин клиент относится к организации Microsoft 365, в которой установлено приложение. Этот клиент может быть таким же, как и тот, в котором было создано приложение в случае одноклиентского приложения, или он может отличаться в случае многоклиентского приложения.

Ограничения службы заданий

Указанные ограничения применяются к запросам в API службы назначения.

Тип запроса Ограничение на приложение по клиенту Ограничение на клиента для всех приложений
Любой 500 запросов за 10 секунд 1000 запросов в 10 секунд
Любой 15 000 запросов за 3600 секунд 30 000 запросов за 3600 секунд
GET me/задание 50 запросов за 10 секунд 150 запросов за 10 секунд

Указанные выше ограничения действуют для следующих ресурсов:

ограничения службы Bookings

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

Ограничение Сфера применения
Четыре одновременных запроса Конечные точки версии 1.0 и бета-версии

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы облачного взаимодействия

Ресурс Ограничения для каждого приложения
Звонки 50 000 запросов за 15-секундный период на каждое приложение на клиент
Сведения о собрании 2000 собраний на пользователя в месяц
Присутствие 1500 запросов за 30-секундный период на каждое приложение на клиент
Виртуальное событие 10 000 запросов на приложение в месяц

Ограничения записей вызовов

Ограничения, перечисленные в следующей таблице, применяются к следующему ресурсу:

Тип ограничения Ограничение
На приложение для всех клиентов 15 000 запросов в 20 секунд
На клиента для всех приложений 10 000 запросов в 20 секунд
На приложение на клиент 1500 запросов за 20 секунд
Запись звонка 10 запросов в 20 секунд (первая страница)
50 запросов в 5 минут (последующие страницы)

Ограничения службы Excel

Объяснения и рекомендации, связанные с регулированием службы Excel, см. в статье Уменьшение ошибок регулирования. Кроме того, ниже приведены некоторые ограничения регулирования.

Тип запроса Ограничение на приложение для всех арендаторов Ограничение на приложение по клиенту
Любой 5000 запросов в течение 10 секунд 1500 запросов в течение 10 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы для образования

Тип запроса Ограничение на приложение для всех арендаторов Ограничение на приложение по клиенту
Любой 400 000 запросов за 20 секунд 35 000 запросов за 10 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы для файлов и списков

Ограничения службы для OneDrive, OneDrive для бизнеса и SharePoint Online см. в статье Как избежать регулирования или блокировки в SharePoint Online.

Сведения, приведенные в этой статье, относятся к следующим ресурсам:

Ограничения службы отчетов удостоверений и доступа

Тип запроса Ограничение на приложение по клиенту
Любой Пять запросов за 10 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Рекомендации по отчетам об идентификации и доступе

Microsoft Entra API отчетов регулируются, когда Microsoft Entra ID получает слишком много вызовов в течение заданного периода времени от клиента или приложения. Вызовы также могут регулироваться, если служба занимает слишком много времени, чтобы ответить. Если ваши запросы по-прежнему завершаются ошибкой с кодом ошибки 429 Too Many Requests, несмотря на то, что вы применяете лучшие методики регулирования, попробуйте сократить объем возвращаемых данных. Сначала попробуйте эти подходы:

  • Используйте фильтры, чтобы настроить запрос только на те данные, которые вам нужны. Если вам нужен только определенный тип события или подмножество пользователей, например, отфильтруйте другие события, используя параметры запроса $filter и $select, чтобы уменьшить размер объекта ответа и риск регулирования.
  • Если вам нужен широкий набор Microsoft Entra ID данных отчетов, используйте $filter параметр createdDateTime, чтобы ограничить количество событий входа, запрашиваемых в одном вызове. Затем выполните итерацию по следующему промежутку времени, пока не получите все необходимые записи. Например, при регулировании можно начать с вызова, который запрашивает данные в течение трех дней, и выполнять итерацию с более короткими интервалами времени, пока ваши запросы не будут регулироваться.

Ограничения службы удостоверения и доступа

Шаблон

Регулирование основано на алгоритме маркерной корзины, которая работает путем добавления отдельной стоимости запросов. Затем сумма затрат на запрос сравнивается с предопределенными ограничениями. Регулируются только запросы, превышающие ограничения. Если превышено какое-либо из ограничений, ответом будет 429 Too Many Requests. Можно получать 429 Too Many Requests ответы, даже если следующие ограничения не достигнуты в ситуациях, когда службы находятся под важной нагрузкой или на основе объема данных для конкретного клиента. В следующей таблице перечислены существующие ограничения.

Тип ограничения Квота единицы ресурса Квота на запись
пара "приложение + клиент" S: 3500 ResourceUnits в 10 секунд
M: 5000 ResourceUnits за 10 секунд
L: 8000 ResourceUnits за 10 секунд
3 000 запросов за 2 минуты 30 секунд
приложение 150 000 ResourceUnits за 20 секунд 35 000 запросов за 5 минут
клиент Неприменимо 18 000 запросов за 5 минут

Примечание.

Ограничение на количество пар приложение + клиент зависит от количества пользователей в запросах клиента. Размеры клиента определяются следующим образом: S — менее 50 пользователей, M — от 50 до 500 пользователей и L — более 500 пользователей.

Указанные выше ограничения действуют для следующих ресурсов:

В следующей таблице перечислены базовые стоимости запросов. У любых запросов, не указанных в списке, базовая стоимость равна 1.

Операция Путь запроса Базовая стоимость единицы ресурса Стоимость записи
GET applications 2 0
GET applications/{id}/extensionProperties 2 0
GET contracts 3 0
POST directoryObjects/getByIds 3 0
GET domains/{id}/domainNameReferences 4 0
POST getObjectsById 3 0
GET groups/{id}/members 3 0
GET groups/{id}/transitiveMembers 5 0
POST isMemberOf 4 0
POST me/checkMemberGroups 4 0
POST me/checkMemberObjects 4 0
POST me/getMemberGroups 2 0
POST me/getMemberObjects 2 0
GET me/licenseDetails 2 0
GET me/memberOf 2 0
GET me/ownedObjects 2 0
GET me/transitiveMemberOf 2 0
GET oauth2PermissionGrants 2 0
GET oauth2PermissionGrants/{id} 2 0
GET servicePrincipals/{id}/appRoleAssignments 2 0
GET subscribedSkus 3 0
GET users 2 0
GET Любой путь удостоверения, не указанный в таблице 1 0
POST Любой путь удостоверения, не указанный в таблице 1 1
PATCH Любой путь удостоверения, не указанный в таблице 1 1
PUT Любой путь удостоверения, не указанный в таблице 1 1
DELETE Любой путь удостоверения, не указанный в таблице 1 1

Важно!

Стоимость операций POST, PATCH и DELETE в пути запроса applications зависит от типа signInAudience. Для приложений, для которых signInAudience относится к AzureADMyOrg или AzureADMultipleOrgs, стоимость составляет 70 000 запросов за 5 минут; а для приложений, для которых signInAudience относится к AzureADandPersonalMicrosoftAccount или PersonalMicrosoftAccount, стоимость составляет 60 запросов за минуту.

Другие факторы, влияющие на стоимость запросов:

  • Использование $select снижает стоимость на 1
  • Использование $expand увеличивает стоимость на 1
  • Использование $top со значением меньше 20 снижает стоимость на 1
  • Создание пользователя в клиенте Microsoft Entra ID B2C увеличивает затраты на 4

Примечание.

Стоимость запроса никогда не может быть меньше 1. Любая стоимость запроса, применяемая к пути запроса, начинающегося с me/, также применяется к аналогичным запросам, начинающимся с users/{id | userPrincipalName}/.

Дополнительные заголовки

Заголовки запросов

  • x-ms-throttle-priority. Если заголовок не существует или для него задано другое значение, это означает, что это нормальный запрос. Рекомендуем присваивать приоритету значение high только для запросов, инициированных пользователем. Этот заголовок может иметь одно из следующих значений:
    • Low. Означает низкий приоритет запроса. Регулирование этого запроса не вызывает заметные для пользователя сбои.
    • Normal. Применяется по умолчанию, если значение не указано. Означает стандартный приоритет запроса.
    • High. Означает высокий приоритет запроса. Регулирование этого запроса вызывает заметные для пользователя сбои.

Примечание.

Если запросы будут регулироваться, запросы с низким приоритетом будут регулироваться первыми, запросы с нормальным приоритетом — вторыми, а запросы с высоким приоритетом — последними. Использование заголовка запроса с приоритетом не изменяет ограничения.

Обычные запросы откликов

  • x-ms-resource-unit. Указывает единицу ресурса, примененную для запроса. Значения: положительные целые числа.
  • x-ms-throttle-limit-percentage. Возвращается только в том случае, если приложение израсходовало более 0,8 от ограничения. Значения в диапазоне от 0,8 до 1,8, соответствующие проценту использования ограничения. Вызывающие могут использовать это значение для настройки оповещения и выполнения действий.

Регулируемые запросы откликов

  • x-ms-throttle-область, например Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b. Указывает область регулирования в следующем формате — <Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>:
    • Scope: (строка, обязательно)
      • Tenant_Application — все запросы определенного клиента для текущего приложения.
      • Tenant — все запросы для текущего клиента независимо от приложения.
      • Application — все запросы для текущего приложения.
    • Ограничение: (строка, обязательный)
      • Read. Запросы на чтение в области (GET)
      • Write. Запросы на запись в области (POST, PATCH, PUT, DELETE...)
      • ReadWrite. Все запросы в области (любые)
    • ApplicationId (GUID, обязательно)
    • TenantId|UserId|ResourceId: (GUID, обязательно)
  • x-ms-throttle-information. Указывает причину регулирования и может иметь любое значение (строка). Это значение предоставляется для диагностики и устранения неполадок. Вот несколько примеров:
    • CPULimitExceeded — регулирование вызвано превышением ограничения для выделения ЦП.
    • WriteLimitExceeded — регулирование вызвано превышением ограничения на запись.
    • ResourceUnitLimitExceeded — регулирование вызвано превышением ограничения для выделенного ресурса.

Ограничения службы операций с политикой данных удостоверений и доступа

Тип запроса Ограничение для каждого клиента
POST для exportPersonalData 1000 запросов в день для любой темы и 100 запросов в день
Любой другой запрос 10 000 запросов в час

Указанные выше ограничения действуют для следующих ресурсов:

Примечание.

Перечисленные ранее ресурсы не возвращают заголовок Retry-After в ответах 429 Too Many Requests.

Ограничения в отношении защиты удостоверений и службы условного доступа

Тип запроса Ограничение на клиента для всех приложений
Любой Один запрос в секунду

Примечание.

Перечисленные ранее ресурсы не возвращают заголовок Retry-After в ответах 429 Too Many Requests.

Ограничения службы поставщиков удостоверений

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
Любой 300 запросов в минуту 200 запросов в минуту

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы защиты информации

Указанные ниже ограничения применяются к любому запросу в /informationProtection.

Для электронной почты ресурс — это уникальная пара ИД сетевого сообщения и получателя. Например, отправка сообщения электронной почты с тем же идентификатором сообщения, отправленного одному и тому же человеку несколько раз в течение 15-минутного периода, активирует ограничение на ресурсы, указанное в следующей таблице. Однако каждые 15 минут (ограничение клиента) можно отправлять до 150 уникальных писем.

Операция Ограничение для каждого клиента Ограничение на ресурс (электронная почта, URL-адрес, файл)
POST 150 запросов за 15 минут и 10 000 запросов за 24 часа Один запрос за 15 минут и 3 запроса за 24 часа

Ограничения службы аналитики

Указанные ниже ограничения применяются к любому запросу в me/insights или users/{id}/insights.

Ограничение Сфера применения
10 000 запросов API за 10-минутный период Конечные точки версии 1.0 и бета-версии
Четыре одновременных запроса Конечные точки версии 1.0 и бета-версии

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы Android for Work в Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы приложений Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы аудита Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы книг Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы пакетов Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы синхронизации Chromebook Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы условий компании Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы настройки v2 устройств Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы настройки устройств Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы регистрации устройств Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы намерения устройств Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы устройств Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 400 запросов в течение 20 секунд 200 запросов в течение 20 секунд
Любое 4000 запросов в течение 20 секунд 2000 запросов в течение 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы защиты конечных точек Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы регистрации Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы GPAnalytics Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы управляемых приложений Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы уведомлений Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы ODJ Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы интеграции партнеров Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы Intune rbac

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы удаленного помощника Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы телефонии Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы Intune TEM

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы устранения неполадок Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы разблокировки Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы обновлений Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы WIP Intune

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы диспетчера приглашений

Указанные ниже ограничения применяются к любому запросу в /invitations.

Операция Ограничение на клиента для всех приложений
Любая операция 150 запросов за 5 секунд

Ограничения службы отчетов Microsoft 365

Указанные ниже ограничения применяются к любому запросу в /reports.

Операция Ограничение на приложение по клиенту Ограничение на клиента для всех приложений
Любой запрос (CSV) 14 запросов в течение 10 минут 40 запросов в течение 10 минут
Любой запрос (JSON, beta) 100 запросов в течение 10 минут н/д

Указанные выше ограничения применяются по отдельности к каждому API отчетов. Например, запрос к API отчетов о действиях пользователей Microsoft Teams и запрос к API отчетов о действиях пользователей Outlook в течение 10 минут считаются одним запросом из 14 для каждого API, а не двумя из 14 запросов для обоих API.

Указанные выше ограничения применяются к всем ресурсам отчетов об использовании.

Ограничения службы Microsoft Teams

Ограничения выражаются в виде запросов в секунду (RPS).

Тип запроса Teams Лимит на приложение на одного арендатора Ограничение на приложение для всех арендаторов
Команда GET 30 запросов в секунду 600 запросов в секунду
Канал GET 30 запросов в секунду 600 запросов в секунду
Вкладка GET для канала, чата 30 запросов в секунду 600 запросов в секунду
GET installedApps for chat, user, team 30 запросов в секунду 600 запросов в секунду
GET appCatalogs 30 запросов в секунду 600 запросов в секунду
Канал POST 30 запросов в секунду 300 запросов в секунду
Вкладка POST для канала или чата 30 запросов в секунду 300 запросов в секунду
POST установленные Приложения для чата, пользователя, команды 30 запросов в секунду 300 запросов в секунду
POST appCatalogs 30 запросов в секунду 300 запросов в секунду
Команда PATCH, канал, вкладка 30 запросов в секунду 300 запросов в секунду
Канал DELETE 15 запросов в секунду 150 запросов в секунду
Вкладка DELETE для чата, канала 15 запросов в секунду 150 запросов в секунду
DELETE установленные Приложения для чата, пользователя, команды 15 запросов в секунду 150 запросов в секунду
DELETE appCatalogs 15 запросов в секунду 150 запросов в секунду
GET /teams/{team-id}, joinedTeams 30 запросов в секунду 300 запросов в секунду
POST /teams 10 запросов в секунду 100 запросов в секунду
PUT /groups/{team-id}/team Шесть запросов в с 150 запросов в секунду
POST /{team-id}/ clone Шесть запросов в с 150 запросов в секунду
Сообщение канала GET 20 запросов в секунду 200 запросов в секунду
GET 1:1/групповое сообщение чата 20 запросов в секунду 200 запросов в секунду
Сообщение канала POST 50 запросов в секунду 500 запросов в секунду
СООБЩЕНИЕ POST 1:1/группового чата 20 запросов в секунду 200 запросов в секунду
GET /teams/{team-id}/schedule и все API по этому пути 30 запросов в секунду 600 запросов в секунду
POST /teams/{team-id}/schedule и все API по этому пути 30 запросов в секунду 300 запросов в секунду
PUT /teams/{team-id}/schedule и все API по этому пути 30 запросов в секунду 300 запросов в секунду
POST /teams/{team-id}/sendActivityNotification Пять запросов в минуту 50 запросов в секунду
POST /chats/{chat-id}/sendActivityNotification Пять запросов в минуту 50 запросов в секунду
POST /users/{user-id}/teamwork/sendActivityNotification Пять запросов в минуту 50 запросов в секунду
POST /teamwork/sendActivityNotificationToRecipients Два запросов в минуту 20 запросов в секунду
GET /teams/{team-id}/members 60 запросов в секунду 1200 о/с
GET /teams/{team-id}/channels 60 запросов в секунду 1200 о/с
GET /teams/{team-id}/channels/{channel-id}/members 60 запросов в секунду 1200 о/с
Получение всех сообщений канала для команды
GET teams/{team-id}/channels/getAllMessages
GET teams/{team-id}/channels/allMessages
200rps 1000rps
Получение всех сообщений чата для пользователя
GET users/{user-id}/chats/getAllMessages
GET users/{user-id}/chats/allMessages
200rps 1000rps
Другие вызовы API GET для Microsoft Teams 30 запросов в секунду 1500 запросов в секунду
Другие вызовы API для Microsoft Teams 30 запросов в секунду 300 запросов в секунду

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

При выполнении сообщения POST в заданном чате или канале можно отправить не более одного запроса в секунду (это ограничение регулирования не применяется к миграции).

См. Также ограничения Microsoft Teams и требования к опросу.

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы управления несколькими клиентами

Тип запроса Ограничение на клиента для всех приложений Ограничение на приложение по клиенту
POST, PUT, DELETE, PATCH 200 запросов за 20 секунд 100 запросов за 20 секунд
Любой 2000 запросов за 20 секунд 1000 запросов за 20 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы OneNote

Тип ограничения Ограничение по приложению на каждого пользователя (делегированный контекст) Ограничение по приложению (контекст "только для приложений")
Частота запросов 120 запросов в 1 минуту и 400 запросов в 1 час 240 запросов в 1 минуту и 800 запросов в 1 час
Параллельные запросы Пять одновременных запросов 20 параллельных запросов

Указанные выше ограничения действуют для следующих ресурсов:

Дополнительные сведения о рекомендациях см. в статье Регулирование в API OneNote и как его избежать.

Примечание.

Перечисленные ранее ресурсы не возвращают заголовок Retry-After в ответах 429 Too Many Requests.

Ограничения службы для открытых расширений и расширений схемы

Тип запроса Ограничение на приложение по клиенту
Любой 455 запросов в течение 10 секунд

Указанные выше ограничения действуют для следующих ресурсов:

Ограничения службы Outlook

Ограничения службы Outlook применяются к общедоступным и национальным облачным развертываниям.

Ограничения на сочетание идентификатора приложения и почтового ящика

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

Ограничение Сфера применения
10 000 запросов API в течение 10-минутного периода Конечные точки версии 1.0 и бета-версии
Четыре одновременных запроса Конечные точки версии 1.0 и бета-версии
Отправка 150 мегабайт (МБ) (PATCH, POST, PUT) за 5-минутный период Конечные точки версии 1.0 и бета-версии

Ресурсы службы Outlook

API Ресурсы
API поиска (предварительная версия)
  • Внешний элемент (Поиск Майкрософт)
  • API профиля
  • Фотография
  • API календаря
  • event
  • eventMessage
  • calendar
  • calendarGroup
  • outlookCategory
  • attachment
  • place (предварительный просмотр)
  • API почты
  • message
  • mailFolder
  • mailSearchFolder
  • messageRule
  • outlookCategory
  • attachment
  • API для управления личными контактами
  • contact
  • contactFolder
  • outlookCategory
  • Социальная и рабочая аналитика
  • person
  • API задач из списка дел (предварительная версия)
  • outlookTask
  • outlookTaskFolder
  • outlookTaskGroup
  • outlookCategory
  • attachment
  • Ограничения службы Outlook для пакетной обработки JSON

    Когда приложение выполняет пакетный запрос JSON , состоящий из нескольких неупорядоченных отдельных запросов к службе Outlook, По умолчанию Microsoft Graph отправляет службе Outlook до четырех отдельных запросов из пакета одновременно, независимо от целевых почтовых ящиков этих запросов. Служба Outlook может выполнять эти запросы параллельно в любой момент, независимо от целевого почтового ящика. Так как Microsoft Graph отправляет только до четырех запросов для параллельного выполнения, выполнение этого пакета остается в пределах ограничений параллелизма Outlook для одного почтового ящика.

    Кроме того, приложение может использовать свойство dependsOn для упорядочивания запросов в пакете. Microsoft Graph отправляет службе Outlook один запрос из пакета в указанный порядок, а Outlook выполняет каждый отдельный запрос в пакете последовательно.

    Другими словами, при выборе одного почтового ящика приложения, разрешающие параллельное выполнение нескольких пакетных запросов, могут использовать один из следующих подходов:

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

    Ограничения службы Project Rome

    Тип запроса Ограничение на каждого пользователя для всех приложений
    GET 400 запросов за 5 минут и 12 000 запросов в день
    POST, PUT, PATCH, DELETE 100 запросов за 5 минут и 8000 запросов в день

    Указанные выше ограничения действуют для следующих ресурсов:

    Ограничения службы обнаружений и инцидентов безопасности

    Указанные ниже ограничения применяются к любому запросу в /security.

    Операция Ограничение на приложение по клиенту
    Любая операция с alert, securityActionssecureScore 150 запросов в минуту
    Любая операция с tiIndicator 1000 запросов в минуту
    Любая операция с secureScore или secureScorecontrolProfile 10 000 запросов API за 10-минутный период
    Любая операция с secureScore или secureScorecontrolProfile Четыре одновременных запроса

    Ограничения службы обнаружения электронных данных безопасности

    Указанные ниже ограничения применяются к любому запросу в /security/eDiscoveryCases.

    Операция Ограничение на приложение по клиенту
    Любой Пять запросов в минуту

    Ограничения взаимодействия служб

    Следующие ограничения применяются к любому типу запросов для взаимодействия служб в /admin/serviceAnnouncement/.

    Тип запроса Ограничение на приложение по клиенту
    Любой 240 запросов за 60 секунд
    Любой 800 запросов в час

    Ограничения службы подписки

    Тип запроса Ограничение на приложение для всех арендаторов Ограничение на приложение по клиенту
    POST, PUT, DELETE, PATCH 2000 запросов за 20 секунд 500 запросов в 20 секунд
    POST /reauthorize подписки по идентификатору 4000 запросов в течение 20 секунд 1000 запросов за 20 секунд
    Получение подписки по ИД 2000 запросов за 20 секунд 500 запросов в 20 секунд
    Получение списка подписок 40 запросов за 20 секунд 25 запросов за 20 секунд

    Предыдущие ограничения применяются к ресурсу подписки .

    Ограничения службы для задач и планов

    Ограничения службы для Планировщик недоступны.

    Сведения, приведенные в этой статье, относятся к следующим ресурсам:

    ограничения служб Viva Engage

    Viva Engage вызовы API могут быть ограничены по скорости, что позволяет 10 запросов на пользователя на приложение в течение 30-секундного периода времени. При превышении предельной скорости все последующие запросы возвращают 429 Too Many Requests код ответа.