Codes de retour de ligne de commande dans l’AWS CLI - AWS Command Line Interface

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

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.

Codes de retour de ligne de commande dans l’AWS CLI

Le code de retour est généralement un code caché envoyé après l’exécution d’une commande AWS Command Line Interface (AWS CLI) qui décrit l’état de la commande. Vous pouvez utiliser la commande echo pour afficher le code envoyé depuis la dernière commande AWS CLI et utiliser ces codes pour déterminer si une commande a réussi ou si elle a échoué, et pourquoi une commande peut contenir une erreur. Outre les codes de retour, vous pouvez consulter plus de détails sur une panne en exécutant vos commandes avec le commutateur --debug. Cela génère un rapport détaillé indiquant les étapes que l’AWS CLI utilise pour traiter la commande et le résultat de chaque étape.

Pour déterminer le code de retour d’une commande AWS CLI, exécutez l’une des commandes suivantes immédiatement après l’exécution de la commande CLI.

Linux and macOS
$ echo $?
0
Windows PowerShell
PS> echo $lastexitcode
0
Windows Command Prompt
C:\> echo %errorlevel%
0

Voici les valeurs des codes de retour qui peuvent être renvoyés à la fin de l’exécution d’une commande AWS Command Line Interface (AWS CLI).

Code Signification
0

Le service a répondu avec un code d’état de réponse HTTP 200, ce qui indique qu’aucune erreur n’avait été générée par l’AWS CLI et le service AWS auquel la demande avait été envoyée.
1

Une ou plusieurs opérations de transfert S3 ont échoué. Limité aux commandes S3.
2

La signification de ce code de retour dépend de la commande.

  • Applicable à toutes les commandes de l’AWS CLI – la commande entrée n’a pas pu être analysée. Les erreurs d’analyse peuvent être dus, notamment, à des sous-commandes ou des arguments obligatoires manquants ou à l’utilisation de commandes ou d’arguments inconnus.

  • Limité aux commandes S3 – Un ou plusieurs fichiers marqués pour transfert ont été ignorés pendant le processus de transfert. En revanche, tous les autres fichiers marqués pour transfert ont été correctement transférés. Les fichiers qui sont ignorés au cours du processus de transfert sont les suivants : fichiers inexistants, fichiers spéciaux de périphérique en mode caractère et en mode bloc, files d’attente FIFO ou sockets et fichiers pour lesquels l’utilisateur ne dispose pas d’autorisations de lecture.
130

La commande a été interrompue par un SIGINT. Il s’agit du signal que vous envoyez pour annuler une commande avec Ctrl+C.
255

La commande a échoué. Des erreurs ont été générées par l’AWS CLI ou par le service AWS auquel la requête a été envoyée.