AWS::S3::Bucket Rule
指定 Amazon S3 存储桶的生命周期规则。有关更多信息,请参阅 Amazon Simple Storage Service API 参考 中的 Put Bucket 生命周期配置。有关示例,请参阅 Put Bucket 生命周期配置示例
语法
要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:
JSON
{ "AbortIncompleteMultipartUpload" :
AbortIncompleteMultipartUpload
, "ExpirationDate" :Timestamp
, "ExpirationInDays" :Integer
, "Id" :String
, "NoncurrentVersionExpirationInDays" :Integer
, "NoncurrentVersionTransition" :NoncurrentVersionTransition
, "NoncurrentVersionTransitions" :[ NoncurrentVersionTransition, ... ]
, "Prefix" :String
, "Status" :String
, "TagFilters" :[ TagFilter, ... ]
, "Transition" :Transition
, "Transitions" :[ Transition, ... ]
}
YAML
AbortIncompleteMultipartUpload:
AbortIncompleteMultipartUpload
ExpirationDate:Timestamp
ExpirationInDays:Integer
Id:String
NoncurrentVersionExpirationInDays:Integer
NoncurrentVersionTransition:NoncurrentVersionTransition
NoncurrentVersionTransitions:- NoncurrentVersionTransition
Prefix:String
Status:String
TagFilters:- TagFilter
Transition:Transition
Transitions:- Transition
属性
AbortIncompleteMultipartUpload
-
指定停止指向 Amazon S3 存储桶的未完成分段上传的生命周期规则。
您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:AbortIncompleteMultipartUpload
Update requires: No interruption
ExpirationDate
-
指示从 Amazon S3 和 Amazon S3 Glacier 中删除对象的时间。该日期值必须采用 ISO 8601 格式。时间始终为午夜 UTC。如果您指定过期和转换时间,则必须对两个属性使用相同的时间单位 (按天数或按日期)。过期时间还必须晚于转换时间。
您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:Timestamp
Update requires: No interruption
ExpirationInDays
-
指示在创建多少天之后将对象从 Amazon S3 和 Amazon S3 Glacier 中删除。如果您指定过期和转换时间,则必须对两个属性使用相同的时间单位 (按天数或按日期)。过期时间还必须晚于转换时间。
您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:整数
Update requires: No interruption
Id
-
规则的唯一标识符。该值不能超过 255 个字符。
必需:否
类型:字符串
Update requires: No interruption
NoncurrentVersionExpirationInDays
-
对于已启用 (或暂停) 版本控制的存储桶,请指定新版本的对象上传到存储桶和旧版本的对象过期之间的时间长度 (以天为单位)。当对象版本过期时,Amazon S3 将永久删除它们。如果您指定了转换时间和过期时间,过期时间必须晚于转换时间。
您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:整数
Update requires: No interruption
NoncurrentVersionTransition
-
(已弃用。) 对于已启用 (或暂停) 版本控制的存储桶,请指定非当前对象转换为指定存储类的时间。如果您指定了转换时间和过期时间,过期时间必须晚于转换时间。如果您指定了此属性,请勿指定
NoncurrentVersionTransitions
属性。您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:NoncurrentVersionTransition
Update requires: No interruption
NoncurrentVersionTransitions
-
对于已启用 (或暂停) 版本控制的存储桶,为一个或多个指定非当前对象转换为指定存储类的时间的转换规则。如果您指定了转换时间和过期时间,过期时间必须晚于转换时间。如果您指定了此属性,请勿指定
NoncurrentVersionTransition
属性。您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:NoncurrentVersionTransition 的列表
Update requires: No interruption
Prefix
-
标识要应用此规则的一个或多个对象的对象键前缀。
必需:否
类型:字符串
Update requires: No interruption
Status
-
如果为
Enabled
,则当前应用了该规则。如果为Disabled
,则当前未应用该规则。必需:是
类型:字符串
允许的值:
Disabled | Enabled
Update requires: No interruption
TagFilters
-
用于标识将应用生命周期规则的对象子集的标签。
必需:否
类型:TagFilter 的列表
Update requires: No interruption
Transition
-
(已弃用。) 指定对象转换为指定存储类的时间。如果您指定过期和转换时间,则必须对两个属性使用相同的时间单位 (按天数或按日期)。过期时间还必须晚于转换时间。如果您指定了此属性,请勿指定
Transitions
属性。您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:Transition
Update requires: No interruption
Transitions
-
一个或多个指定对象转换到指定存储类的规则。如果您指定过期和转换时间,则必须对两个属性使用相同的时间单位 (按天数或按日期)。过期时间还必须晚于转换时间。如果您指定了此属性,请勿指定
Transition
属性。您必须至少指定以下属性之一:
AbortIncompleteMultipartUpload
、ExpirationDate
、ExpirationInDays
、NoncurrentVersionExpirationInDays
、NoncurrentVersionTransition
、NoncurrentVersionTransitions
、Transition
或Transitions
。必需:条件
类型:转换的列表
Update requires: No interruption
另请参阅
-
AWS::S3::Bucket 示例