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. У гілці Q&A Microsoft від травня 2026 року описано саме таку ситуацію: виклик для одного користувача, довгий список $select, що містить signInActivity, $expand=manager, а клієнт налаштовано на один запит на десять секунд і один запит в обробці.
Головне
- Фіксована частота запитів не захищає вас. Ліміти залежать від типу запиту, застосунку і клієнта. Learn наводить ліміт GET signInActivity: 10 запитів на хвилину.
- Зачекайте кількість секунд, зазначену в заголовку Retry-After, а потім повторіть запит. Learn пише, що Graph продовжує враховувати використання навіть під час обмеження, тож негайні повтори лише погіршують situацію.
- Винесення дорогих властивостей з викликів для кожного користувача, пагінація з більшим $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). Автор питання хотів дізнатися, чи застосовується обмеження швидкості окремо для сайту чи для диска, і яка кількість паралельних запитів є безпечною. Анонімна відповідь, яку автор питання прийняв, пояснювала, що ліміти діють на кількох рівнях: клієнт, застосунок і служба. Запити до різних сайтів можуть використовувати одну й ту саму квоту. Також радили дотримуватися Retry-After, використовувати $batch і віддавати перевагу delta-запитам та сповіщенням про зміни замість опитування. Числа для паралельності там не було. Автор питання написав, що це допомогло.
Крок 1: правильно прочитайте 429
Під час кожної помилки фіксуйте три речі: URL запиту, значення Retry-After і час. На сторінці Learn про усунення несправностей у Graph PowerShell сказано, що для перегляду HTTP-методу, URI та коду стану можна запустити командлет з -Debug. Також там радять записати заголовки відповіді request-id і date, якщо ви відкриваєте звернення до служби підтримки.
У треді за травень 2026 значення Retry-After не наводилося. Без нього ніхто не може сказати, який саме ліміт спрацював у скрипті.
Крок 2: дотримуйтеся Retry-After
Сторінка Learn про обмеження швидкості тут однозначна:
- Зачекайте кількість секунд, зазначену в заголовку
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 запитів на хвилину.
Ваш скрипт, що виконує один виклик за десять секунд, робить 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для одного запуску до та після внесених змін. - Запускайте скрипт окремо, без інших завдань, що використовують той самий реєстр застосунку, щоб побачити ефект власних викликів.
- Якщо тротлінг триває, попри правильну затримку повторів і зменшену кількість викликів, зберіть заголовки
request-idіdateта відкрийте звернення до підтримки.
Обмеження
- Дискусія за травень 2026 року не має підтвердженого результату, а прийнята відповідь у ній була згенерована ШІ. Як доказ тут використано настанови Learn, наведені вище.
- Запитання автора про користувачів без блоку
signInActivityу дискусії так і не отримало відповіді. Learn також це не описує, тож відсутність блоку слід вважати невідомим станом. Learn каже, щоlastSuccessfulSignInDateTimeне заповнюється заднім числом для дат до 1 грудня 2023 року, тож порожнє значення не доводить, що користувач ніколи не входив у систему. - Обмеження, наведені в Learn, позначені як такі, що можуть змінюватися. Перш ніж будувати рішення навколо конкретного числа, перевірте актуальну сторінку.
Пов'язане
Джерела
- Microsoft Learn: Microsoft Graph throttling guidance
- Microsoft Learn: Microsoft Graph service-specific throttling limits
- Microsoft Learn: Об'єднання кількох запитів за допомогою пакетування JSON
- Microsoft Learn: List users
- Microsoft Learn: signInActivity resource type
- Microsoft Learn: Як уникнути обмеження швидкості та блокування в SharePoint Online
- Microsoft Learn: Усунення типових помилок у Microsoft Graph PowerShell
- Microsoft Q&A: Проблема з обмеженням швидкості для кінцевої точки users (травень 2026)
- Microsoft Q&A: Поведінка обмеження швидкості Microsoft Graph під час паралельної обробки driveItems (лютий 2026)