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.

Travailler avec les demandes et les réponses

Pour utiliser les requêtes et réponses Lambda @Edge, consultez les rubriques suivantes :

Utiliser les fonctions Lambda @Edge avec le basculement d'origine

Vous pouvez utiliser les fonctions Lambda @Edge avec des CloudFront distributions que vous avez configurées avec des groupes d'origine, par exemple, pour le basculement d'origine que vous configurez afin de garantir 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érer des HTTP réponses dans les déclencheurs de demande

Lorsque CloudFront vous recevez une demande, vous pouvez utiliser une fonction Lambda pour générer une HTTP réponse qui est CloudFront renvoyée directement au visualiseur sans transmettre la réponse à l'origine. La génération de HTTP réponses réduit la charge sur l'origine et réduit généralement le temps de latence pour le spectateur.

Parmi les scénarios courants de génération de HTTP réponses, citons les suivants :

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

Pour voir un exemple de code permettant de générer HTTP des réponses, voirExemples de fonctions Lambda@Edge. Vous pouvez également remplacer les HTTP réponses dans les déclencheurs de réponse. Pour de plus amples informations, veuillez consulter Mettre à jour HTTP les réponses dans les déclencheurs de réponse d'origine.

Modèle de programmation

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

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

Les erreurs possibles associées HTTP aux réponses générées sont les suivantes.

Champs obligatoires

Le champ status est obligatoire.

Tous les autres champs sont facultatifs.

Mettre à jour HTTP les réponses dans les déclencheurs de réponse d'origine

Lorsque CloudFront vous recevez une HTTP réponse du serveur d'origine, si un déclencheur de réponse d'origine est associé au comportement du cache, vous pouvez modifier la HTTP réponse pour remplacer ce qui a été renvoyé par l'origine.

Parmi les scénarios courants de mise à jour HTTP des réponses, citons les suivants :

Vous pouvez également remplacer les HTTP réponses dans les événements de demande d'affichage et d'origine. Pour de plus amples informations, veuillez consulter Générer des HTTP réponses dans les déclencheurs de demande.

Lorsque vous travaillez sur la HTTP réponse, Lambda @Edge n'expose pas le corps renvoyé par le serveur d'origine au déclencheur origin-response. 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édez au corps de la demande en choisissant l'option Inclure le corps

Vous pouvez choisir que Lambda @Edge expose le corps dans une demande de HTTP méthodes inscriptibles (POST,, PUTDELETE, etc.), afin de pouvoir y accéder dans votre fonction 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 lorsque vous créez un CloudFront déclencheur pour votre fonction destiné à une demande d'utilisateur ou à un événement de demande d'origine. Pour de plus amples informations, veuillez consulter Ajouter des déclencheurs pour une fonction Lambda @Edge, ou pour en savoir plus sur l'utilisation de Include Body (Inclure le corps) avec votre fonction, veuillez consulter 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.