Questa pagina si applica ad Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.
Un percorso determina il percorso di una richiesta dal ProxyEndpoint
al
TargetEndpoint
. Il percorso include l'URL utilizzato per accedere all'API
ProxyEndpoint
e l'URL del servizio di backend definito da
TargetEndpoint
.
Guarda questo video per un'introduzione ai percorsi, che descrive la relazione tra ProxyEndpoint
e TargetEndpoint
.
Determinazione dell'URL dell'endpoint del proxy API
L'immagine seguente mostra una richiesta in arrivo al ProxyEndpoint
da un'app e la richiesta indirizzata al servizio di backend:
Dopo aver creato un proxy API su Apigee, l'URL predefinito utilizzato da un'app per accedere al proxy ha il seguente formato:
https://www.example.com/shopping/cart/addItem |_____________| |___________| |_____| | | | hostname basepath resource
Dove:
- Il nome host è un dominio che hai aggiunto al DNS o un indirizzo IP.
- Il percorso base e il percorso della risorsa vengono definiti quando crei il proxy API.
Quando Apigee riceve una richiesta, analizza l'URL per indirizzarla al ProxyEndpoint
corretto. Ad esempio, il seguente URL viene utilizzato per accedere a un proxy API:
http://example.com/v1/weather/forecastrss
Se esamini la definizione di ProxyEndpoint
per il proxy API nella figura sopra,
puoi vedere come viene analizzato questo URL:
- La parte di dominio dell'URL,
http://example.com
, corrisponde a un nome host definito in un gruppo di ambienti. Il proxy è stato disegnato in uno o più ambienti all'interno del gruppo di ambienti. Per saperne di più, consulta Informazioni sugli ambienti e su Gruppi di ambienti. - La seconda parte dell'URL,
/v1/weather
, è determinata dall'elemento<BasePath>
inProxyEndpoint
. Hai definito il percorso di base quando hai creato il proxy. Il percorso di base deve essere univoco per il proxy API per l'ambiente in modo che due proxy API nello stesso ambiente non abbiano lo stesso percorso di base. - La terza parte dell'URL,
/forecastrss
, è una risorsa definita dal proxy API con il flusso condizionale corrispondente definito dall'elemento<Flows>
.
Video:guarda un breve video per scoprire di più sugli endpoint proxy API.
Determinazione dell'URL dell'endpoint di destinazione
L'elemento <RouteRule>
in una
definizione ProxyEndpoint
determina la destinazione del proxy API e viene valutato dopo che tutti
i criteri in PreFlow, Conditional Flows e PostFlow della richiesta ProxyEndpoint
sono
stati elaborati.
Un ProxyEndpoint
può definire il target come:
- Un URL diretto a un servizio di backend.
- Una singola definizione di
TargetEndpoint
. - Più
TargetEndpoint
in cui il proxy API delega la richiesta a un endpoint di destinazione in base a una condizione. - Percorso o target nullo, il che significa che la richiesta non viene inoltrata a un target. ma tutta l'elaborazione della richiesta e la generazione della risposta avvengono su Apigee.
Video:guarda un breve video per scoprire di più sugli endpoint di destinazione.
URL diretto
Un ProxyEndpoint
può richiamare direttamente un servizio di backend, bypassando qualsiasi configurazione TargetEndpoint
nominato. Ad esempio, il seguente <RouteRule>
effettua sempre una chiamata HTTP
a http://example.com/myAPI:
<RouteRule name="default"> <URL>http://example.com/myAPI</URL> </RouteRule>
Tuttavia, poiché non esiste TargetEndpoint
, puoi aggiungere criteri solo ai flussi definiti da ProxyEndpoint
.
Destinazione singola
In una singola definizione di target, ProxyEndpoint
fa riferimento a una singola definizione di TargetEndpoint
per nome, come mostrato nella figura sopra:
<RouteRule name="default"> <TargetEndpoint>default</TargetEndpoint> </RouteRule>
Tutte le richieste a questo proxy API vengono indirizzate alla stessa definizione TargetEndpoint
. Il tag <URL>
in TargetEndpoint
determina la posizione del servizio di backend. Nella figura sopra, l'URL target è http://weather.yahooapis.com
.
Target condizionali
Il tag <RouteRule>
consente di indirizzare una richiesta a un target in base a una condizione. Per determinare l'endpoint di destinazione, puoi utilizzare variabili di flusso, parametri di query, intestazioni HTTP, contenuti dei messaggi o informazioni contestuali come l'ora del giorno e le impostazioni internazionali. Ad esempio, in un URL richiesta potresti includere un'area geografica, come Stati Uniti e Regno Unito. Puoi quindi indirizzare una richiesta a un endpoint di destinazione in base alla regione.
La seguente regola di route valuta un'intestazione HTTP in una richiesta. Se l'intestazione HTTP
routeTo
ha il valore
TargetEndpoint1
, la richiesta
viene inoltrata al TargetEndpoint
denominato TargetEndpoint1
. In caso contrario, la richiesta viene inoltrata a TargetEndpoint2
.
<RouteRule name="MyRoute"> <Condition>request.header.routeTo = "TargetEndpoint1"</Condition> <TargetEndpoint>TargetEndpoint1</TargetEndpoint> </RouteRule> <RouteRule name="default"> <TargetEndpoint>TargetEndpoint2</TargetEndpoint> </RouteRule>
Se hai più regole di routing, creane una come predefinita, ovvero come regola di routing senza condizioni. Assicurati che la regola di route predefinita sia definita per ultima nell'elenco
dei route condizionali perché le regole vengono valutate dall'alto verso il basso in ProxyEndpoint
.
Consulta anche Percorsi agevolati e Riferimento alle condizioni.
Video: guarda un breve video per scoprire come indirizzare a un endpoint target utilizzando i target condizionali.
Percorso nullo
Un percorso nullo supporta gli scenari in cui il messaggio di richiesta non deve essere inoltrato a un TargetEndpoint
. Questa opzione è utile quando ProxyEndpoint
esegue tutta l'elaborazione necessaria, ad esempio utilizzando JavaScript per chiamare un servizio esterno.
L'esempio seguente definisce un percorso nullo:
<RouteRule name="GoNowhere"/>
Scopri di più
- Riferimento per la configurazione dei proxy API
- Riferimento per le proprietà degli endpoint
- Bilanciamento del carico tra i server di backend