Definire intestazioni personalizzate

Media CDN ti consente di specificare intestazioni di richieste e risposte personalizzate.

Le intestazioni personalizzate ti consentono di:

• Restituisce dati geografici sul client, ad esempio paese, regione o città, che puoi utilizzare per mostrare contenuti localizzati.
• Determina se una risposta è stata pubblicata dalla cache (in tutto o in parte) e da quale posizione della cache è stata pubblicata.
• Rimuovi, sostituisci o aggiungi alle intestazioni di richiesta e risposta.

Impostare intestazioni personalizzate

Le intestazioni vengono impostate su ogni percorso, il che ti consente di aggiungere e rimuovere intestazioni per contenuti diversi, come manifest o segmenti video.

Imposta le intestazioni delle richieste personalizzate per route all'inizio del percorso di elaborazione della CDN, prima delle decisioni di memorizzazione nella cache. Ad esempio, se imposti un'intestazione cache-control come intestazione personalizzata per route, influisce sul comportamento di memorizzazione nella cache nella CDN.

Per impostazione predefinita, i valori delle intestazioni aggiunti sono separati da virgole e vengono aggiunti alle intestazioni di risposta o di richiesta con gli stessi nomi di campo.

Per sovrascrivere i valori esistenti, imposta replace su true.

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"
    }
  }
}

Questo esempio esegue le seguenti operazioni:

• Aggiunge un'intestazione client-geo personalizzata alla risposta utilizzando la variabile {client_region}, che restituisce il paese (o la regione) associato all'indirizzo IP del client.
• Aggiunge un'intestazione x-downstream-cdn personalizzata alla richiesta utilizzando una stringa statica.
• Rimuove due intestazioni interne.

Per configurare intestazioni personalizzate specifiche per l'origine, vedi Configurare le riscritture dell'host o le modifiche delle intestazioni specifiche per l'origine.

Variabili di intestazione dinamiche

Le intestazioni personalizzate possono contenere una o più variabili dinamiche.

Le intestazioni delle richieste che fanno parte dei criteri della chiave della cache (cacheKeyPolicy.includedHeaderNames) possono contenere una o più variabili personalizzate. Le intestazioni delle richieste che contengono altre variabili dinamiche non possono far parte della chiave cache.

Per le variabili personalizzate valgono le seguenti considerazioni:

• Le intestazioni di richiesta e risposta esistenti vengono conservate, ad eccezione delle seguenti, che vengono rimosse:

  • X-User-IP
  • Tutte le intestazioni con X-Google o X-GFE

• Le chiavi e i valori delle intestazioni devono essere conformi al documento RFC 7230, con forme obsolete non consentite.

• Tutte le chiavi di intestazione sono in minuscolo (per HTTP/2).

• Alcune intestazioni sono state unite. Quando sono presenti più istanze della stessa chiave di intestazione (ad esempio Via), il bilanciatore del carico combina i relativi valori in un unico elenco separato da virgole per una singola chiave di intestazione. Vengono uniti solo gli header i cui valori possono essere rappresentati come un elenco separato da virgole. Altre intestazioni, come Set-Cookie, non vengono mai unite.

• Alcune intestazioni vengono aggiunte o i valori vengono aggiunti. Media CDN aggiunge o modifica sempre determinate intestazioni, ad esempio X-Forwarded-For.

• Media CDN espande qualsiasi intestazione della risposta con una variabile supportata, anche se impostata dal client o dall'origine. In questo modo puoi impostare intestazioni dinamiche dal client (ad esempio un video player) o dall'infrastruttura di origine, oltre a configurare intestazioni personalizzate. Media CDN non espande le variabili nel percorso della richiesta.

• Ad esempio, in base alle regole descritte in precedenza, le intestazioni X-Goog- e X-Amz- vengono mantenute e convertite in minuscolo.

Valori dello stato della cache

La variabile di intestazione {cdn_cache_status} può restituire più valori corrispondenti al livello di cache che ha fornito la risposta. Tieni presente le seguenti linee guida per interpretare la variabile di intestazione {cdn_cache_status}:

• Se l'intestazione contiene hit, i contenuti richiesti sono stati recuperati dalla cache.
• Se l'intestazione contiene miss, i contenuti richiesti non sono stati trovati in un nodo della cache e sono stati recuperati da un nodo upstream.
• Se l'intestazione contiene fetch, i contenuti richiesti sono stati recuperati dall'origine.

• Se l'intestazione contiene uncacheable, i contenuti richiesti sono stati considerati non memorizzabili nella cache da alcuni o tutti i componenti dell'infrastruttura di memorizzazione nella cache.

  • Se l'intestazione contiene anche hit o miss, i contenuti richiesti sono stati considerati non memorizzabili nella cache da alcuni componenti di memorizzazione nella cache e memorizzabili nella cache da altri.
  • Se l'intestazione non contiene anche hit o miss, i contenuti richiesti sono stati considerati non memorizzabili nella cache da tutti i componenti di memorizzazione nella cache e tutte le richieste di questi contenuti vengono recuperate dall'origine. Per assicurarti che i tuoi contenuti vengano memorizzati nella cache in modo appropriato, consulta i requisiti dell'origine di Media CDN.

Intestazioni predefinite

Media CDN aggiunge le seguenti intestazioni di richieste e risposte rispettivamente alle richieste di origine e alle risposte dei client.

Le chiavi delle intestazioni sono in minuscolo sia per le intestazioni delle richieste sia per quelle delle risposte perché non fanno distinzione tra maiuscole e minuscole.

È possibile aggiungere altre intestazioni, tra cui la posizione del punto di presenza (PoP) edge e lo stato della cache (ad esempio hit e miss), utilizzando le variabili di intestazione dinamiche.