AWS CLI 中的命令列傳回碼 - AWS Command Line Interface

本文件 AWS CLI 僅適用於 第 1 版。

我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 公告。如需有關 第 2 版的文件 AWS CLI，請參閱 第 2 版使用者指南。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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 Command Line Interface (AWS CLI) 命令最後可能傳回的傳回碼值。

代碼 意義
0

該服務以 HTTP 回應狀態代碼 200 進行回應，表示請求所傳送的 AWS CLI 和 AWS 服務並未產生錯誤。
1

一或多個 Amazon S3 傳輸操作失敗。限於 S3 命令。
2

此傳回碼的意義取決於命令：

  • 適用於所有 AWS CLI 命令 – 無法剖析輸入的命令。剖析失敗的原因可能包括 (但不限於) 遺漏必要的子命令或引數，或使用不明命令或參數。

  • 限於 S3 命令 – 在傳輸過程中略過一或多個已標示為傳輸的檔案。不過，所有其他標示為傳輸的檔案已成功傳輸。在傳輸過程中略過的檔案包括：不存在的檔案、字元特殊裝置、區塊特殊裝置、FIFO 佇列或通訊埠的檔案，以及使用者不具有讀取許可的檔案。
130

命令被 SIGINT 中斷。這便是您傳送的以 Ctrl+C 取消命令的訊號。
255

命令失敗。請求送往 AWS CLI 或 AWS 的服務產生錯誤。