AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

CloudFront DistributionConfig CacheBehavior

CacheBehaviorDistributionConfig 属性的属性,用于描述请求的 URL 与模式匹配时的 Amazon CloudFront (CloudFront) 缓存行为。

语法

JSON

Copy
{ "AllowedMethods" : [ String, ... ], "CachedMethods" : [ String, ... ], "Compress" : Boolean, "DefaultTTL" : Number, "ForwardedValues" : ForwardedValues, "MaxTTL" : Number, "MinTTL" : Number, "PathPattern" : String, "SmoothStreaming" : Boolean, "TargetOriginId" : String, "TrustedSigners" : [ String, ... ], "ViewerProtocolPolicy" : String }

YAML

Copy
AllowedMethods: - 字符串 CachedMethods: - 字符串 Compress: Boolean DefaultTTL: Number ForwardedValues: ForwardedValues MaxTTL: Number MinTTL: Number PathPattern: String SmoothStreaming: Boolean TargetOriginId: String TrustedSigners: - 字符串 ViewerProtocolPolicy: String

属性

注意

有关每个属性的约束和有效值的更多信息,请参阅 Amazon CloudFront API Reference 中的 CacheBehavior 数据类型。

AllowedMethods

CloudFront 处理并转发到您的 Amazon S3 存储桶或自定义源的 HTTP 方法。可以指定 ["HEAD", "GET"]["GET", "HEAD", "OPTIONS"]["DELETE", "GET", "HEAD", "OPTIONS", "PATCH", "POST", "PUT"]。如果不指定值,则 AWS CloudFormation 指定 ["HEAD", "GET"]

Required: No

Type: List of String values

CachedMethods

CloudFront 为其缓存响应的 HTTP 方法。您可以指定 ["HEAD", "GET"]["GET", "HEAD", "OPTIONS"]。如果不指定值,则 AWS CloudFormation 指定 ["HEAD", "GET"]

Required: No

Type: List of String values

Compress

指示 CloudFront 是否自动压缩此缓存行为的某些文件。有关更多信息,请参阅 Amazon CloudFront 开发人员指南 中的提供压缩文件

Required: No

Type: Boolean

DefaultTTL

对象在 CloudFront 缓存中保留的默认时间(以秒为单位),此时间之后,CloudFront 会向您的自定义源转发另一个请求,以确定此对象是否已更新。此值仅在您的自定义源未向对象添加 HTTP 标头(如 Cache-Control max-ageCache-Control s-maxageExpires)时应用。

默认情况下,AWS CloudFormation 指定 86400 秒(一天)。如果 MinTTL 属性的值大于默认值,则 CloudFront 使用最小的生存时间 (TTL) 值。

Required: No

Type: Number

ForwardedValues

指定 CloudFront 如何处理查询字符串或 Cookie。

Required: Yes

类型ForwardedValues 类型

MaxTTL

对象在 CloudFront 缓存中保留的最长时间(以秒为单位),此时间之后,CloudFront 会向您的自定义源转发另一个请求,以确定此对象是否已更新。此值仅在您的自定义源未向对象添加 HTTP 标头(如 Cache-Control max-ageCache-Control s-maxageExpires)时应用。

默认情况下,AWS CloudFormation 指定 31536000 秒(一年)。如果 MinTTLDefaultTTL 属性的值大于最大值,则 CloudFront 使用默认的 TTL 值。

Required: No

Type: Number

MinTTL

您希望在 CloudFront 查询源以了解数据元是否已更新之前,数据元保留在缓存中的最短时长。

Required: No

Type: Number

PathPattern

应用此缓存行为的模式。例如,您可以指定 images/*.jpg

CloudFront 接收到最终用户请求时,CloudFront 按照缓存行为在模板中的列出顺序,将请求路径与路径模式进行比较。

Required: Yes

Type: String

SmoothStreaming

指示是否使用与此缓存行为关联的源,以 Microsoft 平滑流格式分发媒体文件。如果您指定 true,则仍可以使用此缓存行为分配其他内容,只要该内容与 PathPattern 值匹配。

Required: No

Type: Boolean

TargetOriginId

在请求与 PathPattern 属性的值匹配时,您希望 CloudFront 将请求发送到的目标源的 ID 值。

Required: Yes

Type: String

TrustedSigners

可以创建签名 URL 以便访问私有内容的 AWS 账户的列表。

Required: No

Type: List of String values

ViewerProtocolPolicy

当请求与 PathPattern 属性的值匹配时,用户可用于访问 TargetOriginId 属性中指定源内文件的协议。有关有效值的更多信息,请参阅 Amazon CloudFront API Reference 中的 CacheBehavior 数据类型的 ViewerProtocolPolicy 内容。

Required: Yes

Type: String

本页内容: