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

Microsoft Graph одновременно накладывает две категории ограничений регулирования для всех вызовов API:

  • Глобальные ограничения, применимые ко всем службам
  • Ограничения для конкретных служб, которые применяются к отдельным службам

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

В следующей таблице указаны глобальные ограничения.

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

В оставшейся части этой статьи представлен обзор ограничений регулирования для каждой службы Microsoft Graph.

Примечание.

Конкретные ограничения, описанные в этой статье, могут быть изменены.

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

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

Тип запроса Ограничение на приложение по клиенту Ограничение на клиента для всех приложений
Любой 350 запросов за 10 секунд 700 запросов за 10 секунд
Любой 10 000 запросов за 3 600 секунд 20 000 запросов за 3 600 секунд
POST /publish 25 запросов за 10 секунд 25 запросов за 10 секунд

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

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

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

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

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

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

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

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

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

Тип ограничения Ограничение
В приложении для всех клиентов 15 000 запросов за 20 секунд
На клиента для всех приложений 10 000 запросов за 20 секунд
На приложение на клиент 1 500 запросов за 20 секунд
На запись звонка 40 запросов за 20 секунд
Вывод списка записей звонков 40 запросов за 20 секунд

Ограничения записей звонков по ТСОП

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

Тип ограничения Ограничение
На клиента 1000 запросов за 60 секунд
На приложение на клиент 200 запросов за 60 секунд
За коллекцию 50 запросов за 60 секунд

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

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

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

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

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

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

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

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

Тип ограничения Ограничение
На клиента 100 запросов за 5 минут

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

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

Сведения об ограничениях служб для OneDrive и SharePoint см. в статье "Как избежать регулирования или блокировки в SharePoint".

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

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

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

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

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

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

  • Используйте фильтры, чтобы настроить запрос только на те данные, которые вам нужны. Если вам нужен только определенный тип события или подмножество пользователей, например, отфильтруйте другие события, используя параметры запроса $filter и $select, чтобы уменьшить размер объекта ответа и риск регулирования.
  • Если вам нужен широкий набор данных отчетов Microsoft Entra ID, используйте $filtercreatedDateTime, чтобы ограничить количество событий входа, запрашиваемых в одном вызове. Затем выполните итерацию по следующему промежутку времени, пока не получите все необходимые записи. Например, если используется регулирование, можно начать вызов, который запрашивает данные за три дня, и выполнять итерацию с более короткими временными интервалами, пока ваши запросы не перестанут регулироваться.
  • Параметр $select=signInActivity операции "Список пользователей" может вызывать более строгое регулирование, чем стандартные вызовы Microsoft API Graph. Чтобы избежать этих ограничений, используйте этот параметр только при необходимости. Если вам нужны данные о действиях входа, используйте его $top=500 , чтобы получить максимум 500 пользователей на страницу вместо 100 по умолчанию. Это уменьшает общее количество необходимых вызовов API.

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

Шаблон

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

Тип ограничения Квота единицы ресурса Квота на запись
пара "приложение + клиент" S: 3 500 единиц ресурсов за 10 секунд
M: 5 000 единиц ресурсов за 10 секунд
L: 8 000 единиц ресурсов за 10 секунд
3 000 запросов за 2 минуты 30 секунд
приложение 150 000 единиц ресурсов за 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 5 0
GET domains/{id}/domainNameReferences 4 0
POST getObjectsById 5 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}/.
  • Использование $select for directoryObjects/getByIds и getObjectsById приводит к 2 единицам ресурса.

Другие заголовки

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

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

Примечание.

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

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

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

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

  • 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 1 000 запросов в день для любой темы и 100 запросов на тему в день
Любой другой запрос 10 000 запросов в час

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

Примечание.

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

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

Тип запроса Ограничение на приложение по клиенту Ограничение на пользователя на клиент
ПУБЛИКАЦИЯ, ИСПРАВЛЕНИЕ И УДАЛЕНИЕ 3 000 запросов за 2 минуты 30 секунд 25 запросов за 10 секунд

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

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

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

Примечание.

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

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

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

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

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

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

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

Указанные ниже ограничения применяются к любому запросу в /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 для обоих.

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

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

Microsoft Teams применяет ограничения регулирования в четырех независимых измерениях. Запрос регулируется, когда он превышает любое применимое к нему ограничение, поэтому всегда рассчитывайте на самый низкий предел, которого достигает ваш сценарий.

Dimension Что это важно Когда обычно применимо
Для каждого приложения Все запросы от одного приложения (идентификатор клиента) суммируются по каждому клиенту. Многотенантные приложения, обслуживающие множество клиентов.
На приложение на клиент Запросы от одного приложения в одном клиенте. Наиболее часто достигаемый предел.
На ресурс Запросы от одной команды, канала или чата. Приложения, которые концентрируют трафик на одной беседе.
На пользователя Запросы, сделанные от имени одного пользователя. Сценарии делегированных разрешений (пользователей).

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

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

