Ограничения регулирования для служб, связанных с Microsoft Graph
Microsoft Graph позволяет получать доступ к данным в нескольких службах, таких как Outlook или Microsoft Entra ID. В этих службах применяются собственные ограничения, которые влияют на работу приложений, использующих Microsoft Graph для доступа к ним.
Любой запрос можно оценивать с учетом нескольких ограничений, в зависимости от области применения ограничения (для каждого приложения во всех клиентах, по клиенту для всех приложений, для каждого приложения по отдельному клиенту и т. д.), типа запроса (GET, POST, PATCH и т. д.) и других факторов. Первое достигнутое ограничение запускает действие регулирования. Помимо специальных ограничений для служб, описанных в этом разделе, применяются следующие глобальные ограничения:
Тип запроса | Для каждого приложения во всех клиентах |
---|---|
Любой | 130 000 запросов за 10 секунд |
Примечание.
Описанные здесь отдельные ограничения могут изменяться.
В этом разделе термин клиент относится к организации Microsoft 365, в которой установлено приложение. Этот клиент может быть таким же, как и тот, в котором было создано приложение в случае одноклиентского приложения, или он может отличаться в случае многоклиентского приложения.
Ограничения службы заданий
Указанные ограничения применяются к запросам в API службы назначения.
Тип запроса | Ограничение на приложение по клиенту | Ограничение на клиента для всех приложений |
---|---|---|
Любой | 500 запросов за 10 секунд | 1000 запросов в 10 секунд |
Любой | 15 000 запросов за 3600 секунд | 30 000 запросов за 3600 секунд |
GET me/задание | 50 запросов за 10 секунд | 150 запросов за 10 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
ограничения службы Bookings
Служба Bookings применяет ограничения к каждой комбинации идентификатора приложения и почтового ящика, в частности, когда определенное приложение обращается к определенному почтовому ящику резервирования. Превышение лимита для одного почтового ящика не влияет на возможность приложения получить доступ к другому почтовому ящику.
Ограничение | Сфера применения |
---|---|
Четыре одновременных запроса | Конечные точки версии 1.0 и бета-версии |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы облачного взаимодействия
Ресурс | Ограничения для каждого приложения |
---|---|
Звонки | 50 000 запросов за 15-секундный период на каждое приложение на клиент |
Сведения о собрании | 2000 собраний на пользователя в месяц |
Присутствие | 1500 запросов за 30-секундный период на каждое приложение на клиент |
Виртуальное событие | 10 000 запросов на приложение в месяц |
Ограничения записей вызовов
Ограничения, перечисленные в следующей таблице, применяются к следующим ресурсам:
Тип ограничения | Ограничение |
---|---|
На приложение для всех клиентов | 15 000 запросов в 20 секунд |
На клиента для всех приложений | 10 000 запросов в 20 секунд |
На приложение на клиент | 1500 запросов за 20 секунд |
Запись звонка | 10 запросов в 20 секунд (первая страница) 50 запросов в 5 минут (последующие страницы) |
Перечисление записей вызовов | 15 запросов в 20 секунд (первая страница) 55 запросов за 5 минут (последующие страницы) |
Ограничения записей вызовов ТСОП
Ограничения, перечисленные в следующей таблице, применяются к следующим ресурсам:
Тип ограничения | Ограничение |
---|---|
На клиента | 1000 запросов за 60 секунд |
На приложение на клиент | 200 запросов за 60 секунд |
На коллекцию | 50 запросов за 60 секунд |
Ограничения службы Excel
Объяснения и рекомендации, связанные с регулированием службы Excel, см. в статье Уменьшение ошибок регулирования. Кроме того, ниже приведены некоторые ограничения регулирования.
Тип запроса | Ограничение на приложение для всех арендаторов | Ограничение на приложение по клиенту |
---|---|---|
Любой | 5000 запросов в течение 10 секунд | 1500 запросов в течение 10 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы для образования
Тип запроса | Ограничение на приложение для всех арендаторов | Ограничение на приложение по клиенту |
---|---|---|
Любой | 400 000 запросов за 20 секунд | 35 000 запросов за 10 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы для файлов и списков
Ограничения службы для OneDrive, OneDrive для бизнеса и SharePoint Online см. в статье Как избежать регулирования или блокировки в SharePoint Online.
Сведения, приведенные в этой статье, относятся к следующим ресурсам:
Ограничения службы отчетов удостоверений и доступа
Тип запроса | Ограничение на приложение по клиенту |
---|---|
Любой | Пять запросов за 10 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Рекомендации по отчетам об идентификации и доступе
Microsoft Entra API отчетов регулируются, когда Microsoft Entra ID получает слишком много вызовов в течение заданного периода времени от клиента или приложения. Вызовы также могут регулироваться, если служба занимает слишком много времени, чтобы ответить. Если ваши запросы по-прежнему завершаются ошибкой с кодом ошибки 429 Too Many Requests
, несмотря на то, что вы применяете лучшие методики регулирования, попробуйте сократить объем возвращаемых данных. Сначала попробуйте эти подходы:
- Используйте фильтры, чтобы настроить запрос только на те данные, которые вам нужны. Если вам нужен только определенный тип события или подмножество пользователей, например, отфильтруйте другие события, используя параметры запроса
$filter
и$select
, чтобы уменьшить размер объекта ответа и риск регулирования. - Если вам нужен широкий набор Microsoft Entra ID данных отчетов, используйте
$filter
параметр createdDateTime, чтобы ограничить количество событий входа, запрашиваемых в одном вызове. Затем выполните итерацию по следующему промежутку времени, пока не получите все необходимые записи. Например, при регулировании можно начать с вызова, который запрашивает данные в течение трех дней, и выполнять итерацию с более короткими интервалами времени, пока ваши запросы не будут регулироваться.
Ограничения службы удостоверения и доступа
Шаблон
Регулирование основано на алгоритме маркерной корзины, которая работает путем добавления отдельной стоимости запросов. Затем сумма затрат на запрос сравнивается с предопределенными ограничениями. Регулируются только запросы, превышающие ограничения. Если превышено какое-либо из ограничений, ответом будет 429 Too Many Requests
. Можно получать 429 Too Many Requests
ответы, даже если следующие ограничения не достигнуты в ситуациях, когда службы находятся под важной нагрузкой или на основе объема данных для конкретного клиента. В следующей таблице перечислены существующие ограничения.
Тип ограничения | Квота единицы ресурса | Квота на запись |
---|---|---|
пара "приложение + клиент" | S: 3500 ResourceUnits в 10 секунд M: 5000 ResourceUnits за 10 секунд L: 8000 ResourceUnits за 10 секунд |
3 000 запросов за 2 минуты 30 секунд |
приложение | 150 000 ResourceUnits за 20 секунд | 35 000 запросов за 5 минут |
клиент | Неприменимо | 18 000 запросов за 5 минут |
Примечание.
Ограничение на количество пар приложение + клиент зависит от количества пользователей в запросах клиента. Размеры клиента определяются следующим образом: S — менее 50 пользователей, M — от 50 до 500 пользователей и L — более 500 пользователей.
Указанные выше ограничения действуют для следующих ресурсов:
В следующей таблице перечислены базовые стоимости запросов. У любых запросов, не указанных в списке, базовая стоимость равна 1.
Операция | Путь запроса | Базовая стоимость единицы ресурса | Стоимость записи |
---|---|---|---|
GET | applications |
2 | 0 |
GET | applications/{id}/extensionProperties |
2 | 0 |
GET | contracts |
3 | 0 |
POST | directoryObjects/getByIds |
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
дляdirectoryObjects/getByIds
иgetObjectsById
приведет к 2 ResourceUnits.
Дополнительные заголовки
Заголовки запросов
-
x-ms-throttle-priority. Если заголовок не существует или для него задано другое значение, это означает, что это нормальный запрос. Рекомендуем присваивать приоритету значение
high
только для запросов, инициированных пользователем. Этот заголовок может иметь одно из следующих значений:- Low. Означает низкий приоритет запроса. Регулирование этого запроса не вызывает заметные для пользователя сбои.
- Normal. Применяется по умолчанию, если значение не указано. Означает стандартный приоритет запроса.
- High. Означает высокий приоритет запроса. Регулирование этого запроса вызывает заметные для пользователя сбои.
Примечание.
Если запросы будут регулироваться, запросы с низким приоритетом будут регулироваться первыми, запросы с нормальным приоритетом — вторыми, а запросы с высоким приоритетом — последними. Использование заголовка запроса с приоритетом не изменяет ограничения.
Обычные запросы откликов
- x-ms-resource-unit. Указывает единицу ресурса, примененную для запроса. Значения: положительные целые числа.
- x-ms-throttle-limit-percentage. Возвращается только в том случае, если приложение израсходовало более 0,8 от ограничения. Значения в диапазоне от 0,8 до 1,8, соответствующие проценту использования ограничения. Вызывающие могут использовать это значение для настройки оповещения и выполнения действий.
Регулируемые запросы откликов
-
x-ms-throttle-область, например
Tenant_Application/ReadWrite/9a3d526c-b3c1-4479-ba74-197b5c5751ae/0785ef7c-2d7a-4542-b048-95bcab406e0b
. Указывает область регулирования в следующем формате —<Scope>/<Limit>/<ApplicationId>/<TenantId|UserId|ResourceId>
:- Scope: (строка, обязательно)
- Tenant_Application — все запросы определенного клиента для текущего приложения.
- Tenant — все запросы для текущего клиента независимо от приложения.
- Application — все запросы для текущего приложения.
- Ограничение: (строка, обязательный)
- Read. Запросы на чтение в области (GET)
- Write. Запросы на запись в области (POST, PATCH, PUT, DELETE...)
- ReadWrite. Все запросы в области (любые)
- ApplicationId (GUID, обязательно)
- TenantId|UserId|ResourceId: (GUID, обязательно)
- Scope: (строка, обязательно)
-
x-ms-throttle-information. Указывает причину регулирования и может иметь любое значение (строка). Это значение предоставляется для диагностики и устранения неполадок. Вот несколько примеров:
- CPULimitExceeded — регулирование вызвано превышением ограничения для выделения ЦП.
- WriteLimitExceeded — регулирование вызвано превышением ограничения на запись.
- ResourceUnitLimitExceeded — регулирование вызвано превышением ограничения для выделенного ресурса.
Ограничения службы операций с политикой данных удостоверений и доступа
Тип запроса | Ограничение для каждого клиента |
---|---|
POST для exportPersonalData |
1000 запросов в день для любой темы и 100 запросов в день |
Любой другой запрос | 10 000 запросов в час |
Указанные выше ограничения действуют для следующих ресурсов:
Примечание.
Перечисленные ранее ресурсы не возвращают заголовок Retry-After
в ответах 429 Too Many Requests
.
Ограничения в отношении защиты удостоверений и службы условного доступа
Тип запроса | Ограничение на клиента для всех приложений |
---|---|
Любой | Один запрос в секунду |
Примечание.
Перечисленные ранее ресурсы не возвращают заголовок Retry-After
в ответах 429 Too Many Requests
.
Ограничения службы поставщиков удостоверений
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
Любой | 300 запросов в минуту | 200 запросов в минуту |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы защиты информации
Указанные ниже ограничения применяются к любому запросу в /informationProtection
.
Для электронной почты ресурс — это уникальная пара ИД сетевого сообщения и получателя. Например, отправка сообщения электронной почты с тем же идентификатором сообщения, отправленного одному и тому же человеку несколько раз в течение 15-минутного периода, активирует ограничение на ресурсы, указанное в следующей таблице. Однако каждые 15 минут (ограничение клиента) можно отправлять до 150 уникальных писем.
Операция | Ограничение для каждого клиента | Ограничение на ресурс (электронная почта, URL-адрес, файл) |
---|---|---|
POST | 150 запросов за 15 минут и 10 000 запросов за 24 часа | Один запрос за 15 минут и 3 запроса за 24 часа |
Ограничения службы аналитики
Указанные ниже ограничения применяются к любому запросу в me/insights
или users/{id}/insights
.
Ограничение | Сфера применения |
---|---|
10 000 запросов API за 10-минутный период | Конечные точки версии 1.0 и бета-версии |
Четыре одновременных запроса | Конечные точки версии 1.0 и бета-версии |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы Android for Work в Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы приложений Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы аудита Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы книг Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы пакетов Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы синхронизации Chromebook Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы условий компании Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы настройки v2 устройств Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы настройки устройств Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы регистрации устройств Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы намерения устройств Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы устройств Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 400 запросов в течение 20 секунд | 200 запросов в течение 20 секунд |
Любое | 4000 запросов в течение 20 секунд | 2000 запросов в течение 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы защиты конечных точек Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы регистрации Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы GPAnalytics Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы управляемых приложений Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы уведомлений Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы ODJ Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы интеграции партнеров Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы Intune rbac
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы удаленного помощника Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы телефонии Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы Intune TEM
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы устранения неполадок Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы разблокировки Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы обновлений Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы WIP Intune
Тип запроса | Ограничение на клиента для всех приложений | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 200 запросов за 20 секунд | 100 запросов за 20 секунд |
Любой | 2000 запросов за 20 секунд | 1000 запросов за 20 секунд |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы диспетчера приглашений
Указанные ниже ограничения применяются к любому запросу в /invitations
.
Операция | Ограничение на клиента для всех приложений |
---|---|
Любая операция | 150 запросов за 5 секунд |
Ограничения службы отчетов Microsoft 365
Указанные ниже ограничения применяются к любому запросу в /reports
.
Операция | Ограничение на приложение по клиенту | Ограничение на клиента для всех приложений |
---|---|---|
Любой запрос (CSV) | 14 запросов в течение 10 минут | 40 запросов в течение 10 минут |
Любой запрос (JSON, beta) | 100 запросов в течение 10 минут | н/д |
Указанные выше ограничения применяются по отдельности к каждому API отчетов. Например, запрос к API отчетов о действиях пользователей Microsoft Teams и запрос к API отчетов о действиях пользователей Outlook в течение 10 минут считаются одним запросом из 14 для каждого API, а не двумя из 14 запросов для обоих API.
Указанные выше ограничения применяются к всем ресурсам отчетов об использовании.
Ограничения службы Microsoft Teams
Ограничения выражаются в виде запросов в секунду (RPS).
Тип запроса Teams | Лимит на приложение на одного арендатора | Ограничение на приложение для всех арендаторов | Ограничение на приложение на клиент на ресурс(чат/канал) |
---|---|---|---|
Команда GET | 30 запросов в секунду | 600 запросов в секунду | |
Канал GET | 30 запросов в секунду | 600 запросов в секунду | 1rps |
Вкладка GET для канала, чата | 30 запросов в секунду | 600 запросов в секунду | 1rps |
GET installedApps for user, team | 30 запросов в секунду | 600 запросов в секунду | |
GET installedApps for chat | 30 запросов в секунду | 600 запросов в секунду | 1rps |
GET appCatalogs | 30 запросов в секунду | 600 запросов в секунду | |
Канал POST | 30 запросов в секунду | 300 запросов в секунду | 1rps |
Вкладка POST для канала или чата | 30 запросов в секунду | 300 запросов в секунду | 1rps |
POST установленные Приложения для чата, пользователя, команды | 30 запросов в секунду | 300 запросов в секунду | |
POST appCatalogs | 30 запросов в секунду | 300 запросов в секунду | |
Команда PATCH, вкладка | 30 запросов в секунду | 300 запросов в секунду | |
Канал PATCH | 30 запросов в секунду | 300 запросов в секунду | 1rps |
Канал DELETE | 15 запросов в секунду | 150 запросов в секунду | 1rps |
Вкладка DELETE для чата, канала | 15 запросов в секунду | 150 запросов в секунду | 1rps |
DELETE установленные Приложения для чата, пользователя, команды | 15 запросов в секунду | 150 запросов в секунду | |
DELETE appCatalogs | 15 запросов в секунду | 150 запросов в секунду | |
GET /teams/{team-id} , joinedTeams |
30 запросов в секунду | 300 запросов в секунду | |
POST /teams | 10 запросов в секунду | 100 запросов в секунду | |
PUT /groups/{team-id} /team |
Шесть запросов в с | 150 запросов в секунду | |
POST /{team-id} / clone |
Шесть запросов в с | 150 запросов в секунду | |
Сообщение канала GET | 20 запросов в секунду | 200 запросов в секунду | 1rps |
GET 1:1/групповое сообщение чата | 20 запросов в секунду | 200 запросов в секунду | 1rps |
Сообщение канала POST | 50 запросов в секунду | 500 запросов в секунду | 1rps |
Участник чата POST | 30 запросов в секунду | 300 запросов в секунду | 16:00 |
Удаление участника чата | 30 запросов в секунду | 300 запросов в секунду | 16:00 |
СООБЩЕНИЕ POST 1:1/группового чата | 20 запросов в секунду | 200 запросов в секунду | 1rps |
GET /teams/{team-id} /schedule и все API по этому пути |
30 запросов в секунду | 600 запросов в секунду | |
POST /teams/{team-id} /schedule и все API по этому пути |
30 запросов в секунду | 300 запросов в секунду | |
PUT /teams/{team-id} /schedule и все API по этому пути |
30 запросов в секунду | 300 запросов в секунду | |
POST /teams/{team-id} /sendActivityNotification |
Пять запросов в минуту | 50 запросов в секунду | |
POST /chats/{chat-id} /sendActivityNotification |
Пять запросов в минуту | 50 запросов в секунду | 1rps |
POST /users/{user-id} /teamwork/sendActivityNotification |
Пять запросов в минуту | 50 запросов в секунду | |
POST /teamwork/sendActivityNotificationToRecipients | Два запросов в минуту | 20 запросов в секунду | |
GET /teams/{team-id} /members |
60 запросов в секунду | 1200 о/с | |
POST /teams/{team-id} /members |
30 запросов в секунду | 300 запросов в секунду | 16:00 |
GET /teams/{team-id} /channels |
60 запросов в секунду | 1200 о/с | 1rps |
GET /teams/{team-id} /channels/{channel-id} /members |
60 запросов в секунду | 1200 о/с | 1rps |
Получение всех сообщений канала для команды GET teams/ {team-id} /channels/getAllMessagesGET teams/ {team-id} /channels/allMessages |
200rps | 1000rps | |
Получение всех сообщений чата для пользователя GET users/ {user-id} /chats/getAllMessagesGET users/ {user-id} /chats/allMessages |
200rps | 1000rps | |
GET /teams/{team-id} /channels/getAllRetainedMessages |
200rps | 1000rps | |
GET /users/{user-id} /chats/getAllRetainedMessages |
200rps | 1000rps | |
Другие вызовы API GET для Microsoft Teams | 30 запросов в секунду | 1500 запросов в секунду | 1rps |
Другие вызовы API для Microsoft Teams | 30 запросов в секунду | 300 запросов в секунду | 1rps |
В каждой команде может быть выдано не более четырех запросов в секунду на каждое приложение.
В данном канале или чате может быть выполнено не более одного запроса в секунду на каждое приложение для каждого клиента.
При выполнении сообщения POST в заданном чате или канале можно отправить не более одного запроса в секунду (это ограничение регулирования не применяется к миграции).
При выполнении списка чатов или get chat или chat:removeAllAccessForUser может быть выдано не более пяти запросов в секунду на пользователя.
См. Также ограничения 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 задач из списка дел (предварительная версия) |
Ограничения службы Outlook для пакетной обработки JSON
Когда приложение выполняет пакетный запрос JSON , состоящий из нескольких неупорядоченных отдельных запросов к службе Outlook, По умолчанию Microsoft Graph отправляет службе Outlook до четырех отдельных запросов из пакета одновременно, независимо от целевых почтовых ящиков этих запросов. Служба Outlook может выполнять эти запросы параллельно в любой момент, независимо от целевого почтового ящика. Так как Microsoft Graph отправляет только до четырех запросов для параллельного выполнения, выполнение этого пакета остается в пределах ограничений параллелизма Outlook для одного почтового ящика, независимо от используемого приложения.
Кроме того, приложение может использовать свойство dependsOn для упорядочивания запросов в пакете. Microsoft Graph отправляет службе Outlook один запрос из пакета в указанный порядок, а Outlook выполняет каждый отдельный запрос в пакете последовательно.
Другими словами, при выборе одного почтового ящика приложения, разрешающие параллельное выполнение нескольких пакетных запросов, могут использовать один из следующих подходов:
- Если отдельные запросы не нужно упорядочивать, необходимо одновременно выполнять отдельные запросы из одного пакета.
-
dependsOn
Используйте свойство для упорядочения запросов в пакете и одновременного выполнения до четырех таких пакетных запросов.
Ограничения службы Project Rome
Тип запроса | Ограничение на каждого пользователя для всех приложений |
---|---|
GET | 400 запросов за 5 минут и 12 000 запросов в день |
POST, PUT, PATCH, DELETE | 100 запросов за 5 минут и 8000 запросов в день |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы обнаружений и инцидентов безопасности
Указанные ниже ограничения применяются к любому запросу в /security
.
Операция | Ограничение на приложение по клиенту |
---|---|
Любая операция с alert , securityActions secureScore |
150 запросов в минуту |
Любая операция с tiIndicator |
1000 запросов в минуту |
Любая операция с secureScore или secureScorecontrolProfile |
10 000 запросов API за 10-минутный период |
Любая операция с secureScore или secureScorecontrolProfile |
Четыре одновременных запроса |
Ограничения службы обнаружения электронных данных безопасности
Указанные ниже ограничения применяются к любому запросу в /security/eDiscoveryCases
.
Операция | Ограничение на приложение по клиенту |
---|---|
Любой | Пять запросов в минуту |
Ограничения взаимодействия служб
Следующие ограничения применяются к любому типу запросов для взаимодействия служб в /admin/serviceAnnouncement/
.
Тип запроса | Ограничение на приложение по клиенту |
---|---|
Любой | 240 запросов за 60 секунд |
Любой | 800 запросов в час |
Ограничения службы подписки
Тип запроса | Ограничение на приложение для всех арендаторов | Ограничение на приложение по клиенту |
---|---|---|
POST, PUT, DELETE, PATCH | 2000 запросов за 20 секунд | 500 запросов в 20 секунд |
POST /reauthorize подписки по идентификатору | 4000 запросов в течение 20 секунд | 1000 запросов за 20 секунд |
Получение подписки по ИД | 2000 запросов за 20 секунд | 500 запросов в 20 секунд |
Получение списка подписок | 40 запросов за 20 секунд | 25 запросов за 20 секунд |
Предыдущие ограничения применяются к ресурсу подписки .
Ограничения службы для задач и планов
Ограничения службы для Планировщик недоступны.
Сведения, приведенные в этой статье, относятся к следующим ресурсам:
ограничения служб Viva Engage
Viva Engage вызовы API могут быть ограничены по скорости, что позволяет 10 запросов на пользователя на приложение в течение 30-секундного периода времени. При превышении предельной скорости все последующие запросы возвращают 429 Too Many Requests
код ответа.