ネガティブキャッシュの使用

このページでは、Cloud CDN でネガティブキャッシュを使用する手順について説明します。ネガティブキャッシュを使用すると、ステータスコードごとに異なる TTL を設定できます。

これにより、一般的なエラーやリダイレクトに詳細なキャッシュを適用できるようになります。これにより、送信元の負荷を軽減し、レスポンスのレイテンシを短縮することで、エンドユーザーのエクスペリエンスを向上させることができます。

始める前に

キャッシュモードと静的コンテンツについて確認します。
Cloud CDN が有効になっていることを確認します。手順については、Cloud CDN の使用をご覧ください。
必要に応じて、次のコマンドで Google Cloud CLI を最新バージョンに更新します。
```
gcloud components update
```
注: gcloud CLI バージョン 316.0.0 以降を使用していることを確認してください。

ステータスコードとデフォルトの TTL

ネガティブキャッシュは、次の表に示す特定のステータスコードに適用されます。

Cloud CDN は、これらのステータスコードに次のデフォルト TTL を適用します。

ステータスコード	意味	TTL
HTTP 300	複数の選択肢があります	10 分
HTTP 301 と 308	恒久的なリダイレクト	10 分
HTTP 302 と 307	一時的なリダイレクト	デフォルトではキャッシュに保存されません
HTTP 404	見つかりませんでした	120 秒
HTTP 405	メソッドが見つかりません	60 秒
HTTP 410	存在しません	120 秒
HTTP 451	法律上の理由で利用できません	120 秒
HTTP 501	実装されていません	60 秒

これらのデフォルト値をオーバーライドするには、ネガティブキャッシュを使用して、指定された HTTP ステータスコードのキャッシュ TTL を設定します。

ネガティブキャッシュの設定

ネガティブキャッシュを使用すると、失敗と成功をキャッシュに保存するようにサービスを構成できます。これにより Cloud CDN は、成功のレスポンスを生成するリクエストから送信元を保護する場合と同様に、エラー（404 Not Found など）を生成するリクエストから送信元を保護できます。

Console

Google Cloud Console で、[ロードバランシング] ページに移動します。
[ロードバランシング] ページに移動
外部アプリケーションロードバランサの名前をクリックします。
[編集] をクリックします。
[バックエンドの構成] でバックエンドを選択し、[編集] をクリックします。
[Cloud CDN を有効にする] が選択されていることを確認します。
ウィンドウの下部にある [高度な構成] をクリックします。
[ネガティブキャッシュを有効にする] をクリックします。
[ネガティブキャッシュポリシーを追加] をクリックします。
1. HTTP ステータスコードを入力します。
2. キャッシュの有効期間（TTL）を選択します。
[更新] をクリックします。
[更新] をもう一度クリックします。

gcloud

バックエンドバケットには、--negative-caching フラグを指定して gcloud compute backend-buckets create コマンドまたは gcloud compute backend-buckets update コマンドを使用します。

バックエンドサービスには、--negative-caching フラグを指定して gcloud compute backend-services create コマンドまたは gcloud compute backend-services update コマンドを使用します。

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --negative-caching

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --negative-caching

2 つの特定のエラーレスポンスのネガティブキャッシュのみを有効にするには、ステータスコード 404 のレスポンスを 60 秒間キャッシュに保存し、ステータスコード 405 のレスポンスを 120 秒間キャッシュに保存します。

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --negative-caching \
    --cache-mode=CACHE_ALL_STATIC \
    --default-ttl=86400 \
    --negative-caching-policy='404=60,405=120'

api

バックエンドバケットには、Method: backendBuckets.insert API 呼び出しまたは Method: backendBuckets.update API 呼び出しを使用します。

バックエンドサービスには、Method: backendServices.insert API 呼び出しまたは Method: backendServices.update API 呼び出しを使用します。

次のいずれかの API 呼び出しを使用します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

JSON リクエストの本文に次のスニペットを追加します。

"cdnPolicy": {
  "negativeCaching": ON,
  "negativeCachingPolicy": [
    {
      "code": STATUS_CODE,
      "ttl": TTL_SECONDS
    }
  ]
}

negativeCachingPolicy を構成するには、ネガティブキャッシュを有効にする必要があります。ポリシーを省略し、negativeCaching を有効にしている場合、Cloud CDN はステータスコードとデフォルトの TTL にあるデフォルト値を使用します。

