Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
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:
-
La llamada base al programa de
aws. -
El comando de nivel superior, que normalmente corresponde a un servicio de AWS compatible con la AWS CLI.
-
El subcomando que especifica qué operación realizar.
-
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 ls2018-12-11 17:08:50 amzn-s3-demo-bucket1 2018-12-14 14:55:44 amzn-s3-demo-bucket2
Para obtener más información acerca de los comandos de Simple Storage Service (Amazon S3), consulte aws
s3 en la Referencia de 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-namemy-stack--change-set-namemy-change-set
Para obtener más información acerca de los comandos de AWS CloudFormation, consulte aws
cloudformation en la Referencia de 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:
-
La llamada base al programa de
aws. -
El comando de nivel superior, que normalmente corresponde a un servicio de AWS compatible con la AWS CLI.
-
El comando
wait -
El subcomando que especifica qué operación realizar.
-
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 CLIguía de referencia de para ver si el servicio admite comandos wait.
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-namemy-stack--change-set-namemy-change-set
Para obtener más información acerca de los comandos wait de AWS CloudFormation, consulte wait en la Referencia de 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-idd-A1B2C3111
Para obtener más información acerca de los comandos wait de AWS CodeDeploy, consulte wait en la Referencia de comandos de AWS CLI.
