Was Sie bei der Aufhebung der Gültigkeit von Dateien wissen müssen - Amazon CloudFront

Was Sie bei der Aufhebung der Gültigkeit von Dateien wissen müssen

Wenn Sie eine Datei angeben, die ungültig gemacht werden soll, beachten Sie die folgenden Informationen:

Groß-/Kleinschreibung

Bei Aufhebungspfaden wird zwischen Groß- und Kleinschreibung unterschieden. /images/Image.jpg und /images/image.jpg geben beispielsweise zwei verschiedene Dateien an.

Ändern des URI mit einer Lambda-Funktion

Wenn Ihre CloudFront-Verteilung eine Lambda-Funktion bei Viewer-Anfrage-Ereignissen auslöst und die Funktion die URI der angefragten Datei ändert, empfiehlt es sich, beide URIs aufzuheben, um die Datei aus den CloudFront-Edge-Zwischenspeichern zu entfernen:

  • Der URI in der Viewer-Anfrage

  • Die URI, nachdem sie von der Funktion geändert wurde

Beispiel

Angenommen, Ihre Lambda-Funktion ändert den URI für eine Datei von diesem:

https://d111111abcdef8.cloudfront.net/index.html

in einen URI, der ein Sprachverzeichnis enthält:

https://d111111abcdef8.cloudfront.net/en/index.html

Um die Datei ungültig zu machen, müssen Sie die folgenden Pfade angeben:

  • /index.html

  • /en/index.html

Weitere Informationen finden Sie unter Invalidation paths.

Standardstammobjekt

Um die Gültigkeit des Standardstammobjekts (Datei) aufzuheben, geben Sie den Pfad auf die Weise an, auf die Sie auch den Pfad für alle anderen Dateien angeben. Weitere Informationen finden Sie unter So funktioniert das Standardstammobjekt.

Weiterleiten von Cookies

Wenn Sie CloudFront so konfiguriert haben, dass Cookies an Ihren Ursprung weitergeleitet werden, enthalten CloudFront-Edge-Zwischenspeicher möglicherweise mehrere Versionen der Datei. Wenn Sie die Gültigkeit einer Datei aufheben, hebt CloudFront die Gültigkeit aller zwischengespeicherten Versionen der Datei auf, unabhängig von den zugehörigen Cookies. Sie können nicht auf der Grundlage der zugehörigen Cookies selektiv die Gültigkeit einiger Versionen aufheben und anderer Versionen nicht. Weitere Informationen finden Sie unter Zwischenspeichern von Inhalten auf der Grundlage von Cookies.

Weiterleiten von Headern

Wenn Sie CloudFront so konfiguriert haben, dass eine Liste von Headern an Ihren Ursprung weitergeleitet wird und dass eine Zwischenspeicherung auf der Grundlage der Werte der Header erfolgt, enthalten CloudFront-Edge-Zwischenspeicher möglicherweise mehrere Versionen der Datei. Wenn Sie die Gültigkeit einer Datei aufheben, hebt CloudFront die Gültigkeit aller zwischengespeicherten Versionen der Datei auf, unabhängig von den Header-Werten. Sie können nicht auf der Grundlage der Header-Werte selektiv die Gültigkeit einiger Versionen aufheben und anderer Versionen nicht. (Wenn Sie CloudFront so konfigurieren, dass alle Header an Ihren Ursprung weitergeleitet werden, speichert CloudFront Ihre Dateien nicht zwischen.) Weitere Informationen finden Sie unter Zwischenspeichern von Inhalten auf der Grundlage von Anforderungsheadern.

Weiterleiten von Abfragezeichenfolgen

Wenn Sie CloudFront so konfiguriert haben, dass Abfragezeichenfolgen an Ihren Ursprung weitergeleitet werden, müssen Sie die Abfragezeichenfolgen beim Aufheben der Gültigkeit von Dateien einfügen, wie in den folgenden Beispielen gezeigt:

  • /images/image.jpg?parameter1=a

  • /images/image.jpg?parameter1=b

Wenn Client-Anfragen fünf verschiedene Abfragezeichenfolgen für dieselbe Datei enthalten, können Sie entweder die Gültigkeit der Datei fünfmal aufheben, einmal für jede Abfragezeichenfolgen, oder den Platzhalter * im Aufhebungspfad verwenden wie im folgenden Beispiel gezeigt:

/images/image.jpg*

Weitere Informationen zur Verwendung von Platzhaltern im Aufhebungspfad finden Sie unter Invalidation paths.

Weitere Informationen zu Abfragezeichenfolgen finden Sie unter Zwischenspeichern von Inhalten auf der Grundlage von Abfragezeichenfolgeparametern.

Um zu ermitteln, welche Abfragezeichenfolgen verwendet werden, können Sie die CloudFront-Protokollierung aktivieren. Weitere Informationen finden Sie unter Standardprotokollierung (Zugriffsprotokolle).

