La version 4 (V4) du AWS SDK pour .NET est sortie !

Pour plus d'informations sur l'interruption des modifications et la migration de vos applications, consultez la rubrique sur la migration.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Réessais et délais d'attente

AWS SDK pour .NET Cela vous permet de configurer le nombre de nouvelles tentatives et les valeurs de délai d'attente pour les requêtes HTTP adressées aux AWS services. Si les valeurs par défaut concernant les nouvelles tentatives et les délais d'expiration ne conviennent pas à votre application, vous pouvez les ajuster selon vos besoins spécifiques, mais il est important de comprendre en quoi le comportement de votre application en sera affecté.

Pour déterminer quelles valeurs utiliser pour les nouvelles tentatives et les délais d'expiration, prenez en compte les éléments suivants :

Les paramètres de nouvelle tentative et de délai d'expiration ont une incidence sur les performances perçues de votre application. Pour les recommandations associées, voirBonnes pratiques en matière de performances.

Nouvelles tentatives

Vue d’ensemble

Ils AWS SDK pour .NET peuvent réessayer les demandes qui échouent en raison d'une limitation côté serveur ou de connexions interrompues. Il existe deux propriétés des classes de configuration de service que vous pouvez utiliser pour spécifier le comportement de nouvelle tentative d'un client de service. Les classes de configuration de service héritent des propriétés suivantes de la Amazon.Runtime.ClientConfig classe abstraite de l'AWS SDK pour .NET API Reference :

Les descriptions détaillées de ces propriétés sont disponibles dans la Amazon.Runtime.ClientConfig classe abstraite de l'AWS SDK pour .NET API Reference. Chaque valeur de RetryMode correspond par défaut à une valeur particulière deMaxErrorRetry, comme indiqué dans le tableau suivant.

Comportement

Quand votre candidature démarre

Lorsque votre application démarre, les valeurs par défaut MaxErrorRetry sont configurées par le SDK. RetryMode Ces valeurs par défaut sont utilisées lorsque vous créez un client de service, sauf si vous spécifiez d'autres valeurs.

Pendant l'exécution de votre application

Lorsque vous créez un client de service, vous pouvez utiliser les valeurs par défaut pour RetryMode etMaxErrorRetry, comme décrit précédemment, ou vous pouvez spécifier d'autres valeurs. Pour spécifier d'autres valeurs, créez et incluez un objet de configuration de service tel que AmazonDynamoDBConfig AmazonSQSConfig lorsque vous créez le client de service.

Ces valeurs ne peuvent pas être modifiées pour un client de service après sa création.

Considérations

Lorsqu'une nouvelle tentative se produit, la latence de votre demande augmente. Vous devez configurer les nouvelles tentatives en fonction des limites de votre application en termes de latence totale des demandes et de taux d'erreur.

Délais

AWS SDK pour .NET Cela vous permet de configurer les délais d'expiration des demandes au niveau du client de service et par appel de méthode. Il existe deux mécanismes pour configurer les délais d'attente, qui sont abordés dans les sections suivantes :

Utilisation du CancellationToken paramètre pour les délais

AWS SDK pour .NET Cela vous permet de configurer les délais d'expiration des demandes pour les appels asynchrones à l'aide du paramètre. CancellationToken L'extrait de code suivant montre un exemple. Le code est lancé System.Threading.Tasks.TaskCanceledException si la demande n'est pas terminée dans les 10 secondes.

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);
}

Utilisation du délai d'attente et des ReadWriteTimeout propriétés pour les délais

AWS SDK pour .NET Cela vous permet de configurer les valeurs du délai d'expiration de la demande et du read/write délai d'expiration du socket au niveau du client de service. Ces valeurs sont spécifiées dans les ReadWriteTimeout propriétés Timeout et de la Amazon.Runtime.ClientConfig classe abstraite. Ces valeurs sont transmises en tant que ReadWriteTimeout propriétés Timeout et des HttpWebRequest objets créés par l'objet client du AWS service. La valeur par défaut de Timeout est de 100 secondes et celle de ReadWriteTimeout est de 300 secondes.

Lorsque votre réseau présente une latence élevée ou qu'une opération fait l'objet d'une nouvelle tentative du fait de certaines conditions, un long délai d'expiration et un nombre élevé de nouvelles tentatives peuvent donner l'impression que certaines opérations du kit SDK ne répondent pas.

Vous trouverez ci-dessous les exceptions aux valeurs de délai d'expiration par défaut. Ces valeurs sont remplacées lorsque vous définissez explicitement les valeurs de délai d'expiration.

L'exemple suivant vous montre comment spécifier le mode de nouvelle tentative standard, un maximum de 3 tentatives, un délai d'attente de 10 secondes et un read/write délai d'attente de 10 secondes (le cas échéant). Le constructeur AmazonS3Client reçoit un objet AmazonS3Config. https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/S3/TS3Config.html

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