Linee guida per la limitazione delle richieste | Concetti relativi all'API Graph
Importante
Per accedere alle risorse di Azure Active Directory è fortemente consigliabile usare Microsoft Graph anziché l'API di Azure AD Graph. Le attività di sviluppo Microsoft sono ora concentrate su Microsoft Graph e non sono previsti altri miglioramenti per l'API di Azure AD Graph. Può essere ancora opportuno usare questa API in un numero molto limitato di scenari. Per altre informazioni, vedere il post di blog Microsoft Graph or the Azure AD Graph (Microsoft Graph o Azure AD Graph) in Office Developer Center.
Cos'è la limitazione delle richieste
La limitazione delle richieste consente di limitare il numero di chiamate simultanee a un servizio per evitare un uso eccessivo delle risorse. Azure Active Directory (AD) Graph è progettato per gestire un volume molto elevato di richieste. In presenza di un numero eccessivo di richieste, la limitazione consente di mantenere livelli ottimali di prestazioni e affidabilità per il servizio Azure AD Graph.
I limiti applicati variano in base allo scenario. Ad esempio, se si esegue un volume elevato di scritture nel tenant, la possibilità che venga applicata la limitazione delle richieste è maggiore rispetto all'esecuzione di letture.
Conseguenze della limitazione delle richieste
Quando viene superata una soglia di limitazione delle richieste, Azure AD Graph limita eventuali ulteriori richieste dal client mentre la limitazione è attiva. Quando è applicata la limitazione delle richieste , il servizio Azure AD Graph restituisce il codice di stato HTTP 429 ("Troppe richieste") e le richieste hanno esito negativo. Il comportamento di limitazione può dipendere dal tipo e dal numero di richieste. In presenza di un volume molto elevato di richieste, ad esempio, vengono limitati tutti i tipi di richieste. Le soglie variano in base al tipo di richiesta. Potrebbe quindi esistere uno scenario in cui le scritture sono limitate, ma le letture sono consentite.
Scenari comuni di limitazione delle richieste
Le cause più comuni della limitazione delle richieste dei client includono:
- Un numero elevato di richieste per tutte le applicazioni in un tenant.
- Un numero elevato di richieste da una particolare applicazione in tutti i tenant.
Procedure consigliate per gestire la limitazione delle richieste
- Ridurre il numero di operazioni per ogni richiesta.
- Ridurre la frequenza delle chiamate.
- Quando le richieste hanno esito negativo con un codice di errore HTTP 429, attendere il numero di secondi specificato nel campo dell'intestazione della risposta Retry-After e ripetere la richiesta.
Quando si implementa la gestione degli errori, usare il codice di errore HTTP 429 per rilevare la limitazione. La risposta per una richiesta non riuscita includerà il campo Retry-After nell'intestazione.
- Attendere il numero di secondi specificato nel campo Retry-After.
- Ripetere la richiesta.
- Se la richiesta ha di nuovo esito negativo con un codice di errore 429, ciò indica che la limitazione è ancora attiva. Continuare a usare il ritardo Retry-After consigliato e ritentare la richiesta fino a quando non viene completata.
Usare il ritardo Retry-After è il modo più rapido per superare la condizione di limitazione delle richieste, perché AAD Graph continua a registrare l'utilizzo delle risorse mentre un client è limitato. È opportuno evitare di ripetere i tentativi immediatamente, perché tutte le richieste vengono accumulate per l'applicazione dei limiti di utilizzo.
Per informazioni più estese sulla limitazione delle richieste in Microsoft Cloud, vedere Throttling Pattern (Modello di limitazione).