

# Códigos de retorno da linha de comando na AWS CLI
<a name="cli-usage-returncodes"></a>

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.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/cli/latest/userguide/cli-usage-returncodes.html)  | 
| 130 |  O comando foi interrompido por um SIGINT. Este é o sinal enviado por você para cancelar um comando com `Ctrl`\$1`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.  | 