Esempi di come Gateway API valuta le regole di routing
La sezione seguente illustra quattro esempi di come Gateway API valuta le regole di routing e le mappature API.
Esempio 1: solo regole di routing
In questo esempio, il nome di dominio personalizzato https://petstore.example.com ha la modalità di routing impostata su ROUTING_RULE_ONLY con le regole di routing e le priorità riportate di seguito.
| ID della regola | Priorità | Condizioni | Azione |
|---|---|---|---|
|
|
10 |
Se la richiesta contiene l’intestazione |
API di destinazione 1 |
|
|
50 |
Se la richiesta contiene le intestazioni |
API di destinazione 2 |
|
|
100 |
Nessuno |
API di destinazione 3 |
La tabella seguente mostra come Gateway API applica le regole di routing precedenti alle richieste di esempio.
| Richiesta | API selezionata | Spiegazione |
|---|---|---|
|
|
API di destinazione 1 |
La richiesta soddisfa la regola di routing |
|
|
API di destinazione 1 |
Gateway API valuta tutte le regole di routing in ordine di priorità. La regola di routing Sebbene le condizioni della richiesta corrispondano anche alla regola di routing |
|
|
API di destinazione 2 |
La richiesta soddisfa la regola di routing |
|
|
API di destinazione 3 |
La richiesta non soddisfa la regola di routing |
Esempio 2: regole di routing e mappature API
In questo esempio, il nome di dominio personalizzato https://petstore.diagram.example.com ha la modalità di routing impostata su ROUTING_RULE_THEN_API_MAPPING e le seguenti regole di routing e mappature API.
| ID della regola | Priorità | Condizioni | Azione |
|---|---|---|---|
|
|
1 |
Se la richiesta contiene |
Invoca la fase |
|
|
5 |
Se la richiesta contiene l’intestazione |
Invoca la fase |
La tabella riportata di seguito mostra le mappature API per https://petstore.backup.example.com.
| Mappatura API | API selezionata |
|---|---|
|
|
Invoca la fase |
|
|
Invoca la fase |
Il diagramma seguente mostra come Gateway API applica le regole di routing e le mappature API precedenti alle richieste di esempio. Le richieste di esempio sono riepilogate nella tabella che segue il diagramma.
La tabella seguente mostra come Gateway API applica le regole di routing e le mappature API precedenti alle richieste di esempio.
| Richiesta | API selezionata | Spiegazione |
|---|---|---|
|
|
La fase |
La richiesta soddisfa la regola di routing |
|
|
La fase |
La richiesta soddisfa la regola di routing |
|
|
La fase |
La richiesta non ha le intestazioni necessarie per soddisfare la regola di routing |
|
|
La fase |
La richiesta esegue la corrispondenza della mappatura API al percorso vuoto |
Esempio 3: regole di routing e mappature API con più livelli
In questo esempio, il nome di dominio personalizzato https://petstore.backup.example.com ha la modalità di routing impostata su ROUTING_RULE_THEN_API_MAPPING e le seguenti regole di routing e mappature API.
La tabella seguente mostra le regole di routing per https://petstore.backup.example.com.
| ID della regola | Priorità | Condizioni | Azione |
|---|---|---|---|
|
|
10 |
Se la richiesta contiene l’intestazione |
API di destinazione 1 |
|
|
50 |
Se la richiesta contiene le intestazioni |
API di destinazione 2 |
La tabella riportata di seguito mostra le mappature API per https://petstore.backup.example.com.
| Mappatura API | API selezionata |
|---|---|
|
|
API di destinazione 3 |
|
|
API di destinazione 4 |
La tabella seguente mostra come Gateway API applica le regole di routing e le mappature API precedenti alle richieste di esempio.
| Richiesta | API selezionata | Spiegazione |
|---|---|---|
|
|
API di destinazione 3 |
La richiesta non ha le intestazioni necessarie per soddisfare la regola di routing |
|
|
API di destinazione 1 |
La richiesta soddisfa la regola di routing |
|
|
Nessuno |
La richiesta non soddisfa nessuna regola di routing o mappatura API. Poiché non esiste una regola di routing predefinita, Gateway API rifiuta la chiamata e invia al chiamante un codice di stato |
Esempio 4: regole di routing per i nomi di dominio con caratteri jolly
In questo esempio, il nome di dominio personalizzato https://*.example.com è un nome di dominio con caratteri jolly. Il carattere jolly supporta tutti i sottodomini che vengono instradati nuovamente allo stesso dominio. Le regole di routing di esempio seguenti modificano questo comportamento per consentire l’instradamento dei sottodomini a diverse API di destinazione utilizzando l’intestazione Host.
La tabella seguente mostra le regole di routing per https://*.example.com.
| ID della regola | Priorità | Condizioni | Azione |
|---|---|---|---|
|
|
10 |
Se la richiesta contiene l’intestazione |
API di destinazione 1 |
|
|
50 |
Se la richiesta contiene l’intestazione |
API di destinazione 2 |
|
|
500 |
Nessuno |
API di destinazione 3 |
La tabella seguente mostra come Gateway API applica le regole di routing precedenti alle richieste di esempio.
| Richiesta | API selezionata | Spiegazione |
|---|---|---|
|
|
API di destinazione 1 |
L’intestazione |
|
|
API di destinazione 2 |
L’intestazione |
|
|
API di destinazione 3 |
Questa richiesta soddisfa la regola di routing catch-all |
