

# 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`\+`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. | 