AWS Command Line Interface
Guia do usuário

Instalar a AWS CLI no Windows

Você pode instalar a AWS Command Line Interface (AWS CLI) no Windows usando um instalador independente ou o pip, que é um gerenciador de pacote para Python. Caso já tenha pip, siga as instruções no tópico de instalação principal.

Instalar a AWS CLI usando o instalador MSI

O AWS CLI é compatível com o Microsoft Windows XP ou posterior. Para usuários do Windows, o pacote de instalação MSI oferece uma maneira familiar e conveniente para instalar o AWS CLI sem necessitar de qualquer outro pré-requisitos.

Quando as atualizações são lançadas, repita o processo de instalação para instalar a versão mais recente do AWS CLI. Para atualizar frequentemente, considere usar o pip para facilitar as atualizações.

Instalar o AWS CLI usando o instalador MSI

  1. Faça o download do instalador MSI apropriado.

    nota

    O instalador MSI para a AWS CLI não funciona com o Windows Server 2008 (versão 6.0.6002). Use pip para instalar com esta versão do Windows Server.

  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 CLI instala para C:\Program Files\Amazon\AWSCLI (versão de 64 bits) ou C:\Program Files (x86)\Amazon\AWSCLI (versão de 32 bits). 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.16.116 Python/3.6.8 Windows/10 botocore/1.12.106

Não incluir o símbolo de prompt (C:\>, mostrado acima) quando você digitar um comando. Essas listas são incluídas no programa para diferenciar comandos que tipo de saída retornado pela CLI. O restante desse guia usa o símbolo de prompt genérico $, exceto nos casos em que um comando é específico do Windows.

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.

Atualizar uma instalação MSI

A AWS CLI é atualizado regularmente. Confira a página de Liberações no GitHub para ver quando a versão mais recente foi lançada. Para atualizar para a versão mais recente, faça download e execute o instalador MSI novamente, conforme descrito anteriormente.

Como desinstalar a AWS CLI

Para desinstalar a AWS CLI, abra o Control Panel (Painel de controle) e escolha Programs and Features (Programas e recursos). Selecione a entrada denominada AWS Command Line Interface e escolha Uninstall (Desinstalar) para executar o desinstalador. Confirme se você deseja desinstalar a AWS CLI quando for solicitado.

Você também pode executar o programa Programs and Features (Programas e recursos) a partir da linha de comando com o seguinte comando.

C:\> appwiz.cpl

Instalar a AWS CLI usando o Python e o pip no Windows

O Python Software Foundation fornece instaladores para Windows que incluem pip.

Para instalar o Python e o pip (Windows)

  1. Faça download do instalador do Python Windows x86-64 na página de downloads do Python.org.

  2. Execute o instalador.

  3. Escolha Add Python 3 to PATH (Adicionar Python 3 ao PATH).

  4. Escolha Instalar agora.

O instalador instala o Python em sua pasta de usuário e adiciona suas pastas do programa ao caminho do usuário.

Para instalar a AWS CLI com o pip3 (Windows)

Se você usar o Python versão 3+, recomendamos usar o comando pip3.

  1. Abra o Command Prompt (Prompt de comando) no menu Start (Iniciar).

  2. Use os seguintes comandos para verificar se o Python e o pip estão instalados corretamente.

    C:\> python --version Python 3.7.1 C:\> pip3 --version pip 18.1 from c:\program files\python37\lib\site-packages\pip (python 3.7)
  3. Instale a AWS CLI usando o pip.

    C:\> pip3 install awscli
  4. Verifique se o AWS CLI está instalado corretamente.

    C:\> aws --version aws-cli/1.16.116 Python/3.6.8 Windows/10 botocore/1.12.106

Para atualizar para a versão mais recente, execute o comando de instalação novamente.

C:\> pip3 install --user --upgrade awscli

Adicionar o executável da AWS CLI em seu caminho de linha de comando

Após a instalação da AWS CLI 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 pode ser necessário definir manualmente se o comando aws não estiver funcionando depois que você fizer a instalação dele.

Se esse comando retornar uma resposta, você estará pronto para executar a ferramenta. O comando where, por padrão, mostra em que local do PATH do sistema ele encontrou o programa especificado:

C:\> where aws C:\Program Files\Amazon\AWSCLI\bin\aws.exe

Você pode encontrar onde o programa aws está instalado executando o seguinte comando.

C:\> where c:\ aws C:\Program Files\Python37\Scripts\aws

Se, em vez disso, o comando where retornar o erro a seguir, ele não estará no PATH do sistema e não será possível executá-lo simplesmente digitando o nome dele.

C:\> where c:\ aws INFO: Could not find files for the given pattern(s).

Nesse caso, execute o comando com o parâmetro /R path para instrui-lo a pesquisar todas as pastas e, assim, você deverá adicionar o caminho manualmente. Use a linha de comando ou o Windows Explorer 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 ...

Os caminhos que aparecem dependem do método usado para instalar a AWS CLI.

Os caminhos típicos incluem:

  • Python 3 e pip3C:\Program Files\Python37\Scripts\

  • Python 3 e pip3 – opção do usuário 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

nota

Os nomes de pasta que incluem os números de versão podem variar. Os exemplos acima refletem o uso do Python versão 3.7. Substitua conforme necessário com o número da versão que você está usando.

Para modificar sua variável PATH (Windows)

  1. Pressione a tecla Windows e digite environment variables.

  2. Escolha Edit environment variables for your account.

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

  4. Adicione o caminho ao campo Variable value (Valor da variável). Por exemplo: C:\new\path

  5. Selecione OK duas vezes para aplicar as novas configurações.

  6. Feche todos os prompts de comando em execução e abra novamente a janela do prompt de comando.