PutBucketLifecycle
更新时间：2025-08-18 15:50:10
PutBucketLifecycle用于为空间（Bucket）创建生命周期，或替换原有的生命周期规则。需要 IAM wos:PutBucketLifecycle 权限。
请求语法
PUT /?lifecycle HTTP/1.1
Host: Bucket.Endpoint
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="https://www.wangsu.com/document ">
<Rule>
<Expiration>
<Days>integer</Days>
</Expiration>
<Filter>
<Prefix>string</Prefix>
</Filter>
<ID>string</ID>
<Transition>
<Date>timestamp</Date>
<StorageClass>string</StorageClass>
</Transition>
</Rule>
...
</LifecycleConfiguration>
URI请求参数
无
请求头
仅需使用公共请求头。
请求体
请求体为如下xml信息：
| 元素名称 | 元素描述 |
|---|---|
| LifecycleConfiguration | 定义生命周期配置列表。 类型：XML 子节点：Rule 父节点：无 |
| Rule | 定义某一条生命周期的详细配置。 类型：XML 父节点：LifecycleConfiguration 子节点：Filter |
| ID | 定义每条规则的唯一标识符。 类型：String 父节点：Rule |
| Filter | 定义符合生命周期规则的对象子集。该过滤当前仅支持基于对象名前缀的过滤。如果未定义（ 类型：XML 子节点：Prefix 父节点：Rule |
| Prefix | 定义生命周期配置的过滤条件。仅对空间中符合该前缀的对象生效。 类型：String 父节点：Filter |
| Expiration | 定义空间内符合Filter条件对象的过期规则。 类型：XML 子节点：Days |
| Days(Expiration) | 定义对象的相对过期天数。例如，值为3表示对象在最后修改时间后第3天被删除。 类型：正整数 父节点：Expiration |
| Transition | 转换规则。 类型：XML 子节点：Days |
| Days(Transition) | 转换天数。 类型：正整数 父节点：Transition |
| StorageClass | 转换类型，IA-低频，Archive-归档。 类型：String 父节点：Transition |
响应语法
HTTP/1.1 200 OK
x-wos-request-id: request id
Content-Type: type
Date: date
Content-Length: length
Server: WS-web-server
响应头
仅需使用公共响应头。
响应元素
无
示例
创建30天转低频、60天转归档、365天删除的生命周期规则
PUT /?lifecycle HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
x-amz-date: Sun, 14 May 2017 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 105
<LifecycleConfiguration>
<Rule>
<ID>id1</ID>
<Filter>
<Prefix>logs/</Prefix>
</Filter>
<Status>Enabled</Status>
<Expiration>
<Days>365</Days>
</Expiration>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
<Transition>
<Days>60</Days>
<StorageClass>Archive</StorageClass>
</Transition>
</Rule>
</LifecycleConfiguration>
HTTP/1.1 200 OK
x-wos-request-id: 9E26D08072A8EF9E
Date: Sun, 14 May 2017 02:11:22 GMT
Content-Length: 0
Server: WCS-Web-Server
本篇文档内容对您是否有帮助？
有帮助
我要反馈