M365Con 2027 – bezpłatna konferencja online · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph zwraca 429 Too Many Requests w skryptach masowych: co zmienić

By ·

Twój skrypt Graph zwalnia do ślimaczego tempa lub kończy się błędem 429, nawet przy jednym żądaniu co dziesięć sekund. Dowiedz się, dlaczego kosztowne właściwości i wspólne limity mają znaczenie, jak zwalniać tempo, dzielić wywołania i bezpiecznie grupować żądania w paczki.

Automatically translated with AI from the original post. Read the English original

Skrypt odczytuje dane użytkowników z Microsoft Graph, jednego użytkownika naraz, z małą i ostrożną częstotliwością. Mimo to otrzymuje 429 Too Many Requests. Wątek Q&A Microsoft z maja 2026 r. opisuje dokładnie ten przypadek: wywołanie dla jednego użytkownika, długa lista $select zawierająca signInActivity, parametr $expand=manager oraz klient ustawiony na jedno żądanie co dziesięć sekund, z jednym żądaniem w toku.

Najważniejsze wnioski

  • Stała częstotliwość żądań nie chroni przed limitami. Limity zależą od typu żądania, aplikacji i dzierżawy. Learn podaje, że GET signInActivity jest ograniczony do 10 żądań na minutę.
  • Odczekaj liczbę sekund podaną w nagłówku Retry-After, a następnie ponów żądanie. Learn podaje, że Graph nadal rejestruje wykorzystanie podczas throttlingu, więc natychmiastowe ponowienia tylko pogarszają sytuację.
  • Wyodrębnienie kosztownych właściwości z wywołań dla pojedynczych użytkowników, stronicowanie z większym $top oraz używanie delta lub powiadomień o zmianach zmniejszają liczbę żądań.
  • W wywołaniu $batch każde żądanie jest oceniane osobno. Paczka zwraca 200, podczas gdy pojedyncze żądania w jej wnętrzu kończą się błędem 429 i nie są za Ciebie ponawiane.

Drugi wątek, z lutego 2026 r., dotyczy tego, jak działa throttling, gdy równolegle odczytuje się wiele dysków SharePoint i OneDrive. Razem oba wątki pokazują, dlaczego prosty limit częstotliwości po stronie klienta nie wystarcza. Ten artykuł wyjaśnia, co dokumentuje Microsoft Learn, a co wątki tylko sugerowały. To przewodnik rozwiązywania problemów, a nie oficjalna procedura Microsoft.

Co zgłaszały wątki

Wątek z maja 2026 r. (punkt końcowy users). Autor pytania otrzymał 429 przy GET /v1.0/users/{id} z wieloma właściwościami, w tym signInActivity, oraz z $expand=manager. Stronicowanie i filtry nie pomogły, ponieważ każde wywołanie zwracało jednego użytkownika. Moderator Microsoft odpowiedział, że o throttlingu decydują kosztowne właściwości, a nie tylko częstotliwość żądań. Zasugerował podzielenie wywołań (profil, aktywność logowania, menedżer), respektowanie Retry-After z wykładniczym ponawianiem, buforowanie oraz rzadsze odczytywanie aktywności logowania. Ta odpowiedź nie została oznaczona jako zaakceptowana. Podobną treść miała odpowiedź wygenerowana przez AI, którą autor pytania oznaczył jako zaakceptowaną. Autor nie napisał, czy błędy 429 ustały.

Wątek z lutego 2026 (driveItems). Osoba pytająca chciała wiedzieć, czy ograniczenia przepustowości (throttling) dotyczą witryny czy dysku, oraz jaki poziom równoległości jest bezpieczny. Anonimowa odpowiedź, zaakceptowana przez pytającego, wskazywała, że limity są warstwowe: na poziomie dzierżawy, aplikacji i usługi, że żądania kierowane do różnych witryn mogą korzystać z tej samej puli przydziału oraz że należy respektować nagłówek Retry-After, używać $batch i wybierać zapytania delta oraz powiadomienia o zmianach zamiast odpytywania. Nie podano żadnej liczby określającej równoległość. Pytający napisał, że to pomogło.

Krok 1: Dokładnie odczytaj błąd 429

Przy każdym niepowodzeniu zapisz trzy rzeczy: adres URL żądania, wartość Retry-After i czas. Strona Learn poświęcona rozwiązywaniu problemów z Graph PowerShell sugeruje uruchomienie polecenia cmdlet z parametrem -Debug, aby zobaczyć metodę HTTP, URI i kod stanu, a jeśli zgłaszasz sprawę do pomocy technicznej, zaleca zapisanie nagłówków odpowiedzi request-id i date.

