Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Comportamiento de los reintentos

El comportamiento de reintento incluye la configuración relativa a la forma en que los SDK intentan recuperarse de los errores derivados de las solicitudes realizadas a los Servicios de AWS.

Elegir entre los modos de reintento standard y adaptive

Le recomendamos que utilice el modo de reintento standard a menos que esté seguro de que su uso es el más adecuado para adaptive.

Si opta por utilizar el modo adaptive, la aplicación debe crear clientes diseñados en función de cada recurso que pueda estar limitado. Un recurso, en este caso, es más preciso que pensar en cada Servicio de AWS. Los Servicios de AWS pueden tener dimensiones adicionales que utilizan para limitar las solicitudes. Usemos el servicio Amazon DynamoDB como ejemplo. DynamoDB usa Región de AWS más la tabla a la que se accede para limitar las solicitudes. Esto significa que una tabla a la que está accediendo su código podría estar más limitada que otras. Si el código utilizaba el mismo cliente para acceder a todas las tablas y las solicitudes a una de esas tablas están limitadas, el modo de reintento adaptativo reducirá la tasa de solicitudes de todas las tablas. El código debe diseñarse para tener un cliente por cada par de región y tabla. Si sufre una latencia inesperada al usar el modo adaptive, consulte la guía de documentación específica de AWS del servicio que esté utilizando.

Detalles de implementación del modo de reintento

Los SDK de AWS utilizan buckets de tokens para decidir si se debe volver a intentar una solicitud y (en el caso del modo de reintento adaptive) con qué rapidez se deben enviar las solicitudes. El SDK utiliza dos grupos de buckets de tokens: un bucket de token de reintentos y un bucket de token de tasa de solicitud.

A continuación se muestra el pseudocódigo de alto nivel para ambos modos de reintento standard y adaptive:

MakeSDKRequest() {
  attempts = 0
  loop {
    GetSendToken()
    response = SendHTTPRequest()
    RequestBookkeeping(response)
    if not Retryable(response)
      return response
    attempts += 1
    if attempts >= MAX_ATTEMPTS:
      return response
    if not HasRetryQuota(response)
      return response
    delay = ExponentialBackoff(attempts)
    sleep(delay)
  }
}

A continuación se muestran más detalles sobre los componentes utilizados en el pseudocódigo:

GetSendToken:

Este paso solo se utiliza en el modo de reintento adaptive. Este paso adquiere un token del bucket de tokens de tasa de solicitud. Si un token no está disponible, esperará a que uno esté disponible. Es posible que el SDK tenga opciones de configuración disponibles para rechazar la solicitud en lugar de esperar. Los tokens del bucket se rellenan a un ritmo que se determina de forma dinámica, en función del número de respuestas de limitación que reciba el cliente.

SendHTTPRequest:

Este paso envía la solicitud a AWS. La mayoría de los SDK de AWS utilizan una biblioteca HTTP que utiliza grupos de conexiones para que puedas reutilizar una conexión existente al realizar una solicitud HTTP. Por lo general, las conexiones se reutilizan si una solicitud falla debido a errores de limitación, pero no si la solicitud falla debido a un error transitorio.

RequestBookkeeping:

Los tokens se agregan al bucket de tokens si la solicitud se realiza correctamente. Solo en el modo de reintento adaptive, la tasa de llenado del bucket de tokens de tasa de solicitudes se actualiza en función del tipo de respuesta recibida.

Retryable:

Este paso determina si se puede volver a intentar una respuesta en función de lo siguiente:

Los errores transitorios (códigos de estado HTTP 400, 408, 500, 502, 503 y 504) y los errores de limitación (códigos de estado HTTP 400, 403, 429, 502, 503 y 509) se pueden volver a intentar. El comportamiento de los reintentos del SDK se determina en combinación con los códigos de error u otros datos del servicio.

MAX_ATTEMPTS:

El número máximo de intentos predeterminado lo establece la configuración retry_mode, a menos que la configuración max_attempts lo anule.

HasRetryQuota

Este paso adquiere un token del bucket de tokens de reintento. Si el bucket de tokens de reintento está vacío, no se volverá a intentar la solicitud.

ExponentialBackoff

En el caso de un error que se pueda volver a intentar, el retraso del reintento se calcula mediante un retroceso exponencial truncado. Los SDK utilizan un retroceso exponencial binario truncado con fluctuación de fase. El siguiente algoritmo muestra cómo se define la cantidad de tiempo de reposo, en segundos, para una respuesta a una solicitud i:

seconds_to_sleep_i = min(b*r^i, MAX_BACKOFF)

En el algoritmo anterior, se aplican los siguientes valores:

b = random number within the range of: 0 <= b <= 1

r = 2

MAX_BACKOFF = 20 seconds para la mayoría de los SDK. Consulte la guía o el código fuente específicos del SDK para confirmarlo.

Soporte mediante SKD y herramientas de AWS

Los siguientes SDK admiten las características y los ajustes descritos en este tema. Se anotan todas las excepciones parciales. Todos los ajustes de propiedades del sistema JVM son compatibles con AWS SDK para Java y AWS SDK para Kotlin únicamente.