M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Microsoft Graph restituisce 429 Too Many Requests negli script in blocco: cosa cambiare

By ·

Il tuo script Graph rallenta fino quasi a bloccarsi o fallisce con 429 anche con una richiesta ogni dieci secondi. Scopri perché contano le proprietà costose e le quote condivise, e come rallentare, suddividere le chiamate e usare i batch in modo sicuro.

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

Uno script legge i dati degli utenti da Microsoft Graph, un utente alla volta, con una cadenza lenta e prudente. Riceve comunque 429 Too Many Requests. Un thread di Q&A di Microsoft di maggio 2026 descrive esattamente questo caso: una chiamata per un utente, un elenco lungo di $select che include signInActivity, un $expand=manager e un client impostato su una richiesta ogni dieci secondi, con una sola richiesta in corso.

Punti chiave

  • Una cadenza fissa di richieste non ti protegge. I limiti dipendono dal tipo di richiesta, dall'applicazione e dal tenant. Learn fissa GET signInActivity a 10 richieste al minuto.
  • Attendi il numero di secondi indicato nell'intestazione Retry-After, poi riprova. Learn spiega che Graph continua a registrare l'utilizzo anche mentre sei soggetto a throttling, quindi ritentare subito peggiora la situazione.
  • Separare le proprietà costose dalle chiamate per singolo utente, paginare con un $top più alto e usare delta o le notifiche di modifica riducono il numero di richieste.
  • In una chiamata $batch ogni richiesta viene valutata singolarmente. Il batch restituisce 200 mentre le singole richieste al suo interno falliscono con 429, e non vengono ritentate automaticamente.

Un secondo thread, di febbraio 2026, chiedeva come funzioni il throttling quando molti drive di SharePoint e OneDrive vengono letti in parallelo. Considerati insieme, i due thread mostrano perché un semplice limite di frequenza lato client non basta. Questo articolo spiega ciò che documenta Microsoft Learn e ciò che i thread si sono limitati a suggerire. È una guida alla risoluzione dei problemi, non una procedura ufficiale Microsoft.

Cosa riportano i thread

Thread di maggio 2026 (endpoint users). Il richiedente riceve 429 su GET /v1.0/users/{id} con molte proprietà, tra cui signInActivity, più $expand=manager. Paginazione e filtri non hanno aiutato, perché ogni chiamata restituisce un solo utente. Un moderatore Microsoft ha risposto che a causare il throttling sono le proprietà costose, non solo la frequenza delle richieste. Il moderatore ha suggerito di suddividere le chiamate (profilo, attività di accesso, manager), rispettare Retry-After con backoff esponenziale, usare la cache e leggere l'attività di accesso meno spesso. Quella risposta non è stata contrassegnata come accettata. Una risposta generata dall'IA, che il richiedente ha invece contrassegnato come accettata, diceva più o meno la stessa cosa. Il richiedente non ha indicato se i 429 si sono interrotti.

Thread di febbraio 2026 (driveItems). L'autore della domanda voleva sapere se il throttling si applica per sito o per drive e quale concorrenza sia sicura. Una risposta anonima, accettata da chi aveva posto la domanda, spiegava che i limiti sono stratificati tra tenant, app e servizio, che le richieste verso siti diversi possono attingere alla stessa quota e che bisogna rispettare Retry-After, usare $batch e preferire le query delta e le notifiche di modifica al polling. Non veniva indicato nessun numero di concorrenza. Chi aveva posto la domanda ha detto che è stato utile.

Passo 1: leggere correttamente il 429

Registra tre informazioni per ogni errore: l'URL della richiesta, il valore di Retry-After e l'ora. La pagina di Learn sulla risoluzione dei problemi di Graph PowerShell suggerisce di eseguire un cmdlet con -Debug per vedere il metodo HTTP, l'URI e il codice di stato, e indica di annotare le intestazioni di risposta request-id e date se apri un ticket di supporto.

Il thread di maggio 2026 non riportava alcun valore di Retry-After. Senza di esso, nessuno può dire quale limite abbia colpito lo script.

Passo 2: rispettare Retry-After

La pagina di Learn sul throttling è chiara su questo punto:

  1. Attendi il numero di secondi indicato nell'intestazione Retry-After.
  2. Riprova la richiesta.
  3. Se la richiesta fallisce di nuovo con 429, continua a usare lo stesso ritardo finché non va a buon fine.

Learn spiega il motivo: Microsoft Graph continua a registrare l'utilizzo delle risorse mentre un client è sottoposto a throttling, quindi attendere secondo l'intestazione è il modo più rapido per recuperare. I tentativi immediati aumentano il tuo utilizzo. Se la risposta non contiene l'intestazione Retry-After, Learn consiglia il backoff esponenziale.

Learn afferma che gli SDK di Microsoft Graph gestiscono già tutto questo. Non dice lo stesso per i cmdlet di Graph PowerShell, quindi non darlo per scontato. Se il tuo script racchiude chiamate dirette, come Invoke-MgGraphRequest, implementa tu l'attesa.

Passo 3: individuare le chiamate costose

La pagina di Learn sui limiti specifici per servizio contiene una sezione dedicata ai report su identità e accessi. Elenca questi valori, che possono cambiare:

  • Qualsiasi richiesta di quel gruppo: 122 richieste ogni 10 secondi per app su tutti i tenant e 5 richieste ogni 10 secondi per app per tenant.
  • GET signInActivity: 10 richieste al minuto.

Il tuo script, che effettua una chiamata ogni dieci secondi, esegue 6 chiamate al minuto, quindi sulla carta resta sotto il limite di 10. Il thread non dice se altri processi della stessa registrazione app fossero in esecuzione nello stesso momento. Tali processi condividerebbero il budget, perché i limiti si applicano per app e per tenant. Questa è una deduzione dalla tabella dei limiti di Learn, non qualcosa che il thread afferma.

