Test des fonctions Lambda dans la console - AWS Lambda

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.

Test des fonctions Lambda dans la console

Vous pouvez tester votre fonction Lambda dans la console en invoquant votre fonction avec un événement de test. Un événement de test est une entrée JSON pour votre fonction. Si votre fonction ne nécessite pas d'entrée, l'événement peut être un document vide ({}).

Lorsque vous exécutez un test dans la console, Lambda invoque votre fonction de manière synchrone avec l'événement de test. L'exécution de la fonction convertit le JSON de l'événement en un objet et le transmet à la méthode du gestionnaire de votre code afin qu'il soit traité.

Créer un événement de test

Avant de pouvoir tester dans la console, vous devez créer un événement de test privé ou partageable.

Invocation de fonctions avec des événements de test

Pour tester une fonction
  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez le nom de la fonction que vous voulez tester.

  3. Choisissez l'onglet Test.

  4. Sous Test event (Événement de test), sélectionnez Create new event (Créer un nouvel événement) ou Edit saved event (Modifier un événement sauvegardé), puis sélectionnez l'événement sauvegardé que vous voulez utiliser.

  5. En option, choisissez un modèle pour le JSON de l'événement.

  6. Sélectionnez Tester).

  7. Pour examiner les résultats du test, sous Execution result (Résultat de l'exécution), développez Details (Détails).

Pour invoquer votre fonction sans enregistrer votre événement de test, choisissez Tester avant d'enregistrer. Cela crée un événement de test non sauvegardé que Lambda ne conserve que pour la durée de la session.

Vous pouvez également accéder à vos événements de test enregistrés et non enregistrés dans l'onglet Code. De là, choisissez Test (Tester), puis choisissez votre événement de test.

Création d'événements de test privés

Les événements de test privés sont disponibles uniquement pour le créateur de l'événement et ils ne nécessitent aucune autorisation supplémentaire pour être utilisés. Vous pouvez créer et enregistrer jusqu'à 10 événements de test privés par fonction.

Pour créer un événement de test privé
  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez le nom de la fonction que vous voulez tester.

  3. Choisissez l'onglet Test.

  4. Sous Test event (Événement de test), procédez comme suit :

    1. Choisissez un Template (Modèle).

    2. Saisissez un Name (Nom) pour le test.

    3. Dans la zone de saisie de texte, entrez l'événement de test JSON.

    4. Sous Event sharing settings (Paramètres de partage de l'événement), choisissez Private (Privé).

  5. Sélectionnez Enregistrer les modifications.

Vous pouvez également créer de nouveaux événements de test dans l'onglet Code. De là, choisissez Test, Configure test event (Configurer l'événement de test).

Création d'événements de test partageables

Les événements de test partageables sont des événements de test que vous pouvez partager avec d'autres utilisateurs dans le même compte AWS. Vous pouvez modifier les événements de test partageables des autres utilisateurs et invoquer votre fonction avec eux.

Lambda enregistre les événements de test partageables sous forme de schémas dans un registre de schémas Amazon EventBridge (CloudWatch Events) nommé. lambda-testevent-schemas Comme Lambda utilise ce registre pour stocker et appeler les événements de test partageables que vous créez, nous vous recommandons de ne pas modifier ce registre ou de créer un registre utilisant le nom lambda-testevent-schemas.

Pour consulter, partager et modifier des événements de test partageables, vous devez disposer d'autorisations pour toutes les opérations d'API de registre de schéma EventBridge (CloudWatch événements) suivantes :

Notez que l'enregistrement des modifications apportées à un événement de test partageable remplace cet événement.

Si vous ne pouvez pas créer, modifier ou consulter des événements de test partageables, vérifiez que votre compte dispose des autorisations requises pour ces opérations. Si vous disposez des autorisations requises mais que vous ne pouvez toujours pas accéder aux événements de test partageables, vérifiez s'il existe des politiques basées sur les ressources susceptibles de limiter l'accès au registre EventBridge (des CloudWatch événements).

Pour créer un événement de test partageable
  1. Ouvrez la page Functions (Fonctions) de la console Lambda.

  2. Choisissez le nom de la fonction que vous voulez tester.

  3. Choisissez l'onglet Test.

  4. Sous Test event (Événement de test), procédez comme suit :

    1. Choisissez un Template (Modèle).

    2. Saisissez un Name (Nom) pour le test.

    3. Dans la zone de saisie de texte, entrez l'événement de test JSON.

    4. Sous Event sharing settings (Paramètres de partage de l'événement), choisissez Shareable (Partageable).

  5. Choisissez Save changes (Enregistrer les modifications).

Utilisez des événements de test partageables avec AWS Serverless Application Model.

Vous pouvez utiliser AWS SAM pour invoquer des événements de test partageables. Pour en savoir plus, consultez sam remote test-event le Guide du développeur de AWS Serverless Application Model

Suppression des schémas d'événements de test partageables

Lorsque vous supprimez des événements de test partageables, Lambda les supprime du registre lambda-testevent-schemas. Si vous supprimez le dernier événement de test partageable du registre, Lambda supprime le registre.

Si vous supprimez la fonction, Lambda ne supprime pas les schémas d'événements de test partageables associés. Vous devez nettoyer ces ressources manuellement depuis la console EventBridge (CloudWatch Events).