# タグを無効化するときに知っておくべきこと
<a name="invalidation-specifying-tags"></a>

無効にするタグを指定するときには、次の情報を参照してください。

 **オプトインが必要**   
タグ無効化は、`CacheTagConfig` が設定されているディストリビューションでのみ機能します。この設定がないディストリビューションでは、オリジンからのキャッシュタグヘッダーは無視されます。詳細については、「[キャッシュタグによるコンテンツの無効化](invalidation-by-tags.md)」を参照してください。

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

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

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

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

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

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

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

 **最大許容数**   
タグ無効化の項目数は、パス項目と同じ同時無効化制限にカウントされます。各タグ項目は 1 つの無効化パスとしてカウントされます。詳細については、「[無効化のクォータ](cloudfront-limits.md#limits-invalidations)」を参照してください。

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

1. オリジンから古いキャッシュタグヘッダーと新しいキャッシュタグヘッダーの両方を返すようにします。

1. パスの無効化 (`/*` など) を発行するか、既存のタグを無効化します。

1. `CacheTagConfig` を新しい `HeaderName` で更新します。

1. オリジンから古いヘッダーを返すのを停止します。

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