了解 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） 命令結尾時可傳回的傳回程式碼值。

Code	意義
0	命令已成功完成。及 AWS CLI 服務不會將請求傳送到 AWS 所導致任何錯誤。
1	一或多個 Amazon S3 傳輸操作失敗。限於 S3 命令。
2	此傳回碼的意義取決於命令： 適用於所有 CLI 命令 無法剖析輸入的命令–。剖析失敗的原因可能包括 (但不限於) 遺漏必要的子命令或引數，或使用不明命令或參數。 限制為 S3 命令 – 已在傳輸程序期間略過一或多個標記為傳輸的檔案。不過，所有其他標示為傳輸的檔案已成功傳輸。在傳輸過程中略過的檔案包括：不存在的檔案、字元特殊裝置、區塊特殊裝置、FIFO 佇列或通訊埠的檔案，以及使用者不具有讀取許可的檔案。
130	命令被 SIGINT 中斷。這是您傳送以 Ctrl+C 取消命令的訊號。
252	命令語法無效、提供不明的參數，或參數值不正確，且命令無法執行。
253	系統環境或組態無效。雖然提供的命令在語法上有效、遺漏組態或登入資料會使命令無法執行。
254	命令成功剖析，對指定的服務提出請求，但服務傳回錯誤。這通常表示 API 使用方式不正確或其他服務特定問題。
255	命令失敗。請求送往 AWS CLI 或 AWS 的服務產生錯誤。