Ajouter des déclencheurs à une fonction Lambda @Edge

Vous pouvez utiliser la AWS Lambda console ou la CloudFront console Amazon pour ajouter un déclencheur à votre fonction Lambda @Edge.

Important

Vous pouvez créer des déclencheurs uniquement pour les versions numérotées de votre fonction (pas le $ LATEST).

Lambda console

Pour ajouter des déclencheurs d'CloudFront événements à une fonction Lambda @Edge

1. Connectez-vous à la AWS Lambda console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lambda/.

2. Dans la liste des régions située en haut de la page, choisissez US East (N. Virginia) (USA Est (Virginie du Nord)).

3. Sur la page Fonctions, choisissez le nom de la fonction pour laquelle vous souhaitez ajouter des déclencheurs.

4. Sur la page d'aperçu des fonctions, choisissez l'onglet Versions.

5. Choisissez la version à laquelle vous souhaitez ajouter des déclencheurs.

   Une fois que vous avez choisi une version, le nom du bouton devient Version : $ LATEST ou Version : numéro de version.

6. Choisissez l'onglet Triggers (Déclencheurs).

7. Choisissez Add trigger (Ajouter déclencheur).

8. Pour la configuration du déclencheur, choisissez Sélectionner une sourcecloudfront, entrez, puis choisissez CloudFront.

   Note

   Si vous avez déjà créé un ou plusieurs déclencheurs, CloudFront c'est le service par défaut.

9. Spécifiez les valeurs suivantes pour indiquer le moment où vous voulez que la fonction Lambda s'exécute.

   1. Distribution : choisissez la distribution à laquelle vous souhaitez ajouter le déclencheur.

   2. Comportement du cache : choisissez le comportement du cache qui spécifie les objets sur lesquels vous souhaitez exécuter la fonction.

      Note

      Si vous spécifiez * pour le comportement de cache, la fonction Lambda se déploie sur le comportement de cache par défaut.

   3. CloudFront event — Choisissez l'CloudFront événement à l'origine de l'exécution de la fonction.

   4. Inclure le corps : cochez cette case si vous souhaitez accéder au corps de la demande dans votre fonction.

   5. Confirmez le déploiement sur Lambda @Edge : cochez cette case pour AWS Lambda répliquer la fonction de manière globale. Régions AWS

10. Choisissez Ajouter.

    La fonction commence à traiter les demandes relatives aux CloudFront événements spécifiés lorsque la CloudFront distribution mise à jour est déployée. Pour déterminer si une distribution a été déployée, choisissez Distributions dans le panneau de navigation. Lorsqu'une distribution est déployée, la valeur de la colonne État de la distribution passe de Déploiement à la date et à l'heure du déploiement.

CloudFront console

Pour ajouter des déclencheurs d' CloudFront événements à une fonction Lambda @Edge

1. Obtenez ARN la fonction Lambda pour laquelle vous souhaitez ajouter des déclencheurs :

   1. Connectez-vous à la AWS Lambda console AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lambda/.

   2. Dans la liste des régions située en haut de la page, choisissez US East (N. Virginia) (USA Est (Virginie du Nord)).

   3. Dans la liste des fonctions, choisissez le nom de la fonction à laquelle vous voulez ajouter des déclencheurs.

   4. Sur la page d'aperçu des fonctions, cliquez sur l'onglet Versions, puis choisissez la version numérotée à laquelle vous souhaitez ajouter des déclencheurs.

   5. Cliquez sur le ARN bouton Copier pour le ARN copier dans votre presse-papiers. La fonction ARN for the Lambda ressemble à ceci :

      arn:aws:lambda:us-east-1:123456789012:function:TestFunction:2

      Le numéro à la fin (2 dans cet exemple) est le numéro de version de la fonction.

2. Ouvrez la CloudFront console à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

3. Dans la liste des distributions, choisissez l'ID de la distribution à laquelle vous voulez ajouter des déclencheurs.

4. Choisissez l'onglet Comportements.

5. Sélectionnez le comportement du cache auquel vous souhaitez ajouter des déclencheurs, puis choisissez Modifier.

6. Pour les associations de fonctions, dans la liste des types de fonctions, choisissez Lambda @Edge lorsque vous souhaitez que la fonction s'exécute : pour les demandes du lecteur, les réponses du lecteur, les demandes d'origine ou les réponses d'origine.

   Pour de plus amples informations, veuillez consulter Choisissez l'événement pour déclencher la fonction.

7. Dans la zone de texte FunctionARN/Name, collez ARN la fonction Lambda que vous souhaitez exécuter lorsque l'événement choisi se produit. Il s'agit de la valeur que vous avez copiée depuis la console Lambda.

8. Sélectionnez Inclure le corps si vous souhaitez accéder au corps de la demande dans votre fonction.

   Si vous souhaitez simplement remplacer le corps de la demande, vous n'avez pas besoin de sélectionner cette option.

9. Pour exécuter la même fonction pour d'autres types d'événements, répétez les étapes 6 et 7.

10. Sélectionnez Enregistrer les modifications.

11. Pour ajouter des déclencheurs à d'autres comportements de cache pour cette distribution, répétez les étapes 5 à 10.

    La fonction commence à traiter les demandes relatives aux CloudFront événements spécifiés lorsque la CloudFront distribution mise à jour est déployée. Pour déterminer si une distribution a été déployée, choisissez Distributions dans le panneau de navigation. Lorsqu'une distribution est déployée, la valeur de la colonne État de la distribution passe de Déploiement à l'heure et à la date du déploiement.