

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

# ¿Cuál es la versión 1 de AWS Command Line Interface?
<a name="cli-chap-welcome"></a>

**nota**  
La versión 1 de AWS CLI no es la versión más reciente de AWS CLI. ‎Algunas características introducidas en la versión 2 de AWS CLI no son compatibles con la versión 1 y debe realizar una actualización para acceder a esas características. Existen algunos cambios notorios en la versión 1 que pueden requerir que se modifiquen los scripts. Para obtener una lista de los cambios notorios de la versión 2, consulte [Cambios notorios](https://docs.aws.amazon.com/cli/latest/userguide/cliv2-migration.html) en la *versión 2 de la guía del usuario de AWS CLI*.

La AWS Command Line Interface (AWS CLI) es una herramienta de código abierto que le permite interactuar con los servicios de AWS mediante el uso de comandos en el intérprete de comandos de la línea de comandos. Con una configuración mínima, la AWS CLI le permite comenzar a utilizar comandos de ejecución que implementen una funcionalidad equivalente a la que ofrece la Consola de administración de AWS basada en navegador desde el símbolo del sistema del programa de terminal:
+ **Shells de Linux**: utilice programas de shell comunes, tales como [https://www.gnu.org/software/bash/](https://www.gnu.org/software/bash/), [http://www.zsh.org/](http://www.zsh.org/) y [https://www.tcsh.org/](https://www.tcsh.org/), para ejecutar comandos en Linux o macOS.
+ **Línea de comandos de Windows**: en Windows, ejecute comandos en símbolo del programa de Windows o en PowerShell.
+ **De forma remota**: ejecute comandos en las instancias de Amazon Elastic Compute Cloud (Amazon EC2) a través de un programa de terminal remoto, como PuTTY o SSH, o con AWS Systems Manager.

Todas las funciones de administración, gestión y acceso de IaaS (infraestructura como servicio) de AWS de la Consola de administración de AWS están disponibles en la AWS API y la AWS CLI. Las nuevas funcionalidades y servicios de IaaS de AWS proporcionan la funcionalidad completa de la Consola de administración de AWS a través de la API y de la CLI en el momento del lanzamiento o en el plazo de 180 días del lanzamiento. 

La AWS CLI proporciona acceso directo a las API públicas de los servicios de AWS. Puede explorar las capacidades de un servicio con la AWS CLI y desarrollar scripts de shell para administrar los recursos. Además de los comandos equivalentes de la API de bajo nivel, varios servicios de AWS ofrecen personalizaciones para la AWS CLI. Las personalizaciones pueden incluir comandos de un nivel superior que simplifican el uso de un servicio con una API compleja.

## Acerca de la versión 1 de AWS CLI
<a name="welcome-versions-v1"></a>

La versión 1 de la AWS CLI es la AWS CLI original y seguimos ofreciendo soporte. Sin embargo, es posible que las principales nuevas características presentadas en la versión 2 de AWS CLI no puedan adaptarse a la versión 1 de AWS CLI. Para utilizar estas características, debe instalar la versión 2 de la AWS CLI. 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.

Para instalar la versión 1 de la AWS CLI, consulte [Instalar, actualizar y desinstalar la AWS CLI](cli-chap-install.md).

Para comprobar la versión instalada actualmente, utilice 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
```

Para ver el historial de versiones, consulte el [Registro de cambios de versión 1 de la AWS CLI](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst) en *GitHub*.

## Mantenimiento y compatibilidad de las versiones principales del SDK
<a name="sdks-major-versions-maintenance-support"></a>

Para obtener información sobre el mantenimiento y la compatibilidad con las principales versiones del SDK y sus dependencias subyacentes, consulte lo siguiente en la [Guía de referencia de las herramientas y los SDK de AWS](https://docs.aws.amazon.com/sdkref/latest/guide/overview.html):
+ [AWS Política de mantenimiento de SDK y herramientas de AWS](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html)
+ [AWS Matriz de compatibilidad para versiones de las herramientas y los SDK de](https://docs.aws.amazon.com/sdkref/latest/guide/version-support-matrix.html)

## Acerca de Amazon Web Services
<a name="about-aws"></a>

Amazon Web Services (AWS) es una colección de servicios de infraestructura digital que los desarrolladores pueden usar cuando desarrollan sus aplicaciones. Estos servicios incluyen recursos informáticos, almacenamiento, bases de datos y sincronización de aplicaciones (mensajería y colas). AWS usa un modelo de servicio de pago por uso. Solo se le cobrará por los servicios que usted, o sus aplicaciones, utilicen. Asimismo, para que AWS sea más accesible como plataforma para prototipos y experimentos, AWS ofrece un nivel de uso gratuito. En esta capa, los servicios son gratuitos por debajo de determinado nivel de uso. Para obtener más información sobre los costes de AWS y la capa gratuita, consulte [Uso de la capa gratuita de AWS](https://aws.amazon.com/free/). Para obtener una cuenta de AWS, consulte la [página de inicio de AWS](https://aws.amazon.com/) y elija **Crear una cuenta de AWS**.

# Acerca de los ejemplos de la Guía del usuario de la AWS CLI
<a name="welcome-examples"></a>

Los ejemplos de la AWS Command Line Interface (AWS CLI) que aparecen en esta guía se formatean con las siguientes convenciones:
+ **Símbolo**: el símbolo del sistema utiliza el símbolo de Linux y se muestra como (`$ `). En los comandos específicos de Windows, `C:\>` se utiliza como símbolo del sistema. No incluya el símbolo al escribir comandos. 
+ **Directorio**: cuando los comandos se deben ejecutar desde un directorio específico, el nombre del directorio se muestra antes del símbolo de comando.
+ **Entrada del usuario**: el texto del comando que se debe ingresar en la línea de comando se formatea como **user input**.
+ **Texto reemplazable**: el texto variable, incluidos los nombres de los recursos que usted elija o los ID generados por los servicios de AWS que deba incluir en los comandos, se formatea como *texto reemplazable*. En comandos de varias líneas o comandos en los que se requiere una entrada específica desde el teclado, los comandos de teclado también se pueden mostrar como texto reemplazable.
+ **Salida**: la salida devuelta por los servicios de AWS se muestra bajo la entrada del usuario, y se formatea como `computer output`.

El siguiente ejemplo de comando **aws configure** demuestra la entrada del usuario, el texto reemplazable, y la salida:

1. Escriba **aws configure** en la línea de comandos y luego presione **INTRO**.

1. La AWS CLI devuelve líneas de texto, solicitándole que introduzca información adicional.

1. Introduzca cada una de sus claves de acceso y después pulse **Intro**.

1. A continuación, especifique el nombre de una región de AWS en el formato que se muestra y pulse **Intro**. Después, vuelva a pulsar **Intro** para omitir la configuración del formato de salida.

1. El comando **Intro** final se muestra como texto reemplazable porque no hay entrada del usuario para esa línea.

   ```
   $ aws configure
   AWS Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: us-west-2
   Default output format [None]: ENTER
   ```

El siguiente ejemplo muestra un comando simple con salida. Para usar este ejemplo, introduzca el texto completo del comando (el texto resaltado después del símbolo del sistema) y pulse **Intro**. El nombre del grupo de seguridad, *`my-sg`*, se puede sustituir por el nombre del grupo de seguridad deseado. El documento JSON, incluidas las llaves, produce una salida. Si configura la CLI para producir la salida en formado de texto o tabla, se aplicará un formato diferente a la misma. [JSON](https://json.org) es el formato de salida predeterminado.

```
$ aws ec2 create-security-group --group-name my-sg --description "My security group"
{
    "GroupId": "sg-903004f8"
}
```

# Documentación y recursos adicionales para la AWS CLI
<a name="welcome-resources"></a>

## AWS CLIDocumentación y recursos de
<a name="welcome-resources-cli"></a>

Además de esta guía del usuario, estos son algunos otros recursos en línea útiles al utilizar la AWS CLI.
+ [AWS CLI Guía de referencia de la versión 1 de la](https://docs.aws.amazon.com/cli/v1/reference/)
+ [Repositorio de ejemplos de código de scripting en bash de la AWS CLI](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli). Abra los ejemplos de script bash de código abierto. Los ejemplos de script bash están alojados en el [Repositorio de ejemplos de código de AWS](https://github.com/awsdocs/aws-doc-sdk-examples) en *GitHub*.
+ [Repositorio GitHub de la AWS CLI](https://github.com/aws/aws-cli) Puede ver y adaptar el código fuente de la AWS CLI en *GitHub*. Únase a la comunidad de usuarios de *GitHub* para hacernos llegar sus comentarios, solicitar características y realizar aportaciones. Esto también incluye ver y proporcionar ejemplos de comandos para la documentación de la AWS CLI.
+ [Repositorio de ejemplos de alias de la AWS CLI](https://github.com/awslabs/awscli-aliases) Puede ver y adaptar ejemplos de alias de la AWS CLI en *GitHub*.
+ [AWS CLI Registro de cambios de versión 1 de la](https://github.com/aws/aws-cli/blob/develop/CHANGELOG.rst)
+ <a name="latest-guide"></a>[AWS CLI Registro de cambios de versión 2 de la](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1)

## Otros AWS SDK y herramientas
<a name="welcome-resources-sdk"></a>

En función de su caso de uso, es posible que desee elegir uno de los AWS SDK o herramientas según sus necesidades:
+ [AWS Guía de referencia de herramientas y SDK](https://docs.aws.amazon.com/sdkref/latest/guide/)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/sdk-for-cpp)
+ [AWS SDK para Go](https://docs.aws.amazon.com/sdk-for-go/api/)
+ [AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
+ [AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/latest/developer-guide/)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin)
+ [AWS SDK para .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/)
+ [AWS SDK para Python (Boto)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)
+ [AWS SDK para PHP](https://docs.aws.amazon.com/sdk-for-php/latest/developer-guide/)
+ [Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/)
+ [AWS SDK para Ruby](https://docs.aws.amazon.com/sdk-for-ruby/latest/developer-guide/)
+ [AWS SDK para Rust](https://docs.aws.amazon.com/sdk-for-rust)
+ [AWS SDK para SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap)
+ [AWS SDK para Swift](https://docs.aws.amazon.com/sdk-for-swift)
+ [AWS Amplify](https://docs.amplify.aws/swift/)