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

# 關於 AWS CLI 使用者指南中的範例
<a name="welcome-examples"></a>

本指南中的 AWS Command Line Interface (AWS CLI) 範例使用下列慣例編排格式：
+ **提示** – 命令提示使用 Linux 提示字元，並顯示為 (`$ `)。對於 Windows 特有的命令，`C:\>` 將其用作提示。鍵入命令時，請不要包含該提示。
+ **目錄** – 命令必須從特定的目錄執行時，該目錄名稱會顯示在提示符號的前方。
+ **使用者輸入** – 於命令列輸入的命令文字採用 **user input** 格式。
+ **可取代文字** – 變數文字 (包含您所選的資源名稱，或您必須納入命令中之 AWS 服務所產生的 ID) 格式採用*可取代文字*。在多行命令或需要特定鍵盤輸入的命令中，鍵盤命令也可以顯示為可取代文字。
+ **輸出** – 由 AWS 服務傳回的輸出會顯示在使用者輸入的下方，並且格式為 `computer output`。

下列 **aws configure** 命令範例示範了使用者輸入、可取代文字以及輸出：

1. 請在命令列中輸入 **aws configure**，再按下 **Enter**。

1. AWS CLI 輸出文字行，提示您輸入其他資訊。

1. 請依次輸入各個存取金鑰，並按下 **Enter**。

1. 接著，以顯示的格式輸入 AWS 區域名稱，按下 **Enter**，然後最後一次按下 **Enter** 以略過輸出格式設定。

1. 最終 **Enter** 命令會顯示為可取代文字，因為該行沒有使用者輸入。

   ```
   $ aws configure
   AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: us-west-2
   Default output format [None]: ENTER
   ```

下面的例子顯示輸出中有一個簡單的命令。若要使用此範例，請輸入命令的完整文字 (提示後方反白顯示的文字)，並按下 **Enter**。安全性群組的名稱 *`my-sg`* 可用您想要的安全群組名稱取代。JSON 文件 (包含大括弧) 為輸出。如果您將 CLI 設為以文字格式或表格格式輸出，則輸出的格式將會有所差異。[JSON](https://json.org) 為預設輸出格式。

```
$ aws ec2 create-security-group --group-name my-sg --description "My security group"
{
    "GroupId": "sg-903004f8"
}
```