Structure de commande dans l'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 CLIUtilise 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, ce qui correspond généralement à un service AWS pris en charge par l'AWS CLI.

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

4. AWS 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> <subcommand> [options and parameters]

Les paramètres peuvent prendre différents types de valeurs d'entrée, comme des chiffres, des chaînes, des listes, des mappages et des structures JSON. 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 remplace le nom de la pile cloudformation par. 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, reportez-vous à 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 CLIUtilise 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, ce qui correspond généralement à un service AWS pris en charge par l'AWS CLI.

3. La commande wait.

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

5. Les options CLI générales ou les paramètres 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, comme des chiffres, des chaînes, des listes, des mappages et des structures JSON. Ce qui est pris en charge dépend de la commande et de la sous-commande que vous spécifiez.

Note

Tous les services AWS 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 mettent en pause et reprennent uniquement une fois qu'ils ont confirmé que la my-change-setmodification définie dans la pile my-stack est prête à être exécutée.

$ 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, reportez-vous à la référence des AWS CLI commandes.

AWS CodeDeploy

Les exemples de commande suivants sont interrompus jusqu'à ce que le déploiement de D-a1b2c3111 soit terminé avec succès.

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

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