---
title: "PutBucketLifecycleConfiguration"
slug: "ncloudstorage-putbucketlifecycleconfiguration"
updated: 2026-10-08T07:18:27Z
published: 2026-10-08T07:18:27Z
canonical: "api.ncloud-docs.com/ncloudstorage-putbucketlifecycleconfiguration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PutBucketLifecycleConfiguration

Classic/VPC環境で利用できます。

Ncloud Storageバケットにライフサイクルの新規ルールを登録したり、既存のライフサイクルルールを上書きしたりします。

              参考

              

2026年2月26日以降、有効期限機能の適用が開始されました。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| PUT | - |

### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

              参考

              

Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのリクエストヘッダ](/docs/ja/storage-ncloudstorage#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `Content-MD5` | Conditional | リクエストボディの Base64エンコードした128ビット MD5ハッシュ値 - リクエストボディの完全性検証に使用 - `x-amz-checksum-*`を入力しなかった場合、必ず入力 |
| `x-amz-checksum-*` | Conditional | チェックサムのハッシュ値 - キーの`*`に使用したアルゴリズムを入力 - サポートアルゴリズム: `crc32` \| `crc32c` \| `sha1` \| `sha256` \| `crc64nvme` - `Content-MD5`を入力しなかった場合、必ず入力 |

### リクエストボディ

リクエストボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| Rule | List | Required | ルールリスト - 最大1,000個まで |
| Rule.ID | String | Optional | ルール名 - 最大255文字まで入力可能 |
| Rule.Status | String | Optional | ルールの有効化 - `Enabled` \| `Disabled` - `Enabled`の場合にのみルールが適用され、指定がない場合は無効化として処理 |
| Rule.Filter | List | Optional | ルールを適用する objectを区別するフィルタ |
| Rule.Filter.Prefix | String | Optional | ルールを適用する objectの接頭辞、現在は接頭辞で絞り込みのみ可能 |
| Rule.Expiration | List | Optional | 有効期間ルール |
| Rule.Expiration.Days | Integer | Optional | オブジェクトが作成された後に削除される日数、0より大きい正の整数であること |
| Rule.Transition | List | Optional | ストレージクラス移行ルール |
| Rule.Transition.Days | Integer | Optional | オブジェクトが作成された後に指定のストレージクラスに移行される日数、正の整数であること |
| Rule.Transition.StorageClass | String | Optional | 移行先のストレージクラス - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class |
| Rule.NoncurrentVersionExpiration | List | Optional | 非現行オブジェクトバージョンの有効期間ルール |
| Rule.NoncurrentVersionExpiration.NewerNoncurrentVersions | Integer | Optional | 保管する非現行バージョン数 - 最大100個まで |
| Rule.NoncurrentVersionExpiration.NoncurrentDays | Integer | Optional | オブジェクトが非現行状態で保持される日数 - 0より大きい正の整数 |
| Rule.NoncurrentVersionTransition | List | Optional | 非現行オブジェクトバージョンのストレージクラス移行ルール |
| Rule.NoncurrentVersionTransition.NewerNoncurrentVersions | Integer | Optional | オブジェクトを移行する前に、同じストレージクラスに保管する非現行バージョン数 - 最大100個まで |
| Rule.NoncurrentVersionTransition.NoncurrentDays | Integer | Optional | オブジェクトが非現行状態で保持される日数 - 正の整数 |
| Rule.NoncurrentVersionTransition.StorageClass | String | Optional | 移行先のストレージクラス - `ONEZONE_IA`: One Zone-IA(Infrequent Access) Class - `DEEP_ARCHIVE`: Archive Class |

### リクエスト例

リクエストのサンプルコードは次の通りです。

#### 有効期限設定のリクエスト

#### バケットバージョンが有効化していない場合

下記の例は、`Transition`ルールに従い、「documents/」の接頭辞を持つ objectを180日後に DEEP_ARCHIVEストレージクラスに移行します。`Expiration`ルールに従い、「logs/」の接頭辞を持つ objectを作成日から360日後に削除します。

```
PUT /?lifecycle HTTP/1.1
Host: bucket.kr.ncloudstorage.com
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Rule>
      <ID>tran_documents</ID>
      <Filter>
         <Prefix>documents/</Prefix>
      </Filter>
      <Status>Enabled</Status>
      <Transition>
         <Days>180</Days>
         <StorageClass>DEEP_ARCHIVE</StorageClass>
      </Transition>
   </Rule>
   <Rule>
       <ID>exp_logs</ID>
       <Filter>
           <Prefix>logs/</Prefix>
       </Filter>
       <Status>Enabled</Status>
       <Expiration>
           <Days>360</Days>
       </Expiration>
   </Rule>
</LifecycleConfiguration>
```

#### バケットバージョンが有効化している場合

下記の例は、`NoncurrentVersionTransition`ルールに従い、「documents/」の接頭辞を持つオブジェクトの、最も新しい5つの以前バージョンを除く残りのオブジェクトバージョンを、以前の状態になってから180日経過後に自動的に DEEP_ARCHIVEストレージクラスに移行します。`NoncurrentVersionExpiration`ルールに従い、「logs/」の接頭辞を持つ objectが非最新になってから100日が経過すると削除します。

```
PUT /?lifecycle HTTP/1.1
Host: bucket.kr.ncloudstorage.com
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Rule>
      <ID>tran_noncurrent_documents</ID>
      <Filter>
         <Prefix>documents/</Prefix>
      </Filter>
      <Status>Enabled</Status>
      <NoncurrentVersionTransition>
         <NewerNoncurrentVersions>5</NewerNoncurrentVersions>
         <NoncurrentDays>180</NoncurrentDays>
         <StorageClass>DEEP_ARCHIVE</StorageClass>
      </NoncurrentVersionTransition>
   </Rule>
   <Rule>
       <ID>exp_noncurrent_logs</ID>
       <Filter>
           <Prefix>logs/</Prefix>
       </Filter>
       <Status>Enabled</Status>
       <NoncurrentVersionExpiration>
           <NoncurrentDays>100</NoncurrentDays>
       </NoncurrentVersionExpiration>
   </Rule>
</LifecycleConfiguration>
```

#### dateを指定する場合

`Transition`ルールに基づき、「logs/」の接頭辞を持つ objectを`2025-10-23 00:00:00 UTC`以降に DEEP_ARCHIVEストレージクラスに移行するリクエストのサンプルコードは次の通りです。実際の移行は当該日の00:00:00 KST以降に行われます。

```
PUT /?lifecycle HTTP/1.1
Host: bucket.kr.ncloudstorage.com
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Rule>
      <ID>id1</ID>
      <Filter>
         <Prefix>logs/</Prefix>
      </Filter>
      <Status>Enabled</Status>
      <Transition>
         <Date>2025-10-23T00:00:00.000Z</Date>
         <StorageClass>DEEP_ARCHIVE</StorageClass>
      </Transition>
   </Rule>
</LifecycleConfiguration>
```

## レスポンス

レスポンス形式を説明します。

### レスポンスヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、[Ncloud Storageのレスポンスヘッダ](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。

### レスポンスステータスコード

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
HTTP/1.1 200 OK
```