Instale, atualize e desinstale a AWS CLI versão 1 no Windows - AWS Command Line Interface

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

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Instale, atualize e desinstale a AWS CLI versão 1 no Windows

Você pode instalar a versão 1 do AWS Command Line Interface (AWS CLI) no Windows usando um instalador autônomo (recomendado) oupip, 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.

Instale, atualize e desinstale 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 do MSI oferece uma maneira familiar e conveniente de instalar a AWS CLI versão 1 sem instalar nenhum outro pré-requisito.

Instale e atualize a AWS CLI versão 1 usando o instalador MSI

Verifique a página de lançamentos 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 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.32.65 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 manualmente.

Desinstale 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 você deseja desinstalar AWS CLI o.

  4. (Opcional) Remova o AWS SDK compartilhado e AWS CLI as informações de configurações da .aws pasta.

    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, ela não poderá ser acessada por nenhum AWS SDK que ainda esteja no seu sistema.

    A localização padrão da .aws pasta difere entre as plataformas. Por padrão, a pasta está localizada em%UserProfile%\ .aws.

    $ rmdir %UserProfile%\.aws

Instale, atualize e desinstale 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 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 mais antiga do Python, você precisa instalar uma versão anterior da AWS CLI versão 1. Para ver a matriz de suporte da AWS CLI versão 1 do Python, consulte. Requisitos da versão do Python

Instale e atualize a AWS CLI versão 1 usando pip

  1. Para instalar a AWS CLI versão 1, use o pip3 comando (se você usa o Python versão 3 ou posterior) ou o pip comando.

    Para a versão mais recente do AWS CLI, use o seguinte bloco de comando:

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

    Para uma versão específica do AWS CLI, acrescente um símbolo 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 Adicione o executável da AWS CLI versão 1 ao seu caminho de linha de comando.

    C:\> aws --version aws-cli/1.32.65 Python/3.11.6 Windows/10 botocore/1.18.6

Desinstale a AWS CLI versão 1 usando pip

  1. Se você instalou a AWS CLI versão 1 usandopip, você também deve desinstalar usandopip.

    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 aws --version comando para determinar a versão do Python associada à sua AWS CLI versão instalada 1.

    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 o AWS SDK compartilhado e AWS CLI as informações de configurações da .aws pasta.

    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, ela não poderá ser acessada por nenhum AWS SDK que ainda esteja no seu sistema.

    A localização padrão da .aws pasta difere entre as plataformas. Por padrão, a pasta está localizada em%UserProfile%\ .aws.

    $ rmdir %UserProfile%\.aws

Adicione o executável da AWS CLI versão 1 ao seu caminho de linha de comando

Depois de instalar a AWS CLI versão 1 compip, adicione o aws programa à variável de PATH ambiente 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 AWS CLI instalação e desinstalação

Se você encontrar problemas após instalar ou desinstalar o AWS CLI, consulte as etapas de solução Solucionar problemas de erros AWS CLI 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 do AWS CLI.