Antywzorzec: używanie identyfikatorów o dużej mocy zbioru w zasadach dotyczących limitów

Wyświetlasz dokumentację Apigee Edge.
Przejdź do dokumentacji Apigee X.
info

Zasada dotycząca limitu służy do zliczania liczby żądań otrzymywanych przez proxy interfejsu API. Ta funkcja umożliwia dostawcom interfejsów API egzekwowanie limitów liczby wywołań interfejsu API wykonywanych przez aplikacje w określonym przedziale czasu.

Zasada dotycząca limitu może zawierać element identifier, który identyfikuje „zasobnik” limitu, w którym zliczane jest każde żądanie.

Antywzorzec

Gdy używasz zasady dotyczącej limitu, nie używaj identyfikatorów o dużej mocy zbioru.

Moc zbioru odnosi się do liczby unikalnych wartości danych w zbiorze. Identyfikator o dużej mocy zbioru ma dużą liczbę różnych możliwych wartości. Identyfikatory o dużej mocy zbioru obejmują unikalne identyfikatory żądań lub identyfikatory sesji, które zmieniają się przy każdym wywołaniu interfejsu API.

Używanie identyfikatorów o dużej mocy zbioru może znacznie osłabić skuteczność egzekwowania limitu.

Wpływ

Używanie identyfikatorów o dużej mocy zbioru w przypadku elementu identyfikatora zasady dotyczącej limitu powoduje:

  • Nieskuteczne egzekwowanie limitu: każdy unikalny identyfikator jest traktowany jako osobny licznik. Jeśli każde żądanie ma nowy, unikalny identyfikator, system limitów zasadniczo tworzy nowy "zasobnik" dla każdego wywołania interfejsu API. Oznacza to, że ogólny limit jest mierzony na podstawie pojedynczych liczników jednorazowych, a nie rzeczywistych grup żądań, które chcesz ograniczyć, co sprawia, że zasada jest bezużyteczna w przypadku kontroli ruchu.
  • Zwiększone zużycie zasobów: generowanie i zarządzanie dużą liczbą unikalnych liczników limitów niepotrzebnie obciąża platformę Apigee, co prowadzi do zwiększonego zużycia zasobów i potencjalnych problemów z wydajnością.
  • Problemy z monitorowaniem: gdy dane są rozproszone na dużą liczbę unikalnych identyfikatorów, trudno jest monitorować i zrozumieć rzeczywiste trendy zużycia interfejsu API. Tracisz możliwość sprawdzenia, które aplikacje, deweloperzy lub produkty zużywają zasoby interfejsu API.

Sprawdzona metoda

Wybierz identyfikatory o małej lub średniej mocy zbioru, które reprezentują też stabilne i znaczące grupowanie na potrzeby egzekwowania limitu. Pomagają one skutecznie zarządzać wykorzystaniem interfejsu API i uzyskiwać wgląd w ruch. Przykłady:

  • developer.app.name
  • client_id
  • apiproduct.name

Dzięki odpowiednim identyfikatorom zasada dotycząca limitu może skuteczniej zarządzać ruchem interfejsu API, zapobiegać niezamierzonym przekroczeniom limitu i zapewniać przejrzyste informacje o wzorcach wykorzystania.