Befehlsstruktur in der AWS CLI - AWS Command Line Interface

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.

Befehlsstruktur in der AWS CLI

In diesem Thema wird beschrieben, wie der Befehl AWS Command Line Interface (AWS CLI) strukturiert ist und wie die Befehle wait verwendet werden.

Befehlsstruktur

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

  1. Basisaufruf des aws-Programms.

  2. Der Befehl der obersten Ebene, der in der Regel einem AWS Dienst entspricht, der von der unterstützt wird. AWS CLI

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

  4. Allgemeine AWS CLI Optionen oder Parameter, die für den Vorgang erforderlich sind. 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 Arten von Eingabewerten annehmen, z. B. Zahlen, Zeichenketten, 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

Im folgenden Befehlsbeispiel wird der Name des Cloudformation-Stacks in geändert 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 in der AWS CLI Befehlsreferenz.

Wait-Befehle

Für einige AWS Dienste 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.

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

  1. Basisaufruf des aws-Programms.

  2. Der Befehl der obersten Ebene, der in der Regel einem AWS Dienst entspricht, der von der unterstützt wird. AWS CLI

  3. Der wait-Befehl.

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

  5. Allgemeine CLI Optionen oder Parameter, die für den Vorgang erforderlich sind. 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 Arten von Eingabewerten annehmen, z. B. Zahlen, Zeichenketten, Listen, Zuordnungen und JSON Strukturen. Was unterstützt wird, hängt von dem angegebenen Befehl und Unterbefehl ab.

Anmerkung

Nicht jeder AWS Dienst unterstützt wait Befehle. Sehen Sie im Version 2 nach, ob Ihr Dienst wait Befehle unterstützt.

AWS CloudFormation

Die folgenden Befehlsbeispiele werden erst unterbrochen und wieder aufgenommen, wenn bestätigt werden kann, dass my-change-set Änderungssatz im my-stack Der Stack ist bereit zur Ausführung.

$ 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

Die folgenden Befehlsbeispiele pausieren, bis d-A1B2C3111 Die Bereitstellung wurde erfolgreich abgeschlossen.

$ 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.