Cloud-native API Gateway evalúa las reglas de enrutamiento de mayor a menor prioridad. Si una solicitud coincide con una regla, la puerta de enlace la reenvía al servicio de backend configurado. Si ninguna regla coincide, devuelve un error 404.
Prioridad de coincidencia de rutas
Cuando existen varias reglas de enrutamiento, se priorizan de la siguiente manera: Associated Domain Name > Path > Header > Query Parameters > Created At.
Associated Domain Name: las cadenas de dominio más largas tienen mayor prioridad.
-
Path:
Si el valor de Match Rule difiere, la prioridad es: Equals To > Prefix > Regular Expression Match.
Si el valor de Match Rule es el mismo, los valores más largos de Path tienen mayor prioridad.
Header: una mayor cantidad de pares clave-valor implica mayor prioridad.
Query Parameters: una mayor cantidad de pares clave-valor implica mayor prioridad.
Created At: las fechas de creación más antiguas tienen mayor prioridad.
Procedimiento
-
Cree una ruta desde fuera o desde dentro de una instancia de puerta de enlace.
Desde 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.
Haga clic en la API de destino y seleccione la instancia correspondiente o All Instances en la lista desplegable.

Haga clic en Create Route.
Desde 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 página Instance, haga clic en el identificador de la instancia de puerta de enlace de destino. En el panel de navegación izquierdo, haga clic en API y luego en la API de destino.
Haga clic en Create Route.
-
En la página Create Route, configure los parámetros y haga clic en Save o en Save and Publish.
NotaLas condiciones de coincidencia se combinan con un operador lógico AND. A mayor número de condiciones, menor será el alcance de coincidencia.
La prioridad de las rutas sigue el orden de visualización en la página de configuración.
Parámetro
Descripción
Route Name
Nombre personalizado para la ruta.
Route Description
Haga clic en Add Route Description para agregar una descripción de la ruta.
Domain Name
-
Seleccione uno o varios dominios que deben coincidir.
-
Para agregar un dominio, haga clic en Add Domain y siga las instrucciones en pantalla.
Path
Ruta de la solicitud que debe coincidir.
-
Con la misma regla de coincidencia, las rutas más largas tienen mayor prioridad.
-
Con reglas de coincidencia distintas, la prioridad es: Equals To > Prefix > Regular Expression Match.
-
Equals To: coincide con la ruta exacta, por ejemplo,
/user. -
Prefix: coincide con un prefijo de ruta, por ejemplo, las rutas que comienzan con
/user. -
Regular Expression Match: coincide con un patrón de expresión regular.
-
Method
Método HTTP que debe coincidir. Seleccione varios métodos si lo requiere. Valor predeterminado: ANY.
Header
Encabezados de la solicitud que deben coincidir.
Query Parameters
Parámetros de consulta que deben coincidir.
Instance
Instancia de puerta de enlace para esta ruta.
Scenario
Tipo de servicio de backend para la ruta.
-
Escenario básico: Single Service
-
Escenario de versión canary: By Percentage (Multi-service), Tag (Tag-based Routing)
-
Otros escenarios: Mock, Redirect
Los tipos de servicios de backend se describen en Routes.
NotaLa suma de los pesos de tráfico de todos los servicios de backend debe ser del 100 %.
Backend Services
Servicio de backend y puerto hacia donde esta ruta reenvía las solicitudes.
Nota-
Haga clic en Associated Service para seleccionar un origen y un servicio.
-
El número máximo de orígenes depende del tipo de origen.
-
Container Service: hasta 5 orígenes.
-
Nacos y Zookeeper: solo 1 origen.
-
Timeout Period (seconds)
Tiempo de espera de la solicitud en segundos. Valor predeterminado: 60. Establezca este valor en 0 para deshabilitar el tiempo de espera.
Fallback
Servicio que recibe las solicitudes cuando el backend principal no tiene nodos disponibles.
NotaFallback solo es compatible con servicios HTTP.
Retry Times
Número de reintentos. Valor predeterminado: 2. Establezca este valor en 0 para deshabilitar los reintentos.
Retry Condition
Condiciones que activan un reintento.
Retry Status Code
Códigos de estado que activan un reintento.