Choisissez l'événement pour déclencher la fonction

Lorsque vous décidez quel CloudFront événement vous souhaitez utiliser pour déclencher une fonction Lambda, tenez compte des points suivants :

Je souhaite CloudFront mettre en cache des objets modifiés par une fonction Lambda

Pour mettre en cache un objet qui a été modifié par une fonction Lambda afin de CloudFront pouvoir le servir depuis l'emplacement périphérique lors de sa prochaine demande, utilisez l'événement de demande d'origine ou de réponse d'origine.

Cela réduit la charge sur l'origine, réduit la latence pour les demandes suivantes et réduit le coût de l'appel de Lambda@Edge sur les demandes suivantes.

Par exemple, si vous souhaitez ajouter, supprimer ou modifier les en-têtes des objets renvoyés par l'origine et que vous souhaitez CloudFront mettre le résultat en cache, utilisez l'événement de réponse d'origine.

Je veux que la fonction s'exécute pour chaque requête

Pour exécuter la fonction pour chaque demande CloudFront reçue pour la distribution, utilisez les événements de demande ou de réponse du lecteur.

Les événements de demande d'origine et de réponse d'origine se produisent uniquement lorsqu'un objet demandé n'est pas mis en cache dans un emplacement périphérique et CloudFront transmet une demande à l'origine.

Je veux que la fonction change la clé de cache

Pour modifier une valeur que vous utilisez comme base pour la mise en cache, utilisez l'événement Viewer request.

Par exemple, si une fonction modifie le URL pour inclure une abréviation de langue dans le chemin (par exemple, parce que l'utilisateur a choisi sa langue dans une liste déroulante), utilisez l'événement viewer request :

• URLdans la demande du visualiseur — https://example.com/en/ index.html

• URLlorsque la demande provient d'une adresse IP en Allemagne — https://example.com/de/ index.html

Vous utilisez également l'événement de demande utilisateur si vous mettez en cache en fonction des cookies ou des en-têtes de demande.

Note

Si la fonction modifie les cookies ou les en-têtes, configurez CloudFront pour transmettre la partie applicable de la demande à l'origine. Pour plus d’informations, consultez les rubriques suivantes :

• Contenu du cache basé sur les cookies

• Contenu du cache basé sur les en-têtes des demandes

La fonction affecte la réponse depuis l'origine

Pour modifier la demande de manière à affecter la réponse de l'origine, utilisez l'événement de demande d'origine.

En général, la plupart des événements de demande du visiteur ne sont pas transmis à l'origine. CloudFront répond à une demande avec un objet qui se trouve déjà dans le cache périphérique. Si la fonction modifie la demande en fonction d'un événement de demande d'origine, met en CloudFront cache la réponse à la demande d'origine modifiée.