최신 업데이트:2025-08-18 15:31:53
CDNetworks Object Storage는 현재 세 가지 업로드 모드(일반 업로드, 콜백 업로드, 알림 업로드)를 지원합니다. 아래는 이 세 가지 업로드 모드에 대한 비교입니다.
| 모드명 | 트리거 메커니즘 | 응답 컨트롤러 | 적용 시나리오 |
|---|---|---|---|
| 일반 업로드 | API 직접 호출 | Object Storage 플랫폼 | 단순 파일 전송 |
| 콜백 업로드 | 콜백 파라미터가 포함된 API | 클라이언트 비즈니스 시스템 | 커스텀 응답이 필요한 경우 |
| 알림 업로드 | 처리 지시가 포함된 API | 비동기 알림 시스템 | 오디오/비디오 트랜스코딩 등, 시간이 오래 걸리는 작업 |
업로드 결과는 모두 Object Storage 플랫폼에 의해 통일적으로 제어됩니다.

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

콜백 업로드(POST 방식): Upload Policy Data의 callbackUrl 파라미터를 활성화해야 하며, callbackBody 파라미터는 선택 사항이지만 권장됩니다.
보안을 위해, Object Storage 플랫폼은 콜백 업로드 인터페이스 호출 시 요청 헤더에 Authorization 정보를 추가합니다. 기업 웹 시스템에서는 이 정보의 유효성을 검증하여 불법적인 콜백 요청을 차단할 수 있습니다.
재시도 정책: Object Storage 플랫폼에는 콜백 요청 재시도 메커니즘이 내장되어 있어, 정상적으로 콜백 요청이 알림될 수 있도록 보장합니다.
파일 업로드 시, 사용자는 파일 처리 지시사항(비디오 트랜스코딩, 이미지 워터마크, 이미지 크기 조정 등)을 함께 제출하여, Object Storage 플랫폼이 업로드된 파일을 처리하도록 요청할 수 있습니다. 이러한 처리는 일반적으로 시간이 오래 걸리기 때문에, Object Storage 플랫폼은 비동기 처리 전략을 채택하여 클라이언트의 사용 경험에 영향을 주지 않도록 합니다. 처리 작업이 비동기로 실행되고, 완료되면 기업 웹 서비스 시스템에 비동기 알림 방식으로 결과를 통지합니다. 기업 웹 시스템은 다시 클라이언트와 연동하여 전체 처리와 알림 프로세스를 완성합니다.

알림 업로드(POST 방식): Upload Policy Data의 persistentOps 및 persistentNotifyUrl 파라미터를 사용합니다.
재시도 정책: persistentNotifyUrl 주소로 알림 콜백이 실패할 경우, 플랫폼은 재시도 메커니즘을 활성화하여 기본적으로 8회까지 재시도합니다.