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 für den Edge-Standort, die erwartete regionale Edge-Cache-Region oder die CloudFront Server-IP-Adresse abzurufen, die zur 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:

raw QueryString () -Methode

Für diese Methode ist das cloudFront Modul nicht erforderlich.

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 vorangestellte Zeichenfolge zurück. ?

log CustomData () -Methode

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

Verwenden Sie die logCustomData() Methode, um benutzerdefinierte Daten aus Ihrer CloudFront Amazon-Funktion in CloudFront Zugriffsprotokolle zu senden. Die Daten werden in das viewer-response-log-data Protokollfeld viewer-request-log-data oder 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, JSON.stringify() konvertieren Sie es zuerst in eine Zeichenfolge. 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 größer als 800 Byte sind. URL-encoding Wenn Ihre Funktion innerhalb einer einzigen Ausführung logCustomData() mehrmals aufgerufen wird, CloudFront wird nur der letzte Wert verwendet.

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