Dies ist der AWS CDK v2-Entwicklerhandbuch. Das ältere CDK v1 wurde am 1. Juni 2022 gewartet und der Support wurde am 1. Juni 2023 eingestellt.

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.

# AWS CDK-CLI-Befehlsreferenz
<a name="ref-cli-cmd"></a>

Dieser Abschnitt enthält Befehlsreferenzinformationen für die Befehlszeilenschnittstelle (CLI) des AWS Cloud Development Kit (AWS CDK). Die CDK-CLI wird auch als CDK-Toolkit bezeichnet.

## Verwendung
<a name="ref-cli-cmd-usage"></a>

```
$ cdk <command> <arguments> <options>
```

## Befehle
<a name="ref-cli-cmd-commands"></a><a name="ref-cli-cmd-commands-acknowledge"></a>

 ` acknowledge ack `   
Bestätigen Sie eine Benachrichtigung anhand der Problemnummer und verhindern Sie, dass sie erneut angezeigt wird.<a name="ref-cli-cmd-commands-bootstrap"></a>

 ` bootstrap `   
Bereiten Sie eine AWS Umgebung für CDK-Bereitstellungen vor, indem Sie den CDK-Bootstrap-Stack (genannt`CDKToolkit`) in der Umgebung bereitstellen. AWS <a name="ref-cli-cmd-commands-context"></a>

 ` context `   
Verwalten Sie zwischengespeicherte Kontextwerte für Ihre CDK-Anwendung.<a name="ref-cli-cmd-commands-deploy"></a>

 ` deploy `   
Stellen Sie einen oder mehrere CDK-Stacks in Ihrer Umgebung bereit. AWS <a name="ref-cli-cmd-commands-destroy"></a>

 ` destroy `   
Löschen Sie einen oder mehrere CDK-Stacks aus Ihrer Umgebung. AWS <a name="ref-cli-cmd-commands-diff"></a>

 ` diff `   
Führen Sie einen Vergleich durch, um die Infrastrukturänderungen zwischen den CDK-Stacks zu sehen.<a name="ref-cli-cmd-commands-docs"></a>

 ` docs doc `   
Öffnen Sie die CDK-Dokumentation in Ihrem Browser.<a name="ref-cli-cmd-commands-doctor"></a>

 ` doctor `   
Untersuchen und zeigen Sie nützliche Informationen über Ihr lokales CDK-Projekt und Ihre Entwicklungsumgebung an.<a name="ref-cli-cmd-commands-drift"></a>

 ` drift `   
Erkennen Sie Konfigurationsabweichungen bei Ressourcen, die Sie mithilfe von CDK definieren, verwalten und bereitstellen.<a name="ref-cli-cmd-commands-flags"></a>

 ` flags `   
Zeigen Sie Ihre Feature-Flag-Konfigurationen für die CDK-CLI an und ändern Sie sie.<a name="ref-cli-cmd-commands-import"></a>

 ` import `   
Verwenden Sie AWS CloudFormation Ressourcenimporte, um vorhandene AWS Ressourcen in einen CDK-Stack zu importieren.<a name="ref-cli-cmd-commands-init"></a>

 ` init `   
Erstellen Sie ein neues CDK-Projekt aus einer Vorlage.<a name="ref-cli-cmd-commands-list"></a>

 ` list, ls `   
Listet alle CDK-Stacks und ihre Abhängigkeiten von einer CDK-App auf.<a name="ref-cli-cmd-commands-metadata"></a>

 ` metadata `   
Zeigt Metadaten an, die einem CDK-Stack zugeordnet sind.<a name="ref-cli-cmd-commands-migrate"></a>

 ` migrate `   
Migrieren Sie AWS Ressourcen, AWS CloudFormation Stacks und AWS CloudFormation Vorlagen in ein neues CDK-Projekt.<a name="ref-cli-cmd-commands-notices"></a>

 ` notices `   
Zeigen Sie Hinweise für Ihre CDK-Anwendung an.<a name="ref-cli-cmd-commands-refactor"></a>

 ` refactor `   
Schonen Sie beim Refactoring von Code in Ihrer CDK-Anwendung die bereitgestellten Ressourcen.<a name="ref-cli-cmd-commands-synthesize"></a>

 ` synthesize, synth `   
Synthetisieren Sie eine CDK-App, um eine Cloud-Assembly zu erstellen, einschließlich einer AWS CloudFormation Vorlage für jeden Stapel.<a name="ref-cli-cmd-commands-watch"></a>

 ` watch `   
Beobachten Sie ein lokales CDK-Projekt kontinuierlich auf Änderungen bei der Durchführung von Implementierungen und Hotswaps.

## Globale Optionen
<a name="ref-cli-cmd-options"></a>

Die folgenden Optionen sind mit allen CDK-CLI-Befehlen kompatibel.<a name="ref-cli-cmd-options-app"></a>

 `--app, -a <STRING>`   
Geben Sie den Befehl zum Ausführen Ihres App- oder Cloud-Assembly-Verzeichnisses an.  
 *Erforderlich*: Ja<a name="ref-cli-cmd-options-asset-metadata"></a>

 `--asset-metadata <BOOLEAN>`   
Fügen Sie `aws:asset:*` AWS CloudFormation Metadaten für Ressourcen hinzu, die Ressourcen verwenden.  
 *Required*: No  
 *Standardwert*: `true` <a name="ref-cli-cmd-options-build"></a>

 `--build <STRING>`   
Befehl zum Ausführen eines Pre-Synthese-Builds.  
 *Required*: No<a name="ref-cli-cmd-options-ca-bundle-path"></a>

 `--ca-bundle-path <STRING>`   
Pfad zu einem CA-Zertifikat, das bei der Validierung von HTTPS-Anfragen verwendet werden soll.  
Wenn diese Option nicht bereitgestellt wird, liest die CDK-CLI aus der `AWS_CA_BUNDLE` Umgebungsvariablen.  
 *Erforderlich*: Ja<a name="ref-cli-cmd-options-ci"></a>

 `--ci <BOOLEAN>`   
Geben Sie an, dass CDK-CLI-Befehle in einer Continuous Integration (CI) -Umgebung ausgeführt werden.  
Diese Option ändert das Verhalten der CDK-CLI, um es besser an automatisierte Operationen anzupassen, die für CI-Pipelines typisch sind.  
Wenn Sie diese Option angeben, werden Protokolle an statt an `stdout` gesendet. `stderr`  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-context"></a>

 `--context, -c <ARRAY>`   
Fügen Sie kontextbezogene Zeichenkettenparameter als Schlüssel-Wert-Paare hinzu.<a name="ref-cli-cmd-options-debug"></a>

 `--debug <BOOLEAN>`   
Aktivieren Sie detaillierte Debugging-Informationen. Diese Option erzeugt eine ausführliche Ausgabe, die viel mehr Details darüber enthält, was die CDK-CLI hinter den Kulissen tut.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-ec2creds"></a>

 `--ec2creds, -i <BOOLEAN>`   
Erzwingen Sie, dass die CDK-CLI versucht, EC2 Amazon-Instance-Anmeldeinformationen abzurufen.  
Standardmäßig errät die CDK-CLI den EC2 Amazon-Instance-Status.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für die CDK-CLI an.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-ignore-errors"></a>

 `--ignore-errors <BOOLEAN>`   
Ignorieren Sie Synthesefehler, die wahrscheinlich zu einer ungültigen Ausgabe führen.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-json"></a>

 `--json, -j <BOOLEAN>`   
Verwenden Sie JSON anstelle von YAML für AWS CloudFormation Vorlagen, die in der Standardausgabe (`stdout`) gedruckt werden.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-lookups"></a>

 `--lookups <BOOLEAN>`   
Führen Sie Kontext-Lookups durch.  
Die Synthese schlägt fehl, wenn dieser Wert gleich ist `false` und Kontext-Lookups durchgeführt werden müssen.  
 *Required*: No  
 *Standardwert*: `true` <a name="ref-cli-cmd-options-no-color"></a>

 `--no-color <BOOLEAN>`   
Entfernen Sie Farbe und anderes Design aus der Konsolenausgabe.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-notices"></a>

 `--notices <BOOLEAN>`   
Zeigen Sie relevante Hinweise an.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-output"></a>

 `--output, -o <STRING>`   
Geben Sie das Verzeichnis an, in das die synthetisierte Cloud-Assembly ausgegeben werden soll.  
 *Erforderlich*: Ja  
 *Standardwert*: `cdk.out` <a name="ref-cli-cmd-options-path-metadata"></a>

 `--path-metadata <BOOLEAN>`   
Fügen Sie `aws::cdk::path` AWS CloudFormation Metadaten für jede Ressource hinzu.  
 *Required*: No  
 *Standardwert*: `true` <a name="ref-cli-cmd-options-plugin"></a>

 `--plugin, -p <ARRAY>`   
Name oder Pfad eines Knotenpakets, das die CDK-Funktionen erweitert. Diese Option kann in einem einzigen Befehl mehrfach angegeben werden.  
Sie können diese Option in der `cdk.json` Projektdatei oder `~/.cdk.json` auf Ihrem lokalen Entwicklungscomputer konfigurieren:  

```
{
   // ...
   "plugin": [
      "module_1",
      "module_2"
   ],
   // ...
}
```
 *Required*: No<a name="ref-cli-cmd-options-profile"></a>

 `--profile <STRING>`   
Geben Sie den Namen des AWS Profils an, das Ihre AWS Umgebungsinformationen enthält und mit der CDK-CLI verwendet werden soll.  
 *Erforderlich*: Ja<a name="ref-cli-cmd-options-proxy"></a>

 `--proxy <STRING>`   
Verwenden Sie den angegebenen Proxy.  
Wenn diese Option nicht bereitgestellt wird, liest die CDK-CLI aus der `HTTPS_PROXY` Umgebungsvariablen.  
 *Erforderlich*: Ja  
 *Standardwert*: Aus der `HTTPS_PROXY` Umgebungsvariablen lesen.<a name="ref-cli-cmd-options-role-arn"></a>

 `--role-arn, -r <STRING>`   
Der ARN der IAM-Rolle, den die CDK-CLI bei der Interaktion mit ihr annimmt. AWS CloudFormation  
 *Required*: No<a name="ref-cli-cmd-options-staging"></a>

 `--staging <BOOLEAN>`   
Kopieren Sie die Assets in das Ausgabeverzeichnis.  
Geben Sie `false` an, dass das Kopieren von Assets in das Ausgabeverzeichnis verhindert werden soll. Dadurch kann die AWS SAM-CLI beim lokalen Debuggen auf die ursprünglichen Quelldateien verweisen.  
 *Required*: No  
 *Standardwert*: `true` <a name="ref-cli-cmd-options-strict"></a>

 `--strict <BOOLEAN>`   
Konstruieren Sie keine Stapel, die Warnungen enthalten.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-trace"></a>

 `--trace <BOOLEAN>`   
Druckt den Trace für Stack-Warnungen.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-verbose"></a>

 `--verbose, -v <COUNT>`   
Debug-Protokolle anzeigen. Sie können diese Option mehrfach angeben, um die Ausführlichkeit zu erhöhen.  
 *Required*: No<a name="ref-cli-cmd-options-version"></a>

 `--version <BOOLEAN>`   
Zeigt die CDK-CLI-Versionsnummer an.  
 *Required*: No  
 *Standardwert*: `false` <a name="ref-cli-cmd-options-version-reporting"></a>

 `--version-reporting <BOOLEAN>`   
Nehmen Sie die ` AWS::CDK::Metadata` Ressource in synthetisierte Vorlagen AWS CloudFormation auf.  
 *Required*: No  
 *Standardwert*: `true` 

## Bereitstellung und Konfiguration von Optionen
<a name="ref-cli-cmd-configure"></a>

Sie können Optionen über Befehlszeilenargumente übergeben. Für die meisten Optionen können Sie sie in einer `cdk.json` Konfigurationsdatei konfigurieren. Wenn Sie mehrere Konfigurationsquellen verwenden, beachtet die CDK-CLI den folgenden Vorrang:

1.  **Befehlszeilenwerte** — Jede in der Befehlszeile angegebene Option überschreibt die in Dateien konfigurierten Optionen. `cdk.json`

1.  **Projektkonfigurationsdatei** — Die `cdk.json` Datei im Verzeichnis Ihres CDK-Projekts.

1.  **Benutzerkonfigurationsdatei** — Die `cdk.json` Datei, die sich `~/.cdk.json` auf Ihrem lokalen Computer befindet.

## Optionen an der Befehlszeile übergeben
<a name="ref-cli-cmd-pass"></a><a name="ref-cli-cmd-pass-bool"></a>

 **Boolesche Werte übergeben**   
Für Optionen, die einen booleschen Wert akzeptieren, können Sie sie auf folgende Weise angeben:  
+ Verwendung `true` und `false` Werte — Geben Sie den booleschen Wert mit dem Befehl an. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ cdk deploy --watch=true
  $ cdk deploy --watch=false
  ```
+ Geben Sie das Gegenstück zur Option an — Ändern Sie den Optionsnamen, indem Sie ihn hinzufügen`no`, um einen `false` Wert anzugeben. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ cdk deploy --watch
  $ cdk deploy --no-watch
  ```
+ Bei Optionen, die standardmäßig auf `true` oder gesetzt sind`false`, müssen Sie die Option nicht angeben, es sei denn, Sie möchten die Standardeinstellung ändern.

# `cdk acknowledge`
<a name="ref-cli-cmd-ack"></a>

Bestätigen Sie eine Mitteilung anhand der Problemnummer und verhindern Sie, dass sie erneut angezeigt wird.

Dies ist nützlich, um Hinweise auszublenden, die adressiert wurden oder die nicht auf Sie zutreffen.

Bestätigungen werden auf CDK-Projektebene gespeichert. Wenn Sie einen Hinweis in einem CDK-Projekt bestätigen, wird er weiterhin in anderen Projekten angezeigt, bis er dort bestätigt wird.

## Verwendung
<a name="ref-cli-cmd-ack-usage"></a>

```
$ cdk acknowledge <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-ack-args"></a><a name="ref-cli-cmd-ack-args-notice-id"></a>

 **ID des Hinweises**   
Die ID der Mitteilung.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-ack-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-ack-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk acknowledge` Befehl an.

## Beispiele
<a name="ref-cli-cmd-ack-examples"></a>

### Bestätigen und verbergen Sie einen Hinweis, der angezeigt wird, wenn Sie einen anderen CDK-CLI-Befehl ausführen
<a name="ref-cli-cmd-ack-examples-1"></a>

```
$ cdk deploy
... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061

$ cdk acknowledge 16603
```

# `cdk bootstrap`
<a name="ref-cli-cmd-bootstrap"></a>

Bereiten Sie eine AWS Umgebung für CDK-Bereitstellungen vor, indem Sie den CDK-Bootstrap-Stack (genannt`CDKToolkit`) in der Umgebung bereitstellen. AWS 

Der Bootstrap-Stack ist ein CloudFormation Stack, der einen Amazon S3 S3-Bucket und ein Amazon ECR-Repository in der AWS Umgebung bereitstellt. Die AWS CDK-CLI verwendet diese Ressourcen, um synthetisierte Vorlagen und zugehörige Ressourcen während der Bereitstellung zu speichern.

## Verwendung
<a name="ref-cli-cmd-bootstrap-usage"></a>

```
$ cdk bootstrap <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-bootstrap-args"></a><a name="ref-cli-cmd-bootstrap-args-env"></a>

 ** AWS Umgebung**   
Die AWS Zielumgebung, in der der Bootstrap-Stack bereitgestellt werden soll, im folgenden Format:`aws://<account-id>/<region>`.  
Beispiel: `aws://123456789012/us-east-1`   
Dieses Argument kann in einem einzigen Befehl mehrmals angegeben werden, um den Bootstrap-Stack in mehreren Umgebungen bereitzustellen.  
Standardmäßig bootet die CDK-CLI alle Umgebungen, auf die in der CDK-App verwiesen wird, oder ermittelt eine Umgebung aus Standardquellen. Dies kann eine Umgebung sein, die mit der `--profile` Option angegeben wurde, aus Umgebungsvariablen oder AWS Standard-CLI-Quellen.

## Optionen
<a name="ref-cli-cmd-bootstrap-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-bootstrap-options-bootstrap-bucket-name"></a>

 `--bootstrap-bucket-name, --toolkit-bucket-name, -b <STRING>`   
