M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph gibt in Bulk-Skripten 429 Too Many Requests zurück: Was Sie ändern sollten

Von ·

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:

  1. Warten Sie so viele Sekunden, wie im Header Retry-After angegeben sind.
  2. Wiederholen Sie die Anfrage.
  3. 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 von signInActivity, statt des Standardwerts 100.
  • Filtern Sie mit $filter auf createdDateTime, um kleinere Zeiträume abzufragen. Beginnen Sie mit etwa drei Tagen Daten und verkleinern Sie den Zeitraum, falls Sie gedrosselt werden.
  • Die Eigenschaft signInActivity benötigt laut der Learn-Seite zu List users eine Lizenz für Microsoft Entra ID P1 oder P2 sowie die Berechtigung AuditLog.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-after im Antworttext dieser Anfrage. Laut Learn können Sie alle Anfragen nach dem längsten Wert retry-after in 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/Version und NONISV|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

  1. Protokollieren Sie für einen Durchlauf die Anzahl der 429-Antworten und die Werte Retry-After jeweils vor und nach Ihren Änderungen.
  2. Führen Sie das Skript allein aus, ohne dass ein anderer Auftrag dieselbe App-Registrierung verwendet, um die Wirkung Ihrer eigenen Aufrufe zu sehen.
  3. Wenn die Drosselung trotz korrekter Backoff-Logik und reduzierter Aufrufe anhält, erfassen Sie die Header request-id und date und 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, dass lastSuccessfulSignInDateTime vor 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

Entitäten in diesem Artikel

Microsoft Graph Microsoft Graph PowerShell Throttling

Verwandte Artikel

RSS