此接口用于获取指定存储桶(Bucket)生命周期规则。
GET /?lifecycle HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string
该请求使用的公共请求消息头,请参见公共参数。
名称 | 位置 | 参数类型 | 是否必选 | 示例值 | 说明 |
---|---|---|---|---|---|
lifecycle | Query | String | 是 | - | 代表GetBucketLifecycle请求的特殊标识。 |
该请求不使用消息元素。
该请求返回的公共响应消息头,请参见公共参数。
名称 | 参数类型 | 示例值 | 说明 |
---|---|---|---|
Rules | Array | - | 生命周期规则信息。 |
ID | String | id | 规则 ID. |
Prefix | String | prefix | 规则所适用的前缀(Prefix). |
Status | String | Enabled | 是否启用规则。取值说明如下:
|
Expiration | Container | { "Days": 120 } | 指定对象的过期属性。 对于已开启版本控制的 Bucket,指定的过期时间只对对象的当前版本生效。 |
Days | Integer | 120 | 指定对象上传后过期删除的天数。 |
Date | String | 2024-01-31T00:00:00.000Z | 指定对象上传后过期删除的具体日期。按照 ISO8601 标准表示,且为 UTC 的零点。 |
NoncurrentVersionExpiration | Container | - | 指定对象历史版本的过期属性。仅对已开启版本控制或暂停版本控制的 Bucket 生效,仅对对象的历史版本生效。 |
NoncurrentDays | String | 30 | 指定对象历史版本过期删除的天数。 |
NoCurrentDate | String | 2024-01-31T00:00:00.000Z | 指定对象历史版本过期删除的具体日期。按照 ISO8601 标准表示,且为 UTC 的零点。 |
AbortIncompleteMultipartUpload | Container | - | 指定未合并的分片任务(碎片)的过期属性。 |
DaysAfterInitiation | Integer | 30 | 指定未合并的分片任务(碎片)的生命周期规则,在分片任务初始化过后过期删除的天数。 |
Transitions | Array | - | 指定对象沉降为指定存储类型的过期属性。 对于已开启版本控制的 Bucket,指定的过期时间只对对象的当前版本生效。 注意 如果您同时设置了自动沉降到低频存储、智能分层、归档闪回存储、归档存储、冷归档存储、深度冷归档及删除对象,则沉降时间满足:沉降到低频的时间 < 沉降到智能分层的时间 < 沉降到归档闪回的时间< 沉降到归档的时间 < 沉降到冷归档的时间 < 沉降到深度冷归档的时间 < 删除的时间。 子节点:StorageClass、Days、Date |
StorageClass | String | IA | 指定对象沉降的存储类型。取值如下:
父节点:Transitions |
Days | Integer | 120 | 指定对象过期沉降的天数,必须为正整数。 |
Date | String | 2024-01-31T00:00:00.000Z | 指定对象过期沉降的具体日期。按照 ISO8601 标准表示,且为 UTC 的零点。 |
NoncurrentVersionTransitions | Array | - | 指定历史版本对象沉降为指定存储类型的过期属性。仅对已开启版本控制或暂停版本控制的 Bucket 生效,仅对对象的历史版本生效。 注意 如果您同时设置了将历史版本自动沉降到低频存储、智能分层、归档闪回存储、归档存储、冷归档存储、深度冷归档存储及删除对象,则沉降时间满足:沉降到低频的时间 < 沉降到智能分层的时间 < 沉降到归档闪回的时间< 沉降到归档的时间 < 沉降到冷归档的时间 < 沉降到深度冷归档的时间 < 删除的时间。 子节点:StorageClass、NoncurrentDays、NoCurrentDate |
StorageClass | String | IA | 指定历史版本对象沉降的存储类型。取值如下:
父节点:NoncurrentVersionTransitions |
NoncurrentDays | Integer | 120 | 指定历史版本对象过期沉降的天数,必须为正整数。 |
NoncurrentDate | String | 2024-01-31T00:00:00.000Z | 指定历史版本对象过期沉降的具体日期。按照 ISO8601 标准表示,且为 UTC 的零点。 |
Tags | Array | - | TOS 可针对有特定标签的 Object,配置生命周期规则,最多可配置 10 个标签。关于标签的详细说明,请参见文件标签管理。 |
Key | String | tag | 对象标签的键。 |
Value | String | value | 对象标签的值。 |
Filter | Container | - | 指定规则生效的过滤条件,当前支持指定对象大小范围内生效。 |
ObjectSizeGreaterThan | Integer | 65536 | 设置规则生效于大于指定大小的对象,单位是字节。 |
GreaterThanIncludeEqual | String | Enabled | 是否启用相等条件。只能取值
父节点:Filter |
ObjectSizeLessThan | Integer | 65536 | 设置规则生效于小于指定大小的对象,单位是字节。 |
LessThanIncludeEqual | String | Enabled | 是否启用相等条件。取值说明如下:
父节点:Filter |
GET /?lifecycle HTTP/1.1 Host: bucket-name.tos-cn-beijing.volces.com Date: Mon, 14 Apr 2021 01:17:29 GMT Authorization: authorization string
HTTP/1.1 200 OK Date: Fri, 30 Jul 2021 13:53:55 GMT Server: TosServer x-tos-id-2: 1e89f203jld00006-a444fd0 x-tos-request-id: 1e89f203b2d00006-a444ed0 Content-Length: *** { "Rules": [ { "ID": "id", "Prefix": "prefix", "Status": "Enabled", "Tags": [ { "Key": "key", "Value": "value" } ], "Filter": { "ObjectSizeGreaterThan": 65536, "GreaterThanIncludeEqual": "Enabled", "ObjectSizeLessThan": 10485760, "LessThanIncludeEqual": "Disabled" }, "Expiration": { "Days": 120 }, "NoncurrentVersionExpiration": { "NoncurrentDays": 90 }, "AbortIncompleteMultipartUpload": { "DaysAfterInitiation": 30 }, "Transitions": [ { "StorageClass": "IA", "Days": 30 }, { "StorageClass": "COLD_ARCHIVE", "Days": 60 } ], "NoncurrentVersionTransitions": [ { "StorageClass": "IA", "NoncurrentDays": 30 }, { "StorageClass": "COLD_ARCHIVE", "NoncurrentDays": 60 } ] } ] }
如果没有设置生命周期规则,则返回示例如下。
{ "Error": { "Code": "NoSuchLifecycleConfiguration", "RequestId": "936901f5f9aa32d663f5f9aa-ac192267-1pUn7K-GBL-cq-tos_front", "HostId": "fWBVJIQESfYijNMMUzZkucybHUTgEyaF", "Message": "The bucket lifecycle configuration does not exist" } }