Upload Modes

최신 업데이트:2025-08-18 15:31:53

CDNetworks Object Storage는 현재 세 가지 업로드 모드(일반 업로드, 콜백 업로드, 알림 업로드)를 지원합니다. 아래는 이 세 가지 업로드 모드에 대한 비교입니다.

모드명 트리거 메커니즘 응답 컨트롤러 적용 시나리오
일반 업로드 API 직접 호출 Object Storage 플랫폼 단순 파일 전송
콜백 업로드 콜백 파라미터가 포함된 API 클라이언트 비즈니스 시스템 커스텀 응답이 필요한 경우
알림 업로드 처리 지시가 포함된 API 비동기 알림 시스템 오디오/비디오 트랜스코딩 등, 시간이 오래 걸리는 작업

일반 업로드

업로드 결과는 모두 Object Storage 플랫폼에 의해 통일적으로 제어됩니다.
image.png

콜백 업로드

파일 업로드 후, 클라이언트에 반환되는 정보의 포맷을 커스터마이징할 수 있습니다.
image.png

콜백 업로드(POST 방식): Upload Policy Data의 callbackUrl 파라미터를 활성화해야 하며, callbackBody 파라미터는 선택 사항이지만 권장됩니다.

보안을 위해, Object Storage 플랫폼은 콜백 업로드 인터페이스 호출 시 요청 헤더에 Authorization 정보를 추가합니다. 기업 웹 시스템에서는 이 정보의 유효성을 검증하여 불법적인 콜백 요청을 차단할 수 있습니다.

재시도 정책: Object Storage 플랫폼에는 콜백 요청 재시도 메커니즘이 내장되어 있어, 정상적으로 콜백 요청이 알림될 수 있도록 보장합니다.

알림 업로드

파일 업로드 시, 사용자는 파일 처리 지시사항(비디오 트랜스코딩, 이미지 워터마크, 이미지 크기 조정 등)을 함께 제출하여, Object Storage 플랫폼이 업로드된 파일을 처리하도록 요청할 수 있습니다. 이러한 처리는 일반적으로 시간이 오래 걸리기 때문에, Object Storage 플랫폼은 비동기 처리 전략을 채택하여 클라이언트의 사용 경험에 영향을 주지 않도록 합니다. 처리 작업이 비동기로 실행되고, 완료되면 기업 웹 서비스 시스템에 비동기 알림 방식으로 결과를 통지합니다. 기업 웹 시스템은 다시 클라이언트와 연동하여 전체 처리와 알림 프로세스를 완성합니다.
image.png

알림 업로드(POST 방식): Upload Policy Data의 persistentOps 및 persistentNotifyUrl 파라미터를 사용합니다.

재시도 정책: persistentNotifyUrl 주소로 알림 콜백이 실패할 경우, 플랫폼은 재시도 메커니즘을 활성화하여 기본적으로 8회까지 재시도합니다.

이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.