Bulk Modify File Retention Period
최신 업데이트：2025-08-18 15:32:48
이 인터페이스는 비동기 인터페이스로, 지정한 공간(버킷) 내 모든 파일이나 특정 디렉터리 내 파일들의 보존 기간을 일괄 수정할 수 있습니다.
참고:
동일한 파일에 대해 여러 번 보존기간 설정 시, 가장 마지막 설정값이 덮어쓰기(최종 적용)됩니다.
요청 설명
POST /fmgr/setdeadline
Host:<MgrDomain>
Authorization:<AccessToken>
헤더 설명
| 파라미터 | 필수 | 설명 |
|---|---|---|
| HOST | 예 | 관리 도메인 이름, 콘솔의 버킷 개요에서 확인 가능 |
| Authorization | 예 | 관리 인증 정보 |
파라미터 설명
요청 파라미터는 다음과 같이 구성되어 본문(request content)으로 제출됩니다.
fops =bucket/<Urlsafe_Base64_Encoded_Bucket>/deadline/<deadline>;bucket/<Urlsafe_Base64_Encoded_Bucket>/prefix/<Urlsafe_Base64_Encoded_prefix>/deadline/<deadline>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| 파라미터 | 필수 | 설명 |
|---|---|---|
| fops | 예 | 처리 파라미터 목록. 위 포맷 참조, 여러 건 동시 지원하며 각각 세미콜론 (;)으로 구분. |
| bucket | 예 | 버킷 명 지정. <Urlsafe_Base64_Encoded_bucket>는 지정 버킷 이름을 URL-safe Base64로 인코딩한 값. |
| prefix | 아니오 | 지정 디렉토리명(접두사). <Urlsafe_Base64_Encoded_prefix>는 해당 prefix를 URL-safe Base64로 인코딩한 값.참고: 1. prefix 미지정 시(빈 값) 해당 공간의 모든 파일에 적용 2. 부분(퍼지) 매칭 불가. 예: prefix가 test라면 test123으로 시작하는 key는 적용받지 않음 |
| deadline | 예 | 파일 보존 기간(일 단위). 입력한 일 수가 지난 파일은 자동 삭제됨. 예: 1, 2, 3 … 참고: 0 = 즉시 삭제, -1 = 만료시간 해제 및 영구 보관 |
| notifyURL | 아니오 | 처리 결과를 통지받을 URL. |
요청 파라미터 예시
fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==/deadline/10;bucket/bXlidWNrZXQ=/prefix/YWFiLw==/deadline/30¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1
응답 설명
- 요청 성공 시, 아래와 같은 Json 문자열이 반환됩니다.
{ "persistentId": <persistentId> }
| 파라미터 | 설명 |
|---|---|
| persistentId | 작업 프로세스 ID(진행 상태 질의에 사용됨) |
- 요청 실패 시, 아래와 같은 Json 문자열이 반환됩니다.
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| 필드명 | 설명 |
|---|---|
| code | HTTP 요청 응답 코드. HTTP 응답 상태 코드 참고 |
| message | 요청 실패 메시지 |
요청 예시
curl -v -X POST -d "fops=bucket/bXlidWNrZXQ=/prefix/YWFjLw==/deadline/10;bucket/bXlidWNrZXQ=/prefix/YWFiLw==/deadline/30¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/setdeadline"
이 문서의 내용이 도움이 되었습니까?
예
아니오