GET バケットライフサイクル (廃止)
説明
重要
この API の更新バージョンについては、「GetBucketLifecycleConfiguration」を参照してください。<filter> 要素を使用してバケットライフサイクルを設定した場合は、このトピックの更新バージョンが表示されます。このトピックは、下位互換性のために用意されています。
バケットに設定されている lifecycle 設定情報を返します。詳細については、「Amazon Simple Storage Service ユーザーガイド」の「オブジェクトのライフサイクルの管理」を参照してください。
このオペレーションを使用するには、s3:GetLifecycleConfiguration アクションを実行するためのアクセス許可が必要です。デフォルトでは、バケット所有者がこのアクセス許可を持っています。バケット所有者は、他のユーザーにこのアクセス許可を付与することもできます。アクセス許可の詳細については、「Amazon Simple Storage Service ユーザーガイド」の「Amazon S3 リソースへのアクセス許可の管理」を参照してください。
リクエスト
構文
GET /?lifecycle HTTP/1.1 Host:bucketname.s3.amazonaws.com Date:dateAuthorization:authorization string(see リクエストの認証 (AWS 署名バージョン 4))
リクエストパラメータ
オペレーションの実装では、リクエストパラメータを使用しません。
リクエストヘッダー
このオペレーションの実装では、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。詳細については、「共通のリクエストヘッダー」を参照してください。
リクエストの要素
このオペレーションの実装では、リクエストパラメータは使用しません。
レスポンス
レスポンスヘッダー
このオペレーションの実装はほとんどのレスポンスに共通のレスポンスヘッダーのみを使用します。詳細については、「共通のレスポンスヘッダー」を参照してください。
レスポンス要素
この GET の実装は、次のレスポンス要素を返します。
| 名前 | 説明 | 必須 |
|---|---|---|
AbortIncompleteMultipartUpload
|
不完全なマルチパートアップロードが中止オペレーションの対象となるタイミングを指定するためのコンテナ。 子: 型: コンテナ 祖先: |
はい (ルールに他のアクションが指定されていない場合) |
Date
|
Amazon S3 がアクションを実行する日付。詳細については、「Amazon Simple Storage Service ユーザーガイド」中の「ライフサイクルルール: 特定の日付に基づく」を参照してください。 日付の値は、ISO 8601 形式に従う必要があります。この時刻は常に午前 0 時 (UTC) となります。 タイプ: 文字列 祖先: |
はい (Days と ExpiredObjectDeleteMarker がない場合) |
Days
|
オブジェクトの作成後、特定のルールアクションが有効になるまでの日数を指定します。オブジェクトの適格時間は、作成時刻に日数を加算し、その計算結果の時刻を翌日の UTC 午前 0 時に切り上げた値として計算されます。 型: 祖先: |
はい (Date と ExpiredObjectDeleteMarker がない場合) |
DaysAfterInitiation
|
マルチパートアップロードを開始してから、そのマルチパートアップロードを完了する必要がある日数を指定します。指定した日数で完了しない場合、中止オペレーションの対象となり、Amazon S3 は不完全なマルチパートアップロードをキャンセルします。 型: 正の整数 祖先: |
はい (Date がない場合) |
Expiration
|
このアクションは、オブジェクトの有効期間内で、Amazon S3 が適切な失効アクションを実行する期間を指定します。失効アクションは、子
型: コンテナ 子: Days または Date 祖先: Rule |
はい (親タグが指定されている場合) |
ID
|
ルール用の一意の識別子。値は 255 文字以下にする必要があります。 タイプ: 文字列 祖先: Rule |
いいえ |
LifecycleConfiguration
|
ライフサイクルルールのコンテナ。最大 1,000 個のルールを追加できます。 型: コンテナ 子: Rule 祖先: なし |
はい |
ExpiredObjectDeleteMarker |
バージョン管理されたバケット (バージョニングが有効なバケットまたはバージョニングが停止されたバケット) では、この要素は、Amazon S3 がバケット内の期限切れのオブジェクト削除マーカーを削除するかどうかを示します。例については、「Amazon Simple Storage Service ユーザーガイド」の「例 8: 期限切れのオブジェクト削除マーカーを削除するための失効アクションを指定する」を参照してください。 タイプ: 文字列 有効な値: true | false (値 false は許可されますが、no-op です。値が false の場合、Amazon S3 はアクションを実行しません) 祖先: |
はい (Date と Days がない場合) |
NoncurrentDays
|
Amazon S3 が関連付けられたアクションを実行するまでにオブジェクトが非現行状態である日数を指定します。非現行日数の計算については、「Amazon Simple Storage Service ユーザーガイド」の「日数に基づくライフサイクルルール」を参照してください。 型: 祖先: |
はい (祖先が存在する場合のみ) |
NoncurrentVersionExpiration
|
最新ではないオブジェクトのバージョンが期限切れになる時期を指定します。期限切れになると、Amazon S3 により、最新ではないオブジェクトのバージョンが完全に削除されます。 バージョニングが有効 (または停止) になっているバケットにこのライフサイクル設定アクションを設定し、オブジェクトのライフサイクル内の特定の期間にオブジェクトの非現行バージョンを Amazon S3 が削除するようにリクエストします。 型: コンテナ 子: NoncurrentDays 祖先: Rule |
はい (Rule に他のアクションが存在しない場合) |
NoncurrentVersionTransition |
非現行オブジェクトが、 バケットでバージョニングが有効な場合 (またはバージョニングが停止している場合)、このアクションを設定して、オブジェクトの有効期間内の特定の期間に Amazon S3 がオブジェクトの非現行バージョンをストレージクラスに移行するように要求できます。 型: コンテナ 子: NoncurrentDays と StorageClass 祖先: Rule |
はい (Rule に他のアクションが存在しない場合) |
Prefix
|
ルールの適用対象となるオブジェクトを 1 つ以上特定するオブジェクトキープレフィックス。 タイプ: 文字列 祖先: Rule |
はい |
Rule
|
ライフサイクルルールのコンテナ。 型: コンテナ 祖先: LifecycleConfiguration |
はい |
Status
|
Enabled にすると、Amazon S3 はスケジュールどおりにルールを実行します。Disabled にすると、Amazon S3 はルールを無視します。 タイプ: 文字列 祖先: Rule 有効な値: Enabled または Disabled |
はい |
StorageClass
|
オブジェクトの移行先となる Amazon S3 ストレージクラスを指定します。 タイプ: 文字列 祖先: Transition と NoncurrentVersionTransition 有効な値: |
はい |
Transition
|
このアクションは、オブジェクトの有効期間内で Amazon S3 がオブジェクトを
型: コンテナ 子: Days または Date、および StorageClass 祖先: Rule |
はい (Rule に他のアクションが存在しない場合) |
特殊なエラー
| エラーコード | 説明 | HTTP ステータスコード | SOAP フォルトコードプレフィックス |
|---|---|---|---|
NoSuchLifecycleConfiguration |
ライフサイクル設定が存在しません。 | 404 Not Found | クライアント |
Amazon S3 のエラーとエラーコードのリストの一般的な情報については、「エラーレスポンス」を参照してください。
例
例 1: ライフサイクルサブリソースを取得する
この例では、指定されたバケットから lifecycle サブリソースを取得する GET リクエストと、返されたライフサイクル設定を使用したレスポンスの例を示します。
リクエスト例
GET /?lifecycle HTTP/1.1 Host: examplebucket.s3.amazonaws.com x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT Authorization:signatureValue
レスポンス例
HTTP/1.1 200 OK x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp x-amz-request-id: 51991C342C575321 Date: Thu, 15 Nov 2012 00:17:23 GMT Server: AmazonS3 Content-Length: 358 <?xml version="1.0" encoding="UTF-8"?> <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Rule> <ID>Archive and then delete rule</ID> <Prefix>projectdocs/</Prefix> <Status>Enabled</Status> <Transition> <Days>30</Days> <StorageClass>STANDARD_IA</StorageClass> </Transition> <Transition> <Days>365</Days> <StorageClass>GLACIER</StorageClass> </Transition> <Expiration> <Days>3650</Days> </Expiration> </Rule> </LifecycleConfiguration>
関連リソース
