Todos los productos
Search
Centro de documentos

API Gateway:Crear una ruta

Última actualización: Sep 17, 2026

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.

  1. Associated Domain Name: las cadenas de dominio más largas tienen mayor prioridad.

  2. 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.

  3. Header: una mayor cantidad de pares clave-valor implica mayor prioridad.

  4. Query Parameters: una mayor cantidad de pares clave-valor implica mayor prioridad.

  5. Created At: las fechas de creación más antiguas tienen mayor prioridad.

Procedimiento

Nota
  • Las rutas admiten HTTP/1.0, HTTP/1.1, HTTP/2.0, gRPC y WebSocket.

  • El alcance de las rutas se limita a la instancia donde se crean.

  1. Cree una ruta desde fuera o desde dentro de una instancia de puerta de enlace.

    Desde fuera de una instancia

    1. 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.

    2. Haga clic en la API de destino y seleccione la instancia correspondiente o All Instances en la lista desplegable.imagen

    3. Haga clic en Create Route.

    Desde dentro de una instancia

    1. 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.

    2. 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.

    3. Haga clic en Create Route.

  2. En la página Create Route, configure los parámetros y haga clic en Save o en Save and Publish.

    Nota
    • Las 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.

    Nota

    La 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.

    Nota

    Fallback 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.