获取存储分区生命周期

如需列出存储分区的生命周期配置,您需要发出 GET 请求(范围限定于存储分区)并使用 lifecycle 查询字符串参数。生命周期配置在响应正文的 XML 文档中返回。

查询字符串参数

参数 说明 必需
lifecycle 您可以使用此方法显示现有存储分区的生命周期配置。

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

请求标头

请参阅常见请求标头

请求正文元素

此请求不包含 XML 文档。

请求语法

以下语法适用于使用 lifecycle 查询字符串参数的 GET 存储分区请求。

GET /?lifecycle HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

响应标头

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

响应正文元素

以下响应正文元素仅适用于使用 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 个版本(包括当前版本)的版本比该版本的版本号更新时,则满足条件。