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.

# 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
```