Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
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}/. - Использование
$selectfordirectoryObjects/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, обязательно)
- Scope: (строка, обязательно)
-
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 календаря | |
| API почты | |
| API импорта и экспорта почтовых ящиков | |
| API для управления личными контактами | |
| Социальная и рабочая аналитика | |
| API задач из списка дел (предварительная версия) |
Ограничения службы 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 секунд |