

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
<a name="cli-usage-commandstructure"></a>

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

**Topics**
+ [Befehlsstruktur](#cli-usage-commandstructure-structure.title)
+ [Wait-Befehle](#cli-usage-commandstructure-wait)

## Befehlsstruktur
<a name="cli-usage-commandstructure-structure.title"></a>

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

1. Basisaufruf des `aws`-Programms.

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

1. Der *Unterbefehl*, der den auszuführenden Vorgang angibt.

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

### Beispiele
<a name="cli-usage-commandstructure-structure-example"></a>

**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 [https://docs.aws.amazon.com/cli/latest/reference/s3/index.html](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html) in der *AWS CLI-Befehlsreferenz.*

**AWS CloudFormation**

Das folgende [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-change-set.html)-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 [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/index.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/index.html) in der *AWS CLI-Befehlsreferenz*.

## Wait-Befehle
<a name="cli-usage-commandstructure-wait"></a>

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.

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

1. Der `wait`-Befehl.

1. Der *Unterbefehl*, der den auszuführenden Vorgang angibt.

1. 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](https://docs.aws.amazon.com/cli/latest/reference/index.html) darüber, ob Ihr Service `wait`-Befehle unterstützt.

### Beispiele
<a name="cli-usage-commandstructure-wait-example"></a>

**AWS CloudFormation**

Die folgenden [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/change-set-create-complete.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/change-set-create-complete.html)-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 [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/index.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/index.html) in der *AWS CLI-Befehlsreferenz*.

**AWS CodeDeploy**

Folgende [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/change-set-create-complete.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/change-set-create-complete.html)-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 [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/index.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/wait/index.html) in der *AWS CLI-Befehlsreferenz*.