功能说明
GetBucketLifecycle接口用于获取存储桶设置的生命周期规则。
请求消息样式
GET /{Bucket}?lifecycle HTTP/1.1
Host: xxx.zos.ctyun.cn
Date: Date
Content-Length: ContentLength
X-Amz-Content-SHA256: Content-SHA256
Authorization: string请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 指定存储桶名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: tx00000000000000000002e-00624e4358-1217b-default
Content-Type: application/xml
Content-Length: 0
Date: Thu, 07 Apr 2022 01:50:16 GMT
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Rule>
<ID>id</ID>
<Filter>
<Prefix>prefix</Prefix>
<And>
<Tag>
<Key>key1</Key>
<Value>value1</Value>
</Tag>
<Tag>
<Key>key2</Key>
<Value>value2</Value>
</Tag>
</And>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>10</Days>
</Expiration>
</Rule>
</LifecycleConfiguration>响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| LifecycleConfiguration | 参数解释： 生命周期规则的容器，最多容纳1000条规则。 | Container |
表 LifecycleConfiguration
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| LifecycleConfiguration | 参数解释： 生命周期规则的容器，最多容纳1000条规则。 | Container |
| Rule | 参数解释： 生命周期规则。 | Container |
| Expiration | 参数解释： 用日期或天数指定对象的过期时间。 | Container |
| Date | 参数解释： 标识对象的过期日期。 取值范围： 日期为ISO8601格式，必须为UTC午夜0时。 | Date |
| Days | 参数解释： 标识对象受规则约束的天数。 | Long |
| ID | 参数解释： 标识唯一的规则。 | String |
| Filter | 参数解释： 过滤应用规则的对象。 | Container |
| Prefix | 参数解释： 标识应用规则的对象前缀。 | String |
| Tag | 参数解释： 应用规则到拥有指定标签的对象。 | Container |
| Key | 参数解释： 标签的名称。 | String |
| Value | 参数解释： 标签的值。 | String |
| Status | 参数解释： 标识是否应用规则 。 取值范围： - Enabled - Disabled | String |
| Transtions | 参数解释： 标识对象何时转存到指定的Storage Class。 | Container |
| StorageClass | 参数解释： 标识要转存储到哪种存储类别。 取值范围： - STANDARD_IA（低频存储） - GLACIER（归档存储） | String |
| NoncurrentVersionTransitions | 参数解释： 标识历史版本的转存储规则。 | Container |
| NoncurrentDays | 参数解释： 标识对象的历史版本受规则约束的天数。 | Long |
| NoncurrentVersionExpiration | 参数解释： 标识历史版本的过期规则。 | Container |
| AbortIncompleteMultipartUpload | 参数解释： 标识未完成的分段上传的过期属性。 | Container |
| DaysAfterInitiation | 参数解释： 标识为完成的分段的过期时间。 | Long |
| ExpiredObjectDeleteMarker | 参数解释： 标记多版本桶，是否要删除DeleteMarker。 取值范围： - true 约束限制： 不可设置为false | Boolen |
表 Rule
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| ID | 参数解释： 标识唯一的规则。 | String |
| Filter | 参数解释： 过滤应用规则的对象。 | Container |
| Status | 参数解释： 标识是否应用规则。 取值范围： - Enabled - Disabled | String |
| Prefix | 参数解释： 标识应用规则的对象前缀。 | String |
| Expiration | 参数解释： 用日期或天数指定对象的过期时间。 | Container |
| Transtions | 参数解释： 标识对象何时转存到指定的 Storage Class。 | Container |
| NoncurrentVersionExpiration | 参数解释： 标识历史版本的过期规则。 | Container |
| NoncurrentVersionTransitions | 参数解释： 标识历史版本的转存储规则。 | Container |
| AbortIncompleteMultipartUpload | 参数解释： 标识未完成的分段上传的过期属性。 | Container |
表 Expiration
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| Date | 参数解释： 标识对象的过期日期 。 取值范围： 日期为 ISO8601 格式，必须为 UTC 午夜 0 时。 | Date |
| Days | 参数解释： 标识对象受规则约束的天数。 | Long |
| ExpiredObjectDeleteMarker | 参数解释： 标记多版本桶，是否要删除 DeleteMarker。 取值范围： - true 约束限制： 不可设置为 false | Boolen |
表 Filter
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| And | 参数解释： And 标签条件的容器，用于指定多个条件。 | Container |
| Prefix | 参数解释： 标识应用规则的对象前缀。 | String |
| Tag | 参数解释： 应用规则到拥有指定标签的对象。 | Container |
表 And
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| Prefix | 参数解释： 标识应用规则的对象前缀。 | String |
| Tag | 参数解释： 应用规则到拥有指定标签的对象。 | Container |
表 Tag
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| Key | 参数解释： 标签的名称。 | String |
| Value | 参数解释： 标签的值。 | String |
表 Transition
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| Date | 参数解释： 标识对象的转存日期。 取值范围： 日期为 ISO8601 格式，必须为 UTC 午夜 0 时。 | Date |
| Days | 参数解释： 标识对象受规则约束的天数。 | Long |
| StorageClass | 参数解释： 标识要转存储到哪种存储类别。 取值范围： - STANDARD_IA（低频存储） - GLACIER（归档存储） | String |
表 NoncurrentVersionTransition
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| NoncurrentDays | 参数解释： 标识对象的历史版本受规则约束的天数。 | Long |
| StorageClass | 参数解释： 标识要转存储到哪种存储类别。 取值范围： - STANDARD_IA（低频存储） - GLACIER（归档存储） | String |
表 NoncurrentVersionExpiration
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| NoncurrentDays | 参数解释： 标识对象的历史版本受规则约束的天数。 | Long |
表 AbortIncompleteMultipartUpload
| 参数名称 | 参数描述 | 参数类型 |
|---|---|---|
| DaysAfterInitiation | 参数解释： 标识为完成的分段的过期时间。 | Long |
错误码
请参见调用前必知-错误码-全局错误码。