Der Name des Amazon S3 S3-Buckets, der von der CDK-CLI verwendet wird. Dieser Bucket wird erstellt und darf derzeit nicht existieren.  
Geben Sie diese Option an, um den Standardnamen des Amazon S3 S3-Buckets zu überschreiben.  
Wenn Sie diese Option verwenden, müssen Sie die Synthese möglicherweise anpassen. Weitere Informationen finden Sie unter [Anpassen der CDK-Stack-Synthese](configure-synth.md#bootstrapping-custom-synth).  
 *Standardwert: Undefiniert*<a name="ref-cli-cmd-bootstrap-options-bootstrap-customer-key"></a>

 `--bootstrap-customer-key <BOOLEAN>`   
Erstellen Sie einen Customer Master Key (CMK) für den Bootstrap-Bucket (es fallen Gebühren an, aber Sie können die Berechtigungen anpassen, nur modernes Bootstrapping).  
Diese Option ist nicht kompatibel mit. `--bootstrap-kms-key-id`  
 *Standardwert*: Undefiniert<a name="ref-cli-cmd-bootstrap-options-bootstrap-kms-key-id"></a>

 `--bootstrap-kms-key-id <STRING>`   
Die AWS KMS-Masterschlüssel-ID, die für die `SSE-KMS` Verschlüsselung verwendet werden soll.  
Stellen Sie diese Option bereit, um den AWS Standard-KMS-Schlüssel zu überschreiben, der zum Verschlüsseln des Amazon S3 S3-Buckets verwendet wird.  
Diese Option ist nicht kompatibel mit`--bootstrap-customer-key`.  
 *Standardwert*: Undefiniert<a name="ref-cli-cmd-bootstrap-options-cloudformation-execution-policies"></a>

 `--cloudformation-execution-policies <ARRAY>`   
Die verwaltete IAM-Richtlinie ARNs , die der Bereitstellungsrolle zugewiesen werden sollte, die AWS CloudFormation bei der Bereitstellung Ihrer Stacks übernommen wurde.  
Standardmäßig werden Stacks mithilfe der Richtlinie mit vollen Administratorrechten bereitgestellt. `AdministratorAccess`  
Sie können diese Option in einem einzigen Befehl mehrfach angeben. Sie können ARNs auch mehrere in einer einzigen Zeichenfolge angeben, wobei die einzelnen durch Kommas ARNs getrennt werden. Im Folgenden wird ein Beispiel gezeigt:  

```
$ cdk bootstrap --cloudformation-execution-policies "arn:aws:iam::aws:policy/AWSLambda_FullAccess,arn:aws:iam::aws:policy/AWSCodeDeployFullAccess"
```
Um Bereitstellungsfehler zu vermeiden, stellen Sie sicher, dass die von Ihnen angegebenen Richtlinien für alle Bereitstellungen, die Sie in der Umgebung durchführen, für die das Bootstrapping ausgeführt wird, ausreichend sind.  
Diese Option gilt nur für modernes Bootstrapping.  
Die moderne Bootstrap-Vorlage gewährt praktisch jedem AWS Konto in der Liste die in der `--cloudformation-execution-policies` Liste enthaltenen Berechtigungen. `--trust` Standardmäßig werden dadurch die Lese- und Schreibberechtigungen für alle Ressourcen im Bootstrap-Konto erweitert. Stellen Sie sicher, dass [Sie den Bootstrapping-Stack mit Richtlinien und vertrauenswürdigen Konten konfigurieren](bootstrapping-customizing.md), mit denen Sie vertraut sind.
 *Standardwert*: `[]` <a name="ref-cli-cmd-bootstrap-options-custom-permissions-boundary"></a>

 `--custom-permissions-boundary, -cpb <STRING>`   
Geben Sie den Namen einer zu verwendenden Berechtigungsgrenze an.  
Diese Option ist nicht kompatibel mit`--example-permissions-boundary`.  
 *Standardwert*: Undefiniert<a name="ref-cli-cmd-bootstrap-options-example-permissions-boundary"></a>

 `--example-permissions-boundary, -epb <BOOLEAN>`   
Verwenden Sie das Beispiel für die Rechtegrenze, die vom AWS CDK bereitgestellt wird.  
Diese Option ist nicht kompatibel mit`--custom-permissions-boundary`.  
Die vom CDK bereitgestellte Grenzrichtlinie für Berechtigungen sollte als Beispiel betrachtet werden. Bearbeiten Sie den Inhalt und verweisen Sie auf die Beispielrichtlinie, wenn Sie die Funktion testen. Wandeln Sie sie in eine neue Richtlinie für tatsächliche Bereitstellungen um, falls noch keine vorhanden ist. Es geht darum, Abweichungen zu vermeiden. Höchstwahrscheinlich wird eine Rechtegrenze beibehalten und es gibt spezielle Konventionen, einschließlich der Benennung.  
Weitere Informationen zur Konfiguration von Berechtigungen, einschließlich der Verwendung von Rechtegrenzen, finden Sie im [Security and Safety Dev Guide](https://github.com/aws/aws-cdk/wiki/Security-And-Safety-Dev-Guide).  
 *Standardwert*: Undefiniert<a name="ref-cli-cmd-bootstrap-options-execute"></a>

 `--execute <BOOLEAN>`   
Konfigurieren Sie, ob der Änderungssatz ausgeführt werden soll.  
 *Standardwert*: `true` <a name="ref-cli-cmd-bootstrap-options-force"></a>

 `--force, -f <BOOLEAN>`   
Führen Sie immer Bootstrap durch, auch wenn dadurch die Bootstrap-Vorlagenversion herabgestuft würde.  
 *Standardwert*: `false` <a name="ref-cli-cmd-bootstrap-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den Befehl an. `cdk bootstrap`<a name="ref-cli-cmd-bootstrap-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Verwenden Sie vorherige Werte für vorhandene Parameter.  
Sobald eine Bootstrap-Vorlage mit einer Reihe von Parametern bereitgestellt wurde, müssen Sie diese Option auf setzen, `false` um alle Parameter bei future Bereitstellungen zu ändern. Wenn`false`, müssen Sie alle zuvor angegebenen Parameter erneut angeben.  
 *Standardwert*: `true` <a name="ref-cli-cmd-bootstrap-options-public-access-block-configuration"></a>

 `--public-access-block-configuration <BOOLEAN>`   
Blockieren Sie die öffentliche Zugriffskonfiguration auf dem Amazon S3 S3-Bucket, der von der CDK-CLI erstellt und verwendet wird.  
 *Standardwert*: `true` <a name="ref-cli-cmd-bootstrap-options-qualifier"></a>

 `--qualifier <STRING>`   
Neunstelliger Zeichenkettenwert, der für jeden Bootstrap-Stack eindeutig ist. Dieser Wert wird zur physischen ID der Ressourcen im Bootstrap-Stack hinzugefügt.  
Durch die Bereitstellung eines Qualifizierers vermeiden Sie Konflikte bei Ressourcennamen, wenn Sie mehrere Bootstrap-Stacks in derselben Umgebung bereitstellen.  
Wenn Sie den Qualifier ändern, muss Ihre CDK-App den geänderten Wert an den Stack-Synthesizer übergeben. Weitere Informationen finden Sie unter [Anpassen der CDK-Stacksynthese](configure-synth.md#bootstrapping-custom-synth).  
 *Standardwert*: `hnb659fds`. Dieser Wert hat keine Bedeutung.<a name="ref-cli-cmd-bootstrap-options-show-template"></a>

 `--show-template <BOOLEAN>`   
Anstatt Bootstrapping durchzuführen, drucken Sie die aktuelle Bootstrap-Vorlage auf die Standardausgabe (). `stdout` Anschließend können Sie die Vorlage kopieren und nach Bedarf anpassen.  
 *Standardwert*: `false` <a name="ref-cli-cmd-bootstrap-options-tags"></a>

 `--tags, -t <ARRAY>`   
Tags, die dem Bootstrap-Stack hinzugefügt werden sollen, im Format von`KEY=VALUE`.  
 *Standardwert*: `[]` <a name="ref-cli-cmd-bootstrap-options-template"></a>

 `--template <STRING>`   
Verwenden Sie die Vorlage aus der angegebenen Datei anstelle der integrierten.<a name="ref-cli-cmd-bootstrap-options-termination-protection"></a>

 `--termination-protection <BOOLEAN>`   
Schalten Sie den AWS CloudFormation Terminierungsschutz auf dem Bootstrap-Stack um.  
Wann ist `true` der Kündigungsschutz aktiviert. Dadurch wird verhindert, dass der Bootstrap-Stack versehentlich gelöscht wird.  
Weitere Informationen zum Kündigungsschutz finden Sie im * AWS CloudFormation Benutzerhandbuch* unter [Einen Stack vor dem Löschen schützen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-protect-stacks.html).  
 *Standardwert*: Undefiniert<a name="ref-cli-cmd-bootstrap-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Der Name des zu erstellenden Bootstrap-Stacks.  
`cdk bootstrap`Stellt standardmäßig einen Stack mit dem Namen `CDKToolkit` in der angegebenen AWS Umgebung bereit. Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.  
Die CDK-CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.  
 *Standardwert*: `CDKToolkit`   
 *Erforderlich*: Ja<a name="ref-cli-cmd-bootstrap-options-trust"></a>

 `--trust <ARRAY>`   
Das AWS Konto IDs , dem bei der Durchführung von Bereitstellungen in dieser Umgebung vertraut werden sollte.  
Dem Konto, das das Bootstrapping durchführt, wird immer vertraut.  
Diese Option erfordert, dass Sie auch Folgendes angeben. `--cloudformation-execution-policies`  
Sie können diese Option in einem einzigen Befehl mehrfach angeben.  
Diese Option gilt nur für modernes Bootstrapping.  
Um vertrauenswürdige Konten zu einem vorhandenen Bootstrap-Stack hinzuzufügen, müssen Sie alle Konten angeben, denen Sie vertrauen möchten, einschließlich der Konten, die Sie möglicherweise zuvor angegeben haben. Wenn Sie nur neue Konten angeben, denen Sie vertrauen können, werden die zuvor vertrauenswürdigen Konten entfernt.  
Im Folgenden finden Sie ein Beispiel, bei dem zwei Konten als vertrauenswürdig eingestuft werden:  

```
$ cdk bootstrap aws://123456789012/us-west-2 --trust 234567890123 --trust 987654321098 --cloudformation-execution-policies arn:aws:iam::aws:policy/AdministratorAccess
 ⏳  Bootstrapping environment aws://123456789012/us-west-2...
Trusted accounts for deployment: 234567890123, 987654321098
Trusted accounts for lookup: (none)
Execution policies: arn:aws:iam::aws:policy/AdministratorAccess
CDKToolkit: creating CloudFormation changeset...
 ✅  Environment aws://123456789012/us-west-2 bootstrapped.
```
Die moderne Bootstrap-Vorlage gewährt praktisch jedem AWS Konto in der Liste die in der `--cloudformation-execution-policies` Liste enthaltenen Berechtigungen. `--trust` Standardmäßig werden dadurch die Lese- und Schreibberechtigungen für alle Ressourcen im Bootstrap-Konto erweitert. Stellen Sie sicher, dass [Sie den Bootstrapping-Stack mit Richtlinien und vertrauenswürdigen Konten konfigurieren](bootstrapping-customizing.md), mit denen Sie vertraut sind.
 *Standardwert*: `[]` <a name="ref-cli-cmd-bootstrap-options-trust-for-lookup"></a>

 `--trust-for-lookup <ARRAY>`   
Das AWS Konto IDs , dem beim Nachschlagen von Werten in dieser Umgebung vertraut werden sollte.  
Verwenden Sie diese Option, um Konten die Erlaubnis zu erteilen, Stacks zu synthetisieren, die in der Umgebung bereitgestellt werden, ohne ihnen tatsächlich die Erlaubnis zu geben, diese Stacks direkt bereitzustellen.  
Sie können diese Option in einem einzigen Befehl mehrfach angeben.  
Diese Option gilt nur für modernes Bootstrapping.  
 *Standardwert*: `[]` 

## Beispiele
<a name="ref-cli-cmd-bootstrap-examples"></a>

### Bootstrap für die im AWS Produktprofil angegebene Umgebung
<a name="ref-cli-cmd-bootstrap-examples-1"></a>

```
$ cdk bootstrap --profile prod
```

### Stellen Sie den Bootstrap-Stack in den Umgebungen foo und bar bereit
<a name="ref-cli-cmd-bootstrap-examples-2"></a>

```
$ cdk bootstrap --app='node bin/main.js' foo bar
```

### Exportieren Sie die Bootstrap-Vorlage, um sie anzupassen
<a name="ref-cli-cmd-bootstrap-examples-3"></a>

Wenn Sie spezielle Anforderungen haben, die von der Bootstrap-Vorlage nicht erfüllt werden, können Sie sie an Ihre Bedürfnisse anpassen.

Sie können die Bootstrap-Vorlage exportieren, ändern und mithilfe dieser Methode bereitstellen. AWS CloudFormation Im Folgenden finden Sie ein Beispiel für den Export der vorhandenen Vorlage:

```
$ cdk bootstrap --show-template > bootstrap-template.yaml
```

Sie können die CDK-CLI auch anweisen, eine benutzerdefinierte Vorlage zu verwenden. Im Folgenden wird ein Beispiel gezeigt:

```
$ cdk bootstrap --template my-bootstrap-template.yaml
```

### Bootstrap mit einer Berechtigungsgrenze. Entfernen Sie dann diese Berechtigungsgrenze
<a name="ref-cli-cmd-bootstrap-examples-4"></a>

Um mit einer benutzerdefinierten Berechtigungsgrenze zu booten, führen wir Folgendes aus:

```
$ cdk bootstrap --custom-permissions-boundary my-permissions-boundary
```

Um die Berechtigungsgrenze zu entfernen, führen wir Folgendes aus:

```
$ cdk bootstrap --no-previous-parameters
```

### Verwenden Sie einen Qualifier, um Ressourcen zu unterscheiden, die für eine Entwicklungsumgebung erstellt wurden
<a name="ref-cli-cmd-bootstrap-examples-5"></a>

```
$ cdk bootstrap --qualifier dev2024
```

# `cdk context`
<a name="ref-cli-cmd-context"></a>

Verwalten Sie zwischengespeicherte Kontextwerte für Ihre AWS CDK-Anwendung.

 Der *Kontext* stellt die Konfiguration und Umgebungsinformationen dar, die beeinflussen können, wie Ihre Stacks synthetisiert und bereitgestellt werden. Mit `cdk context` können folgende Arbeiten durchgeführt werden:
+ Sehen Sie sich Ihre konfigurierten Kontextwerte an.
+ Legen Sie Kontextwerte fest und verwalten Sie sie.
+ Kontextwerte entfernen.

## Verwendung
<a name="ref-cli-cmd-context-usage"></a>

```
$ cdk context <options>
```

## Optionen
<a name="ref-cli-cmd-context-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-context-options-clear"></a>

 `--clear <BOOLEAN>`   
Löscht den gesamten Kontext.<a name="ref-cli-cmd-context-options-force"></a>

 `--force, -f <BOOLEAN>`   
Ignoriere den Fehler mit fehlendem Schlüssel.  
 *Standardwert*: `false` <a name="ref-cli-cmd-context-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk context` Befehl an.<a name="ref-cli-cmd-context-options-reset"></a>

 `--reset, -e <STRING>`   
Der Kontextschlüssel oder sein Index, der zurückgesetzt werden soll.

# `cdk deploy`
<a name="ref-cli-cmd-deploy"></a>

Stellen Sie einen oder mehrere AWS CDK-Stacks in Ihrer Umgebung bereit. AWS 

Während der Bereitstellung gibt die CDK-CLI Fortschrittsindikatoren aus, ähnlich denen, die von der AWS CloudFormation Konsole aus beobachtet werden können.

Wenn in der AWS Umgebung kein Bootstrapping durchgeführt wird, können nur Stacks ohne Ressourcen und mit synthetisierten Vorlagen unter 51.200 Byte erfolgreich bereitgestellt werden.

## Verwendung
<a name="ref-cli-cmd-deploy-usage"></a>

```
$ cdk deploy <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-deploy-args"></a><a name="ref-cli-cmd-deploy-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, die bereitgestellt werden soll.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-deploy-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-deploy-options-all"></a>

 `--all <BOOLEAN>`   
Stellen Sie alle Stacks in Ihrer CDK-App bereit.  
 *Standardwert*: `false` <a name="ref-cli-cmd-deploy-options-asset-parallelism"></a>

 `--asset-parallelism <BOOLEAN>`   
Geben Sie an, ob Assets parallel erstellt und veröffentlicht werden sollen.<a name="ref-cli-cmd-deploy-options-asset-prebuild"></a>

 `--asset-prebuild <BOOLEAN>`   
Geben Sie an, ob alle Assets erstellt werden sollen, bevor der erste Stack bereitgestellt wird. Diese Option ist nützlich, wenn Docker-Builds fehlschlagen.  
 *Standardwert*: `true` <a name="ref-cli-cmd-deploy-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Das Asset mit der angegebenen ID nicht neu erstellen.  
Diese Option kann in einem einzigen Befehl mehrfach angegeben werden.  
 *Standardwert*: `[]` <a name="ref-cli-cmd-deploy-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Der Name des zu erstellenden AWS CloudFormation Änderungssatzes.  
Diese Option ist nicht kompatibel mit`--method='direct'`.<a name="ref-cli-cmd-deploy-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Stellen Sie mehrere Stacks parallel bereit und berücksichtigen Sie dabei die Abhängigkeiten zwischen den Stacks. Verwenden Sie diese Option, um Bereitstellungen zu beschleunigen. Sie müssen immer noch andere AWS CloudFormation Gebührenbegrenzungen für AWS Ihr Konto berücksichtigen.  
Geben Sie eine Zahl ein, um die maximale Anzahl gleichzeitiger Bereitstellungen anzugeben (sofern die Abhängigkeit dies zulässt).  
 *Standardwert*: `1` <a name="ref-cli-cmd-deploy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Stellen Sie nur angeforderte Stacks bereit und schließen Sie keine Abhängigkeiten ein.<a name="ref-cli-cmd-deploy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Wenn Sie einen vorhandenen Stack bereitstellen, um ihn zu aktualisieren, vergleicht die CDK-CLI die Vorlage und die Tags des bereitgestellten Stacks mit dem Stack, der gerade bereitgestellt werden soll. Wenn keine Änderungen festgestellt werden, überspringt die CDK-CLI die Bereitstellung.  
Um dieses Verhalten zu überschreiben und Stacks immer bereitzustellen, auch wenn keine Änderungen erkannt werden, verwenden Sie diese Option.  
 *Standardwert*: `false` <a name="ref-cli-cmd-deploy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk deploy` Befehl an.<a name="ref-cli-cmd-deploy-options-hotswap"></a>

 `--hotswap <BOOLEAN>`   
Hotswap-Bereitstellungen für eine schnellere Entwicklung. Mit dieser Option wird versucht, wenn möglich eine schnellere Hotswap-Bereitstellung durchzuführen. Wenn Sie beispielsweise den Code einer Lambda-Funktion in Ihrer CDK-App ändern, aktualisiert die CDK-CLI die Ressource direkt über den Service, APIs anstatt eine Bereitstellung durchzuführen. CloudFormation   
Wenn die CDK-CLI Änderungen erkennt, die Hotswapping nicht unterstützen, werden diese Änderungen ignoriert und eine Meldung wird angezeigt. Wenn Sie es vorziehen, eine vollständige CloudFormation Bereitstellung als Ausweichlösung durchzuführen, verwenden Sie stattdessen. `--hotswap-fallback`  
Die CDK-CLI verwendet Ihre aktuellen AWS Anmeldeinformationen, um die API-Aufrufe durchzuführen. Sie übernimmt nicht die Rollen aus Ihrem Bootstrap-Stack, auch wenn das `@aws-cdk/core:newStyleStackSynthesis` Feature-Flag auf gesetzt ist. `true` Diese Rollen verfügen nicht über die erforderlichen Berechtigungen, um AWS Ressourcen direkt zu aktualisieren, ohne sie zu verwenden CloudFormation. Stellen Sie daher sicher, dass Ihre Anmeldeinformationen für dasselbe AWS Konto der Stacks gelten, für das Sie Hotswap-Bereitstellungen durchführen, und dass diese über die erforderlichen IAM-Berechtigungen verfügen, um die Ressourcen zu aktualisieren.  
Hotswapping wird derzeit für die folgenden Änderungen unterstützt:  
+ Code-Assets (einschließlich Docker-Images und Inline-Code), Tag-Änderungen und Konfigurationsänderungen (nur Beschreibungs- und Umgebungsvariablen werden unterstützt) von Lambda-Funktionen.
+ Lambda-Versionen und Alias-Änderungen.
+ Definitionsänderungen von AWS Step Functions Functions-Zustandsmaschinen.
+ Änderungen der Container-Assets der Amazon ECS-Services.
+ Änderungen der Website-Ressourcen von Amazon S3 S3-Bucket-Bereitstellungen.
+ Änderungen an Quelle und Umgebung von AWS CodeBuild Projekten.
+ Änderungen an der VTL-Mapping-Vorlage für AWS AppSync Resolver und Funktionen.
+ Schemaänderungen für AWS AppSync GraphQL APIs.
Die Verwendung bestimmter CloudFormation systemeigener Funktionen wird im Rahmen einer Hotswap-Bereitstellung unterstützt. Dazu zählen:  
+  `Ref` 
+  `Fn::GetAtt`— Nur teilweise unterstützt. Informationen zu den unterstützten Ressourcen und Attributen finden Sie in [dieser Implementierung](https://github.com/aws/aws-cdk/blob/main/packages/aws-cdk/lib/api/evaluate-cloudformation-template.ts#L477-L492).
+  `Fn::ImportValue` 
+  `Fn::Join` 
+  `Fn::Select` 
+  `Fn::Split` 
+  `Fn::Sub` 
Diese Option ist auch mit verschachtelten Stacks kompatibel.  
+ Diese Option führt bewusst zu einer Drift bei den CloudFormation Stacks, um Bereitstellungen zu beschleunigen. Verwenden Sie sie aus diesem Grund nur für Entwicklungszwecke. Verwenden Sie diese Option nicht für Ihre Produktionsbereitstellungen.
+ Diese Option gilt als experimentell und könnte sich in future grundlegend ändern.
+ Die Standardwerte für bestimmte Parameter können je nach Hotswap-Parameter unterschiedlich sein. Beispielsweise wird für einen Amazon ECS-Service derzeit ein Mindestwert für fehlerfreie Werte festgelegt`0`. Überprüfen Sie die Quelle entsprechend, falls dies der Fall ist.
 *Standardwert*: `false` <a name="ref-cli-cmd-deploy-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
Diese Option ist ähnlich wie`--hotswap`. Der Unterschied besteht darin, dass auf eine vollständige CloudFormation Bereitstellung zurückgegriffen `--hotswap-fallback` wird, wenn eine Änderung erkannt wird, die dies erfordert.  
Weitere Informationen zu dieser Option finden Sie unter `--hotswap`.  
 *Standardwert*: `false` <a name="ref-cli-cmd-deploy-options-ignore-no-stacks"></a>

 `--ignore-no-stacks <BOOLEAN>`   
Führen Sie eine Bereitstellung durch, auch wenn Ihre CDK-App keine Stacks enthält.  
Diese Option ist im folgenden Szenario hilfreich: Möglicherweise haben Sie eine App mit mehreren Umgebungen, z. B. `dev` und. `prod` Wenn Sie mit der Entwicklung beginnen, verfügt Ihre Prod-App möglicherweise über keine Ressourcen, oder die Ressourcen sind auskommentiert. Dies führt zu einem Bereitstellungsfehler mit einer Meldung, dass die App keine Stacks hat. Wird verwendet`--ignore-no-stacks`, um diesen Fehler zu umgehen.  
 *Standardwert*: `false` <a name="ref-cli-cmd-deploy-options-import-existing-resources"></a>

 `--import-existing-resources <BOOLEAN>`   
Importieren Sie vorhandene, nicht verwaltete AWS CloudFormation Ressourcen aus Ihrem AWS Konto.  
Wenn Sie diese Option verwenden, werden Ressourcen aus Ihrer synthetisierten AWS CloudFormation Vorlage mit demselben benutzerdefinierten Namen wie bestehende nicht verwaltete Ressourcen in demselben Konto in Ihren Stack importiert.  
Sie können diese Option verwenden, um vorhandene Ressourcen in neue oder bestehende Stacks zu importieren.  
Mit demselben `cdk deploy` Befehl können Sie vorhandene Ressourcen importieren und neue Ressourcen bereitstellen.  
Weitere Informationen zu benutzerdefinierten [Namen finden Sie im * AWS CloudFormation Benutzerhandbuch* unter Namenstyp](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html).  
Weitere Informationen zu diesem `ImportExistingResources` CloudFormation Parameter finden Sie unter [AWS CloudFormation Vereinfacht den Ressourcenimport mit einem neuen Parameter für ChangeSets](https://aws.amazon.com/about-aws/whats-new/2023/11/aws-cloudformation-import-parameter-changesets/).  
Weitere Informationen zur Verwendung dieser Option finden Sie unter [Importieren vorhandener Ressourcen](https://github.com/aws/aws-cdk-cli/tree/main/packages/aws-cdk#import-existing-resources) im *aws-cdk-cli GitHub Repository*.<a name="ref-cli-cmd-deploy-options-logs"></a>

 `--logs <BOOLEAN>`   
Zeigt das CloudWatch Amazon-Protokoll in der Standardausgabe (`stdout`) für alle Ereignisse aus allen Ressourcen in den ausgewählten Stacks an.  
Diese Option ist nur kompatibel mit`--watch`.  
 *Standardwert*: `true` <a name="ref-cli-cmd-deploy-options-method"></a>

 `--method, -m <STRING>`   
Konfigurieren Sie die Methode zur Durchführung einer Bereitstellung.  
+  `change-set`— Standardmethode. Die CDK-CLI erstellt einen CloudFormation Änderungssatz mit den Änderungen, die bereitgestellt werden, und führt dann die Bereitstellung durch.
+  `direct`— Erstellen Sie keinen Änderungssatz. Wenden Sie die Änderung stattdessen sofort an. Dies ist in der Regel schneller als das Erstellen eines Änderungssatzes, aber Sie verlieren Details zum Bereitstellungsfortschritt in der CLI-Ausgabe.
+  `prepare-change-set`— Erstellen Sie einen Änderungssatz, führen Sie aber keine Bereitstellung durch. Dies ist nützlich, wenn Sie über externe Tools verfügen, die den Änderungssatz überprüfen, oder wenn Sie über ein Genehmigungsverfahren für Änderungssätze verfügen.
 *Gültige Werte*:`change-set`,`direct`, `prepare-change-set`   
 *Standardwert*: `change-set` <a name="ref-cli-cmd-deploy-options-notification-arns"></a>

 `--notification-arns <ARRAY>`   
Die ARNs Amazon SNS SNS-Themen, die über Ereignisse im Zusammenhang mit dem Stack benachrichtigt CloudFormation werden.<a name="ref-cli-cmd-deploy-options-outputs-file"></a>

 `--outputs-file, -O <STRING>`   
Der Pfad, in den die Stack-Ausgaben von Bereitstellungen geschrieben werden.  
Nach der Bereitstellung werden die Stack-Ausgaben im JSON-Format in die angegebene Ausgabedatei geschrieben.  
Sie können diese Option in der `cdk.json` Projektdatei oder `~/.cdk.json` auf Ihrem lokalen Entwicklungscomputer konfigurieren:  

```
{
   "app": "npx ts-node bin/myproject.ts",
   // ...
   "outputsFile": "outputs.json"
}
```
Wenn mehrere Stapel bereitgestellt werden, werden die Ausgaben in dieselbe Ausgabedatei geschrieben, die nach Schlüsseln geordnet ist, die den Stacknamen darstellen.<a name="ref-cli-cmd-deploy-options-parameters"></a>

 `--parameters <ARRAY>`   
Übergeben Sie CloudFormation während der Bereitstellung zusätzliche Parameter an.  
Diese Option akzeptiert ein Array im folgenden Format:`STACK:KEY=VALUE`.  
+  `STACK`— Der Name des Stacks, dem der Parameter zugeordnet werden soll.
+  `KEY`— Der Name des Parameters aus Ihrem Stack.
+  `VALUE`— Der Wert, der bei der Bereitstellung übergeben werden soll.
Wenn kein Stack-Name angegeben wird oder wenn `*` er als Stack-Name angegeben wird, werden Parameter auf alle Stacks angewendet, die bereitgestellt werden. Wenn ein Stack den Parameter nicht verwendet, schlägt die Bereitstellung fehl.  
Parameter werden nicht auf verschachtelte Stacks übertragen. Verwenden Sie das Konstrukt, um Parameter an verschachtelte Stacks zu übergeben. ` [NestedStack](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.NestedStack.html) `  
 *Standardwert*: `{}` <a name="ref-cli-cmd-deploy-options-previous-parameters"></a>

 `--previous-parameters <BOOLEAN>`   
Verwenden Sie vorherige Werte für bestehende Parameter.  
Wenn diese Option auf gesetzt ist`false`, müssen Sie bei jeder Bereitstellung alle Parameter angeben.  
 *Standardwert*: `true` <a name="ref-cli-cmd-deploy-options-progress"></a>

 `--progress <STRING>`   
Konfigurieren Sie, wie die CDK-CLI den Bereitstellungsfortschritt anzeigt.  
+  `bar`— Zeigt Ereignisse bei der Stack-Bereitstellung als Fortschrittsbalken an, zusammen mit den Ereignissen für die Ressource, die gerade bereitgestellt wird.
+  `events`— Stellen Sie einen vollständigen Verlauf bereit, einschließlich aller CloudFormation Ereignisse.
Sie können diese Option auch in der `cdk.json` Projektdatei oder `~/.cdk.json` auf Ihrem lokalen Entwicklungscomputer konfigurieren:  

```
{
   "progress": "events"
}
```
 *Zulässige Werte*: `bar`, `events`   
 *Standardwert*: `bar` <a name="ref-cli-cmd-deploy-options-require-approval"></a>

 `--require-approval <STRING>`   
Geben Sie an, für welche sicherheitsrelevanten Änderungen eine manuelle Genehmigung erforderlich ist.  
+  `any-change`— Für jede Änderung am Stack ist eine manuelle Genehmigung erforderlich.
+  `broadening`— Manuelle Genehmigung erforderlich, wenn Änderungen eine Erweiterung der Berechtigungen oder Sicherheitsgruppenregeln beinhalten.
+  `never`— Eine Genehmigung ist nicht erforderlich.
 *Gültige Werte*:`any-change`,`broadening`, `never`   
 *Standardwert*: `broadening` <a name="ref-cli-cmd-deploy-options-rollback"></a>

 `--rollback` \$1 `--no-rollback`, `-R`   
Wenn während der Bereitstellung eine Ressource nicht erstellt oder aktualisiert werden kann, wird die Bereitstellung auf den neuesten stabilen Status zurückgesetzt, bevor die CDK-CLI zurückkehrt. Alle bis zu diesem Zeitpunkt vorgenommenen Änderungen werden rückgängig gemacht. Ressourcen, die erstellt wurden, werden gelöscht und vorgenommene Aktualisierungen werden rückgängig gemacht.  
Geben Sie `--no-rollback` an, dass dieses Verhalten ausgeschaltet werden soll. Wenn eine Ressource nicht erstellt oder aktualisiert werden kann, behält die CDK-CLI die bis zu diesem Zeitpunkt vorgenommenen Änderungen bei und kehrt zurück. Dadurch befindet sich Ihre Bereitstellung in einem fehlgeschlagenen, angehaltenen Zustand. Von hier aus können Sie Ihren Code aktualisieren und die Bereitstellung erneut versuchen. Dies kann in Entwicklungsumgebungen hilfreich sein, in denen Sie schnell iterieren.  
Wenn eine Bereitstellung, die mit ausgeführt wurde, `--no-rollback` fehlschlägt und Sie entscheiden, dass Sie die Bereitstellung rückgängig machen möchten, können Sie den `cdk rollback` Befehl verwenden. Weitere Informationen finden Sie unter [cdk rollback](ref-cli-cmd-rollback.md).  
Mit: Bereitstellungen`--no-rollback`, die zu einem Austausch von Ressourcen führen, schlagen immer fehl. Sie können diesen Optionswert nur für Bereitstellungen verwenden, bei denen neue Ressourcen aktualisiert oder erstellt werden.
 *Standardwert*: `--rollback` <a name="ref-cli-cmd-deploy-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Der Name des vorhandenen CDK Toolkit-Stacks.  
`cdk bootstrap`Stellt standardmäßig einen Stack mit dem Namen `CDKToolkit` in der angegebenen Umgebung bereit. AWS Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.  
Die CDK-CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.<a name="ref-cli-cmd-deploy-options-watch"></a>

 `--watch <BOOLEAN>`   
Beobachten Sie die CDK-Projektdateien kontinuierlich und stellen Sie die angegebenen Stacks automatisch bereit, wenn Änderungen erkannt werden.  
Diese Option impliziert `--hotswap` standardmäßig.  
Diese Option hat einen entsprechenden CDK-CLI-Befehl. Weitere Informationen finden Sie unter [cdk watch](ref-cli-cmd-watch.md).

## Beispiele
<a name="ref-cli-cmd-deploy-examples"></a>

### Stellen Sie den Stack mit dem Namen bereit MyStackName
<a name="ref-cli-cmd-deploy-examples-1"></a>

```
$ cdk deploy MyStackName --app='node bin/main.js'
```

### Stellen Sie mehrere Stacks in einer App bereit
<a name="ref-cli-cmd-deploy-examples-2"></a>

Verwenden Sie`cdk list`, um Ihre Stacks aufzulisten:

```
$ cdk list
CdkHelloWorldStack
CdkStack2
CdkStack3
```

Verwenden Sie die Option, um alle Stacks bereitzustellen: `--all`

```
$ cdk deploy --all
```

Um auszuwählen, welche Stacks bereitgestellt werden sollen, geben Sie Stack-Namen als Argumente an:

```
$ cdk deploy CdkHelloWorldStack CdkStack3
```

### Pipeline-Stacks bereitstellen
<a name="ref-cli-cmd-deploy-examples-3"></a>

Wird verwendet`cdk list`, um Stack-Namen als Pfade anzuzeigen und zu zeigen, wo sie sich in der Pipeline-Hierarchie befinden:

```
$ cdk list
PipelineStack
PiplelineStack/Prod
PipelineStack/Prod/MyService
```

Verwenden Sie die `--all` Option oder den Platzhalter`*`, um alle Stacks bereitzustellen. Wenn Sie eine Hierarchie von Stapeln haben, wie oben beschrieben, `--all` und `*` nur Stapel auf der obersten Ebene abgleichen möchten. Um alle Stapel in der Hierarchie abzugleichen, verwenden Sie. `**`

Sie können diese Muster kombinieren. Im Folgenden werden alle Stapel in der `Prod` Phase bereitgestellt:

```
$ cdk deploy PipelineStack/Prod/**
```

### Übergeben Sie die Parameter bei der Bereitstellung
<a name="ref-cli-cmd-deploy-examples-4"></a>

Definieren Sie Parameter in Ihrem CDK-Stack. Im Folgenden finden Sie ein Beispiel, das einen Parameter erstellt, der `TopicNameParam` nach einem Amazon SNS SNS-Thema benannt ist:

```
new sns.Topic(this, 'TopicParameter', {
    topicName: new cdk.CfnParameter(this, 'TopicNameParam').value.toString()
});
```

Um den Parameterwert von anzugeben`parameterized`, führen Sie den folgenden Befehl aus:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterized"
```

Sie können Parameterwerte überschreiben, indem Sie die `--force` Option verwenden. Im Folgenden finden Sie ein Beispiel für das Überschreiben des Themennamens aus einer früheren Bereitstellung:

```
$ cdk deploy --parameters "MyStackName:TopicNameParam=parameterName" --force
```

### Schreiben Sie die Stack-Ausgaben nach der Bereitstellung in eine Datei
<a name="ref-cli-cmd-deploy-examples-5"></a>

Definieren Sie Ausgaben in Ihrer CDK-Stack-Datei. Im Folgenden finden Sie ein Beispiel, das eine Ausgabe für eine Funktion ARN erstellt:

```
const fn = new lambda.Function(this, "fn", {
  handler: "index.handler",
  code: lambda.Code.fromInline(`exports.handler = \${handler.toString()}`),
  runtime: lambda.Runtime.NODEJS_LATEST
});

new cdk.CfnOutput(this, 'FunctionArn', {
  value: fn.functionArn,
});
```

Stellen Sie den Stack bereit und schreiben Sie die Ausgaben in`outputs.json`:

```
$ cdk deploy --outputs-file outputs.json
```

Das Folgende ist ein Beispiel für die Zeit `outputs.json` nach der Bereitstellung:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  }
}
```

In diesem Beispiel `FunctionArn` entspricht der Schlüssel der logischen ID der `CfnOutput` Instanz.

Im Folgenden finden Sie ein Beispiel für die Zeit `outputs.json` nach der Bereitstellung, wenn mehrere Stacks bereitgestellt werden:

```
{
  "MyStack": {
    "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:MyStack-fn5FF616E3-G632ITHSP5HK"
  },
  "AnotherStack": {
    "VPCId": "vpc-z0mg270fee16693f"
  }
}
```

### Ändern Sie die Bereitstellungsmethode
<a name="ref-cli-cmd-deploy-examples-6"></a>

Um die Bereitstellung ohne Verwendung von Änderungssätzen zu beschleunigen, verwenden Sie`--method='direct'`:

```
$ cdk deploy --method='direct'
```

Um einen Änderungssatz zu erstellen, ihn aber nicht bereitzustellen, verwenden Sie`--method='prepare-change-set'`. Standardmäßig wird ein Änderungssatz mit `cdk-deploy-change-set` dem Namen erstellt. Wenn ein früherer Änderungssatz mit diesem Namen existiert, wird er überschrieben. Wenn keine Änderungen erkannt werden, wird trotzdem ein leerer Änderungssatz erstellt.

Sie können Ihrem Änderungssatz auch einen Namen geben. Im Folgenden wird ein Beispiel gezeigt:

```
$ cdk deploy --method='prepare-change-set' --change-set-name='MyChangeSetName'
```

# `cdk destroy`
<a name="ref-cli-cmd-destroy"></a>

Löschen Sie einen oder mehrere AWS CDK-Stacks aus Ihrer Umgebung. AWS 

Wenn Sie einen Stack löschen, werden die Ressourcen im Stack zerstört, sofern sie nicht mit einem `DeletionPolicy` of konfiguriert wurden. `Retain`

Beim Löschen eines Stacks gibt dieser Befehl Fortschrittsinformationen aus, die dem `cdk deploy` Verhalten ähneln.

## Verwendung
<a name="ref-cli-cmd-destroy-usage"></a>

```
$ cdk destroy <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-destroy-args"></a><a name="ref-cli-cmd-destroy-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, der gelöscht werden soll.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-destroy-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-destroy-options-all"></a>

 `--all <BOOLEAN>`   
Zerstöre alle verfügbaren Stapel.  
 *Standardwert*: `false` <a name="ref-cli-cmd-destroy-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Zerstört nur angeforderte Stacks und schließt keine Abhängigkeiten ein.<a name="ref-cli-cmd-destroy-options-force"></a>

 `--force, -f <BOOLEAN>`   
Bitten Sie nicht um Bestätigung, bevor Sie die Stacks zerstören.<a name="ref-cli-cmd-destroy-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den `cdk destroy` Befehl an.

## Beispiele
<a name="ref-cli-cmd-destroy-examples"></a>

### Löscht einen Stapel mit dem Namen MyStackName
<a name="ref-cli-cmd-destroy-examples-1"></a>

```
$ cdk destroy --app='node bin/main.js' <MyStackName>
```

# `cdk diff`
<a name="ref-cli-cmd-diff"></a>

Führen Sie einen Vergleich durch, um die Infrastrukturänderungen zwischen den AWS CDK-Stacks zu sehen.

Dieser Befehl wird normalerweise verwendet, um Unterschiede zwischen dem aktuellen Status der Stacks in Ihrer lokalen CDK-App und den bereitgestellten Stacks zu vergleichen. Sie können jedoch auch einen bereitgestellten Stack mit einer beliebigen lokalen Vorlage vergleichen. AWS CloudFormation 

## Verwendung
<a name="ref-cli-cmd-diff-usage"></a>

```
$ cdk diff <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-diff-args"></a><a name="ref-cli-cmd-diff-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, um einen Vergleich durchzuführen.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-diff-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-diff-options-change-set"></a>

 `--change-set <BOOLEAN>`   
Geben Sie an, ob ein Änderungssatz erstellt werden soll, um den Austausch von Ressourcen zu analysieren.  
Wann `true` erstellt die CDK-CLI einen AWS CloudFormation Änderungssatz, um die genauen Änderungen anzuzeigen, die an Ihrem Stack vorgenommen werden. Diese Ausgabe beinhaltet, ob Ressourcen aktualisiert oder ersetzt werden. Die CDK-CLI verwendet die Bereitstellungsrolle anstelle der Suchrolle, um diese Aktion auszuführen.  
Wann wird `false` durch den Vergleich von Vorlagen ein schnellerer, aber weniger genauer Vergleich durchgeführt. CloudFormation Jede Änderung, die an Eigenschaften erkannt wird, für die eine Ressource ersetzt werden muss, wird als Ressourcenersatz angezeigt, auch wenn es sich um eine rein kosmetische Änderung handelt, z. B. das Ersetzen einer Ressourcenreferenz durch einen hartcodierten ARN.  
 *Standardwert*: `true` <a name="ref-cli-cmd-diff-options-context-lines"></a>

 `--context-lines <NUMBER>`   
Anzahl der Kontextzeilen, die in das beliebige JSON-Diff-Rendering aufgenommen werden sollen.  
 *Standardwert*: `3` <a name="ref-cli-cmd-diff-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Vergleicht nur angeforderte Stacks und schließt keine Abhängigkeiten ein.<a name="ref-cli-cmd-diff-options-fail"></a>

 `--fail <BOOLEAN>`   
Schlägt fehl und beendet das Programm mit dem Code`1`, ob Unterschiede erkannt wurden.<a name="ref-cli-cmd-diff-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk diff` Befehl an.<a name="ref-cli-cmd-diff-options-processed"></a>

 `--processed <BOOLEAN>`   
Geben Sie an, ob bereits verarbeitete CloudFormation Transformationen mit der Vorlage verglichen werden sollen.  
 *Standardwert*: `false` <a name="ref-cli-cmd-diff-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Drucken Sie den CDK-Stacknamen und die `cdk diff` Standardnachricht nicht aus, `stdout` wenn keine Änderungen erkannt wurden.  
 *Standardwert*: `false` <a name="ref-cli-cmd-diff-options-security-only"></a>

 `--security-only <BOOLEAN>`   
Nur Diff für erweiterte Sicherheitsänderungen.  
 *Standardwert*: `false` <a name="ref-cli-cmd-diff-options-strict"></a>

 `--strict <BOOLEAN>`   
Ändern Sie `cdk diff` das Verhalten, sodass es genauer oder strenger ist. Wenn der Wert true ist, filtert die CDK-CLI keine ` AWS::CDK::Metadata` Ressourcen oder unlesbaren Nicht-ASCII-Zeichen heraus.  
 *Standardwert*: `false` <a name="ref-cli-cmd-diff-options-template"></a>

 `--template <STRING>`   
Der Pfad zur CloudFormation Vorlage, mit der ein CDK-Stack verglichen werden soll.

## Beispiele
<a name="ref-cli-cmd-diff-examples"></a>

### Vergleich mit dem aktuell bereitgestellten Stack mit dem Namen MyStackName
<a name="ref-cli-cmd-diff-examples-1"></a>

Die CDK-CLI verwendet die folgenden Symbole in der Diff-Ausgabe:
+  `[+]`— Identifiziert Code oder Ressourcen, die hinzugefügt werden, wenn Sie Ihre Änderungen bereitstellen.
+  `[-]`— Identifiziert Code oder Ressourcen, die entfernt werden, wenn Sie Ihre Änderungen implementieren.
+  `[~]`— Identifiziert eine Ressource oder Eigenschaft, die geändert wird, wenn Sie Ihre Änderungen implementieren.

Das folgende Beispiel zeigt einen Unterschied zwischen lokalen Änderungen an einer Lambda-Funktion:

```
$ cdk diff MyStackName
start: Building <asset-hash>:<account:Region>
success: Built <asset-hash>:<account:Region>
start: Publishing <asset-hash>:<account:Region>
success: Published <asset-hash>:<account:Region>
Hold on while we create a read-only change set to get a diff with accurate replacement information (use --no-change-set to use a less accurate but faster template-only diff)
Stack MyStackName
Resources
[~] AWS::Lambda::Function HelloWorldFunction <resource-logical-ID>
 └─ [~] Code
     └─ [~] .ZipFile:
         ├─ [-]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello World!'),
          };
        };

         └─ [+]
        exports.handler = async function(event) {
          return {
            statusCode: 200,
            body: JSON.stringify('Hello from CDK!'),
          };
        };



✨  Number of stacks with differences: 1
```

Ein `[~]` Indikator für Ressourcen, die geändert werden, bedeutet nicht immer, dass Ressourcen vollständig ersetzt werden:
+ Einige Ressourceneigenschaften, z. `Code` B. werden die Ressource aktualisieren.
+ Einige Ressourceneigenschaften, wie z. B.`FunctionName`, können dazu führen, dass die Ressource vollständig ersetzt wird.

### Vergleich mit einer bestimmten CloudFormation Vorlage
<a name="ref-cli-cmd-diff-examples-2"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --template-path='./MyStackNameTemplate.yaml'
```

### Vergleicht einen lokalen Stack mit seinem bereitgestellten Stack. Druckt nicht auf die Standardausgabe, wenn keine Änderungen erkannt wurden
<a name="ref-cli-cmd-diff-examples-3"></a>

```
$ cdk diff MyStackName --app='node bin/main.js' --quiet
```

# `cdk docs`
<a name="ref-cli-cmd-docs"></a>

Öffnen Sie die AWS CDK-Dokumentation in Ihrem Browser.

## Verwendung
<a name="ref-cli-cmd-docs-usage"></a>

```
$ cdk docs <options>
```

## Optionen
<a name="ref-cli-cmd-docs-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-docs-options-browser"></a>

 `--browser, -b <STRING>`   
Der zum Öffnen des Browsers zu verwendende Befehl, der `%u` als Platzhalter für den Pfad der zu öffnenden Datei verwendet wird.  
 *Standardwert*: `open %u` <a name="ref-cli-cmd-docs-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk docs` Befehl an.

## Beispiele
<a name="ref-cli-cmd-docs-examples"></a>

### Öffnen Sie die AWS CDK-Dokumentation in Google Chrome
<a name="ref-cli-cmd-docs-examples-1"></a>

```
$ cdk docs --browser='chrome %u'
```

# `cdk doctor`
<a name="ref-cli-cmd-doctor"></a>

Untersuchen und zeigen Sie nützliche Informationen über Ihr lokales AWS CDK-Projekt und Ihre Entwicklungsumgebung an.

Diese Informationen können bei der Behebung von CDK-Problemen helfen und sollten bei der Einreichung von Fehlerberichten bereitgestellt werden.

## Verwendung
<a name="ref-cli-cmd-doctor-usage"></a>

```
$ cdk doctor <options>
```

## Optionen
<a name="ref-cli-cmd-doctor-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-doctor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk doctor` Befehl an.

## Beispiele
<a name="ref-cli-cmd-doctor-examples"></a>

### Einfaches Beispiel für den `cdk doctor` Befehl
<a name="ref-cli-cmd-doctor-examples-1"></a>

```
$ cdk doctor
ℹ️ CDK Version: 1.0.0 (build e64993a)
ℹ️ AWS environment variables:
  - AWS_EC2_METADATA_DISABLED = 1
  - AWS_SDK_LOAD_CONFIG = 1
```

# `cdk drift`
<a name="ref-cli-cmd-drift"></a>

Erkennen Sie Konfigurationsabweichungen für Ressourcen, die Sie mit dem AWS Cloud Development Kit (AWS CDK) definieren, verwalten und bereitstellen. Abweichungen treten auf, wenn die tatsächliche Konfiguration eines Stacks von der erwarteten Konfiguration abweicht. Dies ist der Fall, wenn Ressourcen außerhalb von AWS CloudFormation geändert werden.

Dieser Befehl identifiziert Ressourcen, die geändert wurden (z. B. über die AWS Konsole oder AWS CLI), indem ihr aktueller Status mit ihrer erwarteten Konfiguration verglichen wird. Diese Änderungen können zu unerwartetem Verhalten in Ihrer Infrastruktur führen.

Während der Drifterkennung gibt die CDK-CLI Fortschrittsindikatoren und Ergebnisse aus, die Folgendes anzeigen:
+ Ressourcen, die von ihrer erwarteten Konfiguration abweichen.
+ Die Gesamtzahl der Ressourcen, bei denen Abweichungen auftreten.
+ Eine Zusammenfassung, die angibt, ob im Stack eine Drift festgestellt wurde.

**Wichtig**  
Die `cdk diff` Befehle `cdk drift` und funktionieren unterschiedlich:  
 `cdk drift`ruft den Vorgang zur Erkennung CloudFormation von Abweichungen auf, um den tatsächlichen Zustand der Ressourcen in AWS („Realität“) mit ihrer erwarteten Konfiguration in zu vergleichen CloudFormation. Nicht alle AWS Ressourcen unterstützen die Erkennung von Abweichungen. Eine Liste der unterstützten Ressourcen finden Sie im * AWS CloudFormation Benutzerhandbuch* unter [Unterstützung für Ressourcentypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html).
 `cdk diff`vergleicht die aus Ihrem lokalen CDK-Code synthetisierte CloudFormation Vorlage mit der Vorlage des bereitgestellten CloudFormation Stacks.
Verwenden `cdk drift` Sie diese Option, wenn Sie überprüfen müssen, ob Ressourcen außerhalb CloudFormation (z. B. über die AWS Konsole oder AWS CLI) geändert wurden. Verwenden Sie diese Option, `cdk diff` wenn Sie vor der Bereitstellung eine Vorschau davon erhalten möchten, wie sich Ihre lokalen Codeänderungen auf Ihre Infrastruktur auswirken würden.

## Verwendung
<a name="ref-cli-cmd-drift-usage"></a>

```
$ cdk drift <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-drift-args"></a><a name="ref-cli-cmd-drift-args-stack-name"></a>

 **Stack name**   
Der Name des Stacks, den Sie auf Drift überprüfen möchten. Der Stack muss zuvor für CloudFormation die Drifterkennung bereitgestellt werden.  
 *Typ:* Zeichenfolge  
 *Required*: No  
Wenn kein Stack angegeben ist, wird die Drifterkennung für alle in Ihrer CDK-App definierten Stacks durchgeführt.

## Optionen
<a name="ref-cli-cmd-drift-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-drift-options-fail"></a>

 `--fail <BOOLEAN>`   
Kehren Sie mit dem Exit-Code 1 zurück, wenn eine Drift erkannt wird.  
 *Standardwert*: `false` <a name="ref-cli-cmd-drift-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk drift` Befehl an.

## Beispiele
<a name="ref-cli-cmd-drift-examples"></a>

### Überprüfen Sie die Drift für einen bestimmten Stack
<a name="ref-cli-cmd-drift-examples-stack"></a>

```
$ cdk drift MyStackName
```

Der Befehl gibt Ergebnisse aus, die den folgenden ähneln:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function

1 resource has drifted from their expected configuration

✨  Number of resources with drift: 1
```

### Überprüfen Sie Drift, wenn Ressourcen gelöscht wurden
<a name="ref-cli-cmd-drift-examples-deleted"></a>

Das folgende Beispiel zeigt, wie die Ausgabe aussieht, wenn Ressourcen sowohl geändert als auch gelöscht wurden:

```
Stack MyStackName
Modified Resources
[~] AWS::Lambda::Function MyFunction MyLambdaFunc1234ABCD
 └─ [~] /Description
     ├─ [-] My original hello world Lambda function
     └─ [+] My drifted hello world Lambda function
Deleted Resources
[-] AWS::CloudWatch::Alarm MyAlarm MyCWAlarmABCD1234

2 resources have drifted from their expected configuration

✨  Number of resources with drift: 2
```

### Überprüfen Sie Drift mit dem Exit-Code
<a name="ref-cli-cmd-drift-examples-fail"></a>

Damit der Befehl einen Exit-Code ungleich Null zurückgibt, wenn eine Drift erkannt wird:

```
$ cdk drift MyStackName --fail
```

Dies ist in CI/CD-Pipelines nützlich, um Infrastrukturabweichungen automatisch zu erkennen und darauf zu reagieren.

# `cdk flags`
<a name="ref-cli-cmd-flags"></a>

Zeigen Sie Ihre Feature-Flag-Konfigurationen für die CDK-CLI an und ändern Sie sie.

Feature-Flags steuern das Verhalten der CDK-CLI und Sie können sie verwenden, um bestimmte Funktionen zu aktivieren oder zu deaktivieren. Verwenden Sie den `cdk flags` Befehl, um Ihre aktuellen Feature-Flag-Konfigurationen anzuzeigen und sie nach Bedarf zu ändern.

**Warnung**  
Der `cdk flags` Befehl wird derzeit für das AWS CDK entwickelt. Die aktuellen Funktionen dieses Befehls gelten als produktionsbereit und sicher in der Anwendung. Der Umfang dieses Befehls und seine Funktionen können sich jedoch ändern. Daher müssen Sie sich anmelden, indem Sie die `unstable=flags` Option zur Verwendung dieses Befehls angeben.

## Verwendung
<a name="ref-cli-cmd-flags-usage"></a>

```
$ cdk flags <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-flags-args"></a><a name="ref-cli-cmd-flags-args-flagname"></a>

 **NAME DER FLAGGE**   
Der Name des spezifischen Feature-Flags, das Sie anzeigen oder ändern möchten.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-flags-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-flags-options-set"></a>

 `--set <BOOLEAN>`   
Ändern Sie eine Feature-Flag-Konfiguration.<a name="ref-cli-cmd-flags-options-all"></a>

 `--all <BOOLEAN>`   
Alle Feature-Flags ändern oder anzeigen.<a name="ref-cli-cmd-flags-options-recommended"></a>

 `--recommended <BOOLEAN>`   
Ändern Sie die Flaggen auf empfohlene Status.<a name="ref-cli-cmd-flags-options-default"></a>

 `--default <BOOLEAN>`   
Ändern Sie die Flaggen auf Standardstatus.<a name="ref-cli-cmd-flags-options-unconfigured"></a>

 `--unconfigured <BOOLEAN>`   
Ändern Sie nicht konfigurierte Feature-Flags.<a name="ref-cli-cmd-flags-options-value"></a>

 `--value <STRING>`   
Der Wert, auf den die Feature-Flag-Konfiguration gesetzt werden soll.  
 *Erfordert ARG*: true<a name="ref-cli-cmd-flags-options-safe"></a>

 `--safe <BOOLEAN>`   
Aktivieren Sie alle Feature-Flags, die sich nicht auf Ihre Anwendung auswirken.<a name="ref-cli-cmd-flags-options-interactive"></a>

 `--interactive, -i <BOOLEAN>`   
Interaktive Option für den Befehl flags.

## Beispiele
<a name="ref-cli-cmd-flags-examples"></a>

### Feature-Flag-Konfigurationen anzeigen
<a name="ref-cli-cmd-flags-examples-1"></a>

Starten Sie`cdk flags`, um einen Bericht über Ihre Feature-Flag-Konfigurationen anzuzeigen, die von unseren empfohlenen Status abweichen. Nicht konfigurierte Flags sind mit gekennzeichnet`<unset>`, um darauf hinzuweisen, dass das Flag derzeit keinen Wert hat. Die Flags werden in der folgenden Reihenfolge angezeigt:
+ Flaggen, die auf einen Wert gesetzt sind, der nicht unserem empfohlenen Wert entspricht
+ Flags, die Sie nicht konfiguriert haben

```
$ cdk flags --unstable=flags
Feature Flag                           Recommended                       User
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

Sie können auch ausführen`cdk flags --all`, um einen Bericht mit allen Feature-Flags in der folgenden Reihenfolge anzuzeigen:
+ Flags sind auf einen Wert gesetzt, der unserem empfohlenen Wert entspricht
+ Flaggen, die auf einen Wert gesetzt sind, der nicht unserem empfohlenen Wert entspricht
+ Flags, die Sie nicht konfiguriert haben

```
$ cdk flags --unstable=flags --all
Feature Flag                              Recommended                     User
@aws-cdk/...                                true                         true
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
```

### Ändern Sie Feature-Flag-Werte
<a name="ref-cli-cmd-flags-examples-2"></a>

Um Ihre Feature-Flags interaktiv zu ändern, führen Sie den Befehl `cdk flags --interactive` (oder`cdk flags -i`) aus, um eine Liste mit Menüoptionen anzuzeigen.

Führen `cdk flags --set --recommended --all` Sie den Befehl aus, um alle Feature-Flags auf unseren empfohlenen Wert zu ändern. Mit diesem Befehl wird Ihre Feature-Flag-Konfiguration up-to-date mit den neuesten CDK-Feature-Flag-Konfigurationen beibehalten. Beachten Sie, dass die Ausführung dieses Befehls möglicherweise vorhandene konfigurierte Werte überschreiben kann.

```
$ cdk flags --unstable=flags --set --recommended --all
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         false
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
                ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Wenn Sie den Status Ihrer vorhandenen konfigurierten Flags beibehalten möchten, führen `cdk flags --set --recommended --unconfigured` Sie den Befehl aus. Diese Option ändert nur die unkonfigurierten Feature-Flags auf unsere empfohlenen Werte.

```
$ cdk flags --unstable=flags --set --recommended --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...
    Resources
    [~] AWS::S3::Bucket MyBucket
    └─ [~] Properties
        └─ [~] Encryption
            ├─ [-] None
            └─ [+] ServerSideEncryptionConfiguration:
                    - ...
            ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

Wenn Sie sicherstellen möchten, dass nicht konfigurierte Feature-Flags Ihre Anwendung nicht beeinträchtigen, führen Sie den `cdk flags --set --default --unconfigured` Befehl aus, um die unkonfigurierten Flags auf ihre Standardwerte zu ändern. Wenn er beispielsweise nicht konfiguriert `@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021` ist, wird nach der Ausführung eine Benachrichtigung angezeigt. `cdk synth` Wenn Sie das Flag jedoch auf den Standardstatus (false) setzen, wird es konfiguriert und deaktiviert und hat keine Auswirkungen auf Ihre Anwendung.

```
$ cdk flags --unstable=flags --set --default --unconfigured
Feature Flag                              Recommended Value            User Value
* @aws-cdk/...                              true                         <unset>
* @aws-cdk/...                              true                         <unset>
  Synthesizing...

  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

### Untersuchen Sie bestimmte Feature-Flags
<a name="ref-cli-cmd-flags-examples-3"></a>

#### Weitere Informationen zu einer Flagge anzeigen
<a name="_view_more_information_about_a_flag"></a>

Neben dem Ausführen `cdk flags` und `cdk flags --all` Anzeigen Ihrer Feature-Flag-Konfiguration können Sie auch ein bestimmtes Feature-Flag überprüfen und herausfinden, was das Flag bewirkt. `cdk flags "FLAGNAME"` Dies kann in Fällen hilfreich sein, in denen Sie ein bestimmtes Flag und seine Auswirkungen auf Ihre Anwendung verstehen möchten.

```
$ cdk flags --unstable=flags "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021"
    Description: Enable this feature flag to have cloudfront distributions use the security policy TLSv1.2_2021 by default.
    Recommended Value: true
    User Value: true
```

#### Filtern Sie Flags nach einer Teilzeichenfolge
<a name="_filter_flags_by_substring"></a>

Sie können auch ausführen`cdk flags substring`, um alle passenden Feature-Flags anzuzeigen. Wenn es nur ein Feature-Flag gibt, das dieser Teilzeichenfolge entspricht, werden spezifische Details angezeigt.

```
$ cdk flags --unstable=flags ebs
@aws-cdk/aws-ec2:ebsDefaultGp3Volume
    Description: When enabled, the default volume type of the EBS volume will be GP3
    Recommended Value: true
    User Value: true
```

Wenn mehrere Flags mit der Teilzeichenfolge übereinstimmen, werden alle passenden Flags in einer Tabelle angezeigt. Wenn Sie mehrere Teilzeichenfolgen eingeben, werden alle passenden Flags zurückgegeben, die eine der Teilzeichenfolgen enthalten.

```
$ cdk flags --unstable=flags s3 lambda
Feature Flag                              Recommended                     User
* @aws-cdk/s3...                            true                         false
* @aws-cdk/lambda...                        true                         false
* @aws-cdk/lambda...                        true                         <unset>
```

#### Ändern Sie ein bestimmtes Kennzeichen
<a name="_modify_a_specific_flag"></a>

Wenn Sie den Wert einer Markierung ändern müssen und sicherstellen möchten, dass Sie sie auf einen korrekten und unterstützten Status setzen, führen Sie den Befehl aus`cdk flags --set "FLAGNAME" --value="state"`.

```
$ cdk flags --unstable=flags --set "@aws-cdk/aws-cloudfront:defaultSecurityPolicyTLSv1.2_2021" --value="true"
  Synthesizing...
    Resources
    [~] AWS::CloudFront::Distribution MyDistribution
    └─ [~] Properties
        └─ [~] DefaultSecurityPolicy
            ├─ [-] TLSv1.0
            └─ [+] TLSv1.2_2021
                    - ...
    Number of stacks with differences: 2
  Do you want to accept these changes? (y/n) y
  Resynthesizing...
```

# `cdk gc`
<a name="ref-cli-cmd-gc"></a>

Verwenden Sie den Befehl AWS Cloud Development Kit (AWS CDK) über die Befehlszeilenschnittstelle (CLI)`cdk gc`, um ungenutzte Assets, die in den Ressourcen Ihres Bootstrap-Stacks gespeichert sind, zu löschen. Verwenden Sie diesen Befehl, um nicht mehr benötigte Assets anzuzeigen, zu verwalten und zu löschen.

Für Amazon Simple Storage Service (Amazon S3) -Assets überprüft die CDK-CLI vorhandene AWS CloudFormation Vorlagen in derselben Umgebung, um festzustellen, ob auf sie verwiesen wird. Wenn sie nicht referenziert werden, gelten sie als unbenutzt und kommen für Müllabfuhr in Frage.

**Warnung**  
Der `cdk gc` Befehl befindet sich in der Entwicklung für das AWS CDK. Die aktuellen Funktionen dieses Befehls gelten als produktionsbereit und sicher in der Anwendung. Der Umfang dieses Befehls und seine Funktionen können sich jedoch ändern. Daher müssen Sie sich anmelden, indem Sie die `unstable=gc` Option zur Verwendung dieses Befehls angeben.

## Verwendung
<a name="ref-cli-cmd-gc-usage"></a>

```
$ cdk gc <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-gc-args"></a><a name="ref-cli-cmd-gc-args-env"></a>

 ** AWS Umgebung**   
Die AWS Zielumgebung, in der Aktionen zur Müllabfuhr ausgeführt werden sollen.  
Verwenden Sie bei der Bereitstellung einer Umgebung das folgende Format:`aws://<account-id>/<region>`. Beispiel, `aws://<123456789012>/<us-east-1>`.  
Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden, um Garbage-Collection-Aktionen in mehreren Umgebungen durchzuführen.  
Standardmäßig führt die CDK-CLI Garbage-Collection-Aktionen in allen Umgebungen durch, auf die Sie in Ihrer CDK-App verweisen oder die Sie als Argumente angeben. Wenn Sie keine Umgebung angeben, bestimmt die CDK-CLI die Umgebung anhand von Standardquellen. Zu diesen Quellen gehören Umgebungen, die Sie mit der `--profile` Option angeben, Umgebungsvariablen oder AWS Standard-CLI-Quellen.

## Optionen
<a name="ref-cli-cmd-gc-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-gc-options-action"></a>

 `--action <STRING>`   
Die Aktion, die `cdk gc` während einer Garbage-Collection auf Ihre Assets angewendet wird.  
+  `delete-tagged`— Löscht Assets, die mit einem Datum innerhalb der von Ihnen angegebenen Puffertage gekennzeichnet wurden. Neu identifizierte ungenutzte Assets werden jedoch nicht markiert.
+  `full`— Führt alle Aktionen zur Müllabfuhr durch. Dazu gehören das Löschen von Assets innerhalb der von Ihnen angegebenen Puffertage und das Markieren neu identifizierter ungenutzter Assets.
+  `print`— Gibt die Anzahl der ungenutzten Objekte in der Befehlszeile aus, nimmt jedoch keine tatsächlichen Änderungen in Ihrer AWS Umgebung vor.
+  `tag`— Kennzeichnet alle neu identifizierten ungenutzten Ressourcen, löscht jedoch keine Objekte innerhalb des von Ihnen angegebenen Puffer-Tagebereichs.
 *Zulässige Werte*:`delete-tagged`,`full`,`print`, `tag`   
 *Standardwert*: `full` <a name="ref-cli-cmd-gc-options-bootstrap-stack-name"></a>

 `--bootstrap-stack-name <STRING>`   
Der Name des CDK-Bootstrap-Stacks in Ihrer AWS Umgebung. Geben Sie diese Option an, wenn Sie den Namen Ihres Bootstrap-Stacks angepasst haben. Wenn Sie den `CDKToolkit` Standard-Stacknamen verwenden, müssen Sie diese Option nicht angeben.  
 *Standardwert*: `CDKToolkit` <a name="ref-cli-cmd-gc-options-confirm"></a>

 `--confirm <BOOLEAN>`   
Geben Sie an, ob die CDK-CLI vor dem Löschen von Assets eine manuelle Bestätigung von Ihnen anfordert.  
Geben Sie `false` an, dass Assets automatisch gelöscht werden sollen, ohne dass Sie zur manuellen Bestätigung aufgefordert werden.  
 *Standardwert*: `true` <a name="ref-cli-cmd-gc-options-created-buffer-days"></a>

 `--created-buffer-days <NUMBER>`   
Gibt an, wie viele Tage ein Asset existieren muss, bevor es für Müllabfuhr in Frage kommt.  
Wenn Sie eine Zahl angeben, werden Assets, die nach der von Ihnen angegebenen Anzahl von Tagen noch nicht existiert haben, aus den Aktionen zur Müllabfuhr herausgefiltert.  
 *Standardwert*: `1` <a name="ref-cli-cmd-gc-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk gc` Befehl an.<a name="ref-cli-cmd-gc-options-rollback-buffer-days"></a>

 `--rollback-buffer-days <NUMBER>`   
Die Anzahl der Tage, an denen ein Asset als isoliert gekennzeichnet werden muss, bevor es für Müllabfuhr in Frage kommt.  
Wenn Sie eine Nummer angeben, kennzeichnet die CDK-CLI ungenutzte Assets mit dem aktuellen Datum, anstatt sie zu löschen. Die CDK-CLI überprüft auch, ob bei früheren Ausführungen des `cdk gc` Befehls Assets markiert wurden. Zuvor markierte Assets, die in den von Ihnen angegebenen Bereich der Puffertage fallen, werden gelöscht.  
 *Standardwert*: `0` <a name="ref-cli-cmd-gc-options-type"></a>

 `--type <STRING>`   
Der Bootstrap-Ressourcentyp in Ihrem Bootstrap-Stack, für den Garbage-Collection-Aktionen ausgeführt werden sollen.  
+  `all`— Führen Sie Garbage-Collection-Aktionen für alle Bootstrap-Ressourcen durch.
+  `ecr`— Führen Sie Garbage-Collection-Aktionen für Assets im Amazon Elastic Container Registry (Amazon ECR) -Repository Ihres Bootstrap-Stacks durch.
+  `s3`— Führen Sie Garbage-Collection-Aktionen für Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks durch.
 *Zulässige Werte*:`all`,, `ecr` `s3`   
 *Standardwert*: `all` <a name="ref-cli-cmd-gc-options-unstable"></a>

 `--unstable <STRING>`   
Erlauben Sie die Verwendung von CDK-CLI-Befehlen, die sich noch in der Entwicklung befinden.  
Diese Option ist erforderlich, um alle CDK-CLI-Befehle zu verwenden, die sich noch in der Entwicklung befinden und sich ändern können.  
Diese Option kann in einem einzigen Befehl mehrfach bereitgestellt werden.  
Geben Sie zur Verwendung `cdk gc` an`--unstable=gc`.

## Beispiele
<a name="ref-cli-cmd-gc-examples"></a>

### Grundlegende Beispiele
<a name="ref-cli-cmd-gc-examples-basic"></a>

Im folgenden Beispiel werden Sie zur manuellen Bestätigung aufgefordert, um die standardmäßigen Garbage-Collection-Aktionen für Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks durchzuführen:

```
$ cdk gc --unstable=gc --type=s3

 ⏳  Garbage Collecting environment aws://<account-id>/<region>...
Found 99 assets to delete based off of the following criteria:
- assets have been isolated for > 0 days
- assets were created > 1 days ago

Delete this batch (yes/no/delete-all)?
```

Im folgenden Beispiel werden Garbage-Collection-Aktionen für eine Reihe von Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks ausgeführt. Dieser Bereich umfasst Assets, die zuvor mehr als 30 Tage lang markiert wurden und die 10 Tage oder älter erstellt wurden. `cdk gc` Mit diesem Befehl werden Sie vor dem Löschen von Assets zur manuellen Bestätigung aufgefordert:

```
$ cdk gc --unstable=gc --type=s3 --rollback-buffer-days=30 --created-buffer-days=10
```

Im folgenden Beispiel werden zuvor markierte Assets im Amazon S3 S3-Bucket Ihres Bootstrap-Stacks gelöscht, die länger als 30 Tage nicht verwendet wurden:

```
$ cdk gc --unstable=gc --type=s3 --action=delete-tagged --rollback-buffer-days=30
```

# `cdk import`
<a name="ref-cli-cmd-import"></a>

Verwenden Sie [AWS CloudFormation Ressourcenimporte](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html), um vorhandene AWS Ressourcen in einen CDK-Stack zu importieren.

Mit diesem Befehl können Sie vorhandene Ressourcen, die mit anderen Methoden erstellt wurden, verwenden und sie mithilfe des AWS CDK verwalten.

Wenn Sie erwägen, Ressourcen in das CDK-Management zu verlagern, ist es manchmal akzeptabel, neue Ressourcen zu erstellen, z. B. mit IAM-Rollen, Lambda-Funktionen und Ereignisregeln. Bei anderen Ressourcen, wie z. B. statusbehafteten Ressourcen wie Amazon S3 S3-Buckets und DynamoDB-Tabellen, kann das Erstellen neuer Ressourcen Auswirkungen auf Ihren Service haben. Sie können sie verwenden`cdk import`, um vorhandene Ressourcen mit minimaler Unterbrechung Ihrer Dienste zu importieren. Eine Liste der unterstützten AWS Ressourcen finden Sie im * AWS CloudFormation Benutzerhandbuch* unter [Unterstützung für Ressourcentypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import-supported-resources.html).

 **Um eine vorhandene Ressource in einen CDK-Stack zu importieren**   

1. Führen Sie a aus`cdk diff`, um sicherzustellen, dass Ihr CDK-Stack keine ausstehenden Änderungen enthält. Wenn Sie eine ausführen`cdk import`, sind die einzigen Änderungen, die bei einem Importvorgang zulässig sind, das Hinzufügen neuer Ressourcen, die importiert werden.

1. Fügen Sie Konstrukte für die Ressourcen hinzu, die Sie in Ihren Stack importieren möchten. Fügen Sie beispielsweise Folgendes für einen Amazon S3 S3-Bucket hinzu:

   ```
   new s3.Bucket(this, 'ImportedS3Bucket', {});
   ```

   Fügen Sie keine weiteren Änderungen hinzu. Sie müssen außerdem sicherstellen, dass der aktuelle Status der Ressource exakt modelliert wird. Stellen Sie für das Bucket-Beispiel sicher, dass Sie AWS KMS-Schlüssel, Lebenszyklusrichtlinien und alles andere, was für den Bucket relevant ist, angeben. Andernfalls führen nachfolgende Aktualisierungsvorgänge möglicherweise nicht zu Ihren Erwartungen.

1. Führen Sie `cdk import`. Wenn die CDK-App mehrere Stacks enthält, übergeben Sie einen bestimmten Stacknamen als Argument.

1. Die CDK-CLI fordert Sie auf, die tatsächlichen Namen der Ressourcen, die Sie importieren, einzugeben. Nachdem Sie diese Informationen eingegeben haben, beginnt der Import.

1. Bei `cdk import` erfolgreicher Meldung wird die Ressource vom CDK verwaltet. Alle nachfolgenden Änderungen an der Konstruktkonfiguration werden auf der Ressource widergespiegelt.

Diese Funktion hat derzeit folgende Einschränkungen:
+ Das Importieren von Ressourcen in verschachtelte Stacks ist nicht möglich.
+ Es wird nicht überprüft, ob die von Ihnen angegebenen Eigenschaften für die importierte Ressource korrekt und vollständig sind. Versuchen Sie, nach dem Import einen Vorgang zur Erkennung von Abweichungen zu starten.
+ Ressourcen, die von anderen Ressourcen abhängig sind, müssen alle zusammen oder einzeln in der richtigen Reihenfolge importiert werden. Andernfalls schlägt die CloudFormation Bereitstellung mit ungelösten Verweisen fehl.
+ Dieser Befehl verwendet die Anmeldeinformationen für die Bereitstellungsrolle, die zum Lesen des verschlüsselten Staging-Buckets erforderlich sind. Dazu ist Version 12 der Bootstrap-Vorlage erforderlich, die die erforderlichen IAM-Berechtigungen für die Bereitstellungsrolle enthält.

## Verwendung
<a name="ref-cli-cmd-import-usage"></a>

```
$ cdk import <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-import-args"></a><a name="ref-cli-cmd-import-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, in den Ressourcen importiert werden sollen. Dieses Argument kann in einem einzigen Befehl mehrfach angegeben werden.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-import-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-import-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Der Name des zu CloudFormation erstellenden Änderungssatzes.<a name="ref-cli-cmd-import-options-execute"></a>

 `--execute <BOOLEAN>`   
Geben Sie an, ob der Änderungssatz ausgeführt werden soll.  
 *Standardwert*: `true` <a name="ref-cli-cmd-import-options-force"></a>

 `--force, -f <BOOLEAN>`   
Standardmäßig beendet die CDK-CLI den Prozess, wenn der Template-Diff Aktualisierungen oder Löschungen beinhaltet. Geben Sie `true` an, dass dieses Verhalten außer Kraft gesetzt werden soll, und fahren Sie immer mit dem Import fort.<a name="ref-cli-cmd-import-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den `cdk import` Befehl an.<a name="ref-cli-cmd-import-options-record-resource-mapping"></a>

 `--record-resource-mapping, -r <STRING>`   
Verwenden Sie diese Option, um eine Zuordnung vorhandener physischer Ressourcen zu den CDK-Ressourcen zu generieren, die importiert werden. Die Zuordnung wird in den von Ihnen angegebenen Dateipfad geschrieben. Es werden keine eigentlichen Importvorgänge ausgeführt.<a name="ref-cli-cmd-import-options-resource-mapping"></a>

 `--resource-mapping, -m <STRING>`   
Verwenden Sie diese Option, um eine Datei anzugeben, die Ihre Ressourcenzuweisung definiert. Die CDK-CLI verwendet diese Datei, um physische Ressourcen Ressourcen für den Import zuzuordnen, anstatt Sie interaktiv zu fragen.  
Diese Option kann von Skripten aus ausgeführt werden.<a name="ref-cli-cmd-import-options-rollback"></a>

 `--rollback <BOOLEAN>`   
Setzen Sie den Stack bei einem Fehler in den stabilen Zustand zurück.  
Um dies zu spezifizieren`false`, können Sie `--no-rollback` oder verwenden`-R`.  
Geben Sie `false` an, ob die Iteration schneller erfolgen soll. Bereitstellungen, die Ressourcen ersetzen, schlagen immer fehl.  
 *Standardwert*: `true` <a name="ref-cli-cmd-import-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Der Name des CDK Toolkit-Stacks, der erstellt werden soll.  
`cdk bootstrap`Stellt standardmäßig einen Stack mit dem Namen `CDKToolkit` in der angegebenen Umgebung bereit. AWS Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.  
Die CDK-CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.

# `cdk init`
<a name="ref-cli-cmd-init"></a>

Erstellen Sie ein neues AWS CDK-Projekt aus einer Vorlage.

## Verwendung
<a name="ref-cli-cmd-init-usage"></a>

```
$ cdk init <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-init-args"></a><a name="ref-cli-cmd-init-args-template-type"></a>

 **Typ der Vorlage**   
Der CDK-Vorlagentyp, von dem aus ein neues CDK-Projekt initialisiert werden soll.  
+  `app`— Vorlage für eine CDK-Anwendung.
+  `lib`— Vorlage für eine AWS Construct-Bibliothek.
+  `sample-app`— Beispiel für eine CDK-Anwendung, die einige Konstrukte enthält.
 *Gültige Werte*:`app`,, `lib` `sample-app` 

## Optionen
<a name="ref-cli-cmd-init-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-init-options-generate-only"></a>

 `--generate-only <BOOLEAN>`   
Geben Sie diese Option an, um Projektdateien zu generieren, ohne zusätzliche Operationen wie das Einrichten eines Git-Repositorys, das Installieren von Abhängigkeiten oder das Kompilieren des Projekts zu initiieren.  
 *Standardwert*: `false` <a name="ref-cli-cmd-init-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den `cdk init` Befehl an.<a name="ref-cli-cmd-init-options-language"></a>

 `--language, -l <STRING>`   
Die Sprache, die für das neue Projekt verwendet werden soll. Diese Option kann in der `cdk.json` Konfigurationsdatei des Projekts oder `~/.cdk.json` auf Ihrem lokalen Entwicklungscomputer konfiguriert werden.  
 *Gültige Werte*: `csharp``fsharp`,`go`,`java`,`javascript`,`python`, `typescript` <a name="ref-cli-cmd-init-options-list"></a>

 `--list <BOOLEAN>`   
Listet die verfügbaren Vorlagentypen und Sprachen auf.

## Beispiele
<a name="ref-cli-cmd-init-examples"></a>

### Listet die verfügbaren Vorlagentypen und Sprachen auf
<a name="ref-cli-cmd-init-examples-1"></a>

```
$ cdk init --list
Available templates:
* app: Template for a CDK Application
   └─ cdk init app --language=[csharp|fsharp|go|java|javascript|python|typescript]
* lib: Template for a CDK Construct Library
   └─ cdk init lib --language=typescript
* sample-app: Example CDK Application with some constructs
   └─ cdk init sample-app --language=[csharp|fsharp|go|java|javascript|python|typescript]
```

### Erstellen Sie eine neue CDK-App TypeScript aus der Bibliotheksvorlage
<a name="ref-cli-cmd-init-examples-2"></a>

```
$ cdk init lib --language=typescript
```

# `cdk list`
<a name="ref-cli-cmd-list"></a>

Listet alle AWS CDK-Stacks und ihre Abhängigkeiten von einer CDK-App auf.

## Verwendung
<a name="ref-cli-cmd-list-usage"></a>

```
$ cdk list <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-list-args"></a><a name="ref-cli-cmd-list-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, für den dieser Befehl ausgeführt werden soll.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-list-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-list-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk list` Befehl an.<a name="ref-cli-cmd-list-options-long"></a>

 `--long, -l <BOOLEAN>`   
Zeigt AWS Umgebungsinformationen für jeden Stapel an.  
 *Standardwert*: `false` <a name="ref-cli-cmd-list-options-show-dependencies"></a>

 `--show-dependencies, -d <BOOLEAN>`   
Zeigt Informationen zur Stapelabhängigkeit für jeden Stapel an.  
 *Standardwert*: `false` 

## Beispiele
<a name="ref-cli-cmd-list-examples"></a>

### Listet alle Stacks in der CDK-App „node bin/main.js“ auf
<a name="ref-cli-cmd-list-examples-1"></a>

```
$ cdk list --app='node bin/main.js'
Foo
Bar
Baz
```

### Listet alle Stacks auf, einschließlich der AWS Umgebungsdetails für jeden Stack
<a name="ref-cli-cmd-list-examples-"></a>

```
$ cdk list --app='node bin/main.js' --long
-
    name: Foo
    environment:
        name: 000000000000/bermuda-triangle-1
        account: '000000000000'
        region: bermuda-triangle-1
-
    name: Bar
    environment:
        name: 111111111111/bermuda-triangle-2
        account: '111111111111'
        region: bermuda-triangle-2
-
    name: Baz
    environment:
        name: 333333333333/bermuda-triangle-3
        account: '333333333333'
        region: bermuda-triangle-3
```

# `cdk metadata`
<a name="ref-cli-cmd-metadata"></a>

Zeigt Metadaten an, die einem CDK-Stack zugeordnet sind.

## Verwendung
<a name="ref-cli-cmd-metadata-usage"></a>

```
$ cdk metadata <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-metadata-args"></a><a name="ref-cli-cmd-metadata-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, für den Metadaten angezeigt werden sollen.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-metadata-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-metadata-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk metadata` Befehl an.

# `cdk migrate`
<a name="ref-cli-cdk-migrate"></a>

Migrieren Sie bereitgestellte AWS Ressourcen, AWS CloudFormation Stacks und CloudFormation Vorlagen in ein neues AWS CDK-Projekt.

Mit diesem Befehl wird eine neue CDK-App erstellt, die einen einzelnen Stack enthält, dem der von Ihnen angegebene Wert zugewiesen wird. `--stack-name` Sie können die Migrationsquelle mit `--from-scan``--from-stack`, oder `--from-path` konfigurieren.

Weitere Informationen zur Verwendung `cdk migrate` finden Sie unter [Migrieren vorhandener Ressourcen und AWS CloudFormation Vorlagen zum AWS CDK](migrate.md).

**Anmerkung**  
Der `cdk migrate` Befehl ist experimentell und könnte in future grundlegende Änderungen haben.

## Verwendung
<a name="ref-cli-cdk-migrate-usage"></a>

```
$ cdk migrate <options>
```

## Optionen
<a name="ref-cli-cdk-migrate-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).

### Erforderliche Optionen
<a name="ref-cli-cdk-migrate-options-required"></a><a name="ref-cli-cdk-migrate-options-stack-name"></a>

 `--stack-name <STRING>`   
Der Name des AWS CloudFormation Stacks, der nach der Migration in der CDK-App erstellt wird.  
 *Erforderlich*: Ja

### Bedingte Optionen
<a name="ref-cli-cdk-migrate-options-conditional"></a><a name="ref-cli-cdk-migrate-options-from-path"></a>

 `--from-path <PATH>`   
Der Pfad zur AWS CloudFormation Vorlage, die migriert werden soll. Geben Sie diese Option an, um eine lokale Vorlage anzugeben.  
 *Erforderlich:* Bedingt. Erforderlich, wenn von einer lokalen AWS CloudFormation Vorlage migriert wird.<a name="ref-cli-cdk-migrate-options-from-scan"></a>

 `--from-scan <STRING>`   
Wenn Sie bereitgestellte Ressourcen aus einer AWS Umgebung migrieren, verwenden Sie diese Option, um anzugeben, ob ein neuer Scan gestartet werden soll oder ob die AWS CDK-CLI den letzten erfolgreichen Scan verwenden soll.  
 *Erforderlich:* Bedingt. Erforderlich bei der Migration von bereitgestellten Ressourcen. AWS   
 *Zulässige Werte*:`most-recent`, `new` <a name="ref-cli-cdk-migrate-options-from-stack"></a>

 `--from-stack <BOOLEAN>`   
Stellen Sie diese Option bereit, um von einem bereitgestellten AWS CloudFormation Stack zu migrieren. Wird verwendet`--stack-name`, um den Namen des bereitgestellten AWS CloudFormation Stacks anzugeben.  
 *Erforderlich:* Bedingt. Erforderlich, wenn von einem bereitgestellten AWS CloudFormation Stack migriert wird.

### Optionale Optionen
<a name="ref-cli-cdk-migrate-options-optional"></a><a name="ref-cli-cdk-migrate-options-account"></a>

 `--account <STRING>`   
Das Konto, von dem die AWS CloudFormation Stack-Vorlage abgerufen werden soll.  
 *Required*: No  
 *Standard*: Die AWS CDK-CLI bezieht Kontoinformationen aus Standardquellen.<a name="ref-cli-cdk-migrate-options-compress"></a>

 `--compress <BOOLEAN>`   
Stellen Sie diese Option bereit, um das generierte CDK-Projekt in eine Datei zu komprimieren. `ZIP`  
 *Required*: No<a name="ref-cli-cdk-migrate-options-filter"></a>

 `--filter <ARRAY>`   
Wird verwendet, wenn bereitgestellte Ressourcen aus einem AWS Konto und AWS einer Region migriert werden. Diese Option gibt einen Filter an, mit dem bestimmt wird, welche bereitgestellten Ressourcen migriert werden sollen.  
Diese Option akzeptiert ein Array von Schlüssel-Wert-Paaren, wobei **key** für den Filtertyp und **value** für den zu filternden Wert steht.  
Die folgenden Schlüssel werden akzeptiert:  
+  `resource-identifier`— Ein Bezeichner für die Ressource. Der Wert kann die logische oder physische ID der Ressource sein. Beispiel, `resource-identifier="ClusterName"`.
+  `resource-type-prefix`— Das Präfix AWS CloudFormation für den Ressourcentyp. Geben Sie beispielsweise `resource-type-prefix="AWS::DynamoDB::"` an, dass alle Amazon DynamoDB-Ressourcen gefiltert werden sollen.
+  `tag-key`— Der Schlüssel eines Ressourcen-Tags. Beispiel, `tag-key="myTagKey"`.
+  `tag-value`— Der Wert eines Ressourcen-Tags. Beispiel, `tag-value="myTagValue"`.
Stellen Sie mehrere Schlüssel-Wert-Paare für die `AND` bedingte Logik bereit. Das folgende Beispiel filtert nach jeder DynamoDB-Ressource, die mit `myTagKey` dem Tag-Schlüssel gekennzeichnet ist:. `--filter resource-type-prefix="AWS::DynamoDB::", tag-key="myTagKey"`  
Geben Sie die `--filter` Option für `OR` bedingte Logik mehrmals in einem einzigen Befehl an. Das folgende Beispiel filtert nach jeder Ressource, die eine DynamoDB-Ressource ist oder mit der `myTagKey` als Tag-Schlüssel gekennzeichnet ist:. `--filter resource-type-prefix="AWS::DynamoDB::" --filter tag-key="myTagKey"`  
 *Required*: No<a name="ref-cli-cdk-migrate-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk migrate` Befehl an.<a name="ref-cli-cdk-migrate-options-language"></a>

 `--language <STRING>`   
Die Programmiersprache, die für das CDK-Projekt verwendet werden soll, das während der Migration erstellt wurde.  
 *Required*: No  
 *Gültige Werte*:`typescript`,`python`,, `java``csharp`,`go`.  
 *Standardwert*: `typescript` <a name="ref-cli-cdk-migrate-options-output-path"></a>

 `--output-path <PATH>`   
Der Ausgabepfad für das migrierte CDK-Projekt.  
 *Required*: No  
 *Standard*: Standardmäßig verwendet die AWS CDK-CLI Ihr aktuelles Arbeitsverzeichnis.<a name="ref-cli-cdk-migrate-options-region"></a>

 `--region <STRING>`   
Die AWS Region, aus der die AWS CloudFormation Stack-Vorlage abgerufen werden soll.  
 *Required*: No  
 *Standard*: Die AWS CDK-CLI bezieht AWS Regionsinformationen aus Standardquellen.

## Beispiele
<a name="ref-cli-cdk-migrate-examples"></a>

### Einfaches Beispiel für die Migration von einem Stack CloudFormation
<a name="ref-cli-cdk-migrate-examples-1"></a>

Migrieren Sie von einem bereitgestellten CloudFormation Stack in einer bestimmten AWS Umgebung mithilfe von`--from-stack`. Geben Sie `--stack-name` einen Namen für Ihren neuen CDK-Stack an. Im Folgenden finden Sie ein Beispiel für die Migration `myCloudFormationStack` zu einer neuen CDK-App, die Folgendes verwendet: TypeScript

```
$ cdk migrate --language typescript --from-stack --stack-name 'myCloudFormationStack'
```

### Einfaches Beispiel für die Migration von einer lokalen Vorlage CloudFormation
<a name="ref-cli-cdk-migrate-examples-2"></a>

Migrieren Sie von einer lokalen JSON- oder CloudFormation YAML-Vorlage mit. `--from-path` Geben Sie `--stack-name` an, ob Sie Ihrem neuen CDK-Stack einen Namen geben möchten. Im Folgenden finden Sie ein Beispiel, das eine neue CDK-App erstellt TypeScript , die einen `myCloudFormationStack` Stack aus einer lokalen `template.json` Datei enthält:

```
$ cdk migrate --stack-name "myCloudFormationStack" --language typescript --from-path "./template.json"
```

### Einfaches Beispiel für die Migration von bereitgestellten Ressourcen AWS
<a name="ref-cli-cdk-migrate-examples-3"></a>

Migrieren Sie bereitgestellte AWS Ressourcen aus einer bestimmten AWS Umgebung, die keinem CloudFormation Stack zugeordnet sind, mithilfe von`--from-scan`. Die CDK-CLI verwendet die IaC generator Dienst, um nach Ressourcen zu suchen und eine Vorlage zu generieren. Anschließend verweist die CDK-CLI auf die Vorlage, um die neue CDK-App zu erstellen. Im Folgenden finden Sie ein Beispiel, das eine neue CDK-App TypeScript mit einem neuen `myCloudFormationStack` Stack erstellt, der migrierte Ressourcen enthält: AWS 

```
$ cdk migrate --language typescript --from-scan --stack-name "myCloudFormationStack"
```

# `cdk notices`
<a name="ref-cli-cmd-notices"></a>

Zeigt Hinweise für Ihre CDK-Anwendung an.

Hinweise können wichtige Meldungen zu Sicherheitslücken, Regressionen und der Verwendung nicht unterstützter Versionen enthalten.

Dieser Befehl zeigt relevante Hinweise an, unabhängig davon, ob sie bestätigt wurden oder nicht. Relevante Hinweise können standardmäßig auch nach jedem Befehl erscheinen.

Sie können Hinweise auf folgende Weise unterdrücken:
+ Über Befehlsoptionen. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ cdk deploy --no-notices
  ```
+ Unterdrücken Sie alle Hinweise auf unbestimmte Zeit durch den Kontext in der `cdk.json` Projektdatei:

  ```
  {
    "notices": false,
    "context": {
      // ...
    }
  }
  ```
+ Bestätigen Sie jeden Hinweis mit dem `cdk acknowledge` Befehl.

## Verwendung
<a name="ref-cli-cmd-notices-usage"></a>

```
$ cdk notices <options>
```

## Optionen
<a name="ref-cli-cmd-notices-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-notices-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk notices` Befehl an.

## Beispiele
<a name="ref-cli-cmd-notices-examples"></a>

### Beispiel für einen Standardhinweis, der nach der Ausführung des Befehls cdk deploy angezeigt wird
<a name="ref-cli-cmd-notices-examples-1"></a>

```
$ cdk deploy

... # Normal output of the command

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: If a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: <1.126.0.

        More information at: https://github.com/aws/aws-cdk/issues/16603


17061   Error when building EKS cluster with monocdk import

        Overview: When using monocdk/aws-eks to build a stack containing
                  an EKS cluster, error is thrown about missing
                  lambda-layer-node-proxy-agent/layer/package.json.

        Affected versions: >=1.126.0 <=1.130.0.

        More information at: https://github.com/aws/aws-cdk/issues/17061


If you don’t want to see an notice anymore, use "cdk acknowledge ID". For example, "cdk acknowledge 16603"
```

### Einfaches Beispiel für die Ausführung des Befehls cdk notices
<a name="ref-cli-cmd-notices-examples-2"></a>

```
$ cdk notices

NOTICES

16603   Toggling off auto_delete_objects for Bucket empties the bucket

        Overview: if a stack is deployed with an S3 bucket with
                  auto_delete_objects=True, and then re-deployed with
                  auto_delete_objects=False, all the objects in the bucket
                  will be deleted.

        Affected versions: framework: <=2.15.0 >=2.10.0

        More information at: https://github.com/aws/aws-cdk/issues/16603


If you don’t want to see a notice anymore, use "cdk acknowledge <id>". For example, "cdk acknowledge 16603"
```

# `cdk refactor`
<a name="ref-cli-cmd-refactor"></a>

**Wichtig**  
Der `cdk refactor` Befehl befindet sich in der Vorschauversion und kann sich ändern.  
Sie müssen die `--unstable=refactor` Option angeben, wenn Sie diesen Befehl verwenden.

Schonen Sie bereitgestellte Ressourcen, wenn Sie Code in Ihrer AWS Cloud Development Kit (AWS CDK) -Anwendung umgestalten.

Wenn Sie Konstrukte umbenennen oder sie in Ihrem CDK-Code stapelweise verschieben, werden diese normalerweise als neue Ressourcen behandelt CloudFormation , was zu Ersetzungen führt, die zu Betriebsunterbrechungen oder Datenverlust führen können. Der `cdk refactor` Befehl erkennt diese Änderungen auf intelligente Weise und arbeitet mit der Refactoring-API zusammen, um Ihre Ressourcen zu CloudFormation schonen und gleichzeitig ihre logische Struktur zu aktualisieren. IDs

Mit `cdk refactor` haben Sie folgende Möglichkeiten:
+ Benennen Sie Konstrukte für eine bessere Übersichtlichkeit in Ihrer Codebasis um, ohne dass Ressourcen ersetzt werden.
+ Verschieben Sie Ressourcen zwischen Stapeln, um die Organisation zu verbessern und Aufgaben besser voneinander zu trennen.
+ Reorganisieren Sie Ihre Konstrukthierarchie (z. B. die Gruppierung von AWS-Ressourcen unter einem neuen L3-Konstrukt) und behalten Sie dabei die zugrunde liegenden Cloud-Ressourcen bei.
+ Führen Sie ein sicheres Upgrade durch oder wechseln Sie zwischen Konstruktbibliotheken, einschließlich Abhängigkeiten von Drittanbietern, ohne dass bei einem logischen IDs Wechsel zwischen Versionen Ressourcen ersetzt werden.

Dieser Befehl analysiert Ihre Änderungen, zeigt Ihnen eine Liste von Ressourcen an, deren Speicherort (Stapel und logische ID) geändert wird, und übernimmt den komplexen Prozess der Aktualisierung von CloudFormation Ressourcen unter Beibehaltung ihrer Identität und ihres Status.

Wenn der Befehl ausgeführt wird, berechnet er automatisch Zuordnungen, indem er Ihren aktuellen Code mit dem bereitgestellten Status vergleicht. Es überprüft, ob Ihre CDK-Anwendung genau den gleichen Satz von Ressourcen wie der bereitgestellte Status enthält und sich nur in ihren Positionen im Konstruktbaum unterscheidet. Wenn der Befehl feststellt, dass Ressourcen hinzugefügt, gelöscht oder geändert wurden, wird der Refactoring-Vorgang mit einer Fehlermeldung abgelehnt.

Nach der Zuordnungsberechnung zeigt Ihnen der Befehl die vorgeschlagenen Änderungen an und wendet nach Bestätigung durch den Benutzer das Refactoring an. Wenn Mehrdeutigkeit festgestellt wird (wobei mehrere gültige Zuordnungen möglich sind), können Sie eine Override-Datei mit expliziten Zuordnungen bereitstellen, um diese Fälle zu lösen.

Eine Einführung finden Sie unter [Beibehaltung der bereitgestellten](refactor.md) Ressourcen beim Refactoring von CDK-Code.

## Verwendung
<a name="ref-cli-cmd-refactor-usage"></a>

```
$ cdk refactor <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-refactor-args"></a><a name="ref-cli-cmd-refactor-args-stack-id"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks von Ihrer App zum Refactor.  
Sie können mehrere Stapel angeben IDs , um den Refactoring-Vorgang auf diese Stacks zu konzentrieren. Wenn Ressourcen zwischen Stacks verschoben werden und einer dieser Stapel nicht explizit enthalten ist, bezieht der Refactor-Befehl den zusätzlichen Stapel automatisch in den Vorgang mit ein.  
Wenn Sie keinen Stack angeben IDs, werden alle Stapel in der App für das Refactoring berücksichtigt.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-refactor-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-refactor-options-dry-run"></a>

 `--dry-run`   
Drucken Sie das Mapping auf der Konsole aus, ohne es anzuwenden.  
Diese Option ist nützlich, um Ihre Änderungen vor dem eigentlichen Refactoring zu überprüfen, insbesondere bei der Arbeit mit komplexen Anwendungen. Sie zeigt Ihnen genau, welche Änderungen vorgenommen werden würden, ohne dass Ressourcen geändert würden.<a name="ref-cli-cmd-refactor-options-force"></a>

 `--force`   
Fahren Sie mit dem Refactoring fort, ohne den Benutzer zur Bestätigung aufzufordern.  
Dies ist in interaktiven Umgebungen nützlich, wenn Sie sich der Änderungen sicher sind. In nicht interaktiven Umgebungen wie CI/CD Pipelines fährt die CDK-CLI automatisch ohne Aufforderung fort, sodass diese Option nicht erforderlich ist.<a name="ref-cli-cmd-refactor-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den Befehl an. `cdk refactor`<a name="ref-cli-cmd-refactor-options-override-file"></a>

 `--override-file <FILE>`   
Stellen Sie Overrides bereit, wenn die CDK-CLI keine Refactoring-Auflösung für Ressourcen ermitteln kann. Diese Datei enthält Ressourcenzuordnungen im JSON-Format. Im Folgenden wird ein Beispiel gezeigt:  

```
{
    "environments": [
        {
            "account": "123456789012",
            "region": "us-east-2",
            "resources": {
                "StackA.OldName": "StackB.NewName",
                "StackC.Foo": "StackC.Bar"
            }
        }
    ]
}
```<a name="ref-cli-cmd-refactor-options-revert"></a>

 `--revert <FILE>`   
Macht einen früheren Refactor rückgängig. Sie müssen eine Override-Datei mit Ressourcenzuordnungen bereitstellen.  
Dadurch wird ein früherer Refactoring-Vorgang nicht vollständig rückgängig gemacht. Um einen Refactor vollständig rückgängig zu machen, müssen Sie Ihre App auf einen früheren Status zurücksetzen und den Refactoring-Prozess erneut ausführen.

# `cdk rollback`
<a name="ref-cli-cmd-rollback"></a>

Verwenden Sie den Befehl AWS Cloud Development Kit (AWS CDK) Command Line Interface (CLI)`cdk rollback`, um einen ausgefallenen oder angehaltenen Stack von einer AWS CloudFormation Bereitstellung in seinen letzten stabilen Zustand zurückzusetzen.

**Anmerkung**  
Um diesen Befehl verwenden zu können, muss Version 23 der Bootstrap-Vorlage in Ihrer Umgebung bereitgestellt sein. Weitere Informationen finden Sie unter Versionsverlauf der [Bootstrap-Vorlage](bootstrapping-env.md#bootstrap-template-history).

Wenn Sie die Bereitstellung mithilfe von durchführen`cdk deploy`, führt die CDK-CLI standardmäßig ein Rollback für eine fehlgeschlagene Bereitstellung durch. Wenn Sie `--no-rollback` mit angeben`cdk deploy`, können Sie den `cdk rollback` Befehl verwenden, um eine fehlgeschlagene Bereitstellung manuell rückgängig zu machen. Dadurch wird ein Rollback zum letzten stabilen Status Ihres Stacks eingeleitet.

## Verwendung
<a name="ref-cli-cmd-rollback-usage"></a>

```
$ cdk rollback <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-rollback-args"></a><a name="ref-cli-cmd-rollback-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks von Ihrer App bis zum Rollback.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-rollback-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-rollback-options-all"></a>

 `--all <BOOLEAN>`   
Führen Sie ein Rollback aller Stacks in Ihrer CDK-App durch.  
 *Standardwert*: `false` <a name="ref-cli-cmd-rollback-options-force"></a>

 `--force, -f <BOOLEAN>`   
Wenn Sie es verwenden`cdk rollback`, kann es sein, dass einige Ressourcen nicht zurückgesetzt werden können. Stellen Sie diese Option bereit, um das Rollback aller Ressourcen zu erzwingen. Dies entspricht dem Bereitstellen der `--orphan` Option für jede Ressource in Ihrem Stack.  
 *Standardwert*: `false` <a name="ref-cli-cmd-rollback-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk rollback` Befehl an.<a name="ref-cli-cmd-rollback-options-orphan"></a>

 `--orphan <LogicalId>`   
Bei der Verwendung kann es sein`cdk rollback`, dass bei einigen Ressourcen ein Rollback fehlschlägt. In diesem Fall können Sie versuchen, das Rollback einer Ressource zu erzwingen, indem Sie diese Option verwenden und die logische ID der Ressource angeben, bei der das Rollback fehlgeschlagen ist.  
Diese Option kann in einem einzigen Befehl mehrfach angegeben werden. Im Folgenden finden Sie ein Beispiel:  

```
$ cdk rollback MyStack --orphan MyLambdaFunction --orphan MyLambdaFunction2
```
Um das Rollback aller Ressourcen zu erzwingen, verwenden Sie stattdessen die `--force` Option.<a name="ref-cli-cmd-rollback-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Der Name des vorhandenen CDK Toolkit-Stacks, mit dem die Umgebung gebootet wird.  
`cdk bootstrap`Stellt standardmäßig einen Stack mit dem Namen `CDKToolkit` in der angegebenen Umgebung bereit. AWS Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.  
Die CDK-CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.<a name="ref-cli-cmd-rollback-options-validate-bootstrap-version"></a>

 `--validate-bootstrap-version <BOOLEAN>`   
Geben Sie an, ob die Bootstrap-Stack-Version validiert werden soll. Geben Sie dieses Verhalten `--no-validate-bootsrap-version` an `--validate-bootstrap-version=false` oder schalten Sie es aus.  
 *Standardwert*: `true` 

# `cdk synthesize`
<a name="ref-cli-cmd-synth"></a>

Synthetisieren Sie eine CDK-App, um eine Cloud-Assembly zu erstellen, einschließlich einer AWS CloudFormation Vorlage für jeden Stack.

Cloud-Assemblys sind Dateien, die alles enthalten, was Sie für die Bereitstellung Ihrer App in Ihrer AWS Umgebung benötigen. Es enthält beispielsweise eine CloudFormation Vorlage für jeden Stapel in Ihrer App und eine Kopie der Datei-Assets oder Docker-Images, auf die Sie in Ihrer App verweisen.

Wenn Ihre App einen einzelnen Stapel enthält oder wenn ein einzelner Stapel als Argument angegeben wird, wird die CloudFormation Vorlage auch in der Standardausgabe (`stdout`) im YAML-Format angezeigt.

Wenn Ihre App mehrere Stapel enthält, `cdk synth` wird die Cloud-Assembly zu synthetisiert. `cdk.out`

## Verwendung
<a name="ref-cli-cmd-synth-usage"></a>

```
cdk synthesize <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-synth-args"></a><a name="ref-cli-cmd-synth-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, der synthetisiert werden soll.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-synth-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-synth-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Synthetisiert nur angeforderte Stacks, schließt keine Abhängigkeiten ein.<a name="ref-cli-cmd-synth-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt Befehlsreferenzinformationen für den `cdk synthesize` Befehl an.<a name="ref-cli-cmd-synth-options-quiet"></a>

 `--quiet, -q <BOOLEAN>`   
Geben Sie die CloudFormation Vorlage nicht an aus`stdout`.  
Diese Option kann in der `cdk.json` Datei des CDK-Projekts konfiguriert werden. Im Folgenden wird ein Beispiel gezeigt:  

```
{
   "quiet": true
}
```
 *Standardwert*: `false` <a name="ref-cli-cmd-synth-options-validation"></a>

 `--validation <BOOLEAN>`   
Validieren Sie die generierten CloudFormation Vorlagen nach der Synthese, indem Sie zusätzliche Prüfungen durchführen.  
Sie können diese Option auch über das `validateOnSynth` Attribut oder die `CDK_VALIDATION` Umgebungsvariable konfigurieren.  
 *Standardwert*: `true` 

## Beispiele
<a name="ref-cli-cmd-synth-examples"></a>

### Synthetisieren Sie die Cloud-Assembly für einen CDK-Stack mit logischer ID MyStackName und geben Sie die CloudFormation Vorlage auf stdout aus
<a name="ref-cli-cmd-synth-examples-1"></a>

```
$ cdk synth MyStackName
```

### Synthetisieren Sie die Cloud-Assembly für alle Stacks in einer CDK-App und speichern Sie sie in cdk.out
<a name="ref-cli-cmd-synth-examples-2"></a>

```
$ cdk synth
```

### Synthetisieren Sie die Cloud-Assembly für MyStackName, schließen Sie aber keine Abhängigkeiten ein
<a name="ref-cli-cmd-synth-examples-3"></a>

```
$ cdk synth MyStackName --exclusively
```

### Synthetisieren Sie die Cloud-Assembly für MyStackName, geben Sie die CloudFormation Vorlage jedoch nicht auf stdout aus
<a name="ref-cli-cmd-synth-examples-4"></a>

```
$ cdk synth MyStackName --quiet
```

# `cdk watch`
<a name="ref-cli-cmd-watch"></a>

Beobachten Sie kontinuierlich ein lokales AWS CDK-Projekt auf Änderungen bei der Durchführung von Implementierungen und Hotswaps.

Dieser Befehl ähnelt dem Befehl, mit dem Unterschied`cdk deploy`, dass er kontinuierliche Bereitstellungen und Hotswaps mit einem einzigen Befehl ausführen kann.

Dieser Befehl ist eine Abkürzung für. `cdk deploy --watch`

Um eine `cdk watch` Sitzung zu beenden, unterbrechen Sie den Vorgang, indem Sie auf`Ctrl+C`.

Welche Dateien beobachtet werden, hängt von der `"watch"` Einstellung in Ihrer `cdk.json` Datei ab. Es hat zwei Unterschlüssel, `"include"` und`"exclude"`, das akzeptiert eine einzelne Zeichenfolge oder ein Array von Zeichenketten. Jeder Eintrag wird als Pfad relativ zum Speicherort der `cdk.json` Datei interpretiert. Beides `*` und `**` werden akzeptiert.

Wenn Sie mit dem `cdk init` Befehl ein Projekt erstellen, ist das folgende Standardverhalten `cdk watch` in der `cdk.json` Datei Ihres Projekts konfiguriert:
+  `"include"`ist auf gesetzt`"**/*"`, was alle Dateien und Verzeichnisse im Stammverzeichnis des Projekts einschließt.
+  `"exclude"`ist optional, mit Ausnahme von Dateien und Ordnern, die bereits standardmäßig ignoriert wurden. Dies besteht aus Dateien und Verzeichnissen, die mit`.`, dem CDK-Ausgabeverzeichnis und dem `node_modules` Verzeichnis beginnen.

Die zu konfigurierende Mindesteinstellung `watch` ist`"watch": {}`.

Wenn entweder Ihr CDK-Code oder Ihr Anwendungscode vor der Bereitstellung einen Build-Schritt erfordert, `cdk watch` funktioniert er mit dem `"build"` Schlüssel in der `cdk.json` Datei.

**Wichtig**  
Dieser Befehl ist für die schnelle Bereitstellung während der Entwicklungsphase von CDK-Apps vorgesehen und wird nicht für Produktionsbereitstellungen empfohlen.

Die gleichen Einschränkungen von `cdk deploy --hotswap` gelten für. `cdk watch` Weitere Informationen finden Sie unter ` cdk deploy --hotswap `.

## Usage
<a name="ref-cli-cmd-watch-usage"></a>

```
$ cdk watch <arguments> <options>
```

## Argumente
<a name="ref-cli-cmd-watch-args"></a><a name="ref-cli-cmd-watch-args-stack-name"></a>

 **CDK-Stack-ID**   
Die Konstrukt-ID des CDK-Stacks aus Ihrer App, die Sie sich ansehen möchten.  
 *Typ:* Zeichenfolge  
 *Required*: No

## Optionen
<a name="ref-cli-cmd-watch-options"></a>

Eine Liste der globalen Optionen, die mit allen CDK-CLI-Befehlen funktionieren, finden Sie unter [Globale Optionen](ref-cli-cmd.md#ref-cli-cmd-options).<a name="ref-cli-cmd-watch-options-build-exclude"></a>

 `--build-exclude, -E <ARRAY>`   
Das Asset mit der angegebenen ID darf nicht neu erstellt werden.  
Diese Option kann in einem einzigen Befehl mehrfach angegeben werden.  
 *Standardwert*: `[]` <a name="ref-cli-cmd-watch-options-change-set-name"></a>

 `--change-set-name <STRING>`   
Der Name des zu erstellenden CloudFormation Änderungssatzes.<a name="ref-cli-cmd-watch-options-concurrency"></a>

 `--concurrency <NUMBER>`   
Stellen Sie mehrere Stacks parallel bereit und tauschen Sie sie per Hotswap aus, wobei die Abhängigkeiten zwischen den Stacks berücksichtigt werden. Verwenden Sie diese Option, um Bereitstellungen zu beschleunigen. Sie müssen immer noch andere CloudFormation Gebührenbegrenzungen für AWS Ihr Konto berücksichtigen.  
Geben Sie eine Zahl ein, um die maximale Anzahl gleichzeitiger Bereitstellungen anzugeben (sofern die Abhängigkeit dies zulässt).  
 *Standardwert*: `1` <a name="ref-cli-cmd-watch-options-exclusively"></a>

 `--exclusively, -e <BOOLEAN>`   
Stellen Sie nur angeforderte Stacks bereit und schließen Sie keine Abhängigkeiten ein.<a name="ref-cli-cmd-watch-options-force"></a>

 `--force, -f <BOOLEAN>`   
Stellen Sie immer Stacks bereit, auch wenn die Vorlagen identisch sind.  
 *Standardwert*: `false` <a name="ref-cli-cmd-watch-options-help"></a>

 `--help, -h <BOOLEAN>`   
Zeigt die Befehlsreferenzinformationen für den `cdk watch` Befehl an.<a name="ref-cli-cmd-watch-options-hotswap"></a>

 `--hotswap <BOOLEAN>`   
`cdk watch`Verwendet standardmäßig Hotswap-Bereitstellungen, wenn möglich, um Ihre Ressourcen zu aktualisieren. Die CDK-CLI versucht, eine Hotswap-Bereitstellung durchzuführen, und greift nicht auf eine vollständige CloudFormation Bereitstellung zurück, wenn dies nicht erfolgreich ist. Alle erkannten Änderungen, die nicht über einen Hotswap aktualisiert werden können, werden ignoriert.  
 *Standardwert*: `true` <a name="ref-cli-cmd-watch-options-hotswap-fallback"></a>

 `--hotswap-fallback <BOOLEAN>`   
`cdk watch`Versucht standardmäßig, Hotswap-Bereitstellungen durchzuführen, und ignoriert Änderungen, die Bereitstellungen erfordern. CloudFormation Stellen Sie sicher`--hotswap-fallback`, dass Sie auf eine vollständige Bereitstellung zurückgreifen und eine vollständige CloudFormation Bereitstellung durchführen können, falls die Hotswap-Bereitstellung nicht erfolgreich ist.<a name="ref-cli-cmd-watch-options-logs"></a>

 `--logs <BOOLEAN>`   
`cdk watch`Überwacht standardmäßig alle CloudWatch Protokollgruppen in Ihrer Anwendung und streamt die Protokollereignisse lokal an. `stdout`  
 *Standardwert*: `true` <a name="ref-cli-cmd-watch-options-progress"></a>

 `--progress <STRING>`   
Konfigurieren Sie, wie die CDK-CLI den Bereitstellungsfortschritt anzeigt.  
+  `bar`— Zeigt Ereignisse bei der Stack-Bereitstellung als Fortschrittsbalken an, zusammen mit den Ereignissen für die Ressource, die gerade bereitgestellt wird.
+  `events`— Stellen Sie einen vollständigen Verlauf bereit, einschließlich aller CloudFormation Ereignisse.
Sie können diese Option auch in der `cdk.json` Projektdatei oder `~/.cdk.json` auf Ihrem lokalen Entwicklungscomputer konfigurieren:  

```
{
   "progress": "events"
}
```
 *Zulässige Werte*: `bar`, `events`   
 *Standardwert*: `bar` <a name="ref-cli-cmd-watch-options-rollback"></a>

 `--rollback <BOOLEAN>`   
Wenn während der Bereitstellung eine Ressource nicht erstellt oder aktualisiert werden kann, wird die Bereitstellung auf den neuesten stabilen Status zurückgesetzt, bevor die CDK-CLI zurückkehrt. Alle bis zu diesem Zeitpunkt vorgenommenen Änderungen werden rückgängig gemacht. Ressourcen, die erstellt wurden, werden gelöscht und vorgenommene Aktualisierungen werden rückgängig gemacht.  
Verwenden Sie `--no-rollback` oder`-R`, um dieses Verhalten zu deaktivieren. Wenn eine Ressource nicht erstellt oder aktualisiert werden kann, behält die CDK-CLI die bis zu diesem Zeitpunkt vorgenommenen Änderungen bei und kehrt zurück. Dies kann in Entwicklungsumgebungen hilfreich sein, in denen Sie schnell iterieren.  
Wann`false`, Bereitstellungen, die zu einem Austausch von Ressourcen führen, schlagen immer fehl. Sie können diesen Wert nur für Bereitstellungen verwenden, bei denen neue Ressourcen aktualisiert oder erstellt werden.
 *Standardwert*: `true` <a name="ref-cli-cmd-watch-options-toolkit-stack-name"></a>

 `--toolkit-stack-name <STRING>`   
Der Name des vorhandenen CDK Toolkit-Stacks.  
`cdk bootstrap`Stellt standardmäßig einen Stack mit dem Namen `CDKToolkit` in der angegebenen Umgebung bereit. AWS Verwenden Sie diese Option, um einen anderen Namen für Ihren Bootstrap-Stack anzugeben.  
Die CDK-CLI verwendet diesen Wert, um Ihre Bootstrap-Stack-Version zu überprüfen.

## Beispiele
<a name="ref-cli-cmd-watch-examples"></a>

### Beobachten Sie einen CDK-Stack mit logischer ID auf Änderungen DevelopmentStack
<a name="ref-cli-cmd-watch-examples-1"></a>

```
$ cdk watch DevelopmentStack
Detected change to 'lambda-code/index.js' (type: change). Triggering 'cdk deploy'
DevelopmentStack: deploying...

 ✅  DevelopmentStack
```

### Konfigurieren Sie in einer cdk.json-Datei, welche Elemente ein- und ausgeschlossen werden sollen
<a name="ref-cli-cmd-watch-examples-2"></a>

```
{
   "app": "mvn -e -q compile exec:java",
   "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
   }
}
```

### Erstellen Sie vor der Bereitstellung ein CDK-Projekt mit Java, indem Sie die Datei cdk.json konfigurieren
<a name="ref-cli-cmd-watch-examples-3"></a>

```
{
  "app": "mvn -e -q exec:java",
  "build": "mvn package",
  "watch": {
    "include": "src/main/**",
    "exclude": "target/*"
  }
}
```