カスタム ヘッダーを定義する

Media CDN では、カスタム リクエスト ヘッダーとカスタム レスポンス ヘッダーを指定できます。

カスタム ヘッダーを使用すると、次のことができます。

• 国、リージョン、都市など、クライアントに関する地理データを返し、ローカライズされたコンテンツの表示に使用できます。
• レスポンスがキャッシュから提供されているかどうか（全体または一部）と、レスポンスを送信するキャッシュのロケーションを決定します。
• リクエスト ヘッダーとレスポンス ヘッダーの両方を削除、置換、または追加します。

カスタム ヘッダーを設定する

ヘッダーはルートごとに設定されるため、マニフェストや動画セグメントなど、さまざまなコンテンツのヘッダーを追加または削除できます。

ルートごとのカスタム リクエスト ヘッダーは、キャッシュの決定を行う前に、CDN 処理パスの早い段階で設定します。たとえば、cache-control ヘッダーをルートごとのカスタム ヘッダーとして設定すると、CDN のキャッシュ動作に影響します。

デフォルトでは、追加されたヘッダー値はカンマ区切りで、同じフィールド名を持つレスポンス ヘッダーまたはリクエスト ヘッダーに追加されます。

既存の値を上書きするには、replace を 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"
    }
  }
}

この例では、次の操作を行います。

• {client_region} 変数を使用して、カスタム client-geo ヘッダーをレスポンスに追加します。この変数は、クライアントの IP アドレスに関連付けられた国（またはリージョン）を返します。
• 静的文字列を使用して、カスタム x-downstream-cdn ヘッダーをリクエストに追加します。
• 2 つの内部ヘッダーを削除します。

送信元固有のカスタム ヘッダーを構成するには、 送信元固有のホストの書き換えまたはヘッダーの変更を構成するをご覧ください。

動的ヘッダー変数

カスタム ヘッダーには 1 つ以上の動的変数を含めることができます。

キャッシュキー ポリシー（cacheKeyPolicy.includedHeaderNames）の一部であるリクエスト ヘッダーには、1 つ以上のカスタム変数を含めることができます。他の動的変数を含むリクエスト ヘッダーは、キャッシュキーの一部にすることはできません。