设置桶的生命周期(PutBucketLifecycle)

设置桶的生命周期

此接口用于设置存储空间（Bucket）的生命周期规则。生命周期规则开启后，OSS将按照配置规则，定期自动删除与规则相匹配的文件（Object）。只有Bucket的拥有者才能发起此请求。

请求

请求语法

内容

  PUT /?lifecycle HTTP/1.1
  Host: {BucketName}.{Endpoint}
  Content-Length: length
  Date: {date}
  Authorization: {SignatureValue}     
  Content-MD5: MD5

  <LifecycleConfiguration>
      <Rule>
      ... 
      </Rule>
      <Rule>
      ...
      </Rule>
      …
  </LifecycleConfiguration>

描述

  Endpoint：参考与region地域的关系
  SignatureValue：参考签名算法

请求参数

名称	类型	是否必须	描述
AbortIncompleteMultipartUpload	容器	如果没有指定其他规则，则该参数必须存在。	用于指定不完整的分段上传何时可以中止操作。指定此参数时，无法指定tag。子节点: DaysAfterInitiation 父节点: Rule
And	容器	如果指定多个规则对象，则该参数必须存在。	存放多个规则的容器。父节点:Rule
Date	字符串	如果ExpiredObjectDeleteMarke不指定，则该参数必须存在。	指定对该日期之前的对象执行生命周期规则。父节点: Expiration 或Transition
Days	字符串	如果Date 和 ExpiredObjectDeleteMarker不指定，则该参数必须存在。	指定生命周期规则在Object最后修改过后多少天生效。父节点: Expiration, Transition.
DaysAfterInitiation	正整数	如果父节点指定，则该参数必须存在。	指定启动分段上传后必须完成分段上传的时间。父节点:AbortIncompleteMultipartUpload.
Expiration	容器	如果没有指定其他相关参数，则该参数必须存在。	表示过期时间的属性。子节点: Days 或 Date 父节点：Rule
Filter	容器	是	存放过滤参数的容器。子节点: Prefix, Tag 父节点：Rule
ID	字符串	是	规则唯一的ID，最多由255个字节组成。父节点: Rule
Key	字符串	如果Tag指定，则该参数必须存在。	Tag Key 父节点: Tag
LifecycleConfiguration	容器	是	Lifecycle配置的容器，最多可容纳1000条规则。子节点：Rule 父节点：无
ExpiredObjectDeleteMarker	字符串	如果Date 和 Days指定，则该参数必须存在。	指定是否自动移除过期删除标记。true为是，false为否。父节点：Expiration
NoncurrentDays	容器	是	指定生命周期规则在Object成为非当前版本多少天后生效。父节点：NoncurrentVersionTransition、NoncurrentVersionExpiration
NoncurrentVersionExpiration	容器	如果没有指定其他相关参数，则该参数必须存在。	指定Object非当前版本的生命周期规则的过期属性。子节点：NoncurrentDays
NoncurrentVersionTransition	容器	如果没有指定其他相关参数，则该参数必须存在。	在有效生命周期中，OSS何时将指定Object的非当前版本转储为其他类型。子节点：NoncurrentDays、StorageClass 父节点: Rule
Prefix	字符串	否	指定规则所适用的前缀。只有匹配前缀的Object才可能被该规则所影响。父节点: Filter 或者 And
Rule	容器	是	表述生命周期规则。父节点: LifecycleConfiguration
Status	字符串	是	如果值为Enabled，那么OSS会定期执行该规则；如果为Disabled，那么OSS会忽略该规则。有效值：Enabled，Disabled 父节点: Rule
StorageClass	字符串	如果指定一个或多个父节点，则该参数必须存在。	指定Object转存的存储类型。父节点: Transition and NoncurrentVersionTransition
Tag	容器	否	指定规则所适用的对象标签，可以设置多个。子节点：Key， Value 父节点:Filter 或者 And
Transition	容器	如果没有指定其他相关参数，则该参数必须存在。	生命周期配置中表示迁移时间和迁移后对象存储级别的元素。子节点：Date或Days,StorageClass 父节点: Rule
Value	字符串	如果Tag参数指定，则该参数必须存在。	Tag Value 父节点：Tag

非公共请求头

无

示例

请求

      PUT /?lifecycle HTTP/1.1
      Host: oss-example.oss-cn-beijing.inspurcloud.com
      x-oss-date: Wed, 14 May 2014 02:11:21 GMT
      Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
      Authorization: authorization string
      Content-Length: 415

      <LifecycleConfiguration>
      <Rule>
          <ID>id1</ID>
          <Filter>
              <Prefix>documents/</Prefix>
          </Filter>
          <Status>Enabled</Status>
          <Transition>
          <Days>30</Days>
          <StorageClass>GLACIER</StorageClass>
          </Transition>
      </Rule>
      <Rule>
          <ID>id2</ID>
          <Filter>
              <Prefix>logs/</Prefix>
          </Filter>
          <Status>Enabled</Status>
          <Expiration>
              <Days>365</Days>
          </Expiration>
      </Rule>
      </LifecycleConfiguration>

响应

      HTTP/1.1 200 OK
      x-oss-id-2: r+qR7+nhXtJDDIJ0JJYcd+1j5nM/rUFiiiZ/fNbDOsd3JUE8NWMLNHXmvPfwMpdc
      x-oss-request-id: 9E26D08072A8EF9E
      Date: Wed, 14 May 2014 02:11:21 GMT
      Content-Length: 0

错误码

错误码	描述	状态码	描述
...	...	...	...