Ejemplos de cómo API Gateway evalúa las reglas de enrutamiento
A continuación se muestran cuatro ejemplos de cómo API Gateway evalúa las reglas de enrutamiento y las asignaciones de API.
Ejemplo 1: solo reglas de enrutamiento
En este ejemplo, el nombre de dominio personalizado https://petstore.example.com tiene el modo de enrutamiento establecido en ROUTING_RULE_ONLY y tiene las siguientes reglas de enrutamiento y prioridades.
| ID de regla | Priority (Prioridad) | Condiciones | Acción |
|---|---|---|---|
|
|
10 |
Si la solicitud contiene el encabezado |
API de destino 1 |
|
|
50 |
Si la solicitud contiene los encabezados |
API de destino 2 |
|
|
100 |
Ninguno |
API de destino 3 |
En la siguiente tabla se muestra cómo API Gateway aplica las reglas de enrutamiento anteriores a las solicitudes de ejemplo.
| Solicitud | API seleccionada | Explicación |
|---|---|---|
|
|
API de destino 1 |
La solicitud coincide con la regla de enrutamiento |
|
|
API de destino 1 |
API Gateway evalúa todas las reglas de enrutamiento por orden de prioridad. La regla de enrutamiento Aunque las condiciones de la solicitud también coinciden con la regla de enrutamiento |
|
|
API de destino 2 |
La solicitud coincide con la regla de enrutamiento |
|
|
API de destino 3 |
La solicitud no coincide con la regla de enrutamiento |
Ejemplo 2: reglas de enrutamiento y asignaciones de API
En este ejemplo, el nombre de dominio personalizado https://petstore.diagram.example.com tiene el modo de enrutamiento establecido en ROUTING_RULE_THEN_API_MAPPING y tiene las siguientes reglas de enrutamiento y asignaciones de API.
| ID de regla | Priority (Prioridad) | Condiciones | Acción |
|---|---|---|---|
|
|
1 |
Si la base de la solicitud contiene |
Invoque la etapa |
|
|
5 |
Si la solicitud contiene los encabezados |
Invoque la etapa |
En la siguiente tabla se muestran las asignaciones de la API para https://petstore.backup.example.com.
| Mapeo de API | API seleccionada |
|---|---|
|
|
Invoque la etapa |
|
|
Invoque la etapa |
En el siguiente diagrama se muestra cómo API Gateway aplica las reglas de enrutamiento anteriores a las solicitudes de ejemplo. Las solicitudes de ejemplo se resumen en la tabla que sigue a este diagrama.
En la siguiente tabal se muestra cómo API Gateway aplica las reglas de enrutamiento anteriores a las solicitudes de ejemplo.
| Solicitud | API seleccionada | Explicación |
|---|---|---|
|
|
La etapa |
La solicitud coincide con la regla de enrutamiento |
|
|
La etapa |
La solicitud coincide con la regla de enrutamiento |
|
|
La etapa |
La solicitud no tiene los encabezados necesarios para la coincidencia con la regla de enrutamiento |
|
|
La etapa |
La solicitud coincide con la asignación de la API a la ruta vacía |
Ejemplo 3: reglas de enrutamiento y asignaciones de API con varios niveles
En este ejemplo, el nombre de dominio personalizado https://petstore.backup.example.com tiene el modo de enrutamiento establecido en ROUTING_RULE_THEN_API_MAPPING y tiene las siguientes reglas de enrutamiento y asignaciones de API.
En la siguiente tabla se muestran las reglas de enrutamiento para https://petstore.backup.example.com.
| ID de regla | Priority (Prioridad) | Condiciones | Acción |
|---|---|---|---|
|
|
10 |
Si la solicitud contiene el encabezado |
API de destino 1 |
|
|
50 |
Si la solicitud contiene los encabezados |
API de destino 2 |
En la siguiente tabla se muestran las asignaciones de la API para https://petstore.backup.example.com.
| Mapeo de API | API seleccionada |
|---|---|
|
|
API de destino 3 |
|
|
API de destino 4 |
En la siguiente tabal se muestra cómo API Gateway aplica las reglas de enrutamiento anteriores a las solicitudes de ejemplo.
| Solicitud | API seleccionada | Explicación |
|---|---|---|
|
|
API de destino 3 |
La solicitud no tiene los encabezados necesarios para la coincidencia con la regla de enrutamiento |
|
|
API de destino 1 |
La solicitud coincide con la regla de enrutamiento |
|
|
Ninguno |
La solicitud no coincide con ninguna regla de enrutamiento ni asignación de API. Dado que no hay ninguna regla de enrutamiento predeterminada, API Gateway rechaza la llamada y envía al intermediario un código de estado |
Ejemplo 4: reglas de enrutamiento para nombres de dominio comodín
En este ejemplo, el nombre de dominio personalizado https://*.example.com es un nombre de dominio comodín. El comodín admite todos los subdominios que enrutan al mismo dominio. Las siguientes reglas de enrutamiento de ejemplo cambian este comportamiento para permitir que los subdominios enruten a diferentes API de destino mediante el encabezado Host.
En la siguiente tabla se muestran las reglas de enrutamiento para https://*.example.com.
| ID de regla | Priority (Prioridad) | Condiciones | Acción |
|---|---|---|---|
|
|
10 |
Si la solicitud contiene el encabezado |
API de destino 1 |
|
|
50 |
Si la solicitud contiene encabezados |
API de destino 2 |
|
|
500 |
Ninguno |
API de destino 3 |
En la siguiente tabla se muestra cómo API Gateway aplica las reglas de enrutamiento anteriores a las solicitudes de ejemplo.
| Solicitud | API seleccionada | Explicación |
|---|---|---|
|
|
API de destino 1 |
El encabezado |
|
|
API de destino 2 |
El encabezado |
|
|
API de destino 3 |
Coincide con la regla de enrutamiento catch-all |
