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 una norma ExtensionCallout al proxy. Se hai bisogno di aiuto per creare un proxy semplice, consulta l'articolo su come creare il tuo primo proxy.

Quando aggiungi il supporto per un'estensione, associ il criterio ExtensionCallout con un'estensione configurata. Le impostazioni della 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 relative ai callout per le estensioni integrano nel proxy API.

Per aggiungere un'estensione al proxy API:

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

    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 di 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 dei criteri a sinistra, fai clic su Callout estensione.

    Se il criterio ExtensionCallout non è presente nell'elenco, assicurati di utilizzare la nuova UI di Edge. Inoltre, le estensioni Apigee sono attualmente disponibili solo per i clienti di 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. Questa è l'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 codice XML di esempio. Tieni presente che include uno schema che descrive come strutturare la configurazione dell'elemento <Input>. Puoi ignorare lo schema dell'elemento <Output>: non viene restituito alcun corpo di risposta dall'azione "log" dell'estensione.

  8. Modifica il file XML del criterio 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à creata 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