生命周期配置元素

规则元数据，包含规则 ID 以及指示规则是已启用还是已禁用的状态。如果规则处于禁用状态，则 Amazon S3 不会执行规则中指定的任何操作。

标识规则应用到的对象的筛选条件。您可以通过使用对象大小、对象键前缀、一个或多个对象标签或者筛选条件的组合来指定筛选条件。

您希望 Amazon S3 执行指定操作时的一个或多个转换或过期操作，带有位于对象的生命周期内的日期或时间段。

使用键前缀指定筛选条件 – 此示例显示一个 S3 生命周期规则，此规则基于键名前缀（logs/）应用于一部分对象。例如，此生命周期规则应用于对象 logs/mylog.txt、logs/temp1.txt 和 logs/test.txt。此规则不应用于对象 example.jpg。

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>logs/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
    ...
</LifecycleConfiguration>

如果您要基于不同的键名称前缀将生命周期操作应用于一部分对象，可指定单独的规则。在每个规则中，指定基于前缀的筛选条件。例如，要描述具有键前缀 projectA/ 和 projectB/ 的对象的生命周期操作，可指定两个规则，如下所示：

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Prefix>projectA/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>

    <Rule>
        <Filter>
           <Prefix>projectB/</Prefix>
        </Filter>
        transition/expiration actions
         ...
    </Rule>
</LifecycleConfiguration>

有关对象键的更多信息，请参阅 创建对象键名称。

指定基于对象标签的筛选条件 – 在以下示例中，此生命周期规则指定基于标签（key）和值（value）的筛选条件。随后，此规则仅应用于具有特定标签的一部分对象。

<LifecycleConfiguration>
    <Rule>
        <Filter>
           <Tag>
              <Key>key</Key>
              <Value>value</Value>
           </Tag>
        </Filter>
        transition/expiration actions
        ...
    </Rule>
</LifecycleConfiguration>

您可以指定基于多个标签的筛选条件。您必须在 <And> 元素中包含标签，如以下示例所示。此规则指示 Amazon S3 对具有两个标签（带特定的标签键和值）的对象执行生命周期操作。

<LifecycleConfiguration>
    <Rule>
      <Filter>
         <And>
            <Tag>
               <Key>key1</Key>
               <Value>value1</Value>
            </Tag>
            <Tag>
               <Key>key2</Key>
               <Value>value2</Value>
            </Tag>
             ...
          </And>
      </Filter>
      transition/expiration actions
    </Rule>
</Lifecycle>

此生命周期规则应用于具有指定的两个标签的对象。Amazon S3 执行逻辑 AND。请注意以下几点：

指定基于前缀和一个或多个标签的筛选条件 – 在生命周期规则中，您可以指定基于键前缀和一个或多个标签的筛选条件。同样，您必须在 <And> 元素中包含所有这些筛选条件元素，如下所示：

<LifecycleConfiguration>
    <Rule>
        <Filter>
          <And>
             <Prefix>key-prefix</Prefix>
             <Tag>
                <Key>key1</Key>
                <Value>value1</Value>
             </Tag>
             <Tag>
                <Key>key2</Key>
                <Value>value2</Value>
             </Tag>
              ...
          </And>
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Amazon S3 使用逻辑 AND 组合这些筛选条件。也就是说，该规则应用于具有指定键前缀和指定标签的对象子集。一个筛选条件只能有一个前缀以及零个或多个标签。

您可以指定 empty filter（空筛选条件），在此情况下，此规则应用于桶中的所有对象。

<LifecycleConfiguration>
    <Rule>
        <Filter>
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

要按照 object size（对象大小）筛选规则，您可以指定最小的大小 (ObjectSizeGreaterThan) 或最大大小 (ObjectSizeLessThan)，也可以指定一系列对象大小。

对象大小值以字节为单位。最大筛选条件大小为 5TB。某些存储类具有最小对象大小限制。有关更多信息，请参阅 比较 Amazon S3 存储类。

<LifecycleConfiguration>
    <Rule>
        <Filter>
            <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>   
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

如果要指定对象大小范围，ObjectSizeGreaterThan 整数必须小于 ObjectSizeLessThan 值。当使用多个筛选条件时，必须将筛选条件包装在 <And> 元素中。以下示例显示了如何指定范围在 500 字节到 64000 字节之间的对象。

<LifecycleConfiguration>
    <Rule>
        <Filter>
            <And>
                <Prefix>key-prefix</Prefix>
                <ObjectSizeGreaterThan>500</ObjectSizeGreaterThan>
                <ObjectSizeLessThan>64000</ObjectSizeLessThan>
            </And>    
        </Filter>
        <Status>Enabled</Status>
        transition/expiration actions
    </Rule>
</LifecycleConfiguration>

Transition 操作元素 – 您指定 Transition 操作来将对象从一个存储类转换为另一个存储类。有关转换对象的更多信息，请参阅 受支持的转换和相关限制。达到对象生命周期内指定的日期或时间段后，Amazon S3 将执行该转换。

