文档中心 对象存储 PutBucketLifecycle

PutBucketLifecycle

更新时间:2023-08-17 17:37:03

用于为空间创建生命周期或者替换原有的生命周期规则。需求有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 定义每个规则唯一的标识。
类型:字符串
父节点:Rule
Filter 定义符合生命周期规则的对象子集。这个过滤目前仅支持基于对象名前缀。如果没有定义()则这个此生命周期规则应用于空间中的所有对象。
类型:XML
子节点:Prefix
父节点:Rule
Prefix 定义生命周期配置的过滤条件,空间中只有对符合这个前缀的对象,此生命周期配置才会生效。
类型:字符串
父节点:Filter
Expiration 定义空间中符合Filter的对象的过期规则。
类型:XML
子节点:Days
Date
父节点:Rule
Days 定义Object相对过期天数,比如当值为3的含义是,将相对最后修改时间3天之后的Object删除
类型:正整数
父节点:Expiration
Transition 转换规则
类型:XML
子节点:Days
StorageClass
父节点:Rule
Days 转换的天数
类型:正整数
父节点:Transition
StorageClass 转换类型,IA-低频,Archive-归档
类型:字符串
父节点: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
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!