AWS::CloudFront::Distribution ForwardedValues - AWS CloudFormation
语法属性另请参阅
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

另请参阅