生命周期配置元素

规则元数据，包含规则 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>

有关对象键的更多信息，请参阅 为 Amazon S3 对象命名。

指定基于对象标签的筛选条件 – 在以下示例中，此生命周期规则指定基于标签（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)，也可以指定一系列对象大小。

对象大小值以字节为单位。默认情况下，除非您指定较小的最小大小 (ObjectSizeGreaterThan) 或最大大小 (ObjectSizeLessThan)，否则小于 128 KB 的对象不会转换到任何存储类。有关更多信息，请参阅 示例：支持转换小于 128 KB 的对象。

                    <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 何时将对象转换到指定的存储类。您可以根据自对象变为非当前版本以来的一定天数 (<NoncurrentDays>) 来确定此转换。除了天数之外，还可以指定要保留的非当前版本的数量 (<NewerNoncurrentVersions>)（介于 1 和 100 之间）。此值确定在 Amazon S3 可以转换给定版本之前，必须存在多少个较新的非当前版本。Amazon S3 将转换超过要保留的指定数量的任何其它非当前版本。要进行转换，必须同时超过 <NoncurrentDays> 和 <NewerNoncurrentVersions> 的值。

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

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

NoncurrentVersionExpiration 操作元素 – 使用此操作可指示 Amazon S3 何时永久删除对象的非当前版本。删除的对象无法恢复。您可以根据自对象变为非当前对象以来的一定天数 (<NoncurrentDays>) 来确定此到期日期。除了天数之外，还可以指定要保留的非当前版本的数量 (<NewerNoncurrentVersions>)（介于 1 和 100 之间）。此值指定在 Amazon S3 可以使给定版本到期之前，必须存在多少较新的非当前版本。Amazon S3 将永久删除超过要保留的指定数量的任何其它非当前版本。要进行删除，必须同时超过 <NoncurrentDays> 和 <NewerNoncurrentVersions> 的值。

要指定要保留的非当前版本数量，还必须提供 <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 移除到期对象移除标记。有关示例，请参阅在启用了版本控制的存储桶中移除到期对象删除标记。

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

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。