# GET バケットライフサイクル (廃止)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## 説明
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**重要**  
この API の更新バージョンについては、「[GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html)」を参照してください。<filter> 要素を使用してバケットライフサイクルを設定した場合は、このトピックの更新バージョンが表示されます。このトピックは、下位互換性のために用意されています。

バケットに設定されている `lifecycle` 設定情報を返します。詳細については、「*Amazon Simple Storage Service ユーザーガイド*」の「[オブジェクトのライフサイクルの管理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)」を参照してください。

このオペレーションを使用するには、`s3:GetLifecycleConfiguration` アクションを実行するためのアクセス許可が必要です。デフォルトでは、バケット所有者がこのアクセス許可を持っています。バケット所有者は、他のユーザーにこのアクセス許可を付与することもできます。アクセス許可の詳細については、「*Amazon Simple Storage Service ユーザーガイド*」の「[Amazon S3 リソースへのアクセス許可の管理](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html)」を参照してください。

## リクエスト
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### 構文
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: {{bucketname}}.s3.amazonaws.com
3. Date: {{date}}
4. Authorization: {{authorization string}} (see リクエストの認証 (AWS 署名バージョン 4))
```

### リクエストパラメータ
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

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

### リクエストヘッダー
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

このオペレーションの実装では、すべてのオペレーションに共通のリクエストヘッダーのみを使用します。詳細については、「[共通のリクエストヘッダー](RESTCommonRequestHeaders.md)」を参照してください。

### リクエストの要素
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

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

## レスポンス
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### レスポンスヘッダー
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

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

### レスポンス要素
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

この `GET` の実装は、次のレスポンス要素を返します。


|  名前  |  説明  | 必須 | 
| --- | --- | --- | 
|  AbortIncompleteMultipartUpload  | 不完全なマルチパートアップロードが中止オペレーションの対象となるタイミングを指定するためのコンテナ。子: `DaysAfterInitiation`<br />型: コンテナ<br />祖先: `Rule` | はい (ルールに他のアクションが指定されていない場合) | 
|  Date  | Amazon S3 がアクションを実行する日付。詳細については、「*Amazon Simple Storage Service ユーザーガイド*」中の「[ライフサイクルルール: 特定の日付に基づく](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date)」を参照してください。<br />日付の値は、ISO 8601 形式に従う必要があります。この時刻は常に午前 0 時 (UTC) となります。<br />タイプ: 文字列<br />祖先: `Expiration` または `Transition` | はい (Days と ExpiredObjectDeleteMarker がない場合) | 
|  Days  | オブジェクトの作成後、特定のルールアクションが有効になるまでの日数を指定します。オブジェクトの適格時間は、作成時刻に日数を加算し、その計算結果の時刻を翌日の UTC 午前 0 時に切り上げた値として計算されます。<br />型: `Transition` で使用する場合は非負整数、`Expiration` で使用する場合は正整数。<br />祖先: `Transition` または `Expiration` | はい (Date と ExpiredObjectDeleteMarker がない場合) | 
|  DaysAfterInitiation  | マルチパートアップロードを開始してから、そのマルチパートアップロードを完了する必要がある日数を指定します。指定した日数で完了しない場合、中止オペレーションの対象となり、Amazon S3 は不完全なマルチパートアップロードをキャンセルします。<br />型: 正の整数<br />祖先: `AbortIncompleteMultipartUpload` | はい (Date がない場合) | 
|  Expiration  | このアクションは、オブジェクトの有効期間内で、Amazon S3 が適切な失効アクションを実行する期間を指定します。失効アクションは、子 `Date` または `Days` 要素で指定された期間に従って対象となるオブジェクトに対してのみ発生します。Amazon S3 が実行するアクションは、バケットでバージョニングが有効になっているかどうかによって異なります。<br /> +  バケットでバージョニングが有効になっていない場合、Amazon S3 はオブジェクトの唯一のコピーを完全に削除します。 <br />+  それ以外の場合、バージョニングが有効になっているバケット (またはバージョニングが停止されている) の場合、アクションは現在のバージョンのオブジェクトにのみ適用されます。バージョニングが有効またはバージョニングが停止しているバケットの場合、同じオブジェクトの複数のバージョン (現行バージョン 1 つと 非現行バージョン 0 個以上) を保持できます。 <br />Amazon S3 は、現在のバージョンを削除する代わりに、削除マーカーを新しい現在のバージョンとして追加することで、そのバージョンを非現行バージョンとします。 <br />  バケットがバージョニング一時停止状態の場合、Amazon S3 はバージョン ID として `null` を使用する削除マーカーを作成します。バージョン ID が `null` のバージョンがある場合、Amazon S3 はそのバージョンを上書きします。  <br />  非現行オブジェクトの有効期限を設定するには、`NoncurrentVersionExpiration` アクションを使用する必要があります。  <br />型: コンテナ<br />子: Days または Date<br />祖先: Rule | はい (親タグが指定されている場合) | 
|  ID  | ルール用の一意の識別子。値は 255 文字以下にする必要があります。<br />タイプ: 文字列<br />祖先: Rule | いいえ | 
| LifecycleConfiguration  | ライフサイクルルールのコンテナ。最大 1,000 個のルールを追加できます。<br />型: コンテナ<br />子: Rule<br />祖先: なし | はい | 
| ExpiredObjectDeleteMarker | バージョン管理されたバケット (バージョニングが有効なバケットまたはバージョニングが停止されたバケット) では、この要素は、Amazon S3 がバケット内の期限切れのオブジェクト削除マーカーを削除するかどうかを示します。例については、「*Amazon Simple Storage Service ユーザーガイド*」の「[例 8: 期限切れのオブジェクト削除マーカーを削除するための失効アクションを指定する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8)」を参照してください。<br />タイプ: 文字列 <br />有効な値: true \| false (値 false は許可されますが、no-op です。値が false の場合、Amazon S3 はアクションを実行しません)<br />祖先: `Expiration` | はい (Date と Days がない場合) | 
| NoncurrentDays  | Amazon S3 が関連付けられたアクションを実行するまでにオブジェクトが非現行状態である日数を指定します。非現行日数の計算については、「*Amazon Simple Storage Service ユーザーガイド*」の「[日数に基づくライフサイクルルール](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days)」を参照してください。<br />型: `NoncurrentVersionTransition` で使用する場合は非負整数、`NoncurrentVersionExpiration` で使用する場合は正整数<br />祖先: `NoncurrentVersionExpiration` または `NoncurrentVersionTransition` | はい (祖先が存在する場合のみ) | 
| NoncurrentVersionExpiration  | 最新ではないオブジェクトのバージョンが期限切れになる時期を指定します。期限切れになると、Amazon S3 により、最新ではないオブジェクトのバージョンが完全に削除されます。<br />バージョニングが有効 (または停止) になっているバケットにこのライフサイクル設定アクションを設定し、オブジェクトのライフサイクル内の特定の期間にオブジェクトの非現行バージョンを Amazon S3 が削除するようにリクエストします。<br />型: コンテナ<br />子: NoncurrentDays <br />祖先: Rule | はい (Rule に他のアクションが存在しない場合) | 
| NoncurrentVersionTransition | 非現行オブジェクトが、`STANDARD_IA`、`ONEZONE_IA`、または ストレージクラスに移行する時期を記述する移行ルールのコンテナ。<br />バケットでバージョニングが有効な場合 (またはバージョニングが停止している場合)、このアクションを設定して、オブジェクトの有効期間内の特定の期間に Amazon S3 がオブジェクトの非現行バージョンをストレージクラスに移行するように要求できます。<br />型: コンテナ<br />子: NoncurrentDays と StorageClass<br />祖先: Rule | はい (Rule に他のアクションが存在しない場合) | 
|  Prefix  | ルールの適用対象となるオブジェクトを 1 つ以上特定するオブジェクトキープレフィックス。<br />タイプ: 文字列<br />祖先: Rule | はい | 
| Rule  | ライフサイクルルールのコンテナ。<br />型: コンテナ<br />祖先: LifecycleConfiguration | はい | 
|  Status  | Enabled にすると、Amazon S3 はスケジュールどおりにルールを実行します。Disabled にすると、Amazon S3 はルールを無視します。<br />タイプ: 文字列<br />祖先: Rule<br />有効な値: Enabled または Disabled | はい | 
|  StorageClass  | オブジェクトの移行先となる Amazon S3 ストレージクラスを指定します。<br />タイプ: 文字列<br />祖先: Transition と NoncurrentVersionTransition<br />有効な値: `STANDARD_IA` \| `ONEZONE_IA` \|  | はい | 
|  Transition  | このアクションは、オブジェクトの有効期間内で Amazon S3 がオブジェクトを `STANDARD_IA`、`ONEZONE_IA`、またはストレージクラスに移行する期間を指定します。このアクションが有効な場合、Amazon S3 の動作は、バケットのバージョニングが有効になっているかどうかによって異なります。<br /> +  バケットでバージョニングが有効になっていない場合、Amazon S3 はオブジェクトの唯一のコピーを指定されたストレージクラスに移行します。 <br />+  バケットのバージョニングが有効になっている (またはバージョニングが停止されている) 場合、Amazon S3 はルールで識別されたオブジェクトの現在のバージョンのみを移行します。 <br />  バージョニングが有効なバケットまたはバージョニングが停止されたバケットには、オブジェクトの多くのバージョンを含めることができます。このアクションは、オブジェクトの非現行バージョンには影響しません。非現行オブジェクトを移行するには、`NoncurrentVersionTransition` アクションを使用する必要があります。  <br />型: コンテナ<br />子: Days または Date、および StorageClass<br />祖先: Rule | はい (Rule に他のアクションが存在しない場合) | 

## 特殊なエラー
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| エラーコード | 説明 | HTTP ステータスコード | SOAP フォルトコードプレフィックス | 
| --- | --- | --- | --- | 
| NoSuchLifecycleConfiguration | ライフサイクル設定が存在しません。 | 404 Not Found | クライアント | 

Amazon S3 のエラーとエラーコードのリストの一般的な情報については、「[エラーレスポンス](ErrorResponses.md)」を参照してください。

## 例
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### 例 1: ライフサイクルサブリソースを取得する
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

この例では、指定されたバケットから `lifecycle` サブリソースを取得する GET リクエストと、返されたライフサイクル設定を使用したレスポンスの例を示します。

#### リクエスト例
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: examplebucket.s3.amazonaws.com
3. x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
4. Authorization: {{signatureValue}}
```

#### レスポンス例
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## 関連リソース
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)