Omezení pokyny | Rozhraní Graph API koncepty

Důležité

Důrazně doporučujeme použít Microsoft Graph místo Azure AD Graph API pro přístup k prostředkům Azure Active Directory. Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API. Je velmi omezený počet scénářů, pro které Azure AD Graph API může být vhodné; Další informace najdete v tématu Microsoft Graph nebo Azure AD Graph příspěvku na blogu v Office Dev Center.

Co je omezení?

Omezení omezuje počet souběžných volání služby zabránit nadměrné využití prostředků. Azure Active Directory (AD) grafu je určený k řešení velmi velký objem požadavků. V případě čtenáře počet požadavků omezení pomáhá udržovat optimální výkon a spolehlivost služby Azure AD Graph.

Omezení omezení lišit v závislosti na scénáři. Například pokud provádíte značný zápisů ke klientovi, možnost omezení je vyšší než pokud pouze provádíte čtení.

Co se stane, když omezení dojde k?

Překročení omezení prahovou hodnotu, Azure AD Graph omezuje žádné další požadavky z tohoto klienta omezení je v platnosti. Když omezení, Azure AD Graph vrátí stavový kód HTTP 429 ("příliš mnoho požadavků"), a požadavky nezdaří. Omezování chování může být závislá na typ a počet požadavků. Například pokud máte velmi velký objem požadavků, všechny typy žádostí jsou omezené. Prahová hodnota omezení lišit v závislosti na typ požadavku. Proto může nastat situace, kdy jsou omezené zápisy ale čtení jsou stále povoleny.

Běžné scénáře omezování

Nejběžnější příčiny omezování klientů patří:

  • Velkého množství požadavků na všechny aplikace v klientovi.
  • Velký počet požadavků z konkrétní aplikace přes všechny klienty.

Osvědčené postupy pro zpracování, omezení šířky pásma

  • Snižte počet operací na základě požadavku.
  • Snižte Četnost volání.
  • Při žádosti o selže s kódem chyby HTTP 429, počkejte počtu sekund zadaného v poli odpověď záhlaví opakovat po a opakujte žádost.

Při implementaci zpracování chyb, použijte k detekci omezení kód chyby HTTP 429. Neúspěšné odpověď bude obsahovat opakovat po pole v hlavičce odpovědi.

  1. Počkejte počtu sekund zadaného v opakovat po pole.
  2. Opakujte žádost.
  3. Pokud požadavek selže s kódem chyby 429 znovu, můžete se pořád omezené, nadále používat doporučené zpoždění opakování po a opakovat požadavek, dokud neproběhne úspěšně.

Zálohování vypnout pomocí požadavků opakovat po zpoždění je nejrychlejší způsob, jak obnovit z omezení, protože AAD Graph nadále protokolování využití prostředků, když klient je omezené. Neměli byste okamžitou opakování a vzhledem k tomu, že všechny požadavky nabíhat proti vaší omezení použití.

Širší diskuzi o omezování na cloudu Microsoftu, najdete v části omezení vzor.