Defina cabeçalhos personalizados

A RFC de multimédia permite-lhe especificar cabeçalhos de pedidos e respostas personalizados.

Os cabeçalhos personalizados permitem-lhe fazer o seguinte:

• Devolver dados geográficos sobre o cliente, como o país, a região ou a cidade, que pode usar para mostrar conteúdo localizado.
• Determinar se uma resposta foi publicada a partir da cache (total ou parcialmente) e a partir de que localização da cache foi publicada.
• Remover, substituir ou anexar aos cabeçalhos de pedido e resposta.

Defina cabeçalhos personalizados

Os cabeçalhos são definidos em cada trajeto, o que lhe permite adicionar e remover cabeçalhos para diferentes conteúdos, como manifestos ou segmentos de vídeo.

Defina cabeçalhos de pedidos personalizados por rota no início do caminho de processamento da RFC, antes das decisões de colocação em cache. Por exemplo, se definir um cabeçalho cache-control como um cabeçalho personalizado por rota, afeta o comportamento de colocação em cache na RFC.

Por predefinição, os valores de cabeçalho adicionados são separados por vírgulas e anexados aos cabeçalhos de resposta ou de pedido com os mesmos nomes de campos.

Para substituir os valores existentes, defina replace como 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"
    }
  }
}

Este exemplo faz o seguinte:

• Adiciona um cabeçalho client-geo personalizado à resposta através da variável {client_region}, que devolve o país (ou a região) associado ao endereço IP do cliente.
• Adiciona um cabeçalho x-downstream-cdn personalizado ao pedido através de uma string estática.
• Remove dois cabeçalhos internos.

Para configurar cabeçalhos personalizados específicos da origem, consulte o artigo Configure reescritas de anfitriões ou modificações de cabeçalhos específicos da origem.

Variáveis de cabeçalho dinâmicas

Os cabeçalhos personalizados podem conter uma ou mais variáveis dinâmicas.

Os cabeçalhos dos pedidos que fazem parte da política de chaves da cache (cacheKeyPolicy.includedHeaderNames) podem conter uma ou mais variáveis personalizadas. Os cabeçalhos dos pedidos que contêm outras variáveis dinâmicas não podem fazer parte da chave da cache.

As seguintes considerações aplicam-se às variáveis personalizadas:

• Os cabeçalhos de pedidos e respostas existentes são preservados, exceto os seguintes, que são removidos:

  • X-User-IP
  • Quaisquer cabeçalhos com X-Google ou X-GFE

• As chaves e os valores dos cabeçalhos têm de estar em conformidade com a norma