Тире (-) означает, что для этого измерения не определено специальное ограничение. На запрос по-прежнему распространяются ограничения по умолчанию и все другие ограничения в той же строке.

Teams

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /teams/{team-id} 1500 запросов в секунду 30 запросов в секунду 4 rps на команду -
GET /me/joinedTeams или /users/{user-id}/joinedTeams 300 запросов в секунду 30 запросов в секунду - -
POST /teams 100 запросов в секунду 10 запросов в секунду - -
PUT /groups/{team-id}/team 150 запросов в секунду 6 запросов в секунду - -
PATCH /teams/{team-id} 300 запросов в секунду 30 запросов в секунду 4 rps на команду -
POST /teams/{team-id}/clone 150 запросов в секунду 6 запросов в секунду - -
POST /teams/{team-id}/completeMigration 100 запросов в секунду 10 запросов в секунду - -

Каналы

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /команды/{team-id}/каналы 1200 об/с 60 запросов в секунду 4 rps на команду -
GET /teams/{team-id}/channels/{channel-id} 600 запросов в секунду 30 запросов в секунду 1 об/с на канал -
GET /teams/{team-id}/channels/{channel-id}/members 1200 об/с 60 запросов в секунду 1 об/с на канал -
POST /команды/{team-id}/каналы 100 запросов в секунду 10 запросов в секунду 4 rps на команду -
PATCH /teams/{team-id}/channels/{channel-id} 300 запросов в секунду 30 запросов в секунду 1 об/с на канал -
DELETE /teams/{team-id}/channels/{channel-id} 150 запросов в секунду 15 запросов в секунду 1 об/с на канал -
POST /teams/{team-id}/channels/{channel-id}/completeMigration 100 запросов в секунду 10 запросов в секунду - -

Сообщения в канале

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /teams/{team-id}/channels/{channel-id}/messages 200 запросов в секунду 20 запросов в секунду 1 об/с на канал -
POST /teams/{team-id}/channels/{channel-id}/messages 500 запросов в секунду 50 запросов в секунду 1 об/с на канал 1 об/с
POST /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies 500 запросов в секунду 50 запросов в секунду 1 об/с на канал 1 об/с

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

Чаты

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /chats, /me/chats или /users/{user-id}/chats 200 запросов в секунду 20 запросов в секунду - 1 об/с
ПОЛУЧИТЬ /чаты/{chat-id} 2000 об/с 200 запросов в секунду 1 об/с за чат 5 запросов в секунду
POST /чаты 200 запросов в секунду 20 запросов в секунду - -
ПАТЧ /чаты/{chat-id} 300 запросов в секунду 30 запросов в секунду 1 об/с за чат -
DELETE /чаты/{chat-id} 10 запросов в секунду 1 об/с 1 об/с за чат -
POST /chats/{chat-id}/removeAllAccessForUser 300 запросов в секунду 30 запросов в секунду 1 об/с за чат 1 об/с

Сообщения чата

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /чаты/{chat-id}/сообщения 200 запросов в секунду 20 запросов в секунду 1 об/с за чат -
POST /чаты/{chat-id}/сообщения 200 запросов в секунду 20 запросов в секунду 1 об/с за чат 1 об/с
ПАТЧ /чаты/{chat-id}/сообщения/{message-id} 300 запросов в секунду 30 запросов в секунду 1 об/с за чат -
POST /chats/{chat-id}/messages/{message-id}/softDelete или undoSoftDelete 300 запросов в секунду 30 запросов в секунду 1 об/с за чат -
GET /chats/{chat-id}/messages/{message-id}/hostedContents 500 запросов в секунду 50 запросов в секунду 1 об/с за чат -
GET /chats/{chat-id}/messages/{message-id}/hostedContents/{id}/$value 600 запросов в секунду 60 запросов в секунду 1 об/с за чат -

Members

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /teams/{team-id}/members 1200 об/с 60 запросов в секунду 4 rps на команду -
POST /teams/{team-id}/members 300 запросов в секунду 30 запросов в секунду 4 запроса в минуту на команду -
POST /teams/{team-id}/members/add 100 запросов в секунду 10 запросов в секунду 4 запроса в минуту на команду -
POST /чаты/{chat-id}/участники 300 запросов в секунду 30 запросов в секунду 4 запроса в минуту на чат -
DELETE /chats/{chat-id}/members/{membership-id} 300 запросов в секунду 30 запросов в секунду 4 запроса в минуту на чат -

