命令列選項 - AWS Command Line Interface
如何使用命令列選項AWS CLI 支援的全域命令列選項命令列選項的常見用途

本文件僅適用於第 1 AWS CLI 版。如需與版本 2 的相關文件 AWS CLI，請參閱第 2 版使用者指南。

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

命令列選項

在中 AWS CLI，指令行選項是整體參數，您可以用來取代該單一指令的預設組態設定、任何對應的設定檔設定或環境變數設定。您無法使用命令列選項來直接指定憑證，但可指定要使用的描述檔。

如何使用命令列選項

大多數命令列選項都是簡單的字串，例如下列範例中的設定檔名稱 profile1：

$ aws s3 ls --profile profile1
example-bucket-1
example-bucket-2
...

每個接受引數的選項需要有空格或等號 (=) 來隔開引數與選項名稱。如果引數值是包含空格的字串，則您必須使用引號括住引數。如需關於參數類型和參數格式的詳細資訊，請參閱 指定參數值 AWS CLI。

AWS CLI 支援的全域命令列選項

在中， AWS CLI 您可以使用下列指令行選項來取代該單一指令的預設組態設定、任何對應的紀要設定或環境變數設定。

-ca-捆綁 <string>

指定驗證憑證時要使用的憑證授權單位 (CA) SSL 憑證套裝軟體。

如果已定義，此選項會覆寫設定檔設定 ca_bundle 的數值及 AWS_CA_BUNDLE 環境變數。

--cli-connect-timeout <integer>

指定通訊端連線時間上限 (以秒為單位)。如果數值設為零 (0)，通訊端連線會無限期等待 (凍結) 且不逾時。

--cli-read-timeout <integer>

指定通訊端讀取時間上限 (以秒為單位)。如果數值設為零 (0)，通訊端讀取會無限期等待 (凍結) 且不逾時。

-顏色 <string>

指定支援彩色輸出。有效值為 on、off 和 auto。預設值為 auto。

--debug

啟用偵錯記錄的布林參數。 AWS CLI 依預設，會提供有關命令輸出中指令結果之任何成功或失敗的清理資訊。此 --debug 選項會提供完整的 Python 記錄。這包括命令操作的額外 stderr 診斷資訊，在分析解決命令為什麼產生意外結果時很有用。為了方便檢視偵錯記錄，我們建議將記錄傳送至檔案，以便更輕鬆地搜尋資訊。您可以使用下列其中一種來執行這項作業。

若要僅傳送 stderr 診斷資訊，請附加 2> debug.txt，其中 debug.txt 是您想要用於偵錯檔案的名稱：

$ aws servicename commandname options --debug 2> debug.txt

若要同時傳送輸出及 stderr 診斷資訊，請附加 &> debug.txt，其中 debug.txt 是您想要用於偵錯檔案的名稱：

$ aws servicename commandname options --debug &> debug.txt
-端點網址 <string>

指定URL要傳送要求的目標。對於大多數命令， AWS CLI 會URL根據所選服務和指定的 AWS 區域自動確定。但是，某些指令需要您指定帳戶特URL定。您還可以將某些 AWS 服務配置為直接在您的私有端點內託管端點VPC，然後可能需要指定該端點。

下列命令範例使用自訂的 Amazon S3 端點URL。

$ aws s3 ls --endpoint-url http://localhost:4567

端點組態設定位於多個位置，例如系統或使用者環境變數、本機 AWS 組態檔案，或在命令列上明確宣告為參數。 AWS CLI 端點組態設定的優先順序如下：

  1. --endpoint-url 命令列選項。

  2. 如果啟用，則 AWS_IGNORE_CONFIGURED_ENDPOINT_URLS 全域端點環境變數或設定檔設定 ignore_configure_endpoint_urls 將忽略自訂端點。

  3. 服務特定環境變數 AWS_ENDPOINT_URL_<SERVICE> 所提供的值，例如 AWS_ENDPOINT_URL_DYNAMODB。

  4. AWS_USE_DUALSTACK_ENDPOINT、AWS_USE_FIPS_ENDPOINT 和 AWS_ENDPOINT_URL 環境變數所提供的值。

  5. 共用 config 檔案 services 區段內的 endpoint_url 設定所提供的服務特定端點值。

  6. 共用 config 檔案的 profile 中的 endpoint_url 設定所提供的值。

  7. use_dualstack_endpoint、use_fips_endpoint 和 endpoint_url 設定。

  8. 最後會使URL用相應 AWS service 的任何預設端點。如需每個區域可用的標準服務端點清單，請參閱 Amazon Web Services 一般參考 中的 AWS 區域與端點。

--no-paginate

一個布林參數，可停用自動 AWS CLI 進行的多次呼叫，以接收建立輸出分頁的所有命令結果。這表示只會顯示輸出的第一頁。

--no-sign-request

一種布林參數，可停用將HTTP要求簽署至 AWS 服務端點。這可防止載入憑證。

--no-verify-ssl

默認情況下，與 AWS 服務通信SSL時的 AWS CLI 用途。對於每個SSL連接和呼叫， AWS CLI 驗證SSL證書。使用此選項會覆寫驗SSL證憑證的預設行為。

警告

此選項不是最佳作法。如果您使用--no-verify-ssl，您的用戶端和 AWS 服務之間的流量將不再受到保護。這意味著您的流量存在安全風險，並且容易受到 man-in-the-middle 攻擊。如果您在憑證上遇到問題，最好改為解決這些問題。如需憑證疑難排解步驟，請參閱 SSL憑證錯誤。

--輸出 <string>

指定要用於此命令的輸出格式。您可以指定下列任何數值：

  • json— 輸出格式化為JSON字串。

  • text – 輸出的格式是多行以 Tab 分隔的字串值。這對於將輸出傳遞給文字處理器 (如 grep、sed 或 awk) 非常有用。

  • table – 輸出的格式為使用字元 +|- 形成儲存格框線的表格。它通常以「方便人類使用」的格式來呈現資訊，這種格式比其他格式更容易閱讀，但在編寫程式方面較不有用。

--profile <string>

指定要用於此命令的具名描述檔。若需設置額外的具名描述檔，您可以使用 aws configure 命令搭配 --profile 選項。

$ aws configure --profile <profilename>
-查詢 <string>

指定用於JMESPath篩選回應資料的查詢。如需詳細資訊，請參閱 濾波器 AWS CLI 輸出。

--region <string>

指定要將此命令 AWS 請求發送到哪個 AWS 區域。如需您可指定之所有區域和端點的清單，請參閱 Amazon Web Services 一般參考 中的 AWS 區域與端點。

--version

顯示目前正在執行之 AWS CLI 程式版本的布林參數。

命令列選項的常見用途

命令列選項的常見用途包括在多個 AWS 區域中查看您的資源，或是於編寫指令碼時變更輸出格式以利易讀性與使用便利。在下列範例中，我們執行 describe-instances 命令，直到我們找到執行個體所在的區域。

$ aws ec2 describe-instances --output table --region us-west-1
-------------------
|DescribeInstances|
+-----------------+
$ aws ec2 describe-instances --output table --region us-west-2
------------------------------------------------------------------------------
|                              DescribeInstances                             |
+----------------------------------------------------------------------------+
||                               Reservations                               ||
|+-------------------------------------+------------------------------------+|
||  OwnerId                            |  012345678901                      ||
||  ReservationId                      |  r-abcdefgh                        ||
|+-------------------------------------+------------------------------------+|
|||                                Instances                               |||
||+------------------------+-----------------------------------------------+||
|||  AmiLaunchIndex        |  0                                            |||
|||  Architecture          |  x86_64                                       |||
...