---
title: "PutBucketLifecycleConfiguration"
slug: "ncloudstorage-putbucketlifecycleconfiguration"
updated: 2026-09-17T09:17:01Z
published: 2026-09-17T09:17:01Z
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/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/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 응답 상태 코드

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Ncloud Storage 응답 상태 코드](/docs/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
```