了解 AWS CLI 的傳回碼 - AWS Command Line Interface

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

了解 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 的服務產生錯誤。