Table of contents

Omezení pokyny | Rozhraní Graph API konceptyThrottling guidance | Graph API concepts

Pat Altimore|Poslední aktualizace: 19. 6. 2018
|
1 Přispěvatel
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.We strongly recommend that you use Microsoft Graph instead of Azure AD Graph API to access Azure Active Directory resources.Náš vývojový program jsou nyní soustředit na Microsoft Graph a dále jsou plánované pro Azure AD Graph API.Our development efforts are now concentrated on Microsoft Graph and no further enhancements are planned for 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.There are a very limited number of scenarios for which Azure AD Graph API might still be appropriate; for more information, see the Microsoft Graph or the Azure AD Graph blog post in the Office Dev Center.

Co je omezení?What is throttling?

Omezení omezuje počet souběžných volání služby zabránit nadměrné využití prostředků.Throttling limits the number of concurrent calls to a service to prevent overuse of resources.Azure Active Directory (AD) grafu je určený k řešení velmi velký objem požadavků.Azure Active Directory (AD) Graph is designed to handle a very high volume of requests.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.In the event of an overwhelming number of requests, throttling helps maintain optimal performance and reliability of the Azure AD Graph service.

Omezení omezení lišit v závislosti na scénáři.Throttling limits vary based on the scenario.Například pokud provádíte značný zápisů ke klientovi, možnost omezení je vyšší než pokud pouze provádíte čtení.For example, if you are performing a large volume of writes to your tenant, the possibility for throttling is higher than if you are only performing reads.

Co se stane, když omezení dojde k?What happens when throttling occurs?

Překročení omezení prahovou hodnotu, Azure AD Graph omezuje žádné další požadavky z tohoto klienta omezení je v platnosti.When a throttling threshold is exceeded, Azure AD Graph limits any further requests from that client while the throttle is in effect.Když omezení, Azure AD Graph vrátí stavový kód HTTP 429 ("příliš mnoho požadavků"), a požadavky nezdaří.When throttled, Azure AD Graph returns HTTP status code 429 ("Too many requests"), and the requests fail.Omezování chování může být závislá na typ a počet požadavků.Throttling behavior can be dependent on the type and number of requests.Například pokud máte velmi velký objem požadavků, všechny typy žádostí jsou omezené.For example, if you have a very high volume of requests, all requests types are throttled.Prahová hodnota omezení lišit v závislosti na typ požadavku.Threshold limits vary based on the request type.Proto může nastat situace, kdy jsou omezené zápisy ale čtení jsou stále povoleny.Therefore, you could encounter a scenario where writes are throttled but reads are still permitted.

Běžné scénáře omezováníCommon throttling scenarios

Nejběžnější příčiny omezování klientů patří:The most common causes of throttling of clients include:

  • Velkého množství požadavků na všechny aplikace v klientovi.A large number of requests across all applications in a tenant.
  • Velký počet požadavků z konkrétní aplikace přes všechny klienty.A large number of requests from a particular application across all tenants.

Osvědčené postupy pro zpracování, omezení šířky pásmaBest practices to handle throttling

  • Snižte počet operací na základě požadavku.Reduce the number of operations per request.
  • Snižte Četnost volání.Reduce the frequency of calls.
  • 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.When requests fail with a HTTP error code 429, wait the number of seconds specified in the Retry-After response header field and retry the request.

Při implementaci zpracování chyb, použijte k detekci omezení kód chyby HTTP 429.When implementing error handling, use the HTTP error code 429 to detect throttling.Neúspěšné odpověď bude obsahovat opakovat po pole v hlavičce odpovědi.The failed response will include the Retry-After field in the response header.

  1. Počkejte počtu sekund zadaného v opakovat po pole.Wait the number of seconds specified in the Retry-After field.
  2. Opakujte žádost.Retry the request.
  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ě.If the request fails again with a 429 error code, you are still being throttled, continue to use the recommended Retry-After delay and retry the request until it succeeds.

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é.Backing off requests using the Retry-After delay is the fastest way to recover from throttling because AAD Graph continues to log resource usage while a client is being throttled.Neměli byste okamžitou opakování a vzhledem k tomu, že všechny požadavky nabíhat proti vaší omezení použití.You should avoid immediate retries since all requests accrue against your usage limits.

Širší diskuzi o omezování na cloudu Microsoftu, najdete v části omezení vzor.For a broader discussion of throttling on the Microsoft Cloud, see Throttling Pattern.

© 2018 Microsoft