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.
# Présentation des tests dans le cloud avec sam remote test-event
Utilisez la AWS Serverless Application Model commande Command Line Interface (AWS SAM CLI) `sam remote test-event` pour accéder aux événements de test partageables pour vos AWS Lambda fonctions et les gérer.
Pour en savoir plus sur les événements de test partageables, consultez la rubrique relative aux [événements de test partageables](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) dans le *Guide du développeur AWS Lambda *.
**Topics**
+ [
## Configurer l'CLI AWS SAM pour utiliser sam remote test-event
](#using-sam-cli-remote-test-event-setup)
+ [
## Utilisation de la commande sam remote test-event
](#using-sam-cli-remote-test-event-use)
+ [
## Utilisation des événements de test partageables
](#using-sam-cli-remote-test-event-invoke)
+ [
## Gestion des événements de test partageables
](#using-sam-cli-remote-test-event-manage)
## Conditions préalables
Pour utiliser `sam remote test-event`, installez la CLI AWS SAM en procédant comme suit :
+ [AWS SAM prérequis](prerequisites.md).
+ [Installer la CLI AWS SAM](install-sam-cli.md).
Si vous l'avez déjà AWS SAM CLI installé, nous vous recommandons de passer à la dernière version de la AWS SAMCLI version. Pour en savoir plus, veuillez consulter la section [Mise à niveau de la CLI AWS SAM en cours](manage-sam-cli-versions.md#manage-sam-cli-versions-upgrade).
Avant d'utiliser `sam remote test-event`, nous vous recommandons d'avoir des connaissances de base sur les points suivants :
+ [Configuration de la CLI AWS SAM](using-sam-cli-configure.md).
+ [Créez votre application dans AWS SAM](using-sam-cli-init.md).
+ [Initiation à la construction avec AWS SAM](using-sam-cli-build.md).
+ [Présentation du déploiement avec AWS SAM](using-sam-cli-deploy.md).
+ [Présentation de l'utilisation sam sync de la synchronisation avec AWS Cloud](using-sam-cli-sync.md).
## Configurer l'CLI AWS SAM pour utiliser sam remote test-event
Effectuez les étapes de configuration suivantes pour utiliser la AWS SAM CLI `sam remote test-event` commande :
1. **Configurez le AWS SAM CLI pour utiliser votre Compte AWS** — Les événements de test partageables pour Lambda sont accessibles et gérés par les utilisateurs de Lambda. Compte AWS Pour configurer le AWS SAM CLI afin d'utiliser votre Compte AWS, voir[Configuration de la CLI AWS SAM](using-sam-cli-configure.md).
1. **Configurer les autorisations pour les événements de test partageables** – Pour accéder aux événements de test partageables et les gérer, vous devez disposer des autorisations appropriées. Pour en savoir plus, consultez la rubrique relative aux [événements de test partageables](https://docs.aws.amazon.com/lambda/latest/dg/testing-functions.html#creating-shareable-events) dans le *Guide du développeur AWS Lambda *.
## Utilisation de la commande sam remote test-event
La AWS SAM CLI `sam remote test-event` commande fournit les sous-commandes suivantes que vous pouvez utiliser pour accéder à vos événements de test partageables et les gérer :
+ `delete`— Supprime un événement de test partageable du registre des EventBridge schémas Amazon.
+ `get`— Obtenez un événement de test partageable depuis le registre des EventBridge schémas.
+ `list`— Répertorie les événements de test partageables existants pour une fonction dans le registre des EventBridge schémas.
+ `put`— Enregistrez un événement depuis un fichier local dans le registre des EventBridge schémas.
Pour répertorier ces sous-commandes à l'aide du AWS SAM CLI, exécutez ce qui suit :
```
$ sam remote test-event --help
```
### Suppression d'événements de test partageables
Vous pouvez supprimer un événement de test partageable à l'aide de la sous-commande `delete` et en indiquant :
+ le nom de l'événement de test partageable à supprimer ;
+ un ID acceptable pour la fonction Lambda associée à l'événement ;
+ Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de AWS CloudFormation pile associé à la fonction Lambda.
Voici un exemple :
```
$ sam remote test-event delete HelloWorldFunction --stack-name sam-app --name demo-event
```
Pour obtenir la liste des options à utiliser avec la sous-commande `delete`, consultez [sam remote test-event delete](sam-cli-command-reference-remote-test-event-delete.md). Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :
```
$ sam remote test-event delete --help
```
### Obtention d'événements de test partageables
Vous pouvez obtenir un événement de test partageable à partir du registre des EventBridge schémas en utilisant la `get` sous-commande associée à ce qui suit :
+ le nom de l'événement de test partageable à obtenir ;
+ un ID acceptable pour la fonction Lambda associée à l'événement ;
+ Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de AWS CloudFormation pile associé à la fonction Lambda.
Voici un exemple qui permet d'obtenir un événement de test partageable nommé `demo-event` qui est associé à la fonction Lambda `HelloWorldFunction` de la pile `sam-app`. Cette commande imprime l'événement sur votre console.
```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event
```
Pour obtenir un événement de test partageable et l'enregistrer sur votre machine locale, utilisez l'option `--output-file` et fournissez un chemin et un nom de fichier. Voici un exemple d'enregistrement de `demo-event.json` comme `demo-event` dans le répertoire de travail actuel :
```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
```
Pour obtenir la liste des options à utiliser avec la sous-commande `get`, consultez [sam remote test-event get](sam-cli-command-reference-remote-test-event-get.md). Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :
```
$ sam remote test-event get --help
```
### Liste d'événements de test partageables
Vous pouvez répertorier tous les événements de test partageables pour une fonction Lambda spécifique à partir du registre de schémas. Utilisez la sous-commande `list` en indiquant :
+ un ID acceptable pour la fonction Lambda associée aux événements ;
+ Si vous fournissez l'ID logique de la fonction Lambda, vous devez également fournir le nom de CloudFormation pile associé à la fonction Lambda.
Voici un exemple qui permet d'obtenir une liste de tous les événements de test partageables associés à la fonction Lambda `HelloWorldFunction` de la pile `sam-app` :
```
$ sam remote test-event list HelloWorldFunction --stack-name sam-app
```
Pour obtenir la liste des options à utiliser avec la sous-commande `list`, consultez [sam remote test-event list](sam-cli-command-reference-remote-test-event-list.md). Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :
```
$ sam remote test-event list --help
```
### Enregistrement d'événements de test partageables
Vous pouvez enregistrer des événements de test partageables dans le registre des EventBridge schémas. Utilisez la sous-commande `put` en indiquant :
+ un ID acceptable pour la fonction Lambda associée à l'événement de test partageable ;
+ un nom d'événement de test partageable ;
+ le chemin du fichier et le nom de l'événement local à charger.
Voici un exemple qui enregistre l'événement local `demo-event.json` comme `demo-event` et qui l'associe à la fonction Lambda `HelloWorldFunction` de la pile `sam-app` :
```
$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json
```
Si un événement de test partageable portant le même nom existe dans le registre du EventBridge schéma, il ne le AWS SAM CLI remplacera pas. Pour le remplacer, ajoutez l'option `--force` à votre commande.
Pour obtenir la liste des options à utiliser avec la sous-commande `put`, consultez [sam remote test-event put](sam-cli-command-reference-remote-test-event-put.md). Vous pouvez également exécuter les opérations suivantes depuis AWS SAM CLI :
```
$ sam remote test-event put --help
```
## Utilisation des événements de test partageables
Utilisez des événements de test partageables pour tester vos fonctions Lambda dans AWS Cloud la commande. `sam remote invoke` Pour en savoir plus, veuillez consulter la section [Transmettre des événements de test partageables à une fonction Lambda dans le cloud](using-sam-cli-remote-invoke.md#using-sam-cli-remote-invoke-shareable).
## Gestion des événements de test partageables
Cette rubrique contient des exemples de gestion et d'utilisation d'événements de test partageables.
### Obtenir un événement de test partageable, le modifier et l'utiliser
Vous pouvez obtenir un événement de test partageable depuis le registre des EventBridge schémas, le modifier localement et utiliser l'événement de test local avec votre fonction Lambda dans le. AWS Cloud Voici un exemple :
1. **Récupérer l'événement de test partageable** – Utilisez la sous-commande `sam remote test-event get` pour récupérer un événement de test partageable pour une fonction Lambda spécifique et l’enregistrer localement :
```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
```
1. **Modifier l'événement de test partageable** – Utilisez l'éditeur de texte de votre choix pour modifier l'événement de test partageable.
1. **Utiliser l'événement de test partageable** – Utilisez la commande `sam remote invoke` et indiquez le chemin et le nom du fichier de l'événement avec `--event-file` :
```
$ sam remote invoke HelloWorldFunction --stack-name sam-app --event-file demo-event.json
```
### Obtenir un événement de test partageable, le modifier, le charger et l'utiliser
Vous pouvez obtenir un événement de test partageable à partir du registre des EventBridge schémas, le modifier localement et le télécharger. Vous pouvez ensuite transmettre l'événement de test partageable directement à votre fonction Lambda dans l' AWS Cloud. Voici un exemple :
1. **Récupérer l'événement de test partageable** – Utilisez la sous-commande `sam remote test-event get` pour récupérer un événement de test partageable pour une fonction Lambda spécifique et l’enregistrer localement :
```
$ sam remote test-event get HelloWorldFunction --stack-name sam-app --name demo-event --output-file demo-event.json
```
1. **Modifier l'événement de test partageable** – Utilisez l'éditeur de texte de votre choix pour modifier l'événement de test partageable.
1. **Télécharger l'événement de test partageable** : utilisez la `sam remote test-event put` sous-commande pour télécharger et enregistrer l'événement de test partageable dans le registre du EventBridge schéma. Dans cet exemple, nous utilisons l'option `--force` pour remplacer une ancienne version de notre test partageable :
```
$ sam remote test-event put HelloWorldFunction --stack-name sam-app --name demo-event --file demo-event.json --force
```
1. **Transmettre l'événement de test partageable à votre fonction Lambda** – Utilisez la commande `sam remote invoke` pour transmettre l'événement de test partageable directement à votre fonction Lambda dans l' AWS Cloud :
```
$ sam remote invoke HelloWorldFunction --stack-name sam-app --test-event-name demo-event
```