API Gateway:Configure a retry policy

Condiciones de reintento

Cuando un servicio de backend devuelve un error 5xx, Cloud-native API Gateway reintenta automáticamente la solicitud hasta el número máximo de veces configurado.

• Condiciones de reintento para el protocolo HTTP:

  • 5xx: El servicio de backend devuelve una respuesta 5xx, o bien se desconecta, restablece o agota el tiempo de espera de una conexión durante una operación de lectura.

    Nota

    La condición 5xx incluye las condiciones connect-failure y refused-stream.

  • reset: Se desconecta, restablece o agota el tiempo de espera de una conexión durante una operación de lectura.

  • connect-failure: Una solicitud falla porque la conexión se ha desconectado.

  • refused-stream: El servicio de backend restablece un stream con un código de error REFUSED_STREAM.

  • retriable-status-codes: El código de estado HTTP en la respuesta coincide con un código de estado de reintento especificado.

    Nota

    Solo es posible usar códigos de estado de reintento si se especifica retriable-status-codes en la condición de reintento.

• Condiciones de reintento para el protocolo gRPC:

  • cancelled: El código de estado gRPC en el encabezado de respuesta es cancelled.

  • deadline-exceeded: El código de estado gRPC en el encabezado de respuesta es deadline-exceeded.

  • internal: El código de estado gRPC en el encabezado de respuesta es internal.

  • resource-exhausted: El código de estado gRPC en el encabezado de respuesta es resource-exhausted.

  • unavailable: El código de estado gRPC en el encabezado de respuesta es unavailable.

Configurar una política de reintentos de ruta

1. Es posible configurar una política de reintentos de dos formas, según cómo se gestione su API:

   API 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 luego seleccione una región en la barra de menú superior.

   2. En la página HTTP API, use la lista desplegable de la parte superior para seleccionar la instancia de destino. Puede seleccionar una instancia específica o All instances.

   3. En Routes, haga clic en la ruta de destino.

   API 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 luego seleccione una región en la barra de menú superior.

   2. En la página Instance, haga clic en la instancia de gateway de destino. En el panel de navegación izquierdo, haga clic en API y luego en la API de destino.

   3. En Routes, haga clic en la ruta de destino.

2. Haga clic en la pestaña Configure Policy. En la sección Inbound Processing, haga clic en Enable Policy/Plug-in.

3. Haga clic en la tarjeta Retry. En el panel Add Policy: Retry, configure los parámetros y haga clic en Add.

   Nota

   Después de configurar y habilitar la política de reintentos, compruebe que funciona como se espera.

   Parámetro	Descripción
   Enable	Habilita o deshabilita la política de reintentos. Enabled: La política de reintentos está activa. Disabled: La política de reintentos está inactiva. Nota Si esta política se encuentra deshabilitada, el gateway utiliza una configuración de reintentos predeterminada. El número predeterminado de reintentos es 2, y las condiciones de reintento predeterminadas son connect-failure, refused-stream, unavailable, cancelled y retriable-status-codes.
   Retry Times	El número máximo de reintentos para una solicitud con errores. Valores válidos: de 0 a 10. Se recomienda un valor de 2 o menos. Nota Un valor de 0 deshabilita los reintentos.
   Retry Condition	Las condiciones que activan un reintento. Es posible seleccionar varias condiciones. Para obtener más información, consulte Retry conditions.
   Retry Status Code	Los códigos de estado HTTP que activan un reintento. Es posible especificar varios códigos. Nota Solo es posible configurar el parámetro Retry Status Code si se selecciona retriable-status-codes en Retry Condition.