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.
Einschränkungen für alle Edge-Funktionen
Die folgenden Einschränkungen gelten für alle Edge-Funktionen, sowohl für CloudFront Functions als auch für Lambda @Edge.
Topics
AWS-Konto Besitz
Um eine Kantenfunktion einer CloudFront Verteilung zuzuordnen, müssen Funktion und Verteilung derselben gehören AWS-Konto.
CloudFront Funktionen mit Lambda @Edge kombinieren
Für jedes Cache-Verhalten gelten die folgenden Einschränkungen:
-
Jeder Ereignistyp (Viewer-Anforderung, Ursprungsanforderung, Ursprungsantwort und Viewer-Antwort) kann nur eine Edge-Funktionszuordnung aufweisen.
-
Sie können CloudFront Functions und Lambda @Edge nicht in Viewer-Ereignissen (Viewer-Anfrage und Viewer-Antwort) kombinieren.
Alle anderen Kombinationen von Edge-Funktionen sind erlaubt. In der folgenden Tabelle werden die erlaubten Kombinationen erläutert.
|
CloudFront Funktionen |
|||
|
Viewer-Anforderung |
Viewer-Antwort |
||
|
Lambda@Edge |
Viewer-Anforderung |
Nicht zulässig |
Nicht zulässig |
|
Ursprungsanfrage |
Zulässig |
Zulässig |
|
|
Ursprungsantwort |
Zulässig |
Zulässig |
|
|
Viewer-Antwort |
Nicht zulässig |
Nicht zulässig |
|
HTTP-Statuscodes
CloudFront ruft keine Edge-Funktionen für Viewer-Response-Ereignisse auf, wenn der Ursprung den HTTP-Statuscode 400 oder höher zurückgibt.
Lambda@Edge-Funktionen für Ursprungsantwortereignisse werden für alle Ursprungsantworten aufgerufen, auch wenn der Ursprung einen HTTP-Statuscode 400 oder höher zurückgibt. Weitere Informationen finden Sie unter Aktualisieren von HTTP-Antworten in Ursprungsantwortauslösern.
HTTP-Header
Bestimmte HTTP-Header sind nicht zulässig, was bedeutet, dass sie nicht für Edge-Funktionen zugänglich sind und die Funktionen sie nicht hinzufügen können. Andere Header sind schreibgeschützt, was bedeutet, dass die Funktionen sie zwar lesen, aber nicht hinzufügen, ändern oder löschen können.
Unzulässige Header
Die folgenden HTTP-Header sind nicht für Edge-Funktionen verfügbar und die Funktionen können sie nicht hinzufügen. Wenn Ihre Funktion einen dieser Header hinzufügt, schlägt die CloudFront Validierung fehl und CloudFront gibt den HTTP-Statuscode 502 (Bad Gateway) an den Viewer zurück.
-
Connection -
Expect -
Keep-Alive -
Proxy-Authenticate -
Proxy-Authorization -
Proxy-Connection -
Trailer -
Upgrade -
X-Accel-Buffering -
X-Accel-Charset -
X-Accel-Limit-Rate -
X-Accel-Redirect -
X-Amz-Cf-* -
X-Amzn-Auth -
X-Amzn-Cf-Billing -
X-Amzn-Cf-Id -
X-Amzn-Cf-Xff -
X-Amzn-Errortype -
X-Amzn-Fle-Profile -
X-Amzn-Header-Count -
X-Amzn-Header-Order -
X-Amzn-Lambda-Integration-Tag -
X-Amzn-RequestId -
X-Cache -
X-Edge-* -
X-Forwarded-Proto -
X-Real-IP -
CloudFront-Viewer-Cert-PEM -
Client-Cert -
Client-Cert-Chain
Read-only Header
Die folgenden Header sind schreibgeschützt. Ihre Funktion kann sie lesen und als Eingabe für die Funktionslogik verwenden, doch sie kann die Werte nicht ändern. Wenn Ihre Funktion einen schreibgeschützten Header hinzufügt oder bearbeitet, schlägt die CloudFront Überprüfung der Anforderung fehl und CloudFront gibt den HTTP-Statuscode 502 (Bad Gateway) an den Viewer zurück.
Read-only Header in Viewer-Anforderungsereignissen
Die folgenden Header sind bei Viewer-Anforderungsereignissen schreibgeschützt.
-
CDN-Loop -
Content-Length -
Host -
Transfer-Encoding -
Via
Read-only Header in Ursprungsanforderungsereignissen (nur Lambda @Edge)
Die folgenden Header sind in Ursprungsanforderungsereignissen schreibgeschützt, die nur in Lambda@Edge vorhanden sind.
-
Accept-Encoding -
CDN-Loop -
Content-Length -
If-Modified-Since -
If-None-Match -
If-Range -
If-Unmodified-Since -
Transfer-Encoding -
Via
Read-only Header in Ursprungs-Antwortereignissen (nur Lambda @Edge)
Die folgenden Header sind in Ursprungsantwortereignissen schreibgeschützt, die nur in Lambda@Edge vorhanden sind.
-
Transfer-Encoding -
Via
Read-only Header in Zuschauer-Antwortereignissen
Die folgenden Header sind in Viewer-Antwortereignissen sowohl für CloudFront Functions als auch für Lambda @Edge schreibgeschützt.
-
Warning -
Via
Die folgenden Header sind bei Viewer-Antwortereignissen für Lambda@Edge schreibgeschützt.
-
Content-Length -
Content-Encoding -
Transfer-Encoding
Abfragezeichenfolgen
Die folgenden Einschränkungen gelten für Funktionen, die eine Abfragezeichenfolge in einem Anforderungs-URI lesen, aktualisieren oder erstellen.
-
(Nur Lambda@Edge) Um auf die Abfragezeichenfolge in einer Ursprungsanforderung oder einer Ursprungsantwortfunktion zuzugreifen, muss die Cache-Richtlinie oder die Ursprungsanforderungsrichtlinie auf Alle auf Abfragezeichenfolgen gesetzt werden.
-
Eine Funktion kann eine Abfragezeichenfolge für Viewer-Anforderungs- und Ursprungsanforderungsereignisse erstellen oder aktualisieren (Ursprungsanforderungsereignisse existieren nur in Lambda@Edge).
-
Eine Funktion kann für Ursprungsantwort- und Viewer-Antwortereignisse eine Abfragezeichenfolge lesen, aber nicht erstellen oder aktualisieren (Ursprungsantwortereignisse existieren nur in Lambda@Edge).
-
Wenn eine Funktion eine Abfragezeichenfolge erstellt oder aktualisiert, gelten folgende Einschränkungen:
-
Die Abfragezeichenfolge darf keine Leerzeichen, Steuerzeichen oder die Fragment-ID (
#) enthalten. -
Die Gesamtgröße der URI und der Abfragezeichenfolge darf nicht mehr als 8.192 Zeichen umfassen.
-
Wir empfehlen die Verwendung der Prozentkodierung für die URI und die Abfragezeichenfolge. Weitere Informationen finden Sie unter URI-, Abfragezeichenfolge- und Header-Kodierung.
-
URI
Wenn eine Funktion Änderungen an dem URI für eine Anforderung durchführt, ändert dies weder das Cache-Verhalten für die Anforderung noch den Ursprung, an den Anforderung weitergeleitet wird.
Die Gesamtgröße der URI und der Abfragezeichenfolge darf nicht mehr als 8.192 Zeichen umfassen.
URI-, Abfragezeichenfolge- und Header-Kodierung
Die Werte für den URI, die Abfragezeichenfolge und die Header, die an Edge-Funktionen übergeben werden, sind codiert. UTF-8 Ihre Funktion sollte die UTF-8 Kodierung für die URI-, Abfragezeichenfolge- und Header-Werte verwenden, die sie zurückgibt. Die prozentuale Kodierung ist mit der UTF-8 Kodierung kompatibel.
In der folgenden Liste wird erklärt, wie die Codierung für den URI, die Abfragezeichenfolge und die Header CloudFront behandelt wird:
-
Wenn Werte in der Anfrage UTF-8 codiert sind, CloudFront leitet die Werte an Ihre Funktion weiter, ohne sie zu ändern.
-
Wenn Werte in der Anforderung ISO-8859-1 codiert sind
, CloudFront konvertiert die Werte in die UTF-8 Kodierung, bevor sie an Ihre Funktion weitergeleitet werden. -
Wenn Werte in der Anfrage mit einer anderen Zeichenkodierung codiert werden, CloudFront wird davon ausgegangen, dass sie ISO-8859-1 kodiert sind, und versucht, von in zu konvertieren. ISO-8859-1 UTF-8
Wichtig
Die konvertierten Zeichen sind möglicherweise eine falsche Interpretation der Werte in der ursprünglichen Anfrage. Dies kann dazu führen, dass Ihre Funktion oder Ihr Ursprung ein unbeabsichtigtes Ergebnis produzieren.
Die Werte für den URI, die Abfragezeichenfolge und die Header, die an Ihren Ursprung CloudFront weitergeleitet werden, hängen davon ab, ob eine Funktion die Werte ändert:
-
Wenn eine Funktion den URI, die Abfragezeichenfolge oder den Header nicht ändert, CloudFront leitet sie die Werte, die sie in der Anfrage erhalten hat, an Ihren Ursprung weiter.
-
Wenn eine Funktion den URI, die Abfragezeichenfolge oder den Header ändert, CloudFront leitet sie die UTF-8 kodierten Werte weiter.
Microsoft Smooth Streaming
Sie können Edge-Funktionen nicht mit einer CloudFront Distribution verwenden, die Sie zum Streamen von Mediendateien verwenden, die Sie in das Microsoft Smooth Streaming-Format transkodiert haben.
Tagging
Sie können keine Tags zu Edge-Funktionen hinzufügen. Weitere Informationen zum Taggen finden Sie unter CloudFront. Eine Ressource taggen CloudFront
