注意事项

调用PutBucketLifecycle接口时，有如下注意事项：

• 只有Bucket的拥有者以及被授予PutBucketLifecycle权限的RAM用户才能发起配置生命周期规则的请求。
• 如果Bucket此前没有设置过生命周期规则，此操作会创建一个新的生命周期规则；如果Bucket此前设置过生命周期规则，此操作会覆写先前的规则配置。
• PutBucketLifecycle是覆盖语义。当您需要追加生命周期规则时，请先调用GetBucketLifecycle接口获取当前生命周期规则配置，然后追加新的生命周期规则配置，最后调用PutBucketLifecycle接口更新生命周期规则配置。
• PutBucketLifecycle操作可以对Object以及Part（以分片方式上传，但最后未提交的分片）设置过期时间。

请求语法

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>

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

响应头

此接口仅涉及公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

示例

• 不受版本控制的生命周期配置请求示例

  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 qn6qrrqxo2oawuk53otf****:PYbzsdWAIWAlMW8luk****
  <?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>
    <Rule>
      <ID>r1</ID>
      <Prefix>rule1</Prefix>
      <Tag><Key>xx</Key><Value>1</Value></Tag>
      <Tag><Key>yy</Key><Value>2</Value></Tag>
      <Status>Enabled</Status>
      <Expiration>
        <Days>30</Days>
      </Expiration>
    </Rule>
    <Rule>
      <ID>r2</ID>
      <Prefix>rule2</Prefix>
      <Tag><Key>xx</Key><Value>1</Value></Tag>
      <Status>Enabled</Status>
      <Transition>
        <Days>60</Days>
        <StorageClass>Archive</StorageClass>
      </Transition>
    </Rule>
  </LifecycleConfiguration>

  返回示例

  HTTP/1.1 200 OK
  x-oss-request-id: 534B371674A4D890****
  Date: Thu , 8 Jun 2017 13:08:38 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

• 受版本控制的生命周期配置请求示例

  PUT /?lifecycle HTTP/1.1
  Host: oss-example.oss.aliyuncs.com
  Content-Length: 336
  Date: Mon , 6 May 2019 15:23:20 GMT
  Authorization: OSSWnjl3fg9fdv8fg4b****:Phuu8bBhS8dsff2a****
  <?xml version="1.0" encoding="UTF-8"?>
  <LifecycleConfiguration>
    <Rule>
      <ID>delete example</ID>
      <Prefix>logs/</Prefix>
      <Status>Enabled</Status>
      <Expiration>
        <ExpiredObjectDeleteMarker>true</ExpiredObjectDeleteMarker>     
      </Expiration>
      <NoncurrentVersionExpiration>
        <NoncurrentDays>5</NoncurrentDays>
      </NoncurrentVersionExpiration>
      <AbortMultipartUpload>
        <Days>1</Days>
      </AbortMultipartUpload>
    </Rule>
    <Rule>
      <ID>transit example</ID>
      <Prefix>data/</Prefix>
      <Status>Enabled</Status>
      <Transition>
        <Days>30</Days>
        <StorageClass>IA</StorageClass>
      </Transition>
      <NoncurrentVersionTransition>
        <NoncurrentDays>10</NoncurrentDays>
        <StorageClass>IA</StorageClass>
      </NoncurrentVersionTransition>
    </Rule>
  </LifecycleConfiguration>

  返回示例

  HTTP/1.1 200 OK
  x-oss-request-id: 7D3435J59A9812B*****
  Date: Mon , 6 May 2019 15:23:20 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS

SDK

此接口所对应的各语言SDK如下：

• Java
• Python
• Go
• C++
• PHP
• C
• .NET
• Node.js
• Ruby

错误码