Microsoft Graph gibt in Bulk-Skripten 429 Too Many Requests zurück: Was Sie ändern sollten
Von Mirko Peters ·
Ihr Graph-Skript wird selbst bei einer Anfrage alle zehn Sekunden extrem langsam oder schlägt mit 429 fehl. Erfahren Sie, warum teure Eigenschaften und gemeinsam genutzte Kontingente eine Rolle spielen und wie Sie Anfragen verlangsamen, Aufrufe aufteilen und Batch-Anfragen sicher einsetzen.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Ein Skript liest Benutzerdaten aus Microsoft Graph, einen Benutzer nach dem anderen, mit einer langsamen und vorsichtigen Taktung. Dennoch erhält es 429 Too Many Requests. Ein Microsoft-Q&A-Thread vom Mai 2026 beschreibt genau diesen Fall: ein Aufruf für einen Benutzer, eine lange $select-Liste mit signInActivity, ein $expand=manager und ein Client, der alle zehn Sekunden eine Anfrage sendet, wobei jeweils nur eine Anfrage gleichzeitig läuft.
Das Wichtigste in Kürze
- Eine feste Anfragerate schützt nicht. Die Grenzwerte hängen vom Anfragetyp, von der App und vom Mandanten ab. Learn nennt für GET signInActivity 10 Anfragen pro Minute.
- Warten Sie die im Header Retry-After angegebene Anzahl Sekunden und wiederholen Sie dann die Anfrage. Learn weist darauf hin, dass Graph die Nutzung auch während einer Drosselung weiter erfasst. Sofortige Wiederholungen verschlechtern die Lage daher.
- Wenn Sie teure Eigenschaften aus den Aufrufen pro Benutzer auslagern, mit einem größeren $top paginieren und Delta-Abfragen oder Änderungsbenachrichtigungen nutzen, sinkt die Zahl der Anfragen.
- Bei einem $batch-Aufruf wird jede Anfrage einzeln bewertet. Der Batch gibt 200 zurück, während einzelne Anfragen darin mit 429 fehlschlagen. Diese werden nicht automatisch wiederholt.
Ein zweiter Thread vom Februar 2026 fragte, wie die Drosselung funktioniert, wenn viele SharePoint- und OneDrive-Laufwerke parallel gelesen werden. Zusammen zeigen beide Threads, warum eine einfache Ratenbegrenzung auf dem Client nicht ausreicht. Dieser Artikel erklärt, was Microsoft Learn dokumentiert und was die Threads nur nahelegen. Er ist ein Leitfaden zur Fehlerbehebung und kein offizielles Microsoft-Verfahren.
Was die Threads berichten
Thread vom Mai 2026 (Users-Endpunkt). Der Fragesteller erhielt 429 bei GET /v1.0/users/{id} mit vielen Eigenschaften, darunter signInActivity, sowie bei $expand=manager. Paginierung und Filter halfen nicht, weil jeder Aufruf genau einen Benutzer zurückgibt. Ein Microsoft-Moderator antwortete, dass nicht nur die Anfragerate, sondern vor allem die teuren Eigenschaften die Drosselung auslösen. Er empfahl, die Aufrufe aufzuteilen (Profil, Anmeldeaktivität, Manager), Retry-After mit exponentiellem Backoff zu beachten, zu cachen und die Anmeldeaktivität seltener abzufragen. Diese Antwort wurde nicht als Lösung markiert. Eine KI-generierte Antwort, die der Fragesteller als Lösung markiert hat, sagte im Wesentlichen dasselbe. Der Fragesteller schrieb nicht, ob die 429-Fehler danach aufgehört haben.
Thread vom Februar 2026 (driveItems). Der Fragesteller wollte wissen, ob die Drosselung pro Website oder pro Laufwerk greift und welche Parallelität sicher ist. Eine anonyme Antwort, die der Fragesteller akzeptiert hat, besagte, dass die Limits auf Mandanten-, App- und Dienstebene gestaffelt sind, dass Anfragen an verschiedene Websites dasselbe Kontingent beanspruchen können und dass Sie Retry-After beachten, $batch verwenden und Delta-Abfragen sowie Änderungsbenachrichtigungen dem Polling vorziehen sollten. Eine konkrete Zahl für die Parallelität wurde nicht genannt. Der Fragesteller schrieb, dass ihm die Antwort geholfen hat.
Schritt 1: Den 429-Fehler richtig lesen
Erfassen Sie bei jedem Fehler drei Dinge: die Anfrage-URL, den Wert von Retry-After und den Zeitpunkt. Die Seite zur Fehlerbehebung bei der Graph PowerShell auf Learn empfiehlt, ein Cmdlet mit -Debug auszuführen, um HTTP-Methode, URI und Statuscode zu sehen. Falls Sie ein Supportticket eröffnen, sollten Sie laut dieser Seite außerdem die Antwortheader request-id und date notieren.
Im Thread vom Mai 2026 wurde kein Wert für Retry-After genannt. Ohne diesen Wert kann niemand sagen, welches Limit das Skript erreicht hat.
Schritt 2: Retry-After einhalten
Die Learn-Seite zur Drosselung ist dazu eindeutig:
- Warten Sie so viele Sekunden, wie im Header
Retry-Afterangegeben sind. - Wiederholen Sie die Anfrage.
- Schlägt der Aufruf erneut mit 429 fehl, verwenden Sie dieselbe Verzögerung, bis er erfolgreich ist.
Learn erklärt auch, warum: Microsoft Graph protokolliert die Ressourcennutzung weiter, während ein Client gedrosselt wird. Ein Zurückfahren anhand des Headers ist deshalb der schnellste Weg zur Erholung. Sofortige Wiederholungen erhöhen Ihre Nutzung zusätzlich. Fehlt der Header Retry-After in der Antwort, empfiehlt Learn exponentielles Backoff.
Learn schreibt, dass die Microsoft Graph SDKs dies bereits übernehmen. Für die Graph PowerShell-Cmdlets sagt Learn das nicht, daher sollten Sie es nicht voraussetzen. Wenn Ihr Skript Rohaufrufe kapselt, etwa mit Invoke-MgGraphRequest, müssen Sie die Wartezeit selbst einbauen.
Schritt 3: Die teuren Aufrufe finden
Die Learn-Seite zu dienstspezifischen Limits enthält einen Abschnitt zu Identitäts- und Zugriffsberichten. Dort sind folgende Werte aufgeführt, die sich ändern können:
- Jede Anfrage in dieser Gruppe: 122 Anfragen pro 10 Sekunden pro App über alle Mandanten hinweg und 5 Anfragen pro 10 Sekunden pro App und Mandant.
GET signInActivity: 10 Anfragen pro Minute.
Ihr Skript, das alle zehn Sekunden läuft, macht 6 Aufrufe pro Minute. Das liegt rechnerisch unter 10. Der Thread sagt nicht, ob zur selben Zeit andere Jobs derselben App-Registrierung liefen. Solche Jobs würden sich das Budget teilen, da die Limits pro App und pro Mandant gelten. Dies ist eine Schlussfolgerung aus der Limit-Tabelle auf Learn, keine Aussage des Threads.
Learn weist außerdem darauf hin, dass $select=signInActivity bei List users strengere Drosselung auslösen kann als Standardaufrufe. Die Empfehlungen lauten:
- Verwenden Sie
$top=500, die maximale Seitengröße bei Auswahl vonsignInActivity, statt des Standardwerts 100. - Filtern Sie mit
$filteraufcreatedDateTime, um kleinere Zeiträume abzufragen. Beginnen Sie mit etwa drei Tagen Daten und verkleinern Sie den Zeitraum, falls Sie gedrosselt werden. - Die Eigenschaft
signInActivitybenötigt laut der Learn-Seite zu List users eine Lizenz für Microsoft Entra ID P1 oder P2 sowie die BerechtigungAuditLog.Read.All.
Wenn Sie die Anmeldeaktivität vieler Benutzer benötigen, gibt ein Listenaufruf wie GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 bis zu 500 Benutzer pro Anfrage zurück. Das bedeutet deutlich weniger Anfragen als ein Aufruf pro Benutzer. Die Learn-Seite zu List users dokumentiert diese Anfrage mit signInActivity. Ob sie auch dienstseitig weniger belastet, ist nicht angegeben, daher sollten Sie es messen.
Der Moderator im Mai-Thread schlug vor, signInActivity über den Beta-Endpunkt zu lesen. Die aktuelle v1.0-Referenz auf Learn dokumentiert signInActivity jedoch, Beta sollte dafür also nicht nötig sein. Prüfen Sie die Eigenschaft auf dem Endpunkt, den Sie verwenden.
Schritt 4: Die Anzahl der Anfragen reduzieren
Die Best Practices auf Learn gehen in dieselbe Richtung:
- Reduzieren Sie die Anzahl der Vorgänge pro Anfrage und die Häufigkeit der Aufrufe.
- Vermeiden Sie kontinuierliches Polling und regelmäßige Durchläufe großer Sammlungen. Nutzen Sie Änderungsverfolgung (Delta-Abfragen) und Änderungsbenachrichtigungen, sofern verfügbar.
- Speichern Sie Daten, die sich selten ändern, zwischen, etwa Vorgesetztenbeziehungen. Dieser Rat stammt vom Moderator im Mai-Thread und nicht von Learn.
Schritt 5: $batch mit Bedacht einsetzen
Batching kann Netzwerk-Roundtrips reduzieren. Die Learn-Seite zum JSON-Batching legt eine Obergrenze von 20 einzelnen Anfragen pro Batch fest. Außerdem heißt es dort:
- Jede Anfrage in einem Batch wird einzeln gegen die Drosselungsgrenzen geprüft. Überschreitet eine Anfrage diese Grenzen, schlägt sie mit 429 fehl, der Batch selbst gibt dennoch 200 zurück. In einem Batch können mehrere Anfragen gedrosselt werden.
- Wiederholen Sie jede fehlgeschlagene Anfrage anhand des Werts
retry-afterim Antworttext dieser Anfrage. Laut Learn können Sie alle Anfragen nach dem längsten Wertretry-afterin einem neuen Batch erneut senden. - Wenn ein SDK gedrosselte Anfragen außerhalb eines Batches automatisch wiederholt, gilt das für gedrosselte Anfragen innerhalb eines Batches nicht.
Batching hebt die Grenze also nicht auf. Es verlagert die Wiederholungslogik in Ihren Code.
Schritt 6: Lesezugriffe auf SharePoint und OneDrive planen
Für Durchsuchungen von Laufwerken heißt es auf der Learn-Seite zur SharePoint-Drosselung, dass SharePoint Online mit 429 oder 503 und einem Header Retry-After antwortet und dass gedrosselte Anfragen auf die Grenzwerte angerechnet werden. Die Seite nennt Drosselung auf Benutzer-, Mandanten- und Anwendungsebene. Die einzigen website-bezogenen Grenzwerte betreffen anonyme Links und anonymen Egress. Planen Sie daher keine separate Quote pro Website ein. Weitere Punkte aus dieser Seite:
- Datenverkehr ohne App-ID und ohne User-Agent-Zeichenfolge gilt als nicht gekennzeichnet. Laut Learn wird korrekt gekennzeichneter Datenverkehr gegenüber nicht gekennzeichnetem bevorzugt. Die dokumentierten User-Agent-Formate sind
ISV|CompanyName|AppName/VersionundNONISV|CompanyName|AppName/Version. - Eine Abfrage eines einzelnen Elements kostet 1 Ressourceneinheit, eine Abfrage mehrerer Elemente oder ein Schreibvorgang kostet 2. Berechtigungsoperationen, einschließlich
$expand=permissions, kosten 5. Vermeiden Sie das Expandieren von Berechtigungen bei Massenscans. - Learn empfiehlt, nach Möglichkeit Microsoft Graph statt CSOM und REST zu verwenden, da dieser in der Regel weniger Ressourcen beansprucht.
Im Februar-Thread ging es auch um 410 Gone bei Delta-Abfragen. Laut der dortigen Antwort bedeutet dies, dass das Delta-Token nicht mehr verwendet werden kann und der Client mit einer neuen initialen Delta-Abfrage neu beginnen muss. Berücksichtigen Sie dies bei jeder inkrementellen Synchronisation.
Überprüfen
- Protokollieren Sie für einen Durchlauf die Anzahl der 429-Antworten und die Werte
Retry-Afterjeweils vor und nach Ihren Änderungen. - Führen Sie das Skript allein aus, ohne dass ein anderer Auftrag dieselbe App-Registrierung verwendet, um die Wirkung Ihrer eigenen Aufrufe zu sehen.
- Wenn die Drosselung trotz korrekter Backoff-Logik und reduzierter Aufrufe anhält, erfassen Sie die Header
request-idunddateund eröffnen Sie einen Supportfall.
Limits
- Der Thread vom Mai 2026 hat kein bestätigtes Ergebnis, und die dort akzeptierte Antwort wurde durch KI erzeugt. Als Grundlage dienen hier die oben genannten Learn-Empfehlungen.
- Die Frage des Fragenstellers zu Benutzern ohne
signInActivity-Block blieb im Thread unbeantwortet. Learn beschreibt diesen Fall ebenfalls nicht. Behandeln Sie einen fehlenden Block daher als unbekannt. Learn weist aber darauf hin, dasslastSuccessfulSignInDateTimevor dem 1. Dezember 2023 nicht nachgetragen wird. Ein leerer Wert beweist deshalb nicht, dass sich der Benutzer nie angemeldet hat. - Laut Learn können sich die aufgeführten Grenzwerte ändern. Prüfen Sie die aktuelle Seite, bevor Sie eine Lösung auf einen bestimmten Wert aufbauen.
Verwandte Themen
Quellen
- Microsoft Learn: Leitfaden zur Drosselung von Microsoft Graph
- Microsoft Learn: Dienstspezifische Drosselungsgrenzen von Microsoft Graph
- Microsoft Learn: Mehrere Anfragen mit JSON-Batching kombinieren
- Microsoft Learn: Benutzer auflisten
- Microsoft Learn: Ressourcentyp signInActivity
- Microsoft Learn: So vermeiden Sie Drosselung und Blockierung in SharePoint Online
- Microsoft Learn: Häufige Fehler in Microsoft Graph PowerShell beheben
- Microsoft Q&A: Drosselungsproblem beim users-Endpunkt (Mai 2026)
- Microsoft Q&A: Verhalten der Drosselung bei Microsoft Graph bei der parallelen Verarbeitung von driveItems (Februar 2026)