了解 AWS CLI 中的返回代码 - AWS Command Line Interface
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

了解 AWS CLI 中的返回代码

返回代码通常是运行 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 命令行界面 (AWS CLI) 命令运行结束时可能返回以下返回代码值。

代码 意义
0

命令成功完成。AWS CLI 以及请求发送到的 AWS 服务没有生成任何错误。

1

一个或多个 Amazon S3 传输操作失败。仅限 S3 命令。

2

该返回代码的含义取决于命令:

  • 适用于所有 CLI 命令 – 无法解析输入的命令。解析失败的原因可能是(但不限于)缺少必需的子命令或参数,或使用了未知的命令或参数。

  • 限制为 S3 命令 – 在传输过程中,跳过了标记为要进行传输的一个或多个文件。但是,标记为要进行传输的所有其他文件都已成功传输。传输过程中跳过的文件包括:不存在的文件,作为字符特殊设备、块特殊设备、FIFO 队列或套接字的文件,以及用户没有读取权限的文件。

130

命令已被 SIGINT 中断。这是您通过 Ctrl+C 发送的信号,用于取消某个命令。

252

命令语法无效,提供了未知参数,或者参数值不正确并且阻止了命令运行。

253

系统环境或配置无效。尽管提供的命令在语法上可能是有效的,但缺少配置或凭证,导致该命令无法运行。

254

该命令已成功解析,并且已对指定服务发出了请求,但该服务返回了错误。这通常表示 API 使用不正确或出现其他特定于服务的问题。

255

命令失败。AWS CLI 或将请求发送到的 AWS 服务生成了错误。