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

了解 Amazon CLI 中的返回代码

返回代码通常是运行 Amazon Command Line Interface (Amazon CLI) 命令后发送的隐藏代码,该命令可描述命令的状态。您可以使用 echo 命令显示从上一个 Amazon CLI 命令发送的代码,并使用这些代码确定命令是成功还是失败,以及命令可能出错的原因。除了返回代码之外,您还可以运行带有 --debug 开关的命令,查看有关故障的更多详细信息。此开关将生成一个详细报告,描述 Amazon CLI 用于处理命令的步骤以及每个步骤的结果。

要确定 Amazon CLI 命令的返回代码,请在运行 CLI 命令后立即运行以下命令之一。

Linux and macOS
$ echo $? 0
Windows PowerShell
PS> echo $lastexitcode 0
Windows Command Prompt
C:\> echo %errorlevel% 0

以下是运行 Amazon Command Line Interface (Amazon CLI) 命令结束时可能返回的返回代码值。

代码 意义
0

该服务使用 HTTP 响应状态代码 200 进行响应,表示请求发送到的 Amazon CLI 和 Amazon 服务未生成错误。

1

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

2

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

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

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

130

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

252

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

253

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

254

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

255

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