Utilisation des demandes et des réponses

Pour utiliser les demandes et réponses Lambda@Edge, consultez les rubriques suivantes :

Utilisation des fonctions Lambda@Edge avec le basculement d’origine

Vous pouvez utiliser les fonctions Lambda@Edge avec les distributions CloudFront que vous avez configurées avec les groupes d'origine, par exemple, pour le basculement d'origine que vous configurez pour assurer une haute disponibilité. Pour utiliser une fonction Lambda avec un groupe d'origine, spécifiez la fonction dans une requête d'origine ou un déclencheur de réponse de l'origine pour un groupe d'origine lorsque vous créez le comportement de cache.

Pour plus d’informations, consultez les ressources suivantes :

Génération de réponses HTTP dans les déclencheurs de demande

Lorsque CloudFront reçoit une demande, vous pouvez utiliser une fonction Lambda pour générer une réponse HTTP que CloudFront renvoie directement à l'utilisateur sans transmettre la réponse à l'origine. La génération de réponses HTTP réduit la charge sur le serveur d'origine, et aussi généralement la latence pour l'utilisateur.

Les scénarios courants pour générer des réponses HTTP sont les suivants :

Une fonction Lambda@Edge peut générer une réponse HTTP lorsque les événements CloudFront suivants se produisent :

Pour voir un exemple de code permettant de générer des réponses HTTP, consultez Exemples de fonctions Lambda@Edge. Vous pouvez également remplacer les réponses HTTP dans les déclencheurs de réponse. Pour plus d’informations, consultez Mise à jour des réponses HTTP dans des déclencheurs de réponse de l’origine.

Modèle de programmation

Cette section décrit le modèle de programmation permettant d'utiliser Lambda@Edge pour générer des réponses HTTP.

Objet Réponse

La réponse que vous renvoyez en tant que paramètre result de la méthode callback doit avoir la structure suivante (notez que seul le champ status est requis).

const response = {
    body: 'content',
    bodyEncoding: 'text' | 'base64',
    headers: {
        'header name in lowercase': [{
            key: 'header name in standard case',
            value: 'header value'
         }],
         ...
    },
    status: 'HTTP status code (string)',
    statusDescription: 'status description'
};

L'objet de réponse peut inclure les valeurs suivantes :

Erreurs

Voici des erreurs possibles pour les réponses HTTP générées.

Champs obligatoires

Le champ status est obligatoire.

Tous les autres champs sont facultatifs.

Mise à jour des réponses HTTP dans des déclencheurs de réponse de l’origine

Lorsque CloudFront reçoit une réponse HTTP du serveur d'origine, si un déclencheur de réponse de l'origine est associé au comportement du cache, vous pouvez modifier la réponse HTTP pour remplacer celle renvoyée par l'origine.

Les scénarios courants pour mettre à jour des réponses HTTP sont les suivants :

Vous pouvez également remplacer les réponses HTTP dans les événements de requête utilisateur et à l'origine. Pour plus d’informations, consultez Génération de réponses HTTP dans les déclencheurs de demande.

Lorsque vous utilisez la réponse HTTP, Lambda@Edge n'expose pas le corps renvoyé par le serveur d'origine au déclencheur de réponse de l'origine. Vous pouvez générer un corps de contenu statique en lui attribuant la valeur souhaitée, ou supprimer le corps à l'intérieur de la fonction en définissant une valeur vide. Si vous n'actualisez pas le champ du corps dans votre fonction, le corps d'origine renvoyé par le serveur d'origine est renvoyé à l'utilisateur.

Accès au corps de requête en choisissant l’option Inclure le corps

Vous pouvez décider que Lambda@Edge expose le corps dans une demande pour des méthodes HTTP accessibles en écriture (POST, PUT, DELETE, etc.) afin que vous puissiez y accéder dans vos fonctions Lambda. Vous pouvez choisir un accès en lecture seule ou vous pouvez préciser que vous remplacerez le corps.

Pour activer cette option, choisissez Include Body (Inclure le corps) lorsque vous créez un déclencheur CloudFront pour votre fonction qui correspond à un pour un événement de demande utilisateur ou de demande d'origine. Pour plus d’informations, consultez Ajout de déclencheurs pour une fonction Lambda@Edge, ou pour en savoir plus sur l’utilisation de Include Body (Inclure le corps) avec votre fonction, consultez Structure d'événement Lambda@Edge.

Les scénarios lorsque vous êtes susceptibles de vouloir utiliser cette fonction incluent les éléments suivants :

Pour un exemple de code, consultez Exemples de fonctions Lambda@Edge.