Códigos de retorno da linha de comando na AWS CLI - AWS Command Line Interface

Códigos de retorno da linha de comando na AWS CLI

O código de retorno geralmente é um código oculto enviado após a execução de um comando da AWS Command Line Interface(AWS CLI) que descreve o status do comando. Você pode usar o comando echo para exibir o código enviado do último comando AWS CLI e usar esses códigos para determinar se um comando foi bem-sucedido ou se falhou, e por que um comando pode ter apresentado um erro. Além dos códigos de retorno, você pode visualizar mais detalhes sobre uma falha executando seus comandos com o a opção --debug. Essa opção produz um relatório detalhado das etapas que a AWS CLI usa para processar o comando, e o resultado que foi gerado por cada etapa.

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

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

Veja a seguir os valores de código de retorno que podem ser retornados ao final da execução de um comando de AWS Command Line Interface (AWS CLI).

Código Significado
0

O serviço respondeu com um código de status de resposta HTTP de 200, o que indica que não houve erros gerados pela AWS CLI e pelo serviço da AWS para o qual a solicitação foi enviada.
1

Uma ou mais operações de transferência do Amazon S3 falhou. Limitado a comandos do S3.
2

O significado desse código de retorno depende do comando.

  • Aplicável a todos os comandos da AWS CLI : não foi possível analisar o comando inserido. 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.

  • Limitado a comandos do S3: um ou mais arquivos marcados para transferência foram ignorados durante o processo de transferência. No entanto, todos os outros arquivos marcados para transferência foram transferidos com êxito. Os arquivos que são ignorados durante o processo de transferência incluem: arquivos inexistentes, arquivos que são dispositivos de caracteres especiais, dispositivo de bloqueio especial, filas FIFO ou soquetes, além de arquivos para os quais o usuário não tem permissões de leitura.
130

O comando foi interrompido por um SIGINT. Este é o sinal enviado por você para cancelar um comando com 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 estar sintaticamente válido, uma configuração ou credenciais ausentes 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

Ocorreu uma falha no comando. Houve erros gerados pela AWS CLI ou pelo serviço da AWS para o qual a solicitação foi enviada.