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

As versões Python 2.7, 3.4 e 3.5 foram descontinuadas pela AWS CLI versão 1. Para obter mais informações, consulte a seção AWS CLI versão 1 de Sobre as versões da AWS CLI.

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. Faça o download do instalador MSI apropriado:

  2. Execute o instalador MSI obtido por download 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.19.3 Python/3.7.4 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.

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.

Prerequisites

O Python 2 versão 2.7 ou posterior ou o Python 3 versão 3.6 ou posterior deverá estar instalado. Para obter instruções de instalação, consulte a página Downloading Python no Beginner's Guide do Python.

Atenção

As versões Python 3.4 e 3.5 foram descontinuadas a partir de 2/1/2021.

O Python 2.7 foi descontinuado pela Python Software Foundation em 1º de janeiro de 2020. No futuro, os clientes que usam a AWS CLI versão 1 deverão fazer a transição para o Python 3 (no mínimo, Python 3.6). O suporte ao Python 2.7 foi descontinuado para novas versões da AWS CLI versão 1 a partir de 15/7/2021.

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 Sobre as versões da AWS CLI.

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. Para este 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.19.3 Python/3.7.4 Windows/10 botocore/1.13

Desinstalar a AWS CLI versão 1 usando pip

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.

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.

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

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

  6. Selecione 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.