ネガティブキャッシュポリシーを指定する場合は、キャッシュに保存するすべてのレスポンスコードにキャッシュ TTL を指定してください。ポリシーが指定されている場合、Cloud CDN はデフォルトのネガティブキャッシュを適用しません。

STATUS_CODE には、次の HTTP ステータスコードを指定できます。

300、301、302、307、308
404、405、410、421、451
501

ステータスコードごとにレスポンスをキャッシュに保存する秒数を指定できます。ステータスコードのネガティブキャッシュを無効にするには、ネガティブキャッシュポリシーからそのコードを除外します。

最大許容値は 1,800 秒（30 分）です。ただし、アクセス頻度の少ないオブジェクトは、定義された TTL の前にキャッシュから削除されることがあります。

キャッシュモードを CACHE_ALL_STATIC または USE_ORIGIN_HEADERS に設定すると、指定したレスポンスコードを持ち、Cache-Control または Expires ヘッダーのないレスポンスにネガティブキャッシュが適用されます。

キャッシュモードが FORCE_CACHE_ALL に設定されている場合、ネガティブキャッシュは送信元によって設定されたキャッシュヘッダーをオーバーライドします。Cloud CDN は TTL で指定された時間だけ応答をキャッシュするか、TTL が設定されていない場合はまったくキャッシュしません。

また、キャッシュモードを FORCE_CACHE_ALL に設定すると、Cloud CDN は Cache-Control ヘッダーでクライアントに送信された max-age も変更します。特に、特定のエラーに TTL 設定が構成されている場合、Cloud CDN はその TTL 設定と client_ttl 構成設定の小さい方を取得し、その値を含む Cache-Control: public,max-age=N ヘッダーを送信します。特定のエラーに TTL 設定が構成されていない場合、Cloud CDN は送信元から送信された Cache-Control ヘッダーをすべて削除します。Cloud CDN は、送信元から送信された Expires ヘッダーも常に削除します。

送信元で初期からネガティブキャッシュが有効になっていて、その後（手動または特定のレスポンスコードのキャッシュ保存を無効化したことにより）無効化された場合、キャッシュに保存されたエラーレスポンスは、Cache-Control または Expires ヘッダーのみに基づいて有効と見なされます。したがって、ネガティブキャッシュを無効にすると、ヘッダーにキャッシュ保存期間ディレクティブがないレスポンスはキャッシュから提供されなくなります。

Cloud CDN は、GET リクエストに応じてキャッシュに保存します。詳しくは、キャッシュに保存可能なコンテンツをご覧ください。

各キャッシュエントリはキャッシュキーで識別されます。

ネガティブキャッシュを無効にする

Console

Google Cloud Console で、[ロードバランシング] ページに移動します。
[ロードバランシング] ページに移動
外部アプリケーションロードバランサの名前をクリックします。
[編集] をクリックします。
[バックエンドの構成] でバックエンドを選択し、[編集] をクリックします。
[Cloud CDN を有効にする] が選択されていることを確認します。
ウィンドウの下部にある [高度な構成] をクリックします。
[ネガティブキャッシュを有効にする] の横にあるチェックボックスをオフにします。
[更新] をクリックします。
[更新] をもう一度クリックします。

gcloud

バックエンドバケットには、--no-negative-caching フラグを指定して gcloud compute backend-buckets create コマンドまたは gcloud compute backend-buckets update コマンドを使用します。

バックエンドサービスには、--no-negative-caching フラグを指定して gcloud compute backend-services create コマンドまたは gcloud compute backend-services update コマンドを使用します。

gcloud compute backend-services (create | update) (BACKEND_SERVICE_NAME | BACKEND_BUCKET_NAME)
    --no-negative-caching

api

バックエンドバケットには、Method: backendBuckets.insert API 呼び出しまたは Method: backendBuckets.update API 呼び出しを使用します。

バックエンドサービスには、Method: backendServices.insert API 呼び出しまたは Method: backendServices.update API 呼び出しを使用します。

次のいずれかの API 呼び出しを使用します。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

JSON リクエストの本文に次のスニペットを追加します。

"cdnPolicy": {
  "negativeCaching": OFF
}

ネガティブ キャッシュの使用

始める前に

ステータス コードとデフォルトの TTL

ネガティブ キャッシュの設定

Console

gcloud

api

ネガティブ キャッシュを無効にする

Console

gcloud

api

ネガティブキャッシュの使用

ステータスコードとデフォルトの TTL

ネガティブキャッシュの設定

ネガティブキャッシュを無効にする