Allgemeine Hilfsmethoden - Amazon CloudFront
edgeLocationMetadatenrawQueryString()-Methode

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.

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 Features von JavaScript Runtime 2.0 für CloudFront-Funktionen.

edgeLocationMetadaten

Diese Methode erfordert die Verwendung des cloudfront Moduls.

Anmerkung

Sie können diese Methode nur für Funktionen verwenden, die von Zuschauern angefordert werden. Für Zuschauer-Antwort-Funktionen ist diese Methode leer.

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:

Name

Der aus drei Buchstaben bestehende IATA-Code des Edge-Standorts, der die Anfrage bearbeitet hat.

Server-IP

Die IPv6 Adresse IPv4 oder des Servers, der die Anfrage bearbeitet hat.

Region

Der CloudFront Regional Edge Cache (REC), den die Anfrage voraussichtlich verwenden wird, wenn ein Cache-Fehler auftritt. Dieser Wert wird nicht aktualisiert, falls der erwartete REC nicht verfügbar ist und ein Backup-REC für die Anfrage verwendet wird. Dies beinhaltet nicht, dass der Origin Shield-Standort verwendet wird, außer in Fällen, in denen sich das primäre REC und das Origin Shield am selben Standort befinden.

Anmerkung

CloudFront Functions wird kein zweites Mal aufgerufen, wenn CloudFront es für die Verwendung von Origin-Failover konfiguriert ist. Weitere Informationen finden Sie unter Optimieren der Hochverfügbarkeit mit CloudFront Origin Failover.

rawQueryString()-Methode

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

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. ?

  • Wenn es keine Abfragezeichenfolge gibt, aber die vorhanden ? ist, geben die Funktionen eine leere Zeichenfolge zurück.

  • Wenn es keine Abfragezeichenfolge gibt und die ? nicht vorhanden ist, gibt die Funktion zurückundefined.

Fall 1: Vollständige Abfragezeichenfolge zurückgegeben (ohne Leerlauf?)

URL der eingehenden Anfrage: https://example.com/page?name=John&age=25&city=Boston

rawQueryString()gibt zurück: "name=John&age=25&city=Boston"

Fall 2: Es wurde eine leere Zeichenfolge zurückgegeben (wenn sie vorhanden ? ist, aber ohne Parameter)

URL der eingehenden Anfrage: https://example.com/page?

rawQueryString()gibt zurück: ""

Fall 3: undefined zurückgegeben (keine Abfragezeichenfolge und nein?)

URL der eingehenden Anfrage: https://example.com/page

rawQueryString()gibt zurück: undefined