Allgemeine Hilfsmethoden

Diese Seite bietet zusätzliche Hilfsmethoden innerhalb von CloudFront Functions. Um diese Methoden zu verwenden, erstellen Sie eine CloudFront Funktion mit JavaScript Runtime 2.0.

import cf from 'cloudfront';

Weitere Informationen finden Sie unter JavaScript Runtime 2.0-Funktionen für CloudFront Funktionen.

EdgeLocation-Metadaten

Diese Methode erfordert die Verwendung des cloudfront Moduls.

Verwenden Sie dieses JavaScript Objekt, um den Flughafencode des Edge-Standorts, die erwartete regionale Edge-Cache-Region oder die CloudFront Server-IP-Adresse abzurufen, die für die Bearbeitung der Anfrage verwendet wurde. Diese Metadaten sind nur für den Event-Trigger der Viewer-Anforderung verfügbar.

cf.edgeLocation = {
    name: SEA
    serverIp: 1.2.3.4
    region: us-west-2
}

Das cf.edgeLocation Objekt kann Folgendes enthalten:

Methode raw QueryString ()

Diese Methode benötigt das cloudFront Modul nicht.

Verwenden Sie die rawQueryString() Methode, um die ungeparste und unveränderte Abfragezeichenfolge als Zeichenfolge abzurufen.

Anforderung

function handler(event) {
    var request = event.request;
    const qs = request.rawQueryString();
}

Antwort

Gibt die vollständige Abfragezeichenfolge der eingehenden Anfrage als Zeichenkettenwert ohne den Anfang zurück. ?

Methode log CustomData ()

Um diese Methode zu verwenden, importieren Sie das cloudfront Modul.

Verwenden Sie logCustomData() diese Methode, um benutzerdefinierte Daten von Ihrer CloudFront Amazon-Funktion in CloudFront Zugriffsprotokolle zu senden. Die Daten werden in das viewer-request-log-data oder viewer-response-log-data Protokollfeld geschrieben, je nachdem, ob die Funktion mit einer Zuschaueranfrage oder einem Zuschauerantwortereignis verknüpft ist.

Die Methode akzeptiert ein einzelnes Zeichenkettenargument. Um ein Objekt zu protokollieren, verwenden Sie JSON.stringify() zunächst, um es in eine Zeichenfolge zu konvertieren. Beispiel:

const resp_obj = JSON.stringify(some_obj);
cf.logCustomData(resp_obj);

Jedes Feld unterstützt bis zu 800 Byte an Daten. CloudFront automatisch URL-encodes die Daten, bevor sie in das Protokollfeld geschrieben werden. CloudFront schneidet danach alle Daten ab, die mehr als 800 Byte groß sind. URL-encoding Wenn Ihre Funktion innerhalb einer einzigen Ausführung logCustomData() mehrmals aufgerufen wird, CloudFront verwendet sie nur den letzten Wert.

Die Methode verwendet die folgende Syntax:

cf.logCustomData(String);

import cf from 'cloudfront';

function handler(event) {
    var request = event.request;

    // Check if the debug header exists, if so log it
    if (request.headers['x-debug-header']) {
        // Log the debug header value
        cf.logCustomData("debug header found: " + request.headers['x-debug-header'].value);
    }

    return request;
}