Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

S3 生命周期配置的示例

此部分提供 S3 生命周期配置的示例。每个示例演示如何在各个示例方案中指定 XML。

在创建后的一天内归档所有对象

每个 S3 生命周期规则都包含一个筛选条件，该筛选条件可用于确定存储桶中适用 S3 生命周期规则的一部分对象。以下 S3 生命周期配置显示了如何指定筛选条件的示例。

临时禁用生命周期规则

可以使用 status 元素临时禁用 S3 生命周期规则。如果您想在不覆盖现有规则的情况下测试新规则或排查配置问题，这可能很有用。以下 S3 生命周期配置指定了两个规则：

在此配置中，启用了规则 1 但禁用了规则 2。Amazon S3 忽略禁用的规则。

<LifecycleConfiguration>
  <Rule>
    <ID>Rule1</ID>
    <Filter>
      <Prefix>logs/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>0</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>Rule2</ID>
    <Filter>
      <Prefix>documents/</Prefix>
    </Filter>
    <Status>Disabled</Status>
    <Transition>
      <Days>0</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

在对象的生命周期内逐步将存储类降级

在本示例中，您使用 S3 生命周期配置在对象的生命周期内逐步将存储类降级。级别降低可帮助减少存储成本。有关定价的更多信息，请参阅 Amazon S3 定价。

以下 S3 生命周期配置指定了应用于带键名前缀 logs/ 的对象的规则。该规则指定了以下操作：

<LifecycleConfiguration>
  <Rule>
    <ID>example-id</ID>
    <Filter>
       <Prefix>logs/</Prefix>
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>STANDARD_IA</StorageClass>
    </Transition>
    <Transition>
      <Days>90</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

指定多个规则

如果您希望不同的对象有不同的 S3 生命周期操作，则可以指定多个规则。以下 S3 生命周期配置有两个规则：

<LifecycleConfiguration>
    <Rule>
        <ID>ClassADocRule</ID>
        <Filter>
           <Prefix>classA/</Prefix>        
        </Filter>
        <Status>Enabled</Status>
        <Transition>        
           <Days>365</Days>        
           <StorageClass>GLACIER</StorageClass>       
        </Transition>    
        <Expiration>
             <Days>3650</Days>
        </Expiration>
    </Rule>
    <Rule>
        <ID>ClassBDocRule</ID>
        <Filter>
            <Prefix>classB/</Prefix>
        </Filter>
        <Status>Enabled</Status>
        <Transition>        
           <Days>90</Days>        
           <StorageClass>STANDARD_IA</StorageClass>       
        </Transition>    
        <Expiration>
             <Days>365</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

为启用了版本控制的存储桶指定生命周期规则

假设您有一个启用了版本控制的存储桶，这意味着对于每个对象，您都有一个当前版本以及零个或零个以上的非当前版本。（有关 S3 版本控制的更多信息，请参阅 使用 S3 版本控制保留对象的多个版本。）

在下面的示例中，您想要保留一年的历史记录，然后保留 5 个非当前版本。S3 生命周期配置支持保留任何对象的 1 至 100 个版本。请注意，在 Amazon S3 可以使给定版本到期之前，必须存在超过 5 个较新的非当前版本。Amazon S3 将永久删除超过要保留的指定数量的任何其它非当前版本。要进行删除，必须同时超过 NoncurrentDays 和 NewerNoncurrentVersions 的值。

为了节省存储开销，您希望在非现行的版本成为非现行（假设这些非现行的对象是不需要实时访问的冷数据）后 30 天将非现行的版本移至 S3 Glacier Flexible Retrieval。此外，您还期望在对象创建 90 天后降低当前版本的访问频率，因此您可能会选择将这些对象移动到 S3 Standard-IA 存储类。

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Filter>
           <Prefix></Prefix>
        </Filter>
        <Status>Enabled</Status>
        <Transition>
           <Days>90</Days>
           <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <NoncurrentVersionTransition>      
            <NoncurrentDays>30</NoncurrentDays>      
            <StorageClass>GLACIER</StorageClass>   
        </NoncurrentVersionTransition>    
       <NoncurrentVersionExpiration>     
            <NewerNoncurrentVersions>5</NewerNoncurrentVersions>
            <NoncurrentDays>365</NoncurrentDays>    
       </NoncurrentVersionExpiration> 
    </Rule>
</LifecycleConfiguration>

在启用了版本控制的存储桶中移除到期对象删除标记

已启用版本控制的存储桶的每个对象有一个当前版本，以及零个或多个非当前版本。在删除对象时，请注意以下几点：

此示例演示了可在存储桶中创建过期对象删除标记的场景，以及如何使用 S3 生命周期配置指示 Amazon S3 删除过期对象删除标记。

假设您编写了一个 S3 生命周期配置，该配置使用 NoncurrentVersionExpiration 操作以在对象变为非当前版本 30 天之后移除这些非当前版本，并保留 10 个非当前版本，如下面的示例所示。请注意，在 Amazon S3 可以使给定版本到期之前，必须存在超过 10 个较新的非当前版本。Amazon S3 将永久删除超过要保留的指定数量的任何其它非当前版本。要进行删除，必须同时超过 NoncurrentDays 和 NewerNoncurrentVersions 的值。

<LifecycleConfiguration>
    <Rule>
        ...
        <NoncurrentVersionExpiration>     
            <NewerNoncurrentVersions>10</NewerNoncurrentVersions>
            <NoncurrentDays>30</NoncurrentDays>    
        </NoncurrentVersionExpiration>
    </Rule>
