Passaggio 3: utilizza le norme relative ai callout estensioni

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Quando sviluppi un proxy API, puoi aggiungere il supporto di un'estensione aggiungendo un criterio ExtensionsCallout al proxy. Se hai bisogno di aiuto per creare un proxy semplice, consulta l'articolo Creare il primo proxy.

Quando aggiungi il supporto per un'estensione, associ il criterio ExtensionsCallout con un'estensione configurata. Le impostazioni di configurazione dell'estensione definiscono il modo in cui l'estensione interagisce con la risorsa di backend a cui si connette. È questa estensione configurata in modo specifico che le norme ExtensionsCallout integrano nel proxy API.

Per aggiungere un'estensione al proxy API:

1. Apri il proxy API nella console Apigee Edge nella visualizzazione Sviluppo.

   Anche se devi essere un amministratore dell'organizzazione per creare un'estensione, qualsiasi ruolo utente può aggiungere l'estensione a un proxy API.

2. Nel riquadro Navigazione, seleziona Preflusso.

   

3. Nell'angolo in alto a destra, fai clic sul pulsante + Passaggio per aggiungere un criterio.

   

4. Nella finestra di dialogo Aggiungi passaggio, nell'elenco delle norme a sinistra, fai clic su Callout estensione.

   

   Se non vedi il criterio ExtensionsCallout nell'elenco, assicurati di utilizzare la nuova UI Edge. Inoltre, le estensioni Apigee sono attualmente disponibili solo per i clienti Apigee Edge Cloud Enterprise.

5. Nel riquadro a destra, seleziona le opzioni per configurare il criterio:

   Campo	Descrizione
   Display Name	Inserisci il nome visualizzato del criterio.
   Nome	Inserisci il nome da utilizzare per il criterio in modo programmatico. Deve essere univoco nel proxy.
   Estensione	Scegli l'estensione da utilizzare. Si tratta dell'estensione che hai configurato in precedenza.
   Azioni	Seleziona l'azione "log".

6. Fai clic su Aggiungi.
7. Nella visualizzazione flusso, fai clic sul criterio per visualizzare il relativo XML di configurazione.

   

   Quando aggiungi l'estensione, riceverai un file XML di esempio del criterio. Tieni presente che include uno schema che descrive come strutturare la configurazione dell'elemento <Input>. Puoi ignorare lo schema dell'elemento <Output>: l'azione "log" dell'estensione non restituisce alcun corpo di risposta.

8. Modifica il file XML dei criteri in modo che sia simile al seguente:

   <?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":[]}
   -->

   In questo caso, <Input> definisce quanto segue:

   • logName è il nome del log in cui scrivere. Se non esiste, verrà creato dall'estensione.
   • metadata specifica le informazioni che puoi utilizzare per cercare il log nella console Stackdriver.
   • message è semplicemente il messaggio di log che vuoi scrivere.
9. Fai clic sul pulsante Salva.

Passaggio successivo

Passaggio 1 Passaggio 2 Passaggio 3 Passaggio 4: esegui il deployment del proxy Passaggio 5