Krok 3. Stosuj zasady dotyczące rozszerzenia objaśnień

Przeglądasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. Informacje

Tworząc serwer proxy interfejsu API, możesz dodać do niego zasadę ExtensionCallout. Jeśli potrzebujesz pomocy przy tworzeniu prostego serwera proxy, przeczytaj informacje o tworzeniu pierwszego serwera proxy.

Dodając obsługę rozszerzenia, musisz powiązać zasadę ExtensionCallout ze skonfigurowanym rozszerzeniem. Ustawienia tej konfiguracji rozszerzenia określają, w jaki sposób rozszerzenie wchodzi w interakcję z zasobem backendu, z którym się łączy. To specjalnie skonfigurowane rozszerzenie, które zasada ExtensionCallout integruje się z serwerem proxy interfejsu API.

Aby dodać rozszerzenie do serwera proxy interfejsu API:

1. Otwórz serwer proxy interfejsu API w konsoli Apigee Edge w widoku Develop.

   Aby utworzyć rozszerzenie, musisz być administratorem organizacji, ale każda rola użytkownika może dodać rozszerzenie do serwera proxy interfejsu API.

2. W panelu Nawigator wybierz PreFlow.

   

3. W prawym górnym rogu kliknij przycisk + Krok, aby dodać zasadę.

   

4. W oknie Dodaj krok na liście zasad po lewej stronie kliknij Objaśnienie rozszerzenia.

   

   Jeśli nie widzisz zasady ExtensionCallout na liście, upewnij się, że używasz nowego interfejsu Edge. Ponadto rozszerzenia Apigee są obecnie dostępne tylko dla klientów Apigee Edge Cloud Enterprise.

5. W prawym okienku wybierz opcje konfigurowania zasady:

   Pole	Opis
   Wyświetlana nazwa	Wpisz wyświetlaną nazwę zasady.
   Nazwa	Wpisz nazwę, która ma być używana w przypadku zasady. To pole musi być niepowtarzalne na serwerze proxy.
   Rozszerzenie	Wybierz rozszerzenie, którego chcesz użyć. To jest skonfigurowane wcześniej rozszerzenie.
   Działania	Wybierz działanie związane z rejestrowaniem.

6. Kliknij Dodaj.
7. W widoku procesu kliknij zasadę, aby wyświetlić jej plik XML konfiguracji.

   

   Po dodaniu rozszerzenia otrzymasz przykładowy kod XML zasad. Pamiętaj, że zawiera on schemat opisujący strukturę konfiguracji elementu <Input>. Możesz zignorować schemat elementu <Output> – działanie rozszerzenia „log” nie zwróci treści odpowiedzi.

8. Zmień plik XML zasad tak, aby wyglądał następująco:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <ConnectorCallout async="false" continueOnError="true" enabled="true" name="Extension-Callout-Beta-1">
     <DisplayName>Logging Extension</DisplayName>
     <Connector>my-logging-extension</Connector>
     <Action>log</Action>
     <Input>{
       "logName": "example-log",
       "metadata": {
         "resource": {
           "type": "global",
           "labels": {
             "project_id": "my-gcp-project"
           }
         }
       },
       "message": "This is a test"
     }</Input>
   </ConnectorCallout><!--
   Input JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"logName":{"type":"string"},"metadata":{"type":"string"},"message":{"type":"string"}},"required":["logName","message"]}
   -->
   <!--
   Output JSON Schema for package=gcp-stackdriver-logging version=0.0.4
   {"type":"object","properties":{"content":{"type":"string"}},"required":[]}
   -->

   <Input> zawiera te definicje:

   • logName to nazwa logu, w którym zapisywane są dane. Jeśli ten element nie istnieje, zostanie utworzony przez rozszerzenie.
   • metadata określa informacje, których możesz używać do przeglądania logu w konsoli Stackdriver.
   • message to komunikat logu, który chcesz napisać.
9. Kliknij przycisk Zapisz.

Następny krok

Krok 1 Krok 2 Krok 3 Krok 4. Wdróż serwer proxy Krok 5