Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Cette page fournit des informations de référence pour la AWS Serverless Application Model commande Command Line Interface (AWS SAMCLI)`sam remote execution`.

Pour une introduction à la AWS SAMCLI, voir [Qu'est-ce que c'est AWS SAMCLI ?](what-is-sam-overview.md#what-is-sam-cli)

La `sam remote execution` commande vous permet de gérer et d'inspecter les exécutions de fonctions durables à distance exécutées dans AWS Lambda.

**Note**  
Ces commandes nécessitent l'accès aux AWS informations d'identification.

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

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

## Options
<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>
Affichez ce message et quittez.

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

`get`  <a name="sam-cli-command-reference-sam-remote-execution-subcommands-get"></a>
Découvrez les détails d'une exécution durable. Pour de plus amples informations, veuillez consulter [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>
Obtenez l'historique d'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [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>
Arrêtez l'exécution d'une fonction durable. Pour de plus amples informations, veuillez consulter [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>

Récupérez les détails de l'exécution d'une fonction durable spécifique à partir de AWS Lambda.

L'ARN d'exécution doit être au format renvoyé par Invoke ou se trouver dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

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

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

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-get-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Le nom de ressource Amazon (ARN) de la fonction durable à exécuter pour laquelle vous souhaitez obtenir des informations.

## Options
<a name="ref-sam-cli-remote-execution-get-options"></a>

`--format [summary|json]`  
Format de la sortie. Valeur par défaut : `summary`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-get-examples"></a>

Obtenez les détails de l'exécution avec le format de résumé par défaut :

```
$ 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'
```

Obtenez les détails de l'exécution au format JSON :

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

**Note**  
Vous devez vous assurer que les caractères de contrôle de l'ARN d'exécution `$` sont correctement échappés lorsque vous utilisez des commandes shell.

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

Récupérez l'historique d'exécution d'une fonction durable spécifique à partir de AWS Lambda.

L'ARN d'exécution doit être au format renvoyé par StartDurableExecution ou trouvé dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

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

```
$ sam remote execution history DURABLE_EXECUTION_ARN [OPTIONS]
```

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-history-arguments"></a>

`DURABLE_EXECUTION_ARN`  
Le nom de ressource Amazon (ARN) de la fonction durable dont vous souhaitez récupérer l'historique.

## Options
<a name="ref-sam-cli-remote-execution-history-options"></a>

`--format [table|json]`  
Format de la sortie. Valeur par défaut : `table`

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-history-examples"></a>

Obtenez l'historique des exécutions avec le format de tableau par défaut :

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

Obtenez l'historique des exécutions au format JSON :

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

Arrêtez l'exécution d'une fonction durable en cours d'exécution dans AWS Lambda.

L'ARN d'exécution doit être au format renvoyé StartDurableExecution ou trouvé dans les journaux d'exécution.

**Note**  
Cette commande nécessite l'accès aux AWS informations d'identification.

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

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

## Arguments obligatoires
<a name="ref-sam-cli-remote-execution-stop-arguments"></a>

`DURABLE_EXECUTION_ARN`  
L'Amazon Resource Name (ARN) de l'exécution de la fonction durable à arrêter.

## Options
<a name="ref-sam-cli-remote-execution-stop-options"></a>

`--error-message TEXT`  
Message d'erreur à associer à l'arrêt de l'exécution.

`--error-type TEXT`  
Type d'erreur à associer à l'arrêt de l'exécution.

`--error-data TEXT`  
Données d'erreur à associer à l'exécution arrêtée.

`--stack-trace TEXT`  
Empilez les entrées de suivi. Cette option peut être spécifiée plusieurs fois.

`--region TEXT`  
Définissez la AWS région du service (par exemple,`us-east-1`).

`--profile TEXT`  
Sélectionnez un profil spécifique dans votre fichier d'informations d'identification pour obtenir des AWS informations d'identification.

`--config-env TEXT`  
Nom de l'environnement spécifiant les valeurs des paramètres par défaut dans le fichier de configuration. Valeur par défaut : `default`

`--config-file TEXT`  
Fichier de configuration contenant les valeurs des paramètres par défaut. Valeur par défaut : `samconfig.toml`

`--save-params`  
Enregistrez les paramètres fournis via la ligne de commande dans le fichier de configuration.

`--beta-features / --no-beta-features`  
Activer/désactiver les fonctionnalités bêta.

`--debug`  
Activez la journalisation du débogage pour imprimer les messages de débogage générés par la AWS SAM CLI et afficher les horodatages.

`-h, --help`  
Affiche ce message, puis se ferme.

## Exemples
<a name="ref-sam-cli-remote-execution-stop-examples"></a>

Arrêtez l'exécution sans détails sur l'erreur :

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

Arrêtez l'exécution avec un message d'erreur et tapez :

```
$ 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"
```

Arrêtez l'exécution en indiquant tous les détails de l'erreur et en enregistrant la 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()"
```