Richtlijnen beperking | Graph API-concepten

Belangrijk

Wordt aangeraden dat u Microsoft Graph in plaats van Azure AD Graph API voor toegang tot Azure Active Directory-resources. Ontwikkeling van onze producten nu concentreren zich bij Microsoft Graph en geen verdere verbeteringen zijn gepland voor Azure AD Graph API. Er zijn een zeer beperkt aantal scenario's waarvoor Azure AD Graph API nog steeds mogelijk geschikt; Zie voor meer informatie de Microsoft Graph of de Azure AD Graph blogbericht in het Office-ontwikkelaarscentrum.

Wat is beperking?

Bandbreedtebeperking beperkt het aantal gelijktijdige aanroepen naar een service om te voorkomen dat overmatig gebruik van bronnen. Grafiek van Azure Active Directory (AD) is ontworpen voor het verwerken van een zeer groot aantal aanvragen. In het geval van een groot aantal aanvragen zorgt beperking optimale prestaties en betrouwbaarheid van de service Azure AD Graph onderhouden.

Limieten voor bandbreedteregeling variëren, afhankelijk van het scenario. Bijvoorbeeld, als u een groot aantal schrijfbewerkingen in uw tenant uitvoert, is de mogelijkheid voor beperking hoger dan als u alleen leesbewerkingen uitvoert.

Wat gebeurt er wanneer beperking optreedt?

Wanneer een bandbreedteregeling drempelwaarde wordt overschreden, beperkt Azure AD Graph verdere verzoeken van uit dat de client als de beperking van kracht. Wanneer beperkt, Azure AD Graph retourneert HTTP-statuscode 429 (' te veel aanvragen '), en de aanvragen mislukken. Gedrag beperking is afhankelijk van het type en aantal aanvragen. Bijvoorbeeld, als er een zeer groot aantal aanvragen, zijn alle aanvragen typen beperkt. Grenswaarden die bepalen variëren, afhankelijk van het aanvraagtype. Daarom kan er een scenario waarbij schrijfbewerkingen zijn beperkt, maar nog steeds mogen worden gelezen.

Algemene scenario's voor bandbreedteregeling

De meest voorkomende oorzaken van het beperken van de clients zijn onder andere:

• Een groot aantal aanvragen op alle toepassingen in een tenant.
• Een groot aantal aanvragen van een bepaalde toepassing op alle tenants.

Aanbevolen procedures voor het afhandelen van beperking

• Verminder het aantal bewerkingen per aanvraag.
• Verlaag de frequentie van aanroepen.
• Wanneer met een HTTP-foutcode 429 aanvragen mislukken, het aantal seconden dat is opgegeven in het headerveld reactie voor opnieuw proberen na wachten en de aanvraag opnieuw proberen.

Bij het implementeren van foutafhandeling, gebruikt u de HTTP-foutcode 429 voor het detecteren van beperking. De mislukte reactie omvat de opnieuw proberen na veld in de antwoordheader.

1. Wacht het aantal seconden dat is opgegeven de opnieuw proberen na veld.
2. De aanvraag opnieuw proberen.
3. Als de aanvraag opnieuw met een 429 foutcode mislukt, u zijn nog steeds wordt beperkt, blijven de aanbevolen vertraging voor opnieuw proberen na gebruiken en de aanvraag opnieuw proberen totdat dit is gelukt.

Een back-up uit-aanvragen via de opnieuw proberen na vertraging is de snelste manier om te herstellen van de beperking omdat AAD-grafiek aan te melden Resourcegebruik terwijl een client wordt beperkt blijft. Aangezien alle aanvragen op basis van uw gebruikslimieten doorlopen, moet u directe nieuwe pogingen niet.

Zie voor een uitgebreidere bespreking van de beperking op de Microsoft Cloud, patroon beperking.