Dela via

Begränsning vägledning | Graph API-begrepp

  • Artikel

Viktigt

Vi rekommenderar starkt att du använder Microsoft Graph i stället för Azure AD Graph API för att komma åt resurser i Azure Active Directory. Vårt utvecklingsarbete är nu samlade på Microsoft Graph och inga fler förbättringar som planeras att Azure AD Graph API. Det finns ett begränsat antal scenarier som Azure AD Graph API kan fortfarande vara lämplig. Mer information finns i Microsoft Graph eller Azure AD Graph blogginlägget i Office Dev Center.

Vad begränsning?

Begränsning begränsar antalet samtidiga anrop till en tjänst för att förhindra felaktig användning av resurser. Diagram för Azure Active Directory (AD) är utformad för att hantera en mycket stor mängd begäranden. Vid ett överväldigande antal begäranden upprätthåller begränsning optimala prestanda och tillförlitlighet för tjänsten Azure AD-diagram.

Bandbreddsbegränsning gränser variera beroende på scenario. Om du utför ett stort antal skrivningar till din klient är till exempel möjligheten för begränsning av högre än om du bara utför läsningar.

Vad händer när begränsning inträffar?

När ett bandbreddsbegränsning tröskelvärde har överskridits begränsar Azure AD Graph ytterligare förfrågningar från klienten när begränsningen tillämpas. När begränsas, Azure AD Graph returnerar HTTP-statuskod 429 (”för många begäranden”), och begäranden att misslyckas. Begränsning beteende kan vara beroende på typ och antal begäranden. Till exempel om du har en mycket stor mängd begäranden begränsas alla typer av begäranden. Tröskelvärden variera beroende på typ av begäran. Därför kan du stöta på ett scenario där skrivningar har begränsats men läser fortfarande är tillåtna.

Vanliga scenarier för bandbreddsbegränsning

De vanligaste orsakerna till begränsning av klienter är:

  • Ett stort antal begäranden i alla program i en klient.
  • Ett stort antal begäranden från ett visst program över alla klienter.

Metodtips för att hantera begränsning

  • Minska antalet åtgärder per begäran.
  • Minska frekvensen av anrop.
  • När begäranden misslyckas med en HTTP-felkod 429, vänta antalet sekunder som anges i försök igen efter svar huvudfältet och försök sedan begäran.

När du implementerar felhantering, Använd HTTP-felkod 429 för att identifiera begränsning. Misslyckade svaret innehåller den försök igen efter i rubriken.

  1. Vänta antalet sekunder som anges i den försök igen efter fältet.
  2. Gör om begäran.
  3. Om begäran misslyckas igen med en 429 felkoden kan du fortfarande har begränsats kan fortsätta att använda den rekommenderade försök igen efter fördröjningen och försöka tills den lyckas.

Säkerhetskopiering av begäranden som använder den försök igen efter fördröjningen är det snabbaste sättet att återställa från begränsning eftersom AAD diagrammet fortsätter att logga resursanvändningen medan en klient har begränsats. Eftersom alla begäranden som görs mot gränserna för Resursanvändning bör du undvika omedelbara försök.

En bredare beskrivning av begränsning på Microsoft Cloud finns begränsning mönster.