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.

Ejemplos

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 Simple Storage Service (Amazon S3), consulte aws s3 en la Referencia de los comandos de AWS CLI.

AWS CloudFormation

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

$ aws cloudformation create-change-set --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 AWS CLIversión 2 de la guía de referencia de para ver si el servicio admite comandos wait.

Ejemplos

AWS CloudFormation

Los siguientes ejemplos de comandos 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 acerca de los comandos wait de AWS CloudFormation‎, consulte wait‎ en la Referencia de los comandos de AWS CLI.

AWS CodeDeploy

‎Los ejemplos de comandos wait deployment-successful que se muestran a continuación se detienen hasta que se complete satisfactoriamente la implementación de ‎d-A1B2C3111.

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

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