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

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

Тип ограничения Ограничение
На клиента 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.

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

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

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

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

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

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

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

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

Шаблон

Регулирование основано на алгоритме маркерной корзины, которая работает путем добавления отдельной стоимости запросов. Затем суммарная стоимость запросов сравнивается с заранее определенными ограничениями. Регулирование применяется только для запросов, превышающих ограничения. Если превышено любое из ограничений, будет получен отклик 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 секунд 70 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
  • Создание пользователя в клиенте Azure AD 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-scope. Например: Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b. Указывает область регулирования в следующем формате — <Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>:
    • Scope: (строка, обязательно)
      • Tenant_Application — все запросы определенного клиента для текущего приложения.
      • Tenant — все запросы для текущего клиента независимо от приложения.
      • Application — все запросы для текущего приложения.
    • Limit: (строка, обязательно)
      • 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 запросов по теме в день
Любой другой запрос 10000 запросов в час

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

Примечание.

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

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

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

Примечание.

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

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

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

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

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

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

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

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

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

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

Ограничение Сфера применения
10 000 запросов API в течение 10-минутного периода Конечные точки версии 1.0 и бета-версии
4 параллельных запроса Конечные точки версии 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 минут будут рассматриваться как 1 запрос из 14 для каждого API, а не 2 запроса из 14 для обоих.

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

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

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

Тип запроса Teams Лимит на приложение на одного арендатора Ограничение на приложение для всех арендаторов
ПОЛУЧИТЬ команду, канал, вкладку, установленные приложения, каталог приложений 30 запросов в секунду 600 запросов в секунду
Канал POST / PUT, вкладка, установленные приложения, каталог приложений 30 запросов в секунду 300 запросов в секунду
PATCH команда, канал, вкладка, установленные приложения, каталог приложений 30 запросов в секунду 300 запросов в секунду
УДАЛИТЬ канал, вкладку, установленные приложения, каталог приложений 15 запросов в секунду 150 запросов в секунду
Получить /teams/{team-id}, joinedTeams 30 запросов в секунду 300 запросов в секунду
POST /teams 10 запросов в секунду 100 запросов в секунду
PUT /groups/{team-id}/team, клон 6 запросов в секунду 150 запросов в секунду
ПОЛУЧИТЬ сообщение канала 20 запросов в секунду 200 запросов в секунду
ПОЛУЧИТЬ 1: 1 / сообщение группового чата 20 запросов в секунду 200 запросов в секунду
Сообщение POST канала 50 запросов в секунду 500 запросов в секунду
POST 1: 1 / сообщение в групповом чате 20 запросов в секунду 200 запросов в секунду
GET /teams/{team-id}/schedule и все API по этому пути 30 запросов в секунду 600 запросов в секунду
POST, PATCH, PUT /teams/{team-id}/schedule и все API по этому пути 30 запросов в секунду 300 запросов в секунду
DELETE /teams/{team-id}/schedule и все API по этому пути 15 запросов в секунду 150 запросов в секунду
POST /teams/{team-id}/sendActivityNotification 5 запросов в секунду 50 запросов в секунду
POST /chats/{chat-id}/sendActivityNotification 5 запросов в секунду 50 запросов в секунду
POST /users/{user-id}/teamwork/sendActivityNotification 5 запросов в секунду 50 запросов в секунду
POST /teamwork/sendActivityNotificationToRecipients 2 запроса в секунду 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 запросов в секунду

Максимально 4 запроса в секунду на приложение могут быть отправлены для данной команды или канала. В определенный канал можно отправлять не более 3000 сообщений на каждое приложение в день (за исключением случаев, когда используется режим миграции).

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

Ограничения службы Outlook проверяются для каждого идентификатора приложения и сочетания почтового ящика. Иными словами, описываемые ограничения применяются к конкретному приложению, которое получает доступ к определенному почтовому ящику (пользователя или группы). Если приложение превышает ограничение для одного почтового ящика, оно не повлияет на возможность доступа к другому почтовому ящику. Указанные ниже ограничения относятся к общедоступному облаку, а также к национальным облачным развертываниям.

Ограничение Сфера применения
10 000 запросов API в течение 10-минутного периода Конечные точки версии 1.0 и бета-версии
4 параллельных запроса Конечные точки версии 1.0 и бета-версии
Отправка 15 мегабайт (МБ) (PATCH, POST, PUT) в течение 30 секунд. Конечные точки версии 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
  • Ограничения службы Project Rome

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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