登录控制台
AWS CloudFormation
User Guide (API 版本 2010-05-15)
AWS 文档 » AWS CloudFormation » User Guide » 模板参考 » 资源属性类型参考 » Amazon S3 Bucket Rule
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

Amazon S3 Bucket Rule

Rule 属性类型描述生命周期规则。Amazon S3 Bucket LifecycleConfiguration 属性的 Rules 子属性包含一个 Rule 属性类型列表。有关更多信息，请参阅 Amazon Simple Storage Service (Amazon S3) API 参考中的 PUT Bucket 生命周期。

语法

JSON

{
  "AbortIncompleteMultipartUpload" : AbortIncompleteMultipartUpload,
  "ExpirationDate" : String,
  "ExpirationInDays" : Integer,
  "Id" : String,
  "NoncurrentVersionExpirationInDays" : Integer,
  "NoncurrentVersionTransition（已淘汰）" : NoncurrentVersionTransition,
  "NoncurrentVersionTransitions" : [ NoncurrentVersionTransition, ... ],
  "Prefix" : String,
  "Status" : String,
  "TagFilters" : [ TagFilter, ... ],
  "Transition（已淘汰）" : Transition,
  "Transitions" : [ Transition, ... ]
}

YAML

AbortIncompleteMultipartUpload: 
  AbortIncompleteMultipartUpload
ExpirationDate: String
ExpirationInDays: Integer
Id: String
NoncurrentVersionExpirationInDays: Integer
NoncurrentVersionTransition（已淘汰）:
  NoncurrentVersionTransition
NoncurrentVersionTransitions:
  - NoncurrentVersionTransition
Prefix: String
Status: String
TagFilters: 
  - TagFilter
Transition（已淘汰）:
  Transition
Transitions:
  - Transition

属性

AbortIncompleteMultipartUpload

指定一个生命周期规则，以中止向 Amazon S3 存储桶进行的未完成分段上传。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

Type: Amazon S3 Bucket AbortIncompleteMultipartUpload

ExpirationDate

指示从 Amazon S3 和 Glacier 中删除对象的时间。该日期值必须采用 ISO 8601 格式。时间始终为午夜 UTC。如果您指定过期和转换时间，则必须对两个属性使用相同的时间单位（按天数或按日期）。过期时间还必须晚于转换时间。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

Type: String

ExpirationInDays

指示对象在创建多少天后从 Amazon S3 和 Glacier 中删除。如果您指定过期和转换时间，则必须对两个属性使用相同的时间单位（按天数或按日期）。过期时间还必须晚于转换时间。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

Type: Integer

Id

此规则的唯一标识符。值不能多于 255 个字符。

Required: No

Type: String

NoncurrentVersionExpirationInDays

对于已启用（或暂停）版本控制的存储桶，请指定新版本的对象上传到存储桶和旧版本的对象过期之间的时间长度（以天为单位）。当对象版本过期时，Amazon S3 将永久删除它们。如果您指定了转换时间和过期时间，过期时间必须晚于转换时间。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

Type: Integer

NoncurrentVersionTransition（已淘汰）

对于已启用（或暂停）版本控制的存储桶，请指定非当前对象转换为指定存储类的时间。如果您指定了转换时间和过期时间，过期时间必须晚于转换时间。如果您指定了此属性，请勿指定 NoncurrentVersionTransitions 属性。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

类型：Amazon S3 Bucket NoncurrentVersionTransition

NoncurrentVersionTransitions

对于已启用（或暂停）版本控制的存储桶，为一个或多个指定非当前对象转换为指定存储类的时间的转换规则。如果您指定了转换时间和过期时间，过期时间必须晚于转换时间。如果您指定了此属性，请勿指定 NoncurrentVersionTransition 属性。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

类型：Amazon S3 Bucket NoncurrentVersionTransition 的列表

Prefix

标识要应用此规则的一个或多个对象的对象键前缀。

Required: No

Type: String

Status

指定 Enabled 或 Disabled。如果您指定 Enabled，则 Amazon S3 将按计划执行此规则。如果您指定 Disabled，则 Amazon S3 将忽略此规则。

Required: Yes

Type: String

TagFilters

用于标识将应用生命周期规则的对象子集的标签。

必需：否

类型：Amazon S3 Bucket TagFilter 的列表

更新要求：无需中断

Transition（已淘汰）

指定对象转换为指定存储类的时间。如果您指定过期和转换时间，则必须对两个属性使用相同的时间单位（按天数或按日期）。过期时间还必须晚于转换时间。如果您指定了此属性，请勿指定 Transitions 属性。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

类型：Amazon S3 存储桶转换

Transitions

一个或多个指定对象转换到指定存储类的规则。如果您指定过期和转换时间，则必须对两个属性使用相同的时间单位（按天数或按日期）。过期时间还必须晚于转换时间。如果您指定了此属性，请勿指定 Transition 属性。

Required: Conditional。您必须至少指定以下属性之一：AbortIncompleteMultipartUpload、ExpirationDate、ExpirationInDays、NoncurrentVersionExpirationInDays、NoncurrentVersionTransition、NoncurrentVersionTransitions、Transition 或 Transitions。

类型：Amazon S3 存储桶转换 的列表

本页内容：