Learn afferma inoltre che $select=signInActivity nella chiamata List users può causare un throttling più severo rispetto alle chiamate standard. Il suo consiglio è:

  • Usa $top=500, la dimensione massima della pagina quando selezioni signInActivity, invece del valore predefinito di 100.
  • Usa $filter su createdDateTime per interrogare intervalli di tempo più piccoli. Parti da circa tre giorni di dati e restringi l'intervallo se vieni sottoposto a throttling.
  • Secondo la pagina List users di Learn, la proprietà signInActivity richiede una licenza Microsoft Entra ID P1 o P2 e l'autorizzazione AuditLog.Read.All.

Se ti servono i dati di accesso di molti utenti, una chiamata di elenco come GET /v1.0/users?$select=displayName,userPrincipalName,signInActivity&$top=500 restituisce fino a 500 utenti per richiesta. Significa molte meno richieste rispetto a una chiamata per utente. La pagina List users di Learn documenta questa richiesta con signInActivity. Non è indicato se sia anche più leggera lato servizio, quindi misurala.

Il moderatore del thread di maggio suggeriva di leggere signInActivity tramite l'endpoint beta. Il riferimento v1.0 attuale di Learn documenta signInActivity, quindi per questa proprietà non dovrebbe servire beta. Verifica la proprietà sull'endpoint che usi.

Passo 4: ridurre il numero di richieste

Le best practice di Learn vanno nella stessa direzione:

  • Riduci il numero di operazioni per richiesta e la frequenza delle chiamate.
  • Evita il polling continuo e le scansioni regolari di grandi raccolte. Usa il rilevamento delle modifiche (query delta) e le notifiche di modifica, quando disponibili.
  • Metti in cache i dati che cambiano raramente, come le relazioni con i manager. Questo è un consiglio del moderatore del thread di maggio, non un'indicazione di Learn.

Passo 5: usare $batch con attenzione

Il batching può ridurre i round trip di rete. La pagina di Learn sul batching JSON fissa un limite di 20 richieste singole per batch. Inoltre afferma:

  • Ogni richiesta in un batch viene valutata singolarmente rispetto ai limiti di throttling. Se una richiesta supera i limiti, fallisce con 429, mentre il batch nel suo complesso restituisce 200. In un singolo batch possono essere sottoposte a throttling più richieste.
  • Ripeti ogni richiesta non riuscita usando il valore retry-after presente nel corpo della risposta per quella richiesta. Secondo Learn, potresti ritentarle tutte in un nuovo batch dopo il valore retry-after più alto.
  • Se un SDK ritenta automaticamente le richieste soggette a throttling quando non sono in batch, le richieste soggette a throttling all'interno di un batch non vengono ritentate automaticamente.

Quindi il batching non elimina il limite. Sposta la logica di ripetizione nel tuo codice.

Passo 6: pianifica le letture di SharePoint e OneDrive

Per le scansioni dei drive, la pagina di Learn sul throttling di SharePoint indica che SharePoint Online restituisce 429 o 503 con un'intestazione Retry-After e che le richieste soggette a throttling contano ai fini dei limiti. Elenca il throttling a livello di utente, tenant e applicazione, e i suoi unici limiti per sito riguardano i link anonimi e l'egress anonimo. Non pianificare intorno a una quota separata per ogni sito. Altri punti di quella pagina:

  • Il traffico senza app ID e senza stringa User-Agent è non decorato. Secondo Learn, il traffico ben decorato ha la priorità su quello non decorato. I formati User-Agent documentati sono ISV|CompanyName|AppName/Version e NONISV|CompanyName|AppName/Version.
  • Una query su un singolo elemento costa 1 unità di risorsa, una query su più elementi o una scrittura costa 2, mentre le operazioni sulle autorizzazioni, incluso $expand=permissions, costano 5. Evita l'espansione delle autorizzazioni nelle scansioni di massa.
  • Learn consiglia di usare Microsoft Graph al posto di CSOM e REST dove possibile, perché di solito utilizza meno risorse.

Il thread di febbraio ha toccato anche il caso di 410 Gone per le query delta. La risposta indicava che significa che il token delta non può più essere usato e che il client deve ricominciare con una nuova query delta iniziale. Prevedilo in qualsiasi sincronizzazione incrementale.

Verifica

  1. Registra il numero di risposte 429 e i valori di Retry-After per un'esecuzione, prima e dopo le modifiche.
  2. Esegui lo script da solo, senza altri processi che usano la stessa registrazione app, per vedere l'effetto delle tue sole chiamate.
  3. Se il throttling continua nonostante un backoff corretto e un numero ridotto di chiamate, raccogli le intestazioni request-id e date e apri un caso di supporto.

Limiti

  • Il thread di maggio 2026 non ha un esito confermato, e la risposta accettata era generata dall'AI. Le indicazioni di Learn sopra sono l'evidenza usata qui.
  • La domanda sugli utenti senza un blocco signInActivity non ha ricevuto risposta nel thread. Learn non la descrive, quindi tratta un blocco mancante come sconosciuto. Learn precisa però che lastSuccessfulSignInDateTime non viene retroattivamente valorizzato prima del 1° dicembre 2023, quindi un valore vuoto non dimostra che l'utente non abbia mai effettuato l'accesso.
  • I limiti elencati da Learn sono indicati come soggetti a modifica. Controlla la pagina aggiornata prima di costruire qualcosa su un numero.

Correlati

Fonti

Entities in this article

Microsoft Graph Microsoft Graph PowerShell Throttling

Related articles

RSS