本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 中的命令列選項 AWS CLI
在 中 AWS CLI，命令列選項是全域參數，可用來覆寫該單一命令的預設組態設定、任何對應的設定檔設定或環境變數設定。您無法使用命令列選項來直接指定憑證，但可指定要使用的描述檔。
**Topics**
+ [
## 如何使用命令列選項
](#cli-configure-options-how)
+ [
## AWS CLI 支援的全域命令列選項
](#cli-configure-options-list)
+ [
## 命令列選項的常見用途
](#cli-configure-options-common)
## 如何使用命令列選項
大多數命令列選項都是簡單的字串，例如下列範例中的設定檔名稱 `profile1`：
```
$ aws s3 ls --profile profile1
amzn-s3-demo-bucket1
amzn-s3-demo-bucket2
...
```
每個接受引數的選項需要有空格或等號 (=) 來隔開引數與選項名稱。如果引數值是包含空格的字串，則您必須使用引號括住引數。如需關於參數類型和參數格式的詳細資訊，請參閱 [在 AWS CLI 中指定參數值](cli-usage-parameters.md)。
## AWS CLI 支援的全域命令列選項
在 中 AWS CLI ，您可以使用下列命令列選項來覆寫該單一命令的預設組態設定、任何對應的設定檔設定或環境變數設定。
**--ca-bundle ****
指定在驗證 SSL 憑證時使用的憑證授權機構 (CA) 憑證套件。
如果已定義，此選項會覆寫設定檔設定 `ca\$1bundle` 的數值及 `AWS\$1CA\$1BUNDLE` 環境變數。
**--cli-auto-prompt**
啟用單一命令的自動提示模式。如下列範例所示，您隨時都能指定它。
```
$ aws --cli-auto-prompt
$ aws dynamodb --cli-auto-prompt
$ aws dynamodb describe-table --cli-auto-prompt
```
此選項會覆寫 `aws\$1cli\$1auto\$1prompt` 環境變數及 `cli\$1auto\$1prompt` 設定檔設定。
如需第 2 AWS CLI 版自動提示功能的詳細資訊，請參閱 [在 中啟用和使用命令提示字元 AWS CLI](cli-usage-parameters-prompting.md)。
**--cli-binary-format**
指定 AWS CLI 版本 2 如何解譯二進位輸入參數。它可能是以下其中一個數值：
+ **base64** – 這是預設值。以二進位大型物件 (BLOB) 輸入的輸入參數接受 base64 編碼的字串。若要傳遞實際的二進位內容，請將內容放置在檔案中，並在參數值中使用 `fileb://` 前綴，以提供檔案路徑和名稱。若要傳遞包含在檔案中的 base64 編碼文字，請在參數值中使用 `file://` 前綴，以提供檔案路徑和名稱。
+ **raw-in-base64-out** — AWS CLI 第 1 版的預設值。如果設定的值為 `raw-in-base64-out`，則使用 `file://` 字首參考的檔案會讀取為文字，然後 AWS CLI 嘗試將其編碼為二進位。
這會覆寫 `cli\$1binary\$1format` 檔案組態設定。
```
$ aws lambda invoke \
--cli-binary-format raw-in-base64-out \
--function-name my-function \
--invocation-type Event \
--payload '{ "name": "Bob" }' \
response.json
```
如果您使用字`fileb://`首表示法參考檔案中的二進位值， AWS CLI *一律*會預期檔案包含原始二進位內容，而不會嘗試轉換該值。
如果您使用`file://`字首表示法參考檔案中的二進位值， 會根據目前的`cli_binary_format`設定 AWS CLI 處理檔案。如果該設定的值為 `base64`（未明確設定時為預設值）， AWS CLI 預期檔案包含 base64 編碼的文字。如果該設定值為 `raw-in-base64-out`， AWS CLI 預期檔案會包含原始二進位內容。
**--cli-connect-timeout ****
指定通訊端連線時間上限 (以秒為單位)。如果數值設為零 (0)，通訊端連線會無限期等待 (凍結) 且不逾時。預設值為 60 秒。
**--cli-read-timeout ****
指定通訊端讀取時間上限 (以秒為單位)。如果數值設為零 (0)，通訊端讀取會無限期等待 (凍結) 且不逾時。預設值為 60 秒。
**--color ****
指定支援彩色輸出。有效值為 `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
```
**--endpoint-url ****
指定請求送往的 URL。對於大多數命令， 會根據選取的服務和指定的 AWS 區域 AWS CLI 自動判斷 URL。但部分命令需要您指定帳戶專屬的 URL。您也可以設定一些 AWS 服務直接[在您的私有 VPC 中託管端點](https://docs.aws.amazon.com/vpc/latest/userguide/what-is-amazon-vpc.html#what-is-privatelink)，然後可能需要指定。
下列命令範例使用自訂的 Amazon S3 端點 URL。
```
$ aws s3 ls --endpoint-url http://localhost:4567
```
**端點優先順序**
端點組態設定位於多個位置，例如系統或使用者環境變數、本機 AWS 組態檔案，或在命令列上明確宣告為參數。會依特定順序 AWS CLI 檢查這些端點設定，並使用優先順序最高的端點設定。如需端點優先順序清單，請參閱[端點組態和設定優先順序](cli-configure-endpoints.md#endpoints-precedence)。
**--no-cli-auto-prompt**
停用單一命令的自動提示模式。
```
$ aws dynamodb describe-table --table-name Table1 --no-cli-auto-prompt
```
此選項會覆寫 `aws\$1cli\$1auto\$1prompt` 環境變數及 `cli\$1auto\$1prompt` 設定檔設定。
如需第 2 AWS CLI 版自動提示功能的詳細資訊，請參閱 [在 中啟用和使用命令提示字元 AWS CLI](cli-usage-parameters-prompting.md)。
**--no-cli-pager**
為命令停用輸出之分頁程式的布林參數。
**--no-paginate**
布林值開關，可停用 自動 AWS CLI 進行的多個呼叫，以接收建立輸出分頁的所有命令結果。這表示只會顯示輸出的第一頁。
**--no-sign-request**
停用對 AWS 服務端點簽署 HTTP 請求的布林值開關。這可防止載入憑證。
**--no-verify-ssl**
根據預設， AWS CLI 會在與 AWS 服務通訊時使用 SSL。對於每個 SSL 連線和呼叫， AWS CLI 會驗證 SSL 憑證。使用此選項會覆寫驗證 SSL 憑證的預設行為。
此選項**不**是最佳作法。如果您使用 `--no-verify-ssl`，用戶端 AWS 和服務之間的流量將不再受到保護。這意味著您的流量存在安全風險，並且容易受到攔截式攻擊。如果您在憑證上遇到問題，最好改為解決這些問題。如需憑證疑難排解步驟，請參閱 [SSL 憑證錯誤](cli-chap-troubleshooting.md#tshoot-certificate-verify-failed)。
**--output ****
指定要用於此命令的輸出格式。您可以指定下列任何數值：
+ **[`json`](cli-usage-output-format.md#json-output)** – 輸出的格式為 [JSON](https://json.org/) 字串。
+ **[`yaml`](cli-usage-output-format.md#yaml-output)** – 輸出的格式為 [YAML](https://yaml.org/) 字串。
+ **[`yaml-stream`](cli-usage-output-format.md#yaml-stream-output)** – 輸出採用串流方式且格式為 [YAML](https://yaml.org/) 字串。串流可加速處理大型資料類型。
+ **[`text`](cli-usage-output-format.md#text-output)** – 輸出的格式是多行以 Tab 分隔的字串值。這對於將輸出傳遞給文字處理器 (如 `grep`、`sed` 或 `awk`) 非常有用。
+ **[`table`](cli-usage-output-format.md#table-output)** – 輸出的格式為使用字元 \$1\$1- 形成儲存格框線的表格。它通常以「方便人類使用」的格式來呈現資訊，這種格式比其他格式更容易閱讀，但在編寫程式方面較不有用。
+ **[`off`](cli-usage-output-format.md#off-output)** – 輸出會隱藏 stdout 的所有命令輸出。這在自動化指令碼和 CI/CD 管道中非常有用，您只需檢查命令的結束程式碼，而無需處理輸出。
**--profile ****
指定要用於此命令的[具名描述檔](cli-configure-files.md#cli-configure-files-using-profiles)。若需設置額外的具名描述檔，您可以使用 `aws configure` 命令搭配 `--profile` 選項。
```
$ aws configure --profile
```
**--query ****
指定 [JMESPath 查詢](https://jmespath.org/)以用於篩選回應資料。如需詳細資訊，請參閱 [在 中篩選輸出 AWS CLI](cli-usage-filter.md)。
**--region ****
指定 AWS 要傳送此命令 AWS 請求的區域。如需您可指定之所有區域和端點的清單，請參閱 *Amazon Web Services 一般參考* 中的 [AWS 區域與端點](https://docs.aws.amazon.com/general/latest/gr/rande.html)。
**--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 |||
...
```