使标签失效时需要了解的事项
指定要失效的标签时,请参考以下信息:
- 需要选择加入
-
标签失效仅适用于配置了
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,则针对在旧标头名称下提取的标签发出的失效将不再进行评估。在更改标头名称之前:-
开始从源返回新的和旧的缓存标签标头。
-
发出路径失效(例如
/*)或使现有标签失效。 -
使用新的
HeaderName更新CacheTagConfig。 -
停止从源返回旧标头。
-
- 分配租户
-
还支持通过
CreateInvalidationForDistributionTenantAPI 对分配租户实施标签失效。