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 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()"
```