A versão 4 (V4) do AWS SDK para .NET foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do desenvolvedor AWS SDK para .NET (V4), especialmente o tópico sobre migração para a versão 4.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Novas tentativas e tempos limite

O AWS SDK para .NET permite que você configure os valores do número de tentativas e do tempo limite para solicitações HTTP de serviços da AWS. Se os valores padrão para novas tentativas e tempos limite não forem apropriados, ajuste-os conforme os seus requisitos específicos, mas é importante entender como essa ação afetará o comportamento do aplicativo.

Para determinar quais valores usar para tentativas e tempos limite, considere o seguinte:

Novas tentativas

Visão geral

O AWS SDK para .NET pode realizar novas tentativas para as solicitações que falharem devido ao controle de utilização no lado do servidor ou conexões perdidas. Há duas propriedades das classes de configuração de serviço que você pode usar para especificar o comportamento de novas tentativas de um cliente de serviço. As classes de configuração de serviço herdam essas propriedades da classe abstrata Amazon.Runtime.ClientConfig da Referência de API do AWS SDK para .NET:

As descrições detalhadas dessas propriedades podem ser encontradas na classe Amazon.Runtime.ClientConfig abstrata da Referência de API do AWS SDK para .NET. Cada valor de RetryMode corresponde, por padrão, a um valor específico de MaxErrorRetry, conforme mostrado na tabela a seguir.

Comportamento

Quando seu aplicativo é iniciado

Quando seu aplicativo é iniciado, os valores padrão para RetryMode e MaxErrorRetry são configurados pelo SDK. Esses valores padrão são usados quando você cria um cliente de serviço, a menos que você especifique outros valores.

À medida que seu aplicativo é executado

Ao criar um cliente de serviço, você pode usar os valores padrão para RetryMode e MaxErrorRetry, conforme descrito anteriormente, ou pode especificar outros valores. Para especificar outros valores, crie e inclua um objeto de configuração do serviço, como AmazonDynamoDBConfig ou AmazonSQSConfig quando criar o cliente do serviço.

Não é possível alterar os valores de um cliente de serviço depois que ele tiver sido criado.

Considerações

Quando ocorre uma nova tentativa, a latência da solicitação é aumentada. Configure as tentativas com base nos limites de latência total da solicitação e taxas de erros do aplicativo.

Tempo limite

O AWS SDK para .NET possibilita que você configure os tempos limite de solicitação em nível de cliente de serviço e por chamada de método. Há dois mecanismos para configurar tempos limite, que serão abordados nas seções subsequentes:

Usar o parâmetro CancellationToken para tempos limite

O AWS SDK para .NET permite que você configure os tempos limite de solicitação em chamadas assíncronas usando o parâmetro CancellationToken. O trecho de código a seguir mostra um exemplo. O código lançará System.Threading.Tasks.TaskCanceledException se a solicitação não for concluída em 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);
}

Usar as propriedades Timeout e ReadWriteTimeoutpara tempos limite

O AWS SDK para .NET permite que você configure os valores do tempo limite da solicitação e o tempo limite de leitura/gravação do soquete no nível do cliente do serviço. Esses valores são especificados nas propriedades Timeout e ReadWriteTimeout da classe abstrata Amazon.Runtime.ClientConfig. Esses valores são transmitidos como as propriedades Timeout e ReadWriteTimeout dos objetos HttpWebRequest criados pelo objeto do cliente do serviço da AWS. Por padrão, o valor Timeout é 100 segundos e o valor ReadWriteTimeout é 300 segundos.

Quando a sua rede estiver com latência alta, ou existirem condições que gerem uma nova tentativa para uma operação, utilizar valores de tempo limite longos e um alto número de tentativas pode fazer com que algumas operações do SDK pareçam indiferentes.

Veja a seguir as exceções aos valores de tempo limite padrão. Estes valores são substituídos ao definir explicitamente os valores de tempo limite.

O exemplo a seguir mostra como especificar o modo de novas tentativas padrão, um máximo de três tentativas, um tempo limite de 10 segundos e um tempo limite de leitura/gravação de 10 segundos (se aplicável). O construtor AmazonS3Client recebe um 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
  });