设置存储分区生命周期

默认情况下,存储分区未启用生命周期管理。如需为现有存储分区设置或修改生命周期配置,您需要发出一个范围限定于存储分区的 PUT 请求,并使用 lifecycle 查询字符串参数。您必须在请求正文中添加包含生命周期配置的 XML 文档。请注意,您无法为正在创建的新存储分区设置生命周期配置。

您必须具有 FULL_CONTROL 权限才能设置现有存储分区的生命周期配置。此外,您还必须经过身份验证才能使用 PUT 存储分区方法。

查询字符串参数

参数 说明 必需
lifecycle 您使用此字段来添加或更改现有存储分区的生命周期配置。您必须在请求正文中提供 LifecycleConfiguration 文档。

如需了解您在创建和使用签名网址时包含的参数,请参阅签名网址查询字符串参数

请求标头

请参阅常见请求标头

请求正文元素

以下请求正文元素仅在您使用 lifecycle 查询字符串参数指定现有存储分区的生命周期配置时才适用。

元素 说明
LifecycleConfiguration 定义存储分区的生命周期管理政策,其中包含 0 个或更多个规则(最多 100 个)。使用空元素(例如 <LifecycleConfiguration/>)停用存储分区的生命周期管理。
Rule 定义生命周期管理规则,该规则由操作以及操作所必须满足的条件。
Action 定义要执行的操作。必须包含且只能包含一个操作元素。
Delete 用于删除存储分区中的对象的操作元素。
SetStorageClass 用于更改存储分区中对象的存储类别的操作元素。
Condition 必须满足的操作条件。规则必须至少包含一个条件元素。
Age 与指定年龄(以天为单位)匹配的对象的条件元素。
CreatedBefore 与指定日期 (UTC) 午夜之前创建的对象的条件元素。该值是一个不含时区的 ISO 日期字符串,例如 2019-01-15
CustomTimeBefore 条件元素与 Custom-Time 元数据包含的日期晚于此条件设置日期的日期。CustomTimeBefore 是不带时区的 ISO 日期字符串,例如 2020-02-25
DaysSinceCustomTime 条件元素与 Custom-Time 元数据存在超过 DaysSinceCustomTime 天的对象匹配。
DaysSinceNoncurrentTime 仅与版本化对象相关的条件元素。匹配有效期超过指定天数的对象。
IsLive 条件元素通常只与对象版本控制结合使用。设置为 false 时,满足对象的任何非当前版本需要满足此条件。如果设置为 true,则适合对象的当前版本。如果您不使用对象版本控制功能,当 IsLivetrue 时,所有对象都会被视为活跃对象并匹配。
MatchesStorageClass 与指定存储类别对象的条件元素。可以将同一条件多次添加到同一规则,以涵盖多个存储类别。
NoncurrentTimeBefore 仅与版本化对象相关的条件元素。匹配早于此条件中指定的日期早于 noncurrent 的对象。 NoncurrentTimeBefore 是不带时区的 ISO 日期字符串,例如 2020-02-25
NumberOfNewerVersions 仅与版本化对象相关的条件元素。如果值为 N,则当至少存在 N 个版本(包括当前版本)的版本比该版本的版本号更新时,则满足条件。

请求语法

PUT /?lifecycle HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Content-Type: MIME_TYPE_OF_THE_BODY
Authorization: AUTHENTICATION_STRING

XML_DOCUMENT_DEFINING_LIFECYCLE_CONFIGURATION

响应标头

请求可以返回各种响应标头,具体取决于您使用的请求标头。

响应正文元素

响应的响应正文中不包含 XML 文档。

示例

以下示例为名为 example.com 的存储分区启用了生命周期管理。如需查看更多示例,请参阅“管理生命周期”页面

请求

PUT /example.com?lifecycle HTTP/1.1
Host: storage.googleapis.com
Content-Length: 220
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" ?>
<LifecycleConfiguration>
    <Rule>
        <Action>
            <Delete/>
        </Action>
        <Condition>
            <Age>30</Age>
        </Condition>
    </Rule>
</LifecycleConfiguration>

响应

HTTP/1.1 200 OK
Date: Mon, 07 Jan 2019 03:38:42 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html