

**Esta documentación es para la versión 1 de AWS CLI.**

Anunciamos el próximo fin del soporte para la versión 1 de AWS CLI. Recomendamos migrarse a la versión 2 de AWS CLI. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el [anuncio](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la [Guía del usuario de la versión 2](https://docs.aws.amazon.com/cli/latest/userguide/).

# Instalar, actualizar y desinstalar la AWS CLI
<a name="cli-chap-install"></a>

En este tema, se proporcionan enlaces para instalar, actualizar y desinstalar la versión original de AWS Command Line Interface (AWS CLI). La versión 1 de AWS CLI es compatible actualmente, pero se agregan nuevas características a la versión 2 de AWS CLI que puede que no se agreguen a la versión 1 de AWS CLI. Para utilizar estas características, debe instalar la versión 2 de la AWS CLI. Para obtener información sobre cómo instalar la versión 2, consulte [Instalación de la versión 2 de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html).

**Topics**
+ [

## Requisitos de versión de Python
](#cli-chap-install-python)
+ [Amazon Linux](install-linux-al2017.md)
+ [Linux](install-linux.md)
+ [macOS](install-macos.md)
+ [Windows](install-windows.md)
+ [Virtualenv](install-virtualenv.md)

## Requisitos de versión de Python
<a name="cli-chap-install-python"></a>

La versión 1 de la AWS CLI se construye usando el SDK para Python y, por lo tanto, requiere que instale una versión compatible de Python.

**Matriz de compatibilidad con versiones de Python**


| Version de la AWS CLI | Versión de Python compatible | 
| --- | --- | 
| 1.39.0: actual | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0: 1.31.x | Python 3.7\$1 | 
| 1.20.0 – 1.26.x | Python 3.6\$1 | 
| 1.19.0 – 1.19.x | Python: Python 3.6 y 2.7 | 
| 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 y versiones anteriores, Python 3.3 y versiones anteriores | 

Para obtener información sobre los lanzamientos más recientes de AWS CLI, consulte el [registro de cambios de la versión 2 de la AWS CLI](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) en GitHub.

# Instalación, actualización y desinstalación de la versión 1 de la AWS CLI en Linux
<a name="install-linux-al2017"></a>

La versión 1 de la AWS CLI está preinstalada en Amazon Linux y Amazon Linux 2. Consulte la versión instalada actualmente utilizando el siguiente comando.

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

En función del momento en que haya creado la instancia de Amazon Linux, la versión 1 de AWS CLI está preinstalada mediante uno de los siguientes administradores de paquetes:
+ [pip](#install-amazon-linux-pip)
+ [yum](#install-amazon-linux-yum)

## Requisitos previos
<a name="install-amazon-linux-prereq"></a>

Debe tener ‎instalado Python 3.8 o una versión posterior. Para obtener instrucciones de instalación, consulte la página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) en la *Guía para principiantes* de Python.

**Matriz de compatibilidad con versiones de Python**


| AWS CLIVersion de la  | Versión de Python compatible | 
| --- | --- | 
| 1.39.0: actual | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0: 1.31.x | Python 3.7\$1 | 
| 1.20.0 – 1.26.x | Python 3.6\$1 | 
| 1.19.0 – 1.19.x | Python: Python 3.6 y 2.7 | 
| 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 y versiones anteriores, Python 3.3 y versiones anteriores | 

## Instalación, actualización o desinstalación con pip
<a name="install-amazon-linux-pip"></a>

La mayoría de las instancias de Amazon Linux utilizan pip para preinstalar la versión 1 de AWS CLI.

### Instale o actualice la versión 1 de la AWS CLI en Amazon Linux usando pip
<a name="install-amazon-linux-pip-install"></a>

Para instalar la versión más reciente de la versión 1 de la AWS CLI para el usuario actual, siga estas instrucciones.

1. Si tiene instalada la versión 3 o posterior de Python, recomendamos que utilice `pip3`. Utilice `pip3 install` para instalar o actualizar la última versión de la versión 1 de la AWS CLI. Si ejecuta el comando desde un [entorno virtual de Python (venv)](https://docs.python.org/3/library/venv.html), no necesita utilizar la opción `--user`. 

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

1. Asegúrese de que la carpeta que contiene `aws`forme parte de la variable `PATH`.

   1. Busque el script de perfil de su shell en su directorio de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

   1. Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.

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

      Este comando inserta la ruta, `$HOME/.local/bin` en este ejemplo, delante de la variable `$PATH` existente.

   1. Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.

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

1. Para comprobar que está ejecutando la nueva versión, utilice el 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
   ```

### Desinstalación de la versión 1 de la AWS CLI con pip
<a name="install-amazon-linux-pip-uninstall"></a>

Si necesita desinstalar la AWS CLI, utilice `pip uninstall`.

```
$ pip3 uninstall awscli
```

## Instalación, actualización o desinstalación con yum
<a name="install-amazon-linux-yum"></a>

La mayoría de las instancias de Amazon Linux 2 utilizan yum para preinstalar la versión 1 de AWS CLI.

### Instale o actualice la versión 1 de AWS CLI en Amazon Linux con yum
<a name="install-amazon-linux-yum-install"></a>

Para instalar la versión más reciente de la versión 1 de AWS CLI disponible en Amazon Linux, ejecute el siguiente comando.

```
$ sudo yum install awscli
```

Para actualizar la versión más reciente de la versión 1 de AWS CLI disponible en Amazon Linux, ejecute el siguiente comando.

```
$ sudo yum update awscli
```

Para comprobar que está ejecutando la versión más reciente, utilice el 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
```

### Desinstalación de la versión 1 de AWS CLI con yum
<a name="install-amazon-linux-yum-uninstall"></a>

Para desinstalar AWS CLI, utilice `yum remove`.

```
$ sudo yum remove awscli
```

## Solución de errores de instalación y desinstalación de AWS CLI
<a name="install-amazon-linux-tshoot"></a>

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md) los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte [Errores de comando no encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).

# Instalación, actualización y desinstalación de la versión 1 de la AWS CLI en Linux
<a name="install-linux"></a>

Puede instalar la versión 1 de la AWS Command Line Interface (AWS CLI) y sus dependencias en la mayoría de las distribuciones de Linux con el administrador de paquetes `pip` o el instalador incluido.

Aunque el paquete `awscli` está disponible en los repositorios de otros administradores de paquetes, como `apt` y `yum`, estos no han sido generados ni están administrados ni admitidos por AWS. Le recomendamos que solamente instale la AWS CLI desde los puntos de distribución oficiales de AWS, tal y como se indica en esta guía.

**Topics**
+ [

## Requisitos previos
](#install-linux-prereqs)
+ [

## Instalación y desinstalación de la versión 1 de la AWS CLI en Linux con el instalador incluido
](#install-linux-bundled)
+ [

## Instale y desinstale la versión 1 de la AWS CLI con pip
](#install-linux-pip)
+ [

## Instalación y desinstalación de la versión 1 de la AWS CLI con Snapcraft
](#install-linux-snap)
+ [

## Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
](#install-linux-path)
+ [

## Solución de errores de instalación y desinstalación de AWS CLI
](#install-linux-tshoot)

## Requisitos previos
<a name="install-linux-prereqs"></a>

Debe tener ‎instalado Python 3.8 o una versión posterior. Para obtener instrucciones de instalación, consulte la página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) en la *Guía para principiantes* de Python.

**Matriz de compatibilidad con versiones de Python**


| AWS CLIVersion de la  | Versión de Python compatible | 
| --- | --- | 
| 1.39.0: actual | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0: 1.31.x | Python 3.7\$1 | 
| 1.20.0 – 1.26.x | Python 3.6\$1 | 
| 1.19.0 – 1.19.x | Python: Python 3.6 y 2.7 | 
| 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 y versiones anteriores, Python 3.3 y versiones anteriores | 

## Instalación y desinstalación de la versión 1 de la AWS CLI en Linux con el instalador incluido
<a name="install-linux-bundled"></a>

En Linux o macOC, también utilizar el instalador incluido para instalar la versión 1 de la AWS CLI. Este incluye todas las dependencias y se puede usar sin conexión.

**nota**  
El instalador empaquetado no admite la instalación en rutas que contienen espacios.

**Topics**
+ [

### Instalación de la versión 1 de la AWS CLI con el instalador incluido con `sudo`
](#install-linux-bundled-sudo)
+ [

### Instale la versión 1 de la AWS CLI con el instalador empaquetado sin `sudo`
](#install-linux-bundled-no-sudo)
+ [

### Desinstale el instalador empaquetado de la versión 1 de la AWS CLI
](#install-linux-bundled-uninstall)

### Instalación de la versión 1 de la AWS CLI con el instalador incluido con `sudo`
<a name="install-linux-bundled-sudo"></a>

Los pasos que se indican a continuación le permiten instalar AWS CLI la versión 1 de la desde la línea de comandos en cualquier compilación de Linux o macOS.

A continuación, se muestra un resumen de los comandos de instalación que puede cortar y pegar para que se ejecuten como un único conjunto de comandos.

**Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```

**Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```

Siga estos pasos desde la línea de comandos para instalar la versión 1 de la AWS CLI con el instalador empaquetado.

**Para instalar la versión 1 de la AWS CLI con el instalador empaquetado**

1. Descargue el instalador empaquetado de la versión 1 de la AWS CLI con uno de los métodos siguientes.
   + Descárguelo con el comando `curl`.

     **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
     ```

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
     ```
   + Descárguelo mediante el enlace directo.

     **Para obtener la última versión de AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente url [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)

1. Extraiga los archivos del paquete. Si no tiene `unzip` para extraer los archivos, utilice el administrador de paquetes integrado de la distribución de Linux para instalarlo.

   ```
   $ unzip awscli-bundle.zip
   ```

1. Ejecute el programa de instalación. El instalador instala la AWS CLI en `/usr/local/aws` y crea el symlink `aws` en el directorio `/usr/local/bin`. Si se usa la opción `-b` para crear un symlink, no es necesario especificar el directorio de instalación en la variable `$PATH` del usuario. Con esto, todos los usuarios deberían poder llamar a la AWS CLI al escribir `aws` desde cualquier directorio.

   ```
   $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
   ```

   El script de instalación se ejecuta en la versión de Python predeterminada del sistema. Si tiene instalada una versión alternativa de Python y quiere usar esa versión para instalar la AWS CLI, ejecute el script de instalación de esa versión utilizando la ruta absoluta del ejecutable de Python, tal y como se muestra a continuación

   ```
   $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
   ```

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Instale la versión 1 de la AWS CLI con el instalador empaquetado sin `sudo`
<a name="install-linux-bundled-no-sudo"></a>

Si no tiene permisos `sudo` o quiere instalar la AWS CLI solo para el usuario actual, puede utilizar una versión modificada de los comandos anteriores. Los dos primeros comandos son iguales. 

**Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```

**Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```

**Para instalar la versión 1 de la AWS CLI para el usuario actual**

1. Descargue el instalador empaquetado de la versión 1 de la AWS CLI de una de las siguientes maneras.
   + Descárguelo con el comando `curl`.

     **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
     ```

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
     ```
   + Descárguelo mediante el enlace directo.

     **Para obtener la última versión de AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente url [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)

1. Extraiga los archivos del paquete mediante `unzip`. Si no tiene `unzip`, utilice el administrador de paquetes integrado de la distribución de Linux para instalarlo.

   ```
   $ unzip awscli-bundle.zip
   ```

1. Ejecute el programa de instalación. El instalador instala la AWS CLI en `/usr/local/aws` y crea el symlink `aws` en el directorio `/usr/local/bin`. El comando utiliza el parámetro `-b` para especificar el directorio en el que el instalador coloca el archivo del enlace simbólico de `aws`. Debe tener permisos de escritura en la carpeta especificada.

   ```
   $ ./awscli-bundle/install -b ~/bin/aws
   ```

   Esto instala la AWS CLI en la ubicación predeterminada (`~/.local/lib/aws`) y crea un enlace simbólico (symlink) en `~/bin/aws`. Asegúrese de que `~/bin` está en la variable de entorno `PATH` para que el enlace simbólico funcione.

   ```
   $ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
   $ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary
   ```

1. Asegúrese de que el directorio de la versión 1 de la AWS CLI sea parte de su variable `PATH`.

   1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

   1. Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.

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

      Este comando inserta la ruta, `~/.local/bin` en este ejemplo, delante de la variable `PATH` existente.

   1. Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.

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

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Desinstale el instalador empaquetado de la versión 1 de la AWS CLI
<a name="install-linux-bundled-uninstall"></a>

1. Si instaló la AWS CLI con el instalador empaquetado, siga estas instrucciones. El instalador empaquetado no añade recursos fuera del directorio de instalación, salvo el symlink opcional. Por tanto, para desinstalar, solo es necesario eliminar esos dos elementos.

   ```
   $ sudo rm -rf /usr/local/aws
   $ sudo rm -rf /usr/local/bin/aws
   ```

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` difiere entre plataformas, d‎e forma predeterminada la carpeta se encuentra en *\$1/.aws/*. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilice `sudo`.

   ```
   $ sudo rm -r ~/.aws/
   ```

## Instale y desinstale la versión 1 de la AWS CLI con pip
<a name="install-linux-pip"></a>

**Topics**
+ [

### Instalar pip
](#install-linux-pip-pip)
+ [

### Instale y actualice la versión 1 de la AWS CLI con pip
](#install-linux-awscli)
+ [

### Desinstalación de la AWS CLI con pip
](#post-install-uninstall)

### Instalar pip
<a name="install-linux-pip-pip"></a>

Si aún no ha instalado `pip`, puede hacerlo con el script proporcionado por *Python Packaging Authority*. Ejecute `pip --version` para saber si su versión de Linux ya incluye Python y `pip`. Si tiene instalada la versión 3 o posterior de Python, recomendamos que utilice el comando `pip3`.

1. Utilice el comando `curl` para descargar el script de instalación. El comando siguiente utiliza el parámetro `-O` (letra "O" mayúscula) para especificar que el archivo descargado debe almacenarse en el directorio actual con el mismo nombre que tiene en el host remoto.

   ```
   $ curl -O https://bootstrap.pypa.io/get-pip.py
   ```

1. Ejecute el script con el comando `python` o `python3` para descargar e instalar la versión más reciente de `pip` y otros paquetes de soporte necesarios. Cuando se incluye el modificador `--user`, el script instala `pip` en la ruta `~/.local/bin`.

   ```
   $ python3 get-pip.py --user
   ```

1. Asegúrese de que el directorio que contiene `pip` forma parte de la variable `PATH`.

   1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

   1. Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.

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

      Este comando inserta la ruta, `~/.local/bin` en este ejemplo, delante de la variable `PATH` existente.

   1. Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.

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

1. Para comprobar que `pip` o `pip3` se ha instalado correctamente, ejecute el siguiente comando.

   ```
   $ pip3 --version
   pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)
   ```

### Instale y actualice la versión 1 de la AWS CLI con pip
<a name="install-linux-awscli"></a>

1. Utilice el comando `pip` o `pip3` para instalar o actualizar la AWS CLI. Si utiliza la versión 3 o posterior de Python, recomendamos que utilice el comando `pip3`. El conmutador`--user`, `pip` instala la AWS CLI en `~/.local/bin`. 

   **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

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

   **Para una versión específica de AWS CLI,** agregue dos signos de igual `=` y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión ‎*1.16.312* sería *==1.16.312* lo que da como resultado el siguiente comando:

   ```
   $ pip3 install awscli==1.16.312 --upgrade --user
   ```
**nota**  
Utilice reglas de entrecomillado adecuadas para el terminal. Para utilizar el carácter `=`, es posible que tenga que usar comillas simples o dobles para aplicar escape correctamente. En el siguiente ejemplo se aplica escape mediante comillas simples:  

   ```
   $ pip3 install 'awscli==1.16.312' --upgrade --user
   ```

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Desinstalación de la AWS CLI con pip
<a name="post-install-uninstall"></a>

1. Si ha instalado la versión 1 de la AWS CLI con `pip`, también la debe desinstalar con `pip`.

   ```
   $ pip uninstall awscli
   ```

    Si utiliza la versión 2 o 3 de Python, es posible que necesite usar el comando `pip2` o `pip3`. Use el comando `aws --version` para determinar la versión de Python asociada a la versión 1 de la AWS CLI instalada.

   ```
   $ pip3 uninstall awscli
   ```

   Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` difiere entre plataformas, d‎e forma predeterminada la carpeta se encuentra en *\$1/.aws/*. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilice `sudo`.

   ```
   $ sudo rm -r ~/.aws/
   ```

## Instalación y desinstalación de la versión 1 de la AWS CLI con Snapcraft
<a name="install-linux-snap"></a>

**Topics**
+ [

### Instalación de snap
](#install-linux-snap-install)
+ [

### Instale y actualice la versión 1 de la AWS CLI con snap
](#install-linux-snap-update)
+ [

### Desinstalación de la AWS CLI con snap
](#install-linux-snap-uninstall)

### Instalación de snap
<a name="install-linux-snap-install"></a>

Si aún no ha instalado `snap`, puede instalarlo siguiendo las instrucciones que se indican en *Canonical Snapcraft*. Ejecute `snap version` para saber si su versión de Linux ya incluye `snap`.

1. Instale Snapcraft en su plataforma. Para obtener información sobre la instalación de Snapcraft, consulte [Installing the daemon](https://snapcraft.io/docs/installing-snapd) en la *documentación de Snap*.

1. Reinicie el sistema para que las variables `PATH` se actualicen correctamente. Si tiene problemas durante la instalación, siga los pasos que se indican en la sección [Fix common issues](https://snapcraft.io/docs/fix-common-issues) de la *documentación de Snap*.

1. Para comprobar que `snap` se haya instalado correctamente, ejecute el siguiente comando.

   ```
   $ snap version
   ```

### Instale y actualice la versión 1 de la AWS CLI con snap
<a name="install-linux-snap-update"></a>

1. Ejecute el siguiente comando `snap install` para la versión 1 de la AWS CLI.

   ```
   $ snap install aws-cli --channel=v1/stable --classic
   ```

   En función de los permisos, es posible que tenga añadir `sudo` al comando.

   ```
   $ sudo snap install aws-cli --channel=v1/stable --classic
   ```

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Desinstalación de la AWS CLI con snap
<a name="install-linux-snap-uninstall"></a>

1. Si ha instalado la versión 1 de la AWS CLI con `snap`, también la debe desinstalar con `snap`.

   ```
   $ snap remove aws-cli
   ```

   Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` difiere entre plataformas, d‎e forma predeterminada la carpeta se encuentra en *\$1/.aws/*. Si su usuario tiene permisos de escritura en este directorio, no es necesario que utilice `sudo`.

   ```
   $ sudo rm -r ~/.aws/
   ```

## Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
<a name="install-linux-path"></a>

Después de realizar la instalación con `pip` o `snap`, es posible que necesite añadir el archivo ejecutable `aws` a la variable de entorno `PATH` del sistema operativo.

Para comprobar en qué carpeta instaló `pip` la AWS CLI, ejecute este comando.

```
$ which aws
/home/username/.local/bin/aws
```

Puede hacer referencia a esto como `~/.local/bin/` ya que `/home/username` se corresponde con `~` en Linux.

Si omitió el modificador `--user` y, por tanto, no realizó la instalación en modo de usuario, el archivo ejecutable podría estar en la carpeta `bin` de la instalación de Python. Si no sabe dónde se ha instalado Python, ejecute este comando.

```
$ which python
/usr/local/bin/python
```

La salida puede ser la ruta a un symlink, no el archivo ejecutable real. Ejecute `ls -al` para ver adónde apunta.

```
$ ls -al /usr/local/bin/python
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
```

`pip` instala los programas en la misma carpeta que contiene la aplicación de Python. Añada esta carpeta a la variable `PATH`.

**Para modificar la variable `PATH`**

1. Busque el script de perfil de su shell en su directorio de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

1. Añada un comando de exportación al script de su perfil.

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

   Este comando añade una ruta, `~/.local/bin` en este ejemplo, a la variable `PATH` actual.

1. Cargue el perfil actualizado en su sesión actual.

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

## Solución de errores de instalación y desinstalación de AWS CLI
<a name="install-linux-tshoot"></a>

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md) los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte [Errores de comando no encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).

# Instalación, actualización y desinstalación de la versión 1 de la AWS CLI en macOS
<a name="install-macos"></a>

Puede instalar la versión 1 de la AWS Command Line Interface (AWS CLI) y sus dependencias en macOS con el instalador incluido o `pip`. 

**Topics**
+ [

## Requisitos previos
](#install-macosos-prereq)
+ [

## Instale, actualice y desinstale la versión 1 de la AWS CLI en macOS mediante el instalador empaquetado
](#install-macosos-bundled)
+ [

## Instale, actualice y desinstale la versión 1 de la AWS CLI con pip
](#awscli-install-osx-pip)
+ [

## Solución de errores de instalación y desinstalación de AWS CLI
](#awscli-install-osx-tshoot)

## Requisitos previos
<a name="install-macosos-prereq"></a>

Antes de instalar la versión 1 de AWS CLI en macOS, asegúrese de tener instalado Python 3.8 o una versión posterior. Para obtener instrucciones de instalación, consulte la página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) en la *Guía para principiantes* de Python.

**Matriz de compatibilidad con versiones de Python**


| AWS CLIVersion de la  | Versión de Python compatible | 
| --- | --- | 
| 1.39.0: actual | Python 3.9\$1 | 
| 1.32.0 – 1.38.38 | Python 3.8\$1 | 
| 1.27.0: 1.31.x | Python 3.7\$1 | 
| 1.20.0 – 1.26.x | Python 3.6\$1 | 
| 1.19.0 – 1.19.x | Python: Python 3.6 y 2.7 | 
| 1.17 – 1.18.x | Python 2.7\$1, Python 3.4\$1 | 
| 1.0 – 1.16.x | Python 2.6 y versiones anteriores, Python 3.3 y versiones anteriores | 

## Instale, actualice y desinstale la versión 1 de la AWS CLI en macOS mediante el instalador empaquetado
<a name="install-macosos-bundled"></a>

En Linux o macOS, puede usar el instalador empaquetado para instalar la versión 1 de la AWS Command Line Interface (AWS CLI). Este incluye todas las dependencias y se puede usar sin conexión.

El instalador empaquetado no admite la instalación en rutas que contienen espacios.

**Topics**
+ [

### Instalación de la versión 1 de la AWS CLI con el instalador incluido con `sudo`
](#install-macosos-bundled-sudo)
+ [

### Instale la versión 1 de la AWS CLI con el instalador empaquetado sin `sudo`
](#install-macosos-bundled-no-sudo)
+ [

### Desinstale el instalador empaquetado de la versión 1 de la AWS CLI
](#install-macosos-bundled-uninstall)

### Instalación de la versión 1 de la AWS CLI con el instalador incluido con `sudo`
<a name="install-macosos-bundled-sudo"></a>

Los pasos que se indican a continuación le permiten instalar la versión 1 de la AWS CLI desde la línea de comandos en cualquier compilación de macOS.

A continuación, se muestra un resumen de los comandos de instalación que puede cortar y pegar para que se ejecuten como un único conjunto de comandos.

**Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```

**Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
```

**Para instalar la versión 1 de la AWS CLI con el instalador empaquetado**

1. Descargue el instalador empaquetado de la versión 1 de la AWS CLI de una de las siguientes maneras:
   + Descárguelo con el comando `curl`.

     **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
     ```

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
     ```
   + Descárguelo mediante el enlace directo.

     **Para obtener la última versión de AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente url [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)

1. Extraiga (descomprima) los archivos del paquete. Si no tiene `unzip`, utilice el administrador de paquetes integrado de la distribución de macOS para instalarlo.

   ```
   $ unzip awscli-bundle.zip
   ```

1. Ejecute el programa de instalación. El instalador instala la AWS CLI en `/usr/local/aws` y crea el enlace simbólico `aws` en la carpeta `/usr/local/bin`. Si se usa la opción `-b` para crear un enlace simbólico, no es necesario especificar la carpeta de instalación en la variable `$PATH` del usuario. Con esto, todos los usuarios deberían poder llamar a la AWS CLI al escribir `aws` desde cualquier directorio.

   ```
   $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
   ```

   El script de instalación se ejecuta en la versión de Python predeterminada del sistema. Si tiene instalada una versión alternativa de Python y quiere usarla para instalar el AWS CLI, ejecute el script de instalación de esa versión utilizando la ruta absoluta del ejecutable de Python, tal y como se muestra a continuación

   ```
   $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
   ```

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Instale la versión 1 de la AWS CLI con el instalador empaquetado sin `sudo`
<a name="install-macosos-bundled-no-sudo"></a>

Si no tiene permisos `sudo` o quiere instalar la AWS CLI solo para el usuario actual, puede utilizar una versión modificada de los comandos anteriores. Los dos primeros comandos son iguales. 

**Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```

**Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

```
$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
./awscli-bundle/install -b ~/bin/aws
```

**Para instalar la versión 1 de la AWS CLI para el usuario actual**

1. Descargue el instalador empaquetado de la versión 1 de la AWS CLI con uno de los métodos siguientes:
   + Descárguelo con el comando `curl`.

     **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
     ```

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente comando:

     ```
     $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
     ```
   + Descárguelo mediante el enlace directo.

     **Para obtener la última versión de AWS CLI:** [https://s3.amazonaws.com/aws-cli/awscli-bundle.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle.zip)

     **Para una versión específica de la AWS CLI,** agregue un guión y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión *1.16.312* sería `awscli-bundle-1.16.312.zip` lo que da como resultado el siguiente url [https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip](https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip)

1. Extraiga los archivos del paquete. Si no tiene `unzip`, utilice el administrador de paquetes integrado de la distribución de Linux para instalarlo.

   ```
   $ unzip awscli-bundle.zip
   ```

1. Ejecute el programa de instalación. El instalador instala la AWS CLI en `/usr/local/aws` y crea el symlink `aws` en el directorio `/usr/local/bin`. El comando utiliza el parámetro `-b` para especificar el directorio en el que el instalador coloca el archivo del enlace simbólico de `aws`. Debe tener permisos de escritura en el directorio especificado.

   ```
   $ ./awscli-bundle/install -b ~/bin/aws
   ```

   Esto instala la AWS CLI en la ubicación predeterminada (`~/.local/lib/aws`) y crea un enlace simbólico (symlink) en `~/bin/aws`. Asegúrese de que `~/bin` está en la variable de entorno `$PATH` para que el enlace simbólico funcione.

   ```
   $ echo $PATH | grep ~/bin     // See if $PATH contains ~/bin (output will be empty if it doesn't)
   $ export PATH=~/bin:$PATH     // Add ~/bin to $PATH if necessary
   ```

1. Asegúrese de que la carpeta en la que está instalada la versión 1 de la AWS CLI forma parte de la variable `$PATH`.

   1. Busque el script de perfil de su shell en su carpeta de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

   1. Añada un comando de exportación al final del script de su perfil igual que en el siguiente ejemplo.

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

      Este comando inserta la ruta, `~/.local/bin` en este ejemplo, delante de la variable `PATH` existente.

   1. Vuelva a cargar el perfil en la sesión actual para que esos cambios surtan efecto.

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

1. Compruebe que AWS CLI se ha instalado correctamente.

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

   Si obtiene un error, consulte [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md).

### Desinstale el instalador empaquetado de la versión 1 de la AWS CLI
<a name="install-macosos-bundled-uninstall"></a>

1. El instalador incluido coloca todo en el directorio de instalación excepto el enlace simbólico opcional, por lo que, para efectuar la desinstalación, solo necesita eliminar esos dos elementos.

   ```
   $ sudo rm -rf /usr/local/aws
   $ sudo rm /usr/local/bin/aws
   ```

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` difiere entre plataformas, d‎e forma predeterminada la carpeta se encuentra en *\$1/.aws/*. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilice `sudo`.

   ```
   $ sudo rm ~/.aws/
   ```

## Instale, actualice y desinstale la versión 1 de la AWS CLI con pip
<a name="awscli-install-osx-pip"></a>

Puede utilizar `pip` directamente para instalar la AWS CLI. 

**Topics**
+ [

### Instalar pip
](#awscli-install-osx-pip-pip)
+ [

### Instalación y actualización de la AWS CLI con pip
](#awscli-install-osx-pip-install)
+ [

### Agregue la versión 1 ejecutable de la AWS CLI a la ruta de la línea de comandos de macOS
](#awscli-install-osx-path)
+ [

### Desinstalación de la AWS CLI con pip
](#awscli-install-osx-pip-uninstall)

### Instalar pip
<a name="awscli-install-osx-pip-pip"></a>

Si aún no ha instalado `pip`, puede hacerlo con el script proporcionado por *Python Packaging Authority*. Ejecute `pip --version` para saber si su versión de Linux ya incluye Python y `pip`. Si tiene instalada la versión 3 o posterior de Python, recomendamos que utilice el comando `pip3`.

1. Utilice el comando `curl` para descargar el script de instalación. El comando siguiente utiliza el parámetro `-O` (letra «O» mayúscula) para especificar que el archivo descargado debe almacenarse en la carpeta actual con el mismo nombre que tiene en el host remoto.

   ```
   $ curl -O https://bootstrap.pypa.io/get-pip.py
   ```

1. Ejecute el script con el comando `python` o `python3` para descargar e instalar la versión más reciente de `pip` y otros paquetes de soporte necesarios. Cuando se incluye el modificador `--user`, el script instala `pip` en la ruta `~/.local/bin`.

   ```
   $ python3 get-pip.py --user
   ```

### Instalación y actualización de la AWS CLI con pip
<a name="awscli-install-osx-pip-install"></a>

1. Utilice el comando `pip` o `pip3` para instalar la AWS CLI. Si utiliza la versión 3 o posterior de Python, recomendamos que utilice el comando `pip3`.

   **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

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

   **Para una versión específica de AWS CLI,** agregue dos signos de igual `=` y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión ‎*1.16.312* sería *==1.16.312* lo que da como resultado el siguiente comando:

   ```
   $ pip3 install awscli==1.16.312 --upgrade --user
   ```
**nota**  
Utilice reglas de entrecomillado adecuadas para el terminal. Para utilizar el carácter `=`, es posible que tenga que usar comillas simples o dobles para aplicar escape correctamente. En el siguiente ejemplo se aplica escape mediante comillas simples:  

   ```
   $ pip3 install 'awscli==1.16.312' --upgrade --user
   ```

1. Compruebe que la AWS CLI esté instalada correctamente.

   ```
   $ aws --version
   aws-cli/1.40.41 Python/3.11.6 Darwin/23.3.0 botocore/1.18.6
   ```

   Si no se encuentra el programa, [añádalo a la ruta de la línea de comandos](#awscli-install-osx-path).

### Agregue la versión 1 ejecutable de la AWS CLI a la ruta de la línea de comandos de macOS
<a name="awscli-install-osx-path"></a>

Después de realizar la instalación con `pip`, es posible que necesite añadir el programa `aws` a la variable de entorno `PATH` del sistema operativo. La ubicación del programa depende de dónde se haya instalado Python.

**Example Ubicación de instalación de la AWS CLI: macOS con Python 3.6 y `pip` (modo usuario)**  

```
~/Library/Python/3.7/bin
```
Sustituya la versión de Python que tiene con la versión del ejemplo anterior.

Si no sabe dónde se ha instalado Python, ejecute `which python`.

```
$ which python
/usr/local/bin/python
```

La salida puede ser la ruta a un symlink, no el programa real. Ejecute `ls -al` para ver adónde apunta.

```
$ ls -al /usr/local/bin/python
~/Library/Python/3.7/bin/python3.7
```

`pip` instala los programas en la misma carpeta que contiene la aplicación de Python. Añada esta carpeta a la variable `PATH`.

**Para modificar la variable `PATH`**

1. Busque el script de perfil de su shell en su directorio de usuario. Si no está seguro de cuál es el shell que tiene, ejecute `echo $SHELL`.

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

1. Añada un comando de exportación al script de su perfil.

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

   Este comando añade una ruta, `~/.local/bin` en este ejemplo, a la variable `PATH` actual.

1. Cargue el perfil actualizado en su sesión actual.

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

### Desinstalación de la AWS CLI con pip
<a name="awscli-install-osx-pip-uninstall"></a>

1. Si ha instalado la versión 1 de la AWS CLI con `pip`, también la debe desinstalar con `pip`.

   ```
   $ pip uninstall awscli
   ```

    Si utiliza la versión 2 o 3 de Python, es posible que necesite usar el comando `pip2` o `pip3`. Use el comando `aws --version` para determinar la versión de Python asociada a la versión 1 de la AWS CLI instalada.

   ```
   $ pip3 uninstall awscli
   ```

   Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` difiere entre plataformas, d‎e forma predeterminada la carpeta se encuentra en *\$1/.aws/*. Si su usuario tiene permiso de escritura en este directorio, no es necesario que utilice `sudo`.

   ```
   $ sudo rm -rf ~/.aws/
   ```

## Solución de errores de instalación y desinstalación de AWS CLI
<a name="awscli-install-osx-tshoot"></a>

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md) los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte [Errores de comando no encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).

# Instalación, actualización y desinstalación de la versión 1 de la AWS CLI en Windows
<a name="install-windows"></a>

Puede instalar la versión 1 de la AWS Command Line Interface (AWS CLI) en Windows con un instalador independiente (recomendado) o con `pip`, un administrador de paquetes para Python.

No incluya el símbolo de comando (`C:\>`) al escribir un comando. Estos símbolos se incluyen en los listados del programa para diferenciar los comandos introducidos de los que devuelve la AWS CLI. En el resto de esta guía se utiliza el símbolo del sistema genérico (`$`) excepto en los casos en los que un comando es específico de Windows.

**Topics**
+ [

## Instale, actualice y desinstale la versión 1 de la AWS CLI con el instalador MSI
](#msi-on-windows)
+ [

## Instale, actualice y desinstale la versión 1 de la AWS CLI con Python y pip en Windows
](#awscli-install-windows-pip)
+ [

## Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
](#awscli-install-windows-path)
+ [

## Solución de errores de instalación y desinstalación de AWS CLI
](#awscli-install-windows-tshoot)

## Instale, actualice y desinstale la versión 1 de la AWS CLI con el instalador MSI
<a name="msi-on-windows"></a>

La versión 1 de la AWS CLI es compatible con Windows XP o versiones posteriores. Para los usuarios de Windows, el paquete de instalación de MSI ofrece un entorno familiar y cómodo para instalar la versión 1 de la AWS CLI sin necesidad de instalar ningún otro requisito previo. 

### Instale y actualice la versión 1 de la AWS CLI con el instalador MSI
<a name="install-msi-on-windows"></a>

Consulte la página de [Versiones](https://github.com/aws/aws-cli/releases) en GitHub para ver si se ha publicado una versión más reciente. Cuando se hayan publicado las actualizaciones, deberá repetir el proceso de instalación para obtener la última versión de la versión 1 de la AWS CLI. 

1. Descargue el instalador MSI adecuado:
   + Instalador MSI de la AWS CLI para Windows (64 bits): [ https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
   + Instalador MSI de la AWS CLI para Windows (32 bits): [https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
   + Archivo de instalación combinado de la AWS CLI para Windows: [https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) (incluye los instaladores MSI de 32 y 64 bits, e instalará automáticamente la versión correcta)

1. Ejecute el instalador MSI descargado o el archivo de configuración.

1. Siga las instrucciones en pantalla. De forma predeterminada, la versión 1 de la AWS CLI se instala en `C:\Program Files\Amazon\AWSCLI` (versión de 64 bits) o `C:\Program Files (x86)\Amazon\AWSCLI` (versión de 32 bits). 

1. Para confirmar la instalación, utilice el comando `aws --version` en un símbolo del sistema (abra el menú **Inicio** y busque `cmd` para iniciar un símbolo del sistema).

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

   Si Windows no puede encontrar el programa, es posible que tenga que cerrar y volver a abrir el símbolo del sistema para actualizar la ruta o [añadir el directorio de instalación a la variable de entorno PATH](#awscli-install-windows-path) manualmente.

### Desinstale la versión 1 de la AWS CLI
<a name="install-msi-uninstall"></a>

Para utilizar las siguientes instrucciones de desinstalación, debe haber instalado la versión 1 de la AWS CLI con el instalador MSI o el archivo de instalación.

1. Abra **Programas y características** mediante una de las siguientes acciones:
   + Abra el **Panel de control** y elija **Programas y características**.
   + Abra un símbolo del sistema y escriba el comando siguiente.

     ```
     C:\> appwiz.cpl
     ```

1. Seleccione la entrada denominada **AWS Command Line Interface** y elija **Desinstalar** para iniciar el desinstalador.

1. Confirma que deseas desinstalar la AWS CLI.

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` ‎difiere entre plataformas, de forma predeterminada la carpeta se encuentra en *%UserProfile%\$1.aws*.

   ```
   $ rmdir %UserProfile%\.aws
   ```

## Instale, actualice y desinstale la versión 1 de la AWS CLI con Python y pip en Windows
<a name="awscli-install-windows-pip"></a>

La Python Software Foundation ofrece instaladores para Windows que incluyen `pip`.

### Requisitos previos
<a name="awscli-install-windows-pip-prereqs"></a>

Debe tener ‎instalado Python 3.8 o una versión posterior. Para obtener instrucciones de instalación, consulte la página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) en la *Guía para principiantes* de Python.

### Instale y actualice la versión 1 de la AWS CLI con pip
<a name="awscli-install-windows-pip-python"></a>

1. Para instalar la versión 1 de la AWS CLI, utilice el comando `pip3` (si utiliza Python versión 3 o posterior) o el comando `pip`.

   **Para instalar la última versión del AWS CLI, ** utilice el siguiente bloque de comandos:

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

   **Para una versión específica de la AWS CLI,** agregue un símbolo menor que `<` y el número de versión al nombre del archivo. Para este ejemplo, el nombre de archivo de la versión*1.16.312* sería *<1.16.312* lo que da como resultado el siguiente comando:

   ```
   C:\> pip3 install awscli<1.16.312 --upgrade --user
   ```

1. Verifique que la versión 1 de la AWS CLI esté instalada correctamente. Si no hay respuesta, consulte la sección [Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos](#awscli-install-windows-path).

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

### Desinstalación de la versión 1 de la AWS CLI con pip
<a name="awscli-install-windows-pip-uninstall"></a>

1. Si ha instalado la versión 1 de la AWS CLI con `pip`, también la debe desinstalar con `pip`.

   ```
   C:\> pip uninstall awscli
   ```

    Si utiliza la versión 2 o 3 de Python, es posible que necesite usar el comando `pip2` o `pip3`. Use el comando `aws --version` para determinar la versión de Python asociada a la versión 1 de la AWS CLI instalada.

   ```
   C:\> pip3 uninstall awscli
   ```

   Es posible que deba reiniciar la ventana del símbolo del sistema o el equipo para eliminar todos los archivos.

1. **(Opcional)** Elimine el SDK de AWS compartido e información de configuración de AWS CLI en la carpeta `.aws`.
**aviso**  
Estos ajustes de configuración y credenciales se comparten en todos los SDK de AWS y AWS CLI. Si elimina esta carpeta, ningún SDK de AWS que todavía sigue en el sistema podrá acceder a ella.

   La ubicación predeterminada de la carpeta `.aws` ‎difiere entre plataformas, de forma predeterminada la carpeta se encuentra en *%UserProfile%\$1.aws*.

   ```
   $ rmdir %UserProfile%\.aws
   ```

## Agregue la versión 1 de la AWS CLI ejecutable a la ruta de la línea de comandos
<a name="awscli-install-windows-path"></a>

Después de instalar la versión 1 de la AWS CLI con `pip`, agregue el programa `aws` a la variable de entorno `PATH` del sistema operativo. Con una instalación MSI, esto debería suceder automáticamente. Pero si el comando `aws` no se ejecuta después de instalarlo, es posible que deba configurarlo manualmente.

1. Utilice el comando `where` para buscar la ubicación del archivo `aws`. De forma predeterminada, el comando `where` muestra dónde se encuentra un programa especificado en la variable `PATH` del sistema. 

   ```
   C:\> where aws
   ```

   Las rutas que aparecen dependen de la plataforma y del método utilizado para instalar la AWS CLI. Los nombres de carpeta que incluyen los números de versión puede variar. Estos ejemplos reflejan el uso de Python versión 3.7. Reemplace la versión por el número de versión que está utilizando, según sea necesario. Las rutas típicas son las siguientes:
   + **Python 3 y `pip3`** – `C:\Program Files\Python37\Scripts\`
   + **Python 3 y `pip3`: opción de usuario en versiones anteriores de Windows**`%USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts`
   + **Python 3 y `pip3`, opción de usuario en 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`

   Siga estos pasos en función de si se devuelve una ruta de archivo.

------
#### [ A file path is returned ]

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

   Para encontrar dónde está instalado el programa de `aws`, ejecute el siguiente comando.

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

------
#### [ A file path is NOT returned ]

   Si el comando `where` devuelve el siguiente error, no está en la variable `PATH` del sistema y no puede ejecutarse simplemente escribiendo su nombre.

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

   En ese caso, ejecute el comando `where` con el parámetro `/R path` para indicarle que busque en todas las carpetas y agregue después la ruta manualmente. Utilice la línea de comandos o el Explorador de archivos para averiguar en qué lugar del equipo está instalado. 

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

------

1. Pulse la tecla de Windows y escriba **environment variables**.

1. Elija **Edit environment variables for your account (Edición de las variables de entorno de esta cuenta)**.

1. Elija **PATH** y, a continuación, **Edit (Edición de)**.

1. Agregue la ruta que encontró en el campo **Valor de variable** por ejemplo, ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***.

1. Elija **OK (Aceptar)** dos veces para aplicar la nueva configuración.

1. Cierre los símbolos del sistema en ejecución y vuelva a abrir la ventana de símbolo del sistema.

## Solución de errores de instalación y desinstalación de AWS CLI
<a name="awscli-install-windows-tshoot"></a>

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md) los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte [Errores de comando no encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).

# Instalación y actualización de la versión 1 de la AWS CLI en un entorno virtual
<a name="install-virtualenv"></a>

Puede evitar conflictos de versiones con otros paquetes `pip` instalando la versión 1 de la AWS Command Line Interface (AWS CLI) en un entorno virtual.

**Topics**
+ [

## Requisitos previos
](#install-virtualenv-prereqs)
+ [

## Instale y actualice la versión 1 de la AWS CLI en un entorno virtual
](#install-virtualenv-install)
+ [

## Solución de errores de instalación y desinstalación de AWS CLI
](#install-virtualenv-tshoot)

## Requisitos previos
<a name="install-virtualenv-prereqs"></a>
+ Python 3.8 o versiones posteriores. Para obtener instrucciones de instalación, consulte la página [Downloading Python](https://wiki.python.org/moin/BeginnersGuide/Download) en la *Guía para principiantes* de Python.

  **Matriz de compatibilidad con versiones de Python**    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cli/v1/userguide/install-virtualenv.html)
+ Se ha instalado `pip` o `pip3`.

## Instale y actualice la versión 1 de la AWS CLI en un entorno virtual
<a name="install-virtualenv-install"></a>

1. Instale `virtualenv` mediante `pip`.

   ```
   $ pip install --user virtualenv
   ```

1. Cree un entorno virtual y asígnele un nombre.

   ```
   $ virtualenv ~/cli-ve
   ```

   También puede utilizar la opción `-p` para especificar una versión de Python distinta de la predeterminada.

   ```
   $ virtualenv -p /usr/bin/python37 ~/cli-ve
   ```

1. Active el entorno virtual nuevo.

   **Linux o macOS**

   ```
   $ source ~/cli-ve/bin/activate
   ```

   **Windows**

   ```
   $ %USERPROFILE%\cli-ve\Scripts\activate
   ```

   El símbolo del sistema cambia para mostrar que el entorno virtual está activo.

   ```
   (cli-ve)~$
   ```

1. Instale o actualice la versión 1 de la AWS CLI en su entorno virtual.

   ```
   (cli-ve)~$ pip install --upgrade awscli
   ```

1. Verifique que la versión 1 de la AWS CLI esté instalada correctamente.

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

1. Puedes utilizar el comando `deactivate` para salir del entorno virtual. Siempre que inicies una sesión nueva, debes activar el entorno de nuevo.

## Solución de errores de instalación y desinstalación de AWS CLI
<a name="install-virtualenv-tshoot"></a>

Si se encuentra con problemas después de instalar o desinstalar la AWS CLI, consulte en [Solución de errores para la AWS CLI](cli-chap-troubleshooting.md) los pasos para la solución de problemas. Para conocer los pasos más relevantes de la solución de problemas, consulte [Errores de comando no encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [El comando "`aws --version`" devuelve una versión diferente a la instalada](cli-chap-troubleshooting.md#tshoot-install-wrong-version) y [El comando "`aws --version`" devuelve una versión después de desinstalar la AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).