W wątku z maja 2026 nie podano wartości Retry-After. Bez niej nikt nie jest w stanie określić, który limit skrypt przekroczył.

Krok 2: Respektuj Retry-After

Strona Learn o throttlingu jest w tej kwestii jednoznaczna:

  1. Odczekaj liczbę sekund podaną w nagłówku Retry-After.
  2. Ponów żądanie.
  3. Jeśli ponownie pojawi się błąd 429, nadal stosuj to samo opóźnienie, aż żądanie się powiedzie.

Learn wyjaśnia, dlaczego: usługa Microsoft Graph nadal rejestruje wykorzystanie zasobów, gdy klient jest objęty throttlingiem, więc wstrzymanie się zgodnie z nagłówkiem jest najszybszym sposobem na odzyskanie dostępu. Natychmiastowe ponowienia zwiększają zużycie. Jeśli odpowiedź nie zawiera nagłówka Retry-After, Learn zaleca wykładniczy mechanizm ponawiania (exponential backoff).

Learn podaje, że zestawy SDK Microsoft Graph obsługują to już same. Nie mówi tego samego o cmdlet-ach Graph PowerShell, więc nie zakładaj tego. Jeśli skrypt opakowuje surowe wywołania, na przykład Invoke-MgGraphRequest, sam zaimplementuj oczekiwanie.

Krok 3: Znajdź kosztowne wywołania

Strona Learn o limitach specyficznych dla usług ma sekcję dotyczącą raportów tożsamości i dostępu. Wymienia ona poniższe wartości, które mogą ulec zmianie:

  • Każde żądanie z tej grupy: 122 żądania na 10 sekund na aplikację we wszystkich dzierżawach oraz 5 żądań na 10 sekund na aplikację w jednej dzierżawie.
  • GET signInActivity: 10 żądań na minutę.

Twój skrypt, wykonujący jedno wywołanie co dziesięć sekund, wysyła 6 wywołań na minutę, co na papierze mieści się w limicie 10. Wątek nie mówi, czy w tym samym czasie działały inne zadania z tej samej rejestracji aplikacji. Takie zadania współdzieliłyby budżet, ponieważ limity obowiązują na poziomie aplikacji i dzierżawy. To wniosek wyciągnięty z tabeli limitów Learn, a nie informacja podana w wątku.

Learn wskazuje również, że $select=signInActivity w wywołaniu List users może powodować surowszy throttling niż standardowe wywołania. Zalecenia są następujące:

  • Użyj $top=500, czyli maksymalnego rozmiaru strony przy wybieraniu signInActivity, zamiast domyślnych 100.
  • Użyj $filter na createdDateTime, aby odpytywać mniejsze przedziały czasu. Zacznij od około trzech dni danych i zawęź przedział, jeśli zostaniesz objęty throttlingiem.
  • Właściwość signInActivity wymaga licencji Microsoft Entra ID P1 lub P2 oraz uprawnienia AuditLog.Read.All, zgodnie ze stroną Learn dotyczącą List users.

Jeśli potrzebujesz danych o logowaniach wielu użytkowników, wywołanie listy, takie jak GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500, zwraca do 500 użytkowników w jednym żądaniu. Oznacza to znacznie mniej żądań niż jedno wywołanie na użytkownika. Strona Learn List users dokumentuje to żądanie z signInActivity. Nie podano, czy jest ono też lżejsze dla usługi, dlatego warto to zmierzyć.

Moderator w wątku z maja sugerował odczytywanie signInActivity przez punkt końcowy beta. Aktualna dokumentacja referencyjna Learn dla v1.0 opisuje signInActivity, więc do tego nie powinno być potrzebne beta. Sprawdź tę właściwość w punkcie końcowym, którego używasz.

Krok 4: Ogranicz liczbę żądań

Najlepsze praktyki Learn wskazują ten sam kierunek:

  • Zmniejsz liczbę operacji w jednym żądaniu oraz częstotliwość wywołań.
  • Unikaj ciągłego odpytywania i regularnego skanowania dużych kolekcji. Używaj śledzenia zmian (zapytania delta) oraz powiadomień o zmianach, jeśli są dostępne.
  • Buforuj dane, które rzadko się zmieniają, na przykład relacje menedżerów. To porada moderatora z wątku z maja, a nie stwierdzenie Learn.

