View a markdown version of this page

Was Sie wissen müssen, wenn Sie Pfade ungültig machen - Amazon CloudFront

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.

Was Sie wissen müssen, wenn Sie Pfade ungültig machen

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

Berücksichtigung von Groß- und

Bei Aufhebungspfaden wird zwischen Groß- und Kleinschreibung unterschieden. /images/Image.jpg und /images/image.jpg geben beispielsweise 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 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 so konfiguriert haben CloudFront , 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 Zwischenspeichern von Inhalten auf der Grundlage von Cookies.

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 Zwischenspeichern von Inhalten auf der Grundlage von Anforderungsheadern.

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 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 Zugriffsprotokolle (Standardprotokolle).

Maximal zulässig

Weitere Informationen zur maximalen Anzahl der zulässigen Gültigkeitsaufhebungen finden Sie unter Kontingente für Aufhebungen.

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

Wichtig

Verwenden Sie das ~ Zeichen nicht in Ihrem Pfad. CloudFront unterstützt dieses Zeichen nicht für Ungültigerklärungen, 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 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

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) 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 Beispiel: Aufhebungspfade

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

    / directory-path /*

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

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

Signiert URLs

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