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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=host,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e                

Sample responses

• Lifecycle rules based on 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 based on last access time

  Note

  When a lifecycle rule uses the last access time, the response includes the AtimeBase element. AtimeBase is a Unix timestamp (seconds since 1970-01-01 00:00:00 UTC) indicating when access tracking was 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>