对于受版本控制的桶（已启用版本控制或已暂停版本控制的桶），Transition 操作适用于当前对象版本。为了管理非当前版本，Amazon S3 定义了 NoncurrentVersionTransition 操作（本主题稍后会对此描述）。

Expiration 操作元素 – Expiration 操作使规则中标识的对象到期，并且应用于任意 Amazon S3 存储类中符合条件的对象。有关存储类别的更多信息，请参阅 使用 Amazon S3 存储类。Amazon S3 使所有过期的对象不可用。是否永久删除对象取决于桶的版本控制状态。

NoncurrentVersionTransition 操作元素 – 使用此操作可指定 Amazon S3 何时将对象转换到指定的存储类。您可以根据自对象变为非当前对象以来的一定天数来确定此到期日期。除了天数之外，您还可以提供要保留的最大非当前版本数（最多 100）。此值确定在 Amazon S3 可以对给定版本执行关联操作之前，必须存在多少个较新的非当前版本。Amazon S3 将转换超过要保留的指定数量的任何其它非当前版本。

要指定最大非当前版本数量，您还必须提供 Filter 元素。如果您未指定 Filter 元素，Amazon S3 会在您提供最大数量的非当前版本时生成 InvalidRequest 错误。

有关转换对象的更多信息，请参阅 受支持的转换和相关限制。有关当您在 NoncurrentVersionTransition 操作中指定天数时 Amazon S3 如何计算日期的详细信息，请参阅 生命周期规则：基于对象的存在期限。

NoncurrentVersionExpiration 操作元素 – 使用此操作可指示 Amazon S3 何时永久删除对象的非当前版本。删除的对象无法恢复。您可以根据自对象变为非当前对象以来的一定天数来确定此到期日期。除了天数之外，您还可以提供要保留的最大非当前版本数（最多 100）。此值指定在 Amazon S3 可以对给定版本执行关联操作之前，必须存在多少较新的非当前版本。Amazon S3 将永久删除超过要保留的指定数量的任何其它非当前版本。

要指定最大非当前版本数量，您还必须提供 Filter 元素。如果您未指定 Filter 元素，Amazon S3 会在您提供最大数量的非当前版本时生成 InvalidRequest 错误。

当您需要更正任何意外删除或覆盖时，非当前对象的延时移除可能很有帮助。例如，您可以配置一个到期规则，以便在对象变为非当前版本五天后删除非当前版本。例如，假设在 2014 年 1 月 1 日上午 10:30 UTC，您创建了名为 photo.gif 的对象（版本 ID 111111）。在 2014 年 2 月 1 日上午 11:30 UTC，您意外删除了 photo.gif（版本 ID 111111），这将导致使用新版本 ID（如版本 ID 4857693）创建一个删除标记。您现在有五天时间可以在永久删除之前，恢复原始版本的 photo.gif (版本 ID 111111)。在 2014 年 1 月 8 日 00:00 UTC，有关到期的生命周期规则运行并永久删除 photo.gif（版本 ID 111111）（在它成为非当前版本五天之后）。

有关当您在 NoncurrentVersionExpiration 操作中指定天数时 Amazon S3 如何计算日期的详细信息，请参阅 生命周期规则：基于对象的存在期限。

AbortIncompleteMultipartUpload 操作元素 – 使用此元素可设置您希望允许分段上传保持运行的最长时间（天）。如果适用的分段上传（由生命周期规则中指定的键名称 prefix 确定）未在预定义的时间段内成功完成，Amazon S3 将停止未完成的分段上传。有关更多信息，请参阅 中止分段上传。

ExpiredObjectDeleteMarker 操作元素 – 在启用了版本控制的存储桶中，包含零个非当前版本的删除标记称为到期对象删除标记。您可以使用此生命周期操作来指示 Amazon S3 移除到期对象移除标记。有关示例，请参阅示例 7：移除过期对象删除标记。

您指定的值是自对象创建以来将发生此操作的天数。

Amazon S3 按以下方式计算时间：将在规则中指定的天数与对象创建时间相加，然后将得出的时间舍入至下一日的午夜 UTC。例如，如果对象的创建时间是 2014 年 1 月 15 日上午 10:30 UTC，并且您在转换规则中指定了 3 天，则对象的转换日期将计算为 2014 年 1 月 19 日 00:00 UTC。

您指定的值是从对象版本变为非当前版本以来（即，当对象被覆盖或删除时）的天数，作为 Amazon S3 将对指定的对象执行操作的时间。

Amazon S3 按以下方式计算时间：将规则中指定的天数与创建对象的新后继者版本的时间相加，然后将得出的时间舍入至下一日的午夜 UTC。例如，在您的存储桶中，假设某个对象的当前版本的创建时间是 2014 年 1 月 1 日上午 10:30 UTC。如果替换当前版本的对象新版本的创建时间是 2014 年 1 月 15 日上午 10:30 UTC，并且您在转换规则中指定了 3 天，则对象的转换日期计算为 2014 年 1 月 19 日 00:00 UTC。