Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Puoi utilizzare le estensioni per integrare risorse esterne nei proxy API. Ad esempio, puoi integrare servizi della piattaforma 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 dell'estensione
In fase di runtime, un'estensione funge da intermediario, elaborando richieste e risposte tra un proxy API e una risorsa esterna.
Ecco una panoramica del funzionamento dell'elaborazione tramite un'estensione in fase di runtime.
- Una richiesta client raggiunge un proxy API e il suo flusso di richieste procede attraverso i criteri del proxy.
- Il flusso di richieste raggiunge un criterio relativo ai callout delle estensioni nel proxy configurato per passare i dati a un'estensione implementata nell'ambiente. I dati includono valori che saranno necessari per inviare una richiesta alla risorsa esterna rappresentata dall'estensione.
- L'estensione invia una richiesta alla risorsa esterna, quindi riceve una risposta.
- L'estensione trasmette la sua risposta alle norme relative ai callout estensioni, dove viene gestita dal codice proxy.
- Il flusso di richieste continua attraverso il proxy fino a quando non restituisce una risposta al client.
Utilizzare le estensioni
Ogni estensione viene sviluppata e configurata tenendo conto di una specifica risorsa esterna. Per utilizzare un'estensione, un amministratore di Apigee Edge e uno sviluppatore di proxy API seguono questi passaggi generali:
- Un amministratore dell'organizzazione Apigee Edge configura ed esegue il deployment dell'estensione. Lo configura con valori specifici per le esigenze dell'azienda. Questa configurazione crea un'istanza dell'estensione specifica per l'utilizzo da parte dello sviluppatore del proxy API. Ad esempio, potrebbero configurare un'estensione per l'accesso a un determinato bucket in Google Cloud Storage, incluse le credenziali di autenticazione richieste.
- Uno sviluppatore proxy dell'API utilizza un'estensione configurata in un proxy API aggiungendo un criterio relativo ai callout delle estensioni al proxy. La configurazione del criterio specifica:
- quale estensione configurata da utilizzare.
- le azioni dell'estensione (pensa a queste come chiamate di funzione all'estensione) da richiamare.
- i parametri dell'azione da trasmettere con la chiamata all'azione. In fase di esecuzione, il criterio utilizza l'estensione per accedere alla risorsa esterna come parte del flusso del proxy.
Documentazione sulle estensioni
I seguenti argomenti forniscono ulteriori informazioni sulle estensioni:
- Per un'introduzione pratica alle estensioni, consulta Tutorial: aggiunta e utilizzo di un'estensione.
- Per riferimenti sulle estensioni incluse in Apigee Edge, consulta la panoramica del riferimento per le estensioni.
- Per i riferimenti sull'API di gestione che puoi utilizzare per aggiungere, rimuovere e implementare le estensioni, consulta l'articolo sull'API Extensions.