Dołączanie i konfigurowanie zasad w plikach XML

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Możesz tworzyć i edytować zasady lokalnie za pomocą ulubionego edytora tekstu, edytora XML lub IDE. W tym temacie omówiono typ zasady dotyczącej limitów jako przykład tworzenia, konfigurowania, podłączania i wdrażania i testowania.

Większość serwerów proxy interfejsów API wymusza limit. Limity pozwalają kontrolować, jak często aplikacja kliencka jest ma uprawnienia do wywoływania interfejsu API w danym przedziale czasu. W przykładzie poniżej zasada dotycząca limitów to skonfigurowana pod kątem ograniczenia liczby aplikacji do 1 żądania na minutę. (Może to nie być prawdziwe, pozwalają w prosty sposób sprawdzić efekty stosowania zasad).

W konfiguracji serwera proxy interfejsu API pliki zasad są przechowywane jako pliki XML w Katalog /apiproxy/policies.

Na przykład zasada typu Limit o nazwie „LimitPolicy” można utworzyć jako plik o nazwie QuotaPolicy.xml z tą treścią:

<Quota enabled="true" continueOnError="false" name="QuotaPolicy">
    <Allow count="1"/>
    <Interval>1</Interval>
    <TimeUnit>minute</TimeUnit>
</Quota>

Możesz utworzyć plik tekstowy ręcznie lub wygenerować zasadę na podstawie schematu XML. Wszystkie zasady mają pewne ustawienia specyficzne dla danego typu zasad, a pewne ustawienia dla wszystkich zasad.

Gdy dołączysz zasady w interfejsie zarządzania, kreator serwerów proxy interfejsów API generuje zasady ze schematu XML dla wybranego typu zasady. W związku z tym możesz zobaczyć w konfiguracji zasad, które dla jasności nie zawsze są uwzględniane w dokumentacji.

Wszystkie zasady definiują te atrybuty:

  • enabled: wskazuje, czy zasada jest włączona. lub „wyłączony”. Zasady mogą być włączane/wyłączane w czasie działania przez zmianę tego ustawienia. Zasada, która zawiera enabled ustawiona na false nie jest wymuszana.
  • continueOnError: określa, czy potok powinien nadal przetwarzać w przypadku niepowodzenia. Przy egzekwowaniu zasad dotyczących limitów błędy prawdopodobnie wskazują, że limit został przekroczony i dlatego ten atrybut powinien mieć wartość false (fałsz).
  • name: nazwa, jaką nadajesz danej zasadzie. Ta nazwa jest unikalna zasadą i służy do dołączania zasad do procesu jako etapu przetwarzania.
.

W powyższym przykładzie elementy Allow, Interval oraz TimeUnit odnoszą się do zasad dotyczących limitów. Te elementy określają ustawienia interfejsu API Usługi są egzekwowane w imieniu interfejsu API. Inne typy zasad definiują własne ustawienia, więcej dowiesz się z informacji o zasadach.