Una directiva de reescritura HTTP modifica la ruta y el nombre de host de una solicitud antes de reenviarla a un servicio de backend. Esto le otorga un control preciso sobre el enrutamiento para cumplir con sus requisitos de negocio y de arquitectura.
Configurar una directiva de reescritura HTTP
La reescritura HTTP modifica la ruta y el nombre de host de la solicitud original.
-
Cloud-native API Gateway ofrece dos formas de configurar una directiva de reescritura HTTP: para las API gestionadas fuera de una instancia y para las API gestionadas dentro de una instancia.
API fuera de una instancia
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, haga clic en API y seleccione una región en la barra de menú superior.
Haga clic en la API de destino. En la lista desplegable All instances de la parte superior, seleccione la instancia de destino o bien All Instances.
En la pestaña Routes, seleccione la ruta de destino.
API dentro de una instancia
Inicie sesión en la consola de Cloud-native API Gateway. En el panel de navegación izquierdo, haga clic en Instance y seleccione una región en la barra de menú superior.
En la página Instance, haga clic en el ID de la instancia de gateway de destino. En el panel de navegación izquierdo, haga clic en API y luego en la API de destino.
En la pestaña Routes, seleccione la ruta de destino.
Haga clic en la pestaña Configure Policy. Después, en la sección Inbound Processing, haga clic en Enable Policy/Plug-in.
Haga clic en la tarjeta HTTP Rewrite. En el panel Add Policy: HTTP Rewrite, configure los parámetros y haga clic en Add.
Reescritura de ruta
Cloud-native API Gateway es compatible con dos métodos de reescritura de ruta: por prefijo y por expresión regular.
Reescritura por prefijo
Este método cambia el prefijo de la ruta de una solicitud.
Ejemplo 1
Para cambiar la ruta de una solicitud de /app/test a /test antes de reenviarla a un servicio de backend, utilice la siguiente configuración:
Condición de coincidencia de ruta: el tipo de coincidencia es Prefix Match y la ruta es
/app/.Reescritura: el tipo de reescritura es Prefix Rewrite y la ruta es
/.
La ruta de la condición de coincidencia debe ser /app/. Esto se debe a que la reescritura por prefijo solo reemplaza la cadena que coincide con la regla de prefijo. Si la ruta de la condición se estableciera en /app, la ruta resultante sería //test, lo cual no corresponde al resultado esperado.
Ejemplo 2
Si necesita cambiar la ruta de una solicitud de /v1/test a /v2/test, aplique la siguiente configuración:
Condición de coincidencia de ruta: el tipo de coincidencia es Prefix Match y la ruta es
/v1.Reescritura: el tipo de reescritura es Prefix Rewrite y la ruta es
/v2.
La reescritura por prefijo requiere que el tipo de coincidencia de la ruta sea Prefix Match. Este tipo de reescritura no es compatible con rutas que usan Exact Match o Regex Match. Dado que la coincidencia por prefijo aplica a todas las solicitudes que comparten un mismo prefijo de ruta, evalúe cuidadosamente si todas las solicitudes coincidentes deben reescribirse. De lo contrario, considere usar una reescritura por expresión regular.
Reescritura por expresión regular
Esta función modifica una parte de la ruta de la solicitud mediante un parámetro mode (el patrón de expresión regular que se busca) y un parámetro replacement (la cadena de sustitución). Para conocer los detalles de sintaxis, consulte la documentación sobre sintaxis de expresiones regulares.
Ejemplo 1
Para cambiar la ruta de una solicitud de /aaa/one/bbb/one/ccc a /aaa/two/bbb/two/ccc, utilice la siguiente configuración:
Condición de coincidencia de ruta: el tipo de coincidencia es Exact Match y la ruta es
/aaa/one/bbb/one/ccc.Reescritura: el tipo de reescritura es Regex Rewrite, el valor de
modeesoney el dereplacementestwo.
Ejemplo 2
Para quitar el prefijo /httpbin de una ruta como /httpbin/(.*)/(.*) e intercambiar los dos grupos capturados, aplique la siguiente configuración:
Condición de coincidencia de ruta: el tipo de coincidencia es Regex Match y la ruta es
/httpbin/(.*)/(.*).Reescritura: el tipo de reescritura es Regex Rewrite, el valor de
modees/httpbin/(.*)/(.*)y el dereplacementes/\2/\1. En esta cadena,\1representa el primer grupo capturado por la expresión regular y\2representa el segundo. Este comportamiento es similar al de las variables $1 y $2 que se utilizan en Nginx.
La reescritura por expresión regular es una función avanzada con una sintaxis compleja que suele reservarse para casos especiales. Se recomienda utilizar la reescritura por prefijo si esta cubre sus necesidades.
Reescritura de nombre de host
Cloud-native API Gateway es compatible con la reescritura exacta del nombre de host.
Por ejemplo, para cambiar el nombre de host de la solicitud de test.com a dev.com, establezca el nombre de host de reescritura en dev.com dentro de la configuración de la directiva.