文档中心

对象存储

生命周期规则

GetBucketLifecycle

GetBucketLifecycle

功能描述

此接口用于获取指定存储桶（Bucket）生命周期规则。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
lifecycle	Query	String	是	-	代表 GetBucketLifecycle 请求的特殊标识。

请求元素

该请求不使用消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

说明

您可以调用 GetBucketLifecycle 接口获取基于最后修改时间的生命规则或基于最后访问时间的生命周期规则，这2种生命周期规则返回的部分响应元素不同，具体请参考以下内容。

通用元素

名称	参数类型	示例值	说明
Rules	Array	-	生命周期规则信息。
ID	String	id	规则 ID。
Prefix	String	prefix	规则所适用的前缀（Prefix）。
Status	String	Enabled	是否启用规则。取值说明如下： Enabled：表示启用规则，TOS 会定期执行该规则。 Disabled：表示不启用规则，TOS 会忽略该规则。
Tags	Array	-	TOS 可针对有特定标签的 Object，配置生命周期规则，最多可配置 10 个标签。关于标签的详细说明，请参见文件标签管理。子节点：Key、Value
Key	String	tag	对象标签的键。父节点：Tags
Value	String	value	对象标签的值。父节点：Tags
Filter	Container	-	指定规则生效的过滤条件，当前支持指定对象大小范围内生效。子节点：ObjectSizeGreaterThan、GreaterThanIncludeEqual、ObjectSizeLessThan、LessThanIncludeEqual、Not
ObjectSizeGreaterThan	Integer	65536	设置规则生效于大于指定大小的对象，单位是字节。父节点：Filter
GreaterThanIncludeEqual	String	Enabled	是否启用相等条件。只能取值 Enabled 或 Disabled，不配置则默认为 Disabled。取值说明如下： Enabled：表示启用相等条件，即“大于等于”。 Disabled：表示不启用相等条件，即“大于”。父节点：Filter
ObjectSizeLessThan	Integer	65536	设置规则生效于小于指定大小的对象，单位是字节。父节点：Filter
LessThanIncludeEqual	String	Enabled	是否启用相等条件。取值说明如下： Enabled：表示启用相等条件，即“小于等于”。 Disabled：表示不启用相等条件，即“小于”。父节点：Filter
Not	Array	-	设置本条生命周期规则对指定前缀和标签的对象不生效。
Prefix	String	prefix123	指定 Not 配置所适用的对象前缀。父节点：Not
Tags	Array	-	指定 Not 配置所适用的对象标签。子节点：Key、Value
Key	String	key1	指定 Not 配置所适用的对象标签的键。父节点：Tags
Value	String	value1	指定 Not 配置所适用的对象标签的值。父节点：Tags

基于最后修改时间的生命周期规则相关元素

