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 SAM Referenz
<a name="serverless-sam-reference"></a>

 Dieser Abschnitt enthält AWS SAM Referenzmaterial. Dazu gehören AWS SAMCLI Referenzmaterial wie Referenzinformationen zu AWS SAMCLI Befehlen und zusätzliche AWS SAMCLI Informationen wie Konfiguration, Versionskontrolle und Informationen zur Fehlerbehebung. Darüber hinaus enthält dieser Abschnitt Referenzinformationen zur AWS SAM Spezifikation und zur AWS SAM Vorlage, z. B. Referenzinformationen zu Konnektoren, Image-Repositorys und Bereitstellungen. 

## AWS SAM Spezifikation und Vorlage AWS SAM
<a name="serverless-sam-spec"></a>

Die AWS SAM Spezifikation ist eine Open-Source-Spezifikation unter der Apache 2.0-Lizenz. Die aktuelle Version der AWS SAM Spezifikation ist verfügbar in der[AWS SAM Schablone](sam-specification.md). AWS SAM Die Spezifikation enthält eine vereinfachte Kurzsyntax, mit der Sie die Funktionen, Ereignisse APIs, Konfigurationen und Berechtigungen Ihrer serverlosen Anwendung definieren. 

Sie interagieren mit der AWS SAM Spezifikation über das Projektverzeichnis der AWS SAM Anwendung. Dabei handelt es sich um die Ordner und Dateien, die bei der Ausführung des **sam init** Befehls erstellt werden. Dieses Verzeichnis enthält die AWS SAM Vorlage, eine wichtige Datei, die Ihre AWS Ressourcen definiert. Die AWS SAM Vorlage ist eine Erweiterung einer AWS CloudFormation Vorlage. Die vollständige Referenz für CloudFormation Vorlagen finden Sie unter [Vorlagenreferenz](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-reference.html) im *AWS CloudFormation Benutzerhandbuch*.

## AWS SAMCLIBefehlsreferenz
<a name="serverless-sam-cli"></a>

Die AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) ist ein Befehlszeilentool, das Sie zusammen mit AWS SAM Vorlagen und unterstützten Integrationen von Drittanbietern verwenden können, um Ihre serverlosen Anwendungen zu erstellen und auszuführen.

Sie können die AWS SAMCLI Befehle verwenden, um Ihre serverlosen Anwendungen zu entwickeln, zu testen und bereitzustellen. AWS Cloud Im Folgenden finden Sie einige Beispiele für AWS SAMCLI Befehle:
+ `sam init`— Wenn Sie zum ersten Mal AWS SAMCLI Benutzer sind, können Sie den `sam init` Befehl ohne Parameter ausführen, um eine Hello World-Anwendung zu erstellen. Der Befehl generiert eine vorkonfigurierte AWS SAM Vorlage und einen Beispielanwendungscode in der von Ihnen ausgewählten Sprache.
+ `sam local invoke`und `sam local start-api` — Verwenden Sie diese Befehle, um Ihren Anwendungscode lokal zu testen, bevor Sie ihn auf dem AWS Cloud bereitstellen.
+ `sam logs`— Verwenden Sie diesen Befehl, um Logs abzurufen, die Ihre Lambda-Funktion generiert. Dies kann Ihnen beim Testen und Debuggen Ihrer Anwendung helfen, nachdem Sie sie auf dem bereitgestellt haben. AWS Cloud
+ `sam package`— Verwenden Sie diesen Befehl, um Ihren Anwendungscode und Ihre Abhängigkeiten in einem *Bereitstellungspaket* zu bündeln. Sie benötigen das Bereitstellungspaket, um Ihre Anwendung auf das hochzuladen AWS Cloud.
+ `sam deploy`— Verwenden Sie diesen Befehl, um Ihre serverlose Anwendung auf dem AWS Cloud bereitzustellen. Es erstellt die AWS Ressourcen und legt Berechtigungen und andere Konfigurationen fest, die in der AWS SAM Vorlage definiert sind.

Anweisungen zur Installation von finden AWS SAMCLI Sie unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md).

## AWS SAM Richtlinienvorlagen
<a name="serverless-policy-temps"></a>

Mit AWS SAM können Sie aus einer Liste von Richtlinienvorlagen auswählen, um die Berechtigungen Ihrer AWS Lambda Funktion auf die Ressourcen zu beschränken, die Ihre Anwendung verwendet. Eine Liste der verfügbaren Richtlinienvorlagen finden Sie unter[Tabelle mit Richtlinienvorlagen](serverless-policy-templates.md#serverless-policy-template-table). Allgemeine Informationen zu Richtlinienvorlagen und AWS SAM finden Sie unter[AWS SAM Richtlinienvorlagen](serverless-policy-templates.md).

## Topics
<a name="reference-sam-topics"></a>
+ [AWS SAM Schablone](sam-specification.md)
+ [AWS SAMCLIBefehlsreferenz](serverless-sam-cli-command-reference.md)
+ [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md)
+  [AWS SAM Steckverbinderreferenz](reference-sam-connector.md) 
+ [AWS SAM Richtlinienvorlagen](serverless-policy-templates.md)
+ [Bild-Repositorys für AWS SAM](serverless-image-repositories.md)
+ [Telemetrie in der AWS SAMCLI](serverless-sam-telemetry.md)
+ [Richten Sie den Ressourcenzugriff in Ihrer AWS SAM Vorlage ein und verwalten Sie ihn](sam-permissions.md)

# AWS SAMCLIBefehlsreferenz
<a name="serverless-sam-cli-command-reference"></a>

Dieser Abschnitt enthält Referenzinformationen zu AWS SAMCLI Befehlen. Dieser enthält Informationen zur Verwendung, eine umfassende Liste der verschiedenen Optionen, die für jeden Befehl verfügbar sind, und zusätzliche Informationen. Gegebenenfalls umfassen zusätzliche Informationen Details wie Argumente, Umgebungsvariablen und Ereignisse. Einzelheiten finden Sie in den einzelnen Befehlen. Anweisungen zur Installation von finden AWS SAMCLI Sie unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md).

**Topics**
+ [

# sam build
](sam-cli-command-reference-sam-build.md)
+ [

# sam delete
](sam-cli-command-reference-sam-delete.md)
+ [

# sam deploy
](sam-cli-command-reference-sam-deploy.md)
+ [

# sam init
](sam-cli-command-reference-sam-init.md)
+ [

# sam list
](sam-cli-command-reference-sam-list.md)
+ [

# sam local callback
](sam-cli-command-reference-sam-local-callback.md)
+ [

# sam local execution
](sam-cli-command-reference-sam-local-execution.md)
+ [

# sam local generate-event
](sam-cli-command-reference-sam-local-generate-event.md)
+ [

# sam local invoke
](sam-cli-command-reference-sam-local-invoke.md)
+ [

# sam local start-api
](sam-cli-command-reference-sam-local-start-api.md)
+ [

# sam local start-lambda
](sam-cli-command-reference-sam-local-start-lambda.md)
+ [

# sam logs
](sam-cli-command-reference-sam-logs.md)
+ [

# sam package
](sam-cli-command-reference-sam-package.md)
+ [

# sam pipeline bootstrap
](sam-cli-command-reference-sam-pipeline-bootstrap.md)
+ [

# sam pipeline init
](sam-cli-command-reference-sam-pipeline-init.md)
+ [

# sam publish
](sam-cli-command-reference-sam-publish.md)
+ [

# sam remote callback
](sam-cli-command-reference-sam-remote-callback.md)
+ [

# sam remote execution
](sam-cli-command-reference-sam-remote-execution.md)
+ [

# sam remote invoke
](sam-cli-command-reference-remote-invoke.md)
+ [

# sam remote test-event
](sam-cli-command-reference-remote-test-event.md)
+ [

# sam sync
](sam-cli-command-reference-sam-sync.md)
+ [

# sam traces
](sam-cli-command-reference-sam-traces.md)
+ [

# sam validate
](sam-cli-command-reference-sam-validate.md)

# sam build
<a name="sam-cli-command-reference-sam-build"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam build`.
+ Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam build` Befehls finden Sie unter[Einführung in das Bauen mit AWS SAM](using-sam-cli-build.md).

Der `sam build` Befehl bereitet eine Anwendung für nachfolgende Schritte im Entwickler-Workflow vor, z. B. lokales Testen oder Bereitstellen auf der AWS Cloud.

## Usage
<a name="ref-sam-cli-build-usage"></a>

```
$ sam build <arguments> <options>
```

