Object Storage Service:GetBucketLifecycle

Sample requests

Get /?lifecycle HTTP/1.1
Host: oss-example.oss.aliyuncs.com  
Date: Mon, 14 Apr 2014 01:17:29 GMT  
Authorization: OSS qn6qn6q**************:77Dv****************                 

Sample responses

• Lifecycle rules that are configured based on the last modification time

  HTTP/1.1 200
  x-oss-request-id: 534B371674E88A4D8906****
  Date: Mon, 14 Apr 2014 01:17:29 GMT
  Connection: keep-alive
  Content-Length: 255
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <LifecycleConfiguration>
    <Rule>
      <ID>delete after one day</ID>
      <Prefix>logs1/</Prefix>
      <Status>Enabled</Status>
      <Expiration>
        <Days>1</Days>
      </Expiration>
    </Rule>
    <Rule>
      <ID>mtime transition1</ID>
      <Prefix>logs2/</Prefix>
      <Status>Enabled</Status>
      <Transition>
        <Days>30</Days>
        <StorageClass>IA</StorageClass>
      </Transition>
    </Rule>
    <Rule>
      <ID>mtime transition2</ID>
      <Prefix>logs3/</Prefix>
      <Status>Enabled</Status>
      <Transition>
        <Days>30</Days>
        <StorageClass>IA</StorageClass>
        <IsAccessTime>false</IsAccessTime>
      </Transition>
    </Rule>
  </LifecycleConfiguration>                            

• Lifecycle rules that are configured based on the last access time

  Note

  If a lifecycle rule is configured for a bucket based on the last access time, the AtimeBase element is included in the sample response. This element indicates that the timestamp of the last access time (the time since 1970-01-01 00:00:00 UTC) is the timestamp when access tracking is enabled for the bucket.

  HTTP/1.1 200
  x-oss-request-id: ****
  Date: Mon, 26 Jul 2021 01:17:29 GMT
  Connection: keep-alive
  Content-Length: length
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <LifecycleConfiguration>
    <Rule>
      <ID>atime transition1</ID>
      <Prefix>logs1/</Prefix>
      <Status>Enabled</Status>
      <Transition>
        <Days>30</Days>
        <StorageClass>IA</StorageClass>
        <IsAccessTime>true</IsAccessTime>
        <ReturnToStdWhenVisit>false</ReturnToStdWhenVisit>
      </Transition>
      <AtimeBase>1631698332</AtimeBase>
    </Rule>
    <Rule>
      <ID>atime transition2</ID>
      <Prefix>logs2/</Prefix>
      <Status>Enabled</Status>
      <NoncurrentVersionTransition>
        <NoncurrentDays>10</NoncurrentDays>
        <StorageClass>IA</StorageClass>
        <IsAccessTime>true</IsAccessTime>
        <ReturnToStdWhenVisit>false</ReturnToStdWhenVisit>
      </NoncurrentVersionTransition>
      <AtimeBase>1631698332</AtimeBase>
    </Rule>
  </LifecycleConfiguration>

• No lifecycle rules configured

  HTTP/1.1 404
  x-oss-request-id: 534B371674E88A4D8906****
  Date: Mon, 14 Apr 2014 01:17:29 GMT
  Connection: keep-alive
  Content-Length: 278
  Server: AliyunOSS
  
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <BucketName>oss-example</BucketName>
    <Code>NoSuchLifecycle</Code>
    <Message>No Row found in Lifecycle Table.</Message>
    <RequestId>534B372974E88A4D8906****</RequestId>
    <HostId> BucketName.oss.example.com</HostId>
  </Error>