Was Sie wissen müssen, wenn Sie Dateien für ungültig erklären

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

Groß-/Kleinschreibung

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

Ändern des URI mithilfe einer Lambda-Funktion

Wenn Ihre CloudFront Distribution bei Viewer-Anforderungsereignissen eine Lambda-Funktion auslöst und die Funktion den URI der angeforderten Datei ändert, empfehlen wir Ihnen, beide für ungültig zu erklären, URIs um die Datei aus den CloudFront Edge-Caches 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:

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

Zu einer URI, die 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 so konfiguriert CloudFront haben, dass Cookies an Ihren Ursprung weitergeleitet werden, können CloudFront Edge-Caches mehrere Versionen der Datei enthalten. Wenn Sie eine Datei für ungültig erklären, wird jede zwischengespeicherte Version der Datei CloudFront ungültig gemacht, 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 Auf Cookies basierender Inhalt zwischenspeichern.

Weiterleiten von Headern

Wenn Sie so konfiguriert haben CloudFront , dass eine Liste von Headern an Ihren Ursprung weitergeleitet und anhand der Werte der Header zwischengespeichert wird, können CloudFront Edge-Caches mehrere Versionen der Datei enthalten. 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 so konfigurieren CloudFront , dass alle Header an Ihren Ursprung weitergeleitet werden, werden Ihre Dateien CloudFront nicht zwischengespeichert.) Weitere Informationen finden Sie unter Inhalt auf der Grundlage von Anforderungsheadern zwischenspeichern.

Weiterleiten von Abfragezeichenfolgen

Wenn Sie so konfiguriert haben CloudFront , dass Abfragezeichenfolgen an Ihren Ursprung weitergeleitet werden, müssen Sie die Abfragezeichenfolgen bei der Invalidierung von Dateien einbeziehen, 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 Inhalt auf der Grundlage von Abfragezeichenfolgenparametern zwischenspeichern.

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

Maximum erlaubt

Weitere Hinweise zur maximal zulässigen Anzahl von Invalidierungen finden Sie unter. Maximum für gleichzeitige Aufhebungsanfragen

Microsoft Smooth Streaming-Dateien

Sie können Mediendateien im Microsoft Smooth Streaming-Format nicht ungültig machen, wenn Sie Smooth Streaming für das entsprechende Cache-Verhalten aktiviert haben.

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. Kodieren Sie keine anderen Zeichen im Pfad mit URL, da sonst die alte Version der aktualisierten Datei CloudFront nicht ungültig wird.

Aufhebungspfade

Der Pfad ist der relative Pfad in Bezug auf die Verteilung. Um die Datei beispielsweise für ungültig zu erklären, geben Sie anhttps://d111111abcdef8.cloudfront.net/images/image2.jpg. /images/image2.jpg

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 die Invalidierungspfade mit einem führenden 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

Um Platzhalter (*) bei der Invalidierung zu verwenden, müssen Sie den Platzhalter am Ende des Pfads angeben. Sternchen (*), die an einer anderen Stelle eingefügt werden, werden als wörtliche Zeichenübereinstimmung und nicht als Ungültigerklärung von Platzhaltern behandelt.

Wenn Sie das AWS Command Line Interface (AWS CLI) verwenden, um Dateien für ungültig zu erklären, und Sie einen Pfad angeben, der den * Platzhalter enthält, müssen Sie den Pfad wie in Anführungszeichen () einschließen. " "/*"

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

Beispiel: Invalidierungspfade

• Um alle Dateien in einem Verzeichnis für ungültig zu erklären:

  /directory-path/*

• Um ein Verzeichnis, all seine Unterverzeichnisse und alle Dateien in dem Verzeichnis und den Unterverzeichnissen ungültig zu machen:

  /directory-path*

• 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:

  /directory-path/file-name.*

• 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:

  /directory-path/initial-characters-in-file-name*

• Wenn Sie CloudFront den Cache auf der Grundlage von Abfragezeichenfolgenparametern konfigurieren und alle Versionen einer Datei für ungültig erklären möchten, gehen Sie wie folgt vor:

  /directory-path/file-name.file-name-extension*

• So machen Sie alle Dateien in einer Distribution ungültig:

  /*

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

Signed URLs

Wenn Sie signiert verwenden URLs, machen Sie eine Datei ungültig, indem Sie nur den Teil der URL vor dem Fragezeichen (?) angeben.