

**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 Amazon Linux
<a name="install-linux-al2017"></a>

A AWS CLI versão 1 está pré-instalada no Amazon Linux e no Amazon Linux 2. Verifique a versão atualmente instalada usando o comando a seguir.

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

Dependendo de quando você criou sua instância do Amazon Linux, a AWS CLI versão 1 é pré-instalada usando um dos seguintes gerenciadores de pacotes:
+ [pip](#install-amazon-linux-pip)
+ [yum](#install-amazon-linux-yum)

## Pré-requisitos
<a name="install-amazon-linux-prereq"></a>

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.

**Matriz de suporte a versões do Python**


| AWS CLIVersão do  | Versão do Python com suporte | 
| --- | --- | 
| 1.39.0: atual | Python 3.9 e posterior | 
| 1.32.0-1.38.38 | Python 3.8 e posterior | 
| 1.27.0–1.31.x | Python 3.7 e posterior | 
| 1.20.0–1.26.x | Python 3.6 | 
| 1.19.0: 1.19.x | Python 2.7\$1, Python 3.6\$1 | 
| 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 e anteriores, Python 3.3 e anteriores | 

## Instalar, atualizar e desinstalar usando pip
<a name="install-amazon-linux-pip"></a>

A maioria das instâncias do Amazon Linux usa pip para pré-instalar a AWS CLI versão 1.

### Instalar ou atualizar a AWS CLI versão 1 no Amazon Linux usando pip
<a name="install-amazon-linux-pip-install"></a>

Para instalar a versão mais recente da AWS CLI versão 1 para o usuário atual, use as instruções a seguir.

1. Se você tiver o Python versão 3 ou posterior instalado, recomendamos usar o `pip3`. Use `pip3 install` para instalar ou atualizar para a versão mais recente da AWS CLI versão 1. Se você executar o comando em um [ambiente virtual Python (venv)](https://docs.python.org/3/library/venv.html), não será necessário usar a opção `--user`. 

   ```
   $ pip3 install --upgrade --user awscli
   ```

1. Verifique se a pasta que contém `aws` faz parte da variável `PATH`.

   1. Encontre o script de perfil do shell no diretório de usuário. Se não tiver certeza de qual shell você tem, execute `echo $SHELL`.

      ```
      $ ls -a ~
      .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
      ```
      + **Bash**: `.bash_profile`, `.profile` ou `.bash_login`
      + **Zsh** – `.zshrc`
      + **Tcsh**: `.tcshrc`, `.cshrc` ou `.login`.

   1. Adicione um comando de exportação ao final do script de perfil que é semelhante ao exemplo a seguir.

      ```
      export PATH=$HOME/.local/bin:$PATH
      ```

      Esse comando insere o caminho `$HOME/.local/bin` neste exemplo na frente da variável `$PATH` existente.

   1. Recarregue o perfil em sua sessão atual para colocar essas alterações em vigor.

      ```
      $ source ~/.bash_profile
      ```

1. Para verificar se você está executando a nova versão, use o comando `aws --version`.

   ```
   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
   ```

### Desinstalar a AWS CLI versão 1 usando pip
<a name="install-amazon-linux-pip-uninstall"></a>

Se precisar desinstalar a AWS CLI, use `pip uninstall`.

```
$ pip3 uninstall awscli
```

## Instalar, atualizar ou desinstalar usando yum
<a name="install-amazon-linux-yum"></a>

A maioria das instâncias do Amazon Linux usa yum para pré-instalar a AWS CLI versão 1.

### Instalar ou atualizar a AWS CLI versão 1 no Amazon Linux usando yum
<a name="install-amazon-linux-yum-install"></a>

Para instalar a versão mais recente da AWS CLI versão 1 disponível no Amazon Linux, execute o comando a seguir.

```
$ sudo yum install awscli
```

Para atualizar para versão mais recente da AWS CLI versão 1 disponível no Amazon Linux, execute o comando a seguir.

```
$ sudo yum update awscli
```

Para verificar se você está executando a versão mais recente, use o comando `aws --version`.

```
$ aws --version
aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6
```

### Desinstalar a AWS CLI versão 1 usando yum
<a name="install-amazon-linux-yum-uninstall"></a>

Para desinstalar a AWS CLI, use `yum remove`.

```
$ sudo yum remove awscli
```

## Solução de problemas de erros de instalação e desinstalação da AWS CLI
<a name="install-amazon-linux-tshoot"></a>

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