タグを無効化するときに知っておくべきこと

タグ無効化は、CacheTagConfig が設定されているディストリビューションでのみ機能します。この設定がないディストリビューションでは、オリジンからのキャッシュタグヘッダーは無視されます。詳細については、「キャッシュタグによるコンテンツの無効化」を参照してください。

タグ無効化項目は、# 文字で始まる必要があります。例えば、product:electronics というタグが付いたキャッシュされたオブジェクトをすべて無効にするには、Paths.Items リストで #product:electronics を指定します。

タグ値は大文字と小文字を区別しません。例えば、#Product:Electronics と #product:electronics は同じタグを参照します。

各タグ値には、カンマを除く ASCII 表示文字 (33～126) のみを含める必要があります。タグの最大長は 256 文字です。

パスの無効化とは異なり、タグ無効化項目は * ワイルドカードをサポートしていません。# プレフィックスが付いた各項目は、タグ値と完全に一致します。

CloudFront は、キャッシュされたオブジェクトごとに最大 50 個のタグを処理します。オリジンレスポンスの設定済みヘッダーに 50 個を超えるタグが含まれている場合、制限を超える追加のタグは保存されず、無効化には使用できません。

タグで無効化すると、CloudFront は、関連付けられた Cookie、ヘッダー、またはクエリ文字列パラメータに関係なく、指定されたタグを持つすべてのオブジェクトのキャッシュされたバリアントをすべて無効にします。一部のバリアントだけを選択的に無効にし、他は無効化しないということはできません。

CreateInvalidation リクエストでは、パス項目 (/images/* など) とタグ項目 (#brand:acme など) の両方を同じ無効化バッチに含めることができます。各項目は、制限に対する 1 つの無効化パスとしてカウントされます。

タグ無効化の項目数は、パス項目と同じ同時無効化制限にカウントされます。各タグ項目は 1 つの無効化パスとしてカウントされます。詳細については、「無効化のクォータ」を参照してください。

CacheTagConfig で HeaderName を変更すると、古いヘッダー名で抽出されたタグに対して発行された無効化は評価されなくなります。ヘッダー名を変更する前に以下を行います。

タグ無効化は、 CreateInvalidationForDistributionTenant API を介したディストリビューションテナントでもサポートされています。