GetBucketLifecycle - Object Storage Service - Alibaba Cloud ドキュメントセンター

バケットに設定されているライフサイクルルールを照会します。

使用方法

バケットに設定されているライフサイクルルールを照会するには、oss:GetBucketLifecycle 権限が必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。

リクエスト構文

GET /?lifecycle HTTP/1.1
Host: BucketName.oss.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

例

リクエストの例

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

レスポンスの例

最終更新時刻に基づいて設定されたライフサイクルルール

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>

最終アクセス時刻に基づいて設定されたライフサイクルルール

説明

最終アクセス時刻に基づいてバケットにライフサイクルルールが設定されている場合、レスポンスの例には AtimeBase 要素が含まれます。この要素は、最終アクセス時刻（1970-01-01 00:00:00 UTCからの経過時間）のタイムスタンプが、バケットのアクセストラッキングが有効になったときのタイムスタンプであることを示します。

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>

ライフサイクルルールが設定されていません

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>

OSS SDK

次のプログラミング言語の OSS SDK を使用して、GetBucketLifecycle 操作を呼び出すことができます。

ossutil

GetBucketLifecycle 操作に対応する ossutil コマンドについては、「get-bucket-lifecycle」をご参照ください。

エラーコード

エラーコード	HTTP ステータスコード	説明
AccessDenied	403 Forbidden	バケットに設定されているライフサイクルルールを照会する権限がないために返されるエラーメッセージです。バケット所有者のみが、バケットに設定されているライフサイクルルールを照会する権限を持っています。
NoSuchBucket または NoSuchLifecycle	404 Not Found	バケットが存在しないか、バケットにライフサイクルルールが設定されていないために返されるエラーメッセージです。