最終更新日:2025-08-18 15:31:53
CDNetworks Object Storageは、現在3つのアップロードモード(通常アップロード、コールバックアップロード、および通知アップロード)をサポートしています。これら3つのモードの比較は以下の通りです。
| モード名 | トリガーメカニズム | レスポンスコントローラー | 適用シナリオ |
|---|---|---|---|
| 通常アップロード | APIの直接呼び出し | Object Storageプラットフォーム | シンプルなファイル転送 |
| コールバックアップロード | コールバックパラメータ付きAPI | クライアント業務システム | カスタムレスポンスが必要な場合 |
| 通知アップロード | 処理指示付きAPI | 非同期通知システム | 音声・動画のトランスコーディングなど、時間がかかる操作 |
全てのアップロード返却結果は、Object Storageプラットフォームによって統一的に管理されます。

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

コールバックアップロード(POST方式):Upload Policy DataのcallbackUrlパラメータを有効にする必要があり、callbackBodyパラメータは任意ですが推奨されます。
セキュリティを確保するために、Object Storageプラットフォームはコールバック時にAuthorization情報をリクエストヘッダーに追加します。企業のWebシステム側は、この情報の有効性を検証することで不正なコールバックリクエストをブロックできます。
リトライポリシー:Object Storageプラットフォームはコールバックリクエストのリトライメカニズムを備えており、コールバックリクエストが正常に通知できるようにします。
ファイルをアップロードする際、ユーザーはファイル処理指示(動画トランスコーディング、画像ウォーターマーク、画像リサイズなどの操作を含む)を送信し、Object Storageプラットフォームにアップロードしたファイルの処理を依頼します。これらの処理は通常時間がかかるため、Object Storageプラットフォームは非同期処理戦略を採用し、クライアント側の体験への影響を避けます。処理が完了すると、非同期通知手段により企業のWebサービスシステムに結果が通知され、企業のWebシステムがクライアントとの連携を通じて一連の処理および通知を完了させます。

通知アップロード(POST方式):Upload Policy DataのpersistentOpsパラメータとpersistentNotifyUrlパラメータを使用します。
リトライポリシー:persistentNotifyUrlアドレスで通知コールバックに失敗した場合、プラットフォームはリトライメカニズムを起動し、デフォルトで最大8回リトライします。