Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Arbeiten Sie mit Anfragen und Antworten

Informationen zur Verwendung von Lambda @Edge -Anfragen und -Antworten finden Sie in den folgenden Themen:

Verwenden Sie Lambda @Edge -Funktionen mit Origin-Failover

Sie können Lambda @Edge -Funktionen mit CloudFront Distributionen verwenden, die Sie mit Ursprungsgruppen eingerichtet haben, z. B. für Origin-Failover, das Sie konfigurieren, um eine hohe Verfügbarkeit sicherzustellen. Um eine Lambda-Funktion mit einer Ursprungsgruppe zu verwenden, geben Sie die Funktion in einem Ursprungsanfragen- oder Ursprungsantwort-Auslöser für eine Ursprungsgruppe an, wenn Sie das Zwischenspeicher-Verhalten erstellen.

Weitere Informationen finden Sie hier:

Generieren Sie HTTP Antworten in Anforderungsauslösern

Wenn Sie CloudFront eine Anfrage erhalten, können Sie eine Lambda-Funktion verwenden, um eine HTTP Antwort zu generieren, die direkt an den Betrachter CloudFront zurückkehrt, ohne die Antwort an den Ursprung weiterzuleiten. Durch das Generieren von HTTP Antworten wird die Belastung des Ursprungs reduziert und in der Regel auch die Latenz für den Betrachter verringert.

Zu den gängigen Szenarien für HTTP die Generierung von Antworten gehören die folgenden:

Eine Lambda @Edge -Funktion kann eine HTTP Antwort generieren, wenn die folgenden CloudFront Ereignisse eintreten:

Einen Beispielcode für die Generierung von HTTP Antworten finden Sie unterBeispielfunktionen für Lambda@Edge. Sie können die HTTP Antworten auch in Antwortauslösern ersetzen. Weitere Informationen finden Sie unter HTTPAntworten in den ursprünglichen Antwortauslösern aktualisieren.

Programmiermodell

In diesem Abschnitt wird das Programmiermodell für die Verwendung von Lambda @Edge zur Generierung von HTTP Antworten beschrieben.

Antwortobjekt

Die Antwort, die Sie als result-Parameter der callback-Methode zurückgeben, sollte folgenden Aufbau haben (beachten Sie, dass nur das status-Feld erforderlich ist).

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'
};

Das Antwortobjekt kann die folgenden Werte enthalten:

Fehler

Im Folgenden sind mögliche Fehler bei generierten HTTP Antworten aufgeführt.

Pflichtfelder

Das Feld status ist ein Pflichtfeld.

Alle anderen Felder sind optional.

HTTPAntworten in den ursprünglichen Antwortauslösern aktualisieren

Wenn eine HTTP Antwort vom Ursprungsserver CloudFront empfangen wird und ein Origin-Response-Trigger mit dem Cache-Verhalten verknüpft ist, können Sie die HTTP Antwort so ändern, dass die vom ursprünglichen Server zurückgegebenen Antworten außer Kraft gesetzt werden.

Zu den gängigen Szenarien für die Aktualisierung von HTTP Antworten gehören die folgenden:

Sie können die HTTP Antworten auch in den Ereignissen Viewer und Origin Request ersetzen. Weitere Informationen finden Sie unter Generieren Sie HTTP Antworten in Anforderungsauslösern.

Wenn Sie mit der HTTP Antwort arbeiten, macht Lambda @Edge den vom Ursprungsserver zurückgegebenen Text nicht dem Origin-Response-Trigger zugänglich. Sie können einen statischen Inhaltstext erzeugen, indem Sie ihn auf den gewünschten Wert setzen, oder den Text innerhalb der Funktion entfernen, indem Sie den Wert auf leer setzen. Wenn Sie das Textkörperfeld in Ihrer Funktion nicht aktualisieren, wird der ursprüngliche Textkörper, der vom Ursprungsserver zurückgegeben wird, an den Viewer zurückgegeben.

Greifen Sie auf den Anfragetext zu, indem Sie die Option „Text einschließen“ wählen

Sie können sich dafür entscheiden, dass Lambda @Edge den Hauptteil in einer Anfrage für beschreibbare HTTP Methoden (POST, PUTDELETE, usw.) verfügbar macht, sodass Sie in Ihrer Lambda-Funktion darauf zugreifen können. Sie können den Lesezugriff wählen oder angeben, dass Sie den Textkörper ersetzen möchten.

Um diese Option zu aktivieren, wählen Sie „Text einbeziehen“, wenn Sie einen CloudFront Trigger für Ihre Funktion erstellen, der für eine Viewer-Anfrage oder ein Origin-Request-Ereignis bestimmt ist. Weitere Informationen finden Sie unter Trigger für eine Lambda @Edge -Funktion hinzufügen. Mehr zur Nutzung von Include Body (Textkörper einbeziehen) mit Ihrer Funktion finden Sie unter Lambda@Edge-Ereignisstruktur.

Sie können dieses Feature in den folgenden Szenarien nutzen:

Einen Beispiel-Code finden Sie unter Beispielfunktionen für Lambda@Edge.