Stai visualizzando la documentazione relativa a Apigee e Apigee ibrido.
Visualizza
Documentazione di Apigee Edge.
La configurazione di ProxyEndpoint definisce il modo in cui le app client utilizzano le API tramite Apigee. ProxyEndpoint definisce l'URL del proxy API e il comportamento di un proxy: quali criteri applicare e a quali endpoint target instradare, nonché le condizioni che devono essere soddisfatte per l'esecuzione di questi criteri o delle regole di instradamento.
In breve, la configurazione ProxyEndpoint definisce tutto ciò che deve essere fatto per implementare tramite Google Cloud CLI o tramite l'API Compute Engine.
Antipattern
Un proxy API può avere uno o più endpoint proxy. La definizione di più ProxyEndpoint è una facile e un semplice meccanismo per implementare più API in un unico proxy. In questo modo, puoi riutilizzare i criteri e/o la logica di business prima e dopo l'invocazione di un endpoint di destinazione.
D'altra parte, quando definisci più ProxyEndpoint in un singolo proxy API, finisci per combinare concettualmente molte API non correlate in un unico artefatto. Rende più difficili i proxy API per leggere, comprendere, eseguire il debug e gestire. Questo mina la filosofia principale dei proxy API: semplificare per gli sviluppatori la creazione e la gestione delle API.
Impatto
Più ProxyEndpoint in un proxy API possono:
- Rendere difficile per gli sviluppatori comprendere e gestire il proxy API.
- Offuscare l'analisi. Per impostazione predefinita, i dati di analisi vengono aggregati a livello di proxy. Non è prevista alcuna suddivisione delle metriche per endpoint proxy, a meno che non crei report personalizzati.
- Semplifica la risoluzione dei problemi relativi ai proxy API.
Best practice
Quando implementi un nuovo proxy API o riprogetta un proxy API esistente, utilizza la seguenti best practice:
- Implementare un proxy API con un singolo ProxyEndpoint.
- Se esistono più API che condividono un server di destinazione comune e/o richiedono la stessa logica o dopo la chiamata al server di destinazione, valuta la possibilità di utilizzare flussi condivisi per implementare questa logica proxy API diversi.
- Se sono presenti più API che condividono un percorso base iniziale comune, ma differiscono nel suffisso, utilizza flussi condizionali in un singolo ProxyEndpoint.
- Se esiste un proxy API con più ProxyEndpoint e non ci sono problemi, non è necessario intervenire.
L'utilizzo di un ProxyEndpoint per proxy API comporta:
- Proxy più semplici e facili da gestire
- Analytics fornisce migliori informazioni, come le prestazioni proxy e il tempo di risposta target, riportati separatamente invece che raggruppati per tutti i ProxyEndpoint
- Risoluzione dei problemi e risoluzione dei problemi più rapide