View a markdown version of this page

使标签失效时需要了解的事项 - Amazon CloudFront

使标签失效时需要了解的事项

指定要失效的标签时,请参考以下信息:

需要选择加入

标签失效仅适用于配置了 CacheTagConfig 的分配。没有此配置的分配会忽略源中的缓存标签标头。有关更多信息,请参阅 按缓存标签使内容失效

标签失效前缀

标签失效项必须以 # 字符开头。例如,要使所有标记为 product:electronics 的缓存对象失效,请在 Paths.Items 列表中指定 #product:electronics

是否区分大小写

标签值不区分大小写。例如,#Product:Electronics #product:electronics 指同一个标签。

标记格式

每个标签值只能包含 ASCII 可见字符(33–126),不包括逗号。标签的最大长度为 256 个字符。

无通配符支持

与路径失效不同,标签失效项不支持 * 通配符。每个带 # 前缀的项都与确切的标签值相匹配。

每个缓存对象的最大标签数

CloudFront 为每个缓存的对象最多处理 50 个标签。如果源响应在配置的标头中包含 50 个以上的标签,则不会存储超出限制的附加标签,且这些附加标签也不能用于失效。

转发 Cookie、标头和查询字符串

当您按标签失效时,无论关联的 Cookie、标头或查询字符串参数如何,CloudFront 都会使带有指定标签的每个对象的每个缓存变体失效。您不能有选择地使某些变体无效,而不使其它变体失效。

混合路径失效和标签失效

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

允许的最大值

标签失效项计入与路径项相同的并发失效限制。每个标签项都计为一个失效路径。有关更多信息,请参阅 有关失效的配额

更改标头名称

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

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

  2. 发出路径失效(例如 /*)或使现有标签失效。

  3. 使用新的 HeaderName 更新 CacheTagConfig

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

分配租户

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