Udostępnij za pośrednictwem

Wskazówki dotyczące ograniczania | Pojęcia dotyczące interfejsu API programu Graph

  • Artykuł

Ważne

Zdecydowanie zaleca się używanie Microsoft Graph zamiast interfejsu API Azure AD Graph dostęp do zasobów usługi Azure Active Directory. Nasze programistycznych teraz jest skoncentrowana na program Microsoft Graph i interfejsu API usługi Azure AD Graph planowane żadne rozszerzenia funkcjonalności. Istnieje bardzo ograniczoną liczbę scenariuszy, w których interfejsu API usługi Azure AD Graph nadal może być odpowiednie; Aby uzyskać więcej informacji, zobacz Microsoft Graph lub Azure AD Graph wpis w blogu w Centrum deweloperów pakietu Office.

Co to jest ograniczanie?

Ograniczanie ogranicza liczbę równoczesnych wywołań do usługi, aby zapobiec nadmierne zużycie zasobów. Graph usługi Azure Active Directory (AD) jest przeznaczona do obsługi bardzo dużą liczbę żądań. W przypadku utrudnione liczba żądań ograniczanie przepustowości pomaga zachować optymalną wydajność i niezawodność usługi Azure AD Graph.

Limity ograniczania przepustowości różnić w zależności od scenariusza. Na przykład jeśli przeprowadzasz dużą liczbę operacji zapisu dla Twojej dzierżawy, możliwość ograniczania jest wyższa niż jeśli tylko wykonywana odczytów.

Co się stanie w przypadku ograniczania występuje?

Po przekroczeniu progu ograniczania przepustowości, Azure AD Graph ogranicza żadnych dalszych żądań z tego klienta przepustnicy w czasie działania. Gdy ograniczenie, Azure AD Graph zwraca kod stanu HTTP 429 ("jest zbyt wiele żądań"), i Niepowodzenie żądania. Ograniczanie zachowanie może być zależny od typu i liczby żądań. Na przykład jeśli masz bardzo dużą liczbę żądań, wszystkie typy żądań są ograniczane. Wartości progowych różnić w zależności od typu żądania. W związku z tym może wystąpić scenariusz zapisy są ograniczane, ale dla których odczyty nadal są dozwolone.

Typowe scenariusze ograniczania przepustowości

Najczęstszymi przyczynami ograniczania przepustowości klientów obejmują:

  • Duża liczba żądań do wszystkich aplikacji w dzierżawie.
  • Duża liczba żądań z określonej aplikacji we wszystkich dzierżawców.

Najlepsze rozwiązania w celu obsługi ograniczania przepustowości

  • Zmniejsz liczbę operacji na żądanie.
  • Zmniejsz częstotliwość wywołań.
  • Podczas żądania zakończyć się niepowodzeniem z kodem błędu HTTP 429, poczekaj liczby sekund określonej w polu ponownych prób po odpowiedzi nagłówka i ponów żądanie.

Podczas implementowania obsługi błędów, użyj kod błędu HTTP 429 wykryć ograniczania. Nie powiodło się odpowiedź będzie zawierać ponownych prób po pole nagłówka odpowiedzi.

  1. Poczekaj liczby sekund określonej w ponownych prób po pola.
  2. Ponów żądanie.
  3. Jeśli żądanie nie powiedzie się ponownie z kodem błędu 429, możesz są nadal ograniczane, nadal używać zalecane Opóźnienie ponownych prób po i ponowić żądanie do skutku.

Tworzenie kopii żądań przy użyciu wolnego ponownych prób po opóźnienie jest najszybszym sposobem odzyskanie ograniczania przepustowości, ponieważ Graph usługi AAD w dalszym ciągu rejestrować użycie zasobów, gdy klient jest ograniczane. Należy unikać bezpośredniego ponownych prób od wszystkich żądań naliczania względem limitów do użycia.

Omówienie szerszych ograniczania przepustowości w Microsoft Cloud, zobacz ograniczania wzorzec.