# AWS CLI의 명령줄 반환 코드
<a name="cli-usage-returncodes"></a>

반환 코드는 대개 명령의 상태를 설명하는 AWS Command Line Interface(AWS CLI) 명령을 실행한 후 전송되는 숨겨진 코드입니다. `echo` 명령을 사용하여 마지막 AWS CLI 명령에서 보낸 코드를 표시하고, 이러한 코드를 사용하여 명령이 성공했는지 또는 실패했는지, 명령에 오류가 있는 이유를 확인할 수 있습니다. 반환 코드 외에도 `--debug` 스위치로 명령을 실행하여 실패에 대한 자세한 정보를 볼 수 있습니다. 이렇게 하면 AWS CLI가 명령을 처리하기 위해 사용하는 단계와 각 단계의 결과가 포함된 세부 보고서가 생성됩니다.

AWS CLI 명령의 반환 코드를 확인하려면 CLI 명령을 실행한 즉시 다음 명령 중 하나를 실행합니다.

------
#### [ Linux and macOS ]

```
$ echo $?
0
```

------
#### [ Windows PowerShell ]

```
PS> echo $lastexitcode
0
```

------
#### [ Windows Command Prompt ]

```
C:\> echo %errorlevel%
0
```

------

다음은 AWS Command Line Interface (AWS CLI) 명령의 실행이 끝났을 때 반환될 수 있는 반환 코드 값입니다.


| 코드 | 의미 | 
| --- | --- | 
| 0 |  서비스가 HTTP 응답 상태 코드 200으로 응답했습니다. 이는 요청이 전송된 AWS CLI 및 AWS 서비스에서 발생한 오류가 없음을 나타냅니다.  | 
| 1 |  하나 이상의 Amazon S3 전송 작업이 실패했습니다. *S3 명령으로 제한됩니다.*  | 
| 2 |  이 반환 코드의 의미는 명령에 따라 달라집니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cli/latest/userguide/cli-usage-returncodes.html)  | 
| 130 |  SIGINT에 의해 명령이 중단되었습니다. 이것은 `Ctrl`\$1`C`로 명령을 취소하기 위해 사용자가 보낸 신호입니다.  | 
| 252 |  명령 구문이 잘못되었거나 알 수 없는 파라미터가 제공되었거나 파라미터 값이 잘못되어 명령이 실행되지 않습니다.  | 
| 253 |  시스템 환경 또는 구성이 잘못되었습니다. 제공된 명령이 구문적으로 유효할 수 있지만 구성 또는 보안 인증 정보가 누락되어 명령이 실행되지 않습니다.  | 
| 254 |  명령이 구문 분석되었고 지정된 서비스에 대한 요청이 생성되었지만 서비스에서 오류를 반환했습니다. 이는 일반적으로 잘못된 API 사용이나 기타 서비스 관련 문제를 나타냅니다.  | 
| 255 |  명령이 실패했습니다. 요청이 전송된 AWS CLI 또는 AWS 서비스에서 오류가 생성되었습니다.  |