Structure de commande dans le AWS CLI

Cette rubrique explique comment la commande AWS Command Line Interface (AWS CLI) est structurée et comment utiliser les commandes wait.

Structure de commande

AWS CLI Utilise une structure en plusieurs parties sur la ligne de commande qui doit être spécifiée dans cet ordre :

1. L'appel de base pour le programme aws.

2. La commande de niveau supérieur, qui correspond généralement à un AWS service pris en charge par le AWS CLI.

3. La sous-commande qui spécifie l'opération à effectuer.

4. AWS CLI Options ou paramètres généraux requis par l'opération. Vous pouvez les spécifier dans n'importe quel ordre tant qu'ils suivent les trois premières parties. Si un paramètre exclusif est spécifié plusieurs fois, seule la dernière valeur s'applique.

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

Les paramètres peuvent prendre différents types de valeurs d'entrée, telles que des nombres, des chaînes, des listes, des cartes et JSON des structures. Ce qui est pris en charge dépend de la commande et de la sous-commande que vous spécifiez.

Exemples

Amazon S3

L'exemple suivant répertorie tous vos compartiments Amazon S3.

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

Pour plus d'informations sur les commandes Amazon S3, consultez la référence des AWS CLI commandes.

AWS CloudFormation

L'exemple de commande suivant change le nom de la pile cloudformation en my-change-set.

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

Pour plus d'informations sur les AWS CloudFormation commandes, voir la référence des AWS CLI commandes.

Commandes d'attente

Des wait commandes sont disponibles pour certains AWS services. Toute commande utilisée attend aws wait généralement qu'une commande soit terminée avant de passer à l'étape suivante. Cela est particulièrement utile pour les commandes partitionnées ou les scripts, car vous pouvez utiliser une commande d'attente pour empêcher de passer aux étapes suivantes en cas d'échec de la commande d'attente.

AWS CLI Utilise une structure en plusieurs parties sur la ligne de commande pour la wait commande qui doit être spécifiée dans cet ordre :

1. L'appel de base pour le programme aws.

2. La commande de niveau supérieur, qui correspond généralement à un AWS service pris en charge par le AWS CLI.

3. La commande wait.

4. La sous-commande qui spécifie l'opération à effectuer.

5. CLIOptions ou paramètres généraux requis par l'opération. Vous pouvez les spécifier dans n'importe quel ordre tant qu'ils suivent les trois premières parties. Si un paramètre exclusif est spécifié plusieurs fois, seule la dernière valeur s'applique.

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

Les paramètres peuvent prendre différents types de valeurs d'entrée, telles que des nombres, des chaînes, des listes, des cartes et JSON des structures. Ce qui est pris en charge dépend de la commande et de la sous-commande que vous spécifiez.

Note

Tous les AWS services ne prennent pas en charge wait les commandes. Consultez le version 2 pour savoir si votre service prend en charge wait les commandes.

Exemples

AWS CloudFormation

Les exemples de commande suivants ne s'interrompent et ne reprennent qu'une fois qu'ils ont confirmé que le my-change-set modification définie dans le my-stack stack est prêt à fonctionner.

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

Pour plus d'informations sur les AWS CloudFormation wait commandes, voir la référence des AWS CLI commandes.

AWS CodeDeploy

Les exemples de commandes suivants sont interrompus jusqu'à ce que d-A1B2C3111 le déploiement s'est terminé avec succès.

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

Pour plus d'informations sur les AWS CodeDeploy wait commandes, voir la référence des AWS CLI commandes.