Microsoft Graph geeft 429 Too Many Requests bij bulkscripts: wat je moet aanpassen
By Mirko Peters ·
Je Graph-script wordt traag of faalt met 429, zelfs bij één verzoek per tien seconden. Ontdek waarom dure eigenschappen en gedeelde quota ertoe doen, en hoe je terugschaalt, aanroepen opsplitst en veilig batcht.
Automatically translated with AI from the original post. Read the English original
Een script leest gebruikersgegevens uit Microsoft Graph, één gebruiker tegelijk, met een trage en voorzichtige snelheid. Toch krijgt het 429 Too Many Requests. Een Microsoft Q&A-thread van mei 2026 beschrijft precies dit: een aanroep voor één gebruiker, een lange $select-lijst met signInActivity, een $expand=manager, en een client die één verzoek per tien seconden stuurt, met één verzoek tegelijk onderweg.
Belangrijkste punten
- Een vaste verzoeksnelheid beschermt je niet. Limieten hangen af van het type verzoek, de app en de tenant. Learn noemt GET signInActivity op 10 verzoeken per minuut.
- Wacht het aantal seconden uit de Retry-After-header en probeer het dan opnieuw. Learn zegt dat Graph het gebruik blijft registreren terwijl je gethrottled wordt, dus directe nieuwe pogingen maken het erger.
- Dure eigenschappen uit de aanroepen per gebruiker halen, pagineren met een grotere $top, en delta of change notifications gebruiken, verlaagt het aantal verzoeken.
- Bij een $batch-aanroep wordt elk verzoek afzonderlijk beoordeeld. De batch geeft 200 terug, terwijl losse verzoeken erin falen met 429. Die worden niet automatisch opnieuw geprobeerd.
Een tweede thread, uit februari 2026, vroeg hoe throttling werkt wanneer veel SharePoint- en OneDrive-drives parallel worden gelezen. Samen laten de twee threads zien waarom een eenvoudige snelheidslimiet aan de clientkant niet genoeg is. Dit artikel legt uit wat Microsoft Learn documenteert en wat de threads alleen suggereerden. Het is een troubleshootinggids, geen officiële Microsoft-procedure.
Wat de threads meldden
Thread van mei 2026 (users-endpoint). De vrager kreeg 429 op GET /v1.0/users/{id} met veel eigenschappen, waaronder signInActivity, plus $expand=manager. Paginering en filters hielpen niet, omdat elke aanroep één gebruiker teruggaf. Een Microsoft-moderator antwoordde dat de dure eigenschappen, en niet alleen de verzoeksnelheid, de throttling veroorzaken. De moderator stelde voor de aanroepen op te splitsen (profiel, aanmeldactiviteit, manager), Retry-After te respecteren met exponentiële backoff, te cachen, en aanmeldactiviteit minder vaak uit te lezen. Dat antwoord was niet als geaccepteerd gemarkeerd. Een door AI gegenereerd antwoord, dat de vrager wel als geaccepteerd markeerde, zei vrijwel hetzelfde. De vrager heeft niet laten weten of de 429's zijn gestopt.
Thread van februari 2026 (driveItems). De vraagsteller wilde weten of throttling per site of per drive geldt, en welke gelijktijdigheid veilig is. Een anoniem antwoord, door de vraagsteller geaccepteerd, zei dat de limieten gelaagd zijn over tenant, app en service, dat verzoeken naar verschillende sites uit hetzelfde quotum kunnen putten, en dat je Retry-After moet respecteren, $batch moet gebruiken en delta-query's en wijzigingsmeldingen moet verkiezen boven polling. Er werd geen getal voor gelijktijdigheid genoemd. De vraagsteller gaf aan dat het had geholpen.
Stap 1: Lees de 429 goed
Leg bij elke fout drie dingen vast: de aanvraag-URL, de waarde van Retry-After en het tijdstip. De Learn-pagina over het oplossen van problemen met Graph PowerShell adviseert om een cmdlet met -Debug uit te voeren om de HTTP-methode, URI en statuscode te zien, en vermeldt dat je de responsheaders request-id en date moet noteren als je een supportticket opent.
De thread van mei 2026 noemde geen waarde voor Retry-After. Zonder die waarde kan niemand zeggen welke limiet het script heeft geraakt.
Stap 2: Respecteer Retry-After
De Learn-pagina over throttling is hier duidelijk over:
- Wacht het aantal seconden dat in de
Retry-After-header staat. - Probeer het verzoek opnieuw.
- Als het opnieuw mislukt met 429, blijf dezelfde vertraging gebruiken totdat het lukt.
Learn legt uit waarom: Microsoft Graph blijft het resourcegebruik registreren terwijl een client wordt getrottled, dus wachten volgens de header is de snelste manier om te herstellen. Directe nieuwe pogingen verhogen je verbruik. Als het antwoord geen Retry-After-header bevat, adviseert Learn exponentiële backoff.
Learn zegt dat de Microsoft Graph SDK's dit al afhandelen. Voor Graph PowerShell-cmdlets zegt Learn dat niet, dus neem dat niet zomaar aan. Als je script ruwe aanroepen omhult, zoals Invoke-MgGraphRequest, bouw de wachttijd dan zelf in.
Stap 3: Zoek de dure aanroepen
De Learn-pagina over servicespecifieke limieten heeft een sectie voor identity- en access-rapporten. Die somt de volgende getallen op, die kunnen wijzigen:
- Elke aanvraag in die groep: 122 aanvragen per 10 seconden per app over alle tenants, en 5 aanvragen per 10 seconden per app per tenant.
GET signInActivity: 10 aanvragen per minuut.
Jouw script dat elke tien seconden draait, doet 6 aanroepen per minuut, wat op papier onder de 10 blijft. De thread zegt niet of andere taken van dezelfde app-registratie tegelijkertijd liepen. Die taken zouden het budget delen, omdat de limieten per app en per tenant gelden. Dit is een conclusie uit de limietentabel van Learn, niet iets wat de thread zegt.
Learn zegt ook dat $select=signInActivity bij List users strengere throttling kan veroorzaken dan standaardaanroepen. Het advies:
- Gebruik
$top=500, de maximale paginagrootte wanneer jesignInActivityselecteert, in plaats van de standaard 100. - Gebruik
$filteropcreatedDateTimeom kleinere tijdsbereiken op te vragen. Begin met ongeveer drie dagen aan gegevens en verklein het bereik als je getrottled wordt. - De eigenschap
signInActivityvereist volgens de Learn-pagina over List users een Microsoft Entra ID P1- of P2-licentie en de machtigingAuditLog.Read.All.
Als je de aanmeldactiviteit van veel gebruikers nodig hebt, geeft een lijstaanroep zoals GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 tot 500 gebruikers per aanvraag terug. Dat betekent veel minder aanvragen dan één aanroep per gebruiker. De Learn-pagina over List users documenteert deze aanvraag met signInActivity. Of die ook aan de serverkant lichter is, staat er niet bij, dus meet het.
De moderator in de thread van mei stelde voor om signInActivity via het beta-endpoint uit te lezen. De huidige v1.0-referentie van Learn documenteert signInActivity, dus je zou beta hiervoor niet nodig moeten hebben. Controleer de eigenschap op het endpoint dat je gebruikt.
Stap 4: Verminder het aantal aanvragen
De best practices van Learn wijzen in dezelfde richting:
- Verminder het aantal bewerkingen per aanvraag en de frequentie van aanroepen.
- Vermijd continu pollen en regelmatig scannen van grote verzamelingen. Gebruik wijzigingsbijhouding (delta-query's) en wijzigingsmeldingen waar die beschikbaar zijn.
- Cache gegevens die niet vaak veranderen, zoals relaties met managers. Dit is advies van de moderator in de thread van mei, geen uitspraak van Learn.
Stap 5: Gebruik $batch met zorg
Batchen kan het aantal netwerkrondes verminderen. De JSON-batchpagina van Learn stelt een limiet van 20 afzonderlijke aanvragen per batch. Er staat ook:
- Elke aanvraag in een batch wordt afzonderlijk beoordeeld op de throttlinglimieten. Als één aanvraag die limieten overschrijdt, mislukt die aanvraag met 429, terwijl de batch zelf 200 teruggeeft. In één batch kunnen meerdere aanvragen worden gethrottled.
- Probeer elke mislukte aanvraag opnieuw met de waarde van
retry-afterin de responsbody van die aanvraag. Volgens Learn kun je ze allemaal opnieuw in een nieuwe batch sturen na de langsteretry-after-waarde. - Als een SDK gethrottlede aanvragen automatisch opnieuw probeert wanneer ze niet gebundeld zijn, dan gebeurt dat niet automatisch voor gethrottlede aanvragen binnen een batch.
Batching haalt de limiet dus niet weg. Het verplaatst de retrylogica naar je eigen code.
Stap 6: Leesbewerkingen in SharePoint en OneDrive plannen
Voor drive-scans zegt de Learn-pagina over SharePoint-throttling dat SharePoint Online 429- of 503-responses teruggeeft met een Retry-After-header, en dat gethrottlede aanvragen meetellen voor de limieten. De pagina noemt throttling op gebruikersniveau, tenantniveau en applicatieniveau. De enige limieten per site zijn die voor anonieme links en anonieme egress. Plan dus niet op basis van een apart quotum per site. Overige punten uit die pagina:
- Verkeer zonder app-ID en zonder User-Agent-string is ongedecoreerd. Volgens Learn krijgt goed gedecoreerd verkeer voorrang boven ongedecoreerd verkeer. De gedocumenteerde User-Agent-formaten zijn
ISV|CompanyName|AppName/VersionenNONISV|CompanyName|AppName/Version. - Een query op één item kost 1 resource unit, een query op meerdere items of een schrijfactie kost 2, en machtigingsbewerkingen, inclusief
$expand=permissions, kosten 5. Vermijd het uitklappen van machtigingen in bulkscans. - Learn raadt aan om waar mogelijk Microsoft Graph te gebruiken in plaats van CSOM en REST, omdat dat meestal minder resources kost.
De februari-thread ging ook kort in op 410 Gone bij delta-queries. Het antwoord daar was dat dit betekent dat het delta-token niet meer gebruikt kan worden, en dat de client opnieuw moet beginnen met een nieuwe initiële delta-query. Houd hier rekening mee bij elke incrementele synchronisatie.
Verifiëren
- Registreer het aantal 429-responses en de
Retry-After-waarden voor één run, zowel vóór als na je wijzigingen. - Draai het script alleen, zonder andere taak die dezelfde app-registratie gebruikt, zodat je het effect van je eigen aanroepen ziet.
- Blijft throttling optreden ondanks correcte backoff en minder aanroepen, verzamel dan de
request-id- endate-headers en open een supportcase.
Limieten
- De thread van mei 2026 heeft geen bevestigde uitkomst, en het geaccepteerde antwoord daarin was door AI gegenereerd. Het hier gebruikte bewijs is de Learn-richtlijn hierboven.
- De vraag van de vragensteller over gebruikers zonder
signInActivity-blok is in de thread nooit beantwoord. Learn beschrijft dit ook niet, dus behandel een ontbrekend blok als onbekend. Learn zegt wel datlastSuccessfulSignInDateTimeniet is teruggevuld vóór 1 december 2023, dus een lege waarde bewijst niet dat de gebruiker nooit heeft ingelogd. - Limieten die Learn vermeldt, worden aangemerkt als wijzigbaar. Controleer de actuele pagina voordat je een getal in je oplossing verwerkt.
Gerelateerd
Bronnen
- Microsoft Learn: Microsoft Graph throttling guidance
- Microsoft Learn: Microsoft Graph service-specific throttling limits
- Microsoft Learn: Requests bundelen met JSON-batching
- Microsoft Learn: List users
- Microsoft Learn: signInActivity resource type
- Microsoft Learn: Voorkomen dat je wordt gethrottled of geblokkeerd in SharePoint Online
- Microsoft Learn: Veelvoorkomende fouten oplossen in Microsoft Graph PowerShell
- Microsoft Q&A: Throttling-probleem met users-endpoint (mei 2026)
- Microsoft Q&A: Throttlinggedrag van Microsoft Graph bij het parallel verwerken van driveItems (februari 2026)