# 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/zh_cn/cli/latest/userguide/cli-usage-returncodes.html)  | 
| 130 |  命令已被 SIGINT 中断。这是您通过 `Ctrl`\$1`C` 发送的信号，用于取消某个命令。  | 
| 252 |  命令语法无效，提供了未知参数，或者参数值不正确并且阻止了命令运行。  | 
| 253 |  系统环境或配置无效。尽管提供的命令在语法上可能是有效的，但缺少配置或凭证，导致该命令无法运行。  | 
| 254 |  该命令已成功解析，并已对指定服务发出了请求，但该服务返回了错误。这通常表示 API 使用不正确或出现其他特定于服务的问题。  | 
| 255 |  命令失败。AWS CLI 或将请求发送到的 AWS 服务生成了错误。  |