PUT バケットライフサイクル (廃止)

説明

バケットの新しいライフサイクル設定を作成するか、既存のライフサイクル設定を置き換えます。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「オブジェクトのライフサイクルの管理」を参照してください。

アクセス許可

デフォルトでは、バケット、オブジェクト、関連サブリソース (例:ライフサイクル設定やウェブサイト設定) を含むすべての Amazon S3 リソースはプライベートです。リソースの所有者 (リソースを作成した AWS アカウント) のみが、リソースにアクセスできます。リソースの所有者は、アクセスポリシーを作成することにより、オプションで他のユーザーにアクセス許可を付与できます。このオペレーションでは、ユーザーは s3:PutLifecycleConfiguration アクセス許可を取得する必要があります。

アクセス許可を明示的に拒否することもできます。明示的な拒否は、他のあらゆるアクセス許可よりも優先されます。ユーザーまたはアカウントがバケットからオブジェクトを削除できないようにするには、次のアクションのアクセス許可を拒否する必要があります。

アクセス許可の詳細については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 リソースへのアクセス許可の管理」を参照してください。

リクエスト

構文

PUT /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Content-Length: length
Date: date
Authorization: authorization string 
Content-MD5: MD5

Lifecycle configuration in the request body

認可文字列の詳細については、「リクエストの認証 (AWS 署名バージョン 4)」を参照してください。

リクエストパラメータ

オペレーションの実装では、リクエストパラメータを使用しません。

リクエストヘッダー

リクエスト本文

リクエストでは、リクエスト本文でライフサイクル設定を指定します。ライフサイクル設定は XML 形式で指定します。以下は、基本的なライフサイクル設定の一例です。1 つのルールを指定します。ルール内の Prefix は、ルールが適用されるオブジェクトを特定します。このルールでは、2 つのアクション (Transition と Expiration) も指定します。各アクションは、Amazon S3 がアクションを実行するタイムラインを指定します。Status は、ルールが有効か無効かを示します。

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <Transition>        
           <Date>value</Date>        
           <StorageClass>storage class</StorageClass>       
        </Transition>    
        <Expiration>
           <Days>value</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

バケットの状態が、バージョニングが有効か、またはバージョニングが停止している場合、同じオブジェクトの複数のバージョン (現行バージョン 1 つと 非現行バージョン 0 個以上) を保持できます。次のライフサイクル設定では、現在のものではないオブジェクトバージョンに固有のアクション (NoncurrentVersionTransition、NoncurrentVersionExpiration) を指定します。

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <NoncurrentVersionTransition>      
           <NoncurrentDays>value</NoncurrentDays>      
           <StorageClass>storage class</StorageClass>   
        </NoncurrentVersionTransition>    
        <NoncurrentVersionExpiration>     
           <NoncurrentDays>value</NoncurrentDays>    
        </NoncurrentVersionExpiration> 
    </Rule>
</LifecycleConfiguration>

マルチパートアップロード API を使用すると、大容量オブジェクトをいくつかに分けてアップロードできます。マルチパートアップロードの詳細については、「Amazon Simple Storage Service ユーザーガイド」の「マルチパートアップロードの概要」を参照してください。ライフサイクル設定を使用すると、マルチパートアップロードが指定の日数以内に完了しなかった場合、不完全なマルチパートアップロード (ルールで指定されたキー名プレフィックスによって識別される) を停止するように Amazon S3 に指示できます。Amazon S3 は、マルチパートアップロードをキャンセルするとき、アップロードに関連付けられているすべてのパートを削除します。これにより、Amazon S3 に一部のパートが保存されたままの不完全なマルチパートアップロードは存在しなくなるため、それらに対してストレージコストを支払う必要はありません。AbortIncompleteMultipartUpload アクションにルールを指定するライフサイクル設定の例を次に示します。このアクションは、開始から 7 日後に不完全なマルチパートアップロードをキャンセルするように Amazon S3 に指示します。

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>SomeKeyPrefix/</Prefix>
        <Status>rule-status</Status>
        <AbortIncompleteMultipartUpload>
          <DaysAfterInitiation>7</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

以下のセクションでは、ライフサイクル設定における XML 要素について説明します。

レスポンス

レスポンスヘッダー

このオペレーションの実装はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。詳細については、「共通のレスポンスヘッダー」を参照してください。

レスポンス要素

このオペレーションの実装では、レスポンス要素は返されません。

特殊なエラー

このオペレーションの実装では、特殊なエラーは返されません。Amazon S3 のエラーとエラーコードのリストの一般的な情報については、「エラーレスポンス」を参照してください。

例

例 1: バージョニングが有効になっていないバケットにライフサイクル設定を追加する

以下のライフサイクル設定では、それぞれ 1 つのアクションを持つ 2 つのルールが指定されています。

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

以下は、前述のライフサイクル設定を examplebucket バケットに追加する PUT /?lifecycle リクエストの例です。

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 415

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

レスポンスの例を次に示します。

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

例 2: バージョニングが有効になっているバケットにライフサイクル設定を追加する

以下のライフサイクル設定では、それぞれ Amazon S3 が実行するアクションを 1 つずつ含む 2 つのルールが指定されています。これらのアクションは、バケットのバージョニングが有効になっている場合、またはバージョニングが停止されている場合に指定します。

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>100</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>30</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

以下は、前述のライフサイクル設定を examplebucket バケットに追加する PUT /?lifecycle リクエストの例です。

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:21:48 GMT
Content-MD5: 96rxH9mDqVNKkaZDddgnw==
Authorization: authorization string
Content-Length: 598

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>1</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionSoonAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>0</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

レスポンスの例を次に示します。

HTTP/1.1 200 OK
x-amz-id-2: aXQ+KbIrmMmoO//3bMdDTw/CnjArwje+J49Hf+j44yRb/VmbIkgIO5A+PT98Cp/6k07hf+LD2mY=
x-amz-request-id: 02D7EC4C10381EB1
Date: Wed, 14 May 2014 02:21:50 GMT
Content-Length: 0
Server: AmazonS3

その他の例

STANDARD_IA や ONEZONE_IA などのストレージクラスにオブジェクトを移行するその他の例については、「ライフサイクル設定の例」を参照してください。

関連リソース