¡Se AWS SDK para .NET ha publicado la versión 4 (V4) del!

Para empezar a usar la nueva versión del SDK, consulte la Guía para desarrolladores de AWS SDK para .NET (versión 4), especialmente el tema Migración a la versión 4.

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

Descripción general

AWS SDK para .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 de la clase abstracta Amazon.Runtime.ClientConfig de la Referencia de API de AWS SDK para .NET:

Encontrará descripciones detalladas de estas propiedades en la clase abstracta Amazon.Runtime.ClientConfig de la Referencia de API de AWS SDK para .NET. 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 para .NET le permite configurar los tiempos de espera de las solicitudes en el nivel del cliente del servicio y por llamada a cada método. Existen dos mecanismos para configurar los tiempos de espera, que se describen en las secciones siguientes:

Uso del parámetro CancellationToken para los tiempos de espera

AWS SDK para .NET permite configurar los tiempos de espera de las solicitudes en llamadas asíncronas mediante el parámetro CancellationToken. El siguiente fragmento de código muestra un ejemplo. El código genera una excepción System.Threading.Tasks.TaskCanceledException si la solicitud no se completa en 10 segundos.

string bucketName = "amzn-s3-demo-bucket";
string path = "pathToBucket";
using (var amazonS3Client = new AmazonS3Client(new AmazonS3Config()))
{
    // Cancel request after 10 seconds
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource(TimeSpan.FromMilliseconds(10000));
    CancellationToken cancellationToken = cancellationTokenSource.Token;
    ListObjectsV2Request listRequestV2 = new()
    {
        BucketName = bucketName,
        Prefix = path,
    };

    ListObjectsV2Response listResponseV2 = await amazonS3Client.ListObjectsV2Async(listRequestV2, cancellationToken);
}

Uso de las propiedades Timeout y ReadWriteTimeout para los tiempos de espera

AWS SDK para .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 propiedades Timeout y ReadWriteTimeout de la clase abstracta Amazon.Runtime.ClientConfig. Estos valores se pasan como las propiedades Timeout y ReadWriteTimeout de los objetos HttpWebRequestcreados por el objeto de cliente de servicio de AWS. 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.

En el siguiente ejemplo se 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 para .NET that target .NET Core.
    ReadWriteTimeout = TimeSpan.FromSeconds(10),
    RetryMode = RequestRetryMode.Standard,
    MaxErrorRetry = 3
  });