CDN加速

PutBucketLifecycle

更新时间:2021-06-17 14:15:05

PutBucketLifecycle

用于为空间创建生命周期或者替换原有的生命周期规则。需求有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信息

元素名称

元素描述

是否必填

LifecyckeConfiguration

定义生命周期配置列表。

类型:XML

子节点:Rule

父节点:空

Rule

定义某个生命周期详细配置。

类型:XML

父节点:LifecycleConfiguration

子节点:Filter

ID

定义每个规则唯一的标识。

类型:字符串

父节点:Rule

Filter

定义符合生命周期规则的对象子集。这个过滤目前仅支持基于对象名前缀。如果没有定义(<Filter></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