Befehlsstruktur in der AWS CLI - AWS Command Line Interface
BefehlsstrukturWait-Befehle

Befehlsstruktur in der AWS CLI

In diesem Thema wird beschrieben, wie ein AWS Command Line Interface (AWS CLI)-Befehl strukturiert ist und wie Wait–Befehle verwendet werden.

Befehlsstruktur

Die AWS CLI verwendet eine mehrteilige Struktur in der Befehlszeile, die in dieser Reihenfolge angegeben werden muss:

  1. Basisaufruf des aws-Programms.

  2. Der Top-Level-Befehl, der in der Regel einem AWS-Service entspricht, der von der AWS CLI unterstützt wird.

  3. Der Unterbefehl, der den auszuführenden Vorgang angibt.

  4. Allgemeine AWS CLI-Optionen oder -Parameter, die von dem Vorgang benötigt werden. Sie können diese in beliebiger Reihenfolge angeben, da diese Informationen nach den ersten drei Teilen aufgeführt werden. Bei mehrfacher Angabe eines exklusiven Parameters wird nur der letzte Wert angewendet.

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

Parameter können verschiedene Typen von Eingabewerten akzeptieren, darunter Zahlen, Zeichenfolgen, Listen, Zuordnungen und JSON-Strukturen. Was unterstützt wird, hängt von dem angegebenen Befehl und Unterbefehl ab.

Amazon S3

Das folgende Beispiel listet alle Ihre Amazon-S3-Buckets auf.

$ aws s3 ls
2018-12-11 17:08:50 amzn-s3-demo-bucket1
2018-12-14 14:55:44 amzn-s3-demo-bucket2

Weitere Informationen zu den Amazon-S3-Befehlen finden Sie unter aws s3 in der AWS CLI-Befehlsreferenz.

AWS CloudFormation

Das folgende create-change-set-Befehlsbeispiel ändert den Namen des Cloudformation-Stacks zu my-change-set.

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

Weitere Informationen zu den AWS CloudFormation-Befehlen finden Sie unter aws cloudformation in der AWS CLI-Befehlsreferenz.

Wait-Befehle

Für einige AWS-Services sind wait-Befehle verfügbar. Jeder Befehl, der aws wait verwendet, wartet normalerweise, bis ein Befehl abgeschlossen ist, bevor er zum nächsten Schritt übergeht. Dies ist besonders nützlich für mehrteilige Befehle oder Skripterstellung, da Sie einen Wait-Befehl verwenden können, um zu verhindern, dass zu nachfolgenden Schritten übergegangen wird, wenn der Wait-Befehl fehlschlägt.

Die AWS CLI verwendet eine mehrteilige Struktur in der Befehlszeile für den Befehl wait, die in dieser Reihenfolge angegeben werden muss:

  1. Basisaufruf des aws-Programms.

  2. Der Top-Level-Befehl, der in der Regel einem AWS-Service entspricht, der von der AWS CLI unterstützt wird.

  3. Der wait-Befehl.

  4. Der Unterbefehl, der den auszuführenden Vorgang angibt.

  5. Allgemeine CLI-Optionen oder -Parameter, die von dem Vorgang benötigt werden. Sie können diese in beliebiger Reihenfolge angeben, da diese Informationen nach den ersten drei Teilen aufgeführt werden. Bei mehrfacher Angabe eines exklusiven Parameters wird nur der letzte Wert angewendet.

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

Parameter können verschiedene Typen von Eingabewerten akzeptieren, darunter Zahlen, Zeichenfolgen, Listen, Zuordnungen und JSON-Strukturen. Was unterstützt wird, hängt von dem angegebenen Befehl und Unterbefehl ab.

Anmerkung

Nicht jeder AWS-Service unterstützt wait-Befehle. Informieren Sie sich im AWS CLIReferenzleitfaden für Version 2 darüber, ob Ihr Service wait-Befehle unterstützt.

AWS CloudFormation

Die folgenden wait change-set-create-complete-Befehlsbeispiele werden nur angehalten und fortgesetzt, nachdem bestätigt wurde, dass der Änderungssatz my-change-set im my-stack-Stack zur Ausführung bereit ist.

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

Weitere Informationen zu den AWS CloudFormation wait-Befehlen finden Sie unter wait in der AWS CLI-Befehlsreferenz.

AWS CodeDeploy

Folgende wait deployment-successful-Befehlsbeispiele werden angehalten, bis die d-A1B2C3111-Bereitstellung erfolgreich abgeschlossen wird.

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

Weitere Informationen zu den AWS CodeDeploy wait-Befehlen finden Sie unter wait in der AWS CLI-Befehlsreferenz.