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.

Reintentos y tiempos de espera

AWS SDK for .NET permite configurar el número de reintentos y los valores de tiempo de espera de las solicitudes HTTP relativas a servicios de AWS. Si los valores predeterminados de los reintentos y los tiempos de espera no son adecuados para su aplicación, puede ajustarlos para sus requisitos específicos, pero es importante comprender cómo afectará hacer esto al comportamiento de su aplicación.

Para determinar qué valores usar para los reintentos y los tiempos de espera, tenga en cuenta lo siguiente:

Reintentos

Información general

AWS SDK for .NET reintentará las solicitudes con errores producidos por la limitación controlada del lado del servidor o por conexiones perdidas. Hay dos propiedades de las clases de configuración de servicios que se pueden usar para especificar el comportamiento de reintento de un cliente de servicio. Las clases de configuración de servicios heredan estas propiedades del resumen Amazon.Runtime. ClientConfigclase de la referencia de la APIAWS SDK for .NET:

Las descripciones detalladas de estas propiedades se encuentran en el resumen Amazon.Runtime. ClientConfigclase de la AWS SDK for .NETAPI Reference. Cada valor de RetryMode se corresponde de forma predeterminada con un valor concreto de MaxErrorRetry, como se muestra en la siguiente tabla.

Comportamiento

Cuando la aplicación se inicia

Cuando la aplicación se inicia, SDK configura los valores predeterminados de RetryMode y MaxErrorRetry. Estos valores predeterminados se utilizarán cuando cree un cliente de servicio, a menos que especifique otros valores.

Mientras la aplicación se ejecuta

Al crear un cliente de servicio, puede usar los valores predeterminados de RetryMode y MaxErrorRetry, tal y como se ha explicado anteriormente, o bien puede especificar otros valores. Para especificar otros valores, cree e incluya un objeto de configuración de servicio como AmazonDynamoDBConfig o AmazonSQSConfig al crear el cliente de servicio.

Una vez creado el servicio de cliente, estos valores no podrán modificarse.

Consideraciones

Cuando se produce un reintento, aumenta la latencia de la solicitud. Debe configurar sus reintentos según los límites de su aplicación para la latencia de solicitudes total y las tasas de error.

Tiempos de espera

AWS SDK for .NET permite configurar los valores de tiempo de espera de la solicitud o de tiempo de espera de lectura/escritura del socket en el nivel de cliente del servicio. Estos valores se especifican en las ReadWriteTimeout propiedades del Timeout resumen Amazon.Runtime. ClientConfigclase. Estos valores se transmiten como ReadWriteTimeout propiedades de Timeout los HttpWebRequestobjetos creados por el objeto del cliente de AWS servicio. De forma predeterminada, el valor Timeout es de 100 segundos y el valor ReadWriteTimeout es de 300 segundos.

Cuando su red tiene una elevada latencia o existen condiciones que hacen que se reintente una operación, el uso de valores de tiempo de espera largo y un elevado número de reintentos pueden hacer que algunas operaciones del SDK parezcan no tener capacidad de respuesta.

A continuación, se indican las excepciones sobre los valores de tiempo de espera predeterminados. Estos valores se invalidan al establecer de forma explícita los valores de tiempo de espera.

Ejemplo

En el siguiente ejemplo muestra cómo especificar el modo de reintento Estándar, un máximo de 3 reintentos, un tiempo de espera de 10 segundos y un tiempo de espera de lectura/escritura de 10 segundos (si procede). Al constructor AmazonS3Client se le asigna un objeto AmazonS3Config.

var s3Client = new AmazonS3Client(
  new AmazonS3Config
  {
    Timeout = TimeSpan.FromSeconds(10),
    // NOTE: The following property is obsolete for
    //       versions of the AWS SDK for .NET that target .NET Core.
    ReadWriteTimeout = TimeSpan.FromSeconds(10),
    RetryMode = RequestRetryMode.Standard,
    MaxErrorRetry = 3
  });