AWS CLIréessaie

Cette rubrique décrit comment les appels aux AWS services AWS CLI peuvent échouer en raison de problèmes inattendus. Ces problèmes peuvent survenir côté serveur ou échouer en raison de la limitation du débit du AWS service que vous essayez d'appeler. Ces types de défaillances ne nécessitent généralement pas de traitement spécial et l'appel est automatiquement refait, souvent après une brève période d'attente. AWS CLIIl fournit de nombreuses fonctionnalités pour aider les clients à réessayer d'appeler les AWS services en cas d'erreurs ou d'exceptions de ce type.

Modes de nouvelle tentative disponibles

Vous AWS CLI avez le choix entre plusieurs modes en fonction de votre version :

• Mode de nouvelle tentative classique
• Mode de nouvelle tentative standard
• Mode de nouvelle tentative adaptatif

Mode de nouvelle tentative classique

Le mode Legacy utilise un ancien gestionnaire de tentatives dont les fonctionnalités sont limitées, notamment :

• La valeur par défaut est de 4 pour le nombre maximum de tentatives, soit un total de 5 tentatives d'appel. Cette valeur peut être remplacée via le paramètre de max_attempts configuration.

• DynamoDB a une valeur par défaut de 9 pour le nombre maximum de tentatives, soit un total de 10 tentatives d'appel. Cette valeur peut être remplacée via le paramètre de max_attempts configuration.

• Réessayez pour le nombre limité d'erreurs/exceptions suivant :

  • Erreurs générales de socket ou de connexion :

    • ConnectionError

    • ConnectionClosedError

    • ReadTimeoutError

    • EndpointConnectionError

  • Erreurs et exceptions liées à la régulation ou aux limites côté service :

    • Throttling

    • ThrottlingException

    • ThrottledException

    • RequestThrottledException

    • ProvisionedThroughputExceededException

• Réessayez d'utiliser plusieurs codes d'état HTTP, notamment 429, 500, 502, 503, 504 et 509.

• Toute nouvelle tentative comportera un recul exponentiel d'un facteur de base de 2.

Mode de nouvelle tentative standard

Le mode standard est un ensemble standard de règles de nouvelle tentative dans les AWS SDK, offrant davantage de fonctionnalités que les anciens. Ce mode est le mode par défaut pour AWS CLI la version 2. Le mode standard a été créé pour la AWS CLI version 2 et est rétroporté vers la AWS CLI version 1. Les fonctionnalités du mode standard incluent :

• Une valeur par défaut de 2 pour le nombre maximum de tentatives, soit un total de 3 tentatives d'appel. Cette valeur peut être remplacée via le paramètre de max_attempts configuration.

• Réessayez pour la liste étendue d'erreurs/exceptions suivante :

  • Erreurs/exceptions transitoires

    • RequestTimeout

    • RequestTimeoutException

    • PriorRequestNotComplete

    • ConnectionError

    • HTTPClientError

  • Erreurs et exceptions liées à la régulation ou aux limites côté service :

    • Throttling

    • ThrottlingException

    • ThrottledException

    • RequestThrottledException

    • TooManyRequestsException

    • ProvisionedThroughputExceededException

    • TransactionInProgressException

    • RequestLimitExceeded

    • BandwidthLimitExceeded

    • LimitExceededException

    • RequestThrottled

    • SlowDown

    • EC2ThrottledException

• Réessayez de corriger les codes d'erreur transitoires et non descriptifs. Plus précisément, ces codes d'état HTTP : 500, 502, 503, 504.

• Toute nouvelle tentative inclura un recul exponentiel d'un facteur de base de 2 pour une durée maximale de 20 secondes.

Mode de nouvelle tentative adaptatif

Avertissement

Le mode adaptatif est un mode expérimental susceptible de changer, tant au niveau des fonctionnalités que du comportement.

Le mode de tentative adaptatif est un mode de nouvelle tentative expérimental qui inclut toutes les fonctionnalités du mode standard. Outre les fonctionnalités du mode standard, le mode adaptatif introduit également une limitation du débit côté client grâce à l'utilisation d'un bucket de jetons et de variables de limite de débit qui sont mises à jour dynamiquement à chaque nouvelle tentative. Ce mode offre une flexibilité lors des tentatives côté client qui s'adapte à la réponse d'état d'erreur/d'exception d'un service. AWS

