Aufforderung der AWS CLI zur Eingabe von Befehlen - AWS Command Line Interface
FunktionsweiseFunktionen für automatische EingabeaufforderungAutomatischer EingabeaufforderungsmodiKonfigurieren der automatischen Eingabeaufforderung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Aufforderung der AWS CLI zur Eingabe von Befehlen

Sie können festlegen, dass die AWS CLI Version 2 Sie zur Eingabe von Befehlen, Parametern und Ressourcen auffordert, wenn Sie einen aws-Befehl ausführen.

Funktionsweise

Wenn die Funktion aktiviert ist, können Sie mit der automatischen Eingabeaufforderung die EINGABETASTE verwenden, um einen teilweise eingegebenen Befehl zu vervollständigen. Nachdem Sie die EINGABETASTE gedrückt haben, werden Befehle, Parameter und Ressourcen basierend auf Ihrer weiteren Eingabe vorgeschlagen. Die Vorschläge enthalten links den Namen des Befehls, Parameters oder der Ressource und rechts eine Beschreibung. Um einen Vorschlag auszuwählen und zu verwenden, verwenden Sie die Pfeiltasten, um eine Zeile hervorzuheben, und drücken Sie dann die LEERTASTE. Wenn Sie mit der Eingabe Ihres Befehls fertig sind, drücken Sie die EINGABETASTE, um den Befehl zu verwenden. Das folgende Beispiel zeigt, wie eine vorgeschlagene Liste aus der automatischen Eingabeaufforderung aussieht.

$ 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

Funktionen für automatische Eingabeaufforderung

Die automatische Eingabeaufforderung enthält die folgenden nützlichen Funktionen:

Dokumentationsbereich

Stellt die Hilfedokumentation für den aktuellen Befehl bereit. Um die Dokumentation zu öffnen, drücken Sie die F3-Taste.

Vervollständigung von Befehlen

Schlägt zu verwendende aws-Befehle vor. Um eine Liste anzuzeigen, geben Sie den Befehl teilweise ein. Im folgenden Beispiel wird nach einem Service gesucht, der mit dem Buchstaben a beginnt.

$ 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
Parametervervollständigung

Nachdem ein Befehl eingegeben wurde, beginnt die automatische Eingabeaufforderung, Parameter vorzuschlagen. Die Beschreibungen für die Parameter umfassen den Werttyp und eine Beschreibung dessen, was der Parameter ist. Erforderliche Parameter werden zuerst aufgeführt und als erforderlich (required) gekennzeichnet. Das folgende Beispiel zeigt die Parameterliste, die von der automatischen Eingabeaufforderung für aws dynamodb describe-table erstellt wird.

$ 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...
Ressourcenvervollständigung

Die automatische Eingabeaufforderung führt AWS-API-Aufrufe mithilfe der verfügbaren AWS-Ressourceneigenschaften durch, um Ressourcenwerte vorzuschlagen. Auf diese Weise kann die automatische Eingabeaufforderung bei der Eingabe von Parametern mögliche Ressourcen vorschlagen, die Sie besitzen. Im folgenden Beispiel listet die automatische Eingabeaufforderung Ihre Tabellennamen auf, wenn Sie den Parameter --table-name für den Befehl aws dynamodb describe-table eingeben.

$ aws dynamodb describe-table
> aws dynamodb describe-table --table-name 
                                            Table1
                                            Table2
                                            Table3
Kurzschriftvervollständigung

Für Parameter, die Kurzschriftensyntax verwenden, schlägt die automatische Eingabeaufforderung Werte vor, die verwendet werden sollen. Im folgenden Beispiel listet die automatische Eingabeaufforderung die Kurzschriften-Syntaxwerte für den --placement-Parameter im aws ec2 run-instances-Befehl auf.

$ 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...
Dateivervollständigung

Beim Ausfüllen von Parametern in aws-Befehlen schlägt die automatische Vervollständigung lokale Dateinamen vor, nachdem das Präfix file:// oder fileb:// verwendet wurde. Im folgenden Beispiel schlägt die automatische Eingabeaufforderung lokale Dateien vor, nachdem --item file:// für den Befehl aws ec2 run-instances eingegeben wurde.

