Put Bucket Lifecycle
Bucket的拥有者可以通过Put Bucket Lifecycle来设置Bucket的Lifecycle配置。Lifecycle开启后,OSS将按照配置,定期自动删除或转储与Lifecycle规则相匹配的Object。
请求语法PUT /?lifecycle HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Authorization: SignatureValue
Host: BucketName.oss.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
<Rule>
<ID>RuleID</ID>
<Prefix>Prefix</Prefix>
<Status>Status</Status>
<Expiration>
<Days>Days</Days>
</Expiration>
<Transition>
<Days>Days</Days>
<StorageClass>StorageClass</StorageClass>
</Transition>
<AbortMultipartUpload>
<Days>Days</Days>
</AbortMultipartUpload>
</Rule>
</LifecycleConfiguration>
请求元素(Request Elements)
名称 | 描述 | 是否必需 |
CreatedBeforeDate | 指定规则何时之前生效。日期必需服从ISO8601的格式,并且总是UTC的零点。 例如:2002-10-11T00:00:00.000Z 类型:字符串 父节点:Expiration或者Transition或者AbortMultipartUpload | Days和CreatedBeforeDate二选一 |
Days | 指定规则在对象最后修改时间过后多少天生效。 类型:正整数 父节点:Expiration或者Transition | Days和CreatedBeforeDate二选一 |
Expiration | 指定Object规则的过期属性。 类型:容器 子节点:Days或CreatedBeforeDate 父节点:Rule | 否 |
AbortMultipartUpload | 指定未完成的Part规则的过期属性。 类型:容器 子节点:Days或CreatedBeforeDate 父节点:Rule | 否 |
ID | 规则唯一的ID。最多由255字节组成。当用户没有指定,或者该值为空时,OSS会为用户生成一个唯一值。 类型:字符串 子节点:无 父节点:Rule | 否 |
LifecycleConfiguration | Lifecycle配置的容器,最多可容纳1000条规则。 类型:容器 子节点:Rule 父节点:无 | 是 |
Prefix | 指定规则所适用的前缀。只有匹配前缀的对象才可能被该规则所影响。不可重叠。 类型:字符串 子节点:无 父节点:Rule | 是 |
Rule | 表述一条规则 类型:容器 子节点:ID,Prefix,Status,Expiration 父节点:LifecycleConfiguration | 是 |
Status | 如果其值为Enabled,那么OSS会定期执行该规则;如果是Disabled,那么OSS会忽略该规则。 类型:字符串 父节点:Rule 有效值:Enabled,Disabled | 是 |
StorageClass | 指定对象转储到OSS的目标存储类型 类型:字符串 子节点:无 父节点:Transition 有效值:IA或者Archive | 是,如果父节点Transition设置了 |
Transition | 指定Object在有效生命周期中,OSS何时将对象转储到IA或者Archive存储类型 类型:容器 子节点:Days或CreatedBeforeDate 父节点:Rule | 否 |
PUT /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com
Content-Length: 443
Date: Thu , 8 Jun 2017 13:08:38 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfj byc:PYbzsdWSMrAIWAlMW8luWekJ8=
<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration>
<Rule>
<ID>delete objects and parts after one day</ID>
<Prefix>logs/</Prefix>
<Status>Enabled</Status>
<Expiration>
<Days>1</Days>
</Expiration>
<AbortMultipartUpload>
<Days>1</Days>
</AbortMultipartUpload>
</Rule>
<Rule>
<ID>transit objects to IA after 30, to Archive 60, expire after 10 years</ID>
<Prefix>data/</Prefix>
<Status>Enabled</Status>
<Transition>
<Days>30</Days>
<StorageClass>IA</StorageClass>
</Transition>
<Transition>
<Days>60</Days>
<StorageClass>Archive</StorageClass>
</Transition>
<Expiration>
<Days>3600</Days>
</Expiration>
</Rule>
<Rule>
<ID>transit objects to Archive after 60 days</ID>
<Prefix>important/</Prefix>
<Status>Enabled</Status>
<Transition>
<Days>6</Days>
<StorageClass>Archive</StorageClass>
</Transition>
</Rule>
<Rule>
<ID>delete created before date</ID>
<Prefix>backup/</Prefix>
<Status>Enabled</Status>
<Expiration>
<CreatedBeforeDate>2017-01-01T00:00:00.000Z</CreatedBeforeDate>
</Expiration>
<AbortMultipartUpload>
<CreatedBeforeDate>2017-01-01T00:00:00.000Z</CreatedBeforeDate>
</AbortMultipartUpload>
</Rule>
</LifecycleConfiguration>
HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906008B
Date: Thu , 8 Jun 2017 13:08:38 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。