Uso de códigos de retorno

Um código de retorno geralmente é, mas nem sempre, um código oculto enviado após a execução de um comando CLI do Gerenciador de Sessões do Amazon DCV descrevendo seu status.

Para visualizar esses códigos de retorno, você pode usar o comando echo. Isso exibe o código enviado do último comando da CLI do Gerenciador de Sessões. YOu pode usar esses códigos para determinar se um comando foi bem-sucedido ou não e por que um comando pode ter um erro.

Além dos códigos de retorno, você pode visualizar mais detalhes sobre uma falha executando seus comandos com --debug. Isso produz um relatório detalhado das etapas que a CLI do Gerenciador de Sessões usa para processar o comando e o resultado de cada etapa.

Para determinar o código de retorno de um comando da CLI do DCV SM, execute um dos seguintes comandos imediatamente após a execução do comando da CLI.

• Linux e macOS

  $  echo $?
  0

• Janelas PowerShell

  $  echo $lastexitcode
  0

• Prompt de comando do Windows

  $  echo %errorlevel%
  0

Os seguintes códigos de retorno aparecem no final da execução de um comando da CLI:

• 0 O comando foi bem-sucedido. Não houve erros gerados pela CLI nem pelo serviço para o qual a solicitação foi enviada.

• 1 O arquivo de configuração analisado na CLI não foi encontrado ou pode estar corrompido.

• 2 Falha ao analisar o comando inserido na linha de comando. Falhas de análise podem ser causadas, entre outros motivos, pela ausência de subcomandos ou argumentos necessários ou pelo uso de comandos ou argumentos desconhecidos. Observe que esse significado do código de retorno é aplicável a todos os comandos da CLI.

• 130 O processo recebeu um SIGINT (Ctrl-C).

• 252 A sintaxe do comando era inválida, um parâmetro desconhecido foi fornecido ou um valor de parâmetro estava incorreto e impediu a execução do comando.

• 253 O ambiente ou configuração do sistema era inválido. Embora o comando fornecido possa ser sintaticamente válido, uma configuração ausente ou as credenciais impediram a execução do comando.

• 254 O comando foi analisado com êxito e uma solicitação foi feita para o serviço especificado, mas o serviço retornou um erro. Isso geralmente indica o uso incorreto da API ou outros problemas específicos do serviço.

• 255 Erro geral de captura. O comando pode ter sido analisado corretamente, mas ocorreu um erro de runtime não especificado ao executar o comando. Como esse é um código de erro geral, um erro pode mudar de 255 para um código de retorno mais específico. Não se deve confiar em um código de retorno 255 para determinar um caso de erro específico.