Microsoft Graph возвращает 429 Too Many Requests в массовых скриптах: что изменить
By Mirko Peters ·
Ваш скрипт Graph замедляется до ползания или падает с 429 даже при одном запросе каждые десять секунд. Разберитесь, почему важны дорогие свойства и общие квоты, как делать паузы, разбивать вызовы и безопасно использовать пакетные запросы.
Automatically translated with AI from the original post. Read the English original
Скрипт читает данные пользователей из Microsoft Graph по одному пользователю за раз, медленно и аккуратно. Тем не менее он получает 429 Too Many Requests. Обсуждение Microsoft Q&A от мая 2026 года описывает именно эту ситуацию: вызов для одного пользователя, длинный список $select, включающий signInActivity, параметр $expand=manager, а клиент настроен на один запрос каждые десять секунд с одним запросом в работе.
Ключевые выводы
- Фиксированная частота запросов не защищает вас. Ограничения зависят от типа запроса, приложения и клиента. Learn указывает для GET signInActivity лимит 10 запросов в минуту.
- Подождите количество секунд, указанное в заголовке Retry-After, и только потом повторите запрос. Learn сообщает, что Graph продолжает учитывать использование, пока действует ограничение, поэтому немедленные повторные попытки только ухудшают ситуацию.
- Вынос дорогих свойств из запросов по каждому пользователю, постраничная выборка с большим $top и использование delta-запросов или уведомлений об изменениях сокращают количество запросов.
- В вызове $batch каждый запрос оценивается отдельно. Пакет возвращает 200, а отдельные запросы внутри него завершаются с 429, и повторно они за вас не отправляются.
Второе обсуждение, от февраля 2026 года, спрашивало, как работает ограничение при параллельном чтении множества дисков SharePoint и OneDrive. Вместе два обсуждения показывают, почему простого ограничения частоты на стороне клиента недостаточно. Эта статья объясняет, что документирует Microsoft Learn, и что в обсуждениях было лишь предположено. Это руководство по устранению неполадок, а не официальная процедура Microsoft.
Что сообщили обсуждения
Обсуждение от мая 2026 года (эндпоинт users). Автор вопроса получил 429 на GET /v1.0/users/{id} с большим количеством свойств, включая signInActivity, а также $expand=manager. Постраничная выборка и фильтры не помогли, поскольку каждый вызов возвращал одного пользователя. Модератор Microsoft ответил, что ограничение вызывают дорогие свойства, а не только частота запросов. Он предложил разбить вызовы (профиль, активность входа, руководитель), учитывать Retry-After с экспоненциальной задержкой, использовать кэширование и читать активность входа реже. Этот ответ не был отмечен как принятый. Ответ, сгенерированный ИИ, который автор вопроса отметил как принятый, говорил примерно то же. Автор не сообщил, прекратились ли ошибки 429.
Тред за февраль 2026 года (driveItems). Автор вопроса хотел знать, применяется ли ограничение частоты запросов (throttling) на уровне сайта или диска и какой уровень параллельности безопасен. Анонимный ответ, который автор вопроса принял, сообщал, что ограничения действуют на нескольких уровнях: клиент, приложение и сервис; что запросы к разным сайтам могут расходовать одну и ту же квоту; что нужно учитывать Retry-After, использовать $batch и предпочитать delta-запросы и уведомления об изменениях опросу. Числового значения параллельности в ответе не было. Автор вопроса написал, что ответ помог.
Шаг 1: правильно читаем ответ 429
При каждой ошибке сохраняйте три вещи: URL запроса, значение Retry-After и время. На странице Learn о диагностике Graph PowerShell говорится, что чтобы увидеть HTTP-метод, URI и код состояния, можно запустить командлет с -Debug, а при обращении в поддержку нужно записать заголовки ответа request-id и date.
В майском треде значение Retry-After не приводилось. Без него никто не может сказать, какое именно ограничение сработало в скрипте.
Шаг 2: соблюдаем Retry-After
Страница Learn о throttling на этот счёт однозначна:
- Подождите количество секунд, указанное в заголовке
Retry-After. - Повторите запрос.
- Если снова возвращается 429, продолжайте использовать ту же задержку, пока запрос не выполнится успешно.
Learn объясняет почему: Microsoft Graph продолжает учитывать использование ресурсов, пока клиент получает ограничение, поэтому пауза по заголовку — самый быстрый способ восстановиться. Немедленные повторные попытки только увеличивают нагрузку. Если в ответе нет заголовка Retry-After, Learn рекомендует экспоненциальную задержку между повторами.
Learn указывает, что SDK Microsoft Graph уже обрабатывают это автоматически. Для командлетов Graph PowerShell такого не сказано, поэтому не стоит на это рассчитывать. Если ваш скрипт оборачивает прямые вызовы, например Invoke-MgGraphRequest, реализуйте ожидание сами.
Шаг 3: находим дорогие вызовы
На странице Learn о лимитах для конкретных сервисов есть раздел для отчётов об идентификации и доступе. В нём приведены следующие значения, которые могут измениться:
- Любой запрос из этой группы: 122 запроса за 10 секунд на приложение во всех клиентах и 5 запросов за 10 секунд на приложение в одном клиенте.
GET signInActivity: 10 запросов в минуту.
Ваш скрипт, который делает один вызов каждые 10 секунд, выполняет 6 вызовов в минуту, что на бумаге меньше 10. В треде не сказано, запускались ли в это же время другие задачи из той же регистрации приложения. Такие задачи делили бы один и тот же лимит, поскольку ограничения действуют на приложение и на клиент. Это вывод из таблицы лимитов Learn, а не утверждение из треда.
Learn также отмечает, что $select=signInActivity в запросе List users может вызывать более строгое ограничение частоты, чем стандартные вызовы. Рекомендации такие:
- Используйте
$top=500— максимальный размер страницы при выборкеsignInActivity— вместо значения по умолчанию 100. - Используйте
$filterпоcreatedDateTime, чтобы запрашивать более короткие временные интервалы. Начните примерно с трёх дней данных и сужайте интервал, если получаете ограничение. - По данным страницы Learn о List users, для свойства
signInActivityнужна лицензия Microsoft Entra ID P1 или P2 и разрешениеAuditLog.Read.All.
Если нужна активность входа для многих пользователей, запрос к списку, например GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500, возвращает до 500 пользователей за один запрос. Это значительно меньше запросов, чем один вызов на пользователя. Страница Learn о List users документирует этот запрос с signInActivity. Будет ли он также легче для сервиса, не указано, поэтому измерьте это сами.
Модератор в майском треде предложил читать signInActivity через бета-эндпоинт. В актуальной справке Learn для v1.0 свойство signInActivity описано, так что бета для него, вероятно, не нужна. Проверьте свойство на том эндпоинте, который вы используете.
Шаг 4: сокращаем количество запросов
Рекомендации Learn по лучшим практикам идут в том же направлении:
- Уменьшайте количество операций в одном запросе и частоту вызовов.
- Избегайте непрерывного опроса и регулярного сканирования больших коллекций. Используйте отслеживание изменений (delta-запросы) и уведомления об изменениях, если они доступны.
- Кэшируйте данные, которые меняются нечасто, например связи с руководителями. Это совет модератора из майского треда, а не утверждение Learn.
Шаг 5: осторожно с $batch
Пакетная обработка может сократить количество сетевых обращений. На странице Learn о пакетной обработке JSON установлен лимит в 20 отдельных запросов в одном пакете. Там также сказано:
- Каждый запрос в пакете проверяется на соответствие лимитам троттлинга независимо от других. Если запрос превышает их, он завершается с кодом 429, а сам пакет возвращает 200. В одном пакете может быть ограничено сразу несколько запросов.
- Повторяйте каждый неудачный запрос, используя значение
retry-afterиз тела ответа для этого запроса. Learn говорит, что можно повторить их все новым пакетом после самого большого значенияretry-after. - Если SDK автоматически повторяет запросы с троттлингом, когда они не пакетированы, то запросы с троттлингом внутри пакета автоматически не повторяются.
Таким образом, пакетирование не снимает ограничение. Оно переносит логику повторных попыток в ваш код.
Шаг 6: Спланируйте чтение из SharePoint и OneDrive
Для сканирования дисков страница Learn о троттлинге SharePoint говорит, что SharePoint Online возвращает 429 или 503 с заголовком Retry-After, а запросы с троттлингом учитываются в лимитах. Страница перечисляет троттлинг на уровне пользователя, клиента и приложения, а единственные лимиты на уровне сайта относятся к анонимным ссылкам и анонимному исходящему трафику. Не закладывайте отдельную квоту на каждый сайт. Другие моменты из этой статьи:
- Трафик без идентификатора приложения и без строки User-Agent считается недекорированным. Learn говорит, что корректно оформленный трафик обрабатывается в приоритете перед недекорированным. Документированные форматы User-Agent:
ISV|CompanyName|AppName/VersionиNONISV|CompanyName|AppName/Version. - Запрос одного элемента стоит 1 единицу ресурсов, запрос нескольких элементов или запись стоит 2, а операции с разрешениями, включая
$expand=permissions, стоят 5. Избегайте раскрытия разрешений при массовом сканировании. - Learn рекомендует по возможности использовать Microsoft Graph вместо CSOM и REST, так как он обычно расходует меньше ресурсов.
В февральской ветке обсуждения также упоминался 410 Gone для delta-запросов. Ответ там гласил, что это означает, что delta-токен больше не может использоваться и клиенту нужно начать заново с нового начального delta-запроса. Учитывайте это в любой инкрементальной синхронизации.
Проверка
- Записывайте количество ответов 429 и значения
Retry-Afterза один запуск до и после ваших изменений. - Запускайте скрипт отдельно, без других задач, использующих ту же регистрацию приложения, чтобы увидеть эффект от ваших собственных вызовов.
- Если троттлинг сохраняется при корректной экспоненциальной задержке (backoff) и сокращённом числе вызовов, соберите заголовки
request-idиdateи откройте обращение в поддержку.
Ограничения
- По майской ветке обсуждения подтверждённого результата нет, а принятый там ответ был создан ИИ. Здесь в качестве подтверждения используются рекомендации Learn, приведённые выше.
- Вопрос автора о пользователях без блока
signInActivityв этой ветке так и остался без ответа. Learn это тоже не описывает, поэтому отсутствие блока следует считать неизвестным. Learn при этом указывает, чтоlastSuccessfulSignInDateTimeне заполняется задним числом до 1 декабря 2023 года, поэтому пустое значение не доказывает, что пользователь никогда не входил в систему. - Лимиты, указанные в Learn, помечены как подлежащие изменению. Проверяйте актуальную страницу, прежде чем строить решение вокруг конкретного числа.
Связанные материалы
Источники
- Microsoft Learn: рекомендации по троттлингу Microsoft Graph
- Microsoft Learn: ограничения троттлинга для сервисов Microsoft Graph
- Microsoft Learn: объединение нескольких запросов с помощью JSON-пакетирования
- Microsoft Learn: список пользователей
- Microsoft Learn: тип ресурса signInActivity
- Microsoft Learn: как не попасть под троттлинг и блокировку в SharePoint Online
- Microsoft Learn: устранение распространённых ошибок в Microsoft Graph PowerShell
- Microsoft Q&A: проблема с ограничением частоты запросов (throttling) для эндпоинта users (май 2026)
- Microsoft Q&A: поведение ограничения частоты запросов (throttling) в Microsoft Graph при параллельной обработке driveItems (февраль 2026)