Instalar, atualizar e desinstalar a AWS CLI versão 1 no Windows - AWS Command Line Interface

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Instalar, atualizar e desinstalar a 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.

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 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:

  2. Execute o instalador MSI baixado ou o arquivo de configuração.

  3. 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).

  4. 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.22.23 Python/3.8.8 Windows/10 botocore/1.13

    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 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
  2. Selecione a entrada denominada AWS Command Line Interface e escolha Uninstall (Desinstalar) para executar o desinstalador.

  3. Confirme que deseja desinstalar a AWS CLI.

  4. (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%\.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ê também deve ter o Python 3.6 ou posterior instalado. Para obter instruções de instalação, consulte a página Downloading Python no Beginner's Guide do Python.

Atenção

O Python 2.7 foi descontinuado pela Python Software Foundation em 1º de janeiro de 2020. A partir da AWS CLI versão 1.20.0, é necessária uma versão mínima do Python 3.6.

Para usar a AWS CLI versão 1 com uma versão anterior do Python, você precisará instalar uma versão anterior da AWS CLI versão 1. Para visualizar a matriz de suporte a versões do Python para a AWS CLI versão 1, consulte Requisitos da versão 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
  2. 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.

    C:\> aws --version aws-cli/1.22.23 Python/3.8.8 Windows/10 botocore/1.13

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. Se você usar o Python versão 3 ou posterior, recomendamos usar o comando pip3.

    C:\> pip3 uninstall awscli

    Talvez seja necessário reiniciar a janela do prompt de comando ou o computador para remover todos os arquivos.

  2. (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%\.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 pip3C:\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 ...
  2. Pressione a tecla Windows e digite environment variables.

  3. Escolha Edit environment variables for your account (Editar variáveis de ambiente para sua conta).

  4. Selecione PATH e, em seguida, Edit (Editar).

  5. Adicione o caminho encontrado no campo Variable value (Valor da variável). Por exemplo, C:\Program Files\Amazon\AWSCLI\bin\aws.exe.

  6. Escolha OK duas vezes para aplicar as novas configurações.

  7. 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 de erros da AWS CLI 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, O comando “aws --version” retorna uma versão diferente da que você instalou e O comando “aws --version” retorna uma versão após a desinstalação da AWS CLI.