## Argumente
<a name="ref-sam-cli-build-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="ref-sam-cli-build-args-resource-id"></a>
Optional. Weist an, eine einzelne Ressource AWS SAM zu erstellen, die in einer [AWS SAM Vorlage](what-is-sam-overview.md#what-is-sam-template) deklariert ist. Die Build-Artefakte für die angegebene Ressource sind die einzigen, die für nachfolgende Befehle im Workflow verfügbar sind, d. h. `sam package` und`sam deploy`.

## Optionen
<a name="ref-sam-cli-build-options"></a>

`--base-dir, -s DIRECTORY`  <a name="ref-sam-cli-build-options-base-dir"></a>
Löst relative Pfade zum Quellcode der Funktion oder Ebene in Bezug auf dieses Verzeichnis auf. Verwenden Sie diese Option, wenn Sie ändern möchten, wie relative Pfade zu Quellcode-Ordnern aufgelöst werden. Standardmäßig werden relative Pfade in Bezug auf den Speicherort der AWS SAM Vorlage aufgelöst.  
Zusätzlich zu den Ressourcen in der Root-Anwendung oder dem Root-Stack, den Sie erstellen, werden mit dieser Option auch verschachtelte Anwendungen oder Stacks angewendet.  
Diese Option gilt für die folgenden Ressourcentypen und Eigenschaften:  
+ Ressourcentyp: `AWS::Serverless::Function` Immobilie: `CodeUri`
+ Ressourcentyp: `AWS::Serverless::Function` Ressourcenattribut: `Metadata` Eintrag: `DockerContext`
+ Ressourcentyp: `AWS::Serverless::LayerVersion` Immobilie: `ContentUri`
+ Ressourcentyp: `AWS::Lambda::Function` Immobilie: `Code`
+ Ressourcentyp: `AWS::Lambda::LayerVersion` Immobilie: `Content`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-build-options-beta-features"></a>
Betafunktionen zulassen oder ablehnen.

`--build-dir, -b DIRECTORY`  <a name="ref-sam-cli-build-options-build-dir"></a>
Der Pfad zu einem Verzeichnis, in dem die erstellten Artefakte gespeichert sind. Dieses Verzeichnis und sein gesamter Inhalt werden mit dieser Option entfernt.

`--build-image TEXT`  <a name="ref-sam-cli-build-options-build-image"></a>
Die URI des Container-Images, das Sie für den Build abrufen möchten. Ruft das Container-Image standardmäßig aus Amazon ECR AWS SAM Public ab. Verwenden Sie diese Option, um das Bild von einem anderen Speicherort abzurufen.  
Sie können diese Option mehrfach angeben. Jede Instanz dieser Option kann entweder eine Zeichenfolge oder ein Schlüssel-Wert-Paar annehmen. Wenn Sie eine Zeichenfolge angeben, ist dies die URI des Container-Images, das für alle Ressourcen in Ihrer Anwendung verwendet werden soll. Beispiel, `sam build --use-container --build-image amazon/aws-sam-cli-build-image-python3.8`. Wenn Sie ein Schlüssel-Wert-Paar angeben, ist der Schlüssel der Ressourcenname und der Wert ist der URI des Container-Images, das für diese Ressource verwendet werden soll. Zum Beispiel `sam build --use-container --build-image Function1=amazon/aws-sam-cli-build-image-python3.8`. Mit Schlüssel-Wert-Paaren können Sie verschiedene Container-Images für verschiedene Ressourcen angeben.  
Diese Option gilt nur, wenn die `--use-container` Option angegeben ist, andernfalls tritt ein Fehler auf.

`--build-in-source | --no-build-in-source`  <a name="ref-sam-cli-build-options-build-in-source"></a>
Geben Sie `--build-in-source` an, dass Ihr Projekt direkt im Quellordner erstellt wird.  
Die `--build-in-source` Option unterstützt die folgenden Laufzeiten und Build-Methoden:  
+ **Laufzeiten** — Jede Node.js Laufzeit, die von der `sam init --runtime` Option unterstützt wird.
+ **Methoden erstellen** —`Makefile`,`esbuild`.
Die `--build-in-source` Option ist mit den folgenden Optionen nicht kompatibel:  
+ `--hook-name`
+ `--use-container `
*Standardwert*: `--no-build-in-source`

`--cached | --no-cached`  <a name="ref-sam-cli-build-options-cached"></a>
Aktiviert oder deaktiviert zwischengespeicherte Builds. Verwenden Sie diese Option, um Build-Artefakte wiederzuverwenden, die sich gegenüber früheren Builds nicht geändert haben. AWS SAM bewertet, ob Sie Dateien in Ihrem Projektverzeichnis geändert haben. Standardmäßig werden Builds nicht zwischengespeichert. Wenn die `--no-cached` Option aufgerufen wird, überschreibt sie die `cached = true` Einstellung in samconfig.toml.  
AWS SAM bewertet nicht, ob Sie Module von Drittanbietern geändert haben, von denen Ihr Projekt abhängt, wenn Sie keine bestimmte Version bereitgestellt haben. Wenn Ihre Python-Funktion beispielsweise eine `requirements.txt` Datei mit dem Eintrag `requests=1.x` enthält und die neueste Version des Anforderungsmoduls von `1.1` zu geändert wird`1.2`, ruft sie die neueste Version erst ab, wenn Sie einen AWS SAM nicht zwischengespeicherten Build ausführen.

`--cache-dir`  <a name="ref-sam-cli-build-options-cached-dir"></a>
Das Verzeichnis, in dem die Cache-Artefakte gespeichert werden, wenn `--cached` angegeben. Das Standard-Cache-Verzeichnis ist`.aws-sam/cache`.

`--config-env TEXT`  <a name="ref-sam-cli-build-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-build-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--container-env-var, -e TEXT`  <a name="ref-sam-cli-build-options-container-env-var"></a>
Umgebungsvariablen, die an den Build-Container übergeben werden sollen. Sie können diese Option mehrfach angeben. Jede Instanz dieser Option benötigt ein Schlüssel-Wert-Paar, wobei der Schlüssel die Ressourcen- und Umgebungsvariable und der Wert der Wert der Umgebungsvariablen ist. Beispiel: `--container-env-var Function1.GITHUB_TOKEN=TOKEN1 --container-env-var Function2.GITHUB_TOKEN=TOKEN2`.  
Diese Option gilt nur, wenn die `--use-container` Option angegeben ist, andernfalls tritt ein Fehler auf.

`--container-env-var-file, -ef PATH`  <a name="ref-sam-cli-build-options-container-env-var-file"></a>
Der Pfad und der Dateiname einer JSON-Datei, die Werte für die Umgebungsvariablen des Containers enthält. Weitere Hinweise zu Container-Umgebungsvariablendateien finden Sie unter[Datei mit Container-Umgebungsvariablen](serverless-sam-cli-using-build.md#serverless-sam-cli-using-container-environment-file).  
Diese Option gilt nur, wenn die `--use-container` Option angegeben ist, andernfalls tritt ein Fehler auf.

`--debug`  <a name="ref-sam-cli-build-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von ihm AWS SAMCLI generierten Debug-Meldungen zu drucken und Zeitstempel anzuzeigen.

`--docker-network TEXT`  <a name="ref-sam-cli-build-options-docker-network"></a>
Gibt den Namen oder die ID eines vorhandenen Docker Netzwerks an, mit dem Docker Lambda-Container eine Verbindung herstellen sollen, zusammen mit dem Standard-Bridge-Netzwerk. Wenn nicht angegeben, stellen die Lambda-Container nur eine Verbindung zum Docker Standard-Bridge-Netzwerk her.

`--exclude, -x`  <a name="ref-sam-cli-build-options-exclude"></a>
Der Name der Ressource (n), die von der `sam build` ausgeschlossen werden sollen. Wenn Ihre Vorlage beispielsweise `Function1``Function2`, und enthält `Function3` und Sie ausführen`sam build --exclude Function2`, `Function3` wird nur `Function1` und erstellt.

`--help`  <a name="ref-sam-cli-build-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--hook-name TEXT`  <a name="ref-sam-cli-build-options-hook-name"></a>
Der Name des Hooks, der zur Erweiterung der AWS SAMCLI Funktionalität verwendet wird.  
Zulässige Werte:`terraform`.

`--manifest , -m PATH`  <a name="ref-sam-cli-build-options-manifest"></a>
Der Pfad zu einer benutzerdefinierten Abhängigkeitsmanifestdatei (z. B. package.json), die anstelle der Standarddatei verwendet werden soll.

`--mount-symlinks`  <a name="ref-sam-cli-build-options-mount-symlinks"></a>
Stellt sicher, dass die Symlinks, die in den zu erstellenden oder aufzurufenden Dateien vorhanden sind, AWS SAMCLI immer eingehängt werden. Dies gilt nur für symbolische Links im Verzeichnis der obersten Ebene (d. h. für symbolische Links, die sich direkt im Stammverzeichnis der Funktion befinden). Standardmäßig werden Symlinks nicht gemountet, außer denen, die für die Verwendung `node_modules` in `build-in-source` NodeJS benötigt werden.

`--no-use-container`  <a name="ref-sam-cli-build-options-no-use-container"></a>
Eine Option, mit der Sie das IDE-Toolkit verwenden können, um das Standardverhalten festzulegen. Sie können es auch verwenden`sam build --no-use-container`, um einen Build auf Ihrem lokalen Computer anstelle eines Docker-Containers auszuführen.

`--parallel`  <a name="ref-sam-cli-build-options-parallel"></a>
Ermöglicht parallel Builds. Verwenden Sie diese Option, um die Funktionen und Ebenen Ihrer AWS SAM Vorlage parallel zu erstellen. Standardmäßig werden die Funktionen und Ebenen nacheinander erstellt.

`--parameter-overrides`  <a name="ref-sam-cli-build-options-parameter-overrides"></a>
(Optional) Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare codiert sind. Verwendet dasselbe Format wie (). AWS Command Line Interface AWS CLI Zum Beispiel: '`ParameterKey`=`KeyPairName`, `ParameterValue` `MyKey` `ParameterKey` =`InstanceType`, `ParameterValue` =`t1.micro`'. Diese Option ist nicht kompatibel mit`--hook-name`.

`--profile TEXT`  <a name="ref-sam-cli-build-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="ref-sam-cli-build-options-region"></a>
Das AWS-Region , in dem die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="ref-sam-cli-build-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--skip-prepare-infra`  <a name="ref-sam-cli-build-options-skip-prepare-infra"></a>
Überspringt die Vorbereitungsphase, wenn keine Änderungen an der Infrastruktur vorgenommen wurden. Zusammen mit der `--hook-name` Option verwenden.

`--skip-pull-image`  <a name="ref-sam-cli-build-options-skip-pull-image"></a>
Gibt an, ob der Befehl das Abrufen des neuesten Docker-Images für die Lambda-Laufzeit überspringen soll.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-build-options-template-file"></a>
Der Pfad und der Dateiname der AWS SAM Vorlagendatei. `[default: template.[yaml|yml]]` Diese Option ist nicht kompatibel mit`--hook-name`.

`--terraform-project-root-path`  <a name="ref-sam-cli-build-options-terraform-project-root-path"></a>
Der relative oder absolute Pfad zum Verzeichnis der obersten Ebene, das Ihre Terraform Konfigurationsdateien oder den Funktionsquellcode enthält. Wenn sich diese Dateien außerhalb des Verzeichnisses befinden, das Ihr Terraform Root-Modul enthält, verwenden Sie diese Option, um den absoluten oder relativen Pfad anzugeben. Für diese Option muss dieser `--hook-name` Wert auf gesetzt sein`terraform`.

`--use-container`, `-u`  <a name="ref-sam-cli-build-options-use-container"></a>
Wenn Ihre Funktionen von Paketen abhängen, die nativ kompilierte Abhängigkeiten haben, verwenden Sie diese Option, um Ihre Funktion in einem Lambda-ähnlichen Docker-Container zu erstellen.

## Beispiel
<a name="sam-cli-command-reference-sam-build-examples"></a>

Ein ausführliches Beispiel und eine ausführliche Anleitung zur Verwendung des `sam build` Unterbefehls finden Sie unter. [Einführung in das Bauen mit AWS SAM](using-sam-cli-build.md)

# sam delete
<a name="sam-cli-command-reference-sam-delete"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam delete`.

Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam delete` Befehl löscht eine AWS SAM Anwendung, indem er den CloudFormation Stack, die Artefakte, die verpackt und in Amazon S3 und Amazon ECR bereitgestellt wurden, und die AWS SAM Vorlagendatei löscht.

Dieser Befehl prüft auch, ob ein Amazon ECR-Companion-Stack bereitgestellt ist, und fordert den Benutzer in diesem Fall auf, diesen Stack und die Amazon ECR-Repositorys zu löschen. Wenn `--no-prompts` angegeben, werden Companion-Stacks und Amazon ECR-Repositorys standardmäßig gelöscht.

## Usage
<a name="sam-cli-command-reference-sam-delete-usage"></a>

```
$ sam delete <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-delete-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist `default`. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-delete-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich `samconfig.toml` im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-delete-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die AWS SAMCLI generierte Debug-Nachricht zu drucken und Zeitstempel anzuzeigen.

`--help`  <a name="sam-cli-command-reference-sam-delete-options-help"></a>
Zeigt diese Meldung an und beendet das Programm.

`--no-prompts`  <a name="sam-cli-command-reference-sam-delete-options-no-prompts"></a>
Geben Sie diese Option an, um im nicht interaktiven Modus zu AWS SAM arbeiten. Der Stack-Name muss entweder zusammen mit der `--stack-name` Option oder in der `toml` Konfigurationsdatei angegeben werden.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-delete-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="sam-cli-command-reference-sam-delete-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--s3-bucket`  <a name="sam-cli-command-reference-sam-delete-options-s3-bucket"></a>
Der Pfad des Amazon S3 S3-Buckets, den Sie löschen möchten.

`--s3-prefix`  <a name="sam-cli-command-reference-sam-delete-options-s3-prefix"></a>
Das Präfix des Amazon S3 S3-Buckets, den Sie löschen möchten.

`--save-params`  <a name="sam-cli-command-reference-sam-delete-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-delete-options-stack-name"></a>
Der Name des CloudFormation Stacks, den Sie löschen möchten.

## Beispiele
<a name="sam-cli-command-reference-sam-delete-examples"></a>

Der folgende Befehl löscht den Stack`MY-STACK`. 

```
$ sam delete --stack-name MY-STACK
```

Der folgende Befehl löscht den Stack `MY-STACK` und den S3-Bucket: `sam-s3-demo-bucket`

```
$ sam delete \
    --stack-name MyStack \
    --s3-bucket MySAMBucket
```

# sam deploy
<a name="sam-cli-command-reference-sam-deploy"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam deploy`.
+ Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam deploy` Befehls finden Sie unter[Einführung in die Bereitstellung mit AWS SAM](using-sam-cli-deploy.md).

Der `sam deploy` Befehl stellt eine Anwendung für den AWS Cloud Benutzer bereit. AWS CloudFormation

## Usage
<a name="ref-sam-cli-deploy-usage"></a>

```
$ <environment variables> sam deploy <options>
```

## Umgebungsvariablen
<a name="ref-sam-cli-deploy-env"></a>

`SAM_CLI_POLL_DELAY`  <a name="ref-sam-cli-deploy-env-sam-cli-poll-delay"></a>
Stellen Sie die `SAM_CLI_POLL_DELAY` Umgebungsvariable mit einem Wert von Sekunden in Ihrer Shell ein, um zu konfigurieren, wie oft die AWS SAM-CLI den CloudFormation Stack-Status überprüft. Dies ist nützlich, wenn die Drosselung von angezeigt wird. CloudFormation Diese Umgebungsvariable wird für die Abfrage von `describe_stack` API-Aufrufen verwendet, die während der Ausführung ausgeführt werden. `sam deploy`   
Das Folgende ist ein Beispiel für diese Variable:  

```
$ SAM_CLI_POLL_DELAY=5 sam deploy
```

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

`--capabilities LIST`  <a name="ref-sam-cli-deploy-options-capabilities"></a>
Eine Liste von Funktionen, die Sie angeben müssen, um die Erstellung bestimmter Stacks CloudFormation zu ermöglichen. Einige Stack-Vorlagen können Ressourcen enthalten, die sich auf Ihre Berechtigungen auswirken AWS-Konto, z. B. durch das Erstellen neuer AWS Identity and Access Management (IAM-) Benutzer. Bei diesen Stacks müssen Sie ihre Fähigkeiten ausdrücklich anerkennen, indem Sie diese Option angeben. Die einzigen gültigen Werte sind `CAPABILITY_IAM` und `CAPABILITY_NAMED_IAM`. Wenn Sie über IAM-Ressourcen verfügen, können Sie eine der beiden Funktionen angeben. Wenn Sie über IAM-Ressourcen mit benutzerdefinierten Namen verfügen, müssen Sie Folgendes angeben. `CAPABILITY_NAMED_IAM` Wenn Sie diese Option nicht angeben, gibt der Vorgang einen `InsufficientCapabilities` Fehler zurück.  
Wenn Sie eine Anwendung bereitstellen, die verschachtelte Anwendungen enthält, müssen Sie angeben, dass `CAPABILITY_AUTO_EXPAND` die Anwendung verschachtelte Anwendungen enthält. Weitere Informationen finden Sie unter [Bereitstellen verschachtelter Anwendungen](serverless-sam-template-nested-applications.md#serverless-sam-templates-nested-applications-deploying).

`--config-env TEXT`  <a name="ref-sam-cli-deploy-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist `default`. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-deploy-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich `samconfig.toml` im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="ref-sam-cli-deploy-options-confirm-changeset"></a>
Fordert auf, zu bestätigen, ob der den berechneten Changeset AWS SAMCLI bereitstellt.

`--debug`  <a name="ref-sam-cli-deploy-options-debug"></a>
Aktivieren Sie die Debug-Protokollierung, um die generierte Debug-Nachricht zu drucken und Zeitstempel anzuzeigen. AWS SAMCLI

`--disable-rollback | --no-disable-rollback`  <a name="ref-sam-cli-deploy-options-disable-rollback"></a>
Geben Sie an, ob Ihr CloudFormation Stack zurückgesetzt werden soll, falls während einer Bereitstellung ein Fehler auftritt. Wenn während einer Bereitstellung ein Fehler auftritt, wird Ihr CloudFormation Stack standardmäßig auf den letzten stabilen Status zurückgesetzt. Wenn Sie angeben `--disable-rollback` und während einer Bereitstellung ein Fehler auftritt, werden Ressourcen, die vor dem Auftreten des Fehlers erstellt oder aktualisiert wurden, nicht zurückgesetzt.

`--fail-on-empty-changeset | --no-fail-on-empty-changeset`  <a name="ref-sam-cli-deploy-options-fail-on-empty-changeset"></a>
Geben Sie an, ob ein Exit-Code ungleich Null zurückgegeben werden soll, wenn keine Änderungen am Stack vorgenommen werden müssen. Das Standardverhalten besteht darin, einen Exit-Code ungleich Null zurückzugeben.

`--force-upload`  <a name="ref-sam-cli-deploy-options-force-upload"></a>
Geben Sie diese Option an, um Artefakte hochzuladen, auch wenn sie mit vorhandenen Artefakten im Amazon S3 S3-Bucket übereinstimmen. Passende Artefakte werden überschrieben.

`--guided, -g`  <a name="ref-sam-cli-deploy-options-guided"></a>
Geben Sie diese Option an, damit AWS SAMCLI Sie von den Benutzeraufforderungen durch die Bereitstellung geführt werden.

`--help`  <a name="ref-sam-cli-deploy-options-help"></a>
Diese Meldung anzeigen und beenden.

`--image-repositories TEXT`  <a name="ref-sam-cli-deploy-options-image-repositories"></a>
Eine Zuordnung von Funktionen zu ihrer Amazon ECR-Repository-URI. Referenzfunktionen anhand ihrer logischen ID. Im Folgenden wird ein Beispiel gezeigt:  

```
$ sam deploy --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Sie können diese Option in einem einzigen Befehl mehrfach angeben.

`--image-repository TEXT`  <a name="ref-sam-cli-deploy-options-image-repository"></a>
Der Name des Amazon ECR-Repositorys, in das dieser Befehl das Bild Ihrer Funktion hochlädt. Diese Option ist für Funktionen erforderlich, die mit dem `Image` Pakettyp deklariert wurden.

`--kms-key-id TEXT`  <a name="ref-sam-cli-deploy-options-kms-key-id"></a>
Die ID eines AWS Key Management Service (AWS KMS) -Schlüssels, der zum Verschlüsseln von Artefakten verwendet wird, die sich im Amazon S3 S3-Bucket befinden. Wenn Sie diese Option nicht angeben, werden von Amazon S3 verwaltete Verschlüsselungsschlüssel AWS SAM verwendet.

`--metadata`  <a name="ref-sam-cli-deploy-options-metadata"></a>
Eine Metadatenübersicht, die an alle Artefakte angehängt werden kann, auf die in Ihrer Vorlage verwiesen wird.

`--no-execute-changeset`  <a name="ref-sam-cli-deploy-options-no-execute-changeset"></a>
Gibt an, ob das Changeset angewendet werden soll. Geben Sie diese Option an, wenn Sie Ihre Stack-Änderungen anzeigen möchten, bevor Sie das Changeset anwenden. Dieser Befehl erstellt ein CloudFormation Changeset und wird dann beendet, ohne das Changeset anzuwenden. Um das Changeset anzuwenden, führen Sie denselben Befehl ohne diese Option aus.

`--no-progressbar`  <a name="ref-sam-cli-deploy-options-no-progressbar"></a>
Zeigen Sie keinen Fortschrittsbalken an, wenn Sie Artefakte auf Amazon S3 hochladen.

`--notification-arns LIST`  <a name="ref-sam-cli-deploy-options-notification-arns"></a>
Eine Liste der Amazon Simple Notification Service (Amazon SNS) -Themen ARNs , die mit dem Stack CloudFormation verknüpft sind.

`--on-failure [ROLLBACK | DELETE | DO_NOTHING]`  <a name="ref-sam-cli-deploy-options-on-failure"></a>
Geben Sie die Aktion an, die ausgeführt werden soll, wenn ein Stack nicht erstellt werden kann.  
Die folgenden Optionen sind verfügbar:  
+ `ROLLBACK`— Setzt den Stack auf einen früheren als funktionierend bekannten Zustand zurück.
+ `DELETE`— Bringt den Stack in einen früheren als funktionierend bekannten Zustand zurück, falls einer existiert. Andernfalls wird der Stapel gelöscht.
+ `DO_NOTHING`— Macht den Stapel weder rückgängig noch löscht er ihn. Der Effekt ist derselbe wie der von. `--disable-rollback`
Das Standardverhalten ist `ROLLBACK`.  
Sie können entweder die `--disable-rollback` Option oder die `--on-failure` Option angeben, aber nicht beide.

`--parameter-overrides LIST`  <a name="ref-sam-cli-deploy-options-parameter-overrides"></a>
Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare codiert sind. Jede Überschreibung verwendet das Format. `ParameterKey=name,ParameterValue=value` Mehrere Überschreibungen werden durch Leerzeichen getrennt. Nachfolgend finden Sie zwei Beispiele:  

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2
```

```
$ sam deploy --parameter-overrides ParameterKey=value1,ParameterValue=value2 ParameterKey=hello,ParameterValue=world ParameterKey=apple,ParameterValue=banana
```

`--profile TEXT`  <a name="ref-sam-cli-deploy-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die Anmeldeinformationen abruft AWS .

`--region TEXT`  <a name="ref-sam-cli-deploy-options-region"></a>
Das AWS-Region , in dem die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--resolve-image-repos`  <a name="ref-sam-cli-deploy-options-resolve-image-repos"></a>
Erstellen Sie automatisch Amazon ECR-Repositorys, die für die Paketierung und Bereitstellung für Bereitstellungen ohne Anleitung verwendet werden. Diese Option gilt nur für Funktionen und Ebenen mit den angegebenen Werten. `PackageType: Image` Wenn Sie die `--guided` Option angeben, wird sie AWS SAMCLI ignoriert`--resolve-image-repos`.  
Wenn mit dieser Option AWS SAM automatisch Amazon ECR-Repositorys für Funktionen oder Ebenen erstellt werden und Sie diese Funktionen oder Ebenen später aus Ihrer AWS SAM Vorlage löschen, werden die entsprechenden Amazon ECR-Repositorys automatisch gelöscht.

`--resolve-s3`  <a name="ref-sam-cli-deploy-options-resolve-s3"></a>
Erstellen Sie automatisch einen Amazon S3 S3-Bucket, der für die Paketierung und Bereitstellung bei Bereitstellungen ohne Anleitung verwendet wird. Wenn Sie die `--guided` Option angeben, ignoriert die AWS SAM CLI sie`--resolve-s3`. Wenn Sie sowohl die `--s3-bucket` `--resolve-s3` Optionen als auch angeben, tritt ein Fehler auf.

`--role-arn TEXT`  <a name="ref-sam-cli-deploy-options-role-arn"></a>
Der Amazon-Ressourcenname (ARN) einer IAM-Rolle, der beim Anwenden des Changesets übernommen CloudFormation wird.

`--s3-bucket TEXT`  <a name="ref-sam-cli-deploy-options-s3-bucket"></a>
Der Name des Amazon S3 S3-Buckets, in den dieser Befehl Ihre CloudFormation Vorlage hochlädt. Wenn Ihre Vorlage größer als 51.200 Byte ist, ist entweder die `--s3-bucket` Option oder die `--resolve-s3` Option erforderlich. Wenn Sie sowohl die `--s3-bucket` `--resolve-s3` Optionen als auch angeben, tritt ein Fehler auf.

`--s3-prefix TEXT`  <a name="ref-sam-cli-deploy-options-s3-prefix"></a>
Das Präfix, das den Namen der Artefakte hinzugefügt wird, die in den Amazon S3 S3-Bucket hochgeladen werden. Der Präfixname ist ein Pfadname (Ordnername) für den Amazon S3 S3-Bucket.

`--save-params`  <a name="ref-sam-cli-deploy-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--signing-profiles LIST`  <a name="ref-sam-cli-deploy-options-signing-profiles"></a>
Die Liste der Signaturprofile, mit denen Sie Ihre Bereitstellungspakete signieren können. Diese Option verwendet eine Liste von Schlüssel-Wert-Paaren, wobei der Schlüssel der Name der Funktion oder Ebene ist, die signiert werden soll, und der Wert das Signaturprofil ist, wobei der optionale Profilbesitzer durch getrennt ist. `:` Beispiel, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--stack-name TEXT`  <a name="ref-sam-cli-deploy-options-stack-name"></a>
(Erforderlich) Der Name des CloudFormation Stacks, auf dem Sie die Bereitstellung durchführen. Wenn Sie einen vorhandenen Stack angeben, aktualisiert der Befehl den Stack. Wenn Sie einen neuen Stack angeben, erstellt der Befehl ihn.

`--tags LIST`  <a name="ref-sam-cli-deploy-options-tags"></a>
Eine Liste von Tags, die dem erstellten oder aktualisierten Stapel zugeordnet werden sollen. CloudFormation leitet diese Tags auch an Ressourcen im Stack weiter, die sie unterstützen.

`--template-file, --template, -t PATH`  <a name="ref-sam-cli-deploy-options-template-file"></a>
Der Pfad und der Dateiname, in dem sich Ihre AWS SAM Vorlage befindet.  
Wenn Sie diese Option angeben, werden AWS SAM nur die Vorlage und die lokalen Ressourcen bereitgestellt, auf die sie verweist.

`--use-json`  <a name="ref-sam-cli-deploy-options-use-json"></a>
Gibt JSON für die CloudFormation Vorlage aus. Die Standardausgabe ist YAML.

## Beispiel
<a name="sam-cli-command-reference-sam-deploy-examples"></a>

Ein ausführliches Beispiel und eine ausführliche Anleitung zur Verwendung des `sam deploy` Unterbefehls finden Sie unter. [Einführung in die Bereitstellung mit AWS SAM](using-sam-cli-deploy.md)

# sam init
<a name="sam-cli-command-reference-sam-init"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam init`.
+ Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam init` Befehls finden Sie unter[Erstellen Sie Ihre Bewerbung in AWS SAM](using-sam-cli-init.md).

Der `sam init` Befehl bietet Optionen zum Initialisieren einer neuen serverlosen Anwendung.

## Usage
<a name="sam-cli-command-reference-sam-init-usage"></a>

```
$ sam init <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-init-options"></a>

`--app-template TEXT`  <a name="sam-cli-command-reference-sam-init-options-app-template"></a>
Die ID der verwalteten Anwendungsvorlage, die Sie verwenden möchten. Wenn Sie sich nicht sicher sind, rufen Sie `sam init` ohne Optionen für einen interaktiven Workflow an.  
Dieser Parameter ist erforderlich, wenn `--no-interactive` er angegeben und nicht bereitgestellt `--location` wird.  
Dieser Parameter ist nur in AWS SAMCLI Version 0.30.0 und höher verfügbar. Die Angabe dieses Parameters mit einer früheren Version führt zu einem Fehler.

`--application-insights | --no-application-insights`  <a name="sam-cli-command-reference-sam-init-options-application-insights"></a>
 Aktivieren Sie die Amazon CloudWatch Application Insights-Überwachung für Ihre Anwendung. Weitere Informationen hierzu finden Sie unter [Verwenden von CloudWatch Application Insights zur Überwachung Ihrer AWS SAM serverlosen Anwendungen](monitor-app-insights.md).   
 Die Standardoption ist `--no-application-insights`. 

`--architecture, -a [ x86_64 | arm64 ]`  <a name="sam-cli-command-reference-sam-init-options-architecture"></a>
Die Befehlssatzarchitektur für die Lambda-Funktionen Ihrer Anwendung. Geben Sie einen von `x86_64` oder `arm64` an.

`--base-image [ amazon/dotnet8-base | amazon/dotnet6-base | amazon/java25-base | amazon/java21-base | amazon/java17-base | amazon/java11-base | amazon/nodejs24.x-base | amazon/nodejs22.x-base | amazon/nodejs20.x-base | amazon/nodejs18.x-base | amazon/nodejs16.x-base | amazon/python3.14-base | amazon/python3.13-base | amazon/python3.12-base | amazon/python3.11-base | amazon/python3.10-base | amazon/python3.9-base | amazon/python3.8-base | amazon/ruby3.4-base | amazon/ruby3.3-base | amazon/ruby3.2-base ]`  <a name="sam-cli-command-reference-sam-init-options-base-image"></a>
Das Basis-Image Ihrer Anwendung. Diese Option gilt nur, wenn der Pakettyp ist`Image`.  
Dieser Parameter ist erforderlich, wenn `--no-interactive` er angegeben`Image`, `--package-type` als angegeben und nicht angegeben `--location` ist.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-init-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-init-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-init-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von ihm AWS SAMCLI generierten Debug-Meldungen auszudrucken und Zeitstempel anzuzeigen.

`--dependency-manager, -d [ gradle | mod | maven | bundler | npm | cli-package | pip ]`  <a name="sam-cli-command-reference-sam-init-options-dependency-manager"></a>
Der Abhängigkeitsmanager Ihrer Lambda-Laufzeit.

`--extra-content`  <a name="sam-cli-command-reference-sam-init-options-extra-content"></a>
Überschreiben Sie alle benutzerdefinierten Parameter in der `cookiecutter.json` Konfiguration der Vorlage, `{"customParam1": "customValue1", "customParam2":"customValue2"}` z. B.

`--help, -h`  <a name="sam-cli-command-reference-sam-init-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--location, -l TEXT`  <a name="sam-cli-command-reference-sam-init-options-location"></a>
Der Speicherort der Vorlage oder Anwendung (Git, Mercurial, HTTP/HTTPS, .zip-Datei, Pfad).  
Dieser Parameter ist erforderlich, wenn er angegeben `--no-interactive` ist und `--runtime``--name`, und `--app-template` nicht angegeben werden.  
Für Git-Repositorys müssen Sie den Speicherort des Stammverzeichnisses des Repositorys verwenden.  
Für lokale Pfade muss die Vorlage entweder im ZIP-Format oder im [Cookiecutter-Format](https://cookiecutter.readthedocs.io/en/latest/README.html) vorliegen.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-init-options-name"></a>
Der Name Ihres Projekts, das als Verzeichnis generiert werden soll.  
Dieser Parameter ist erforderlich, wenn `--no-interactive` er angegeben und nicht bereitgestellt `--location` wird.

`--no-input`  <a name="sam-cli-command-reference-sam-init-options-no-input"></a>
Deaktiviert die Cookiecutter-Aufforderung und akzeptiert die VCF-Standardwerte, die in der Vorlagenkonfiguration definiert sind.

`--no-interactive`  <a name="sam-cli-command-reference-sam-init-options-no-interactive"></a>
Deaktiviert die interaktive Aufforderung für Init-Parameter und schlägt fehl, wenn erforderliche Werte fehlen.

`--output-dir, -o PATH`  <a name="sam-cli-command-reference-sam-init-options-output-dir"></a>
Der Ort, an dem die initialisierte Anwendung ausgegeben wird.

`--package-type [ Zip | Image ]`  <a name="sam-cli-command-reference-sam-init-options-package-type"></a>
Der Pakettyp der Beispielanwendung. `Zip`erstellt ein ZIP-Dateiarchiv und `Image` ein Container-Image.

`--runtime, -r [ dotnet8 | dotnet6 | java25 | java21 | java17 | java11 | nodejs24.x | nodejs22.x | nodejs20.x | nodejs18.x | nodejs16.x | python3.14 | python3.13 | python3.12 | python3.11 | python3.10 | python3.9 | python3.8 | ruby3.4 | ruby3.3 | ruby3.2 ]`  <a name="sam-cli-command-reference-sam-init-options-runtime"></a>
Die Lambda-Laufzeit Ihrer Anwendung. Diese Option gilt nur, wenn der Pakettyp ist`Zip`.  
Dieser Parameter ist erforderlich, wenn `--no-interactive` er angegeben`Zip`, `--package-type` als angegeben und nicht angegeben `--location` ist.

`--save-params`  <a name="sam-cli-command-reference-sam-init-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--tracing | --no-tracing`  <a name="sam-cli-command-reference-sam-init-options-tracing"></a>
Aktivieren Sie AWS X-Ray die Ablaufverfolgung für Ihre Lambda-Funktionen.

## Beispiel
<a name="sam-cli-command-reference-sam-init-examples"></a>

Ein ausführliches Beispiel und eine ausführliche Anleitung zur Verwendung des `sam init` Unterbefehls finden Sie unter. [Erstellen Sie Ihre Bewerbung in AWS SAM](using-sam-cli-init.md)

# sam list
<a name="sam-cli-command-reference-sam-list"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam list`.

Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam list` Befehl gibt wichtige Informationen über die Ressourcen in Ihrer serverlosen Anwendung und den Status Ihrer serverlosen Anwendung aus. Verwenden Sie es **sam list** vor und nach der Bereitstellung, um Sie bei der lokalen und Cloud-Entwicklung zu unterstützen.

## Usage
<a name="sam-cli-command-reference-sam-list-usage"></a>

```
$ sam list <options> <subcommand>
```

## Optionen
<a name="sam-cli-command-reference-sam-list-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-list-options-help"></a>
Zeige diese Nachricht und beende den Vorgang.

## Unterbefehle
<a name="sam-cli-command-reference-sam-list-subcommands"></a>

`endpoints`  <a name="sam-cli-command-reference-sam-list-subcommands-endpoints"></a>
Zeigt eine Liste der Cloud- und lokalen Endpunkte aus Ihrem CloudFormation Stack an. Weitere Informationen finden Sie unter [sam list endpoints](sam-cli-command-reference-sam-list-endpoints.md).

`resources`  <a name="sam-cli-command-reference-sam-list-subcommands-resources"></a>
Zeigt die Ressourcen in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) an, die AWS CloudFormation bei der Bereitstellung erstellt wurden. Weitere Informationen finden Sie unter [sam list resources](sam-cli-command-reference-sam-list-resources.md).

`stack-outputs`  <a name="sam-cli-command-reference-sam-list-subcommands-stack-outputs"></a>
Zeigt die Ausgaben Ihres CloudFormation Stacks aus einer AWS SAM CloudFormation OR-Vorlage an. Weitere Informationen finden Sie unter [sam list stack-outputs](sam-cli-command-reference-sam-list-stack-outputs.md).

# sam list endpoints
<a name="sam-cli-command-reference-sam-list-endpoints"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam list endpoints` Unterbefehl Command Line Interface (AWS SAMCLI).

Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam list endpoints` Unterbefehl zeigt eine Liste der Cloud- und lokalen Endpunkte aus Ihrem CloudFormation Stack an. Sie können mit diesen Ressourcen über die Befehle **sam local** und **sam sync** interagieren.

AWS Lambda und Amazon API Gateway Gateway-Ressourcentypen werden mit diesem Befehl unterstützt.

**Anmerkung**  
Benutzerdefinierte Domains werden unterstützt, wenn sie für Ihre Amazon API Gateway Gateway-Ressourcen konfiguriert sind. Dieser Befehl gibt die benutzerdefinierte Domain statt des Standardendpunkts aus.

## Usage
<a name="sam-cli-command-reference-sam-list-endpoints-usage"></a>

```
$ sam list endpoints <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-list-endpoints-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt.  
*Standardwert*: `default`  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält.  
*Standardwert*: `samconfig.toml` im aktuellen Arbeitsverzeichnis.  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-endpoints-options-debug"></a>
Schalten Sie die Debug-Protokollierung ein, um die von der generierten Debug-Meldungen AWS SAMCLI mit Zeitstempeln zu drucken.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-endpoints-options-help"></a>
Diese Nachricht anzeigen und beenden.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-endpoints-options-output"></a>
Geben Sie das Format für die Ausgabe der Ergebnisse an.  
*Standardwert*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-profile"></a>
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-region"></a>
Stellen Sie die AWS Region des Dienstes ein. Beispiel, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-endpoints-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-endpoints-options-stack-name"></a>
Name des bereitgestellten CloudFormation Stacks. Der Stack-Name befindet sich in der `samconfig.toml` Datei Ihrer Anwendung oder der angegebenen Konfigurationsdatei.  
Wenn diese Option nicht angegeben ist, werden die in Ihrer Vorlage definierten lokalen Ressourcen angezeigt.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-endpoints-options-template"></a>
AWS SAM Vorlagendatei.  
*Standardwert*: `template.[yaml|yml|json]`

## Beispiele
<a name="sam-cli-command-reference-sam-list-endpoints-examples"></a>

Zeigt im JSON-Format eine Ausgabe der bereitgestellten Ressourcenendpunkte aus Ihrem CloudFormation Stack mit dem Namen `test-stack` an.

```
$ sam list endpoints --stack-name test-stack --output json
			
[
  {
    "LogicalResourceId": "HelloWorldFunction",
    "PhysicalResourceId": "sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq",
    "CloudEndpoint": "https://zt55oi7kbljxjmcoahsj3cknwu0rposq.lambda-url.us-east-1.on.aws/",
    "Methods": "-"
  },
  {
    "LogicalResourceId": "ServerlessRestApi",
    "PhysicalResourceId": "uj80uoe2o2",
    "CloudEndpoint": [
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Prod",
      "https://uj80uoe2o2.execute-api.us-east-1.amazonaws.com/Stage"
    ],
    "Methods": [
      "/hello['get']"
    ]
  }
]
```

# sam list resources
<a name="sam-cli-command-reference-sam-list-resources"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam list resources` Unterbefehl Command Line Interface (AWS SAMCLI).

Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam list resources` Unterbefehl zeigt die Ressourcen in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) an, die AWS CloudFormation durch die AWS SAM Transformation bei der Bereitstellung erstellt wurden.

Verwenden Sie es vor der Bereitstellung **sam list resources** zusammen mit einer AWS SAM Vorlage, um zu sehen, welche Ressourcen erstellt werden. Geben Sie einen CloudFormation Stack-Namen ein, um eine konsolidierte Liste mit bereitgestellten Ressourcen anzuzeigen.

**Anmerkung**  
Um eine Liste von Ressourcen aus Ihrer AWS SAM Vorlage zu generieren, wird eine lokale Transformation Ihrer Vorlage durchgeführt. Ressourcen, die unter bestimmten Bedingungen bereitgestellt werden, z. B. in einer bestimmten Region, sind in dieser Liste enthalten.

## Usage
<a name="sam-cli-command-reference-sam-list-resources-usage"></a>

```
$ sam list resources <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-list-resources-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt.  
*Standardwert*: `default`  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält.  
*Standardwert*: `samconfig.toml` im aktuellen Arbeitsverzeichnis.  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-resources-options-debug"></a>
Schalten Sie die Debug-Protokollierung ein, um die von der generierten Debug-Meldungen AWS SAMCLI mit Zeitstempeln zu drucken.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-resources-options-help"></a>
Diese Nachricht anzeigen und beenden.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-resources-options-output"></a>
Geben Sie das Format für die Ausgabe der Ergebnisse an.  
*Standardwert*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-profile"></a>
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-region"></a>
Stellen Sie die AWS Region des Dienstes ein. Beispiel, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-resources-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-resources-options-stack-name"></a>
Name des bereitgestellten CloudFormation Stacks. Der Stack-Name befindet sich in der `samconfig.toml` Datei Ihrer Anwendung oder der angegebenen Konfigurationsdatei.  
Falls angegeben, wird die logische Ressource IDs aus Ihrer Vorlage dem entsprechenden physischen IDs Eingang zugeordnet. CloudFormation Weitere Informationen zu physischen IDs [Ressourcen finden Sie im *AWS CloudFormation Benutzerhandbuch* unter Ressourcenfelder](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-resource-fields).  
Wenn diese Option nicht angegeben ist, werden die in Ihrer Vorlage definierten lokalen Ressourcen angezeigt.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-list-resources-options-"></a>
AWS SAM Vorlagendatei.  
*Standardwert*: `template.[yaml|yml|json]`

## Beispiele
<a name="sam-cli-command-reference-sam-list-resources-examples"></a>

Zeigt im Tabellenformat eine Ausgabe der lokalen Ressourcen aus Ihrer AWS SAM Vorlage und der bereitgestellten Ressourcen aus Ihrem CloudFormation Stack mit dem Namen an`test-stack`. Führen Sie das Programm aus demselben Verzeichnis wie Ihre lokale Vorlage aus.

```
$ sam list resources --stack-name test-stack --output table
			
-------------------------------------------------------------------------------------------------------------------------
Logical ID                                                   Physical ID
-------------------------------------------------------------------------------------------------------------------------
HelloWorldFunction                                           sam-app-test-list-HelloWorldFunction-H85Y7yIV7ZLq
HelloWorldFunctionHelloWorldPermissionProd                   sam-app-test-list-
                                                             HelloWorldFunctionHelloWorldPermissionProd-1QH7CPOCBL2IK
HelloWorldFunctionRole                                       sam-app-test-list-HelloWorldFunctionRole-SRJDMJ6F7F41
ServerlessRestApi                                            uj80uoe2o2
ServerlessRestApiDeployment47fc2d5f9d                        pncw5f
ServerlessRestApiProdStage                                   Prod
ServerlessRestApiDeploymentf5716dc08b                        -
-------------------------------------------------------------------------------------------------------------------------
```

# sam list stack-outputs
<a name="sam-cli-command-reference-sam-list-stack-outputs"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam list stack-outputs` Unterbefehl Command Line Interface (AWS SAMCLI).

Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam list stack-outputs` Unterbefehl zeigt die Ausgaben Ihres AWS CloudFormation Stacks aus einer AWS Serverless Application Model (AWS SAM) oder einer CloudFormation Vorlage an. Weitere Informationen dazu `Outputs` finden Sie unter [Ausgaben](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/outputs-section-structure.html) im *AWS CloudFormation Benutzerhandbuch*.

## Usage
<a name="sam-cli-command-reference-sam-list-stack-outputs-usage"></a>

```
$ sam list stack-outputs <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-list-stack-outputs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt.  
*Standardwert*: `default`  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält.  
*Standardwert*: `samconfig.toml` im aktuellen Arbeitsverzeichnis.  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-debug"></a>
Schalten Sie die Debug-Protokollierung ein, um die von der generierten Debug-Meldungen AWS SAMCLI mit Zeitstempeln zu drucken.

`--help, -h`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-help"></a>
Diese Nachricht anzeigen und beenden.

`--output [json|table]`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-output"></a>
Geben Sie das Format für die Ausgabe der Ergebnisse an.  
*Standardwert*: `table`

`--profile TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-profile"></a>
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--region TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-region"></a>
Stellen Sie die AWS Region des Dienstes ein. Beispiel, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-list-stack-outputs-options-"></a>
Name des bereitgestellten CloudFormation Stacks. Der Stack-Name befindet sich in der `samconfig.toml` Datei Ihrer Anwendung oder der angegebenen Konfigurationsdatei.  
Diese Option ist erforderlich.

## Beispiele
<a name="sam-cli-command-reference-sam-list-stack-outputs-examples"></a>

Zeigt die Ausgaben der Ressourcen in Ihrem CloudFormation Stack mit dem Namen im Tabellenformat an`test-stack`.

```
$ sam list stack-outputs --stack-name test-stack --output table
			
------------------------------------------------------------------------------------------------------------------------
OutputKey                                OutputValue                              Description
------------------------------------------------------------------------------------------------------------------------
HelloWorldFunctionIamRole                arn:aws:iam::account-number:role/sam-      Implicit IAM Role created for Hello
                                         app-test-list-HelloWorldFunctionRole-    World function
                                         SRJDMJ6F7F41
HelloWorldApi                            https://uj80uoe2o2.execute-api.us-       API Gateway endpoint URL for Prod
                                         east-1.amazonaws.com/Prod/hello/         stage for Hello World function
HelloWorldFunction                       arn:aws:lambda:us-                       Hello World Lambda Function ARN
                                         east-1:account-number:function:sam-app-
                                         test-list-
                                         HelloWorldFunction-H85Y7yIV7ZLq
------------------------------------------------------------------------------------------------------------------------
```

# sam local callback
<a name="sam-cli-command-reference-sam-local-callback"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam local callback`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Mit `sam local callback` diesem Befehl können Sie während der Entwicklung und beim Testen Rückrufe an lokale, dauerhafte Funktionsausführungen senden.

## Usage
<a name="sam-cli-command-reference-sam-local-callback-usage"></a>

```
$ sam local callback <subcommand> <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-local-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-callback-options-help"></a>
Zeige diese Nachricht und beende das Programm.

## Unterbefehle
<a name="sam-cli-command-reference-sam-local-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-succeed"></a>
Sendet einen erfolgreichen Rückruf an eine dauerhafte Funktionsausführung. Weitere Informationen finden Sie unter [sam local callback succeed](sam-cli-command-reference-sam-local-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-fail"></a>
Sendet einen Fehler-Callback an eine dauerhafte Funktionsausführung. Weitere Informationen finden Sie unter [sam local callback fail](sam-cli-command-reference-sam-local-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-local-callback-subcommands-heartbeat"></a>
Sendet einen Heartbeat-Callback an eine dauerhafte Funktionsausführung. Weitere Informationen finden Sie unter [sam local callback heartbeat](sam-cli-command-reference-sam-local-callback-heartbeat.md).

# sam local callback succeed
<a name="sam-cli-command-reference-sam-local-callback-succeed"></a>

Sendet einen erfolgreichen Rückruf an eine dauerhafte Funktionsausführung.

## Usage
<a name="ref-sam-cli-local-callback-succeed-usage"></a>

```
$ sam local callback succeed CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Rückrufs, an den eine Erfolgsantwort gesendet werden soll.

## Optionen
<a name="ref-sam-cli-local-callback-succeed-options"></a>

`-r, --result TEXT`  
Payload des Erfolgsergebnisses als Zeichenfolge.

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-local-callback-succeed-examples"></a>

Erfolgreicher Rückruf ohne Ergebnis senden:

```
$ sam local callback succeed my-callback-id
```

Erfolgs-Rückruf mit Ergebnis senden:

```
$ sam local callback succeed my-callback-id --result 'Task completed successfully'
```

Erfolgs-Rückruf mit Kurzoption senden:

```
$ sam local callback succeed my-callback-id -r 'Success result'
```

# sam local callback fail
<a name="sam-cli-command-reference-sam-local-callback-fail"></a>

Sendet einen Fehler-Callback an eine dauerhafte Funktionsausführung.

## Usage
<a name="ref-sam-cli-local-callback-fail-usage"></a>

```
$ sam local callback fail CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-callback-fail-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Callbacks, an den eine Fehlerantwort gesendet werden soll.

## Optionen
<a name="ref-sam-cli-local-callback-fail-options"></a>

`--error-data TEXT`  
Zusätzliche Fehlerdaten.

`--stack-trace TEXT`  
Trace-Einträge stapeln. Diese Option kann mehrfach angegeben werden.

`--error-type TEXT`  
Fehlertyp.

`--error-message TEXT`  
Ausführliche Fehlermeldung.

`--region TEXT`  
Stellen Sie die AWS Region des Dienstes ein (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-local-callback-fail-examples"></a>

Fehlgeschlagener Rückruf ohne Parameter senden:

```
$ sam local callback fail my-callback-id
```

Fehlerrückruf mit Fehlermeldung senden:

```
$ sam local callback fail my-callback-id --error-message 'Task failed'
```

Fehler-Callback mit allen Parametern senden:

```
$ sam local callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam local callback heartbeat
<a name="sam-cli-command-reference-sam-local-callback-heartbeat"></a>

Sendet einen Heartbeat-Callback an eine dauerhafte Funktionsausführung.

## Usage
<a name="ref-sam-cli-local-callback-heartbeat-usage"></a>

```
$ sam local callback heartbeat CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Rückrufs, an den ein Heartbeat gesendet werden soll.

## Optionen
<a name="ref-sam-cli-local-callback-heartbeat-options"></a>

`--region TEXT`  
Stellen Sie die AWS Region des Dienstes ein (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-local-callback-heartbeat-examples"></a>

Heartbeat-Rückruf senden:

```
$ sam local callback heartbeat my-callback-id
```

# sam local execution
<a name="sam-cli-command-reference-sam-local-execution"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam local execution`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Mit `sam local execution` diesem Befehl können Sie lokale dauerhafte Funktionsausführungen während der Entwicklung und des Testens verwalten und überprüfen.

**Anmerkung**  
Für diese Befehle ist möglicherweise kein Zugriff auf AWS Anmeldeinformationen erforderlich.

## Usage
<a name="sam-cli-command-reference-sam-local-execution-usage"></a>

```
$ sam local execution <subcommand> <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-local-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-local-execution-options-help"></a>
Zeige diese Nachricht und beende das Programm.

## Unterbefehle
<a name="sam-cli-command-reference-sam-local-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-get"></a>
Informieren Sie sich über die Ausführung einer dauerhaften Funktion. Weitere Informationen finden Sie unter [sam local execution get](sam-cli-command-reference-sam-local-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-history"></a>
Ruft den Ausführungsverlauf einer dauerhaften Funktionsausführung ab. Weitere Informationen finden Sie unter [sam local execution history](sam-cli-command-reference-sam-local-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-local-execution-subcommands-stop"></a>
Stoppt die Ausführung einer dauerhaften Funktion. Weitere Informationen finden Sie unter [sam local execution stop](sam-cli-command-reference-sam-local-execution-stop.md).

# sam local execution get
<a name="sam-cli-command-reference-sam-local-execution-get"></a>

Rufen Sie die Details einer bestimmten dauerhaften Funktionsausführung ab.

**Anmerkung**  
Für diesen Befehl ist möglicherweise kein Zugriff auf AWS Anmeldeinformationen erforderlich.

## Usage
<a name="ref-sam-cli-local-execution-get-usage"></a>

```
$ sam local execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Der Amazon-Ressourcenname (ARN) der dauerhaften Funktionsausführung, für die Details abgerufen werden sollen.

## Optionen
<a name="ref-sam-cli-local-execution-get-options"></a>

`--format [summary|json]`  
Ausgabeformat; Standard: `summary`

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und wird beendet.

## Beispiele
<a name="ref-sam-cli-local-execution-get-examples"></a>

Rufen Sie die Ausführungsdetails im Standardzusammenfassungsformat ab:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Holen Sie sich Ausführungsdetails im JSON-Format:

```
$ sam local execution get arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam local execution history
<a name="sam-cli-command-reference-sam-local-execution-history"></a>

Ruft den Ausführungsverlauf einer dauerhaften Funktionsausführung ab.

## Usage
<a name="ref-sam-cli-local-execution-history-usage"></a>

```
$ sam local execution history EXECUTION_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-execution-history-arguments"></a>

`EXECUTION_ID`  
Die eindeutige Kennung der dauerhaften Funktionsausführung, für die der Verlauf abgerufen werden soll.

## Optionen
<a name="ref-sam-cli-local-execution-history-options"></a>

`--format [table|json]`  
Ausgabeformat; Standard: `table`

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-local-execution-history-examples"></a>

Den Ausführungsverlauf im Tabellenformat abrufen:

```
$ sam local execution history my-execution-id
```

Ausführungshistorie im JSON-Format abrufen:

```
$ sam local execution history my-execution-id --format json
```

# sam local execution stop
<a name="sam-cli-command-reference-sam-local-execution-stop"></a>

Stoppt die Ausführung einer laufenden dauerhaften Funktion.

**Anmerkung**  
Für diesen Befehl ist möglicherweise kein Zugriff auf AWS Anmeldeinformationen erforderlich.

## Usage
<a name="ref-sam-cli-local-execution-stop-usage"></a>

```
$ sam local execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-local-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Der Amazon-Ressourcenname (ARN) der dauerhaften Funktionsausführung, die gestoppt werden soll.

## Optionen
<a name="ref-sam-cli-local-execution-stop-options"></a>

`--error-message TEXT`  
Fehlermeldung, die mit der gestoppten Ausführung verknüpft werden soll.

`--error-type TEXT`  
Fehlertyp, der der gestoppten Ausführung zugeordnet werden soll.

`--error-data TEXT`  
Fehlerdaten, die der gestoppten Ausführung zugeordnet werden sollen.

`--stack-trace TEXT`  
Trace-Einträge stapeln. Diese Option kann mehrfach angegeben werden.

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-local-execution-stop-examples"></a>

Ausführung ohne Fehlerdetails beenden:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Beenden Sie die Ausführung mit einer Fehlermeldung und geben Sie Folgendes ein:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Beenden Sie die Ausführung mit vollständigen Fehlerdetails und Stack-Trace:

```
$ sam local execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam local generate-event
<a name="sam-cli-command-reference-sam-local-generate-event"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Unterbefehl Command Line Interface (AWS SAMCLI)`sam local generate-event`.
+ Eine Einführung in das finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam local generate-event` Befehls finden Sie unter[Einführung in das Testen mit sam local generate-event](using-sam-cli-local-generate-event.md).

Der `sam local generate-event` Unterbefehl generiert Beispiele für Nutzdaten für Ereignisse, die unterstützt werden. AWS-Services

## Usage
<a name="ref-sam-cli-local-generate-event-usage"></a>

```
$ sam local generate-event <options> <service> <event> <event-options>
```

## Optionen
<a name="ref-sam-cli-local-generate-event-options"></a>

`--config-env TEXT`  <a name="ref-sam-cli-local-generate-event-options-config-env"></a>
Der Name der Umgebung, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-generate-event-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich `samconfig.toml` im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--help`  <a name="ref-sam-cli-local-generate-event-options-help"></a>
Zeigt diese Nachricht an und wird beendet.

## Service
<a name="ref-sam-cli-local-generate-event-service"></a>

Führen Sie den folgenden Befehl aus, um eine Liste der unterstützten Dienste anzuzeigen:

```
$ sam local generate-event
```

## Veranstaltung
<a name="ref-sam-cli-local-generate-event-event"></a>

Führen Sie den folgenden Befehl aus, um eine Liste der unterstützten Ereignisse anzuzeigen, die für jeden Dienst generiert werden können:

```
$ sam local generate-event <service>
```

## Optionen für Ereignisse
<a name="ref-sam-cli-local-generate-event-event-options"></a>

Führen Sie den folgenden Befehl aus, um eine Liste der unterstützten Ereignisoptionen anzuzeigen, die Sie ändern können:

```
$ sam local generate-event <service> <event> --help
```

## Beispiele
<a name="sam-cli-command-reference-sam-local-generate-event-examples"></a>

Beispiele zur Verwendung des `sam local generate-event` Unterbefehls finden Sie unter. [Generieren Sie Beispielereignisse](using-sam-cli-local-generate-event.md#using-sam-cli-local-generate-event-generate)

# sam local invoke
<a name="sam-cli-command-reference-sam-local-invoke"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam local invoke` Unterbefehl Command Line Interface (AWS SAMCLI).
+ Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam local invoke` Unterbefehls finden Sie unter[Einführung in das Testen mit sam local invoke](using-sam-cli-local-invoke.md).

Der `sam local invoke` Unterbefehl initiiert einen einmaligen lokalen Aufruf einer Funktion. AWS Lambda 

**Anmerkung**  
Es wird nicht empfohlen, die lokalen Aufruffunktionen von SAM CLI in nicht vertrauenswürdigem Code zu verwenden. Um eine vollständige Isolierung von Ihrer lokalen Umgebung zu erreichen, führen Sie den Code direkt im Lambda-Service aus.

**Anmerkung**  
`sam local invoke`Unterstützt für langlebige Funktionen die statusbehaftete Ausführung mit automatischem Checkpoint und automatischer Wiedergabe. Der Container läuft während der Ausführung dauerhafter Funktionen weiter, um die Beibehaltung und Wiederaufnahme des Zustands zu gewährleisten.

## Usage
<a name="ref-sam-cli-local-invoke-usage"></a>

```
$ sam local invoke <arguments> <options>
```

**Anmerkung**  
Wenn in Ihrer AWS SAM Vorlage mehr als eine Funktion definiert ist, geben Sie die logische ID der Funktion an, die Sie aufrufen möchten.

## Argumente
<a name="ref-sam-cli-local-invoke-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="ref-sam-cli-local-invoke-args-resource-id"></a>
Die ID der aufzurufenden Lambda-Funktion.  
Dieses Argument ist optional. Wenn Ihre Anwendung eine einzelne Lambda-Funktion enthält, wird sie von der AWS SAM CLI aufgerufen. Wenn Ihre Anwendung mehrere Funktionen enthält, geben Sie die ID der aufzurufenden Funktion an.  
*Gültige Werte*: Die logische ID oder der Ressourcen-ARN der Ressource.

## Optionen
<a name="ref-sam-cli-local-invoke-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-invoke-options-add-host"></a>
Übergibt eine Zuordnung von Hostname zu IP-Adresse an die Hostdatei des Docker-Containers. Dieser Parameter kann mehrfach übergeben werden.  

**Example**  
Beispiel: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-invoke-options-beta-features"></a>
Betafunktionen zulassen oder ablehnen.

`--config-env TEXT`  <a name="ref-sam-cli-local-invoke-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-invoke-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-invoke-options-container-env-vars"></a>
(Optional) Übergeben Sie beim lokalen Debuggen Umgebungsvariablen an den Image-Container der Lambda-Funktion.

`--container-host TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host"></a>
Host eines lokal emulierten Lambda-Containers. Der Standardwert ist `localhost`. Wenn Sie AWS SAMCLI in einem Docker-Container auf macOS laufen möchten, können Sie angeben`host.docker.internal`. Wenn Sie den Container auf einem anderen Host ausführen möchten als AWS SAMCLI, können Sie die IP-Adresse des Remote-Hosts angeben.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-invoke-options-container-host-interface"></a>
Die IP-Adresse der Host-Netzwerkschnittstelle, an die Container-Ports gebunden werden sollen. Der Standardwert ist `127.0.0.1`. Wird verwendet`0.0.0.0`, um an alle Schnittstellen zu binden.

`--debug`  <a name="ref-sam-cli-local-invoke-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von ihm AWS SAMCLI generierten Debug-Meldungen zu drucken und Zeitstempel anzuzeigen.

`--debug-args TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-args"></a>
Zusätzliche Argumente, die an den Debugger übergeben werden.

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-invoke-options-debug-port"></a>
Wenn angegeben, wird der Lambda-Funktionscontainer im Debug-Modus gestartet und dieser Port auf dem lokalen Host verfügbar gemacht.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-invoke-options-debugger-path"></a>
Der Hostpfad zu einem Debugger, der in den Lambda-Container gemountet ist.

`--docker-network TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-network"></a>
Der Name oder die ID eines vorhandenen Docker-Netzwerks, mit dem Lambda-Docker-Container eine Verbindung herstellen sollen, zusammen mit dem Standard-Bridge-Netzwerk. Wenn dies nicht angegeben ist, stellen die Lambda-Container nur eine Verbindung zum Standard-Bridge-Docker-Netzwerk her.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-invoke-options-docker-volume-basedir"></a>
Der Speicherort des Basisverzeichnisses, in dem die AWS SAM Datei existiert. Wenn Docker auf einem Remote-Computer ausgeführt wird, müssen Sie den Pfad, in dem sich die AWS SAM Datei befindet, auf dem Docker-Computer bereitstellen und diesen Wert so ändern, dass er mit dem Remote-Computer übereinstimmt.

`--durable-execution-name TEXT`  <a name="ref-sam-cli-local-invoke-options-durable-execution-name"></a>
Name für die dauerhafte Ausführung (nur für dauerhafte Funktionen)

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-invoke-options-env-vars"></a>
Die `.env` JSON-Datei oder die Datei, die Werte für die Umgebungsvariablen der Lambda-Funktion enthält. Das Dateiformat wird automatisch erkannt. Weitere Hinweise zu Umgebungsvariablendateien finden Sie unter[Umgebungsvariablendatei](serverless-sam-cli-using-invoke.md#serverless-sam-cli-using-invoke-environment-file).

`--event, -e PATH`  <a name="ref-sam-cli-local-invoke-options-event"></a>
Die JSON-Datei, die Ereignisdaten enthält, die an die Lambda-Funktion übergeben werden, wenn sie aufgerufen wird. Wenn Sie diese Option nicht angeben, wird kein Ereignis angenommen. Um JSON von einzugeben`stdin`, müssen Sie den Wert '-' übergeben. Einzelheiten zu den Formaten von Ereignisnachrichten verschiedener AWS Dienste finden Sie unter [Arbeiten mit anderen Diensten](https://docs.aws.amazon.com/lambda/latest/dg/lambda-services.html) im *AWS Lambda Entwicklerhandbuch*.

`--force-image-build`  <a name="ref-sam-cli-local-invoke-options-force-image-build"></a>
Gibt an, ob das Image, das zum Aufrufen von Lambda-Funktionen mit Ebenen verwendet wird, neu erstellt werden AWS SAMCLI soll.

`--help`  <a name="ref-sam-cli-local-invoke-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--hook-name TEXT`  <a name="ref-sam-cli-local-invoke-options-hook-name"></a>
Der Name des Hooks, der zur Erweiterung der AWS SAMCLI Funktionalität verwendet wird.  
Zulässige Werte:`terraform`.

`--invoke-image TEXT`  <a name="ref-sam-cli-local-invoke-options-invoke-image"></a>
Die URI des Container-Images, das Sie für den lokalen Funktionsaufruf verwenden möchten. Ruft standardmäßig das Container-Image aus Amazon ECR Public ab (die unter aufgeführt sind). AWS SAM [Bild-Repositorys für AWS SAM](serverless-image-repositories.md) Verwenden Sie diese Option, um das Bild von einem anderen Speicherort abzurufen.  
Beispiel, `sam local invoke MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-invoke-options-layer-cache-basedir"></a>
Gibt den Speicherort des Basisverzeichnisses an, in das die von Ihrer Vorlage verwendeten Ebenen heruntergeladen werden.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-invoke-options-log-file"></a>
Die Protokolldatei, an die Laufzeitprotokolle gesendet werden sollen.

`--mount-symlinks`  <a name="ref-sam-cli-local-invoke-options-mount-symlinks"></a>
Stellt sicher, dass die Symlinks, die in den zu erstellenden oder aufzurufenden Dateien vorhanden sind, AWS SAMCLI immer eingehängt werden. Dies gilt nur für symbolische Links im Verzeichnis der obersten Ebene (d. h. für symbolische Links, die sich direkt im Stammverzeichnis der Funktion befinden). Standardmäßig werden Symlinks nicht gemountet, außer denen, die für die Verwendung `node_modules` in `build-in-source` NodeJS benötigt werden.

`--no-event`  <a name="ref-sam-cli-local-invoke-options-no-event"></a>
Ruft die Funktion mit einem leeren Ereignis auf.

`--no-memory-limit`  <a name="ref-sam-cli-local-invoke-options-no-memory-limit"></a>
Beseitigt die Speicherbeschränkung im Container beim lokalen Aufrufen, auch wenn Speicher in der AWS SAM Vorlage konfiguriert ist.

`--parameter-overrides`  <a name="ref-sam-cli-local-invoke-options-parameter-overrides"></a>
Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare codiert sind. Verwenden Sie dasselbe Format wie (). AWS Command Line Interface AWS CLI Das AWS SAMCLI Format besteht aus expliziten Schlüsselwörtern und Werten, wobei jede Überschreibung durch ein Leerzeichen getrennt ist. Nachfolgend finden Sie zwei Beispiele:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--profile TEXT`  <a name="ref-sam-cli-local-invoke-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="ref-sam-cli-local-invoke-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--runtime TEXT`  <a name="ref-sam-cli-local-invoke-options-runtime"></a>
Verwendet die angegebene Laufzeit, um eine Lambda-Funktion lokal aufzurufen. Dies überschreibt die in der Datei definierte Laufzeit. `template.yml` Dies ermöglicht auch das Testen von Lambda-Funktionen mit unterschiedlichen Laufzeiten, ohne die ursprüngliche Funktionskonfiguration zu ändern.

`--save-params`  <a name="ref-sam-cli-local-invoke-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--shutdown`  <a name="ref-sam-cli-local-invoke-options-shutdown"></a>
Emuliert nach Abschluss des Aufrufs ein Shutdown-Ereignis, um zu testen, wie Erweiterungen das Shutdown-Verhalten behandeln.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-invoke-options-skip-prepare-infra"></a>
Überspringt die Vorbereitungsphase, wenn keine Änderungen an der Infrastruktur vorgenommen wurden. Zusammen mit der `--hook-name` Option verwenden.

`--skip-pull-image`  <a name="ref-sam-cli-local-invoke-options-skip-pull-image"></a>
Standardmäßig AWS SAMCLI überprüft das die neueste Remote-Laufzeitumgebung von Lambda und aktualisiert Ihr lokales Image automatisch, damit es synchron bleibt.  
Geben Sie diese Option an, um das Herunterladen des neuesten Docker Images für Ihre Lambda-Laufzeitumgebung zu überspringen.

`--template, -t PATH`  <a name="ref-sam-cli-local-invoke-options-template"></a>
Die AWS SAM Vorlagendatei.  
Diese Option ist nicht kompatibel mit`--hook-name`.  
Wenn Sie diese Option angeben, werden nur die Vorlage und die lokalen Ressourcen AWS SAM geladen, auf die sie verweist.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
Die Mandanten-ID für Lambda-Funktionen mit mehreren Mandanten. Wird verwendet, um die Rechenisolierung zwischen verschiedenen Mandanten sicherzustellen. Erforderlich beim Aufrufen von Funktionen, die mit dem Mandantenisolationsmodus konfiguriert sind.

`--terraform-plan-file`  <a name="ref-sam-cli-local-invoke-options-terraform-plan-file"></a>
Der relative oder absolute Pfad zu Ihrer lokalen Terraform Plandatei, wenn Sie with verwenden. AWS SAMCLI Terraform Cloud Für diese Option muss der `--hook-name` Wert auf gesetzt sein`terraform`.

## Beispiele
<a name="sam-cli-command-reference-sam-local-invoke-examples"></a>

Im folgenden Beispiel wird ein generiertes Ereignis für lokale Tests verwendet, indem ein `s3.json` Ereignis verwendet wird, um eine Lambda-Funktion lokal aufzurufen.

```
$ sam local invoke --event events/s3.json S3JsonLoggerFunction
```

Das folgende Beispiel testet die Funktion ` HelloWorldFunction` mit der Python 3.11-Laufzeit

```
$ sam local invoke --runtime python3.11 HelloWorldFunction
```

Im folgenden Beispiel wird die Funktion ` HelloWorldFunction` mit einem dauerhaften Ausführungsnamen getestet

```
$ sam local invoke HelloWorldFunction --durable-execution-name my-execution
```

# sam local start-api
<a name="sam-cli-command-reference-sam-local-start-api"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Unterbefehl Command Line Interface (AWS SAMCLI)`sam local start-api`.
+ Eine Einführung in das finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam local start-api` Unterbefehls finden Sie unter[Einführung in das Testen mit sam local start-api](using-sam-cli-local-start-api.md).

Der `sam local start-api` Unterbefehl führt Ihre AWS Lambda Funktionen lokal aus, um sie über einen lokalen HTTP-Serverhost zu testen.

## Usage
<a name="ref-sam-cli-local-start-api-usage"></a>

```
$ sam local start-api <options>
```

## Optionen
<a name="ref-sam-cli-local-start-api-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-api-options-add-host"></a>
Übergibt eine Zuordnung von Hostname zu IP-Adresse an die Hostdatei des Docker-Containers. Dieser Parameter kann mehrfach übergeben werden.  

**Example**  
Beispiel: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-api-options-beta-features"></a>
Betafunktionen zulassen oder ablehnen.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-api-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-api-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-api-options-container-env-vars"></a>
Optional. Übergeben Sie beim lokalen Debuggen Umgebungsvariablen an den Image-Container.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host"></a>
Host eines lokal emulierten Lambda-Containers. Der Standardwert ist `localhost`. Wenn Sie AWS SAMCLI in einem Docker-Container auf macOS laufen möchten, können Sie angeben`host.docker.internal`. Wenn Sie den Container auf einem anderen Host ausführen möchten als AWS SAMCLI, können Sie die IP-Adresse des Remote-Hosts angeben.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-api-options-container-host-interface"></a>
Die IP-Adresse der Host-Netzwerkschnittstelle, an die Container-Ports gebunden werden sollen. Der Standardwert ist `127.0.0.1`. Wird verwendet`0.0.0.0`, um an alle Schnittstellen zu binden.

`--debug`  <a name="ref-sam-cli-local-start-api-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken AWS SAMCLI und Zeitstempel anzuzeigen.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-args"></a>
Zusätzliche Argumente, die an den Debugger übergeben werden müssen.

`--debug-function`  <a name="ref-sam-cli-local-start-api-options-debug-function"></a>
Optional. Gibt die Lambda-Funktion an, auf die Debug-Optionen angewendet werden sollen, wenn sie angegeben `--warm-containers` ist. Dieser Parameter gilt für `--debug-port``--debugger-path`, und. `--debug-args`

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-api-options-debug-port"></a>
Wenn angegeben, wird der Lambda-Funktionscontainer im Debug-Modus gestartet und dieser Port auf dem lokalen Host verfügbar gemacht.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-api-options-debugger-path"></a>
Der Hostpfad zu einem Debugger, der in den Lambda-Container gemountet wird.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-network"></a>
Der Name oder die ID eines vorhandenen Docker-Netzwerks, mit dem sich die Lambda-Docker-Container verbinden sollen, zusammen mit dem Standard-Bridge-Netzwerk. Wenn dies nicht angegeben ist, stellen die Lambda-Container nur eine Verbindung zum Standard-Bridge-Docker-Netzwerk her.

` --docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-api-options-docker-volume-basedir"></a>
Der Speicherort des Basisverzeichnisses, in dem die AWS SAM Datei existiert. Wenn Docker auf einem Remote-Computer ausgeführt wird, müssen Sie den Pfad, in dem sich die AWS SAM Datei befindet, auf dem Docker-Computer bereitstellen und diesen Wert so ändern, dass er mit dem Remote-Computer übereinstimmt.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-api-options-env-vars"></a>
Die `.env` JSON-Datei oder die Datei, die Werte für die Umgebungsvariablen der Lambda-Funktion enthält. Das Dateiformat wird automatisch erkannt.

`--force-image-build`  <a name="ref-sam-cli-local-start-api-options-force-image-build"></a>
Gibt an, ob das Bild, das zum Aufrufen von Funktionen mit Ebenen verwendet wurde, neu erstellt werden AWS SAM CLI soll.

`--help`  <a name="ref-sam-cli-local-start-api-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-api-options-hook-name"></a>
Der Name des Hooks, der zur Erweiterung der AWS SAMCLI Funktionalität verwendet wird.  
Zulässige Werte:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-api-options-host"></a>
Der lokale Hostname oder die IP-Adresse, an die gebunden werden soll (Standard: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-api-options-invoke-image"></a>
Die URI des Container-Images, das Sie für Ihre Lambda-Funktionen verwenden möchten. Ruft das Container-Image standardmäßig aus Amazon ECR AWS SAM Public ab. Verwenden Sie diese Option, um das Bild von einem anderen Speicherort abzurufen.  
Sie können diese Option mehrfach angeben. Jede Instanz dieser Option kann entweder eine Zeichenfolge oder ein Schlüssel-Wert-Paar annehmen. Wenn Sie eine Zeichenfolge angeben, ist dies die URI des Container-Images, das für alle Funktionen in Ihrer Anwendung verwendet werden soll. Beispiel, `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8`. Wenn Sie ein Schlüssel-Wert-Paar angeben, ist der Schlüssel der Ressourcenname und der Wert ist der URI des Container-Images, das für diese Ressource verwendet werden soll. Zum Beispiel `sam local start-api --invoke-image public.ecr.aws/sam/emu-python3.8 --invoke-image Function1=amazon/aws-sam-cli-emulation-image-python3.8 `. Mit Schlüssel-Wert-Paaren können Sie verschiedene Container-Images für verschiedene Ressourcen angeben.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-api-options-layer-cache-basedir"></a>
Gibt den Speicherort an, in den die von Ihrer Vorlage verwendeten Ebenen heruntergeladen werden.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-api-options-log-file"></a>
Die Protokolldatei, an die Laufzeitprotokolle gesendet werden sollen.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-api-options-no-memory-limit"></a>
Beseitigt die Speicherbeschränkung im Container beim lokalen Aufruf, auch wenn Speicher in der AWS SAM Vorlage konfiguriert ist.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-api-options-parameter-overrides"></a>
Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare codiert sind. Verwenden Sie dasselbe Format wie (). AWS Command Line Interface AWS CLI Das AWS SAMCLI Format besteht aus expliziten Schlüsselwörtern und Werten, wobei jede Überschreibung durch ein Leerzeichen getrennt ist. Nachfolgend finden Sie zwei Beispiele:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-api-options-port"></a>
Die lokale Portnummer, auf der gewartet werden soll (Standard: '3000').

`--profile TEXT`  <a name="ref-sam-cli-local-start-api-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="ref-sam-cli-local-start-api-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-api-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--shutdown`  <a name="ref-sam-cli-local-start-api-options-shutdown"></a>
Emuliert nach Abschluss des Aufrufs ein Shutdown-Ereignis, um zu testen, wie Erweiterungen das Shutdown-Verhalten behandeln.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-api-options-skip-prepare-infra"></a>
Überspringt die Vorbereitungsphase, wenn keine Änderungen an der Infrastruktur vorgenommen wurden. Zusammen mit der `--hook-name` Option verwenden.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-api-options-skip-pull-image"></a>
Gibt an, ob die CLI das Abrufen des neuesten Docker-Images für die Lambda-Laufzeit überspringen soll.

`--ssl-cert-file PATH`  <a name="ref-sam-cli-local-start-api-options-ssl-cert-file"></a>
Pfad zur SSL-Zertifikatsdatei (Standard: Keine). Wenn Sie diese Option verwenden, muss die `--ssl-key-file` Option auch verwendet werden.

`--ssl-key-file PATH`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Pfad zur SSL-Schlüsseldatei (Standard: Keine). Wenn Sie diese Option verwenden, muss die `--ssl-cert-file` Option auch verwendet werden.

`--static-dir, -s TEXT`  <a name="ref-sam-cli-local-start-api-options-static-dir"></a>
Alle statischen Asset-Dateien (z. B.CSS/JavaScript/HTML), die sich in diesem Verzeichnis befinden, werden unter angezeigt`/`.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-api-options-template"></a>
Die AWS SAM Vorlagendatei.  
Wenn Sie diese Option angeben, werden nur die Vorlage und die lokalen Ressourcen AWS SAM geladen, auf die sie verweist.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-api-options-terraform-plan-file"></a>
Der relative oder absolute Pfad zu Ihrer lokalen Terraform Plandatei, wenn Sie AWS SAMCLI with verwendenTerraform Cloud. Für diese Option muss der `--hook-name` Wert auf gesetzt sein`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-api-options-warm-containers"></a>
Optional. Gibt an, wie Container für jede Funktion AWS SAMCLI verwaltet werden.  
Zwei Optionen sind verfügbar:  
   `EAGER`: Container für alle Funktionen werden beim Start geladen und bleiben zwischen Aufrufen bestehen.  
   `LAZY`: Container werden nur geladen, wenn jede Funktion zum ersten Mal aufgerufen wird. Diese Container bleiben für weitere Aufrufe bestehen.

## Beispiel
<a name="sam-cli-command-reference-sam-local-start-api-examples"></a>

Im folgenden Beispiel wird ein lokaler Server gestartet, sodass Sie Ihre Anwendung über die API testen können. Damit dieser Befehl funktioniert, muss die Anwendung installiert sein und Docker muss ausgeführt werden.

```
$ sam local start-api --port 3000
```

# sam local start-lambda
<a name="sam-cli-command-reference-sam-local-start-lambda"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Unterbefehl Command Line Interface ()AWS SAMCLI. `sam local start-lambda`
+ Eine Einführung in das finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam local start-lambda` Unterbefehls finden Sie unter[Einführung in das Testen mit sam local start-lambda](using-sam-cli-local-start-lambda.md).

Der `sam local start-lambda` Unterbefehl startet einen lokalen Endpunkt, der emuliert werden soll. AWS Lambda

## Usage
<a name="ref-sam-cli-local-start-lambda-usage"></a>

```
$ sam local start-lambda <options>
```

## Optionen
<a name="ref-sam-cli-local-start-lambda-options"></a>

`--add-host LIST`  <a name="ref-sam-cli-local-start-lambda-options-add-host"></a>
Übergibt eine Zuordnung von Hostname zu IP-Adresse an die Hostdatei des Docker-Containers. Dieser Parameter kann mehrfach übergeben werden.  

**Example**  
Beispiel: `--add-host example.com:127.0.0.1`

`--beta-features | --no-beta-features`  <a name="ref-sam-cli-local-start-lambda-options-beta-features"></a>
Betafunktionen zulassen oder ablehnen.

`--config-env TEXT`  <a name="ref-sam-cli-local-start-lambda-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="ref-sam-cli-local-start-lambda-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--container-env-vars`  <a name="ref-sam-cli-local-start-lambda-options-container-env-vars"></a>
Optional. Übergeben Sie beim lokalen Debuggen Umgebungsvariablen an den Image-Container.

`--container-host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host"></a>
Host eines lokal emulierten Lambda-Containers. Der Standardwert ist `localhost`. Wenn Sie AWS SAMCLI in einem Docker-Container auf macOS laufen möchten, können Sie angeben`host.docker.internal`. Wenn Sie den Container auf einem anderen Host ausführen möchten als AWS SAMCLI, können Sie die IP-Adresse des Remote-Hosts angeben.

`--container-host-interface TEXT`  <a name="ref-sam-cli-local-start-lambda-options-container-host-interface"></a>
Die IP-Adresse der Host-Netzwerkschnittstelle, an die Container-Ports gebunden werden sollen. Der Standardwert ist `127.0.0.1`. Wird verwendet`0.0.0.0`, um an alle Schnittstellen zu binden.

`--debug`  <a name="ref-sam-cli-local-start-lambda-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken AWS SAMCLI und Zeitstempel anzuzeigen.

`--debug-args TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-args"></a>
Zusätzliche Argumente, die an den Debugger übergeben werden müssen.

`--debug-function`  <a name="ref-sam-cli-local-start-lambda-options-debug-function"></a>
Optional. Gibt die Lambda-Funktion an, auf die Debug-Optionen angewendet werden sollen, wenn sie angegeben `--warm-containers` ist. Dieser Parameter gilt für `--debug-port``--debugger-path`, und. `--debug-args`

`--debug-port, -d TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debug-port"></a>
Wenn angegeben, wird der Lambda-Funktionscontainer im Debug-Modus gestartet und dieser Port auf dem lokalen Host verfügbar gemacht.

`--debugger-path TEXT`  <a name="ref-sam-cli-local-start-lambda-options-debugger-path"></a>
Der Hostpfad zu einem Debugger, der in den Lambda-Container gemountet werden soll.

`--docker-network TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-network"></a>
Der Name oder die ID eines vorhandenen Docker-Netzwerks, mit dem Lambda-Docker-Container eine Verbindung herstellen sollen, zusammen mit dem Standard-Bridge-Netzwerk. Wenn dies angegeben ist, stellen die Lambda-Container nur eine Verbindung zum Standard-Bridge-Docker-Netzwerk her.

`--docker-volume-basedir, -v TEXT`  <a name="ref-sam-cli-local-start-lambda-options-docker-volume-basedir"></a>
Der Speicherort des Basisverzeichnisses, in dem die AWS SAM Datei existiert. Wenn Docker auf einem Remote-Computer ausgeführt wird, müssen Sie den Pfad, in dem sich die AWS SAM Datei befindet, auf dem Docker-Computer bereitstellen und diesen Wert so ändern, dass er mit dem Remote-Computer übereinstimmt.

`--env-vars, -n PATH`  <a name="ref-sam-cli-local-start-lambda-options-env-vars"></a>
Die `.env` JSON-Datei oder die Datei, die Werte für die Umgebungsvariablen der Lambda-Funktion enthält. Das Dateiformat wird automatisch erkannt.

`--force-image-build`  <a name="ref-sam-cli-local-start-lambda-options-force-image-build"></a>
Geben Sie an, ob das Bild, das zum Aufrufen von Funktionen mit Ebenen verwendet wurde, neu erstellt werden CLI soll.

`--help`  <a name="ref-sam-cli-local-start-lambda-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--hook-name TEXT`  <a name="ref-sam-cli-local-start-lambda-options-hook-name"></a>
Der Name des Hooks, der zur Erweiterung der AWS SAMCLI Funktionalität verwendet wird.  
Zulässige Werte:`terraform`.

`--host TEXT`  <a name="ref-sam-cli-local-start-lambda-options-host"></a>
Der lokale Hostname oder die IP-Adresse, an die gebunden werden soll (Standard: '127.0.0.1').

`--invoke-image TEXT`  <a name="ref-sam-cli-local-start-lambda-options-invoke-image"></a>
Die URI des Container-Images, das Sie für den lokalen Funktionsaufruf verwenden möchten. Ruft das Container-Image standardmäßig aus Amazon ECR AWS SAM Public ab. Verwenden Sie diese Option, um das Bild von einem anderen Speicherort abzurufen.  
Beispiel, `sam local start-lambda MyFunction --invoke-image amazon/aws-sam-cli-emulation-image-python3.8`.

`--layer-cache-basedir DIRECTORY`  <a name="ref-sam-cli-local-start-lambda-options-layer-cache-basedir"></a>
Gibt den Speicherort (basedir) an, in den die von Ihrer Vorlage verwendeten Ebenen heruntergeladen werden.

`--log-file, -l TEXT`  <a name="ref-sam-cli-local-start-lambda-options-log-file"></a>
Die Protokolldatei, an die Laufzeitprotokolle gesendet werden sollen.

`--no-memory-limit`  <a name="ref-sam-cli-local-start-lambda-options-no-memory-limit"></a>
Beseitigt die Speicherbeschränkung im Container beim lokalen Aufruf, auch wenn Speicher in der AWS SAM Vorlage konfiguriert ist.

`--parameter-overrides`  <a name="ref-sam-cli-local-start-lambda-options-parameter-overrides"></a>
Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare codiert sind. Verwenden Sie dasselbe Format wie (). AWS Command Line Interface AWS CLI Das AWS SAMCLI Format besteht aus expliziten Schlüsselwörtern und Werten, wobei jede Überschreibung durch ein Leerzeichen getrennt ist. Nachfolgend finden Sie zwei Beispiele:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--port, -p INTEGER`  <a name="ref-sam-cli-local-start-lambda-options-port"></a>
Die lokale Portnummer, auf der gewartet werden soll (Standard: '3001').

`--profile TEXT`  <a name="ref-sam-cli-local-start-lambda-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die Anmeldeinformationen abruft AWS .

`--region TEXT`  <a name="ref-sam-cli-local-start-lambda-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="ref-sam-cli-local-start-lambda-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--shutdown`  <a name="ref-sam-cli-local-start-lambda-options-shutdown"></a>
Emuliert nach Abschluss des Aufrufs ein Shutdown-Ereignis, um zu testen, wie Erweiterungen das Shutdown-Verhalten behandeln.

`--skip-prepare-infra`  <a name="ref-sam-cli-local-start-lambda-options-skip-prepare-infra"></a>
Überspringt die Vorbereitungsphase, wenn keine Änderungen an der Infrastruktur vorgenommen wurden. Zusammen mit der `--hook-name` Option verwenden.

`--skip-pull-image`  <a name="ref-sam-cli-local-start-lambda-options-skip-pull-image"></a>
Gibt an, ob das Abrufen des neuesten Docker-Images für die Lambda-Laufzeit übersprungen werden CLI soll.

`--template, -t PATH`  <a name="ref-sam-cli-local-start-lambda-options-template"></a>
Die AWS SAM Vorlagendatei.  
Wenn Sie diese Option angeben, werden nur die Vorlage und die lokalen Ressourcen AWS SAM geladen, auf die sie verweist. Diese Option ist nicht kompatibel mit`--hook-name`.

`--terraform-plan-file`  <a name="ref-sam-cli-local-start-lambda-options-terraform-plan-file"></a>
Der relative oder absolute Pfad zu Ihrer lokalen Terraform Plandatei, wenn Sie AWS SAMCLI with verwendenTerraform Cloud. Für diese Option muss der `--hook-name` Wert auf gesetzt sein`terraform`.

`--warm-containers [EAGER | LAZY]`  <a name="ref-sam-cli-local-start-lambda-options-warm-containers"></a>
Optional. Gibt an, wie Container für jede Funktion AWS SAMCLI verwaltet werden.  
Zwei Optionen sind verfügbar:  
+ `EAGER`: Container für alle Funktionen werden beim Start geladen und bleiben zwischen Aufrufen bestehen.
+ `LAZY`: Container werden nur geladen, wenn jede Funktion zum ersten Mal aufgerufen wird. Diese Container bleiben für weitere Aufrufe bestehen.

## Beispiel
<a name="sam-cli-command-reference-sam-local-start-lambda-examples"></a>

Ein ausführliches Beispiel und eine ausführliche Anleitung zur Verwendung des `sam local start-lambda` Unterbefehls finden Sie unter. [Einführung in das Testen mit sam local start-lambda](using-sam-cli-local-start-lambda.md)

# sam logs
<a name="sam-cli-command-reference-sam-logs"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam logs`.

Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam logs` Befehl ruft Protokolle ab, die von Ihren AWS Lambda Funktionen generiert wurden.

## Usage
<a name="sam-cli-command-reference-sam-logs-usage"></a>

```
$ sam logs <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-logs-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-logs-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-logs-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--cw-log-group LIST`  <a name="sam-cli-command-reference-sam-logs-options-cw-log-group"></a>
Schließt Protokolle aus den von Ihnen angegebenen CloudWatch Logs-Protokollgruppen ein. Wenn Sie diese Option zusammen mit angeben`name`, AWS SAM werden zusätzlich zu den Protokollen der genannten Ressourcen auch Protokolle aus den angegebenen Protokollgruppen eingeschlossen.

`--debug`  <a name="sam-cli-command-reference-sam-logs-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken AWS SAMCLI und Zeitstempel anzuzeigen.

`---end-time, e TEXT`  <a name="sam-cli-command-reference-sam-logs-options-end-time"></a>
Ruft Protokolle bis zu diesem Zeitpunkt ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Morgen“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln.

`--filter TEXT`  <a name="sam-cli-command-reference-sam-logs-options-filter"></a>
Ermöglicht die Angabe eines Ausdrucks, um schnell Logs zu finden, die Begriffen, Ausdrücken oder Werten in Ihren Protokollereignissen entsprechen. Dies kann ein einfaches Schlüsselwort (z. B. „Fehler“) oder ein Muster sein, das von Amazon CloudWatch Logs unterstützt wird. Die Syntax finden Sie in der [Amazon CloudWatch Logs-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html).

`--help`  <a name="sam-cli-command-reference-sam-logs-options-help"></a>
Zeigt diese Meldung an und wird beendet.

`--include-traces`  <a name="sam-cli-command-reference-sam-logs-options-include-traces"></a>
Schließt Röntgenspuren in die Protokollausgabe ein.

`--name, -n TEXT`  <a name="sam-cli-command-reference-sam-logs-options-name"></a>
Der Name der Ressource, für die Protokolle abgerufen werden sollen. Wenn diese Ressource Teil eines CloudFormation Stacks ist, kann dies die logische ID der Funktionsressource in der AWS SAM Vorlage CloudFormation/sein. Durch erneutes Wiederholen des Parameters können mehrere Namen angegeben werden. Wenn sich die Ressource in einem verschachtelten Stapel befindet, kann dem Namen der Name des geschachtelten Stacks vorangestellt werden, um Protokolle von dieser Ressource abzurufen (/). NestedStackLogicalId ResourceLogicalId Wenn der Ressourcenname nicht angegeben ist, wird der angegebene Stapel gescannt und es werden Protokollinformationen für alle unterstützten Ressourcen abgerufen. Wenn Sie diese Option nicht angeben, werden Protokolle für alle Ressourcen im AWS SAM Stapel abgerufen, die Sie angeben. Die folgenden Ressourcentypen werden unterstützt:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`

`--output TEXT`  <a name="sam-cli-command-reference-sam-logs-options-output"></a>
Gibt das Ausgabeformat für Protokolle an. Um formatierte Protokolle zu drucken, geben Sie an`text`. Um die Protokolle als JSON zu drucken, geben Sie an`json`.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-logs-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="sam-cli-command-reference-sam-logs-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-logs-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-logs-options-stack-name"></a>
Der Name des CloudFormation Stacks, zu dem die Ressource gehört.

`--start-time, -s TEXT`  <a name="sam-cli-command-reference-sam-logs-options-start-time"></a>
Ruft Logs ab diesem Zeitpunkt ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Gestern“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln. Der Standardwert ist 'vor 10 Minuten'.

` --tail, -t`  <a name="sam-cli-command-reference-sam-logs-options-tail"></a>
Verfolgt die Protokollausgabe. Dadurch wird das Endzeitargument ignoriert und es werden weiterhin Protokolle abgerufen, sobald sie verfügbar sind.

## Beispiele
<a name="sam-cli-command-reference-sam-logs-examples"></a>

Wenn Ihre Funktionen Teil eines CloudFormation Stacks sind, können Sie Protokolle abrufen, indem Sie bei der Angabe des Stack-Namens die logische ID der Funktion verwenden.

```
$ sam logs -n HelloWorldFunction --stack-name myStack
```

Mithilfe der Optionen -s (--start-time) und -e (--end-time) können Sie Logs für einen bestimmten Zeitraum anzeigen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack -s '10min ago' -e '2min ago'
```

Sie können auch die `--tail` Option hinzufügen, auf neue Protokolle zu warten und sie zu sehen, sobald sie eintreffen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --tail
```

Verwenden Sie `--filter` diese Option, um schnell nach Protokollen zu suchen, die Begriffen, Ausdrücken oder Werten in Ihren Protokollereignissen entsprechen.

```
$ sam logs -n HelloWorldFunction --stack-name myStack --filter "error"
```

Die Protokolle für eine Ressource in einem untergeordneten Stapel anzeigen.

```
$ sam logs --stack-name myStack -n childStack/HelloWorldFunction
```

Protokolldateien für alle unterstützten Ressourcen in Ihrer Anwendung.

```
$ sam logs --stack-name sam-app --tail
```

Rufen Sie Protokolle für eine bestimmte Lambda-Funktion und API Gateway Gateway-API in Ihrer Anwendung ab.

```
$ sam logs --stack-name sam-app --name HelloWorldFunction --name HelloWorldRestApi
```

Rufen Sie Protokolle für alle unterstützten Ressourcen in Ihrer Anwendung und zusätzlich aus den angegebenen Protokollgruppen ab.

```
$ sam logs --cw-log-group /aws/lambda/myfunction-123 --cw-log-group /aws/lambda/myfunction-456
```

# sam package
<a name="sam-cli-command-reference-sam-package"></a>

Das AWS Serverless Application Model Command Line Interface (AWS SAM CLI) packt eine AWS SAM Anwendung.

Dieser Befehl erstellt eine `.zip` Datei mit Ihrem Code und Ihren Abhängigkeiten und lädt die Datei auf Amazon Simple Storage Service (Amazon S3) hoch. AWS SAM aktiviert die Verschlüsselung für alle in Amazon S3 gespeicherten Dateien. Anschließend wird eine Kopie Ihrer AWS SAM Vorlage zurückgegeben und Verweise auf lokale Artefakte durch den Amazon S3 S3-Speicherort ersetzt, an den der Befehl die Artefakte hochgeladen hat.

Wenn Sie diesen Befehl verwenden, wird standardmäßig AWS SAMCLI davon ausgegangen, dass Ihr aktuelles Arbeitsverzeichnis das Stammverzeichnis Ihres Projekts ist. Der AWS SAMCLI erste versucht, eine mit dem [sam build](sam-cli-command-reference-sam-build.md) Befehl erstellte Vorlagendatei zu finden, die sich im `.aws-sam` Unterordner befindet und benannt `template.yaml` ist. Als Nächstes AWS SAMCLI versucht der, eine Vorlagendatei mit dem Namen `template.yaml` oder `template.yml` im aktuellen Arbeitsverzeichnis zu finden. Wenn Sie die `--template` Option angeben, wird AWS SAMCLI das Standardverhalten außer Kraft gesetzt und es werden nur diese AWS SAM Vorlage und die lokalen Ressourcen, auf die sie verweist, gepackt.

**Anmerkung**  
[sam deploy](sam-cli-command-reference-sam-deploy.md)führt jetzt implizit die Funktionalität von aus. `sam package` Sie können den [sam deploy](sam-cli-command-reference-sam-deploy.md) Befehl direkt verwenden, um Ihre Anwendung zu verpacken und bereitzustellen.

## Usage
<a name="sam-cli-command-reference-sam-package-usage"></a>

```
$ sam package <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-sam-package-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-sam-package-args-resource-id"></a>
Die ID der Lambda-Funktion, die verpackt werden soll.  
Dieses Argument ist optional. Wenn Ihre Anwendung eine einzelne Lambda-Funktion enthält, packt die AWS SAM CLI sie. Wenn Ihre Anwendung mehrere Funktionen enthält, geben Sie die ID der Funktion an, um eine einzelne Funktion zu verpacken.  
*Gültige Werte*: Die logische ID oder der Ressourcen-ARN der Ressource.

## Optionen
<a name="sam-cli-command-reference-sam-package-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-package-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-package-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-package-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen. AWS SAMCLI

`--force-upload`  <a name="sam-cli-command-reference-sam-package-options-force-upload"></a>
Überschreiben Sie vorhandene Dateien im Amazon S3 S3-Bucket. Geben Sie dieses Flag an, um Artefakte hochzuladen, auch wenn sie mit vorhandenen Artefakten im Amazon S3 S3-Bucket übereinstimmen.

`--help`  <a name="sam-cli-command-reference-sam-package-options-help"></a>
Zeigt diese Nachricht an und wird beendet.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-package-options-image-repository"></a>
Die URI des Amazon Elastic Container Registry (Amazon ECR) -Repositorys, in das dieser Befehl das Image Ihrer Funktion hochlädt. Erforderlich für Funktionen, die mit dem `Image` Pakettyp deklariert wurden.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-package-options-kms-key-id"></a>
Die ID eines AWS Key Management Service (AWS KMS) -Schlüssels, der zum Verschlüsseln von Artefakten verwendet wird, die sich im Amazon S3 S3-Bucket befinden. Wenn diese Option nicht angegeben ist, werden von Amazon AWS SAM S3 verwaltete Verschlüsselungsschlüssel verwendet.

`--metadata`  <a name="sam-cli-command-reference-sam-package-options-metadata"></a>
(Optional) Eine Metadatenübersicht, die an alle Artefakte angehängt werden kann, auf die in Ihrer Vorlage verwiesen wird.

`--no-progressbar`  <a name="sam-cli-command-reference-sam-package-options-no-progressbar"></a>
Zeigen Sie keinen Fortschrittsbalken an, wenn Sie Artefakte auf Amazon S3 hochladen.

`--output-template-file PATH`  <a name="sam-cli-command-reference-sam-package-options-output-template-file"></a>
Der Pfad zu der Datei, in die der Befehl die verpackte Vorlage schreibt. Wenn Sie keinen Pfad angeben, schreibt der Befehl die Vorlage in die Standardausgabe.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-package-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die AWS Anmeldeinformationen abruft.

`--region TEXT`  <a name="sam-cli-command-reference-sam-package-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--resolve-s3`  <a name="sam-cli-command-reference-sam-package-options-resolve-s3"></a>
Erstellen Sie automatisch einen Amazon S3 S3-Bucket, der für die Verpackung verwendet werden soll. Wenn Sie `--s3-bucket` sowohl die als auch die `--resolve-s3` Optionen angeben, tritt ein Fehler auf.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-bucket"></a>
Der Name des Amazon S3 S3-Buckets, in den dieser Befehl Ihr Artefakt hochlädt. Wenn Ihr Artefakt größer als 51.200 Byte ist, ist entweder die Option `--s3-bucket` oder die Option erforderlich. `--resolve-s3` Wenn Sie sowohl die `--s3-bucket` `--resolve-s3` Optionen als auch angeben, tritt ein Fehler auf.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-package-options-s3-prefix"></a>
Dem Namen der Artefakte, die in den Amazon S3 S3-Bucket hochgeladen werden, wurde ein Präfix hinzugefügt. Der Präfixname ist ein Pfadname (Ordnername) für den Amazon S3 S3-Bucket. Dies gilt nur für Funktionen, die mit dem `Zip` Pakettyp deklariert wurden.

`--save-params`  <a name="sam-cli-command-reference-sam-package-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--signing-profiles LIST`  <a name="sam-cli-command-reference-sam-package-options-signing-profiles"></a>
(Optional) Die Liste der Signaturprofile, mit denen Sie Ihre Bereitstellungspakete signieren können. Dieser Parameter verwendet eine Liste von Schlüssel-Wert-Paaren, wobei der Schlüssel der Name der Funktion oder Ebene ist, die signiert werden soll, und der Wert das Signaturprofil ist, wobei der optionale Profilbesitzer durch getrennt ist. `:` Beispiel, `FunctionNameToSign=SigningProfileName1 LayerNameToSign=SigningProfileName2:SigningProfileOwner`.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-package-options-template-file"></a>
Der Pfad und der Dateiname, in dem sich Ihre AWS SAM Vorlage befindet.  
Wenn Sie diese Option angeben, werden nur die Vorlage und die lokalen Ressourcen, auf die sie verweist, AWS SAM verpackt.

`--use-json`  <a name="sam-cli-command-reference-sam-package-options-use-json"></a>
Geben Sie JSON für die CloudFormation Vorlage aus. YAML wird standardmäßig verwendet.

## Beispiel
<a name="sam-cli-command-reference-sam-package-examples"></a>

Im folgenden Beispiel werden Artefakte für eine Lambda-Funktion und CodeDeploy -Anwendungen erstellt und verpackt. Artefakte werden in einen Amazon S3 S3-Bucket hochgeladen. Die Ausgabe des Befehls ist eine neue Datei mit dem Namen `package.yml`.

```
$ sam package \
  --template-file template.yml \
  --output-template-file package.yml \
  --s3-bucket amzn-s3-demo-bucket
```

# sam pipeline bootstrap
<a name="sam-cli-command-reference-sam-pipeline-bootstrap"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam local pipeline bootstrap` Unterbefehl Command Line Interface (AWS SAMCLI).

Eine Einführung in das finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam pipeline bootstrap` Unterbefehl generiert die erforderlichen AWS Infrastrukturressourcen, um eine Verbindung zu Ihrem CI/CD-System herzustellen. Dieser Schritt muss für jede Bereitstellungsphase in Ihrer Pipeline ausgeführt werden, bevor der Befehl ausgeführt wird. **sam pipeline init**

Dieser Unterbefehl richtet die folgenden AWS Infrastrukturressourcen ein:
+ Option zur Konfiguration von Pipeline-Berechtigungen über:
  + Ein Pipeline-IAM-Benutzer mit einer Zugriffsschlüssel-ID und geheimen Schlüsselzugriffsanmeldeinformationen, die mit dem CI/CD System geteilt werden sollen.
**Anmerkung**  
Wir empfehlen, die Zugangsschlüssel regelmäßig zu wechseln. Weitere Informationen finden Sie im *IAM-Benutzerhandbuch* unter [Regelmäßiges Rotieren von Zugriffsschlüsseln für Anwendungsfälle, die langfristige Anmeldeinformationen erfordern](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#rotate-credentials).
  + Unterstützte CI/CD Plattformen über OIDC. Eine Einführung in die Verwendung von OIDC mit AWS SAM Pipeline finden Sie unter. [So verwenden Sie die OIDC-Authentifizierung mit Pipelines AWS SAM](deploying-with-oidc.md)
+ Eine CloudFormation Ausführungs-IAM-Rolle, die CloudFormation zur Bereitstellung der Anwendung übernommen wurde. AWS SAM 
+ Ein Amazon S3 S3-Bucket zur Aufbewahrung der AWS SAM Artefakte.
+ Optional ein Amazon ECR-Image-Repository für Lambda-Bereitstellungspakete für Container-Images (falls Sie über eine Ressource vom Typ `Image` Paket verfügen).

## Usage
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-usage"></a>

```
$ sam pipeline bootstrap <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-options"></a>

`--bitbucket-repo-uuid TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bitbucket-repo-uuid"></a>
 Die UUID des Bitbucket-Repositorys. Diese Option ist spezifisch für die Verwendung von Bitbucket OIDC für Berechtigungen.  
Dieser Wert ist unter https://bitbucket.org/*workspace*//-connect zu finden *repository* admin/addon/admin/pipelines/openid 

`--bucket TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-bucket"></a>
Der ARN des Amazon S3 S3-Buckets, der die AWS SAM Artefakte enthält.

`--cicd-provider TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cicd-provider"></a>
Die CI/CD Plattform für die AWS SAM Pipeline.

`--cloudformation-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-cloudformation-execution-role"></a>
Der ARN der IAM-Rolle, der CloudFormation bei der Bereitstellung des Anwendungsstapels übernommen werden soll. Geben Sie dies nur an, wenn Sie Ihre eigene Rolle verwenden möchten. Andernfalls erstellt der Befehl eine neue Rolle.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist **default**. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich `samconfig.toml` im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--confirm-changeset | --no-confirm-changeset`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-confirm-changeset"></a>
Fordern Sie auf, die Bereitstellung Ihrer Ressourcen zu bestätigen.

`--create-image-repository | --no-create-image-repository`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-create-image-repository"></a>
Geben Sie an, ob ein Amazon ECR-Image-Repository erstellt werden soll, falls keines bereitgestellt wird. Das Amazon ECR-Repository enthält die Container-Images von Lambda-Funktionen oder Ebenen mit dem Pakettyp. `Image` Der Standardwert ist `--no-create-image-repository`.

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-debug"></a>
Aktiviert die Debug-Protokollierung und druckt die von ihm AWS SAMCLI generierten Debug-Nachrichten sowie die Anzeige von Zeitstempeln.

`--deployment-branch TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-deployment-branch"></a>
Name der Filiale, von der aus Bereitstellungen erfolgen. Diese Option ist spezifisch für die Verwendung von GitHub Actions OIDC für Berechtigungen.

`--github-org TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-org"></a>
Die GitHub Organisation, zu der das Repository gehört. Wenn keine Organisation existiert, geben Sie den Benutzernamen des Repository-Besitzers ein. Diese Option ist spezifisch für die Verwendung von GitHub Actions OIDC für Berechtigungen.

`--github-repo TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-github-repo"></a>
Name des GitHub Repositorys, von dem aus Bereitstellungen erfolgen. Diese Option ist spezifisch für die Verwendung von GitHub Actions OIDC für Berechtigungen.

`--gitlab-group TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-group"></a>
Die GitLab Gruppe, zu der das Repository gehört. Diese Option ist spezifisch für die Verwendung von GitLab OIDC für Berechtigungen.

`--gitlab-project TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-gitlab-project"></a>
Der GitLab Projektname. Diese Option ist spezifisch für die Verwendung von GitLab OIDC für Berechtigungen.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-help"></a>
Zeigt diese Nachricht an und wird beendet.

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-image-repository"></a>
Der ARN eines Amazon ECR-Image-Repositorys, das die Container-Images von Lambda-Funktionen oder Ebenen mit dem Pakettyp enthält. `Image` Falls angegeben, werden die `--create-image-repository` Optionen ignoriert. Falls nicht angegeben und `--create-image-repository` angegeben, erstellt der Befehl eine.

`--interactive | --no-interactive`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-interactive"></a>
Deaktivieren Sie die interaktive Aufforderung für Bootstrap-Parameter und schlagen Sie fehl, wenn erforderliche Parameter fehlen. Der Standardwert ist `--interactive`. Für diesen Befehl `--stage` ist der einzige erforderliche Parameter.  
Wenn zusammen mit angegeben `--no-interactive` wird`--use-oidc-provider`, müssen alle erforderlichen Parameter für Ihren OIDC-Anbieter enthalten sein.

`--oidc-client-id TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-client-id"></a>
Die Client-ID, die für die Verwendung mit Ihrem OIDC-Anbieter konfiguriert ist.

`--oidc-provider [github-actions | gitlab | bitbucket-pipelines]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider"></a>
Name des CI/CD Anbieters, der für OIDC-Berechtigungen verwendet wird. GitLab GitHub, und Bitbucket werden unterstützt.

`--oidc-provider-url TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-oidc-provider-url"></a>
Die URL für den OIDC-Anbieter. Der Wert muss mit beginnen. **https://**

`--permissions-provider [oidc | iam]`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-permissions-provider"></a>
Wählen Sie einen Berechtigungsanbieter aus, der die Rolle der Pipeline-Ausführung übernehmen soll. Der Standardwert ist **iam**.

`--pipeline-execution-role TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-execution-role"></a>
Der ARN der IAM-Rolle, den der Pipeline-Benutzer annehmen muss, um in dieser Phase zu arbeiten. Geben Sie dies nur an, wenn Sie Ihre eigene Rolle verwenden möchten. Wenn nicht angegeben, erstellt dieser Befehl eine neue Rolle.

`--pipeline-user TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-pipeline-user"></a>
Der Amazon-Ressourcenname (ARN) des IAM-Benutzers, dessen Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel mit dem CI/CD System geteilt werden. Er wird verwendet, um diesem IAM-Benutzer die Erlaubnis zu erteilen, auf das entsprechende AWS Konto zuzugreifen. Falls nicht angegeben, erstellt der Befehl einen IAM-Benutzer zusammen mit der Zugriffsschlüssel-ID und den Anmeldeinformationen für den geheimen Zugriffsschlüssel.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die Anmeldeinformationen abruft AWS .

`--region TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel, `us-east-1`.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--stage TEXT`  <a name="sam-cli-command-reference-sam-pipeline-bootstrap-options-stage"></a>
Der Name der entsprechenden Bereitstellungsphase. Er wird als Suffix für die erstellten AWS Infrastrukturressourcen verwendet.

## Fehlerbehebung
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting"></a>

### Fehler: Erforderlicher Parameter fehlt
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-troubleshooting-example1"></a>

Wenn zusammen mit angegeben `--no-interactive` wird `--use-oidc-provider` und keiner der erforderlichen Parameter angegeben wird, wird diese Fehlermeldung zusammen mit einer Beschreibung der fehlenden Parameter angezeigt.

## Beispiel
<a name="sam-cli-command-reference-sam-pipeline-bootstrap-examples"></a>

Das folgende Beispiel erstellt die AWS Ressourcen, die für die Erstellung Ihres CI/CD Systems erforderlich sind, aktiviert die Debug-Protokollierung und druckt Debug-Meldungen, die generiert wurden von AWS SAMCLI: verwendet ein generiertes Ereignis für lokale Tests, indem ein Ereignis verwendet wird, um eine `s3.json` Lambda-Funktion lokal aufzurufen

```
$ sam pipeline bootstrap --debug
```

# sam pipeline init
<a name="sam-cli-command-reference-sam-pipeline-init"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam pipeline init` Unterbefehl Command Line Interface (AWS SAMCLI).

Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam pipeline init` Unterbefehl generiert eine Pipeline-Konfigurationsdatei, mit der Ihr CI/CD System serverlose Anwendungen bereitstellen kann. AWS SAM

Vor der Verwendung **sam pipeline init** müssen Sie die erforderlichen Ressourcen für jede Phase in Ihrer Pipeline per Bootstrap bereitstellen. Sie können dies tun, indem Sie sich durch den Prozess **sam pipeline init --bootstrap** zur Erstellung der Setup- und Konfigurationsdatei führen lassen oder auf Ressourcen verweisen, die Sie zuvor mit dem **sam pipeline bootstrap** Befehl erstellt haben.

## Usage
<a name="sam-cli-command-reference-sam-pipeline-init-usage"></a>

```
$ sam pipeline init <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-pipeline-init-options"></a>

`--bootstrap`  <a name="sam-cli-command-reference-sam-pipeline-init-options-bootstrap"></a>
Aktivieren Sie den interaktiven Modus, der den Benutzer durch die Erstellung der erforderlichen AWS Infrastrukturressourcen führt.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist `default`. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file TEXT`  <a name="sam-cli-command-reference-sam-pipeline-init-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert befindet sich `samconfig.toml` im Stammverzeichnis des Projekts. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-pipeline-init-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von ihm AWS SAMCLI generierten Debug-Meldungen zu drucken und Zeitstempel anzuzeigen.

`--help, -h`  <a name="sam-cli-command-reference-sam-pipeline-init-options-help"></a>
Zeigt diese Meldung an und beendet das Programm.

`--save-params`  <a name="sam-cli-command-reference-sam-pipeline-init-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

## Beispiel
<a name="sam-cli-command-reference-sam-pipeline-init-examples"></a>

Das folgende Beispiel zeigt Ihnen, wie Sie die `--bootstrap` Option verwenden können, um einen interaktiven Modus zu durchlaufen, der Sie durch die Erstellung der erforderlichen AWS Infrastrukturressourcen führt:

```
$ sam pipeline init --bootstrap
```

# sam publish
<a name="sam-cli-command-reference-sam-publish"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam publish`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam publish` Befehl veröffentlicht eine AWS SAM Anwendung auf dem AWS Serverless Application Repository. Dieser Befehl verwendet eine verpackte AWS SAM Vorlage und veröffentlicht die Anwendung in der angegebenen AWS Region.

Der `sam publish` Befehl erwartet, dass die AWS SAM Vorlage einen `Metadata` Abschnitt enthält, der Anwendungsmetadaten enthält, die für die Veröffentlichung erforderlich sind. In `Metadata` diesem Abschnitt müssen sich die `ReadmeUrl` Eigenschaften `LicenseUrl` und auf Amazon Simple Storage Service (Amazon S3) -Buckets beziehen, nicht auf lokale Dateien. Weitere Informationen zum `Metadata` Abschnitt der AWS SAM Vorlage finden Sie unter[Veröffentlichen Sie Ihre Bewerbung mit dem AWS SAMCLI](serverless-sam-template-publishing-applications.md).

`sam publish`Erstellt die Anwendung standardmäßig als privat. Bevor andere AWS Konten Ihre Anwendung anzeigen und bereitstellen können, müssen Sie sie teilen. Informationen zur gemeinsamen Nutzung von Anwendungen finden Sie unter [Beispiele für AWS Serverless Application Repository ressourcenbasierte Richtlinien](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/security_iam_resource-based-policy-examples.html) im *AWS Serverless Application Repository Entwicklerhandbuch*.

**Anmerkung**  
Unterstützt derzeit `sam publish` nicht das Veröffentlichen von verschachtelten Anwendungen, die lokal angegeben sind. Wenn Ihre Anwendung verschachtelte Anwendungen enthält, müssen Sie diese separat von der veröffentlichen, AWS Serverless Application Repository bevor Sie Ihre übergeordnete Anwendung veröffentlichen.

## Usage
<a name="sam-cli-command-reference-sam-publish-usage"></a>

```
$ sam publish <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-publish-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-publish-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-publish-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-publish-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von ihm AWS SAMCLI generierten Debug-Meldungen zu drucken und Zeitstempel anzuzeigen.

`--help`  <a name="sam-cli-command-reference-sam-publish-options-help"></a>
Zeigt diese Meldung an und beendet das Programm.

`--profile TEXT`  <a name="sam-cli-command-reference-sam-publish-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die Anmeldeinformationen abruft AWS .

`--region TEXT`  <a name="sam-cli-command-reference-sam-publish-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-publish-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--semantic-version TEXT`  <a name="sam-cli-command-reference-sam-publish-options-semantic-version"></a>
(Optional) Verwenden Sie diese Option, um eine semantische Version Ihrer Anwendung bereitzustellen, die die `SemanticVersion` Eigenschaft im `Metadata` Abschnitt der Vorlagendatei überschreibt. [Weitere Informationen zur semantischen Versionierung finden Sie in der Semantic Versioning-Spezifikation.](https://semver.org/)

`--template, -t PATH`  <a name="sam-cli-command-reference-sam-publish-options-template"></a>
Der Pfad der Vorlagendatei. AWS SAM `[default: template.[yaml|yml]]`

## Beispiele
<a name="sam-cli-command-reference-sam-publish-examples"></a>

Um eine Anwendung zu veröffentlichen:

```
$ sam publish --template packaged.yaml --region us-east-1
```

# sam remote callback
<a name="sam-cli-command-reference-sam-remote-callback"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam remote callback`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Mit dem `sam remote callback` Befehl können Sie Rückrufe an Remoteausführungen von dauerhaften Funktionen senden, die in AWS Lambda ausgeführt werden.

**Anmerkung**  
Diese Befehle erfordern Zugriff auf Anmeldeinformationen. AWS 

## Usage
<a name="sam-cli-command-reference-sam-remote-callback-usage"></a>

```
$ sam remote callback <subcommand> <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-remote-callback-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-callback-options-help"></a>
Zeige diese Nachricht und beende das Programm.

## Unterbefehle
<a name="sam-cli-command-reference-sam-remote-callback-subcommands"></a>

`succeed`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-succeed"></a>
Sendet einen erfolgreichen Rückruf an die Ausführung einer dauerhaften Remote-Funktion. Weitere Informationen finden Sie unter [sam remote callback succeed](sam-cli-command-reference-sam-remote-callback-succeed.md).

`fail`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-fail"></a>
Sendet einen fehlgeschlagenen Rückruf an die Ausführung einer dauerhaften Remotefunktion. Weitere Informationen finden Sie unter [sam remote callback fail](sam-cli-command-reference-sam-remote-callback-fail.md).

`heartbeat`  <a name="sam-cli-command-reference-sam-remote-callback-subcommands-heartbeat"></a>
Sendet einen Callback-Heartbeat an eine dauerhafte Remotefunktion. Weitere Informationen finden Sie unter [sam remote callback heartbeat](sam-cli-command-reference-sam-remote-callback-heartbeat.md).

# sam remote callback succeed
<a name="sam-cli-command-reference-sam-remote-callback-succeed"></a>

Sendet einen erfolgreichen Rückruf an die Ausführung einer dauerhaften Remote-Funktion.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-callback-succeed-usage"></a>

```
$ sam remote callback succeed CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-callback-succeed-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Rückrufs, an den eine Erfolgsantwort gesendet werden soll.

## Optionen
<a name="ref-sam-cli-remote-callback-succeed-options"></a>

`-r, --result TEXT`  
Payload des Erfolgsergebnisses als Zeichenfolge.

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-callback-succeed-examples"></a>

Erfolgreicher Rückruf ohne Ergebnis senden:

```
$ sam remote callback succeed my-callback-id
```

Erfolgs-Rückruf mit Ergebnis senden:

```
$ sam remote callback succeed my-callback-id --result 'Task completed successfully'
```

# sam remote callback fail
<a name="sam-cli-command-reference-sam-remote-callback-fail"></a>

Sendet einen Callback-Fehler an die Ausführung einer dauerhaften Remotefunktion.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-callback-fail-usage"></a>

```
$ sam remote callback fail CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-callback-fail-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Callbacks, an den eine Fehlerantwort gesendet werden soll.

## Optionen
<a name="ref-sam-cli-remote-callback-fail-options"></a>

`--error-data TEXT`  
Zusätzliche Fehlerdaten.

`--stack-trace TEXT`  
Trace-Einträge stapeln. Diese Option kann mehrfach angegeben werden.

`--error-type TEXT`  
Fehlertyp.

`--error-message TEXT`  
Ausführliche Fehlermeldung.

`--region TEXT`  
Stellen Sie die AWS Region des Dienstes ein (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-callback-fail-examples"></a>

Fehlgeschlagener Rückruf ohne Parameter senden:

```
$ sam remote callback fail my-callback-id
```

Fehlerrückruf mit Fehlermeldung senden:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed'
```

Fehler-Callback mit allen Parametern senden:

```
$ sam remote callback fail my-callback-id --error-message 'Task failed' --error-type 'ValidationError' --stack-trace 'at line 42' --error-data '{"code": 500}'
```

# sam remote callback heartbeat
<a name="sam-cli-command-reference-sam-remote-callback-heartbeat"></a>

Sendet einen Callback-Heartbeat an eine dauerhafte Remotefunktion.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-callback-heartbeat-usage"></a>

```
$ sam remote callback heartbeat CALLBACK_ID [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-callback-heartbeat-arguments"></a>

`CALLBACK_ID`  
Die eindeutige Kennung des Rückrufs, an den ein Heartbeat gesendet werden soll.

## Optionen
<a name="ref-sam-cli-remote-callback-heartbeat-options"></a>

`--region TEXT`  
Stellen Sie die AWS Region des Dienstes ein (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-callback-heartbeat-examples"></a>

Heartbeat-Rückruf senden:

```
$ sam remote callback heartbeat my-callback-id
```

# sam remote execution
<a name="sam-cli-command-reference-sam-remote-execution"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam remote execution`.

Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Mit `sam remote execution` diesem Befehl können Sie die in AWS Lambda ausgeführten dauerhaften Remote-Funktionen verwalten und überprüfen.

**Anmerkung**  
Diese Befehle erfordern Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="sam-cli-command-reference-sam-remote-execution-usage"></a>

```
$ sam remote execution <subcommand> <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-remote-execution-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-sam-remote-execution-options-help"></a>
Diese Nachricht anzeigen und beenden.

## Unterbefehle
<a name="sam-cli-command-reference-sam-remote-execution-subcommands"></a>

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Erfahren Sie mehr über eine dauerhafte Ausführung. Weitere Informationen finden Sie unter [sam remote execution get](sam-cli-command-reference-sam-remote-execution-get.md).

`history`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-history"></a>
Ruft den Ausführungsverlauf einer dauerhaften Funktionsausführung ab. Weitere Informationen finden Sie unter [sam remote execution history](sam-cli-command-reference-sam-remote-execution-history.md).

`stop`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-stop"></a>
Stoppt die Ausführung einer dauerhaften Funktion. Weitere Informationen finden Sie unter [sam remote execution stop](sam-cli-command-reference-sam-remote-execution-stop.md).

# sam remote execution get
<a name="sam-cli-command-reference-sam-remote-execution-get"></a>

Rufen Sie die Details einer bestimmten dauerhaften Funktionsausführung von AWS Lambda ab.

Der Ausführungs-ARN sollte in dem Format vorliegen, das von Invoke zurückgegeben wurde oder in den Ausführungsprotokollen zu finden ist.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-execution-get-usage"></a>

```
$ sam remote execution get DURABLE_EXECUTION_ARN [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Der Amazon-Ressourcenname (ARN) der dauerhaften Funktionsausführung, für die Details abgerufen werden sollen.

## Optionen
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Ausgabeformat; Standard: `summary`

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Ruft die Ausführungsdetails im Standard-Zusammenfassungsformat ab:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55'
```

Holen Sie sich Ausführungsdetails im JSON-Format:

```
$ sam remote execution get 'arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/c63eec67-3415-4eb4-a495-116aa3a86278/1d454231-a3ad-3694-aa03-c917c175db55' --format json
```

**Anmerkung**  
Sie müssen sicherstellen, dass Steuerzeichen im Ausführungs-ARN wie `$` bei der Verwendung von Shell-Befehlen ordnungsgemäß maskiert werden.

# sam remote execution history
<a name="sam-cli-command-reference-sam-remote-execution-history"></a>

Rufen Sie den Ausführungshistorie einer bestimmten dauerhaften Funktionsausführung von AWS Lambda ab.

Der Ausführungs-ARN sollte das Format haben, das von den Ausführungsprotokollen zurückgegeben StartDurableExecution oder in diesen gefunden wurde.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-execution-history-usage"></a>

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Der Amazon-Ressourcenname (ARN) der dauerhaften Funktionsausführung, für die der Verlauf abgerufen werden soll.

## Optionen
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Ausgabeformat; Standard: `table`

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Ruft den Ausführungsverlauf im Standardtabellenformat ab:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Den Ausführungsverlauf im JSON-Format abrufen:

```
$ sam remote execution history arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --format json
```

# sam remote execution stop
<a name="sam-cli-command-reference-sam-remote-execution-stop"></a>

Stoppen Sie die Ausführung einer laufenden dauerhaften Funktion in AWS Lambda.

Der Ausführungs-ARN sollte das Format haben, das von den Ausführungsprotokollen zurückgegeben StartDurableExecution oder in diesen gefunden wurde.

**Anmerkung**  
Dieser Befehl erfordert Zugriff auf AWS Anmeldeinformationen.

## Usage
<a name="ref-sam-cli-remote-execution-stop-usage"></a>

```
$ sam remote execution stop DURABLE_EXECUTION_ARN [OPTIONS]
```

## Erforderliche Argumente
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Der Amazon-Ressourcenname (ARN) der dauerhaften Funktionsausführung, die gestoppt werden soll.

## Optionen
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Fehlermeldung, die mit der gestoppten Ausführung verknüpft werden soll.

`--error-type TEXT`  
Fehlertyp, der der gestoppten Ausführung zugeordnet werden soll.

`--error-data TEXT`  
Fehlerdaten, die der gestoppten Ausführung zugeordnet werden sollen.

`--stack-trace TEXT`  
Trace-Einträge stapeln. Diese Option kann mehrfach angegeben werden.

`--region TEXT`  
Legen Sie die AWS Region des Dienstes fest (z. B.`us-east-1`).

`--profile TEXT`  
Wählen Sie ein bestimmtes Profil aus Ihrer Anmeldeinformationsdatei aus, um die AWS Anmeldeinformationen abzurufen.

`--config-env TEXT`  
Umgebungsname, der die Standardparameterwerte in der Konfigurationsdatei angibt. Standard: `default`

`--config-file TEXT`  
Konfigurationsdatei mit Standardparameterwerten. Standard: `samconfig.toml`

`--save-params`  
Speichern Sie die über die Befehlszeile bereitgestellten Parameter in der Konfigurationsdatei.

`--beta-features / --no-beta-features`  
Aktivieren/Deaktivieren von Beta-Funktionen.

`--debug`  
Aktivieren Sie die Debug-Protokollierung, um von der AWS SAM CLI generierte Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen.

`-h, --help`  
Zeigt diese Meldung an und beendet das Programm.

## Beispiele
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Ausführung ohne Fehlerdetails beenden:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id
```

Beenden Sie die Ausführung mit einer Fehlermeldung und geben Sie Folgendes ein:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Execution cancelled" --error-type "UserCancellation"
```

Beenden Sie die Ausführung mit vollständigen Fehlerdetails und Stack-Trace:

```
$ sam remote execution stop arn:aws:lambda:us-east-1:123456789012:function:MyFunction:$LATEST/durable-execution/my-execution-name/my-execution-id --error-message "Task failed" --error-type "TaskFailure" --error-data '{"reason":"timeout"}' --stack-trace "at function1()" --stack-trace "at function2()"
```

# sam remote invoke
<a name="sam-cli-command-reference-remote-invoke"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam remote invoke`.
+ Eine Einführung in den finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote invoke` Befehls finden Sie unter[Einführung in das Testen in der Cloud mit sam remote invoke](using-sam-cli-remote-invoke.md).

Der `sam remote invoke` Befehl ruft unterstützte Ressourcen in der AWS Cloud auf.

## Usage
<a name="sam-cli-command-reference-remote-invoke-usage"></a>

```
$ sam remote invoke <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-remote-invoke-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-remote-invoke-args-resource-id"></a>
Die ID der unterstützten Ressource, die aufgerufen werden soll.  
Dieses Argument akzeptiert die folgenden Werte:  
+ **Amazon Resource Name (ARN)** — Der ARN der Ressource.
**Tipp**  
Verwenden Sie`sam list stack-outputs --stack-name <stack-name>`, um den ARN Ihrer Ressourcen zu erhalten.
+ **Logische ID** — Die logische ID der Ressource. Sie müssen auch den AWS CloudFormation Stack-Namen mithilfe der `--stack-name` Option angeben.
+ **Physikalische ID** — Die physische ID der Ressource. Diese ID wird erstellt, wenn Sie eine Ressource mithilfe von bereitstellen CloudFormation.
**Tipp**  
Verwenden Sie`sam list resources --stack-name <stack-name>`, um die physische ID Ihrer Ressourcen abzurufen.  
**Wenn Sie einen ARN oder eine physische ID angeben:**  
Wenn Sie einen ARN oder eine physische ID angeben, geben Sie keinen Stacknamen an. Wenn der Stack-Name mithilfe der `--stack-name` Option bereitgestellt wird oder wenn der Stack-Name in Ihrer Konfigurationsdatei definiert ist, AWS SAM CLI wird Ihre Ressourcen-ID automatisch als logischen ID-Wert aus dem CloudFormation Stack verarbeitet.  
**Wenn Sie keine Ressourcen-ID angeben:**  
Wenn Sie keine Ressourcen-ID angeben, aber mit der `--stack-name` Option einen Stacknamen angeben, versucht die AWS SAM CLI, mithilfe der folgenden Logik automatisch eine Ressource in Ihrem CloudFormation Stack aufzurufen:  

1.  AWS SAM CLISie identifiziert die Ressourcentypen in der folgenden Reihenfolge und fährt mit dem nächsten Schritt fort, sobald der Ressourcentyp in Ihrem Stack gefunden wurde:

   1. Lambda

   1. Step Functions

   1. Amazon SQS

   1. Kinesis Data Streams

1. Wenn der Ressourcentyp eine einzelne Ressource in Ihrem Stack hat, AWS SAM CLI wird sie aufgerufen. Wenn mehrere Ressourcen des Ressourcentyps in Ihrem Stack vorhanden sind, AWS SAM CLI wird ein Fehler zurückgegeben.
Im Folgenden finden Sie Beispiele dafür, was AWS SAM CLI sie tun werden:  
+ **Stack, der zwei Lambda-Funktionen und eine Amazon SQS SQS-Warteschlange enthält** — Der sucht den AWS SAM CLI Lambda-Ressourcentyp und gibt Fehler zurück, da der Stack mehr als eine Lambda-Funktion enthält.
+ **Stack, der eine Lambda-Funktion und zwei Amazon Kinesis Data Streams Streams-Anwendungen enthält** — Der sucht AWS SAM CLI die Lambda-Funktion und ruft sie auf, da der Stack eine einzige Lambda-Ressource enthält.
+ **Stack, der eine einzelne Amazon SQS SQS-Warteschlange und zwei Kinesis Data Streams Streams-Anwendungen enthält** — Der sucht die AWS SAM CLI Amazon SQS SQS-Warteschlange und ruft sie auf, da der Stack eine einzige Amazon SQS SQS-Warteschlange enthält.

## Optionen
<a name="sam-cli-command-reference-remote-invoke-options"></a>

`--beta-features | --no-beta-features`  <a name="sam-cli-command-reference-remote-invoke-options-beta-features"></a>
Betafunktionen zulassen oder ablehnen.

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-config-env"></a>
Geben Sie die zu verwendende Umgebung aus Ihrer AWS SAMCLI Konfigurationsdatei an.  
*Standardwert*: `default`

`--config-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-config-file"></a>
Geben Sie den Pfad und den Dateinamen Ihrer Konfigurationsdatei an.  
Weitere Informationen zu Konfigurationsdateien finden Sie unter [Konfiguration der AWS SAMCLI](using-sam-cli-configure.md).  
*Standard*: `samconfig.toml` im Stammverzeichnis Ihres Projektverzeichnisses. 

`--debug`  <a name="sam-cli-command-reference-remote-invoke-options-debug"></a>
Aktivieren Sie die Debug-Protokollierung. Dadurch werden Debug-Nachrichten und Zeitstempel gedruckt, die von der generiert wurden. AWS SAMCLI

`--event, -e TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-event"></a>
Das Ereignis, das an die Zielressource gesendet werden soll.

`--event-file FILENAME`  <a name="sam-cli-command-reference-remote-invoke-options-event-file"></a>
Der Pfad zu einer Datei, die das Ereignis enthält, das an die Zielressource gesendet werden soll.

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Zeigt die Hilfemeldung an und beendet den Vorgang.

`--output [ text | json ]`  <a name="sam-cli-command-reference-remote-invoke-options-output"></a>
Geben Sie die Ergebnisse Ihres Aufrufs in einem bestimmten Ausgabeformat aus.  
`json`— Die Anforderungsmetadaten und die Ressourcenantwort werden in der JSON-Struktur zurückgegeben. Die Antwort enthält die vollständige SDK-Ausgabe.  
`text`— Die Metadaten der Anfrage werden in Textstruktur zurückgegeben. Die Ressourcenantwort wird im Ausgabeformat der aufgerufenen Ressource zurückgegeben.

`--parameter`  <a name="sam-cli-command-reference-remote-invoke-options-parameter"></a>
Zusätzliche [https://boto3.amazonaws.com/v1/documentation/api/latest/index.html](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)Parameter, die Sie an die aufgerufene Ressource übergeben können.    
**Amazon Kinesis Data Streams**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-kinesis"></a>
Die folgenden zusätzlichen Parameter können verwendet werden, um einen Datensatz in den Kinesis-Datenstrom aufzunehmen:  
+ `ExplicitHashKey='string'`
+ `PartitionKey='string'`
+ `SequenceNumberForOrdering='string'`
+ `StreamARN='string'`
Eine Beschreibung der einzelnen Parameter finden Sie unter [kinesis.client.PUT\$1RECORD](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/kinesis/client/put_record.html).  
**AWS Lambda**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-lambda"></a>
Die folgenden zusätzlichen Parameter können verwendet werden, um eine Lambda-Ressource aufzurufen und eine gepufferte Antwort zu erhalten:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | Event | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Die folgenden zusätzlichen Parameter können verwendet werden, um eine Lambda-Ressource mit Antwortstreaming aufzurufen:  
+ `ClientContext='base64-encoded string'`
+ `InvocationType='[ DryRun | RequestResponse ]'`
+ `LogType='[ None | Tail ]'`
+ `Qualifier='string'`
Eine Beschreibung der einzelnen Parameter finden Sie im Folgenden:  
+ [Lambda mit gepufferter Antwort — Lambda.Client.Invoke](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke.html)
+ [Lambda mit Antwortstreaming — Lambda.Client.Invoke\$1with\$1Response\$1Stream](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/invoke_with_response_stream.html)  
**Amazon-Simple-Queue-Service (Amazon SQS)**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sqs"></a>
Die folgenden zusätzlichen Parameter können verwendet werden, um eine Nachricht an eine Amazon SQS SQS-Warteschlange zu senden:  
+ `DelaySeconds=integer`
+ `MessageAttributes='json string'`
+ `MessageDeduplicationId='string'`
+ `MessageGroupId='string'`
+ `MessageSystemAttributes='json string'`
Eine Beschreibung der einzelnen Parameter finden Sie unter [sqs.client.send\$1Message](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sqs/client/send_message.html).  
**AWS Step Functions**  <a name="sam-cli-command-reference-remote-invoke-options-parameter-sf"></a>
Die folgenden zusätzlichen Parameter können verwendet werden, um die Ausführung einer Zustandsmaschine zu starten:  
+ `name='string'`
+ `traceHeader='string'`
Eine Beschreibung der einzelnen Parameter finden Sie unter [SFN.Client.Start\$1Execution](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/stepfunctions/client/start_execution.html).

`--profile TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei zum Abrufen der Anmeldeinformationen. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-region"></a>
Das AWS-Region der Ressource. Beispiel, `us-east-1`.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-invoke-options-stack-name"></a>
Der Name des CloudFormation Stacks, zu dem die Ressource gehört.

`--tenant-id TEXT`  <a name="ref-sam-cli-local-invoke-options-tenancyconfig"></a>
Die Mandanten-ID für Lambda-Funktionen mit mehreren Mandanten. Wird verwendet, um die Rechenisolierung zwischen verschiedenen Mandanten sicherzustellen. Erforderlich beim Aufrufen von Funktionen, die mit dem Mandantenisolationsmodus konfiguriert sind.

`--test-event-name NAME`  <a name="sam-cli-command-reference-remote-invoke-options-test-event-name"></a>
Der Name des gemeinsam nutzbaren Testereignisses, das an Ihre Lambda-Funktion übergeben werden soll.  
Diese Option unterstützt nur Lambda-Funktionen.

## Beispiel
<a name="sam-cli-command-reference-remote-invoke-examples"></a>

Das folgende Beispiel ruft unterstützte Ressourcen in der AWS Cloud auf und aktiviert die Debug-Protokollierung, die Debug-Nachrichten und Zeitstempel ausgibt, die generiert wurden von: AWS SAMCLI

```
$ sam remote invoke--debug
```

# sam remote test-event
<a name="sam-cli-command-reference-remote-test-event"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam remote test-event`.
+ Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote test-event` Befehls finden Sie unter[Einführung in Cloud-Tests mit sam remote test-event](using-sam-cli-remote-test-event.md).

Der `sam remote test-event` Befehl interagiert mit gemeinsam nutzbaren Testereignissen in der EventBridge Amazon-Schemaregistry.

## Usage
<a name="sam-cli-command-reference-remote-test-event-usage"></a>

```
$ sam remote test-event <options> <subcommand>
```

## Optionen
<a name="sam-cli-command-reference-remote-test-event-options"></a>

`--help, -h`  <a name="sam-cli-command-reference-remote-invoke-options-help"></a>
Zeigt die Hilfemeldung an und beendet das Programm.

## Unterbefehle
<a name="sam-cli-command-reference-remote-test-event-subcommands"></a>

`delete`  
Löscht ein gemeinsam nutzbares Testereignis aus der EventBridge Schemaregistrierung. Weitere Referenzinformationen finden Sie unter[sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md).

`get`  
Ruft ein gemeinsam nutzbares Testereignis aus der EventBridge Schemaregistrierung ab. Weitere Referenzinformationen finden Sie unter[sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md).

`list`  
Listet bestehende Testereignisse für eine AWS Lambda Funktion auf, die gemeinsam genutzt werden können. Weitere Referenzinformationen finden Sie unter[sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md).

`put`  
Speichern Sie ein Ereignis aus einer lokalen Datei in der EventBridge Schemaregistrierung. Weitere Referenzinformationen finden Sie unter[sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md).

# sam remote test-event delete
<a name="sam-cli-command-reference-remote-test-event-delete"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam remote test-event delete` Unterbefehl Command Line Interface (AWS SAMCLI).
+ Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote test-event` Befehls finden Sie unter[Einführung in Cloud-Tests mit sam remote test-event](using-sam-cli-remote-test-event.md).

Der `sam remote test-event delete` Unterbefehl löscht ein gemeinsam nutzbares Testereignis aus der EventBridge Amazon-Schemaregistry.

## Usage
<a name="sam-cli-command-reference-remote-test-event-delete-usage"></a>

```
$ sam remote test-event delete <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-remote-test-event-delete-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-remote-test-event-delete-args-resource-id"></a>
Die ID der AWS Lambda Funktion, die dem gemeinsam nutzbaren Testereignis zugeordnet ist.  
Wenn Sie eine logische ID angeben, müssen Sie mithilfe der `--stack-name` Option auch einen Wert für den AWS CloudFormation Stack angeben, der der Lambda-Funktion zugeordnet ist.  
*Gültige Werte*: Die logische ID oder Ressource der RessourceARN.

## Optionen
<a name="sam-cli-command-reference-remote-test-event-delete-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-delete-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-delete-options-help"></a>
Zeigt die Hilfemeldung an und beendet das Programm.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-name"></a>
Der Name des gemeinsam nutzbaren Testereignisses, das gelöscht werden soll.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-delete-options-stack-name"></a>
Der Name des CloudFormation Stacks, der der Lambda-Funktion zugeordnet ist.  
Diese Option ist erforderlich, wenn Sie die logische ID der Lambda-Funktion als Argument angeben.

# sam remote test-event get
<a name="sam-cli-command-reference-remote-test-event-get"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam remote test-event get` Unterbefehl Command Line Interface (AWS SAMCLI).
+ Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote test-event` Befehls finden Sie unter[Einführung in Cloud-Tests mit sam remote test-event](using-sam-cli-remote-test-event.md).

Der `sam remote test-event get` Unterbefehl ruft ein gemeinsam nutzbares Testereignis aus der EventBridge Amazon-Schemaregistry ab.

## Usage
<a name="sam-cli-command-reference-remote-test-event-get-usage"></a>

```
$ sam remote test-event get <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-remote-test-event-get-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-remote-test-event-get-args-resource-id"></a>
Die ID der AWS Lambda Funktion, die dem abzurufenden gemeinsam nutzbaren Testereignis zugeordnet ist.  
Wenn Sie eine logische ID angeben, müssen Sie mithilfe der `--stack-name` Option auch einen Wert für den AWS CloudFormation Stack angeben, der der Lambda-Funktion zugeordnet ist.  
*Gültige Werte*: Die logische ID oder Ressource der RessourceARN.

## Optionen
<a name="sam-cli-command-reference-remote-test-event-get-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-get-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-get-options-help"></a>
Zeigt die Hilfemeldung an und beendet das Programm.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-name"></a>
Der Name des gemeinsam nutzbaren Testereignisses, das abgerufen werden soll.

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-get-options-output-file"></a>
Der Dateipfad und der Name, unter dem das Ereignis auf Ihrem lokalen Computer gespeichert werden soll.  
Wenn Sie diese Option nicht angeben, AWS SAM CLI wird der Inhalt des gemeinsam nutzbaren Testereignisses auf Ihrer Konsole ausgegeben.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-get-options-stack-name"></a>
Der Name des CloudFormation Stacks, der der Lambda-Funktion zugeordnet ist.  
Diese Option ist erforderlich, wenn Sie die logische ID der Lambda-Funktion als Argument angeben.

# sam remote test-event list
<a name="sam-cli-command-reference-remote-test-event-list"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam remote test-event list` Unterbefehl Command Line Interface (AWS SAMCLI).
+ Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote test-event` Befehls finden Sie unter[Einführung in Cloud-Tests mit sam remote test-event](using-sam-cli-remote-test-event.md).

Der `sam remote test-event list` Unterbefehl listet die vorhandenen gemeinsam nutzbaren Testereignisse für eine bestimmte AWS Lambda Funktion aus der EventBridge Amazon-Schemaregistrierung auf.

## Usage
<a name="sam-cli-command-reference-remote-test-event-list-usage"></a>

```
$ sam remote test-event list <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-remote-test-event-list-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-remote-test-event-list-args-resource-id"></a>
Die ID der Lambda-Funktion, die den gemeinsam nutzbaren Testereignissen zugeordnet ist.  
Wenn Sie eine logische ID angeben, müssen Sie mithilfe der `--stack-name` Option auch einen Wert für den AWS CloudFormation Stack angeben, der der Lambda-Funktion zugeordnet ist.  
*Gültige Werte*: Die logische ID oder Ressource der RessourceARN.

## Optionen
<a name="sam-cli-command-reference-remote-test-event-list-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-list-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-list-options-help"></a>
Zeigt die Hilfemeldung an und beendet das Programm.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-list-options-stack-name"></a>
Der Name des CloudFormation Stacks, der der Lambda-Funktion zugeordnet ist.  
Diese Option ist erforderlich, wenn Sie die logische ID der Lambda-Funktion als Argument angeben.

## Beispiele
<a name="sam-cli-command-reference-remote-test-event-list-examples"></a>

Beispiele zur Verwendung dieses Befehls finden Sie unter[Testereignisse auflisten, die gemeinsam genutzt werden können](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-list).

# sam remote test-event put
<a name="sam-cli-command-reference-remote-test-event-put"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model `sam remote test-event put` Unterbefehl Command Line Interface (AWS SAMCLI).
+ Eine Einführung in den finden Sie AWS SAMCLI unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung des AWS SAMCLI `sam remote test-event` Befehls finden Sie unter[Einführung in Cloud-Tests mit sam remote test-event](using-sam-cli-remote-test-event.md).

Der `sam remote test-event put` Unterbefehl speichert ein gemeinsam nutzbares Testereignis von Ihrem lokalen Computer in der EventBridge Amazon-Schemaregistrierung.

## Usage
<a name="sam-cli-command-reference-remote-test-event-put-usage"></a>

```
$ sam remote test-event put <arguments> <options>
```

## Argumente
<a name="sam-cli-command-reference-remote-test-event-put-args"></a>

**Resource ID (Ressourcen-ID)**  <a name="sam-cli-command-reference-remote-test-event-put-args-resource-id"></a>
Die ID der AWS Lambda Funktion, die dem gemeinsam nutzbaren Testereignis zugeordnet ist.  
Wenn Sie eine logische ID angeben, müssen Sie mithilfe der `--stack-name` Option auch einen Wert für den AWS CloudFormation Stack angeben, der der Lambda-Funktion zugeordnet ist.  
*Gültige Werte*: Die logische ID oder Ressource der RessourceARN.

## Optionen
<a name="sam-cli-command-reference-remote-test-event-put-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-remote-test-event-put-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-file"></a>
Der Dateipfad und der Name des Ereignisses auf Ihrem lokalen Computer.  
Geben Sie `-` als Dateinamenwert an, aus dem gelesen werden soll`stdin`.  
Diese Option ist erforderlich.

`--force`, `-f`  <a name="sam-cli-command-reference-remote-test-event-put-options-force"></a>
Überschreibt ein gemeinsam nutzbares Testereignis mit demselben Namen.

`--help, -h`  <a name="sam-cli-command-reference-remote-test-event-put-options-help"></a>
Zeigt die Hilfemeldung an und beendet das Programm.

`--name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-name"></a>
Der Name, unter dem das gemeinsam nutzbare Testereignis gespeichert werden soll.  
Wenn ein gemeinsam nutzbares Testereignis mit demselben Namen in der EventBridge Schemaregistrierung vorhanden ist, AWS SAM CLI wird es nicht überschrieben. Um zu überschreiben, fügen Sie die Option hinzu. `--force`

`--output-file FILENAME`  <a name="sam-cli-command-reference-remote-test-event-put-options-output-file"></a>
Der Dateipfad und der Name, unter dem das Ereignis auf Ihrem lokalen Computer gespeichert werden soll.  
Wenn Sie diese Option nicht angeben, AWS SAM CLI wird der Inhalt des gemeinsam nutzbaren Testereignisses auf Ihrer Konsole ausgegeben.

`--stack-name TEXT`  <a name="sam-cli-command-reference-remote-test-event-put-options-stack-name"></a>
Der Name des CloudFormation Stacks, der der Lambda-Funktion zugeordnet ist.  
Diese Option ist erforderlich, wenn Sie die logische ID der Lambda-Funktion als Argument angeben.

## Beispiel
<a name="sam-cli-command-reference-remote-test-event-put-examples"></a>

Ein Beispiel zur Verwendung dieses Befehls finden Sie unter[Testereignisse speichern, die gemeinsam genutzt werden können](using-sam-cli-remote-test-event.md#using-sam-cli-remote-test-event-use-put).

# sam sync
<a name="sam-cli-command-reference-sam-sync"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam sync`.
+ Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)
+ Eine Dokumentation zur Verwendung von finden Sie unter[AWS SAM CLI](using-sam-cli.md). AWS SAMCLI

Der `sam sync` Befehl synchronisiert lokale Anwendungsänderungen mit dem AWS Cloud.

## Usage
<a name="sam-cli-command-reference-sam-sync-usage"></a>

```
$ sam sync <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-sync-options"></a>

`--base-dir, -s DIRECTORY`  <a name="sam-cli-command-reference-sam-sync-options-base-dir"></a>
Löst relative Pfade zum Quellcode der Funktion oder Ebene in Bezug auf dieses Verzeichnis auf. Verwenden Sie diese Option, um zu ändern, wie relative Pfade zu Quellcode-Ordnern aufgelöst werden. Standardmäßig werden relative Pfade in Bezug auf den Speicherort der AWS SAM Vorlage aufgelöst.  
Zusätzlich zu den Ressourcen in der Root-Anwendung oder dem Root-Stack, den Sie erstellen, gilt diese Option auch für verschachtelte Anwendungen oder Stacks. Darüber hinaus gilt diese Option für die folgenden Ressourcentypen und Eigenschaften:  
+ Ressourcentyp: `AWS::Serverless::Function` Eigenschaft: `CodeUri`
+ Ressourcentyp: `AWS::Serverless::Function` Ressourcenattribut: `Metadata` Eintrag: `DockerContext`
+ Ressourcentyp: `AWS::Serverless::LayerVersion` Immobilie: `ContentUri`
+ Ressourcentyp: `AWS::Lambda::Function` Immobilie: `Code`
+ Ressourcentyp: `AWS::Lambda::LayerVersion` Immobilie: `Content`

`--build-image TEXT`  <a name="sam-cli-command-reference-sam-sync-options-build-image"></a>
Der URI für das [Container-Image](serverless-image-repositories.md#serverless-image-repository-uris), das Sie beim Erstellen Ihrer Anwendung verwenden möchten. AWS SAM Verwendet standardmäßig den Container-Image-Repository-URI von [Amazon Elastic Container Registry (Amazon ECR) Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html). Geben Sie diese Option an, um ein anderes Bild zu verwenden.  
Sie können diese Option in einem einzigen Befehl mehrfach verwenden. Jede Option akzeptiert eine Zeichenfolge oder ein Schlüssel-Wert-Paar.  
+ **Zeichenfolge** — Geben Sie den URI des Container-Images an, das alle Ressourcen in Ihrer Anwendung verwenden werden. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ sam sync --build-image amazon/aws-sam-cli-build-image-python3.8
  ```
+ **Schlüssel-Wert-Paar** — Geben Sie den Ressourcennamen als Schlüssel und den Container-Image-URI an, der mit dieser Ressource als Wert verwendet werden soll. Verwenden Sie dieses Format, um für jede Ressource in Ihrer Anwendung einen anderen Container-Image-URI anzugeben. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ sam sync --build-image Function1=amazon/aws-sam-cli-build-image-python3.8
  ```
Diese Option gilt nur, wenn die `--use-container` Option angegeben ist, andernfalls tritt ein Fehler auf.

`--build-in-source | --no-build-in-source`  <a name="sam-cli-command-reference-sam-sync-options-build-in-source"></a>
Ermöglicht `--build-in-source` es, Ihr Projekt direkt im Quellordner zu erstellen.  
Die `--build-in-source` Option unterstützt die folgenden Laufzeiten und Build-Methoden:  
+ **Laufzeiten** — Jede Node.js Laufzeit, die von der `sam init --runtime` Option unterstützt wird.
+ **Methoden erstellen** —`Makefile`,`esbuild`.
Die `--build-in-source` Option ist mit den folgenden Optionen nicht kompatibel:  
+ `--use-container `
*Standardwert*: `--no-build-in-source`

`--capabilities LIST`  <a name="sam-cli-command-reference-sam-sync-options-capabilities"></a>
Eine Liste von Funktionen, die Sie angeben, um die Erstellung bestimmter Stapel CloudFormation zu ermöglichen. Einige Stack-Vorlagen können Ressourcen enthalten, die sich auf Ihre AWS-Konto Berechtigungen auswirken können. Zum Beispiel durch das Erstellen neuer AWS Identity and Access Management (IAM-) Benutzer. Geben Sie diese Option an, um die Standardwerte zu überschreiben. Gültige Werte sind z. B. die Folgenden:  
+ CAPABILITY\$1IAM
+ CAPABILITY\$1NAMED\$1IAM
+ CAPABILITY\$1RESOURCE\$1POLICY
+ CAPABILITY\$1AUTO\$1EXPAND
*Standard: und* `CAPABILITY_NAMED_IAM` `CAPABILITY_AUTO_EXPAND`

`--code`  <a name="sam-cli-command-reference-sam-sync-options-code"></a>
 AWS SAM Synchronisiert standardmäßig alle Ressourcen in Ihrer Anwendung. Geben Sie diese Option an, um nur Coderessourcen zu synchronisieren, die Folgendes beinhalten:  
+ `AWS::Serverless::Function`
+ `AWS::Lambda::Function`
+ `AWS::Serverless::LayerVersion`
+ `AWS::Lambda::LayerVersion`
+ `AWS::Serverless::Api`
+ `AWS::ApiGateway::RestApi`
+ `AWS::Serverless::HttpApi`
+ `AWS::ApiGatewayV2::Api`
+ `AWS::Serverless::StateMachine`
+ `AWS::StepFunctions::StateMachine`
Zum Synchronisieren von Coderessourcen wird der AWS Dienst APIs direkt AWS SAM verwendet, anstatt sie über bereitzustellen AWS CloudFormation. Um Ihren CloudFormation Stack zu aktualisieren, führen Sie **sam sync --watch** oder aus**sam deploy**.

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-sync-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-sync-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--dependency-layer | --no-dependency-layer`  <a name="sam-cli-command-reference-sam-sync-options-dependency-layer"></a>
Gibt an, ob die Abhängigkeiten einzelner Funktionen in eine weitere Ebene aufgeteilt werden sollen, um den Synchronisierungsvorgang zu beschleunigen.  
*Standardwert*: `--dependency-layer`

`--image-repository TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repository"></a>
Der Name des Amazon Elastic Container Registry (Amazon ECR) -Repositorys, in das dieser Befehl das Image Ihrer Funktion hochlädt. Erforderlich für Funktionen, die mit dem `Image` Pakettyp deklariert wurden.

`--image-repositories TEXT`  <a name="sam-cli-command-reference-sam-sync-options-image-repositories"></a>
Eine Zuordnung von Funktionen zu ihrer Amazon ECR-Repository-URI. Referenzfunktionen anhand ihrer logischen ID. Im Folgenden wird ein Beispiel gezeigt:  

```
$ sam sync --image-repositories Function1=123456789012.dkr.ecr.us-east-1.amazonaws.com/my-repo
```
Sie können diese Option in einem einzigen Befehl mehrfach angeben.

`--kms-key-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-kms-key-id"></a>
Die ID eines AWS Key Management Service (AWS KMS) -Schlüssels, der zum Verschlüsseln von Artefakten verwendet wird, die sich im Amazon S3 S3-Bucket befinden. Wenn Sie diese Option nicht angeben, werden von Amazon S3 verwaltete Verschlüsselungsschlüssel AWS SAM verwendet.

`--metadata`  <a name="sam-cli-command-reference-sam-sync-options-metadata"></a>
Eine Metadatenübersicht, die an alle Artefakte angehängt werden kann, auf die Sie in Ihrer Vorlage verweisen.

`--notification-arns LIST`  <a name="sam-cli-command-reference-sam-sync-options-notification-arns"></a>
Eine Liste der Amazon Simple Notification Service (Amazon SNS) -Themen ARNs , die mit dem Stack CloudFormation verknüpft sind.

`--no-use-container`  <a name="ref-sam-cli-sync-options-no-use-container"></a>
Eine Option, mit der Sie das IDE-Toolkit verwenden können, um das Standardverhalten festzulegen.

`--parameter-overrides`  <a name="sam-cli-command-reference-sam-sync-options-parameter-overrides"></a>
Eine Zeichenfolge, die CloudFormation Parameterüberschreibungen enthält, die als Schlüssel-Wert-Paare kodiert sind. Verwenden Sie dasselbe Format wie (). AWS Command Line Interface AWS CLI Das AWS SAMCLI Format besteht aus expliziten Schlüsselwörtern und Werten, wobei jede Überschreibung durch ein Leerzeichen getrennt ist. Nachfolgend finden Sie zwei Beispiele:  
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world`
+ `--parameter-overrides ParameterKey=hello,ParameterValue=world ParameterKey=example1,ParameterValue=example2 ParameterKey=apple,ParameterValue=banana`

`--resource TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource"></a>
Gibt den zu synchronisierenden Ressourcentyp an. Um mehrere Ressourcen zu synchronisieren, können Sie diese Option mehrmals angeben. Diese Option wird zusammen mit der `--code` Option unterstützt. Bei dem Wert muss es sich um eine der unten aufgeführten Ressourcen handeln`--code`. Beispiel, `--resource AWS::Serverless::Function --resource AWS::Serverless::LayerVersion`.

`--resource-id TEXT`  <a name="sam-cli-command-reference-sam-sync-options-resource-id"></a>
Gibt die Ressourcen-ID an, die synchronisiert werden soll. Um mehrere Ressourcen zu synchronisieren, können Sie diese Option mehrmals angeben. Diese Option wird zusammen mit der `--code` Option unterstützt. Beispiel, `--resource-id Function1 --resource-id Function2`.

`--role-arn TEXT`  <a name="sam-cli-command-reference-sam-sync-options-role-arn"></a>
Der Amazon-Ressourcenname (ARN) einer IAM-Rolle, der beim Anwenden des Changesets übernommen CloudFormation wird.

`--s3-bucket TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-bucket"></a>
Der Name des Amazon Simple Storage Service (Amazon S3) -Buckets, in den dieser Befehl Ihre CloudFormation Vorlage hochlädt. Wenn Ihre Vorlage größer als 51.200 Byte ist, ist entweder die Option `--s3-bucket` oder die `--resolve-s3` Option erforderlich. Wenn Sie sowohl die `--s3-bucket` `--resolve-s3` Optionen als auch angeben, tritt ein Fehler auf.

`--s3-prefix TEXT`  <a name="sam-cli-command-reference-sam-sync-options-s3-prefix"></a>
Das Präfix, das den Namen der Artefakte hinzugefügt wurde, die Sie in den Amazon S3 S3-Bucket hochladen. Der Präfixname ist ein Pfadname (Ordnername) für den Amazon S3 S3-Bucket. Dies gilt nur für Funktionen, die mit dem `Zip` Pakettyp deklariert wurden.

`--save-params`  <a name="sam-cli-command-reference-sam-sync-options-save-params"></a>
Speichert die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--skip-deploy-sync | --no-skip-deploy-sync`  <a name="sam-cli-command-reference-sam-sync-options-skip-deploy-sync"></a>
Gibt `--skip-deploy-sync` an, dass die anfängliche Infrastruktursynchronisierung übersprungen werden soll, wenn sie nicht erforderlich ist. Der vergleicht AWS SAMCLI Ihre lokale AWS SAM Vorlage mit der bereitgestellten CloudFormation Vorlage und führt nur dann eine Bereitstellung durch, wenn eine Änderung erkannt wird.  
Gibt `--no-skip-deploy-sync` an, dass bei jeder Ausführung eine CloudFormation Bereitstellung durchgeführt werden `sam sync` soll.  
Weitere Informationen hierzu finden Sie unter [Überspringen Sie die erste CloudFormation Bereitstellung](using-sam-cli-sync.md#using-sam-cli-sync-options-skip-deploy-sync).  
*Standardwert*: `--skip-deploy-sync`

`--stack-name TEXT`  <a name="sam-cli-command-reference-sam-sync-options-stack-name"></a>
Der Name des CloudFormation Stacks für Ihre Anwendung.  
Diese Option ist erforderlich.

`--tags LIST`  <a name="sam-cli-command-reference-sam-sync-options-tags"></a>
Eine Liste von Tags, die dem Stack zugeordnet werden sollen, der erstellt oder aktualisiert wird. CloudFormation leitet diese Tags auch an Ressourcen im Stack weiter, die sie unterstützen.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-sync-options-template-file"></a>
Der Pfad und der Dateiname, in dem sich Ihre AWS SAM Vorlage befindet.  
Wenn Sie diese Option angeben, werden AWS SAM nur die Vorlage und die lokalen Ressourcen bereitgestellt, auf die sie verweist.

`--use-container, -u`  <a name="sam-cli-command-reference-sam-sync-options-use-container"></a>
Wenn Ihre Funktionen von Paketen abhängen, die nativ kompilierte Abhängigkeiten haben, verwenden Sie diese Option, um Ihre Funktion in einem AWS Lambdaähnlichen Docker Container zu erstellen.  
Derzeit ist diese Option nicht kompatibel mit`--dependency-layer`. Wenn Sie `--use-container` mit verwenden`--dependency-layer`, AWS SAMCLI informiert Sie das und fährt mit fort`--no-dependency-layer`.

`--watch`  <a name="sam-cli-command-reference-sam-sync-options-watch"></a>
Startet einen Prozess, der Ihre lokale Anwendung auf Änderungen überwacht und diese automatisch mit der AWS Cloud synchronisiert. Wenn Sie diese Option angeben, werden standardmäßig alle Ressourcen in Ihrer Anwendung AWS SAM synchronisiert, wenn Sie sie aktualisieren. AWS SAM Führt mit dieser Option eine erste CloudFormation Bereitstellung durch. AWS SAM Verwendet dann den AWS Dienst, APIs um die Coderessourcen zu aktualisieren. AWS SAM verwendet CloudFormation , um Infrastrukturressourcen zu aktualisieren, wenn Sie Ihre AWS SAM Vorlage aktualisieren.

`--watch-exclude TEXT`  <a name="sam-cli-command-reference-sam-sync-options-watch-exclude"></a>
Schließt eine Datei oder einen Ordner von der Überwachung auf Dateiänderungen aus. Um diese Option verwenden zu können, `--watch` muss sie ebenfalls angegeben werden.  
Diese Option erhält ein Schlüssel-Wert-Paar:  
+ **Schlüssel** — Die logische ID einer Lambda-Funktion in Ihrer Anwendung.
+ **Wert** — Der zugehörige Dateiname oder Ordner, der ausgeschlossen werden soll.
Wenn Sie Dateien oder Ordner aktualisieren, die mit dieser `--watch-exclude` Option angegeben wurden, AWS SAM CLI wird keine Synchronisierung initiiert. Wenn jedoch eine Aktualisierung anderer Dateien oder Ordner eine Synchronisierung einleitet, werden diese Dateien oder Ordner in diese Synchronisierung aufgenommen.  
Sie können diese Option in einem einzigen Befehl mehrfach angeben.

## Beispiele
<a name="sam-cli-command-reference-sam-sync-examples"></a>

Beispiele zur Verwendung dieses Befehls finden Sie unter[Optionen für den Befehl sam sync](using-sam-cli-sync.md#using-sam-cli-sync-options).

# sam traces
<a name="sam-cli-command-reference-sam-traces"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam traces`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam traces` Befehl ruft AWS X-Ray Spuren AWS-Konto in Ihrem ab. AWS-Region

## Usage
<a name="sam-cli-command-reference-sam-traces-usage"></a>

```
$ sam traces <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-traces-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-traces-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-traces-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist "`samconfig.toml`" im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--end-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-end-time"></a>
Ruft Traces bis zu diesem Zeitpunkt ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Morgen“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln.

`--output TEXT`  <a name="sam-cli-command-reference-sam-traces-options-output"></a>
Gibt das Ausgabeformat für Protokolle an. Um formatierte Protokolle zu drucken, geben Sie an`text`. Um die Protokolle als JSON zu drucken, geben Sie an`json`.

`--save-params`  <a name="sam-cli-command-reference-sam-traces-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--start-time TEXT`  <a name="sam-cli-command-reference-sam-traces-options-start-time"></a>
Ruft ab diesem Zeitpunkt Traces ab. Bei der Uhrzeit kann es sich um relative Werte wie „vor 5 Minuten“, „Gestern“ oder um einen formatierten Zeitstempel wie „2018-01-01 10:10:10“ handeln. Der Standardwert ist 'vor 10 Minuten'.

`--tail`  <a name="sam-cli-command-reference-sam-traces-options-tail"></a>
Schließt die Trace-Ausgabe ab. Dadurch wird das Endzeitargument ignoriert und es werden weiterhin Traces angezeigt, sobald sie verfügbar sind.

`--trace-id TEXT`  <a name="sam-cli-command-reference-sam-traces-options-trace-id"></a>
Die eindeutige Kennung für eine Röntgenspur.

## Beispiele
<a name="sam-cli-command-reference-sam-traces-examples"></a>

Führen Sie den folgenden Befehl aus, um X-Ray-Traces nach ID abzurufen.

```
$ sam traces --trace-id tracing-id-1 --trace-id tracing-id-2
```

Führen Sie den folgenden Befehl aus, um X-Ray-Traces zu verfolgen, sobald sie verfügbar sind.

```
$ sam traces --tail
```

# sam validate
<a name="sam-cli-command-reference-sam-validate"></a>

Diese Seite enthält Referenzinformationen für den AWS Serverless Application Model Befehl Command Line Interface (AWS SAMCLI)`sam validate`.

Eine Einführung in das finden AWS SAMCLI Sie unter [Was ist das? AWS SAMCLI](what-is-sam-overview.md#what-is-sam-cli)

Der `sam validate` Befehl überprüft, ob eine AWS SAM Vorlagendatei gültig ist.

## Usage
<a name="sam-cli-command-reference-sam-validate-usage"></a>

```
$ sam validate <options>
```

## Optionen
<a name="sam-cli-command-reference-sam-validate-options"></a>

`--config-env TEXT`  <a name="sam-cli-command-reference-sam-validate-options-config-env"></a>
Der Umgebungsname, der die Standardparameterwerte in der zu verwendenden Konfigurationsdatei angibt. Der Standardwert ist „default“. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--config-file PATH`  <a name="sam-cli-command-reference-sam-validate-options-config-file"></a>
Der Pfad und der Dateiname der Konfigurationsdatei, die die zu verwendenden Standardparameterwerte enthält. Der Standardwert ist „samconfig.toml“ im Stammverzeichnis des Projektverzeichnisses. Weitere Informationen zu Konfigurationsdateien finden Sie unter [AWS SAMCLIKonfigurationsdatei](serverless-sam-cli-config.md).

`--debug`  <a name="sam-cli-command-reference-sam-validate-options-debug"></a>
Aktiviert die Debug-Protokollierung, um die von den generierten Debug-Nachrichten zu drucken und Zeitstempel anzuzeigen. AWS SAMCLI

`--lint`  <a name="sam-cli-command-reference-sam-validate-options-lint"></a>
 Führt die Linting-Validierung für die Vorlage durch. **cfn-lint** Erstellen Sie eine `cfnlintrc` Konfigurationsdatei, um zusätzliche Parameter anzugeben. *Weitere Informationen finden Sie unter [cfn-lint](https://github.com/aws-cloudformation/cfn-lint) im CloudFormation GitHub Repository.* 

`--profile TEXT`  <a name="sam-cli-command-reference-sam-validate-options-profile"></a>
Das spezifische Profil aus Ihrer Anmeldeinformationsdatei, das die Anmeldeinformationen abruft. AWS 

`--region TEXT`  <a name="sam-cli-command-reference-sam-validate-options-region"></a>
Die AWS Region, in der die Bereitstellung erfolgen soll. Beispiel: us-east-1.

`--save-params`  <a name="sam-cli-command-reference-sam-validate-options-save-params"></a>
Speichern Sie die Parameter, die Sie in der Befehlszeile angeben, in der AWS SAM Konfigurationsdatei.

`--template-file, --template, -t PATH`  <a name="sam-cli-command-reference-sam-validate-options-template-file"></a>
 Die AWS SAM Vorlagendatei. Der Standardwert ist `template.[yaml|yml]`.   
 Wenn sich Ihre Vorlage in Ihrem aktuellen Arbeitsverzeichnis befindet und benannt ist`template.[yaml|yml|json]`, ist diese Option nicht erforderlich.   
 Wenn Sie gerade ausgeführt haben**sam build**, ist diese Option nicht erforderlich. 

## Beispiel
<a name="sam-cli-command-reference-sam-validate-examples"></a>

Ein Beispiel für die Verwendung dieses Befehls zur Validierung einer Vorlage finden Sie unter[AWS SAM Vorlagendateien validieren](serverless-sam-cli-using-validate.md).

Ein Beispiel zur Verwendung dieses Befehls mit cfn-lint finden Sie unter. [Validieren Sie Ihre AWS SAM Bewerbungen mit CloudFormation Linter](validate-cfn-lint.md)

# AWS SAMCLIVerwaltung
<a name="reference-sam-cli"></a>

Dieser Abschnitt enthält Informationen darüber, wie Sie Ihre Version von verwalten und anpassen können AWS SAMCLI. Dies beinhaltet Informationen darüber, wie Sie AWS SAMCLI Befehlsparameterwerte mithilfe einer Konfigurationsdatei auf Projektebene konfigurieren können. Es enthält auch Informationen zur Verwaltung verschiedener Versionen von Ihrem AWS SAMCLI, zum Einrichten von AWS Anmeldeinformationen, sodass Sie in Ihrem Namen AWS Dienste aufrufen AWS SAM können, und zu verschiedenen Möglichkeiten, die Sie anpassen können. AWS SAM Dieser Abschnitt endet mit einem Abschnitt zur allgemeinen AWS SAM Problembehandlung.

**Topics**
+ [

# AWS SAMCLIKonfigurationsdatei
](serverless-sam-cli-config.md)
+ [

# AWS SAMCLIVersionen verwalten
](manage-sam-cli-versions.md)
+ [

# AWS Zugangsdaten einrichten
](serverless-getting-started-set-up-credentials.md)
+ [

# Telemetrie in der AWS SAMCLI
](serverless-sam-telemetry.md)
+ [

# AWS SAMCLIProblembehandlung
](sam-cli-troubleshooting.md)

# AWS SAMCLIKonfigurationsdatei
<a name="serverless-sam-cli-config"></a>

Die AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) unterstützt eine Konfigurationsdatei auf Projektebene, mit der Sie AWS SAMCLI Befehlsparameterwerte konfigurieren können.

Eine Dokumentation zum Erstellen und Verwenden von Konfigurationsdateien finden Sie unter. [Konfiguration der AWS SAMCLI](using-sam-cli-configure.md)

**Topics**
+ [

## Standardeinstellungen für die Konfigurationsdatei
](#serverless-sam-cli-config-default)
+ [

## Unterstützte Konfigurationsdateiformate
](#serverless-sam-cli-config-formats)
+ [

## Geben Sie eine Konfigurationsdatei an
](#serverless-sam-cli-config-specify)
+ [

## Grundlagen der Konfigurationsdatei
](#serverless-sam-cli-config-basics)
+ [

## Regeln für Parameterwerte
](#serverless-sam-cli-config-rules)
+ [

## Rangfolge der Konfiguration
](#serverless-sam-cli-config-precedence)
+ [

## Konfigurationsdateien erstellen und ändern
](#serverless-sam-cli-config-using)

## Standardeinstellungen für die Konfigurationsdatei
<a name="serverless-sam-cli-config-default"></a>

AWS SAM verwendet die folgenden Standardeinstellungen für die Konfigurationsdatei:
+ **Name (Name** – `samconfig`.
+ **Standort** — Im Stammverzeichnis Ihres Projekts. Dies ist derselbe Speicherort wie Ihre `template.yaml` Datei.
+ **Format** —`TOML`. Weitere Informationen finden Sie unter [TOML](https://toml.io/en/) in der *TOMLDokumentation*.

Im Folgenden finden Sie ein Beispiel für eine Projektstruktur, die den Namen und den Speicherort der Standardkonfigurationsdatei enthält:

```
sam-app
├── README.md
├── __init__.py
├── events
├── hello_world
├── samconfig.toml
├── template.yaml
└── tests
```

Im Folgenden sehen Sie ein Beispiel für eine `samconfig.toml`-Datei:

```
...
version = 0.1

[default]
[default.global]
[default.global.parameters]
stack_name = "sam-app"

[default.build.parameters]
cached = true
parallel = true

[default.deploy.parameters]
capabilities = "CAPABILITY_IAM"
confirm_changeset = true
resolve_s3 = true

[default.sync.parameters]
watch = true

[default.local_start_api.parameters]
warm_containers = "EAGER"

[prod]
[prod.sync]
[prod.sync.parameters]
watch = false
```

## Unterstützte Konfigurationsdateiformate
<a name="serverless-sam-cli-config-formats"></a>

`TOML`und `[YAML|YML]` Formate werden unterstützt. Sehen Sie sich die folgende grundlegende Syntax an:

### TOML
<a name="serverless-sam-cli-config-formats-toml"></a>

```
version = 0.1
[environment]
[environment.command]
[environment.command.parameters]
option = parameter value
```

### YAML
<a name="serverless-sam-cli-config-formats-yaml"></a>

```
version: 0.1
environment:
  command:
    parameters:
      option: parameter value
```

## Geben Sie eine Konfigurationsdatei an
<a name="serverless-sam-cli-config-specify"></a>

Standardmäßig AWS SAMCLI sucht der in der folgenden Reihenfolge nach einer Konfigurationsdatei:

1. **Benutzerdefinierte Konfigurationsdatei** — Wenn Sie die `--config-file` Option zur Angabe eines Dateinamens und eines Speicherorts verwenden, AWS SAMCLI sucht der zuerst nach dieser Datei.

1. **`samconfig.toml`Standarddatei** — Dies ist der Standardname und das Standardformat der Konfigurationsdatei, die sich im Stammverzeichnis Ihres Projekts befinden. Wenn Sie keine benutzerdefinierte Konfigurationsdatei angeben, AWS SAMCLI sucht der als Nächstes nach dieser Datei.

1. **`samconfig.[yaml|yml]`Datei** — Wenn die `samconfig.toml` nicht im Stammverzeichnis Ihres Projekts existiert, AWS SAMCLI sucht der nach dieser Datei.

Im Folgenden finden Sie ein Beispiel für die Angabe einer benutzerdefinierten Konfigurationsdatei mithilfe der `--config-file` Option:

```
$ sam deploy --config-file myconfig.yaml
```

**Anmerkung**  
Der `--config-file` Parameter muss sich auf den Speicherort der AWS SAM Vorlagendatei beziehen, da er den Kontext bestimmen AWS SAMCLI muss, in dem die Konfiguration angewendet wird. Die `samconfig.toml` Datei verwaltet die Konfigurationseinstellungen für Ihre Version von AWS SAMCLI, und die CLI sucht nach der `samconfig.toml` Datei (oder dem überschriebenen Konfigurationsdateiparameter) im entsprechenden Ordner der `template.yaml` Datei.

## Grundlagen der Konfigurationsdatei
<a name="serverless-sam-cli-config-basics"></a>

### Umgebung
<a name="serverless-sam-cli-config-basics-environment"></a>

Eine **Umgebung** ist ein benannter Bezeichner, der einen eindeutigen Satz von Konfigurationseinstellungen enthält. Sie können mehrere Umgebungen in einer einzigen AWS SAM Anwendung haben.

Der Standardumgebungsname lautet`default`.

Verwenden Sie die AWS SAMCLI `--config-env` Option, um die zu verwendende Umgebung anzugeben.

### Befehl
<a name="serverless-sam-cli-config-basics-command"></a>

Der **Befehl** ist der AWS SAMCLI Befehl, für den Parameterwerte angegeben werden.

Verwenden Sie den `global` Bezeichner, um Parameterwerte für alle Befehle anzugeben.

Wenn Sie auf einen AWS SAMCLI Befehl verweisen, ersetzen Sie Leerzeichen (` `) und Bindestriche () durch Unterstriche (`–`). `_` Im Folgenden sind einige Beispiele aufgeführt:
+ `build`
+ `local_invoke`
+ `local_start_api`

### Parameters
<a name="serverless-sam-cli-config-basics-parameters"></a>

**Parameter** werden als Schlüssel-Wert-Paare angegeben.
+ Der **Schlüssel** ist der Name der AWS SAMCLI Befehlsoption.
+ Der **Wert** ist der anzugebende Wert.

Verwenden Sie bei der Angabe von Schlüsseln den Namen der Befehlsoption in Langform und ersetzen Sie Bindestriche () durch Unterstriche (`–`). `_` Im Folgenden sind einige Beispiele aufgeführt:
+ `region`
+ `stack_name`
+ `template_file`

## Regeln für Parameterwerte
<a name="serverless-sam-cli-config-rules"></a>

### TOML
<a name="serverless-sam-cli-config-rules-toml"></a>
+ Boolesche Werte können oder sein. `true` `false` Beispiel, `confirm_changeset = true`.
+ Verwenden Sie für Zeichenkettenwerte Anführungszeichen ()`""`. Beispiel, `region = "us-west-2"`.
+ Verwenden Sie für Listenwerte Anführungszeichen (`""`) und trennen Sie die einzelnen Werte durch ein Leerzeichen (` `). Beispiel: `capabilities = "CAPABILITY_IAM CAPABILITY_NAMED_IAM"`.
+ Bei Werten, die eine Liste von Schlüssel-Wert-Paaren enthalten, sind die Paare durch Leerzeichen getrennt (` `), und der Wert jedes Paares ist von codierten Anführungszeichen () umgeben. `\" \"` Beispiel, `tags = "project=\"my-application\" stage=\"production\""`.
+ Bei Parameterwerten, die mehrfach angegeben werden können, ist der Wert ein Array von Argumenten. Beispiel: `image_repositories = ["my-function-1=image-repo-1", "my-function-2=image-repo-2"]`.

### YAML
<a name="serverless-sam-cli-config-rules-yaml"></a>
+ Boolesche Werte können oder sein. `true` `false` Beispiel, `confirm_changeset: true`.
+ Bei Einträgen, die einen einzelnen Zeichenkettenwert enthalten, sind Anführungszeichen (`""`) optional. Beispiel, `region: us-west-2`. Dazu gehören Einträge, die mehrere Schlüssel-Wert-Paare enthalten, die als einzelne Zeichenfolge bereitgestellt werden. Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ sam deploy --tags "foo=bar hello=world"
  ```

  ```
  default:
    deploy:
      parameters:
        tags: foo=bar hello=world
  ```
+ Bei Einträgen, die eine Werteliste enthalten, oder bei Einträgen, die mehrfach in einem einzigen Befehl verwendet werden können, geben Sie sie als Liste von Zeichenfolgen an.

  Im Folgenden wird ein Beispiel gezeigt:

  ```
  $ sam remote invoke --parameter "InvocationType=Event" --parameter "LogType=None"
  ```

  ```
  default:
    remote_invoke:
      parameters:
          parameter:
          - InvocationType=Event
          - LogType=None
  ```

## Rangfolge der Konfiguration
<a name="serverless-sam-cli-config-precedence"></a>

Bei der Konfiguration von Werten gilt die folgende Priorität:
+ Parameterwerte, die Sie in der Befehlszeile angeben, haben Vorrang vor den entsprechenden Werten in der Konfigurationsdatei und im `Parameters` Abschnitt der Vorlagendatei.
+ Wenn die `--parameter-overrides` Option in der Befehlszeile oder in Ihrer Konfigurationsdatei zusammen mit dem `parameter_overrides` Schlüssel verwendet wird, haben ihre Werte Vorrang vor Werten im `Parameters` Abschnitt der Vorlagendatei.
+ In Ihrer Konfigurationsdatei haben die für einen bestimmten Befehl bereitgestellten Einträge Vorrang vor globalen Einträgen. Im folgenden Beispiel verwendet der `sam deploy` Befehl den Stack-Namen`my-app-stack`.

------
#### [ TOML ]

  ```
  [default.global.parameters]
  stack_name = "common-stack"
  
  [default.deploy.parameters]
  stack_name = "my-app-stack"
  ```

------
#### [ YAML ]

  ```
  default:
    global:
      parameters:
        stack_name: common-stack
    deploy:
      parameters:
        stack_name: my-app-stack
  ```

------

## Konfigurationsdateien erstellen und ändern
<a name="serverless-sam-cli-config-using"></a>

### Konfigurationsdateien erstellen
<a name="serverless-sam-cli-config-using-create"></a>

Wenn Sie eine Anwendung mit erstellen`sam init`, wird eine `samconfig.toml` Standarddatei erstellt. Sie können Ihre Konfigurationsdatei auch manuell erstellen.

### Konfigurationsdateien ändern
<a name="serverless-sam-cli-config-using-modify"></a>

Sie können Ihre Konfigurationsdateien manuell ändern. Außerdem werden die konfigurierten Werte während eines AWS SAMCLI interaktiven Ablaufs in Klammern (`[ ]`) angezeigt. Wenn Sie diese Werte ändern, AWS SAMCLI wird Ihre Konfigurationsdatei aktualisiert.

Im Folgenden finden Sie ein Beispiel für einen interaktiven Ablauf mit dem `sam deploy --guided` Befehl:

```
$ sam deploy --guided

Configuring SAM deploy
======================

    Looking for config file [samconfig.toml] :  Found
    Reading default arguments  :  Success

    Setting default arguments for 'sam deploy'
    =========================================
    Stack Name [sam-app]: ENTER
    AWS Region [us-west-2]: ENTER
    #Shows you resources changes to be deployed and require a 'Y' to initiate deploy
    Confirm changes before deploy [Y/n]: n
    #SAM needs permission to be able to create roles to connect to the resources in your template
    Allow SAM CLI IAM role creation [Y/n]: ENTER
    #Preserves the state of previously provisioned resources when an operation fails
    Disable rollback [y/N]: ENTER
    HelloWorldFunction may not have authorization defined, Is this okay? [y/N]: y
    Save arguments to configuration file [Y/n]: ENTER
    SAM configuration file [samconfig.toml]: ENTER
    SAM configuration environment [default]: ENTER
```

Wenn Sie Ihre Konfigurationsdatei ändern, AWS SAMCLI behandelt der globale Werte wie folgt:
+ Wenn der Parameterwert im `global` Abschnitt Ihrer Konfigurationsdatei vorhanden ist, wird der Wert AWS SAMCLI nicht in den spezifischen Befehlsabschnitt geschrieben.
+ Wenn der Parameterwert `global` sowohl im Befehlsabschnitt als auch in einem bestimmten Befehlsabschnitt vorhanden ist, AWS SAMCLI wird der spezifische Eintrag zugunsten des globalen Werts gelöscht.

# AWS SAMCLIVersionen verwalten
<a name="manage-sam-cli-versions"></a>

Verwalten Sie Ihre Versionen der AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) durch Upgrade, Downgrade und Deinstallation. Optional können Sie den Nightly Build herunterladen und installieren. AWS SAMCLI

**Topics**
+ [

## Aktualisierung des AWS SAMCLI
](#manage-sam-cli-versions-upgrade)
+ [

## Deinstallation des AWS SAMCLI
](#manage-sam-cli-versions-uninstall)
+ [

## Wechseln Sie von der Verwendung Homebrew zur Verwaltung von AWS SAMCLI
](#manage-sam-cli-versions-switch)
+ [

## Den AWS SAMCLI Nightly-Build verwalten
](#manage-sam-cli-versions-nightly-build)
+ [

## Installation des AWS SAMCLI in einer virtuellen Umgebung mit pip
](#manage-sam-cli-versions-install-virtual)
+ [

## Verwaltung des AWS SAMCLI mit Homebrew
](#manage-sam-cli-versions-homebrew)
+ [

## Fehlerbehebung
](#manage-sam-cli-versions-troubleshoot)

## Aktualisierung des AWS SAMCLI
<a name="manage-sam-cli-versions-upgrade"></a>

### Linux
<a name="manage-sam-cli-versions-upgrade-linux"></a>

Um das AWS SAMCLI auf Linux zu aktualisieren, folgen Sie den Installationsanweisungen unter[Installation des AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions), fügen Sie jedoch die `--update` Option wie folgt zum Installationsbefehl hinzu:

```
sudo ./sam-installation/install --update
```

### macOS
<a name="manage-sam-cli-versions-upgrade-macos"></a>

Die AWS SAMCLI muss mit derselben Methode aktualisiert werden, mit der sie installiert wurde. Wir empfehlen, dass Sie das Paketinstallationsprogramm verwenden, um das zu installieren und zu aktualisieren AWS SAMCLI.

 Um das AWS SAMCLI mit dem Paketinstallationsprogramm zu aktualisieren, installieren Sie die neueste Paketversion. Detaillierte Anweisungen finden Sie unter [Installation des AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions). 

### Windows
<a name="manage-sam-cli-versions-upgrade-windows"></a>

Um das zu aktualisieren AWS SAMCLI, wiederholen Sie die Windows-Installationsschritte unter [Installieren Sie das AWS SAMCLI](install-sam-cli.md) erneut.

## Deinstallation des AWS SAMCLI
<a name="manage-sam-cli-versions-uninstall"></a>

### Linux
<a name="manage-sam-cli-versions-uninstall-linux"></a>

Um das AWS SAMCLI unter Linux zu deinstallieren, müssen Sie den Symlink und das Installationsverzeichnis löschen, indem Sie die folgenden Befehle ausführen:

1. Suchen Sie den Symlink und die Installationspfade.
   + Suchen Sie den Symlink mit dem **which** folgenden Befehl:

     ```
     which sam
     ```

     Die Ausgabe zeigt den Pfad, in dem sich die AWS SAM Binärdateien befinden, zum Beispiel:

     ```
      /usr/local/bin/sam
     ```
   + Suchen Sie mit dem folgenden Befehl nach dem Verzeichnis, auf das der **ls** Symlink verweist:

     ```
     ls -l /usr/local/bin/sam
     ```

     Im folgenden Beispiel lautet `/usr/local/aws-sam-cli` das Installationsverzeichnis.

     ```
      lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
     ```

1. Löschen Sie den Symlink.

   ```
   sudo rm /usr/local/bin/sam
   ```

1. Löschen Sie das Installationsverzeichnis.

   ```
   sudo rm -rf /usr/local/aws-sam-cli
   ```

### macOS
<a name="manage-sam-cli-versions-uninstall-macos"></a>

Deinstallieren Sie AWS SAMCLI das mit derselben Methode, mit der es installiert wurde. Wir empfehlen, dass Sie das Paketinstallationsprogramm verwenden, um das zu installieren AWS SAMCLI.

Wenn Sie das AWS SAMCLI mit dem Paketinstallationsprogramm installiert haben, gehen Sie zur Deinstallation wie folgt vor.

**Um das zu deinstallieren AWS SAMCLI**

1.  Entfernen Sie das AWS SAMCLI Programm, indem Sie Folgendes ändern und ausführen: 

   ```
   $ sudo rm -rf /path-to/aws-sam-cli
   ```

   1.  *sudo*— Wenn Ihr Benutzer Schreibberechtigungen für den Ort hat, an dem AWS SAMCLI das Programm installiert ist, **sudo** ist dies nicht erforderlich. Andernfalls ist **sudo** erforderlich. 

   1.  */path-to*— Pfad zu dem Ort, an dem Sie das AWS SAMCLI Programm installiert haben. Der Standardspeicherort ist `/usr/local`. 

1.  Entfernen Sie das, AWS SAMCLI `$PATH` indem Sie Folgendes ändern und ausführen: 

   ```
   $ sudo rm -rf /path-to-symlink-directory/sam
   ```

   1.  *sudo*— Wenn Ihr Benutzer Schreibberechtigungen hat`$PATH`, **sudo** ist dies nicht erforderlich. Andernfalls ist **sudo** erforderlich. 

   1.  *path-to-symlink-directory*— Ihre `$PATH` Umgebungsvariable. Der Standardspeicherort ist `/usr/local/bin`. 

1.  Stellen Sie sicher, dass das deinstalliert AWS SAMCLI ist, indem Sie Folgendes ausführen: 

   ```
   $ sam --version
   command not found: sam
   ```

### Windows
<a name="manage-sam-cli-versions-uninstall-windows"></a>

Gehen Sie folgendermaßen vor, um das AWS SAMCLI mithilfe der Windows-Einstellungen zu deinstallieren:

1. Suchen Sie im Startmenü nach „Programme hinzufügen oder entfernen“.

1. Wählen Sie das Ergebnis mit dem Namen **AWS SAM Command Line Interface** und anschließend **Deinstallieren, um das Deinstallationsprogramm** zu starten.

1. Bestätigen Sie, dass Sie das AWS SAMCLI deinstallieren möchten.

## Wechseln Sie von der Verwendung Homebrew zur Verwaltung von AWS SAMCLI
<a name="manage-sam-cli-versions-switch"></a>

Wenn Sie Homebrew die Installation und Aktualisierung von verwenden AWS SAMCLI, empfehlen wir die Verwendung einer AWS unterstützten Methode. Folgen Sie diesen Anweisungen, um zu einer unterstützten Methode zu wechseln.

**Um von der Verwendung von zu wechseln Homebrew**

1. Folgen Sie den Anweisungen unter[Deinstallation einer Homebrew installierten CLI AWS SAM](#manage-sam-cli-versions-homebrew-uninstall), um die Homebrew verwaltete Version zu deinstallieren.

1. Folgen Sie den Anweisungen unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md), um die AWS SAM CLI mit einer unterstützten Methode zu installieren.

## Den AWS SAMCLI Nightly-Build verwalten
<a name="manage-sam-cli-versions-nightly-build"></a>

Sie können den AWS SAMCLI Nightly Build herunterladen und installieren. Er enthält eine Vorabversion des AWS SAMCLI Codes, die möglicherweise weniger stabil ist als die Produktionsversion. Nach der Installation können Sie den Nightly Build mit dem `sam-nightly` Befehl verwenden. Sie können sowohl die Produktions- als auch die Nightly-Build-Version von gleichzeitig installieren und verwenden. AWS SAMCLI

**Anmerkung**  
Der Nightly-Build enthält keine Vorabversion des Build-Images. Aus diesem Grund wird beim Erstellen Ihrer serverlosen Anwendung mit dieser **--use-container** Option die neueste Produktionsversion des Build-Images verwendet.

### Installation des AWS SAMCLI Nightly-Builds
<a name="manage-sam-cli-versions-nightly-build-install"></a>

Folgen Sie diesen Anweisungen, um den AWS SAMCLI Nightly-Build zu installieren.

#### Linux
<a name="manage-sam-cli-versions-nightly-build-install-linux"></a>

Sie können die Nightly-Build-Version von AWS SAMCLI auf der Linux x86\$164-Plattform mit dem Paket-Installer installieren.

**Um den Nightly Build zu installieren AWS SAMCLI**

1. Laden Sie das Paketinstallationsprogramm aus [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dem *aws-sam-cli GitHubRepository* herunter.

1. Folgen Sie den Schritten zur [Installation des AWS SAMCLI, um das](install-sam-cli.md) Nightly Build-Paket zu installieren.

#### macOS
<a name="manage-sam-cli-versions-nightly-build-install-macos"></a>

Sie können die Nightly Build-Version von AWS SAMCLI on macOS mit dem Nightly Build Package Installer installieren.

**Um den Nightly Build zu installieren AWS SAMCLI**

1. Laden Sie das Paketinstallationsprogramm für Ihre Plattform aus [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dem *aws-sam-cli GitHubRepository* herunter.

1. Folgen Sie den Schritten zur [Installation des AWS SAMCLI, um das](install-sam-cli.md) Nightly Build-Paket zu installieren.

#### Windows
<a name="manage-sam-cli-versions-nightly-build-windows"></a>

Die Nightly Build-Version von AWS SAMCLI ist über diesen Download-Link verfügbar: [AWS SAMCLINightly](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi) Build. Um den Nightly Build unter Windows zu installieren, führen Sie dieselben Schritte aus wie in[Installieren Sie das AWS SAMCLI](install-sam-cli.md), verwenden Sie jedoch stattdessen den Download-Link für den Nightly Build.

Führen Sie den Befehl aus, um zu überprüfen, ob Sie die Nightly Build-Version installiert haben. **sam-nightly --version** Die Ausgabe dieses Befehls hat zum Beispiel das `1.X.Y.dev<YYYYMMDDHHmm>` folgende Format:

```
SAM CLI, version 1.20.0.dev202103151200
```

### Wechseln Sie vom Homebrew Paketinstallationsprogramm
<a name="manage-sam-cli-versions-nightly-build-switch"></a>

Wenn Sie den AWS SAMCLI Nightly-Build Homebrew zur Installation und zum Upgrade verwenden und zur Verwendung des Paketinstallationsprogramms wechseln möchten, gehen Sie wie folgt vor.

**Um vom Homebrew Paket-Installer zu wechseln**

1. Deinstallieren Sie den Homebrew installierten AWS SAMCLI Nightly Build.

   ```
   $ brew uninstall aws-sam-cli-nightly
   ```

1. Stellen Sie sicher, dass der AWS SAMCLI Nightly Build deinstalliert wurde, indem Sie Folgendes ausführen:

   ```
   $ sam-nightly --version
   zsh: command not found: sam-nightly
   ```

1. Folgen Sie den Schritten im vorherigen Abschnitt, um den AWS SAMCLI Nightly Build zu installieren.

## Installation des AWS SAMCLI in einer virtuellen Umgebung mit pip
<a name="manage-sam-cli-versions-install-virtual"></a>

Wir empfehlen, das native Paketinstallationsprogramm zu verwenden, um das zu installieren AWS SAMCLI. Wenn Sie es verwenden müssenpip, empfehlen wir Ihnen, das AWS SAMCLI in einer virtuellen Umgebung zu installieren. Dies gewährleistet eine saubere Installationsumgebung und eine isolierte Umgebung, falls Fehler auftreten.

**Anmerkung**  
Ab dem 24. Oktober 2023 stellt AWS SAM CLI das den Support für Python 3.7 ein. Weitere Informationen hierzu finden Sie unter [AWS SAMCLIEinstellung der Unterstützung für Python 3.7](important-notes.md#important-notes-2023-10-python).

**Um das AWS SAMCLI in einer virtuellen Umgebung zu installieren**

1. Erstellen Sie aus einem Startverzeichnis Ihrer Wahl eine virtuelle Umgebung und geben Sie ihr einen Namen.

------
#### [ Linux / macOS ]

   ```
   $ mkdir project
   $ cd project
   $ python3 -m venv venv
   ```

------
#### [ Windows ]

   ```
   > mkdir project
   > cd project
   > py -3 -m venv venv
   ```

------

1. Aktivieren Sie die virtuelle Umgebung

------
#### [ Linux / macOS ]

   ```
   $ . venv/bin/activate
   ```

   Die Eingabeaufforderung ändert sich und zeigt Ihnen, dass Ihre virtuelle Umgebung aktiv ist.

   ```
   (venv) $ 
   ```

------
#### [ Windows ]

   ```
   > venv\Scripts\activate
   ```

   Die Aufforderung ändert sich und zeigt Ihnen, dass Ihre virtuelle Umgebung aktiv ist.

   ```
   (venv) > 
   ```

------

1. Installieren Sie das AWS SAMCLI in Ihrer virtuellen Umgebung.

   ```
   (venv) $ pip install --upgrade aws-sam-cli
   ```

1. Stellen Sie sicher, dass das AWS SAMCLI korrekt installiert ist.

   ```
   (venv) $ sam --version
   SAM CLI, version 1.94.0
   ```

1. Sie können den Befehl `deactivate` verwenden, um die virtuelle Umgebung zu beenden. Wenn Sie eine neue Sitzung starten, müssen Sie die Umgebung erneut aktivieren.

## Verwaltung des AWS SAMCLI mit Homebrew
<a name="manage-sam-cli-versions-homebrew"></a>

**Anmerkung**  
Ab September 2023 AWS wird das AWS verwaltete Homebrew Installationsprogramm für AWS SAMCLI (`aws/tap/aws-sam-cli`) nicht mehr verwaltet. Um die Nutzung fortzusetzenHomebrew, können Sie das von der Community verwaltete Installationsprogramm (`aws-sam-cli`) verwenden. Ab September 2023 wird jeder Homebrew Befehl, auf den verwiesen `aws/tap/aws-sam-cli` wird, umgeleitet`aws-sam-cli`.  
Wir empfehlen Ihnen, unsere unterstützten [Installations](install-sam-cli.md) - und [Upgrade-Methoden](#manage-sam-cli-versions-upgrade) zu verwenden.

### Installation des AWS SAMCLI mit Homebrew
<a name="manage-sam-cli-versions-homebrew-install"></a>

**Anmerkung**  
Diese Anweisungen verwenden das von der Community verwaltete AWS SAMCLI Homebrew Installationsprogramm. Weitere Unterstützung finden Sie im *[Homebrew-Core-Repository](https://github.com/Homebrew/homebrew-core/issues)*.

**Um das zu installieren AWS SAMCLI**

1. Führen Sie Folgendes aus:

   ```
   $ brew install aws-sam-cli
   ```

1. Überprüfen Sie die Installation:

   ```
   $ sam --version
   ```

   Nach erfolgreicher Installation von sollten Sie eine Ausgabe wie die folgende sehen: AWS SAMCLI

   ```
   SAM CLI, version 1.94.0
   ```

### Aktualisierung der AWS SAMCLI Verwendung von Homebrew
<a name="manage-sam-cli-versions-homebrew-upgrade"></a>

Führen Sie den folgenden Befehl ausHomebrew, um die AWS SAMCLI Verwendung zu aktualisieren:

```
$ brew upgrade aws-sam-cli
```

### Deinstallation einer Homebrew installierten CLI AWS SAM
<a name="manage-sam-cli-versions-homebrew-uninstall"></a>

Wenn das mit installiert AWS SAMCLI wurdeHomebrew, gehen Sie wie folgt vor, um es zu deinstallieren.

**Um das zu deinstallieren AWS SAMCLI**

1. Führen Sie Folgendes aus:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI ist, indem Sie Folgendes ausführen:

   ```
   $ sam --version
   command not found: sam
   ```

### Wechseln Sie zum von der Community verwalteten Homebrew Installationsprogramm
<a name="manage-sam-cli-versions-homebrew-switch"></a>

Wenn Sie das AWS verwaltete Homebrew Installationsprogramm (`aws/tap/aws-sam-cli`) verwenden und es vorziehen, es weiterhin zu verwendenHomebrew, empfehlen wir, zum von der Community verwalteten Homebrew Installationsprogramm (`aws-sam-cli`) zu wechseln.

Um in einem einzigen Befehl zu wechseln, führen Sie den folgenden Befehl aus:

```
$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli
```

Folgen Sie diesen Anweisungen, um jeden Befehl einzeln auszuführen.

**Um zum von der Community verwalteten Homebrew Installationsprogramm zu wechseln**

1. Deinstallieren Sie die AWS verwaltete Homebrew Version von AWS SAMCLI:

   ```
   $ brew uninstall aws-sam-cli
   ```

1. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI wurde:

   ```
   $ which sam
   sam not found
   ```

1. Entfernen Sie den AWS verwalteten AWS SAMCLI Wasserhahn:

   ```
   $ brew untap aws/tap
   ```

   Wenn Sie eine Fehlermeldung wie die folgende erhalten, fügen Sie die `--force` Option hinzu und versuchen Sie es erneut.

   ```
   Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
   aws-sam-cli-nightly
   ```

1. Entfernen Sie die zwischengespeicherten Dateien für das AWS verwaltete Installationsprogramm:

   ```
   $ brew cleanup aws/tap
   ```

1. Update Homebrew und alle Formeln:

   ```
   $ brew update
   ```

1. Installieren Sie die von der Community verwaltete Version von: AWS SAMCLI

   ```
   $ brew install aws-sam-cli
   ```

1. Stellen Sie sicher, dass AWS SAMCLI das erfolgreich installiert wurde:

   ```
   $ sam --version
   SAM CLI, version 1.94.0
   ```

## Fehlerbehebung
<a name="manage-sam-cli-versions-troubleshoot"></a>

Falls Sie bei der Installation oder Verwendung von auf Fehler stoßen AWS SAMCLI, finden Sie weitere Informationen unter[AWS SAMCLIProblembehandlung](sam-cli-troubleshooting.md).

# AWS Zugangsdaten einrichten
<a name="serverless-getting-started-set-up-credentials"></a>

Für die AWS SAM Befehlszeilenschnittstelle (CLI) müssen Sie AWS Anmeldeinformationen festlegen, damit sie in Ihrem Namen AWS Dienste aufrufen kann. Zum Beispiel AWS SAMCLI ruft der Amazon S3 auf und CloudFormation.

Möglicherweise haben Sie bereits AWS Anmeldeinformationen für die Arbeit mit AWS Tools wie einem der AWS SDKs oder dem festgelegt AWS CLI. Falls nicht, finden Sie in diesem Thema die empfohlenen Vorgehensweisen zum Einrichten von AWS Anmeldeinformationen.

Um AWS Anmeldeinformationen festzulegen, benötigen Sie die *Zugriffsschlüssel-ID* und Ihren *geheimen Zugriffsschlüssel* für den IAM-Benutzer, den Sie konfigurieren möchten. Informationen zu Zugriffsschlüsseln IDs und geheimen Zugriffsschlüsseln finden Sie unter [Managing Access Keys for IAM Users](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) im *IAM-Benutzerhandbuch*.

Stellen Sie als Nächstes fest, ob Sie das AWS CLI installiert haben. Folgen Sie dann den Anweisungen in einem der folgenden Abschnitte:

## Mit dem AWS CLI
<a name="serverless-getting-started-set-up-credentials-cli"></a>

Wenn Sie das AWS CLI installiert haben, verwenden Sie den `aws configure` Befehl und folgen Sie den Anweisungen:

```
$ aws configure
AWS Access Key ID [None]: your_access_key_id
AWS Secret Access Key [None]: your_secret_access_key
Default region name [None]: 
Default output format [None]:
```

Informationen zu dem `aws configure` Befehl finden Sie unter [Schnellkonfiguration von AWS CLI im AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-quick-configuration) *Benutzerhandbuch*.

## Ich verwende nicht den AWS CLI
<a name="serverless-getting-started-set-up-credentials-no-cli"></a>

Wenn Sie das nicht AWS CLI installiert haben, können Sie entweder eine Anmeldeinformationsdatei erstellen oder Umgebungsvariablen festlegen:
+ **Anmeldeinformationsdatei** — Sie können Anmeldeinformationen in der AWS Anmeldeinformationsdatei auf Ihrem lokalen System festlegen. Diese Datei muss sich an einem der folgenden Speicherorte befinden:
  + `~/.aws/credentials`unter Linux oder macOS
  + `C:\Users\USERNAME\.aws\credentials` (Windows)

  Diese Datei sollte Zeilen im folgenden Format enthalten:

  ```
  [default]
  aws_access_key_id = your_access_key_id
  aws_secret_access_key = your_secret_access_key
  ```

   
+ **Umgebungsvariablen** — Sie können die Umgebungsvariablen `AWS_ACCESS_KEY_ID` und die `AWS_SECRET_ACCESS_KEY` Umgebungsvariablen festlegen.

  Verwenden Sie den Befehl **export**, um diese Variablen unter Linux oder macOS festzulegen:

  ```
  export AWS_ACCESS_KEY_ID=your_access_key_id
  export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

  Verwenden Sie den Befehl set, um diese Variablen unter Windows **festzulegen**:

  ```
  set AWS_ACCESS_KEY_ID=your_access_key_id
  set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  ```

# Telemetrie in der AWS SAMCLI
<a name="serverless-sam-telemetry"></a>

Bei AWS entwickeln und lancieren wir Dienstleistungen auf der Grundlage dessen, was wir aus Interaktionen mit Kunden lernen. Wir nutzen Kundenfeedback, um unser Produkt weiterzuentwickeln. Telemetrie ist eine zusätzliche Information, die uns hilft, die Bedürfnisse unserer Kunden besser zu verstehen, Probleme zu diagnostizieren und Funktionen bereitzustellen, die das Kundenerlebnis verbessern.

Die AWS SAM Befehlszeilenschnittstelle (CLI) sammelt Telemetriedaten, z. B. allgemeine Nutzungsmetriken, System- und Umgebungsinformationen sowie Fehler. Einzelheiten zu der Art der erfassten Telemetrie finden Sie unter [Arten von erfassten Informationen](#serverless-sam-telemtry-data-collected).

Die AWS SAMCLI sammelt **keine** personenbezogenen Daten wie Benutzernamen oder E-Mail-Adressen. Außerdem werden keine sensiblen Informationen auf Projektebene extrahiert.

Kunden haben die Kontrolle darüber, ob die Telemetrie aktiviert ist, und sie können ihre Einstellungen jederzeit ändern. Wenn die Telemetrie aktiviert bleibt, werden Telemetriedaten im Hintergrund AWS SAMCLI gesendet, ohne dass eine zusätzliche Kundeninteraktion erforderlich ist.

## Schalten Sie die Telemetrie für eine Sitzung aus
<a name="serverless-sam-telemtry-opt-out"></a>

In macOS- und Linux-Betriebssystemen können Sie die Telemetrie für eine einzelne Sitzung ausschalten. Um die Telemetrie für Ihre aktuelle Sitzung zu deaktivieren, führen Sie den folgenden Befehl aus, um die Umgebungsvariable `SAM_CLI_TELEMETRY` auf `false` festzulegen. Wiederholen Sie den Befehl für jedes neue Terminal oder jede neue Sitzung.

```
export SAM_CLI_TELEMETRY=0
```

## Telemetrie für Ihr Profil in allen Sitzungen ausschalten
<a name="serverless-sam-telemtry-opt-out-profile"></a>

Führen Sie die folgenden Befehle aus, um die Telemetrie für alle Sitzungen zu deaktivieren, wenn Sie das AWS SAMCLI auf Ihrem Betriebssystem ausführen.

### Aktivieren von Telemetrie unter Linux
<a name="w2aac28c19c16c15b5"></a>

1. Führen Sie Folgendes aus:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Führen Sie Folgendes aus:

   ```
   source ~/.profile
   ```

### Aktivieren von Telemetrie unter macOS
<a name="w2aac28c19c16c15b7"></a>

1. Führen Sie Folgendes aus:

   ```
   echo "export SAM_CLI_TELEMETRY=0" >>~/.profile
   ```

1. Führen Sie Folgendes aus:

   ```
   source ~/.profile
   ```

### Aktivieren von Telemetrie unter Windows
<a name="w2aac28c19c16c15b9"></a>

Mit dem folgenden Befehl können Sie die Umgebungsvariable vorübergehend für die Lebensdauer des Terminalfensters festlegen:

Wenn Sie die Befehlszeile verwenden:

```
set SAM_CLI_TELEMETRY=0
```

Bei Verwendung von PowerShell:

```
$env:SAM_CLI_TELEMETRY=0
```

Verwenden Sie den folgenden Befehl, um die Umgebungsvariable entweder in der Befehlszeile oder PowerShell dauerhaft festzulegen:

```
setx SAM_CLI_TELEMETRY 0
```

**Anmerkung**  
Änderungen werden erst wirksam, wenn das Terminal geschlossen und erneut geöffnet wurde.

## Arten von erfassten Informationen
<a name="serverless-sam-telemtry-data-collected"></a>
+ **Nutzungsinformationen** — Die generischen Befehle und Unterbefehle, die Kunden ausführen.
+ **Fehler und Diagnoseinformationen** — Status und Dauer der Befehle, die Kunden ausführen, einschließlich Exit-Codes, Namen interner Ausnahmen und Fehler beim Herstellen einer Verbindung zu Docker.
+ **System- und Umgebungsinformationen** — Die Python-Version, das Betriebssystem (Windows, Linux oder macOS), die Umgebung, in der der AWS SAMCLI ausgeführt wird (z. B. ein AWS IDE-Toolkit oder ein Terminal), und Hashwerte der Nutzungsattribute. AWS CodeBuild

## Weitere Informationen
<a name="serverless-sam-telemtry-learn-more"></a>

Die AWS SAMCLI gesammelten Telemetriedaten entsprechen den AWS Datenschutzrichtlinien. Weitere Informationen finden Sie hier:
+ [AWS Nutzungsbedingungen](https://aws.amazon.com/service-terms/)
+ [Häufig gestellte Fragen zum Datenschutz](https://aws.amazon.com/compliance/data-privacy-faq/)

# AWS SAMCLIProblembehandlung
<a name="sam-cli-troubleshooting"></a>

Dieser Abschnitt enthält Einzelheiten zur Behebung von Fehlermeldungen bei der Verwendung, Installation und Verwaltung der AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI).

**Topics**
+ [

## Fehlerbehebung
](#install-sam-cli-troubleshooting)
+ [

## Fehlermeldungen
](#sam-cli-troubleshoot-messages)
+ [

## Warnmeldungen
](#sam-cli-troubleshoot-warning)

## Fehlerbehebung
<a name="install-sam-cli-troubleshooting"></a>

Anleitungen zur Fehlerbehebung in Bezug auf AWS SAMCLI finden Sie unter[Behebung von Installationsfehlern](install-sam-cli.md#sam-cli-troubleshoot-install).

## Fehlermeldungen
<a name="sam-cli-troubleshoot-messages"></a>

### Curl-Fehler: „curl: (6) Konnte nicht auflösen:...“
<a name="sam-cli-troubleshoot-messages-curl"></a>

Beim Versuch, den API Gateway Gateway-Endpunkt aufzurufen, wird der folgende Fehler angezeigt:

```
curl: (6) Could not resolve: endpointdomain (Domain name not found)
```

Das bedeutet, dass Sie versucht haben, eine Anfrage an eine ungültige Domain zu senden. Dies kann passieren, wenn Ihre serverlose Anwendung nicht erfolgreich bereitgestellt werden konnte oder wenn Sie einen Tippfehler in Ihrem **curl** Befehl haben. Stellen Sie mithilfe der CloudFormation Konsole oder des sicher, dass die Anwendung erfolgreich bereitgestellt wurde AWS CLI, und stellen Sie sicher, dass Ihr **curl** Befehl korrekt ist.

### Fehler: Es können keine genauen Ressourceninformationen mit dem angegebenen Stack-Namen gefunden werden
<a name="sam-cli-troubleshoot-messages-exact-resource"></a>

Wenn `sam remote invoke` Sie den Befehl in einer Anwendung ausführen, die eine einzelne Lambda-Funktionsressource enthält, wird der folgende Fehler angezeigt:

```
Error: Can't find exact resource information with given <stack-name>. Please provide full resource ARN or --stack-name to resolve the ambiguity.
```

**Mögliche Ursache: Sie haben die `--stack-name` Option nicht angegeben.**  
Wenn ein Funktions-ARN nicht als Argument bereitgestellt wird, erfordert der `sam remote invoke` Befehl, dass die `--stack-name` Option angegeben wird.

**Lösung: Geben Sie die `--stack-name` Option an.**  
Im Folgenden wird ein Beispiel gezeigt:  

```
$ sam remote invoke --stack-name sam-app

Invoking Lambda Function HelloWorldFunction                                                                                                                                                                                                                     
START RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82 Version: $LATEST
END RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82
REPORT RequestId: 40593abb-e1ad-4d99-87bd-ac032e364e82  Duration: 11.31 ms      Billed Duration: 12 ms  Memory Size: 128 MB     Max Memory Used: 67 MB  Init Duration: 171.71 ms
{"statusCode":200,"body":"{\"message\":\"hello world\"}"}%
```

### Fehler: Ressourceninformationen können nicht aus dem Stacknamen gefunden werden
<a name="sam-cli-troubleshoot-messages-stack-name"></a>

Wenn `sam remote invoke` Sie den Befehl ausführen und einen Lambda-Funktions-ARN als Argument übergeben, wird der folgende Fehler angezeigt:

```
Error: Can't find resource information from stack name (<stack-name>) and resource id (<function-id>)
```

**Mögliche Ursache: Sie haben den Wert des Stack-Namens in Ihrer `samconfig.toml` Datei definiert.**  
Der AWS SAMCLI erste überprüft Ihre `samconfig.toml` Datei auf einen Stacknamen. Falls angegeben, wird das Argument als logischer ID-Wert übergeben.

**Lösung: Übergeben Sie stattdessen die logische ID der Funktion.**  
Sie können die logische ID der Funktion als Argument anstelle des ARN der Funktion übergeben.

**Lösung: Entfernen Sie den Wert des Stack-Namens aus Ihrer Konfigurationsdatei.**  
Sie können den Wert des Stack-Namens aus Ihrer Konfigurationsdatei entfernen. Dadurch wird verhindert, dass Ihre Funktion ARN als logischen ID-Wert übergeben wird. AWS SAMCLI  
Führen Sie es aus, `sam build` nachdem Sie Ihre Konfigurationsdatei geändert haben.

### Fehler: Verwaltete Ressourcen konnten nicht erstellt werden: Anmeldeinformationen konnten nicht gefunden werden
<a name="sam-cli-troubleshoot-messages-credentials"></a>

Beim Ausführen des **sam deploy** Befehls wird der folgende Fehler angezeigt:

```
Error: Failed to create managed resources: Unable to locate credentials
```

Das bedeutet, dass Sie keine AWS Anmeldeinformationen eingerichtet haben, mit denen AWS SAMCLI Sie AWS Serviceanfragen tätigen können. Um dieses Problem zu beheben, müssen Sie AWS Anmeldeinformationen einrichten. Weitere Informationen finden Sie unter [AWS Zugangsdaten einrichten](serverless-getting-started-set-up-credentials.md).

### Fehler: FileNotFoundError in Windows
<a name="sam-cli-troubleshoot-messages-filenotfound-win"></a>

Wenn Sie Befehle AWS SAMCLI unter Windows ausführen, wird möglicherweise der folgende Fehler angezeigt:

```
Error: FileNotFoundError
```

Mögliche Ursache: Sie interagieren AWS SAMCLI möglicherweise mit Dateipfaden, die die maximale Pfadbeschränkung von Windows überschreiten.

Lösung: Um dieses Problem zu beheben, muss das neue Verhalten für lange Pfade aktiviert werden. Informationen dazu finden Sie unter [Enable Long Paths in Windows 10, Version 1607 und höher](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) in der *Dokumentation zur Entwicklung von Microsoft Windows-Apps*.

### Fehler: Der Abhängigkeitsauflöser von pip...
<a name="sam-cli-troubleshoot-messages-pip"></a>

*Beispiel-Fehlertext:*

```
ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts. 
aws-sam-cli 1.58.0 requires aws-sam-translator==1.51.0, but you have aws-sam-translator 1.58.0 which is incompatible. 
aws-sam-cli 1.58.0 requires typing-extensions==3.10.0.0, but you have typing-extensions 4.4.0 which is incompatible.
```

**Mögliche Ursache: Bei der Installation von Paketen können Abhängigkeiten zwischen Paketen zu Konflikten führen. pip**  
Jede Version des `aws-sam-cli` Pakets hängt von einer Version des `aws-sam-translator` Pakets ab. Zum Beispiel kann `aws-sam-cli` v1.58.0 von v1.51.0 abhängen`aws-sam-translator`.  
Wenn Sie das Paket AWS SAMCLI verwenden und dann ein anderes Paket installierenpip, das von einer neueren Version von abhängt`aws-sam-translator`, passiert Folgendes:  
+ Die neuere Version von `aws-sam-translator` wird installiert.
+ Die aktuelle Version von `aws-sam-cli` und die neuere Version von sind `aws-sam-translator` möglicherweise nicht kompatibel.
+ Wenn Sie den verwenden AWS SAMCLI, tritt der Abhängigkeitsauflösungsfehler auf.

**Lösungen:**

1. Verwenden Sie das AWS SAMCLI native Paketinstallationsprogramm.

   1. Deinstallieren Sie das AWS SAMCLI mit Pip. Detaillierte Anweisungen finden Sie unter [Deinstallation des AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall).

   1. Installieren Sie das AWS SAMCLI mit dem nativen Paketinstallationsprogramm. Detaillierte Anweisungen finden Sie unter [Installieren Sie das AWS SAMCLI](install-sam-cli.md).

   1. Falls erforderlich, führen Sie ein Upgrade AWS SAMCLI mit dem systemeigenen Paketinstallationsprogramm durch. Detaillierte Anweisungen finden Sie unter [Aktualisierung des AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

1. Wenn Sie die CLI verwenden müssenpip, empfehlen wir Ihnen, die AWS SAM CLI in einer virtuellen Umgebung zu installieren. Dies gewährleistet eine saubere Installationsumgebung und eine isolierte Umgebung, falls Fehler auftreten. Detaillierte Anweisungen finden Sie unter [Installation des AWS SAMCLI in einer virtuellen Umgebung mit pip](manage-sam-cli-versions.md#manage-sam-cli-versions-install-virtual).

### Fehler: Kein solcher Befehl 'remote'
<a name="sam-cli-troubleshoot-messages-command-remote"></a>

Beim Ausführen des `sam remote invoke` Befehls wird der folgende Fehler angezeigt:

```
$ sam remote invoke ...
2023-06-20 08:15:07 Command remote not available
Usage: sam [OPTIONS] COMMAND [ARGS]...
Try 'sam -h' for help.

Error: No such command 'remote'.
```

**Mögliche Ursache: Ihre Version von AWS SAMCLI ist veraltet.**  
Der AWS SAMCLI `sam remote invoke` Befehl wurde mit AWS SAMCLI Version 1.88.0 veröffentlicht. Sie können Ihre Version überprüfen, indem Sie den `sam --version` Befehl ausführen.

**Lösung: Führen Sie ein Upgrade AWS SAMCLI auf die neueste Version durch.**  
Detaillierte Anweisungen finden Sie unter [Aktualisierung des AWS SAMCLI](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).

### Fehler: Das lokale Ausführen von AWS SAM-Projekten erfordertDocker. Hast du es installiert?
<a name="sam-cli-troubleshoot-messages-docker"></a>

Beim Ausführen des **sam local start-api** Befehls wird der folgende Fehler angezeigt:

```
Error: Running AWS SAM projects locally requires Docker. Have you got it installed?
```

Das bedeutet, dass Sie es nicht Docker richtig installiert haben. Dockerist erforderlich, um Ihre Anwendung lokal zu testen. Um dieses Problem zu beheben, folgen Sie den Anweisungen zur Installation von Docker für Ihren Entwicklungshost. Weitere Informationen finden Sie unter [Installieren von Docker](install-docker.md).

### Fehler: Sicherheitseinschränkungen nicht erfüllt
<a name="sam-cli-troubleshoot-messages-security-constraints"></a>

Beim Ausführen **sam deploy --guided** wird Ihnen die Frage angezeigt`Function may not have authorization defined, Is this okay? [y/N]`. Wenn Sie auf diese Aufforderung mit **N** (der Standardantwort) antworten, wird der folgende Fehler angezeigt:

```
Error: Security Constraints Not Satisfied
```

Die Aufforderung informiert Sie darüber, dass die Anwendung, die Sie bereitstellen möchten, möglicherweise über eine öffentlich zugängliche Amazon API Gateway, die ohne Autorisierung konfiguriert ist. Wenn Sie **N** auf diese Aufforderung antworten, sagen Sie, dass dies nicht in Ordnung ist.

Um dieses Problem zu beheben, haben Sie die folgenden Optionen:
+ Konfigurieren Sie Ihre Anwendung mit Autorisierung. Informationen zur Konfiguration der Autorisierung finden Sie unter[Kontrollieren Sie den API-Zugriff mit Ihrer AWS SAM Vorlage](serverless-controlling-access-to-apis.md).
+ Wenn Sie beabsichtigen, einen öffentlich zugänglichen API-Endpunkt ohne Autorisierung einzurichten, starten Sie Ihre Bereitstellung neu und beantworten Sie diese Frage mit, **Y** um anzugeben, dass Sie mit der Bereitstellung einverstanden sind.

### Nachricht: Fehlendes Authentifizierungstoken
<a name="sam-cli-troubleshoot-messages-auth-token"></a>

Beim Versuch, den API Gateway Gateway-Endpunkt aufzurufen, wird der folgende Fehler angezeigt:

```
{"message":"Missing Authentication Token"}
```

Das bedeutet, dass Sie versucht haben, eine Anfrage an die richtige Domain zu senden, aber die URI ist nicht erkennbar. Um dieses Problem zu beheben, überprüfen Sie die vollständige URL und aktualisieren Sie den **curl** Befehl mit der richtigen URL.

## Warnmeldungen
<a name="sam-cli-troubleshoot-warning"></a>

### Warnung:... AWS wird das Homebrew Installationsprogramm für AWS SAM ... nicht mehr verwalten
<a name="sam-cli-troubleshoot-warning-homebrew"></a>

Bei der Installation AWS SAMCLI von Homebrew Using wird die folgende Warnmeldung angezeigt:

```
Warning: ... AWS will no longer maintain the Homebrew installer for AWS SAM (aws/tap/aws-sam-cli). 
				For AWS supported installations, use the first party installers ...
```

**Mögliche Ursache: Der Homebrew Support wird nicht AWS mehr aufrechterhalten.**  
Ab September 2023 AWS wird das Homebrew Installationsprogramm für das nicht mehr gewartet AWS SAMCLI.  

**Lösung: Verwenden Sie eine AWS unterstützte Installationsmethode.**
+  AWS Unterstützte Installationsmethoden finden Sie unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md).

**Lösung: Verwenden Sie das von der Community verwaltete InstallationsprogrammHomebrew, um die Nutzung fortzusetzen.**
+ Sie können das von der Community verwaltete Homebrew Installationsprogramm nach eigenem Ermessen verwenden. Detaillierte Anweisungen finden Sie unter [Verwaltung des AWS SAMCLI mit Homebrew](manage-sam-cli-versions.md#manage-sam-cli-versions-homebrew).

# AWS SAM Steckverbinderreferenz
<a name="reference-sam-connector"></a>

Dieser Abschnitt enthält Referenzinformationen für den Connector-Ressourcentyp AWS Serverless Application Model (AWS SAM). Eine Einführung in Konnektoren finden Sie unter[Verwaltung von Ressourcenberechtigungen mit AWS SAM Konnektoren](managing-permissions-connectors.md).

## Unterstützte Quell- und Zielressourcentypen für Konnektoren
<a name="supported-connector-resource-types"></a>

Der `AWS::Serverless::Connector` Ressourcentyp unterstützt eine ausgewählte Anzahl von Verbindungen zwischen Quell- und Zielressourcen. Verwenden Sie bei der Konfiguration von Konnektoren in Ihrer AWS SAM Vorlage die folgende Tabelle, um auf unterstützte Verbindungen und die Eigenschaften zu verweisen, die für jeden Quell- und Zielressourcentyp definiert werden müssen. Weitere Informationen zur Konfiguration von Konnektoren in Ihrer Vorlage finden Sie unter[AWS::Serverless::Connector](sam-resource-connector.md).

Verwenden Sie die `Id` Eigenschaft sowohl für Quell- als auch für Zielressourcen, sofern sie in derselben Vorlage definiert sind. Optional `Qualifier` kann eine hinzugefügt werden, um den Umfang Ihrer definierten Ressource einzuschränken. Wenn sich die Ressource nicht in derselben Vorlage befindet, verwenden Sie eine Kombination unterstützter Eigenschaften.

 Um neue Verbindungen anzufordern, [reichen Sie ein neues Problem](https://github.com/aws/serverless-application-model/issues/new?assignees=&labels=area%2Fconnectors,stage%2Fneeds-triage&template=other.md&title=%28New%20Connector%20Profile%29) im *serverless-application-model AWS GitHubRepository* ein.


| Source type (Quellentyp) | Zieltyp | Berechtigungen | Eigenschaften der Quelle | Eigenschaften des Ziels | 
| --- | --- | --- | --- | --- | 
| `AWS::ApiGateway::RestApi` | `AWS::Lambda::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::ApiGateway::RestApi` | `AWS::Serverless::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Lambda::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::ApiGatewayV2::Api` | `AWS::Serverless::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Read` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::DynamoDB::Table` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Lambda::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Read` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::DataSource` | `AWS::Serverless::SimpleTable` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Lambda::Function` | `Write` | `Id`oder `ResourceId` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::AppSync::GraphQLApi` | `AWS::Serverless::Function` | `Write` | `Id`oder `ResourceId` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Lambda::Function` | `Read` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::DynamoDB::Table` | `AWS::Serverless::Function` | `Read` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::Events::Rule` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Events::Rule` | `AWS::Lambda::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Events::Rule` | `AWS::Serverless::StateMachine` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Events::Rule` | `AWS::SNS::Topic` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Events::Rule` | `AWS::SQS::Queue` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn``QueueUrl`, und `Type` | 
| `AWS::Events::Rule` | `AWS::StepFunctions::StateMachine` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Lambda::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Location::PlaceIndex` | `Read` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::Lambda::Function` | `AWS::SNS::Topic` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Lambda::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::S3::Bucket` | `AWS::Lambda::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::S3::Bucket` | `AWS::Serverless::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Api` | `AWS::Lambda::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Api` | `AWS::Serverless::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::Lambda::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::Serverless::Function` | `AWS::SNS::Topic` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::SQS::Queue` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::Function` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Lambda::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::HttpApi` | `AWS::Serverless::Function` | `Write` | `Id`oder `Qualifier``ResourceId`, und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Lambda::Function` | `Read` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::Serverless::SimpleTable` | `AWS::Serverless::Function` | `Read` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::Serverless::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::SNS::Topic` | `AWS::Lambda::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::SNS::Topic` | `AWS::Serverless::Function` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::SNS::Topic` | `AWS::SQS::Queue` | `Write` | `Id`oder `Arn` und `Type` | `Id`oder `Arn``QueueUrl`, und `Type` | 
| `AWS::SQS::Queue` | `AWS::Lambda::Function` | `Read`, `Write` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::SQS::Queue` | `AWS::Serverless::Function` | `Read`, `Write` | `Id`oder `Arn` und `Type` | `Id`oder `RoleName` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::DynamoDB::Table` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Events::EventBus` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Lambda::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::S3::Bucket` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::Function` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::SimpleTable` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::Serverless::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SNS::Topic` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::SQS::Queue` | `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn` und `Type` | 
| `AWS::StepFunctions::StateMachine` | `AWS::StepFunctions::StateMachine` | `Read`, `Write` | `Id`oder `RoleName` und `Type` | `Id`oder `Arn``Name`, und `Type` | 

## Von Konnektoren erstellte IAM-Richtlinien
<a name="reference-sam-connector-policies"></a>

In diesem Abschnitt werden die AWS Identity and Access Management (IAM-) Richtlinien dokumentiert, die AWS SAM bei der Verwendung von Connectoren erstellt werden.

`AWS::DynamoDB::Table` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:DescribeStream",
        "dynamodb:GetRecords",
        "dynamodb:GetShardIterator",
        "dynamodb:ListStreams"
      ],
      "Resource": [
        "%{Source.Arn}/stream/*"
      ]
    }
  ]
}
```

`AWS::Events::Rule` auf `AWS::SNS::Topic`  
**Art der Richtlinie**  
[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topicpolicy.html)angehängt an den`AWS::SNS::Topic`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sns:Publish",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Events::Rule` auf `AWS::Events::EventBus`  
**Art der Richtlinie**  
Der `AWS::Events::Rule` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` auf `AWS::StepFunctions::StateMachine`  
**Art der Richtlinie**  
Der `AWS::Events::Rule` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.   
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Events::Rule` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "events.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::Events::Rule` auf `AWS::SQS::Queue`  
**Art der Richtlinie**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)`angehängt an den`AWS::SQS::Queue`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "events.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::S3::Bucket`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::DynamoDB::Table`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::SQS::Queue`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage",
        "sqs:SendMessage",
        "sqs:ChangeMessageVisibility",
        "sqs:PurgeQueue"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::SNS::Topic`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::StepFunctions::StateMachine`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution",
        "states:StartSyncExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeStateMachine",
        "states:ListExecutions"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution",
        "states:DescribeStateMachineForExecution",
        "states:GetExecutionHistory"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::Events::EventBus`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::Lambda::Function` auf `AWS::Location::PlaceIndex`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "geo:DescribePlaceIndex",
        "geo:GetPlace",
        "geo:SearchPlaceIndexForPosition",
        "geo:SearchPlaceIndexForSuggestions",
        "geo:SearchPlaceIndexForText"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::ApiGatewayV2::Api` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::ApiGateway::RestApi` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "apigateway.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:execute-api:${AWS::Region}:${AWS::AccountId}:%{Source.ResourceId}/%{Source.Qualifier}"
}
```

`AWS::SNS::Topic` auf `AWS::SQS::Queue`  
**Art der Richtlinie**  
`[AWS::SQS::QueuePolicy](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sqs-queuepolicy.html)`angehängt an den`AWS::SQS::Queue`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "sns.amazonaws.com"
      },
      "Resource": "%{Destination.Arn}",
      "Action": "sqs:SendMessage",
      "Condition": {
        "ArnEquals": {
          "aws:SourceArn": "%{Source.Arn}"
        }
      }
    }
  ]
}
```

`AWS::SNS::Topic` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "sns.amazonaws.com",
  "SourceArn": "%{Source.Arn}"
}
```

`AWS::SQS::Queue` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
Der `AWS::Lambda::Function` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:DeleteMessage"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:ReceiveMessage",
        "sqs:GetQueueAttributes"
      ],
      "Resource": [
        "%{Source.Arn}"
      ]
    }
  ]
}
```

`AWS::S3::Bucket` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "s3.amazonaws.com",
  "SourceArn": "%{Source.Arn}",
  "SourceAccount": "${AWS::AccountId}"
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::SNS::Topic`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::SQS::Queue`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sqs:SendMessage"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::S3::Bucket`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:GetObjectAcl",
        "s3:GetObjectLegalHold",
        "s3:GetObjectRetention",
        "s3:GetObjectTorrent",
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAcl",
        "s3:GetObjectVersionForReplication",
        "s3:GetObjectVersionTorrent",
        "s3:ListBucket",
        "s3:ListBucketMultipartUploads",
        "s3:ListBucketVersions",
        "s3:ListMultipartUploadParts"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:AbortMultipartUpload",
        "s3:DeleteObject",
        "s3:DeleteObjectVersion",
        "s3:PutObject",
        "s3:PutObjectLegalHold",
        "s3:PutObjectRetention",
        "s3:RestoreObject"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::DynamoDB::Table`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::StepFunctions::StateMachine`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:DescribeExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:DescribeRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "states:StartExecution"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "states:StopExecution"
      ],
      "Resource": [
        "arn:${AWS::Partition}:states:${AWS::Region}:${AWS::AccountId}:execution:%{Destination.Name}:*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "events:PutTargets",
        "events:PutRule"
      ],
      "Resource": [
        "arn:${AWS::Partition}:events:${AWS::Region}:${AWS::AccountId}:rule/StepFunctionsGetEventsForStepFunctionsExecutionRule"
      ]
    }
  ]
}
```

`AWS::StepFunctions::StateMachine` auf `AWS::Events::EventBus`  
**Art der Richtlinie**  
Der `AWS::StepFunctions::StateMachine` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` auf `AWS::DynamoDB::Table`  
**Art der Richtlinie**  
Der `AWS::AppSync::DataSource` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Read`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:GetItem",
        "dynamodb:Query",
        "dynamodb:Scan",
        "dynamodb:BatchGetItem",
        "dynamodb:ConditionCheckItem",
        "dynamodb:PartiQLSelect"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "dynamodb:PutItem",
        "dynamodb:UpdateItem",
        "dynamodb:DeleteItem",
        "dynamodb:BatchWriteItem",
        "dynamodb:PartiQLDelete",
        "dynamodb:PartiQLInsert",
        "dynamodb:PartiQLUpdate"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}/index/*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
Der `AWS::AppSync::DataSource` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "lambda:InvokeAsync",
        "lambda:InvokeFunction"
      ],
      "Resource": [
        "%{Destination.Arn}",
        "%{Destination.Arn}:*"
      ]
    }
  ]
}
```

`AWS::AppSync::DataSource` auf `AWS::Events::EventBus`  
**Art der Richtlinie**  
Der `AWS::AppSync::DataSource` Rolle ist eine vom [Kunden verwaltete Richtlinie](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html) zugeordnet.  
**Zugriffskategorien**  
`Write`  

```
{
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "events:PutEvents"
      ],
      "Resource": [
        "%{Destination.Arn}"
      ]
    }
  ]
}
```

`AWS::AppSync::GraphQLApi` auf `AWS::Lambda::Function`  
**Art der Richtlinie**  
`[AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html)`angehängt an den`AWS::Lambda::Function`.  
**Zugriffskategorien**  
`Write`  

```
{
  "Action": "lambda:InvokeFunction",
  "Principal": "appsync.amazonaws.com",
  "SourceArn": "arn:${AWS::Partition}:appsync:${AWS::Region}:${AWS::AccountId}:apis/%{Source.ResourceId}"
}
```

# Installation von Docker zur Verwendung mit dem AWS SAMCLI
<a name="install-docker"></a>

Dockerist eine Anwendung, die Container auf Ihrem Computer ausführt. Mit AWS SAM kann eine lokale Umgebung bereitgestellt werdenDocker, die einem Container ähnelt, um Ihre serverlosen Anwendungen zu erstellen, zu testen und zu debuggen. AWS Lambda 

**Anmerkung**  
Dockerist nur erforderlich, um Ihre Anwendungen lokal zu testen und mithilfe dieser Option Bereitstellungspakete zu erstellen. `--use-container`

**Topics**
+ [

## Installation von Docker
](#install-docker-instructions)
+ [

## Nächste Schritte
](#install-docker-next-steps)

## Installation von Docker
<a name="install-docker-instructions"></a>

Folgen Sie diesen Anweisungen, um die Installation Docker auf Ihrem Betriebssystem durchzuführen.

### Linux
<a name="install-docker-instructions-linux"></a>

Docker ist auf vielen verschiedenen Betriebssystemen verfügbar, einschließlich der meisten modernen Linux-Distributionen wie CentOSDebian, und. Ubuntu Informationen zur Installation Docker auf Ihrem speziellen Betriebssystem finden Sie unter [Get Docker auf der Docker Docs-Website](https://docs.docker.com/get-docker/).

**Zur Installation Docker auf Amazon Linux 2 oder Amazon Linux 2023**

1. Aktualisieren Sie die installierten Pakete und den Cache der Paketverwaltung auf Ihrer Instance.

   ```
   $ sudo yum update -y
   ```

1. Installieren Sie das neueste Docker Community Edition-Paket.
   + Führen Sie für Amazon Linux 2 Folgendes aus:

     ```
     $ sudo amazon-linux-extras install docker
     ```
   + Führen Sie für Amazon Linux 2023 Folgendes aus:

     ```
     $ sudo yum install -y docker
     ```

1. Starten Sie den Service Docker.

   ```
   $ sudo service docker start
   ```

1. Fügen Sie der `docker` Gruppe das `ec2-user` hinzu, damit Sie Docker Befehle ausführen können, ohne zu verwenden**sudo**.

   ```
   $ sudo usermod -a -G docker ec2-user
   ```

1. Holen Sie sich die neuen `docker` Gruppenberechtigungen, indem Sie sich abmelden und erneut anmelden. Schließen Sie dazu Ihr aktuelles SSH-Terminalfenster und stellen Sie in einer neuen Instanz erneut eine Verbindung zu Ihrer Instance her. Ihre neue SSH-Sitzung sollte über die entsprechenden `docker` Gruppenberechtigungen verfügen.

1. Stellen Sie sicher, dass die Docker-Befehle ausführen `ec2-user` können, ohne sie zu verwenden. **sudo**

   ```
   $ docker ps
   ```

   Sie sollten die folgende Ausgabe sehen, die bestätigt, dass Docker installiert ist und läuft:

   ```
    CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
   ```

**Anmerkung**  
Um unter Linux Lambda-Funktionen mit einer anderen Befehlssatzarchitektur als Ihrem Host-Computer zu erstellen und auszuführen, müssen Sie zusätzliche Schritte konfigurierenDocker. Um beispielsweise `arm64` Funktionen auf einem `x86_64` Computer auszuführen, können Sie den folgenden Befehl ausführen, um den Docker Daemon zu konfigurieren:. `docker run --rm --privileged multiarch/qemu-user-static --reset -p yes`

Falls bei der Installation Probleme auftretenDocker, finden Sie weitere Informationen unter[Behebung von Installationsfehlern](install-sam-cli.md#sam-cli-troubleshoot-install). Oder lesen Sie auf der Docker Docs-Website den Abschnitt [zur Fehlerbehebung](https://docs.docker.com/engine/install/linux-postinstall/#troubleshooting) unter **Schritte nach der Installation für Linux**.

### macOS
<a name="install-docker-instructions-macos"></a>

**Anmerkung**  
DockerDesktop wird offiziell unterstützt, aber ab AWS SAMCLI Version 1.47.0 können Sie Alternativen verwenden, sofern diese die Runtime verwenden. Docker

1. Installieren Docker

   Das AWS SAMCLI unterstützt die Docker Ausführung auf macOS Sierra 10.12 oder höher. Informationen zur Installation finden Sie Docker unter [DockerDesktop für Mac installieren](https://docs.docker.com/docker-for-mac/install/) auf der Docker Docs-Website.

1. Konfigurieren Sie Ihre gemeinsam genutzten Laufwerke

   Das AWS SAMCLI setzt voraus, dass das Projektverzeichnis oder ein beliebiges übergeordnetes Verzeichnis in einem gemeinsam genutzten Laufwerk aufgeführt ist. Dies kann die gemeinsame Nutzung von Dateien erfordern. Weitere Informationen finden Sie in der *DockerDokumentation* unter dem Thema [Volume-Mount erfordert Dateifreigabe](https://docs.docker.com/desktop/troubleshoot-and-support/troubleshoot/topics/#volume-mounting-requires-file-sharing-for-any-project-directories-outside-of-home) zur Problembehebung.

1. Überprüfen der Installation

   Stellen Sie nach Docker der Installation sicher, dass es funktioniert. Stellen Sie außerdem sicher, dass Sie Docker Befehle von der Befehlszeile aus ausführen können (z. B.`docker ps`). Sie müssen keine Container installieren, abrufen oder abrufen — dies wird bei Bedarf automatisch AWS SAMCLI erledigt.

Falls bei der Installation Probleme auftretenDocker, finden Sie weitere Tipps zur Problembehebung auf der [Docs-Website im Abschnitt Problembehandlung und Diagnose](https://docs.docker.com/docker-for-mac/troubleshoot/). Docker

### Windows
<a name="install-docker-instructions-windows"></a>

**Anmerkung**  
AWS SAM unterstützt offiziell Docker Desktop. Ab AWS SAMCLI Version 1.47.0 können Sie jedoch Alternativen verwenden, sofern diese die Docker Runtime verwenden.

1. Installieren Docker.

   DockerDesktop unterstützt das neueste Windows-Betriebssystem. Für ältere Versionen von Windows ist die Docker Toolbox verfügbar. Wählen Sie Ihre Version von Windows für die richtigen Docker Installationsschritte:
   + Informationen zur Installation Docker für Windows 10 finden [Sie auf der Docker Docs-Website unter Docker Desktop für Windows installieren](https://docs.docker.com/docker-for-windows/install/).
   + Informationen zur Installation Docker für frühere Versionen von Windows finden Sie unter [The Docker Toolbox](https://github.com/docker-archive/toolbox) im Docker GitHub Toolbox-Repository.

1. Konfigurieren Sie Ihre gemeinsam genutzten Laufwerke.

   Das AWS SAMCLI setzt voraus, dass das Projektverzeichnis oder ein beliebiges übergeordnetes Verzeichnis in einem gemeinsam genutzten Laufwerk aufgeführt ist. In einigen Fällen müssen Sie Ihr Laufwerk teilen, Docker damit es ordnungsgemäß funktioniert.

1. Überprüfen Sie die Installation.

   Stellen Sie nach Docker der Installation sicher, dass es funktioniert. Stellen Sie außerdem sicher, dass Sie Docker Befehle von der Befehlszeile aus ausführen können (z. B.**docker ps**). Sie müssen keine Container installieren, abrufen oder abrufen — dies wird bei Bedarf automatisch AWS SAMCLI erledigt.

Falls bei der Installation Probleme auftretenDocker, finden Sie weitere Tipps zur Problembehebung auf der [Docs-Website im Abschnitt Problembehandlung und Diagnose](https://docs.docker.com/docker-for-mac/troubleshoot/). Docker

## Nächste Schritte
<a name="install-docker-next-steps"></a>

Informationen zur Installation von finden AWS SAMCLI Sie unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md).

# Installation Finch zur Verwendung mit der AWS SAM CLI
<a name="install-finch"></a>

Finch AWS ist ein Container-Entwicklungstool, das eine Alternative zu Docker MacOS- und Linux-Systemen bietet und besonders vorteilhaft ist. Weitere Informationen finden Sie unter [Finch unter GitHub](https://github.com/runfinch). Mit AWS SAM kann eine lokale Umgebung bereitgestellt werdenFinch, die einem Container AWS Lambda zum Erstellen, Testen und Debuggen Ihrer serverlosen Anwendungen ähnelt.

**Anmerkung**  
Sie müssen Finch Ihre Anwendungen lokal testen, Bereitstellungspakete mithilfe der `--use-container` Option erstellen und OCI-Image-Funktionen erstellen. Ab AWS SAM CLI-Version 1.145.0 unterstützt AWS SAM CLI Finch als alternative Container-Laufzeit zu. Docker

**Topics**
+ [

## Installation von Finch
](#install-finch-instructions)
+ [

## Konfiguration Finch mit AWS SAM CLI
](#install-finch-configuration)
+ [

## Die Installation wird überprüft
](#install-finch-verification)
+ [

## Stoppen von Finch
](#install-finch-stopping)
+ [

## Fehlerbehebung
](#install-finch-troubleshooting)
+ [

## Nächste Schritte
](#install-finch-next-steps)

## Installation von Finch
<a name="install-finch-instructions"></a>

Folgen Sie diesen Anweisungen, um die Installation Finch auf Ihrem Betriebssystem durchzuführen.

### Voraussetzungen
<a name="install-finch-prerequisites"></a>

**Anmerkung**  
FinchDie Integration in AWS SAM CLI ist auf macOS- und Linux-Systemen verfügbar. Windows-Benutzer sollten aus Finch Funktionsgründen die Verwendung einer virtuellen Maschine oder einer Linux-Umgebung in Betracht ziehen.

**macOS-Versionen:**
+ macOS 15 Sequoia
+ macOS 14 Sonoma

**Anmerkung**  
Finchunterstützt die neuesten beiden Versionen von macOS.

**Linux:**
+ Linux Kernel v4.x \$1

### Finch installieren
<a name="install-finch"></a>

#### macOS
<a name="install-finch-instructions-macos"></a>

**Installieren Sie Finch unter macOS wie folgt**

1. Installieren Sie Finch mit der `brew` CLI. Wenn Sie dazu aufgefordert werden, geben Sie Ihr macOS-Passwort ein.

   ```
   $ brew install finch
   ```

1. Überprüfen Sie die installierte Finch Version.

   ```
   $ finch --version
   ```

1. Initialisieren Sie die Finch virtuelle Maschine (Erstinstallation).

   ```
   $ finch vm init
   ```

1. Starten Sie die Finch virtuelle Maschine.

   ```
   $ finch vm start
   ```

1. Überprüfen Sie den Status der Finch virtuellen Maschine.

   ```
   $ finch vm status
   ```

1. Stellen Sie sicher, dass das korrekt Finch läuft.

   ```
   $ finch --info
   $ finch ps
   ```

Weitere Informationen finden Sie unter [Finch auf macOS installieren](https://runfinch.com/docs/managing-finch/macos/installation/).

#### Linux
<a name="install-finch-instructions-linux"></a>

Sie können die Installation Finch unter Amazon Linux, Ubuntu oder mithilfe einer generischen Installationsmethode durchführen. Weitere Informationen finden Sie unter [Finch unter Linux installieren](https://runfinch.com/docs/managing-finch/linux/installation/).

## Konfiguration Finch mit AWS SAM CLI
<a name="install-finch-configuration"></a>

Nach der Installation Finch erkennt die AWS SAM CLI automatisch und verwendet Finch sie als Container-Runtime, wenn sie Docker nicht ausgeführt wird.

**Anmerkung**  
Finchdient als Fallback fürDocker. Wenn Sie beide Finch installiert haben Docker und ausgeführt werden, priorisiert AWS SAM CLI Docker standardmäßig.

### Konfiguration der Administratoreinstellungen (macOS)
<a name="install-finch-configuration-preference"></a>

Sie können AWS SAM CLI so konfigurieren, dass eine bestimmte Container-Laufzeit als Standard verwendet wird, indem Sie eine Administrator-Einstellungsdatei erstellen. Diese systemweite Einstellung setzt das standardmäßige Fallback-Verhalten außer Kraft.

**Verfügbare Konfigurationsoptionen**
+ **FinchAls bevorzugte Container-Laufzeit festlegen:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string finch" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **DockerAls bevorzugte Container-Laufzeit festlegen:**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Add :DefaultContainerRuntime string docker" /Library/Preferences/com.amazon.samcli.plist
  ```
+ **Einstellung entfernen (zum Standardverhalten zurückkehren):**

  ```
  $ sudo /usr/libexec/PlistBuddy -c "Remove :DefaultContainerRuntime" /Library/Preferences/com.amazon.samcli.plist
  ```

**Anmerkung**  
Wenn keine Administratoreinstellung festgelegt ist, verwendet AWS SAM CLI Docker standardmäßig, sofern verfügbar, und Finch als Fallback, wenn sie nicht ausgeführt Docker wird.

### Unterschiede beim Einhängen von Verzeichnissen (macOS)
<a name="install-finch-differences"></a>

Unter macOS schlagen AWS SAM lokale Befehle fehl, wenn Sie Ihr Projekt außerhalb Ihres Home-Verzeichnisses (`~`) oder suchen`/Volumes`. Dieses Design schränkt das automatische Einbinden von Verzeichnissen aus Sicherheitsgründen ohne Ihr Wissen ein.

**Optionen zur Schadensbegrenzung**
+ **Option 1:** Öffnen Sie die Finch-Konfiguration in einem Texteditor `~/.finch/finch.yaml` und fügen Sie Ihren Projektpfad unter dem `additional_directories` Abschnitt hinzu. Starten Sie dann die Finch virtuelle Maschine neu. Weitere Informationen finden Sie in der [Finch-Dokumentation](https://runfinch.com/docs/managing-finch/macos/disk-management/#adding-additional-disk-mounts).

  ```
  $ finch vm stop
  $ finch vm start
  ```
+ **Option 2:** Verschieben Sie Ihr Projekt in Ihr Home-Verzeichnis.

## Die Installation wird überprüft
<a name="install-finch-verification"></a>

Stellen Sie nach der Installation und dem Start sicherFinch, dass es mit AWS SAM CLI funktioniert.

### Grundlegende Überprüfung
<a name="install-finch-verification-basic"></a>

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob AWS SAM CLI Folgendes verwenden kannFinch:

```
$ sam build --use-container
```

Sie sollten sehen, wie AWS SAM CLI verwendet wirdFinch, um Ihre Anwendung in einer Containerumgebung zu erstellen.

**Anmerkung**  
Finchdient als Ausweichlösung fürDocker. Wenn ausgeführt Docker wird, priorisiert AWS SAM CLI Docker standardmäßig.

### Testen Finch als Fallback
<a name="install-finch-verification-fallback"></a>

Um Finch als Fallback zu testen, wenn Docker es läuft, müssen Sie zuerst aufhörenDocker.

**Um die Finch Fallback-Funktionalität zu testen**

1. DockerVerwenden Sie nicht mehr die entsprechenden Befehle für Ihr Betriebssystem.

   **macOS:**

   ```
   $ docker stop $(docker ps -q)
   $ pkill -f "Docker Desktop"
   ```

   Verify Docker wurde gestoppt.

   ```
   $ docker ps
   ```

   **Linux:**

   ```
   $ docker stop $(docker ps -q)
   $ sudo systemctl stop docker
   ```

   Verify Docker wurde gestoppt.

   ```
   $ sudo systemctl status docker
   ```

1. Führen Sie den `sam build --use-container` Befehl aus, um zu überprüfen, ob AWS SAM CLI ihn automatisch Finch als Fallback verwendet.

## Stoppen von Finch
<a name="install-finch-stopping"></a>

Wenn Sie den Vorgang beenden müssenFinch, verwenden Sie die folgenden Befehle:

**macOS:**

```
$ finch vm stop
$ sudo pkill -f finch
```

Verify Finch wurde gestoppt.

```
$ finch vm status
```

**Linux:**

```
$ sudo systemctl stop finch
$ sudo pkill -f finch
```

Verify Finch wurde gestoppt.

```
$ sudo systemctl status finch
```

## Fehlerbehebung
<a name="install-finch-troubleshooting"></a>

Wenn Sie auf Probleme stoßen mitFinch:
+ Stellen Sie sicher, dass Ihr Betriebssystem die Voraussetzungen erfüllt.
+ Stellen Sie sicher, dass Sie die Virtualisierung auf Ihrem System aktiviert haben.
+ Stellen Sie für macOS sicher, dass Sie über ausreichend Festplattenspeicher für die virtuelle Maschine verfügen.
+ Stellen Sie für Linux sicher, dass Sie über die erforderlichen Berechtigungen zum Ausführen von `systemctl` Befehlen verfügen.
+ Wenn Sie beim Übertragen von Images mit mehreren Architekturen an Amazon Elastic Container Registry (Amazon ECR) CloudFormation Bereitstellungsfehler mit der Fehlermeldung „Medientyp nicht unterstützt“ feststellen, erstellen Sie ein einzelnes Image-Artefakt, anstatt Images mit mehreren Architekturen zu verwenden. Dies liegt daran, Finch dass sowohl der Bildindex als auch das Bild an Amazon ECR übertragen werden, während nur das Docker Bild übertragen wird.
+ Wenn plattformübergreifendes Erstellen fehlschlägt, weil die Architektur der Zielfunktion nicht mit der Architektur des Host-Computers unter Linux übereinstimmt, aktivieren Sie die plattformübergreifende Emulation, indem Sie Folgendes ausführen. `sudo finch run --privileged --rm tonistiigi/binfmt:master --install all`

Weitere Informationen zur Fehlerbehebung finden Sie in der [Finch-Dokumentation](https://runfinch.com/docs/) oder im. [AWS SAMCLIProblembehandlung](sam-cli-troubleshooting.md)

## Nächste Schritte
<a name="install-finch-next-steps"></a>

Nachdem Sie es Finch installiert haben, können Sie es mit AWS SAM CLI verwenden, um:
+ Erstellen Sie serverlose Anwendungen mithilfe von Containern mit`sam build --use-container`. Weitere Informationen finden Sie unter [sam build](sam-cli-command-reference-sam-build.md).
+ Testen Sie Lambda-Funktionen lokal mit`sam local invoke`. Weitere Informationen finden Sie unter [sam local invoke](sam-cli-command-reference-sam-local-invoke.md).
+ Starten Sie ein lokales API Gateway mit`sam local start-api`. Weitere Informationen finden Sie unter [sam local start-api](sam-cli-command-reference-sam-local-start-api.md).
+ Starten Sie einen lokalen Lambda-Endpunkt mit`sam local start-lambda`. Weitere Informationen finden Sie unter [sam local start-lambda](sam-cli-command-reference-sam-local-start-lambda.md).

Weitere Informationen zur Verwendung von AWS SAM CLI mit Containern finden Sie unter[Standardbuild mit AWS SAM](serverless-sam-cli-using-build.md).

# Bild-Repositorys für AWS SAM
<a name="serverless-image-repositories"></a>

AWS SAM vereinfacht Aufgaben im Bereich Continuous Integration und Continuous Delivery (CI/CD) für serverlose Anwendungen mithilfe von Build-Container-Images. Zu den AWS SAM bereitgestellten Images gehören die AWS SAM Befehlszeilenschnittstelle (CLI) und Build-Tools für eine Reihe unterstützter AWS Lambda Laufzeiten. Dies macht es einfacher, serverlose Anwendungen mit dem zu erstellen und zu paketieren. AWS SAMCLI Sie können diese Images mit CI/CD Systemen verwenden, um die Erstellung und Bereitstellung von AWS SAM Anwendungen zu automatisieren. Beispiele finden Sie unter [Bereitstellen mit CI/CD Systemen und Pipelines](deploying-options.md#serverless-deploying-ci-cd).

AWS SAM Build-Container-Images URIs sind mit der Version des in diesem Image AWS SAMCLI enthaltenen Images gekennzeichnet. Wenn Sie den URI ohne Tags angeben, wird die neueste Version verwendet. `public.ecr.aws/sam/build-nodejs20.x`Verwendet beispielsweise das neueste Bild. `public.ecr.aws/sam/build-nodejs20.x:1.24.1`Verwendet jedoch das Image, das die AWS SAM CLI-Version 1.24.1 enthält.

Ab Version 1.33.0 von sind sowohl `arm64` Container-Images als `x86_64` auch für unterstützte Laufzeiten verfügbar. AWS SAMCLI Weitere Informationen finden Sie unter [Lambda-Laufzeiten](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html) im *AWS Lambda Developer* Guide.

**Anmerkung**  
Vor Version 1.22.0 von DockerHub war das Standard-Repository AWS SAMCLI, aus dem das Container-Image AWS SAMCLI abgerufen wurde. Ab Version 1.22.0 wurde das Standard-Repository in Amazon Elastic Container Registry Public (Amazon ECR Public) geändert. Um ein Container-Image aus einem anderen Repository als dem aktuellen Standard-Repository abzurufen, können Sie den **[sam build](sam-cli-command-reference-sam-build.md)** Befehl mit der **--build-image** Option verwenden. Die Beispiele am Ende dieses Themas zeigen, wie Anwendungen mithilfe von DockerHub Repository-Images erstellt werden.

## Bild-Repository URIs
<a name="serverless-image-repository-uris"></a>

In der folgenden Tabelle sind die URIs [Amazon ECR Public](https://docs.aws.amazon.com/AmazonECR/latest/public/what-is-ecr.html) Build-Container-Images aufgeführt, mit denen Sie serverlose Anwendungen erstellen und verpacken können. AWS SAM

**Anmerkung**  
Amazon ECR Public wurde DockerHub ab AWS SAMCLI Version 1.22.0 ersetzt. Wenn Sie eine frühere Version von verwenden, empfehlen wir Ihnen AWS SAMCLI, ein Upgrade durchzuführen.


| Laufzeit |  Amazon ECR Public | 
| --- | --- | 
| Benutzerdefinierte Laufzeit (AL2023) | [public.ecr. aws/sam/build- bereitgestellt.al2023](https://gallery.ecr.aws/sam/build-provided.al2023) | 
| Benutzerdefinierte Laufzeit (AL2) | [public.ecr. aws/sam/build-bereitgestellt.al2](https://gallery.ecr.aws/sam/build-provided.al2) | 
| Benutzerdefinierte Laufzeit | [public.ecr. aws/sam/build-bereitgestellt](https://gallery.ecr.aws/sam/build-provided) | 
| Java 25 | [public.ecr. aws/sam/build-java 25](https://gallery.ecr.aws/sam/build-java25) | 
| Java 21 | [public.ecr. aws/sam/build-java 21](https://gallery.ecr.aws/sam/build-java21) | 
| Java 17 | [public.ecr. aws/sam/build-java17](https://gallery.ecr.aws/sam/build-java17) | 
| Java 11 | [public.ecr. aws/sam/build-java11](https://gallery.ecr.aws/sam/build-java11) | 
| Java 8 | [public.ecr. aws/sam/build-Java 8](https://gallery.ecr.aws/sam/build-java8) | 
| .NET 9 | [public.ecr. aws/sam/build-dotnet9](https://gallery.ecr.aws/sam/build-dotnet9) | 
| .NET 8 | [public.ecr. aws/sam/build-dotnet8](https://gallery.ecr.aws/sam/build-dotnet8) | 
| .NET 7 | [public.ecr. aws/sam/build-dotnet7](https://gallery.ecr.aws/sam/build-dotnet7) | 
| .NET 6 | [public.ecr. aws/sam/build-dotnet6](https://gallery.ecr.aws/sam/build-dotnet6) | 
| Node.js 24 | [public.ecr. aws/sam/build-nodejs24.x](https://gallery.ecr.aws/sam/build-nodejs24.x) | 
| Node.js 22 | [public.ecr. aws/sam/build-nodejs22.x](https://gallery.ecr.aws/sam/build-nodejs22.x) | 
| Node.js 20 | [public.ecr. aws/sam/build-nodejs20.x](https://gallery.ecr.aws/sam/build-nodejs20.x) | 
| Node.js 18 | [public.ecr. aws/sam/build-nodejs18.x](https://gallery.ecr.aws/sam/build-nodejs18.x) | 
| Node.js 16 | [public.ecr. aws/sam/build-nodejs16.x](https://gallery.ecr.aws/sam/build-nodejs16.x) | 
| Python 3.14 | [public.ecr. aws/sam/build-Python3.14](https://gallery.ecr.aws/sam/build-python3.14) | 
| Python 3.13 | [public.ecr. aws/sam/build-Python3.13](https://gallery.ecr.aws/sam/build-python3.13) | 
| Python 3.12 | [public.ecr. aws/sam/build-Python3.12](https://gallery.ecr.aws/sam/build-python3.12) | 
| Python 3.11 | [public.ecr. aws/sam/build-Python3.11](https://gallery.ecr.aws/sam/build-python3.11) | 
| Python 3.10 | [public.ecr. aws/sam/build-Python3.10](https://gallery.ecr.aws/sam/build-python3.10) | 
| Python 3.9 | [public.ecr. aws/sam/build-Python3,9](https://gallery.ecr.aws/sam/build-python3.9) | 
| Python 3.8 | [public.ecr. aws/sam/build-Python3,8](https://gallery.ecr.aws/sam/build-python3.8) | 
| Rubin 3.4 | [public.ecr. aws/sam/build- Rubin 3.4](https://gallery.ecr.aws/sam/build-ruby3.4) | 
| Ruby 3.3 | [public.ecr. aws/sam/build- Ruby 3.3](https://gallery.ecr.aws/sam/build-ruby3.3) | 
| Ruby 3.2 | [public.ecr. aws/sam/build- Ruby 3.2](https://gallery.ecr.aws/sam/build-ruby3.2) | 

## Beispiele
<a name="serverless-image-repository-example-commands"></a>

Die folgenden zwei Beispielbefehle erstellen Anwendungen mithilfe von Container-Images aus dem Image-Repository:

**Erstellen Sie eine Node.js 24 Anwendung mit einem Container-Image, das aus Amazon ECR abgerufen wurde**:

```
$ sam build --use-container --build-image public.ecr.aws/sam/build-nodejs24.x
```

**Erstellen Sie eine Funktionsressource mit dem Python 3.14 Container-Image aus Amazon ECR**:

```
$ sam build --use-container --build-image Function1=public.ecr.aws/sam/build-python3.14
```

# Schrittweise Bereitstellung serverloser Anwendungen mit AWS SAM
<a name="automating-updates-to-serverless-apps"></a>

AWS Serverless Application Model (AWS SAM) ist integriert [CodeDeploy](https://docs.aws.amazon.com/codedeploy/latest/userguide/welcome.html), um schrittweise AWS Lambda Bereitstellungen zu ermöglichen. AWS SAM Erledigt mit nur wenigen Konfigurationszeilen Folgendes für Sie:
+ Stellt neue Versionen Ihrer Lambda-Funktion bereit und erstellt automatisch Aliase, die auf die neue Version verweisen.
+ Leitet den Kundenverkehr schrittweise auf die neue Version um, bis Sie davon überzeugt sind, dass sie wie erwartet funktioniert. Wenn ein Update nicht ordnungsgemäß funktioniert, können Sie die Änderungen rückgängig machen.
+ Definiert Testfunktionen vor und nach dem Datenverkehr, um zu überprüfen, ob der neu bereitgestellte Code korrekt konfiguriert ist und ob Ihre Anwendung erwartungsgemäß funktioniert.
+ Macht die Bereitstellung automatisch rückgängig, wenn CloudWatch Alarme ausgelöst werden.

**Anmerkung**  
Wenn Sie schrittweise Bereitstellungen über Ihre AWS SAM Vorlage aktivieren, wird automatisch eine CodeDeploy Ressource für Sie erstellt. Sie können die CodeDeploy Ressource direkt über die AWS-Managementkonsole anzeigen.

**Beispiel**

Das folgende Beispiel zeigt die Verwendung von CodeDeploy , um Kunden schrittweise auf Ihre neu bereitgestellte Version der Lambda-Funktion umzustellen:

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before & after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

Diese Überarbeitungen der AWS SAM Vorlage haben folgende Auswirkungen:
+ `AutoPublishAlias`: Durch Hinzufügen dieser Eigenschaft und Angabe eines Aliasnamens: AWS SAM
  + Erkennt, wenn neuer Code bereitgestellt wird, basierend auf Änderungen an der Amazon S3 S3-URI der Lambda-Funktion.
  + Erstellt und veröffentlicht eine aktualisierte Version dieser Funktion mit dem neuesten Code.
  + Erstellt einen Alias mit einem von Ihnen angegebenen Namen (sofern nicht bereits ein Alias vorhanden ist) und verweist auf die aktualisierte Version der Lambda-Funktion. Funktionsaufrufe sollten den Alias-Qualifizierer verwenden, um dies zu nutzen. Wenn Sie mit der Versionierung und Aliasnamen von Lambda-Funktionen nicht vertraut sind, finden Sie weitere Informationen unter [AWS Lambda Funktionsversionierung](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html) und Aliase.
+ `Deployment Preference Type`: Im vorherigen Beispiel werden 10 Prozent Ihres Kundenverkehrs sofort auf Ihre neue Version umgestellt. Nach 10 Minuten wird der gesamte Verkehr auf die neue Version umgestellt. Wenn Ihre Tests vor oder nach dem Datenverkehr jedoch fehlschlagen oder wenn ein CloudWatch Alarm ausgelöst wird, wird Ihre Bereitstellung CodeDeploy zurückgesetzt. Sie können auf folgende Weise angeben, wie der Datenverkehr zwischen den Versionen verlagert werden soll:
  + `Canary`: Der Datenverkehr wird in zwei Inkrementen verschoben. Sie können aus vordefinierten Canary-Optionen wählen. Die Optionen geben den Prozentsatz des Datenverkehrs an, der im ersten Schritt auf Ihre aktualisierte Lambda-Funktionsversion umgestellt wurde, und das Intervall in Minuten, bevor der verbleibende Verkehr in der zweiten Stufe verschoben wird. 
  + `Linear`: Der Datenverkehr wird in gleichmäßigen Inkrementen um die gleiche Anzahl von Minuten zwischen den einzelnen Inkrementen verschoben. Sie können aus vordefinierten linearen Optionen wählen, die den Prozentsatz des Datenverkehrs angeben, der in jedem Inkrement verschoben wird, und die Anzahl der Minuten zwischen den einzelnen Schritten. 
  + `AllAtOnce`: Der gesamte Datenverkehr wird gleichzeitig von der ursprünglichen Lambda-Funktion auf die aktualisierte Lambda-Funktionsversion umgestellt. 

  In der folgenden Tabelle sind weitere Optionen zur Verkehrsverlagerung aufgeführt, die über die im Beispiel verwendete hinaus verfügbar sind.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/serverless-application-model/latest/developerguide/automating-updates-to-serverless-apps.html)
+ `Alarms`: Dabei handelt es sich um CloudWatch Alarme, die durch alle Fehler ausgelöst werden, die bei der Bereitstellung ausgelöst wurden. Wenn sie auftreten, wird Ihre Bereitstellung automatisch rückgängig gemacht. Dies ist beispielsweise der Fall, wenn der aktualisierte Code, den Sie bereitstellen, Fehler in der Anwendung verursacht. Ein anderes Beispiel ist, wenn einige [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-functions-metrics.html)oder benutzerdefinierte CloudWatch Messwerte, die Sie angegeben haben, den Alarmschwellenwert überschritten haben.
+ `Hooks`: Dabei handelt es sich um Testfunktionen vor und nach dem Verkehr, die Prüfungen durchführen, bevor die Verkehrsverlagerung auf die neue Version beginnt und nachdem die Verkehrsverlagerung abgeschlossen ist.
  + `PreTraffic`: Ruft vor Beginn der Verkehrsverlagerung die CodeDeploy Lambda-Funktion Pre-Traffic Hook auf. Diese Lambda-Funktion muss zurückrufen CodeDeploy und deren Erfolg oder Misserfolg anzeigen. Wenn die Funktion fehlschlägt, wird sie abgebrochen und ein Fehler wird an gemeldet. CloudFormation Wenn die Funktion erfolgreich ist, wird mit der CodeDeploy Verkehrsverlagerung fortgefahren.
  + `PostTraffic`: Ruft nach Abschluss der Verkehrsverlagerung die CodeDeploy Lambda-Funktion nach dem Traffic Hook auf. Dies ähnelt dem Pre-Traffic-Hook, bei dem die Funktion erneut aufrufen muss, um einen Erfolg oder CodeDeploy Misserfolg zu melden. Verwenden Sie Post-Traffic-Hooks für Integrationstests oder andere Validierungsaktivitäten.

  Weitere Informationen finden Sie unter [SAM-Referenz für sichere Bereitstellungen](https://github.com/aws/serverless-application-model/blob/master/docs/safe_lambda_deployments.rst). 

## Schrittweise erstmalige Bereitstellung einer Lambda-Funktion
<a name="automating-updates-to-serverless-apps-first-time"></a>

 Bei der schrittweisen Bereitstellung einer Lambda-Funktion CodeDeploy ist eine zuvor bereitgestellte Funktionsversion erforderlich, von der der Datenverkehr verlagert werden soll. Daher sollte Ihre erste Bereitstellung in zwei Schritten durchgeführt werden: 
+ **Schritt 1**: Stellen Sie Ihre Lambda-Funktion bereit und erstellen Sie automatisch Aliase mit. `AutoPublishAlias`
+ **Schritt 2**: Führen Sie Ihre schrittweise Bereitstellung mit durch. `DeploymentPreference`

Wenn Sie Ihre erste schrittweise Bereitstellung in zwei Schritten durchführen, erhalten Sie CodeDeploy eine frühere Lambda-Funktionsversion, von der aus Sie den Datenverkehr verlagern können.

### Schritt 1: Stellen Sie Ihre Lambda-Funktion bereit
<a name="automating-updates-to-serverless-apps-first-time-step1"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live
```

### Schritt 2: Führen Sie Ihre schrittweise Bereitstellung durch
<a name="automating-updates-to-serverless-apps-first-time-step2"></a>

```
Resources:
MyLambdaFunction:
  Type: AWS::Serverless::Function
  Properties:
    Handler: index.handler
    Runtime: nodejs20.x
    CodeUri: s3://bucket/code.zip

    AutoPublishAlias: live

    DeploymentPreference:
      Type: Canary10Percent10Minutes 
      Alarms:
        # A list of alarms that you want to monitor
        - !Ref AliasErrorMetricGreaterThanZeroAlarm
        - !Ref LatestVersionErrorMetricGreaterThanZeroAlarm
      Hooks:
        # Validation Lambda functions that are run before and after traffic shifting
        PreTraffic: !Ref PreTrafficLambdaFunction
        PostTraffic: !Ref PostTrafficLambdaFunction
```

## Weitere Informationen
<a name="automating-updates-to-serverless-apps-learn"></a>

Ein praktisches Beispiel für die Konfiguration einer schrittweisen Bereitstellung finden Sie in [Modul 5 — Bereitstellungen auf Canary](https://s12d.com/sam-ws-en-canaries) in *The Complete AWS SAM Workshop*.

# Wichtige Referenzhinweise für AWS SAM
<a name="important-notes"></a>

Dieser Abschnitt enthält wichtige Hinweise und Ankündigungen für AWS Serverless Application Model (AWS SAM).

**Topics**
+ [

## Wichtige Hinweise für 2023
](#important-notes-2023)

## Wichtige Hinweise für 2023
<a name="important-notes-2023"></a>

### Oktober 2023
<a name="important-notes-2023-10"></a>

#### AWS SAMCLIEinstellung der Unterstützung für Python 3.7
<a name="important-notes-2023-10-python"></a>

*Veröffentlicht am 20.10.2023*

Python 3.7erhielt end-of-life den Status im Juni 2023. AWS SAM CLISie werden den Support für den Python 3.7 24. Oktober 2023 einstellen. Weitere Informationen finden Sie in der [Ankündigung](https://github.com/aws/aws-sam-cli/issues/5889) im *aws-sam-cli GitHubRepositorium*.

Diese Änderung wirkt sich auf die folgenden Benutzer aus:
+ Wenn Sie das AWS SAM CLI über verwenden Python 3.7 und installieren`pip`.
+ Wenn Sie das `aws-sam-cli` als Bibliothek verwenden und Ihre Anwendung damit erstellenPython 3.7.

Wenn Sie das AWS SAM CLI mit einer anderen Methode installieren und verwalten, sind Sie davon nicht betroffen.

Für betroffene Benutzer empfehlen wir, dass Sie Ihre Entwicklungsumgebung auf Python 3.8 oder eine neuere Version aktualisieren.

Diese Änderung hat keinen Einfluss auf die Unterstützung der Python 3.7 AWS Lambda Laufzeitumgebung. Weitere Informationen finden Sie unter [Runtime Deprecation Policy](https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtime-support-policy) im *AWS Lambda Developer* Guide.