名称	参数类型	示例值	说明
Expiration	Container	-	基于最后修改时间的生命周期规则中删除最新版本对象的过期属性。对于已开启版本控制的 Bucket，指定的过期时间只对对象的当前版本生效。子节点：Days、Date
Days	Integer	120	基于最后修改时间的生命周期规则中最新版本对象过期删除的天数。父节点：Expiration
Date	String	2024-01-31T00:00:00.000Z	基于最后修改时间的生命周期规则中最新版本对象过期删除的具体日期。按照 ISO8601 标准表示，且为 UTC 的零点。父节点：Expiration
NoncurrentVersionExpiration	Container	-	基于最后修改时间的生命周期规则中删除历史版本对象的过期属性。仅对已开启版本控制或暂停版本控制的 Bucket 生效，仅对对象的历史版本生效。子节点：NoncurrentDays、NoncurrentDate
NoncurrentDays	Integer	30	基于最后修改时间的生命周期规则中历史版本对象过期删除的天数。父节点：NoncurrentVersionExpiration
NonCurrentDate	String	2024-01-31T00:00:00.000Z	基于最后修改时间的生命周期规则中历史版本对象过期删除的具体日期。按照 ISO8601 标准表示，且为 UTC 的零点。父节点：NoncurrentVersionExpiration
AbortIncompleteMultipartUpload	Container	-	指定未合并的分片任务（碎片）的过期属性。子节点：DaysAfterInitiation
DaysAfterInitiation	Integer	30	指定未合并的分片任务（碎片）的生命周期规则，在分片任务初始化过后过期删除的天数。父节点：AbortIncompleteMultipartUpload
Transitions	Array	-	基于最后修改时间的生命周期规则中沉降最新版本对象的的过期属性。对于已开启版本控制的 Bucket，指定的过期时间只对对象的当前版本生效。警告如果您同时设置了自动沉降到低频存储、智能分层、归档闪回存储、归档存储、冷归档存储、深度冷归档及删除对象，则沉降时间满足：沉降到低频的时间 < 沉降到智能分层的时间 < 沉降到归档闪回的时间< 沉降到归档的时间 < 沉降到冷归档的时间 < 沉降到深度冷归档的时间 < 删除的时间。子节点：StorageClass、Days、Date
StorageClass	String	IA	基于最后修改时间的生命周期规则中最新版本对象沉降的存储类型。取值如下： IA：低频访问存储。 INTELLIGENT_TIERING：智能分层存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。说明深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。父节点：Transitions
Days	Integer	120	基于最后修改时间的生命周期规则中最新版本对象过期沉降的天数，必须为正整数。父节点：Transitions
Date	String	2024-01-31T00:00:00.000Z	基于最后修改时间的生命周期规则中最新版本对象过期沉降的具体日期。按照 ISO8601 标准表示，且为 UTC 的零点。父节点：Transitions
NoncurrentVersionTransitions	Array	-	基于最后修改时间的生命周期规则中沉降历史版本对象的的过期属性。仅对已开启版本控制或暂停版本控制的 Bucket 生效，仅对对象的历史版本生效。警告如果您同时设置了将历史版本自动沉降到低频存储、智能分层、归档闪回存储、归档存储、冷归档存储、深度冷归档存储及删除对象，则沉降时间满足：沉降到低频的时间 < 沉降到智能分层的时间 < 沉降到归档闪回的时间< 沉降到归档的时间 < 沉降到冷归档的时间 < 沉降到深度冷归档的时间 < 删除的时间。子节点：StorageClass、NoncurrentDays、NonCurrentDate
StorageClass	String	IA	基于最后修改时间的生命周期规则中历史版本对象沉降的存储类型。沉降的存储类型。取值如下： IA：低频访问存储。 INTELLIGENT_TIERING：智能分层存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。说明深度冷归档目前处于邀测状态，如您需要使用该存储类型，请联系客户经理。父节点：NoncurrentVersionTransitions
NoncurrentDays	Integer	120	基于最后修改时间的生命周期规则中历史版本对象沉降的天数，必须为正整数。父节点：NoncurrentVersionTransitions
NoncurrentDate	String	2024-01-31T00:00:00.000Z	基于最后修改时间的生命周期规则中历史版本对象沉降的具体日期。按照 ISO8601 标准表示，且为 UTC 的零点。父节点：NoncurrentVersionTransitions

基于最后访问时间的生命周期规则相关元素

名称	参数类型	示例值	说明
AccessTimeTransitions	Array	-	基于最后访问时间的生命周期规则中最新版本对象的过期属性。子节点：StorageClass、Days
StorageClass	String	IA	基于最后访问时间的生命周期规则中最新版本对象沉降的存储类型。取值如下： IA：低频访问存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。父节点：AccessTimeTransitions
Days	Integer	30	基于最后访问时间的生命周期规则中最新版本对象过期沉降的天数，必须为正整数。父节点：AccessTimeTransitions
NoncurrentVersionAccessTimeTransitions	Array	-	基于最后访问时间的生命周期规则中历史版本对象的过期属性。子节点：StorageClass、NoncurrentDays
StorageClass	String	IA	基于最后访问时间的生命周期规则中历史版本对象沉降的存储类型。取值如下： IA：低频访问存储。 ARCHIVE_FR：归档闪回存储。 ARCHIVE：归档存储。 COLD_ARCHIVE：冷归档存储。 DEEP_COLD_ARCHIVE：深度冷归档存储。父节点：NoncurrentVersionAccessTimeTransitions
NoncurrentDays	Integer	60	基于最后访问时间的生命周期规则中历史版本对象过期沉降的天数，必须为正整数。父节点：NoncurrentVersionAccessTimeTransitions

请求示例

响应示例

响应元素 1

基于最后修改时间的生命周期规则

响应元素 2

基于最后访问时间的生命周期规则

响应元素 3

没有设置生命周期规则

最近更新时间：2026.10.21 16:29:33

这个页面对您有帮助吗？

有用

有用

无用

无用