Ограничения регулирования для служб, связанных с 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, обязательно)
- Scope: (строка, обязательно)
- 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/getAllMessagesGET teams/ {team-id} /channels/allMessages |
200rps | 1000rps |
Получение всех сообщений чата для пользователя GET users/ {user-id} /chats/getAllMessagesGET 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 календаря | |
API почты | |
API для управления личными контактами | |
Социальная и рабочая аналитика | |
API задач из списка дел (предварительная версия) |
Ограничения службы Project Rome
Тип запроса | Ограничение на каждого пользователя для всех приложений |
---|---|
GET | 400 запросов в течение 5 минут и 12000 запросов в течение 1 дня |
POST, PUT, PATCH, DELETE | 100 запросов в течение 5 минут и 8000 запросов в течение 1 дня |
Указанные выше ограничения действуют для следующих ресурсов:
Ограничения службы обнаружений и инцидентов безопасности
Указанные ниже ограничения применяются к любому запросу в /security
.
Операция | Ограничение на приложение по клиенту |
---|---|
Любая операция с alert , securityActions secureScore |
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 секунд |
Предыдущие ограничения применяются к ресурсу подписки .
Ограничения службы для задач и планов
Ограничения службы для Планировщика недоступны.
Сведения, приведенные в этой статье, относятся к следующим ресурсам: