Utilisation de codes de retour

Un code de retour est généralement, mais pas toujours, un code caché envoyé après l'exécution d'une commande CLI Amazon DCV Session Manager décrivant son statut.

Pour consulter ces codes de retour, vous pouvez utiliser la echo commande. Cela affiche le code envoyé par la dernière commande CLI du gestionnaire de session. YOu peut utiliser ces codes pour déterminer si une commande a réussi ou non et pourquoi une commande peut contenir une erreur.

Outre les codes de retour, vous pouvez afficher plus de détails sur un échec en exécutant vos commandes avec--debug. Cela produit un rapport détaillé des étapes utilisées par la CLI du gestionnaire de session pour traiter la commande et le résultat de chaque étape.

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

• Linux et macOS

  $  echo $?
  0

• Fenêtres PowerShell

  $  echo $lastexitcode
  0

• Invite de commande Windows

  $  echo %errorlevel%
  0

Les codes de retour suivants apparaissent à la fin de l'exécution d'une commande CLI :

• 0La commande a été exécutée avec succès. Aucune erreur n'a été générée ni par la CLI ni par le service auquel la demande a été adressée.

• 1Le fichier de configuration analysé par la CLI est introuvable ou est peut-être endommagé.

• 2La commande saisie sur la ligne de commande n'a pas pu être analysée. Les échecs d'analyse peuvent être dus, sans toutefois s'y limiter, à l'absence de sous-commandes ou d'arguments requis ou à l'utilisation de commandes ou d'arguments inconnus. Notez que cette signification du code de retour s'applique à toutes les commandes CLI.

• 130Le processus a reçu un SIGINT (Ctrl-C).

• 252La 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.

• 253L'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.

• 254La 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.

• 255Erreur fourre-tout générale. La commande a peut-être été analysée correctement, mais une erreur d'exécution non spécifiée s'est produite lors de l'exécution de la commande. Comme il s'agit d'un code d'erreur général, une erreur peut passer de 255 à un code de retour plus spécifique. Un code de retour de 255 ne doit pas être utilisé pour déterminer un cas d'erreur spécifique.