

# 使标签失效时需要了解的事项
<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、标头和查询字符串**   
当您按标签失效时，无论关联的 Cookie、标头或查询字符串参数如何，CloudFront 都会使带有指定标签的每个对象的每个缓存变体失效。您不能有选择地使某些变体无效，而不使其它变体失效。

 **混合路径失效和标签失效**   
您可以在 `CreateInvalidation` 请求的同一个失效批次中同时包含路径项（例如 `/images/*`）和标签项（例如 `#brand:acme`）。每个项都计为一个通往极限的失效路径。

 **允许的最大值**   
标签失效项计入与路径项相同的并发失效限制。每个标签项都计为一个失效路径。有关更多信息，请参阅 [有关失效的配额](cloudfront-limits.md#limits-invalidations)。

 **更改标头名称**   
如果您在 `CacheTagConfig` 中更改 `HeaderName`，则针对在旧标头名称下提取的标签发出的失效将不再进行评估。在更改标头名称之前：  

1. 开始从源返回新的和旧的缓存标签标头。

1. 发出路径失效（例如 `/*`）或使现有标签失效。

1. 使用新的 `HeaderName` 更新 `CacheTagConfig`。

1. 停止从源返回旧标头。

 **分配租户**   
还支持通过 ` CreateInvalidationForDistributionTenant` API 对分配租户实施标签失效。