Estructura de comandos en la AWS CLI - AWS Command Line Interface

Python 2.7, 3.4 y 3.5 están obsoletas para la versión 1 de AWS CLI. Para obtener más información, consulte la sección de la versión 1 de AWS CLI de Acerca de las versiones de AWS CLI.

Estructura de comandos en la AWS CLI

En este tema se abordan cómo está estructurado el comando de la AWS Command Line Interface (AWS CLI) y cómo usar comandos de espera.

Estructura de comandos

La AWS CLI utiliza una estructura de multiparte en la línea de comandos que deben especificarse en el siguiente orden:

  1. La llamada base al programa de aws.

  2. El comando de nivel superior, que normalmente corresponde a un servicio de AWS compatible con la AWS CLI.

  3. El subcomando que especifica qué operación realizar.

  4. Opciones o parámetros generales de la AWS CLI necesarios por la operación. Puede especificarlos en cualquier orden siempre que vayan detrás de las tres primeras partes. Si se especifica un parámetro exclusivo varias veces, solo se aplica el último valor.

$ aws <command> <subcommand> [options and parameters]

Los parámetros pueden tomar varios tipos de valores de entrada, como números, cadenas, listas, mapas y estructuras JSON. Los valores admitidos dependen del comando y los subcomandos que especifique.

Amazon S3

En el siguiente ejemplo se enumeran todos los buckets de Amazon S3.

$ aws s3 ls 2018-12-11 17:08:50 my-bucket 2018-12-14 14:55:44 my-bucket2

Para obtener más información acerca de los comandos de Amazon S3, consulte aws s3 en la Referencia de los comandos de AWS CLI.

aws s3

AWS CloudFormation

El siguiente ejemplo de comandos change-set-create-complete cambia el nombre de la pila de cloudformation a my-change-set.

$ aws cloudformation change-set-create-complete --stack-name my-stack --change-set-name my-change-set

Para obtener más información acerca de los comandos de AWS CloudFormation, consulte aws cloudformation en la Referencia de los comandos de AWS CLI.

Comandos de espera

Algunos servicios de AWS tienen comandos wait disponibles. Cualquier comando que use aws wait por lo general espera hasta que se completa un comando antes de ir al siguiente paso. Esto es especialmente útil para comandos multiparte o scripting, ya que puede utilizar un comando de espera para evitar pasar a pasos posteriores si el comando de espera falla.

La AWS CLI utiliza una estructura multiparte en la línea de comandos para el comando wait que debe especificarse en el siguiente orden:

  1. La llamada base al programa de aws.

  2. El comando de nivel superior, que normalmente corresponde a un servicio de AWS compatible con la AWS CLI.

  3. El comando wait

  4. El subcomando que especifica qué operación realizar.

  5. Opciones o parámetros generales de la CLI necesarios por la operación. Puede especificarlos en cualquier orden siempre que vayan detrás de las tres primeras partes. Si se especifica un parámetro exclusivo varias veces, solo se aplica el último valor.

$ aws <command> wait <subcommand> [options and parameters]

Los parámetros pueden tomar varios tipos de valores de entrada, como números, cadenas, listas, mapas y estructuras JSON. Los valores admitidos dependen del comando y los subcomandos que especifique.

nota

No todos los servicios de AWS admiten comandos wait. Consulte la Guía de referencia de AWS CLI para ver si su servicio admite comandos wait.

AWS CloudFormation

Los siguientes ejemplos de comandos de wait change-set-create-complete se detienen y se reanudan solo después de que pueda confirmar que el conjunto de cambios my-change-set de la pila my-stack está listo para ejecutarse.

$ aws cloudformation wait change-set-create-complete --stack-name my-stack --change-set-name my-change-set

Para obtener más información sobre los comandos AWS CloudFormation wait, consulte espera en la Referencia de comandos de AWS CLI.

AWS CodeDeploy

Los siguientes ejemplos de comandos wait deployment-successful se detiene hasta que se completa satisfactoriamente la implementación de D-A1B2C3111.

$ aws deploy wait deployment-successful --deployment-id d-A1B2C3111

Para obtener más información sobre los comandos AWS CodeDeploy wait, consulte espera en la Referencia de comandos de AWS CLI.