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

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 dues, 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.
252

La syntaxe de la commande n’était pas valide, un paramètre inconnu a été fourni ou une valeur de paramètre incorrecte a empêché l’exécution de la commande.
253

L’environnement ou la configuration du système n’était pas valide. Bien que la commande fournie soit syntaxiquement valide, l’absence de configuration ou d’informations d’identification a empêché l’exécution de la commande.
254

La commande a été correctement analysée et une demande a été envoyée au service spécifié, mais le service a renvoyé une erreur. Cela indique généralement une utilisation incorrecte de l’API ou d’autres problèmes spécifiques au service.
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.