Che cosa sono le estensioni?

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

Puoi utilizzare le estensioni per integrare risorse esterne nei proxy API. Ad esempio, puoi integrare i servizi Google Cloud, come Google Cloud Storage. In fase di esecuzione, un proxy API utilizza l'estensione per scambiare richieste e risposte con la risorsa esterna.

Framework di runtime delle estensioni

In fase di esecuzione, un'estensione funge da intermediario, elaborando le richieste e le risposte tra un proxy API e una risorsa esterna.

Ecco una panoramica del funzionamento dell'elaborazione tramite un'estensione in fase di esecuzione.

  1. Una richiesta del client raggiunge un proxy API e il relativo flusso di richieste procede in base alle norme del proxy.
  2. Il flusso di richieste raggiunge un criterio di callout dell'estensione nel proxy configurato per trasmettere i dati a un'estensione di cui è stato eseguito il deployment nell'ambiente. I dati includono i valori necessari per inviare una richiesta alla risorsa esterna rappresentata dall'estensione.
  3. L'estensione invia una richiesta alla risorsa esterna, quindi riceve una risposta.
  4. L'estensione restituisce la risposta alle norme relative ai callout delle estensioni, dove viene gestita dal codice proxy.
  5. Il flusso di richieste continua attraverso il proxy finché non restituisce una risposta al client.

Utilizzo delle estensioni

Ogni estensione viene sviluppata e configurata in base a una risorsa esterna specifica. Per utilizzare un'estensione, un amministratore di Apigee Edge e uno sviluppatore di proxy API devono seguire questi passaggi di alto livello:

  • Un amministratore dell'organizzazione Apigee Edge configura e distribuisce l'estensione. Lo configurano con valori specifici per le esigenze dell'attività. Questa configurazione crea un'istanza dell'estensione destinata all'utilizzo dallo sviluppatore del proxy API. Ad esempio, potrebbe configurare un'estensione per accedere a un determinato bucket in Google Cloud Storage, incluse le credenziali di autenticazione richieste.
  • Uno sviluppatore di proxy API utilizza un'estensione configurata in un proxy API aggiungendo al proxy un criterio di callout dell'estensione. La configurazione del criterio specifica
    • l'estensione configurata da utilizzare.
    • le azioni dell'estensione (considerale come chiamate di funzione all'estensione) da richiamare.
    • i parametri azione da passare con la chiamata all'azione. In fase di esecuzione, il criterio utilizza l'estensione per accedere alla risorsa esterna nell'ambito del flusso del proxy.

Documentazione sulle estensioni

I seguenti argomenti forniscono ulteriori informazioni sulle estensioni: