GetBucketLifecycle
更新时间：2025-08-18 15:50:12
该接口用于获取存储空间的生命周期配置。需要具备 IAM wos:GetBucketLifecycle 权限。
请求语法
GET /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization string
URI请求参数
无
请求头
请使用 公共请求头。
请求体
无
响应语法
HTTP/1.1 200 OK
x-wos-request-id:
Date:
Server: WCS-Web-Server
Content-Length: 358
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document ">
<Rule>
<ID>id</ID>
<Filter>
<Prefix> </Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>
响应头
请使用 公共响应头。
响应体
| 字段名 | 描述 |
|---|---|
| LifecycleConfiguration | 定义生命周期配置列表。 类型：XML 子节点：Rule 父节点：空 |
| Rule | 定义某一条生命周期配置。 类型：XML 父节点：LifecycleConfiguration 子节点：Filter |
| ID | 定义每条规则的唯一ID。 类型：String 父节点：Rule |
| Filter | 定义符合生命周期规则的对象子集。仅支持通过前缀过滤对象。若未定义（ 类型：XML 子节点：Prefix 父节点：Rule |
| Prefix | 定义过滤规则，仅对存储空间内符合该前缀的对象生效。 类型：String 父节点：Filter |
| Status | 生命周期配置状态（是否生效）。Enable表示配置生效。 类型：String（目前仅有Enabled值） 父节点：Rule |
| Expiration | 定义符合过滤规则对象的过期时间。 类型：XML 子节点：Days|Date 父节点：Rule |
| Days | 定义对象的相对过期天数。例如，值为13表示对象将在最后修改时间后13天过期。 类型：正整数 父节点：Expiration |
| Transition | 转换规则。 类型：XML 子节点：Days |
| Days | 转换的天数。 类型：正整数 父节点：Transition |
| StorageClass | 转换类型，IA-低频，Archive-归档 类型：字符串 父节点：Transition |
示例
GET /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-wos-date: Thu, 15 Nov 2016 00:17:21 GMT
Authorization: signatureValue
HTTP/1.1 200 OK
x-wos-request-id: 51991C342C575321
Date: Thu, 15 Nov 2016 00:17:23 GMT
Server: WCS-Web-Serve
Content-Length: 358
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns=" https://www.wangsu.com/document ">
<Rule>
<ID>Archive and then delete rule</ID>
<Filter>
<Prefix>projectdocs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>
本篇文档内容对您是否有帮助？
有帮助
我要反馈