Maximum erlaubt

Weitere Informationen zur maximalen Anzahl der zulässigen Gültigkeitsaufhebungen finden Sie unter Maximum für gleichzeitige Aufhebungsanfragen.

Microsoft Smooth Streaming-Dateien

Sie können die Gültigkeit von Mediendateien im Format Microsoft Smooth Streaming nicht aufheben, wenn Smooth Streaming für das entsprechende Cacheverhalten aktiviert ist.

Nicht-ASCII- oder unsichere Zeichen im Pfad

Wenn der Pfad Nicht-ASCII-Zeichen oder unsichere Zeichen enthält, wie in RFC 1738, definiert, URL-codieren Sie diese Zeichen. URL-codieren Sie keine anderen Zeichen in dem Pfad. Ansonsten hebt CloudFront die Gültigkeit der alten Version der aktualisierten Datei nicht auf.

Wichtig

Verwenden Sie nicht das Zeichen ~ in Ihrem Pfad. CloudFront unterstützt dieses Zeichen nicht für Gültigkeitsaufhebungen, unabhängig davon, ob es URL-kodiert ist oder nicht.

Aufhebungspfade

Der Pfad ist der relative Pfad in Bezug auf die Verteilung. Um beispielsweise die Gültigkeit der Datei unter https://d111111abcdef8.cloudfront.net/images/image2.jpg aufzuheben, würden Sie /images/image2.jpg angeben.

Anmerkung

In der CloudFront-Konsole können Sie den vorangestellten Schrägstrich im Pfad wie folgt weglassen: images/image2.jpg. Wenn Sie die CloudFront-API direkt verwenden, müssen Aufhebungspfade mit einem vorangestellten Schrägstrich beginnen.

Mit dem Platzhalter * können Sie auch die Gültigkeit mehrerer Dateien gleichzeitig aufheben. Der Platzhalter *, der 0 oder mehr Zeichen ersetzt, muss das letzte Zeichen im Aufhebungspfad sein.

Wichtig

Zur Verwendung von Platzhaltern (*) bei der Aufhebung der Gültigkeit müssen Sie den Platzhalter am Ende des Pfads platzieren. Sternchen (*), die an einer anderen Stelle eingefügt werden, werden als wörtliche Zeichenübereinstimmung behandelt und nicht als Aufhebung der Gültigkeit eines Platzhalters.

Wenn Sie die AWS Command Line Interface (AWS CLI) bei der Aufhebung der Gültigkeit von Dateien verwenden und Sie einen Pfad mit dem Platzhalter * verwenden, müssen Sie den Pfad in Anführungszeichen (") angeben, wie z. B. "/*".

Die maximale Länge eines Pfads beträgt 4 000 Zeichen.

Beispiel: Aufhebungspfade

  • So heben Sie die Gültigkeit aller Dateien in einem Verzeichnis auf:

    /Verzeichnispfad/*

  • So heben Sie die Gültigkeit eines Verzeichnisses, aller Unterverzeichnisse und aller Dateien im Verzeichnis und den Unterverzeichnissen auf:

    /Verzeichnispfad*

  • So heben Sie die Gültigkeit aller Dateien auf, die denselben Namen, aber verschiedene Dateinamenerweiterungen haben, wie beispielsweise logo.jpg, logo.png und logo.gif:

    /Verzeichnispfad/Dateiname.*

  • So heben Sie die Gültigkeit aller Dateien in einem Verzeichnis auf, deren Dateinamen mit denselben Zeichen beginnen (beispielsweise alle Dateien für ein Video im HLS-Format), unabhängig von der Dateinamenerweiterung:

    /Verzeichnispfad/Anfangszeichen-im-Dateinamen*

  • Wenn Sie CloudFront so konfigurieren, dass die Zwischenspeicherung auf der Grundlage von Abfragezeichenfolgeparametern erfolgt, und Sie die Gültigkeit aller Versionen einer Datei aufheben möchten:

    /Verzeichnispfad/Dateiname.Dateinamenerweiterung*

  • So heben Sie die Gültigkeit aller Dateien in einer Distribution auf:

    /*

Weitere Informationen zum AUfheben der Gültigkeit von Dateien, wenn Sie eine Lambda-Funktion zum Ändern der URI verwenden, finden Sie unter Changing the URI Using a Lambda Function.

Wenn es sich bei dem Aufhebungspfad um ein Verzeichnis handelt und wenn Sie über keine Standard-Methode zum Angeben von Verzeichnissen verfügen – mit oder ohne einen abschließenden Schrägstrich (/) –, empfehlen wir, die Gültigkeit des Verzeichnisses sowohl mit als auch ohne abschließenden Schrägstrich aufzuheben, beispielsweise /images und /images/.

Signierte URLs

Wenn Sie signierte URLs verwenden, heben Sie die Gültigkeit einer Datei auf, indem Sie nur den Teil der URL vor dem Fragezeichen (?) einfügen.