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étentatives et délais

Vous AWS SDK for .NET permet de configurer le nombre de tentatives et les valeurs de délai d'expiration 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 :

Nouvelle tentative

Présentation

Ils AWS SDK for .NET peuvent réessayer les demandes qui échouent en raison d'un ralentissement côté serveur ou d'une interruption de connexion. Il existe deux propriétés des classes de configuration de service que vous pouvez utiliser pour spécifier le comportement d'un client de service en cas de nouvelle tentative. Les classes de configuration de service héritent de ces propriétés de l'abstrait Amazon.Runtime. ClientConfigclasse de l'AWS SDK for .NETAPI Reference :

Les descriptions détaillées de ces propriétés se trouvent dans le résumé Amazon.Runtime. ClientConfigclasse de l'AWS SDK for .NETAPI Reference. Chaque valeur de RetryMode correspond par défaut à une valeur particulière deMaxErrorRetry, comme indiqué dans le tableau suivant.

Attitude

Quand votre candidature démarre

Lorsque votre application démarre, les valeurs par défaut pour RetryMode et MaxErrorRetry sont configurées par le SDK. 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 ou AmazonSQSConfig lorsque vous créez le client de service.

Ces valeurs ne peuvent pas être modifiées pour un client de service une fois celui-ci créé.

Considérations

Lorsqu'une nouvelle tentative a lieu, 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

Vous AWS SDK for .NET permet de configurer le délai d'expiration de la demande et les valeurs du délai de lecture/écriture du socket au niveau du client de service. Ces valeurs sont spécifiées dans Timeout et dans les ReadWriteTimeout propriétés du résumé Amazon.Runtime. ClientConfigclasse. Ces valeurs sont transmises sous forme de ReadWriteTimeout propriétés Timeout et des HttpWebRequestobjets 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.

Exemple

L'exemple suivant vous montre comment spécifier le mode de nouvelle tentative standard, un maximum de 3 tentatives, un délai d'expiration de 10 secondes et un délai de lecture/écriture de 10 secondes (le cas échéant). Le constructeur AmazonS3Client reçoit un objet 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
  });