Vous êtes AWS CLI invité à saisir des commandes

La AWS CLI version 2 peut vous demander des commandes, des paramètres et des ressources lorsque vous exécutez une aws commande.

Comment ça marche

Si cette option est activée, l'invite automatique vous permet d'utiliser la touche ENTER pour terminer une commande partiellement saisie. Après avoir appuyé sur la touche ENTER, 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 une description de celui-ci sur la droite. Pour sélectionner et utiliser une suggestion, utilisez les flèches pour surligner une ligne, puis appuyez sur la touche ESPACE. Lorsque vous avez fini de saisir votre commande, appuyez sur ENTER pour l'utiliser. L'exemple suivant montre à quoi ressemble une liste suggérée à partir d'une invite automatique.

$ aws
> aws a
       accessanalyzer                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 afficher une liste, entrez partiellement la commande. L'exemple suivant recherche un service commençant par la lettrea.

$ aws
> aws a
       accessanalyzer                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 démarre pour 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 pouraws 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 appels d'API AWS en utilisant les propriétés des ressources AWS 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-name paramètre de la aws dynamodb describe-table commande.

$ aws dynamodb describe-table
> aws dynamodb describe-table --table-name 
                                            Table1
                                            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 --placement paramètre de la commande. aws ec2 run-instances

$ aws ec2 run-instances
> aws ec2 run-instances --placement 
 AvailabilityZone=      [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 aws des 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:// la aws ec2 run-instances commande.

$ 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 --region la aws dynamodb list-tables commande.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region 
                                     af-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 --profile la aws dynamodb list-tables commande.

$ aws dynamodb list-tables
> aws dynamodb list-tables --profile 
                                     profile1
                                     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 eu fois --region eu la aws dynamodb list-tables commande saisie.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region west
                                         eu-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
> aws 
        dynamodb 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 tentez d'exécuter une aws commande, que vous l'appeliez manuellement à l'aide du --cli-auto-prompt paramètre ou que vous l'activiez définitivement. Cela inclut d'appuyer sur ENTER aprè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-prompt pour désactiver l'invite automatique.

• Les variables d'environnement utilisent la aws_cli_auto_prompt variable.

• Les fichiers de configuration partagés utilisent ce cli_auto_prompt paramètre.