오브젝트 생명 주기 관리

Prev Next

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)를 직접 해제하는 기능을 지원하지 않습니다.

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