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)를 직접 해제하는 기능을 지원하지 않습니다.
이미 수명주기 헤더가 설정된 객체는 지정된 삭제 시점까지 삭제할 수 없으며, 삭제가 필요한 경우 동일한 키로 객체를 다시 업로드(덮어쓰기) 하여 수명주기 설정을 제거한 뒤 삭제해 주시기 바랍니다.