Benutzerdefinierte Header definieren

Mit Media CDN können Sie benutzerdefinierte Anfrage- und Antwortheader angeben.

Mit benutzerdefinierten Headern haben Sie folgende Möglichkeiten:

• Geografische Daten zum Client zurückgeben, z. B. Land, Region oder Stadt, mit denen Sie lokalisierte Inhalte anzeigen können.
• Ermitteln, ob eine Antwort vollständig oder teilweise aus dem Cache bereitgestellt wurde und von welchem Cache-Speicherort sie bereitgestellt wurde.
• Sowohl Anfrage- als auch Antwortheader entfernen, ersetzen oder ergänzen.

Benutzerdefinierte Header festlegen

Header werden für jede Route festgelegt. So können Sie Header für verschiedene Inhalte wie Manifeste oder Videosegmente hinzufügen und entfernen.

Legen Sie benutzerdefinierte Anfrageheader pro Route früh im CDN-Verarbeitungspfad fest, bevor Entscheidungen zum Caching getroffen werden. Wenn Sie beispielsweise einen cache-control-Header als benutzerdefinierten Header pro Route festlegen, wirkt sich das auf das Caching-Verhalten im CDN aus.

Standardmäßig werden hinzugefügte Headerwerte durch Kommas getrennt und den Antwort- oder Anfrageheadern mit denselben Feldnamen angehängt.

Wenn Sie vorhandene Werte überschreiben möchten, legen Sie replace auf true fest.

gcloud edge-cache services describe prod-media-service

routeRules:
- priority: 1
   description: "video routes"
   matchRules:
      - prefixMatch: "/video/"
   headerAction:
      responseHeadersToAdd:
      # Return the country (or region) associated with the client's IP address.
      - headerName: "client-geo"
         headerValue: "{client_region}"
         replace: true
      requestHeadersToAdd:
      # Inform the upstream origin server the request is from Media CDN
      - headerName: "x-downstream-cdn"
         headerValue: "Media CDN"
      responseHeadersToRemove:
      - headerName: "X-User-ID"
      - headerName: "X-Other-Internal-Header"

route_rule {
  description = "video routes"
  priority    = 1
  match_rule {
    prefix_match = "/video/"
  }
  origin = google_network_services_edge_cache_origin.default.name
  header_action {
    response_header_to_add {
      # Return the country (or region) associated with the client's IP address.
      header_name  = "client-geo"
      header_value = "{client_region}"
      replace      = true
    }
    request_header_to_add {
      # Inform the upstream origin server that the request is from Media CDN.
      header_name  = "x-downstream-cdn"
      header_value = "Media CDN"
    }
    response_header_to_remove {
      header_name = "X-User-ID"
    }
    response_header_to_remove {
      header_name = "X-Other-Internal-Header"
    }
  }
}

Dieses Beispiel tut Folgendes:

• Fügt der Antwort einen benutzerdefinierten client-geo-Header unter Verwendung der {client_region}-Variablen hinzu, die das Land oder die Region zurückgibt, das bzw. die der IP-Adresse des Clients zugeordnet ist.
• Fügt der Anfrage einen benutzerdefinierten x-downstream-cdn-Header mit einem statischen String hinzu.
• Entfernt zwei interne Header.

Informationen zum Konfigurieren ursprungsspezifischer benutzerdefinierter Header finden Sie unter Ursprungsspezifische Host-Umschreibungen oder Header-Änderungen konfigurieren.

Dynamische Headervariablen

Benutzerdefinierte Header können eine oder mehrere dynamische Variablen enthalten.

Anforderungsheader, die Teil der Cache-Schlüsselrichtlinie (cacheKeyPolicy.includedHeaderNames) sind, können eine oder mehrere benutzerdefinierte Variablen enthalten. Anfrageheader, die andere dynamische Variablen enthalten, können nicht Teil des Cache-Schlüssels sein.

Für benutzerdefinierte Variablen gelten die folgenden Überlegungen:

• Vorhandene Anfrage- und Antwortheader bleiben erhalten, mit Ausnahme der folgenden, die entfernt werden:

  • X-User-IP
  • Alle Header mit X-Google oder X-GFE

• Header-Schlüssel und -Werte müssen RFC 7230 entsprechen. Ältere Formate sind nicht zulässig.

• Alle Headerschlüssel werden in Kleinbuchstaben umgewandelt (gemäß HTTP/2).

• Einige Header werden zusammengeführt. Wenn mehrere Instanzen mit demselben Headerschlüssel vorhanden sind, z. B. Via, kombiniert der Load-Balancer deren Werte in einer durch Kommas getrennten Liste zu einem einzelnen Headerschlüssel. Es werden nur Header zusammengeführt, deren Werte als durch Kommas getrennte Liste dargestellt werden können. Andere Header wie Set-Cookie werden nie zusammengeführt.

• Einige Header werden hinzugefügt oder Werte werden an sie angehängt. Media CDN fügt immer bestimmte Header wie X-Forwarded-For hinzu oder ändert sie.

• Media CDN erweitert jeden Antwortheader mit einer unterstützten Variable, auch wenn er vom Client oder Ursprung festgelegt wurde. Sie können nicht nur benutzerdefinierte Header, sondern auch von Ihrem Client (z. B. ein Videoplayer) oder Ihrer Ursprungsinfrastruktur festlegen. Variablen im Anfragepfad werden in Media CDN nicht erweitert.

• Gemäß den oben beschriebenen Regeln werden beispielsweise die Header X-Goog- und X-Amz- beibehalten und in Kleinbuchstaben umgewandelt.

Cache-Statuswerte

Die Headervariable {cdn_cache_status} kann mehrere Werte zurückgeben, die der Cache-Ebene entsprechen, über die die Antwort bereitgestellt wurde. Beachten Sie die folgenden Richtlinien für die Interpretation der Headervariable {cdn_cache_status}:

• Wenn der Header hit enthält, wurden die angeforderten Inhalte aus dem Cache abgerufen.
• Wenn der Header miss enthält, wurden die angeforderten Inhalte nicht in einem Cacheknoten gefunden und mussten von einem Upstream-Knoten abgerufen werden.
• Wenn der Header fetch enthält, wurden die angeforderten Inhalte vom Ursprungsserver abgerufen.

• Wenn der Header uncacheable enthält, wurden die angeforderten Inhalte von einigen oder allen Komponenten der Caching-Infrastruktur als nicht cachefähig eingestuft.

  • Wenn der Header auch hit oder miss enthält, wurden die angeforderten Inhalte von einigen Caching-Komponenten als nicht im Cache speicherbar und von anderen als im Cache speicherbar eingestuft.
  • Wenn der Header nicht auch hit oder miss enthält, wurden die angeforderten Inhalte von allen Caching-Komponenten als nicht cachefähig eingestuft und alle Anfragen für diese Inhalte werden vom Ursprung abgerufen. Damit Ihre Inhalte richtig im Cache gespeichert werden, müssen Sie die Media CDN-Ursprungsanforderungen beachten.

Standardheader

Media CDN fügt den Ursprungsanfragen und Clientantworten die folgenden Anfrage- und Antwortheader hinzu.

Header-Schlüssel werden sowohl für Anfrage- als auch für Antwortheader in Kleinbuchstaben umgewandelt, da bei Header-Schlüsseln die Groß-/Kleinschreibung nicht beachtet wird.

Andere Header, einschließlich des Edge-PoP-Standorts (Point of Presence) und des Cache-Status (z. B. hit und miss), können mit Variablen für dynamische Header hinzugefügt werden.