Codes de retour de ligne de commande dans le 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 echo commande pour afficher le code envoyé depuis la dernière AWS CLI commande 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 --debug commutateur. Ce commutateur produit un rapport détaillé des étapes AWS CLI utilisées pour traiter la commande et du résultat de chaque étape.

Pour déterminer le code de retour d'une AWS CLI commande, exécutez l'une des commandes suivantes immédiatement après l'avoir CLI exécutée.

Linux and macOS

$ echo $?
0

Windows PowerShell

PS> echo $lastexitcode
0

Windows Command Prompt

C:\> echo %errorlevel%
0

Les valeurs de code de retour qui peuvent être renvoyées à la fin de l'exécution d'une commande AWS Command Line Interface (AWS CLI) sont les suivantes.

Code	Signification
0	Le service a répondu avec un code d'état de HTTP réponse de 200 indiquant qu'aucune erreur n'avait été générée par le AWS service AWS CLI et auquel la demande avait été envoyée.
1	Une ou plusieurs opérations de transfert Amazon S3 ont échoué. Limité aux commandes S3.
2	La signification de ce code de retour dépend de la commande. Applicable à toutes les AWS CLI commandes : la commande saisie 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 le 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 ignorés pendant le processus de transfert incluent les fichiers qui n'existent pas, les fichiers contenant des caractères spéciaux, bloquant des périphériques spéciaux, des FIFO files d'attente ou des sockets, et les fichiers pour lesquels l'utilisateur n'a pas d'autorisation de lecture.
130	La commande a été interrompue par unSIGINT. Il s'agit du signal que vous envoyez pour annuler une commande avec le signe 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 API utilisation incorrecte ou d'autres problèmes spécifiques au service.
255	La commande a échoué. Des erreurs ont été générées par le AWS CLI ou par le AWS service auquel la demande a été envoyée.