TTL の設定とオーバーライドの変更

このページでは、Cloud CDN で TTL オーバーライドを変更する方法について説明します。TTL オーバーライドを使用すると、Cloud CDN によってコンテンツが再検証までにキャッシュに保存される期間を詳細に制御できます。

次の表に、TTL 設定の概要を示します。

始める前に

• キャッシュ モードについて確認します。

• Cloud CDN が有効になっていることを確認します。手順については、Cloud CDN の使用をご覧ください。

• 必要に応じて、次のコマンドで Google Cloud CLI を最新バージョンに更新します。

  gcloud components update
  

デフォルトの TTL を設定する

デフォルトの TTL をオーバーライドして、Cloud CDN が送信元のコンテンツを再検証する頻度を下げることで、更新頻度の低いコンテンツのキャッシュ ヒット率を向上させることができます。ただし、アクセス頻度の少ないオブジェクトが、定義された TTL の前にキャッシュから除外される場合があります。

キャッシュ モードが FORCE_CACHE_ALL の場合、デフォルトの TTL は、すべてのレスポンスに設定されている TTL（送信元のヘッダーで TTL が設定されているレスポンスを含む）を上書きします。このモードでは、デフォルトの TTL はクライアントに表示されます。これは、Cloud CDN がクライアントに配信されるレスポンスの public 属性と max-age 属性を設定するためです。

CACHE_ALL_STATIC モードの場合、有効な TTL（max-age、s-maxage、または Expires ヘッダー）がないレスポンスに対して送信元から提供されたキャッシュ内のコンテンツにデフォルトの TTL が適用されます。CACHE_ALL_STATIC モードの場合、デフォルトの TTL でクライアントに配信される Cache-Control ヘッダーは変更されません。CACHE_ALL_STATIC モードで Cache-Control ヘッダーを変更するには、クライアント TTL を設定する必要があります。

送信元のヘッダー（USE_ORIGIN_HEADERS）を使用するようにキャッシュ モードを設定すると、Cloud CDN は max-age または s-maxage の送信元のディレクティブ、または Expires ヘッダーを代わりに使用するため、デフォルトの TTL 値は適用されず、設定できません。

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --default-ttl=DEFAULT_TTL

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --default-ttl=DEFAULT_TTL

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

"cdnPolicy": {
  "defaultTtl": DEFAULT_TTL
}

最大 TTL を設定する

最大 TTL は、送信元から配信されるキャッシュ コンテンツに関して Cloud CDN 内で許可される TTL の上限を指定します。

次のいずれかに該当する場合に、レスポンスの TTL に対して最大 TTL によって上限が設定されます。

• レスポンスは、max-age または s-maxage を最大 TTL 値よりも高い値に設定することを試みます。
• 今後、レスポンスには cdnPolicy.maxTtl 秒を超える Expires ヘッダーが含まれます。

最大 TTL の設定は、クライアントに送信される max-age の値を変更しません。詳細については、最大クライアント TTL のオーバーライドをご覧ください。最大 TTL の設定は、Cloud CDN がコンテンツのキャッシュへの保存を試行する時間の長さにのみ影響します。

この設定は、キャッシュ モードが CACHE_ALL_STATIC の場合にのみ使用されます。最大許容値は 31,622,400 秒（1 年）です。ただし、アクセス頻度の少ないオブジェクトが、定義された TTL の前にキャッシュから除外される場合があります。

FORCE_CACHE_ALL では、TTL は常にデフォルトの TTL に設定されます。最大 TTL の設定はできません。