AWS::CloudFront::Distribution ForwardedValues
此字段已弃用。建议您使用缓存策略或源请求策略来代替此字段。
如果要将值包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建缓存策略。
如果希望将值发送到源,但不包含在缓存键中,请使用源请求策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建源请求策略。
指定 CloudFront 如何处理查询字符串、Cookie 和 HTTP 标头的复杂类型。
语法
要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:
JSON
{ "Cookies" :
Cookies
, "Headers" :[ String, ... ]
, "QueryString" :Boolean
, "QueryStringCacheKeys" :[ String, ... ]
}
YAML
Cookies:
Cookies
Headers:- String
QueryString:Boolean
QueryStringCacheKeys:- String
属性
Cookies
-
此字段已弃用。建议您使用缓存策略或源请求策略来代替此字段。
如果要将 Cookie 包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建缓存策略。
如果希望将 Cookie 发送到源,但不包含在缓存键中,请使用源请求策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建源请求策略。
一个复杂类型,用于指定您是否希望 CloudFront 将 Cookie 转发到源,如果转发到源,则转发到哪些源。有关将 Cookie 转发到源的更多信息,请参阅 Amazon CloudFront 开发人员指南 中的 CloudFront 如何转发、缓存和记录 Cookie。
必需:否
类型:Cookies
Update requires: No interruption
Headers
-
此字段已弃用。建议您使用缓存策略或源请求策略来代替此字段。
如果要将标头包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建缓存策略。
如果希望将标头发送到源,但不包含在缓存键中,请使用源请求策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建源请求策略。
一个复杂类型,用于指定您希望 CloudFront 转发到此缓存行为的源的
Headers
(如有)。对于您指定的标头,CloudFront 还将缓存基于查看器请求中的标头值的指定对象的各个版本。有关更多信息,请参阅 Amazon CloudFront 开发人员指南 中的根据请求标头缓存内容。
必需:否
类型:字符串列表
Update requires: No interruption
QueryString
-
此字段已弃用。建议您使用缓存策略或源请求策略来代替此字段。
如果要将查询字符串包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建缓存策略。
如果希望将查询字符串发送到源,但不包含在缓存键中,请使用源请求策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建源请求策略。
指示您是否希望 CloudFront 将查询字符串转发到与此缓存行为关联的源并基于查询字符串参数进行缓存。CloudFront 行为取决于
QueryString
的值以及为QueryStringCacheKeys
指定的值(如果有):如果为
QueryString
指定 true,并且没有为QueryStringCacheKeys
指定任何值,CloudFront 会将所有查询字符串参数转发到来源,并基于所有查询字符串参数进行缓存。根据拥有的查询字符串参数的个数和值,这可能对性能产生不利影响,因为 CloudFront 必须将更多的请求转发到源。如果为
QueryString
指定 true,并且为QueryStringCacheKeys
指定一个或多个值,CloudFront 会将所有查询字符串参数转发到来源,但仅基于指定的查询字符串参数进行缓存。如果为
QueryString
指定 false,CloudFront 不会将任何查询字符串参数转发到来源,也不会基于查询字符串参数进行缓存。有关更多信息,请参阅 Amazon CloudFront 开发人员指南 中的将 CloudFront 配置为基于查询字符串参数进行缓存。
必需:是
类型:布尔值
Update requires: No interruption
QueryStringCacheKeys
-
此字段已弃用。建议您使用缓存策略或源请求策略来代替此字段。
如果要将查询字符串包含在缓存键中,请使用缓存策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建缓存策略。
如果希望将查询字符串发送到源,但不包含在缓存键中,请使用源请求策略。有关更多信息,请参阅 Amazon CloudFront 开发人员指南中的创建源请求策略。
一个复杂类型,包含您希望 CloudFront 用于针对此缓存行为进行缓存的查询字符串参数信息。
必需:否
类型:字符串列表
Update requires: No interruption
另请参阅
-
Amazon CloudFront API 参考 中的 ForwardedValues