À chaque nouvelle tentative, le mode adaptatif modifie les variables de limite de débit en fonction de l'erreur, de l'exception ou du code d'état HTTP présenté dans la réponse du service. AWS Ces variables de limite de débit sont ensuite utilisées pour calculer un nouveau débit d'appels pour le client. Chaque exception/erreur ou réponse HTTP infructueuse (fournie dans la liste ci-dessus) d'un AWS service met à jour les variables de limite de débit au fur et à mesure des nouvelles tentatives jusqu'à ce que le succès soit atteint, que le bucket de jetons soit épuisé ou que la valeur maximale de tentatives configurée soit atteinte.

Configuration d'un mode de nouvelle tentative

AWS CLICela inclut une variété de configurations de nouvelle tentative ainsi que des méthodes de configuration à prendre en compte lors de la création de votre objet client.

Méthodes de configuration disponibles

Dans leAWS CLI, les utilisateurs peuvent configurer les nouvelles tentatives de la manière suivante :

• Variables d’environnement

• AWS CLIfichier de configuration

Les utilisateurs peuvent personnaliser les options de nouvelle tentative suivantes :

• Mode de nouvelle tentative - Spécifie le mode de nouvelle tentative utilisé. AWS CLI Comme décrit précédemment, trois modes de nouvelle tentative sont disponibles : ancien, standard et adaptatif. La valeur par défaut pour la version 2 est standard.

• Nombre maximal de tentatives - Spécifie la valeur maximale de tentatives utilisées par le gestionnaire de AWS CLI nouvelles tentatives, l'appel initial étant pris en compte dans la valeur que vous fournissez. La valeur par défaut est 5.

Définition d'une configuration de nouvelle tentative dans vos variables d'environnement

Pour définir votre configuration de nouvelle tentative pour leAWS CLI, mettez à jour les variables d'environnement de votre système d'exploitation.

Les variables d'environnement de nouvelle tentative sont les suivantes :

• AWS_RETRY_MODE

• AWS_MAX_ATTEMPTS

Pour plus d'informations sur les variables d'environnement, consultezVariables d'environnement pour configurer le AWS CLI.

Définition d'une configuration de nouvelle tentative dans votre fichier AWS de configuration

Pour modifier votre configuration de nouvelle tentative, mettez à jour votre fichier AWS de configuration global. L'emplacement par défaut de votre fichier de configuration est AWS ~/.aws/config.

Voici un exemple de fichier de AWS configuration :

[default]
retry_mode = standard
max_attempts = 6

Pour plus d'informations sur les fichiers de configuration, consultezParamètres des fichiers de configuration et d'informations d'identification.

Afficher les journaux des tentatives de nouvelle tentative

Il AWS CLI utilise la méthodologie de réessai et la journalisation de Boto3. Vous pouvez utiliser --debug cette option sur n'importe quelle commande pour recevoir les journaux de débogage. Pour plus d'informations sur l'utilisation de --debug cette option, consultezOptions de ligne de commande.

Si vous recherchez « réessayer » dans vos journaux de débogage, vous trouverez les informations dont vous avez besoin pour réessayer. Les entrées du journal client pour les nouvelles tentatives dépendent du mode de nouvelle tentative que vous avez activé.

Mode Héritage :

Les messages de nouvelle tentative sont générés par botocore.retryhandler. L'un des trois messages suivants s'affichera :

• No retry needed

• Retry needed, action of: <action_name>

• Reached the maximum number of retry attempts: <attempt_number>

Mode standard ou adaptatif :

Les messages de nouvelle tentative sont générés par botocore.retries.standard. L'un des trois messages suivants s'affichera :

• No retrying request

• Retry needed, retrying request after delay of: <delay_value>

• Retry needed but retry quota reached, not retrying request

Pour le fichier de définition complète des tentatives de botocore, consultez _retry.json dans le référentiel botocore. GitHub