キャッシュタグでキャッシュをパージする

キャッシュタグでのパージは、複数ファイルのパージを簡単にします。ウェブページや画像など、アセットにキャッシュタグを付けると、まとめて即座にパージできます。

1. ページや静的アセットなどのウェブコンテンツに対し、オリジンのウェブサーバーから Cache-Tag HTTP レスポンスヘッダーにタグを追加します。
2. ウェブトラフィックが Cloudflare で プロキシされていること を確認します。
3. Cloudflare は、Cache-Tag HTTP ヘッダーのタグを、キャッシュするコンテンツに関連付けます。
4. ダッシュボードまたは API で、特定のキャッシュタグを指定して、そのタグを含むコンテンツを Cloudflare CDN キャッシュから即座にパージします。
5. Cloudflare は、パージしたキャッシュタグを持つコンテンツに対して キャッシュ MISS を強制します。

ウェブコンテンツに Cache-Tag HTTP レスポンスヘッダーでキャッシュタグを付けると、クライアントとサーバーがリクエストやレスポンスに追加情報を渡せます。HTTP ヘッダーは、大文字小文字を区別しない名前、コロン :、有効な値で構成されます。例: Cache-Tag:tag1,tag2,tag3。複数のキャッシュタグを使う場合は、カンマで区切ります。

コンテンツがエッジネットワークに届くと、Cloudflare は次を行います。

• 訪問者へレスポンスを返す前、または Worker へ渡す前に、Cache-Tag HTTP ヘッダーを削除します。Cloudflare を有効にしたサイトでは、エンドユーザーや Worker が Cache-Tag HTTP ヘッダーを見ることはありません。
• ヘッダー内の空白と、キャッシュタグ名の前後の空白を削除します。tag1、tag2 と tag1,tag2 は同じとみなします。
• キャッシュタグを適用する前に、連続したカンマと末尾のカンマをすべて削除します。tag1,,,tag2 と tag1,tag2 は同じとみなします。

• 1 つの HTTP レスポンスに、複数の Cache-Tag HTTP ヘッダーフィールドを含められます。
• キャッシュタグの最小長は 1 バイトです。
• 個々のタグに最大長はありません。ただし、ヘッダーフィールド名を除いた Cache-Tag HTTP ヘッダー全体は 16 KB を超えられません。おおよそ 1,000 個の一意なタグです。長さには空白とカンマを含み、ヘッダーフィールド名は含みません。
• キャッシュパージでは、API 呼び出し内のキャッシュタグの最大長は 1,024 文字です。
• Cache-Tag HTTP ヘッダーには、印字可能な ASCII 文字だけを含めます。
• キャッシュタグにスペースは使えません。
• 大文字小文字は区別しません。たとえば Tag1 と tag1 は同じとみなします。

1. Cloudflare ダッシュボードで、Configuration ページを開きます。

   Configuration を開く ↗

2. Purge Cache で Custom Purge を選択します。Custom Purge ウィンドウが開きます。

3. Purge by で Tag を選択します。

4. テキストボックスに、キャッシュ済みリソースをパージするタグを入力します。複数のキャッシュタグ付きリソースをパージする場合は、タグをカンマで区切るか、1 行に 1 タグとします。一度にパージできるタグは 100 個までです。

5. Purge を選択します。

レート制限については 提供状況と制限 を参照してください。

タグでパージするとリソースが削除され、その後のリクエストでは CF-Cache-Status ヘッダーが MISS になります。

Tiered Cache を使っている場合、タグパージは EXPIRED を返すことがあります。下位ティアが上位ティアへ再検証し、上位ティアの負荷を減らすためです。 上位ティアにリソースがあるかどうか、エンドユーザーが下位ティアと上位ティアのどちらに届くかによって、EXPIRED または MISS が返ります。