Im Cache gespeicherte Inhalte entwerten

Die Cache-Entwertung (oder Cache-Leerung) ist der Vorgang, bei dem im Cache gespeicherte Inhalte als ungültig deklariert werden. Dadurch werden die Inhalte aus dem Cache entfernt und die nächste Anfrage wird direkt vom Ursprungsserver abgerufen.

Media CDN unterstützt mehrere Möglichkeiten, Inhalte für die Entwertung auszuwählen:

• Host und URL-Pfad
• URL-Präfix (Platzhalter)
• Cache-Tags, einschließlich der integrierten Tags für status, origin und content-type

Sie können diese Entwertungsparameter kombinieren, um bestimmte Antworten aus dem Cache zu erreichen und die Ursprungslast beim anschließenden Füllen des Cache zu minimieren.

Unterstützte Entwertungssyntax

Die unterstützte Entwertungssyntax lautet so:

Hinweise:

• In einer einzelnen Entwertungsanfrage können bis zu 10 Cache-Tags angegeben werden.
• Sie können host, path und tags in einer einzelnen Entwertungsanfrage kombinieren. Sie werden als boolesches AND behandelt.
• Wenn mehrere Cache-Tags angegeben werden, werden sie als boolesches OR behandelt. Wenn Sie beispielsweise --tags="status=404,origin=staging-origin" angeben, werden alle Antworten mit dem Cache-Tag status=404 ungültig, ebenso wie alle Antworten mit dem Cache-Tag origin=staging-origin.

Cache-Tags

Mit Cache-Tags (oder Ersatzschlüsseln) können Sie Inhalte basierend auf beliebigen Metadaten entwerten.

Diese Tags werden durch Folgendes definiert:

• Festlegen des HTTP-Headers Cache-Tag in einer Ursprungsantwort, wobei die Tags als durch Kommas getrennte Liste von Werten angegeben werden.
• Integrierte Tags, die auf dem HTTP-Statuscode der Antwort, dem MIME-Typ aus dem HTTP-Antwortheader Content-Type oder dem Namen des Ursprungs basieren, von dem die Antwort abgerufen wurde.

Wenn in einer einzelnen Entwertungsanfrage mehrere Tags angegeben werden, werden sie als boolesches OR behandelt.

Dazu ein Beispiel:

• Sie haben die folgenden im Cache gespeicherten Objekte:

  • Im Cache gespeichertes Objekt 1 mit den Tags status=200, content-type=video/mp4
  • Im Cache gespeichertes Objekt 2 mit den Tags status=404, content-type=text/plain
  • Im Cache gespeichertes Objekt 3 mit den Tags status=200, content-type=application/x-mpegurl

• Sie senden eine Anfrage, um Objekte mit tags="status=200,content-type=text/plain" zu entwerten.

• Ergebnis: Alle drei im Cache gespeicherten Objekte werden gleichzeitig entwertet. Dadurch soll verhindert werden, dass Sie alle möglichen Tag-Kombinationen angeben müssen, von denen einige möglicherweise unbekannt sind.

Hinweise:

• Die Standard-Cache-Tags sind nicht in der clientseitigen Antwort enthalten, da sie entweder vorhandene Header (z. B. die Statuszeile oder Content-Type) oder interne Konfigurationsdetails widerspiegeln.
• Cache-Tags, die vom Ursprung im HTTP-Antwortheader Cache-Tag gesendet werden, werden an den Client gesendet. Wenn Sie verhindern möchten, dass diese an den Client gesendet werden, verwenden Sie die Funktion responseHeadersToRemove in einer routeRule, um den Header Cache-Tag zu entfernen. Beispiele finden Sie in der Dokumentation zu benutzerdefinierten Headern.

Integrierte Tags

Auf Antworten werden automatisch die folgenden Cache-Tags angewendet, um die Entwertung von Inhalten basierend auf dem Statuscode, dem MIME-Typ oder dem Ursprung zu unterstützen, von dem die Inhalte abgerufen wurden. Sie müssen diese Tags nicht in Ihren Ursprungsantworten angeben.

Beschränkungen für Cache-Tags

Für Cache-Tags gelten die folgenden Einschränkungen:

• Ein Tag darf nicht mehr als 120 Byte umfassen.
• Die Gesamtzahl der Tag-Namen darf 4 KiB (4096 Byte) pro im Cache gespeichertem Objekt nicht überschreiten.
• Es dürfen nicht mehr als 50 Tags pro Objekt vorhanden sein, abgesehen von den Standard-Tags, die von Media CDN hinzugefügt werden.
• Muss ein gültiger HTTP-Tokenname sein, wie in Abschnitt 3.2.6 von HTTP RFC 7230 definiert.
• Darf nicht die integrierten Präfixe status=, origin= oder content-type= enthalten (die ignoriert werden).

Tags, die diese Limits nicht einhalten oder diese Anforderungen nicht erfüllen, werden ignoriert. In einigen Fällen (z. B. wenn die Antwortheader zu groß sind) schlägt die Antwort fehl und wird nicht im Cache gespeichert.

Berechtigungen

Die networkservices.EdgeCacheServices.invalidateCache Berechtigung steuert den Zugriff auf die invalidateCache API. Diese Berechtigung ist in Identity and Access Management-Rollen networkservices.edgeCacheAdmin und networkservices.edgeCacheUser enthalten.

Beispiele

Die folgenden Beispiele zeigen, wie Sie im Cache gespeicherte Antworten für einen Media CDN-Dienst entwerten.

Sie können die Felder host, path und tags in einer einzelnen Entwertungsanfrage kombinieren, um eine bestimmte Gruppe von Inhalten zu entwerten.

Nach Host entwerten

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --host=HOST

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --host="media.example.com"

Das Entwerten aller Inhalte, die mit einem Host verknüpft sind, kann riskant sein und die Leistung beeinträchtigen. Sie können den Entwertungsbereich reduzieren, indem Sie einen bestimmten Pfad oder relevante Cache-Tags angeben.

Nach Pfad entwerten

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --path=PREFIX

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --path="/segments/e94a6b1f731/*"

Nach Cache-Tag entwerten

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --tags=TAGS

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --tags="status=404,content-type=text/plain"

Entwertungslatenz

Die Cache-Entwertung über Tausende von Standorten in Media CDN ist in der Regel innerhalb einer Minute weltweit abgeschlossen.

In einigen Fällen kann die Entwertung länger dauern, je nach Systemlast, Konnektivität und Umfang der zu entwertenden Inhalte.

Logging

Wenn Audit-Logs aktiviert sind, werden Entwertungsaufrufe in Cloud Logging protokolliert.

Beschränkungen

Für Entwertungen gibt es eine Ratenbegrenzung. Wenn Sie das Ratenlimit für Entwertungen überschreiten, erhalten Sie eine HTTP-429-Fehlermeldung mit dem Status RESOURCE_EXHAUSTED.

Jede Entwertungsanfrage wird unabhängig von Größe oder Umfang des Pfads als einzelne Operation auf Ihr Ratenlimit angerechnet. Beispielsweise werden sowohl das Entwerten einer einzelnen Datei (/images/my-image.png) als auch das Entwerten eines Platzhalterpfads (/images/*) als eine Entwertungsanfrage gezählt.