Приложения, вкладки и предоставленные разрешения

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
УСТАНОВКА Приложения для команды, чата или пользователя 1500 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
ПОЛУЧИТЬ РАЗРЕШЕНИЕгранты для команды или чата 1500 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
POST установленПриложения для команды, чата или пользователя 300 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
DELETE установленоПриложения для команды, чата или пользователя 150 запросов в секунду 15 запросов в секунду 1 об/с на чат или канал -
ПОЛУЧИТЬ вкладки для канала или чата 600 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
Вкладки POST для канала или чата 300 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
Вкладка "ИСПРАВЛЕНИЕ" 300 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал -
DELETE вкладки для канала или чата 150 запросов в секунду 15 запросов в секунду 1 об/с на чат или канал -
GET /appCatalogs/teamsApps 1500 запросов в секунду 30 запросов в секунду - -
POST /appCatalogs/teamsApps 300 запросов в секунду 30 запросов в секунду - -
DELETE /appCatalogs/teamsApps/{app-id} 150 запросов в секунду 15 запросов в секунду - -

Уведомления ленты новостей

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
POST /teams/{team-id}/sendActivityNotification 50 запросов в секунду 5 запросов в секунду 4 rps на команду -
POST /chats/{chat-id}/sendActivityNotification 50 запросов в секунду 5 запросов в секунду 1 об/с за чат -
POST /users/{user-id}/teamwork/sendActivityNotification 50 запросов в секунду 5 запросов в секунду - -
POST /teamwork/sendActivityNotificationToRecipients 20 запросов в секунду 2 запроса в секунду - -

Массовое получение сообщений

Эти API предназначены для сценариев экспорта и соответствия требованиям и имеют собственные более высокие ограничения.

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /teams/{team-id}/channels/getAllMessages или /channels/allMessages 1000 об/с 200 запросов в секунду - -
GET /users/{user-id}/chats/getAllMessages или /chats/allMessages 1000 об/с 200 запросов в секунду - -
GET /teams/{team-id}/channels/getAllRetainedMessages 1000 об/с 200 запросов в секунду - -
GET /users/{user-id}/chats/getAllRetainedMessages 1000 об/с 200 запросов в секунду - -
GET /copilot/users/{user-id}/interactionHistory/getAllEnterpriseInteractions 1500 запросов в секунду 30 запросов в секунду - -

Смены

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
GET /teams/{team-id}/schedule и все API по этому пути 600 запросов в секунду 30 запросов в секунду - -
POST /teams/{team-id}/schedule и все API по этому пути 300 запросов в секунду 30 запросов в секунду - -
PUT /teams/{team-id}/schedule и все API по этому пути 300 запросов в секунду 30 запросов в секунду - -

Sections

Запрос Для каждого приложения На приложение на клиент На ресурс На пользователя
Все API управления разделами в /users/{user-id}/teamwork/sections - 5 запросов в секунду - -

Все операции с разделами, включая разделы, элементы разделов, действия по изменению порядка и разностные запросы, имеют одно ограничение.

Ограничения по умолчанию

Эти ограничения используются во всех запросах Microsoft Teams, не перечисленных в предыдущих таблицах.

Тип запроса Для каждого приложения На приложение на клиент На ресурс На пользователя
GET 1500 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал 1 об/с
POST, PUT и PATCH 300 запросов в секунду 30 запросов в секунду 1 об/с на чат или канал 1 об/с
DELETE 150 запросов в секунду 15 запросов в секунду 1 об/с на чат или канал 1 об/с

См. Также ограничения 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 импорта и экспорта почтовых ящиков
  • mailbox
  • mailboxItem
  • mailboxFolder
  • exchangeSettings
  • 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 , чтобы упорядочивать запросы в пакете и выполнять до четырех таких пакетных запросов одновременно.

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

    Следующие API Places имеют ограничение регулирования в три вызова в секунду:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Ограничения служб Windows 365

    Тип запроса Ограничение на клиент для всех приложений или пользователей Ограничение на приложение или пользователя на клиент
    Список облачных компьютеров 180 запросов за 60 секунд 162 запроса за 60 секунд
    Получить облачный компьютер 540 запросов за 60 секунд 486 запросов за 60 секунд

    Начиная с 30 сентября 2025 г. ограничение регулирования для приложения/пользователя на клиента будет снижено до половины от общего ограничения на клиента, чтобы один пользователь или приложение не могли использовать всю квоту в клиенте.

    Тип запроса Ограничение на клиент для всех приложений или пользователей Ограничение на приложение или пользователя на клиент
    Список облачных компьютеров 180 запросов за 60 секунд 90 запросов за 60 секунд
    Получить облачный компьютер 540 запросов за 60 секунд 270 запросов за 60 секунд