Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Activation et utilisation des invites de commande dans le AWS CLI
La AWS CLI version 2 peut vous demander des commandes, des paramètres et des ressources lorsque vous exécutez une aws commande.
Rubriques
Comment ça marche
Si cette option est activée, l'invite automatique vous permet d'utiliser la ENTERtouche pour terminer une commande partiellement saisie. Après avoir appuyé sur la ENTERtouche, des commandes, des paramètres et des ressources sont suggérés en fonction de ce que vous continuez à taper. Les suggestions indiquent le nom de la commande, du paramètre ou de la ressource sur la gauche et leur description sur la droite. Pour sélectionner et utiliser une suggestion, utilisez les touches fléchées pour surligner une ligne, puis appuyez sur la SPACEtouche. Lorsque vous avez fini de saisir votre commande, appuyez sur ENTERcette touche pour l'utiliser. L'exemple suivant montre à quoi ressemble une liste suggérée à partir d'une invite automatique.
$aws> awsaaccessanalyzer Access Analyzer acm AWS Certificate Manager acm-pca AWS Certificate Manager Private Certificate Authority alexaforbusiness Alexa For Business amplify AWS Amplify
Fonctionnalités d'invite automatique
L'invite automatique contient les fonctionnalités utiles suivantes :
- Panneau de documentation
-
Fournit la documentation d'aide pour la commande en cours. Pour ouvrir la documentation, appuyez sur la touche F3.
- Saisie automatique de commandes
-
awsSuggère des commandes à utiliser. Pour voir une liste, entrez partiellement la commande. L'exemple suivant recherche un service commençant par la lettrea.$aws> awsaaccessanalyzer Access Analyzer acm AWS Certificate Manager acm-pca AWS Certificate Manager Private Certificate Authority alexaforbusiness Alexa For Business amplify AWS Amplify - Complétion des paramètres
-
Une fois qu'une commande est saisie, l'invite automatique commence à suggérer des paramètres. Les descriptions des paramètres incluent le type de valeur et une description de ce qu'est le paramètre. Les paramètres requis sont répertoriés en premier et sont étiquetés comme requis. L'exemple suivant montre la liste automatique des paramètres pour
aws dynamodb describe-table.$aws dynamodb describe-table> aws dynamodb describe-table--table-name (required) [string] The name of the table to describe. --cli-input-json [string] Reads arguments from the JSON string provided. The JSON string follows the format provide... --cli-input-yaml [string] Reads arguments from the YAML string provided. The YAML string follows the format provide... --generate-cli-skeleton [string] Prints a JSON skeleton to standard output without sending an API request. If provided wit... - Achèvement des ressources
-
L'invite automatique effectue des AWS API appels en utilisant les propriétés AWS des ressources disponibles pour suggérer des valeurs de ressources. Cela permet à l'invite automatique de suggérer d'éventuelles ressources que vous possédez lors de la saisie des paramètres. Dans l'exemple suivant, l'invite automatique répertorie les noms de vos tables lorsque vous saisissez le
--table-nameparamètre de laaws dynamodb describe-tablecommande.$aws dynamodb describe-table> aws dynamodb describe-table--table-nameTable1 Table2 Table3 - Achèvement de la sténographie
-
Pour les paramètres utilisant une syntaxe abrégée, l'invite automatique suggère les valeurs à utiliser. Dans l'exemple suivant, l'invite automatique répertorie les valeurs de syntaxe abrégée pour le
--placementparamètre de la commande.aws ec2 run-instances$aws ec2 run-instances> aws ec2 run-instances--placementAvailabilityZone= [string] The Availability Zone of the instance. If not specified, an Availability Zone wil... Affinity= [string] The affinity setting for the instance on the Dedicated Host. This parameter is no... GroupName= [string] The name of the placement group the instance is in. PartitionNumber= [integer] The number of the partition the instance is in. Valid only if the placement grou... - Achèvement du fichier
-
Lorsque vous renseignez des paramètres dans
awsdes commandes, la saisie automatique suggère des noms de fichiers locaux après avoir utilisé le préfixe ou.file://fileb://Dans l'exemple suivant, l'invite automatique suggère des fichiers locaux après avoir saisi--item file://laaws ec2 run-instancescommande.$aws ec2 run-instances> aws ec2 run-instances--item file://item1.txt file1.json file2.json - Achèvement de la région
-
Lorsque vous utilisez le paramètre global
--region, l'invite automatique répertorie les régions parmi lesquelles sélectionner. Dans l'exemple suivant, l'invite automatique suggère les régions par ordre alphabétique après avoir saisi--regionlaaws dynamodb list-tablescommande.$aws dynamodb list-tables> aws dynamodb list-tables--regionaf-south-1 ap-east-1 ap-northeast-1 ap-northeast-2 - Complétion du profil
-
Lorsque vous utilisez le paramètre global
--profile, l'invite automatique répertorie vos profils. Dans l'exemple suivant, l'invite automatique suggère vos profils après avoir saisi--profilelaaws dynamodb list-tablescommande.$aws dynamodb list-tables> aws dynamodb list-tables--profileprofile1 profile2 profile3 - Recherche floue
-
Commandes et valeurs complètes contenant un jeu de caractères spécifique. Dans l'exemple suivant, l'invite automatique suggère les régions qui contiennent une
eufois--region eulaaws dynamodb list-tablescommande saisie.$aws dynamodb list-tables> aws dynamodb list-tables--region westeu-west-1 eu-west-2 eu-west-3 us-west-1 - Historique
-
Pour afficher et exécuter les commandes précédemment utilisées en mode invite automatique, appuyez sur CTRL+ R. L'historique répertorie les commandes précédentes que vous pouvez sélectionner à l'aide des touches fléchées. Dans l'exemple suivant, l'historique du mode d'invite automatique est affiché.
$aws> awsdynamodb list-tables s3 ls
Modes d'invite automatique
L'invite automatique pour la AWS CLI version 2 dispose de 2 modes qui peuvent être configurés :
-
Mode complet : utilise l'invite automatique chaque fois que vous essayez d'exécuter une
awscommande, que vous l'appeliez manuellement à l'aide du--cli-auto-promptparamètre ou que vous l'activiez définitivement. Cela inclut le fait d'appuyer ENTERaprès une commande complète ou une commande incomplète. -
Mode partiel : utilise l'invite automatique si une commande est incomplète ou ne peut pas être exécutée en raison d'erreurs de validation côté client. Ce mode est particulièrement utile si vous avez des scripts ou des runbooks préexistants, ou si vous souhaitez uniquement être automatiquement invité à saisir des commandes que vous ne connaissez pas au lieu d'être invité à chaque commande.
Configurer l'invite automatique
Pour configurer l'invite automatique, vous pouvez utiliser les méthodes suivantes par ordre de priorité :
-
Les options de ligne de commande activent ou désactivent l'invite automatique pour une seule commande.
--cli-auto-promptÀ utiliser pour appeler l'invite automatique et--no-cli-auto-promptpour désactiver l'invite automatique. -
Les variables d'environnement utilisent la
aws_cli_auto_promptvariable. -
Les fichiers de configuration partagés utilisent ce
cli_auto_promptparamètre.
