# Sobre os exemplos no Guia do usuário da AWS CLI
<a name="welcome-examples"></a>

Os exemplos da AWS Command Line Interface (AWS CLI) neste guia são formatados de acordo com seguintes convenções:
+ **Prompt**: o prompt de comando usa o prompt do Linux e é exibido como (`$ `). Para comandos específicos do Windows, `C:\>` é usado como prompt. Não inclua prompt quando você digitar comandos. 
+ **Diretório**: quando comandos devem ser executados de um diretório específico, o nome do diretório é mostrado antes do símbolo do comando.
+ **Entrada do usuário** o texto do comando inserido na linha de comando é formatado como **user input**.
+ **Texto substituível**: o texto variável, incluindo nomes de recursos que você escolher ou IDs gerados pelos serviços da AWS, que você deve incluir em comandos é formatado como *texto substituível*. Em comandos ou comandos de várias linhas, em que é necessária uma entrada específica do teclado, os comandos do teclado também podem ser exibidos como texto substituível.
+ **Saída**: a saída retornada pelos serviços da AWS é mostrada sob a entrada do usuário e é formatada como `computer output`.

O exemplo de comando **aws configure** a seguir inclui entradas do usuário, texto substituível e saída:

1. Insira **aws configure** na linha de comando e pressione **Enter**.

1. A AWS CLI gera linhas de texto, solicitando que você insira informações adicionais.

1. Insira cada uma de suas chaves de acesso e pressione **Enter**.

1. Depois, insira um nome de região da AWS no formato mostrado, pressione **Enter** e, depois, **Enter** uma última vez para ignorar o formato de saída.

1. O comando final **Enter** é mostrado como texto substituível porque não há entradas do usuário para essa linha.

   ```
   $ 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
   ```

O exemplo a seguir mostra um comando simples com saída. Para usar este exemplo, insira o texto completo do comando (o texto destacado após o prompt) e pressione **Enter**. O nome do grupo de segurança, *`my-sg`*, pode ser substituído pelo nome do grupo de segurança desejado. O documento JSON, incluindo as chaves, é saída. Se configurar o CLI para resultar em texto ou formato de tabela, a saída será formatada de forma diferente. [JSON](https://json.org) é o formato de saída padrão.

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