Upload Modes

最終更新日:2025-08-18 15:31:53

CDNetworks Object Storageは、現在3つのアップロードモード(通常アップロード、コールバックアップロード、および通知アップロード)をサポートしています。これら3つのモードの比較は以下の通りです。

モード名 トリガーメカニズム レスポンスコントローラー 適用シナリオ
通常アップロード APIの直接呼び出し Object Storageプラットフォーム シンプルなファイル転送
コールバックアップロード コールバックパラメータ付きAPI クライアント業務システム カスタムレスポンスが必要な場合
通知アップロード 処理指示付きAPI 非同期通知システム 音声・動画のトランスコーディングなど、時間がかかる操作

通常アップロード

全てのアップロード返却結果は、Object Storageプラットフォームによって統一的に管理されます。
Hermes Upload 서버 작업 안내

コールバックアップロード

ファイルのアップロード後、クライアントへの返却情報のフォーマットをカスタマイズできます。
Hermes Upload 서버 작업 안내

コールバックアップロード(POST方式):Upload Policy DataのcallbackUrlパラメータを有効にする必要があり、callbackBodyパラメータは任意ですが推奨されます。

セキュリティを確保するために、Object Storageプラットフォームはコールバック時にAuthorization情報をリクエストヘッダーに追加します。企業のWebシステム側は、この情報の有効性を検証することで不正なコールバックリクエストをブロックできます。

リトライポリシー:Object Storageプラットフォームはコールバックリクエストのリトライメカニズムを備えており、コールバックリクエストが正常に通知できるようにします。

通知アップロード

ファイルをアップロードする際、ユーザーはファイル処理指示(動画トランスコーディング、画像ウォーターマーク、画像リサイズなどの操作を含む)を送信し、Object Storageプラットフォームにアップロードしたファイルの処理を依頼します。これらの処理は通常時間がかかるため、Object Storageプラットフォームは非同期処理戦略を採用し、クライアント側の体験への影響を避けます。処理が完了すると、非同期通知手段により企業のWebサービスシステムに結果が通知され、企業のWebシステムがクライアントとの連携を通じて一連の処理および通知を完了させます。
Hermes Upload 서버 작업 안내

通知アップロード(POST方式):Upload Policy DataのpersistentOpsパラメータとpersistentNotifyUrlパラメータを使用します。

リトライポリシーpersistentNotifyUrlアドレスで通知コールバックに失敗した場合、プラットフォームはリトライメカニズムを起動し、デフォルトで最大8回リトライします。