# 关于《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"
}
```