---
title: "오브젝트 생명 주기 관리"
slug: "storage-storage-10-12"
tags: ["Classic", "VPC", "Archive Storage"]
updated: 2026-10-22T09:07:57Z
published: 2026-10-22T09:07:57Z
canonical: "guide-gov.ncloud-docs.com/storage-storage-10-12"
---

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

# 오브젝트 생명 주기 관리

Classic/VPC 환경에서 이용 가능합니다.

오브젝트가 원하는 시간에 자동으로 삭제되도록 설정하는 생명 주기 관리 방법을 안내합니다. 이 기능은 콘솔에서는 제공되지 않으며, API를 통해 설정할 수 있습니다.

- 생명 주기는 오브젝트를 업로드할 때(PUT) 또는 업로드 이후(POST) 요청에 `X-Delete-At` 또는 `X-Delete-After` 헤더를 추가하여 설정할 수 있습니다.
- `X-Delete-After`로 설정한 값은 저장될 때 `X-Delete-At` 형식으로 변환됩니다.
- 생명 주기를 해제하려면 `X-Remove-Delete-At` 또는 `X-Remove-Delete-After` 헤더를 사용합니다.

| 이름 | 적용 위치 | 타입 | 설명 |
| --- | --- | --- | --- |
| `X-Delete-At` | 헤더 | Integer | 오브젝트의 삭제 시간(Unix Timestamp) |
| `X-Delete-After` | 헤더 | Integer | 입력한 시간(초) 이후에 오브젝트 삭제 |

          참고

          

생명 주기는 단일 오브젝트 단위로 설정할 수 있습니다. DLO나 SLO로 업로드된 오브젝트의 경우, 세그먼트 오브젝트와 매니페스트 오브젝트 각각에 생명 주기를 따로 설정해야 합니다.

          주의

          

생명 주기가 만료되어 삭제된 오브젝트는 복구할 수 없습니다.

## 생명 주기 설정

오브젝트에 생명 주기를 설정하는 방법을 설명합니다.

### 오브젝트 업로드 시 설정(PUT)

오브젝트 업로드 요청(PUT)에 헤더를 추가하여 생명 주기를 설정하는 방법은 다음과 같습니다.

- 요청 구문

```
PUT /v1/AUTH_{project_id}/{container}/{object}
```
- `X-Delete-At` 요청 예시

```
curl -i -X PUT -H "X-Delete-At: 1540520319" -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
```
- `X-Delete-After` 요청 예시

```
curl -i -X PUT -H "X-Delete-After: 3600" -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
```

### 오브젝트 업로드 이후 설정(POST)

업로드된 오브젝트에 POST 요청을 통해 생명 주기를 설정하는 방법은 다음과 같습니다.

- 요청 구문

```
POST /v1/AUTH_{project_id}/{container}/{object}
```
- `X-Delete-At` 요청 예시

```
curl -i -X POST -H "X-Delete-At: 1540520319" -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
```
- `X-Delete-After` 요청 예시

```
curl -i -X POST -H "X-Delete-After: 3600" -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
```

## 생명 주기 조회

오브젝트에 설정된 생명 주기를 조회하는 방법은 다음과 같습니다.

- 요청 구문

```
HEAD /v1/AUTH_{project_id}/{container}/{object}
```
- 요청 예시

```
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
```
- 응답 예시

```
HTTP/1.1 200 OK
Content-Length: 4
X-Delete-At: 1540520319
Accept-Ranges: bytes
Last-Modified: Fri, 26 Oct 2018 02:25:30 GMT
Etag: 098f6bcd4621d373cade4e832627b4f6
X-Timestamp: 1540520729.75505
Content-Type: text/html
X-Trans-Id: txeaa0f1050fcf4cad9ccce-005bd27b8d
X-Openstack-Request-Id: txeaa0f1050fcf4cad9ccce-005bd27b8d
Date: Fri, 26 Oct 2018 02:27:25 GMT
```

## 생명 주기 설정 해제

Archive Storage에서는 수명주기 헤더(X-Delete-At)를 직접 해제하는 기능을 지원하지 않습니다.

이미 수명주기 헤더가 설정된 객체는 지정된 삭제 시점까지 삭제할 수 없으며, 삭제가 필요한 경우 동일한 키로 객체를 다시 업로드(덮어쓰기) 하여 수명주기 설정을 제거한 뒤 삭제해 주시기 바랍니다.