</LifecycleConfiguration>

NoncurrentVersionExpiration 操作不应用于当前的对象版本。它只会移除非当前版本。

对于当前对象版本，您可以根据当前对象版本是否遵循了明确定义的生命周期，通过以下方式管理其生命周期：

通过在 Expiration 操作中将 ExpiredObjectDeleteMarker 元素设为 true，您可以指示 Amazon S3 移除过期对象删除标记。

用于中止分段上传的生命周期配置

您可以使用 Amazon S3 的分段上传 REST API 操作来在分段中上载大型对象。有关分段上传的更多信息，请参阅 在 Amazon S3 中使用分段上传来上传和复制对象。

通过使用 S3 生命周期配置，当分段上传在指定的启动后的天数内未完成时，您可以指示 Amazon S3 停止未完成的分段上传（通过在规则中指定的键名称前缀确定）。当 Amazon S3 中止分段上传时，它将删除与分段上传关联的所有分段。此流程通过确保您没有包含存储在 Amazon S3 中的分段的未完成分段上传，从而帮助控制存储成本。

下面是使用 AbortIncompleteMultipartUpload 操作指定规则的示例 S3 生命周期配置。此操作将指引 Amazon S3 在分段上传启动 7 天后停止未完成的分段上传。

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Filter>
           <Prefix>SomeKeyPrefix/</Prefix>
        </Filter>
        <Status>rule-status</Status>
        <AbortIncompleteMultipartUpload>
          <DaysAfterInitiation>7</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

使没有数据的非当前对象到期

您可以创建仅根据对象的大小转换对象的规则。您可以指定最小大小（ObjectSizeGreaterThan）或最大大小（ObjectSizeLessThan），也可以指定一个对象大小范围，单位为字节。当使用多个筛选条件（如前缀和大小规则）时，必须将筛选条件包装在 <And> 元素中。

<LifecycleConfiguration>
  <Rule>
    <ID>Transition with a prefix and based on size</ID>
    <Filter>
       <And>
          <Prefix>tax/</Prefix>
          <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>
       </And>   
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>365</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

当通过同时使用 ObjectSizeGreaterThan 和 ObjectSizeLessThan 元素指定范围时，最大对象大小必须大于最小对象大小。当使用多个筛选条件时，必须将筛选条件包装在 <And> 元素中。以下示例显示了如何指定范围在 500 字节到 64000 字节之间的对象。指定范围时，ObjectSizeGreaterThan 和 ObjectSizeLessThan 筛选条件不包含所指定的值。有关更多信息，请参阅 Filter 元素。

<LifecycleConfiguration>
    <Rule>
        ...
          <And>
             <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>
             <ObjectSizeLessThan>64000</ObjectSizeLessThan>
          </And>
    </Rule>
</LifecycleConfiguration>

您还可以创建规则，专门使没有数据的非当前对象过期，包括在启用版本控制的存储桶中创建的非当前删除标记对象。以下示例使用 NoncurrentVersionExpiration 操作，在对象变为非当前版本 30 天之后移除这些非当前版本，并保留 10 个非当前对象版本。本示例还使用 ObjectSizeLessThan 元素来只筛选没有数据的对象。

请注意，在 Amazon S3 可以使给定版本到期之前，必须存在超过 10 个较新的非当前版本。Amazon S3 将永久删除超过要保留的指定数量的任何其它非当前版本。要进行删除，必须同时超过 NoncurrentDays 和 NewerNoncurrentVersions 的值。

<LifecycleConfiguration>
  <Rule>
    <ID>Expire noncurrent with size less than 1 byte</ID>
    <Filter>
       <ObjectSizeLessThan>1</ObjectSizeLessThan>
    </Filter>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>     
       <NewerNoncurrentVersions>10</NewerNoncurrentVersions>
       <NoncurrentDays>30</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
</LifecycleConfiguration>

示例：支持转换小于 128 KB 的对象

Amazon S3 对生命周期配置应用默认行为，来防止将小于 128 KB 的对象转换到任何存储类。可以通过向配置中添加最小大小 (ObjectSizeGreaterThan) 或最大大小 (ObjectSizeLessThan) 筛选条件来指定更小的大小，从而支持转换更小的对象。以下示例支持将任何小于 128 KB 的对象转换到 S3 Glacier Instant Retrieval 存储类：

<LifecycleConfiguration>
  <Rule>
    <ID>Allow small object transitions</ID>
    <Filter>
          <ObjectSizeGreaterThan>1</ObjectSizeGreaterThan>
    </Filter>
    <Status>Enabled</Status>
    <Transition>
      <Days>365</Days>
      <StorageClass>GLACIER_IR</StorageClass>
    </Transition>
  </Rule>
</LifecycleConfiguration>

以下示例说明如何在 PutBucketLifecycleConfiguration 请求中使用 x-amz-transition-object-size-minimum-default 标头，来将 varies_by_storage_class 默认转换行为应用于 S3 生命周期配置。此行为支持将小于 128 KB 的对象转换到 S3 Glacier 或 S3 Glacier Deep Archive 存储类。默认情况下，所有其它存储类都将阻止小于 128 KB 的转换。您仍然可以使用自定义筛选条件来更改任何存储类的最小转换大小。自定义筛选条件始终优先于默认转换行为：

HTTP/1.1 200
x-amz-transition-object-size-minimum-default: varies_by_storage_class
<?xml version="1.0" encoding="UTF-8"?>
...