**Esta documentação é somente para a versão 1 da AWS CLI.**
Anunciamos o próximo fim do suporte para a AWS CLI versão 1. É recomendável migrar para a AWS CLI versão 2. Para saber as datas e receber detalhes e informações adicionais sobre como migrar, consulte o [anúncio](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Para obter a documentação relacionada à AWS CLI versão 2, consulte o [Guia do usuário da versão 2](https://docs.aws.amazon.com/cli/latest/userguide/).
# O que é o AWS Command Line Interfaceversão 1?
**nota**
A versão 1 da AWS CLI não é a versão mais recente da AWS CLI. Alguns recursos apresentados na AWS CLI versão 2 não são compatíveis com a versão 1, e você deve fazer a atualização para acessá-los. Há algumas alterações "radicais" em relação à versão 1 que podem exigir alterações nos scripts. Para obter uma lista das alterações mais recentes na versão 2, consulte [Alterações mais recentes](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html) no *Guia do usuário da AWS CLI versão 2*.
A AWS Command Line Interface (AWS CLI) é uma ferramenta de código aberto que permite interagir com os serviços da AWS usando comandos no shell da linha de comando. Com o mínimo de configuração, a AWS CLI permite começar a executar comandos que implementam uma funcionalidade equivalente àquela fornecida pelo Console de gerenciamento da AWS baseado em navegador do prompt de comando em seu programa de terminal:
+ **Shells do Linux**: use programas comuns de shell, como [https://www.gnu.org/software/bash/](https://www.gnu.org/software/bash/), [http://www.zsh.org/](http://www.zsh.org/) e [https://www.tcsh.org/](https://www.tcsh.org/) para executar comandos no Linux ou macOS.
+ **Linha de comando do Windows**: no Windows, execute comandos no prompt de comando do Windows ou no PowerShell.
+ **Remotamente**: execute comandos em instâncias do Amazon Elastic Compute Cloud (Amazon EC2) por meio de um programa de terminal remoto, como PuTTY ou SSH, ou com o .AWS Systems Manager
Toda as funções administração, gerenciamento e acesso da AWS IaaS (Infraestrutura como um serviço) no Console de gerenciamento da AWS estão disponíveis na API da AWS e na AWS CLI. Os novos recursos e serviços da AWS IaaS fornecem funcionalidade completa do Console de gerenciamento da AWS por meio da API e da CLI no lançamento ou dentro de 180 dias após o lançamento.
A AWS CLI fornece acesso direto às APIs públicas de serviços da AWS. Você pode explorar os recursos de um serviço com a AWS CLI e desenvolver scripts de shell para gerenciar seus recursos. Além dos comandos de nível inferior equivalentes a API, vários serviços da AWS fornecem personalizações para a AWS CLI. As personalizações podem incluir comandos de nível mais elevado que simplificam o uso de um serviço com uma API complexa.
## Sobre a AWS CLI versão 1
A AWS CLI versão 1 é a AWS CLI original, e continuamos a oferecer suporte a ela. No entanto, é possível que a portabilidade dos principais recursos apresentados na AWS CLI versão 2 não seja feita para a AWS CLI versão 1. Para usar esses recursos, é necessário instalar a AWS CLI versão 2. A AWS CLI versão 1 é criada com o SDK for Python e, portanto, requer a instalação de uma versão compatível do Python.
Para instalar a AWS CLI versão 1, consulte [Instalar, atualizar e desinstalar a AWS CLI](cli-chap-install.md).
Para verificar a versão atualmente instalada, use o seguinte comando:
```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```
Para obter o histórico de versões, consulte o [Log de alterações da AWS CLI versão 1](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst) no *GitHub*.
## Manutenção e suporte para as versões principais do SDK
Para obter informações sobre manutenção e suporte para versões principais do SDK e suas dependências subjacentes, consulte o seguinte no [Guia de referência de AWS SDKs e ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html):
+ [AWS Política de manutenção de ferramentas e SDKs da](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS Matriz de suporte a versões de ferramentas e SDKs da](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)
## Sobre a Amazon Web Services
A Amazon Web Services (AWS) é um conjunto de serviços de infraestrutura digital que os desenvolvedores podem utilizar ao desenvolver suas aplicações. Os serviços incluem computação, armazenamento, banco de dados e sincronização de aplicações (sistema de mensagens e filas). A AWS usa um modelo de serviço de pagamento conforme o uso. Você será cobrado apenas pelos serviços que você ou suas aplicações usam. Além disso, para tornar AWS mais acessível como plataforma para criação de protótipos e experimentação, a AWS oferece um nível de uso gratuito. Neste nível, os serviços são gratuitos abaixo de um determinado nível de uso. Para obter mais informações sobre os custos e o nível gratuito da AWS, consulte [Nível gratuito da AWS](https://aws.amazon.com/free/). Para obter uma conta da AWS, abra a [página inicial da AWS](https://aws.amazon.com/) e selecione **Criar uma conta da AWS**.
# Sobre os exemplos no Guia do usuário da AWS CLI
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"
}
```
# Documentação e recursos adicionais para a AWS CLI
## AWS CLIDocumentação e recursos da
Além deste guia, os recursos a seguir são fontes online importantes para quando for usar a AWS CLI.
+ [AWS CLI Guia de referência da versão 1 da](https://docs.aws.amazon.com/cli/v1/reference/)
+ [Repositório de exemplos de códigos de script bash da AWS CLI](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli). Exemplos de scripts bash de código aberto. *Os exemplos de script Bash estão hospedados no [Repositório de exemplos de código da AWS](https://github.com/awsdocs/aws-doc-sdk-examples) no GitHub*.
+ [Repositório da AWS CLI no GitHub](https://github.com/aws/aws-cli). Você pode visualizar e bifurcar o código-fonte para a AWS CLI no *GitHub*. Faça parte da comunidade de usuários no *GitHub* para fornecer feedback, solicitar recursos e enviar suas próprias contribuições. Isso inclui visualizar e fornecer exemplos de comandos para a documentação da AWS CLI.
+ [Repositório de exemplos de alias da AWS CLI](https://github.com/awslabs/awscli-aliases): você pode visualizar e bifurcar exemplos de alias da AWS CLI no *GitHub*.
+ [AWS CLI Log de alterações da versão](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst)
+ [AWS CLI Log de alterações da versão](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)
## Outras ferramentas e SDKs da AWS
Dependendo do seu caso de uso, talvez você queira escolher uma das ferramentas ou SDKs da AWS para melhor atender às suas necessidades:
+ [AWS Guia de referência de SDKs e ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp)
+ [AWS SDK para Go](https://docs.aws.amazon.com/sdk-for-go/api/)
+ [AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin)
+ [AWS SDK para .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/)
+ [AWS SDK para Python (Boto)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
+ [AWS SDK para PHP](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/)
+ [Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/)
+ [AWS SDK para Ruby](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/)
+ [AWS SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust)
+ [AWS SDK para SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap)
+ [AWS SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift)
+ [AWS Amplify](https://docs.amplify.aws/swift/)