aws cli
1.0.0
Este paquete proporciona una interfaz de línea de comandos unificada para Amazon Web Services.
Saltar a:
Este archivo README es para la versión 1 de AWS CLI. Si busca información sobre la versión 2 de AWS CLI, visite la rama v2.
El paquete aws-cli funciona en versiones de Python:
El 30 de mayo de 2022, finalizó el soporte para Python 3.6. Esto se produce tras el fin del soporte de Python Software Foundation para el tiempo de ejecución que se produjo el 23 de diciembre de 2021.
El 13 de diciembre de 2023, finalizó el soporte para Python 3.7. Esto se produce tras el fin del soporte de Python Software Foundation para el tiempo de ejecución que se produjo el 27 de junio de 2023. Para obtener más información, consulte esta publicación de blog.
¡Atención!
Recomendamos que todos los clientes supervisen periódicamente el sitio web de boletines de seguridad de Amazon Web Services para detectar boletines de seguridad importantes relacionados con aws-cli.
La versión 1 de AWS CLI estuvo disponible de forma general el 02/09/2013 y actualmente se encuentra en la fase de soporte completo del ciclo de vida de disponibilidad.
Para obtener información sobre el mantenimiento y la compatibilidad con las versiones principales del SDK y sus dependencias subyacentes, consulte la sección Política de mantenimiento en la Guía de referencia de credenciales y configuración compartida de SDK y herramientas de AWS .
La instalación de AWS CLI y sus dependencias utiliza una variedad de funciones de empaquetado proporcionadas por pip y setuptools . Para garantizar una instalación sin problemas, se recomienda utilizar:
pip : 9.0.2 o superiorsetuptools : 36.2.0 o superior La forma más segura de instalar AWS CLI es utilizar pip en un virtualenv :
$ python -m pip instalar awscli
o, si no está instalando en un virtualenv , para instalar globalmente:
$ sudo python -m pip instalar awscli
o para su usuario:
$ python -m pip instalar --usuario awscli
Si tiene instalado el paquete aws-cli y desea actualizar a la última versión, puede ejecutar:
$ python -m pip instalar --actualizar awscli
Esto instalará el paquete aws-cli así como todas las dependencias.
Nota
En macOS, si ve un error con respecto a la versión six que vino con distutils en El Capitan, use la opción --ignore-installed :
$ sudo python -m pip install awscli --ignore-instalado seis
En Linux y Mac OS, la CLI de AWS se puede instalar mediante un instalador incluido. La AWS CLI también se puede instalar en Windows mediante un instalador MSI.
Si desea ejecutar la rama develop de AWS CLI, consulte la sección Versión de desarrollo de la guía de contribución.
Consulte la sección de instalación de la Guía del usuario de AWS CLI para obtener más información.
Antes de utilizar la CLI de AWS, debe configurar sus credenciales de AWS. Puedes hacer esto de varias maneras:
La forma más rápida de comenzar es ejecutar el comando aws configure :
$aws configurar ID de clave de acceso de AWS: MYACCESSKEY Clave de acceso secreta de AWS: MYSECRETKEY Nombre de región predeterminado [us-west-2]: us-west-2 Formato de salida predeterminado [Ninguno]: json
Para utilizar variables de entorno, haga lo siguiente:
$ exportar AWS_ACCESS_KEY_ID=<clave_acceso> $ exportar AWS_SECRET_ACCESS_KEY=<clave_secreta>
Para utilizar el archivo de credenciales compartido, cree un archivo con formato INI como este:
[por defecto] aws_access_key_id=MICLAVE DE ACCESO aws_secret_access_key=MYSECRETKEY [pruebas] aws_access_key_id=MICLAVE DE ACCESO aws_secret_access_key=MYSECRETKEY
y colóquelo en ~/.aws/credentials (o en %UserProfile%.aws/credentials en Windows). Si desea colocar el archivo de credenciales compartidas en una ubicación diferente a la especificada anteriormente, debe indicarle a aws-cli dónde encontrarlo. Haga esto configurando la variable de entorno adecuada:
$ exportar AWS_SHARED_CREDENTIALS_FILE=/ruta/al/archivo_credenciales_compartido
Para usar un archivo de configuración, cree un archivo con formato INI como este:
[por defecto] aws_access_key_id=<clave de acceso predeterminada> aws_secret_access_key=<clave secreta predeterminada> # Opcional, para definir la región predeterminada para este perfil. región=nosotros-oeste-1 [prueba de perfil] aws_access_key_id=<clave de acceso de prueba> aws_secret_access_key=<clave secreta de prueba> región=nosotros-oeste-2
y colóquelo en ~/.aws/config (o en %UserProfile%.awsconfig en Windows). Si desea colocar el archivo de configuración en una ubicación diferente a la especificada anteriormente, debe indicarle a la CLI de AWS dónde encontrarlo. Haga esto configurando la variable de entorno adecuada:
$ exportar AWS_CONFIG_FILE=/ruta/al/archivo_config
Como puede ver, puede tener varios profiles definidos tanto en el archivo de credenciales compartidas como en el archivo de configuración. Luego puede especificar qué perfil usar usando la opción --profile . Si no se especifica ningún perfil, se utiliza el perfil default .
En el archivo de configuración, excepto el perfil predeterminado, debe prefijar cada sección de configuración de un grupo de perfiles con profile . Por ejemplo, si tiene un perfil llamado "pruebas", el encabezado de la sección sería [profile testing] .
Se recomienda encarecidamente la última opción para las credenciales si utiliza la CLI de AWS en una instancia EC2. Los roles de IAM son una excelente manera de instalar credenciales automáticamente en su instancia. Si utiliza roles de IAM, la CLI de AWS los encontrará y utilizará automáticamente.
Además de las credenciales, se pueden configurar otras variables con variables de entorno, entradas del archivo de configuración o ambas. Consulte la Guía de referencia de credenciales y configuración compartida de herramientas y SDK de AWS para obtener más información.
Para obtener más información sobre las opciones de configuración, consulte el tema Variables de configuración de AWS CLI. También puede acceder a este tema desde la AWS CLI ejecutando aws help config-vars .
Un comando de AWS CLI tiene la siguiente estructura:
$ aws <comando> <subcomando> [opciones y parámetros]
Por ejemplo, para enumerar los depósitos de S3, el comando sería:
$ aws s3 ls
Para ver la documentación de ayuda, utilice uno de los siguientes:
$aws ayuda $ aws <comando> ayuda $ aws <comando> <subcomando> ayuda
Para obtener la versión de AWS CLI:
$ aws --versión
Para activar la salida de depuración:
$ aws --debug <comando> <subcomando>
Puede leer más información en el capítulo Uso de AWS CLI de la Guía del usuario de AWS CLI.
El paquete aws-cli incluye una función de finalización de comandos para sistemas tipo Unix. Esta función no se instala automáticamente, por lo que deberá configurarla manualmente. Para obtener más información, lea el tema sobre finalización del comando AWS CLI.
La mejor manera de interactuar con nuestro equipo es a través de GitHub. Puede abrir un problema y elegir una de nuestras plantillas para obtener orientación, informes de errores o solicitudes de funciones.
Puede encontrar ayuda en la comunidad en Stack Overflow con la etiqueta aws-cli o en el foro de discusión de AWS para CLI. Si tiene un plan de soporte con AWS Support, también puede crear un nuevo caso de soporte.
Verifique si hay problemas similares abiertos antes de abrir otro.
La AWS CLI implementa las API de servicios de AWS. Para cuestiones generales relacionadas con los servicios o sus limitaciones, puede que le resulten útiles los foros de discusión de servicios web de Amazon.
