다큐멘트 센터 Object Storage API Set File Retention Period

Set File Retention Period

최신 업데이트:2025-08-18 15:32:21

이 인터페이스는 사용자가 파일의 보관 기간을 설정할 수 있도록 하며, 설정된 일수를 초과한 파일은 자동으로 삭제됩니다.

참고: 파일이 삭제되면 복구할 수 없으니, 신중하게 조작하시기 바랍니다.

요청 설명

요청 경로

POST /setdeadline
Host: <MgrDomain>
Authorization:<AccessToken>

<requestParam>

헤더 설명

파라미터 필수 여부 설명
Host 관리 도메인 이름. 콘솔의 버킷 개요에서 확인 가능합니다.
Authorization 관리 인증정보

파라미터 설명

요청 파라미터는 아래와 같이 구성되어 요청 본문에 포함되어야 합니다:

bucket=<Urlsafe_Base64_Encoded_Bucket>&key=<Urlsafe_Base64_Encoded_Key>&deadline=<deadline>&relevance=<relevance>

요청 파라미터

파라미터 필수 여부 설명
bucket 공간(버킷) 이름
key 파일 이름
deadline 파일 보관 기간(일 단위). 지정한 일수를 초과한 파일은 자동으로 삭제됩니다. 예: 1, 2, 3 …
참고: 0은 가능한 빨리 삭제, -1은 만료 시간을 해제하여 영구 보관을 의미합니다.
relevance 아니오 m3u8 파일 연동 시, TS 파일의 보관 기간 설정 여부. 0: 연동하지 않음, 1: 연동 설정.
참고:
1. 본 파라미터를 지정하지 않으면 기본적으로 연동됩니다. m3u8 파일이 아니라면 이 파라미터는 무시됩니다.
2. m3u8 파일 내에서 TS 접근 경로가 상대 경로일 때만 연동 적용됩니다. TS 주소가 절대 경로이면 TS 파일은 연동되지 않습니다. 주의해서 조작하시기 바랍니다.
3. TS 파일이 절대 경로로 명시된 m3u8 파일의 경우, m3u8 파일 처리 전에 먼저 m3u8 내용을 파싱하여 TS 파일을 별도로 처리하는 것이 권장됩니다.*

응답 설명

아래와 같은 형식의 JSON 문자열이 반환됩니다:

{
    "code":     "<code string>",
    "message":   "<message string>"
}
필드명 필수 여부 설명
code HTTP 요청 응답 코드. HTTP 응답 상태 코드 참고
message 요청 결과 메시지. OK는 성공을 의미합니다.

예시

curl -v -X POST -d"bucket=aW1hZ2Vz&key=bGVodS5tcDQ==&deadline=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/setdeadline"
이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.