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 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)