$ aws ec2 run-instances
> aws ec2 run-instances --item file:// 
                         item1.txt
                         file1.json
                         file2.json
Regionvervollständigung

Bei Verwendung des globalen Parameters --region listet die automatische Eingabeaufforderung mögliche Regionen zur Auswahl auf. Im folgenden Beispiel schlägt die automatische Eingabeaufforderung Regionen in alphabetischer Reihenfolge vor, nachdem --region für den Befehl aws dynamodb list-tables eingegeben wurde.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region 
                                     af-south-1
                                     ap-east-1
                                     ap-northeast-1
                                     ap-northeast-2
Profilvervollständigung

Wenn Sie den globalen Parameter --profile verwenden, listet die automatische Eingabeaufforderung Ihre Profile auf. Im folgenden Beispiel schlägt die automatische Eingabeaufforderung Ihre Profile vor, nachdem --profile für den Befehl aws dynamodb list-tables eingegeben wurde.

$ aws dynamodb list-tables
> aws dynamodb list-tables --profile 
                                     profile1
                                     profile2
                                     profile3
Fuzzy-Suche

Vervollständigen Sie Befehle und Werte, die einen bestimmten Satz von Zeichen enthalten. Im folgenden Beispiel schlägt die automatische Eingabeaufforderung Regionen vor, die eu enthalten, nachdem --region eu für den Befehl aws dynamodb list-tables eingegeben wurde.

$ aws dynamodb list-tables
> aws dynamodb list-tables --region west
                                         eu-west-1
                                         eu-west-2
                                         eu-west-3
                                         us-west-1
Verlauf

Um zuvor verwendete Befehle im automatischen Eingabeaufforderungsmodus anzuzeigen und auszuführen, drücken Sie STRG + R. Der Verlauf listet vorherige Befehle auf, die Sie mit den Pfeiltasten auswählen können. Im folgenden Beispiel wird der Verlauf des automatischen Eingabeaufforderungsmodus angezeigt.

$ aws
> aws 
        dynamodb list-tables
        s3 ls

Automatischer Eingabeaufforderungsmodi

Die automatische Eingabeaufforderung für die AWS CLI Version 2 hat 2 Modi, die konfiguriert werden können:

  • Vollmodus: Verwendet die automatische Eingabeaufforderung jedes Mal, wenn Sie versuchen, einen aws-Befehl auszuführen, unabhängig davon, ob Sie ihn manuell mit dem Parameter --cli-auto-prompt aufrufen oder ihn dauerhaft aktiviert haben. Dazu gehört das Drücken der EINGABETASTE sowohl nach einem vollständigen Befehl als auch nach einem unvollständigen Befehl.

  • Teilmodus: Verwendet die automatische Eingabeaufforderung, wenn ein Befehl unvollständig ist oder aufgrund von clientseitigen Validierungsfehlern nicht ausgeführt werden kann. Dieser Modus ist besonders nützlich, wenn Sie über bereits vorhandene Skripts oder Runbooks verfügen oder nur für Befehle, mit denen Sie nicht vertraut sind, automatisch aufgefordert werden möchten, anstatt bei jedem Befehl gefragt zu werden.

Konfigurieren der automatischen Eingabeaufforderung

Um die automatische Eingabeaufforderung zu konfigurieren, können Sie die folgenden Methoden in der Reihenfolge ihrer Rangfolge verwenden:

  • Befehlszeilenoptionen aktivieren oder deaktivieren die automatische Eingabeaufforderung für einen einzelnen Befehl. Verwenden Sie --cli-auto-prompt, um die automatische Eingabeaufforderung aufzurufen, und --no-cli-auto-prompt, um die automatische Eingabeaufforderung zu deaktivieren.

  • Umgebungsvariablen verwenden die Variable aws_cli_auto_prompt.

  • Freigegebene Konfigurationsdateien verwenden die Einstellung cli_auto_prompt.