**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/).
# Instalação, atualização e desinstalação da AWS CLI versão 1 no Windows
Você pode instalar a versão 1 da AWS Command Line Interface (AWS CLI) no Windows usando um instalador independente (recomendado) ou o `pip`, que é um gerenciador de pacotes para Python.
Não inclua o símbolo de prompt (`C:\>`) ao digitar um comando. Eles são incluídos nas listas do programa para diferenciar comandos que você digita da saída retornada pela AWS CLI. O restante desse guia usa o símbolo de prompt genérico (`$`), exceto nos casos em que um comando é específico do Windows.
**Topics**
+ [Instalar, atualizar e desinstalar a AWS CLI versão 1 usando o instalador MSI](#msi-on-windows)
+ [Instalar, atualizar e desinstalar a AWS CLI versão 1 usando Python e pip no Windows](#awscli-install-windows-pip)
+ [Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando](#awscli-install-windows-path)
+ [Solução de problemas de erros de instalação e desinstalação da AWS CLI](#awscli-install-windows-tshoot)
## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando o instalador MSI
A AWS CLI versão 1 é compatível com o Windows XP ou posterior. Para usuários do Windows, o pacote de instalação MSI oferece uma maneira familiar e conveniente de instalar a AWS CLI versão 1 sem necessitar de nenhum outro pré-requisito.
### Instalar e atualizar a AWS CLI versão 1 usando o instalador MSI
Confira a página de [Liberações](https://github.com/aws/aws-cli/releases) no GitHub para ver quando a versão mais recente foi lançada. Quando novas atualizações forem lançadas, você deverá repetir o processo de instalação para instalar a versão mais recente da AWS CLI versão 1.
1. Baixe o instalador MSI apropriado:
+ Instalador MSI da AWS CLI para Windows (64 bits): [https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ Instalador MSI da AWS CLI para Windows (32 bits): [https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ Arquivo de configuração combinado da AWS CLI para Windows: [ https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) (inclui os instaladores MSI de 32 bits e de 64 bits e instala automaticamente a versão correta)
1. Execute o instalador MSI baixado ou o arquivo de configuração.
1. Siga as instruções da tela. Por padrão, a AWS CLI versão 1 é instalada em `C:\Program Files\Amazon\AWSCLI` (versão de 64 bits) ou em `C:\Program Files (x86)\Amazon\AWSCLI` (versão de 32 bits).
1. Para confirmar a instalação, use o comando `aws --version` em um prompt de comando (abra o menu **Start (Iniciar)** e pesquise `cmd` para iniciar um prompt de comando).
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
Se o Windows não conseguir localizar o programa, talvez seja necessário fechar e abrir o prompt de comando novamente para atualizar o caminho ou [adicionar o diretório de instalação à variável de ambiente PATH](#awscli-install-windows-path) manualmente.
### Desinstalar a AWS CLI versão 1
Para usar as instruções de desinstalação a seguir, é necessário ter instalado a AWS CLI versão 1 com o instalador MSI ou com o arquivo de configuração.
1. Abra **Programas e Recursos** seguindo um destes procedimentos:
+ Abra o **Painel de Controle** e selecione **Programas e Recursos**.
+ Abra um prompt de comando e execute o comando a seguir.
```
C:\> appwiz.cpl
```
1. Selecione a entrada denominada **AWS Command Line Interface** e escolha **Uninstall (Desinstalar)** para executar o desinstalador.
1. Confirme que deseja desinstalar a AWS CLI.
1. **(Opcional)** Remova as informações compartilhadas do AWS SDK e das configurações da AWS CLI na pasta `.aws`.
**Atenção**
Essas configurações de configuração e credenciais são compartilhadas em todos os AWS SDKs e na AWS CLI. Se você remover essa pasta, elas não poderão ser acessadas por nenhum AWS SDK que ainda estiver em seu sistema.
O local padrão da pasta `.aws` difere entre plataformas. Por padrão, a pasta está localizada em *%UserProfile%\$1.aws*.
```
$ rmdir %UserProfile%\.aws
```
## Instalar, atualizar e desinstalar a AWS CLI versão 1 usando Python e pip no Windows
O Python Software Foundation fornece instaladores para Windows que incluem `pip`.
### Pré-requisitos
Você deve ter o Python 3.8 ou posterior instalado. Para obter instruções de instalação, consulte a página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) no *Beginner's Guide* do Python.
### Instalar e atualizar a AWS CLI versão 1 usando pip
1. Para instalar a AWS CLI versão 1, use o comando `pip3` (se você usar o Python versão 3 ou posterior) ou o comando `pip`.
**Para a versão mais recente da AWS CLI**, use o seguinte bloco de comandos:
```
C:\> pip3 install awscli --upgrade --user
```
**Para uma versão específica da AWS CLI**, acrescente símbolo de menor que `<` e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *1.16.312* seria *<1.16.312*, o que resultaria no seguinte comando:
```
C:\> pip3 install awscli<1.16.312 --upgrade --user
```
1. Verifique se a AWS CLI versão 1 está instalada corretamente. Se não houver resposta, consulte a seção [Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando](#awscli-install-windows-path).
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
### Desinstalar a AWS CLI versão 1 usando pip
1. Se você instalou a AWS CLI versão 1 usando `pip`, também será necessário desinstalá-la usando `pip`.
```
C:\> pip uninstall awscli
```
Se você estiver usando o Python versão 2 ou 3, talvez seja necessário usar o comando `pip2` ou `pip3`. Use o comando `aws --version` para determinar a versão do Python associada à AWS CLI versão 1 instalada.
```
C:\> pip3 uninstall awscli
```
Talvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.
1. **(Opcional)** Remova as informações compartilhadas do AWS SDK e das configurações da AWS CLI na pasta `.aws`.
**Atenção**
Essas configurações de configuração e credenciais são compartilhadas em todos os AWS SDKs e na AWS CLI. Se você remover essa pasta, elas não poderão ser acessadas por nenhum AWS SDK que ainda estiver em seu sistema.
O local padrão da pasta `.aws` difere entre plataformas. Por padrão, a pasta está localizada em *%UserProfile%\$1.aws*.
```
$ rmdir %UserProfile%\.aws
```
## Adicionar o executável da AWS CLI versão 1 ao caminho da linha de comando
Após a instalação da AWS CLI versão 1 com o `pip`, adicione o programa `aws` à variável de ambiente `PATH` do seu sistema operacional. Com uma instalação MSI, isso deve acontecer automaticamente. Mas se o comando `aws` não for executado após a instalação, talvez seja necessário configurá-lo manualmente.
1. Use o comando `where` para encontrar o local do arquivo `aws`. Por padrão, o comando `where` mostra onde um programa especificado é encontrado no `PATH` do sistema.
```
C:\> where aws
```
Os caminhos que aparecem dependem da plataforma e do método utilizado para instalar a AWS CLI. Os nomes de pasta que incluem os números de versão podem variar. Esses exemplos refletem o uso do Python versão 3.7. Substitua a versão pelo número de versão que você está usando, conforme necessário. Os caminhos típicos incluem o seguinte:
+ **Python 3 e `pip3`** – `C:\Program Files\Python37\Scripts\`
+ **Python 3 e opção --user do `pip3` em versões anteriores do Windows** – `%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts`
+ **Python 3 e `pip3`: opção do usuário no Windows 10**: `%USERPROFILE%\AppData\Roaming\Python\Python37\Scripts`
+ **Instalador MSI (64 bits)** – `C:\Program Files\Amazon\AWSCLI\bin`
+ **Instalador MSI (32 bits)** – `C:\Program Files (x86)\Amazon\AWSCLI\bin`
Use as etapas a seguir levando em conta se um caminho de arquivo é retornado.
------
#### [ A file path is returned ]
```
C:\> where aws
C:\Program Files\Amazon\AWSCLI\bin\aws.exe
```
É possível encontrar onde o programa `aws` está instalado executando o comando a seguir.
```
C:\> where c:\ aws
C:\Program Files\Python37\Scripts\aws
```
------
#### [ A file path is NOT returned ]
Se o comando `where` retornar o erro a seguir, ele não estará no `PATH` do sistema e você não poderá executá-lo inserindo seu nome.
```
C:\> where c:\ aws
INFO: Could not find files for the given pattern(s).
```
Nesse caso, execute o comando `where` com o parâmetro `/R path` para instrui-lo a pesquisar todas as pastas e adicione o caminho manualmente. Use a linha de comando ou o Explorador de Arquivos para descobrir onde ele está instalado no computador.
```
C:\> where /R c:\ aws
c:\Program Files\Amazon\AWSCLI\bin\aws.exe
c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd
...
```
------
1. Pressione a tecla Windows e digite **environment variables**.
1. Escolha **Edit environment variables for your account ** (Editar variáveis de ambiente para sua conta).
1. Selecione **PATH** e, em seguida, **Edit** (Editar).
1. Adicione o caminho encontrado no campo **Variable value** (Valor da variável). Por exemplo, ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***.
1. Escolha **OK** duas vezes para aplicar as novas configurações.
1. Feche todos os prompts de comando em execução e abra novamente a janela do prompt de comando.
## Solução de problemas de erros de instalação e desinstalação da AWS CLI
Se você encontrar problemas após instalar ou desinstalar a AWS CLI, consulte [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md) para obter os passos para a solução de problemas. Para obter os passos mais relevantes para a solução de problemas, consulte [Erros de comando não encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [O comando “`aws --version`” retorna uma versão diferente da que você instalou](cli-chap-troubleshooting.md#tshoot-install-wrong-version) e [O comando “`aws --version`” retorna uma versão após a desinstalação da AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).