Krok 5: Ostrożnie używaj $batch

Grupowanie żądań może ograniczyć liczbę podróży w obie strony w sieci. Strona Learn o grupowaniu JSON ustala limit 20 pojedynczych żądań w jednej partii. Podaje również, że:

  • Każde żądanie w wsadzie jest oceniane pod kątem limitów ograniczania przepustowości osobno. Jeśli któreś je przekracza, kończy się błędem 429, a sam wsad zwraca 200. W jednym wsadzie może zostać ograniczonych kilka żądań.
  • Ponów każde nieudane żądanie, używając wartości retry-after z treści odpowiedzi dla tego konkretnego żądania. Dokumentacja Learn sugeruje, że można ponowić wszystkie w nowym wsadzie po upływie najdłuższej wartości retry-after.
  • Jeśli SDK ponawia ograniczone żądania wysyłane poza wsadem, to ograniczone żądania wewnątrz wsadu nie są ponawiane automatycznie.

Wsadowanie więc nie znosi limitu. Przenosi logikę ponawiania do Twojego kodu.

Krok 6: Zaplanuj odczyty z SharePoint i OneDrive

W przypadku skanowania dysków strona Learn o ograniczaniu przepustowości w SharePoint Online podaje, że SharePoint Online zwraca 429 lub 503 z nagłówkiem Retry-After, a żądania ograniczone wliczają się do limitów. Wymienia ograniczenia na poziomie użytkownika, dzierżawy i aplikacji, a jedyne limity dla pojedynczych witryn dotyczą anonimowych linków i anonimowego ruchu wychodzącego. Nie planuj według osobnego limitu przydziału dla każdej witryny. Inne istotne punkty z tej strony:

  • Ruch bez identyfikatora aplikacji i bez ciągu User-Agent jest nieoznaczony. Learn podaje, że prawidłowo oznaczony ruch ma pierwszeństwo przed nieoznaczonym. Udokumentowane formaty User-Agent to ISV|CompanyName|AppName/Version oraz NONISV|CompanyName|AppName/Version.
  • Zapytanie o pojedynczy element kosztuje 1 jednostkę zasobów, zapytanie o wiele elementów lub zapis kosztuje 2, a operacje na uprawnieniach, w tym $expand=permissions, kosztują 5. Unikaj rozwijania uprawnień w masowych skanowaniach.
  • Learn zaleca, o ile to możliwe, używanie Microsoft Graph zamiast CSOM i REST, ponieważ zwykle zużywa mniej zasobów.

Lutowy wątek dotyczył także odpowiedzi 410 Gone w zapytaniach delta. Według odpowiedzi w nim zawartej oznacza ona, że token delta nie może być już użyty, a klient powinien rozpocząć od nowa od początkowego zapytania delta. Uwzględnij to w każdej synchronizacji przyrostowej.

Weryfikacja

  1. Zapisz liczbę odpowiedzi 429 oraz wartości Retry-After z jednego przebiegu przed i po wprowadzeniu zmian.
  2. Uruchom skrypt samodzielnie, bez innych zadań używających tej samej rejestracji aplikacji, aby zobaczyć efekt własnych wywołań.
  3. Jeśli ograniczanie nadal występuje mimo prawidłowego wycofywania (backoff) i mniejszej liczby wywołań, zbierz nagłówki request-id i date i otwórz zgłoszenie do pomocy technicznej.

Limity

  • Wątek z maja 2026 r. nie ma potwierdzonego wyniku, a zaakceptowana w nim odpowiedź została wygenerowana przez AI. Jako dowód wykorzystano wskazówki Learn przytoczone powyżej.
  • Pytanie autora o użytkowników bez bloku signInActivity nie zostało w wątku rozstrzygnięte. Learn także tego nie opisuje, więc brak bloku należy traktować jako nieznany. Learn wyjaśnia jednak, że lastSuccessfulSignInDateTime nie jest uzupełniane wstecznie przed 1 grudnia 2023 r., więc pusta wartość nie dowodzi, że użytkownik nigdy się nie logował.
  • Limity podane przez Learn są oznaczone jako podlegające zmianom. Zanim zbudujesz na nich rozwiązanie, sprawdź aktualną wersję strony.

Powiązane

Źródła

Entities in this article

Microsoft Graph Microsoft Graph PowerShell Throttling

Related articles

RSS