Object Storage Service:OSS へのオブジェクトのアップロード方法

アップロード方法

OSS は 6 つのアップロード方法を提供します。ファイルサイズ、ネットワーク条件、およびアップロードの開始者に基づいて選択してください。

• シンプルアップロード：単一の PutObject API 呼び出しで最大 5 GB のファイルをアップロードできます。設定は不要です。ファイルサイズとネットワークの安定性が問題にならない、日常的なアップロードにはこの方法を使用してください。

• マルチパートアップロード：ファイルをパーツに分割し、並列でアップロードすることで、最大 48.8 TB のファイルをアップロードできます。InitiateMultipartUpload、UploadPart、CompleteMultipartUpload を順番に呼び出してください。OSS はパーツを 1 つのオブジェクトに組み立てます。アップロードが中断された場合、クライアントは失敗したパーツを記録し、それらのパーツのみを再試行します。並列スループットが重要な大きいファイルにはこの方法を使用してください。

• 追加アップロード：AppendObject API を使用して、既存のオブジェクトにデータを追加できます。各追加のサイズは最大 5 GB です。追加されたデータはすぐに読み取り可能です。コンテンツが継続的に増加する動画ストリームやログファイルにはこの方法を使用してください。この方法は、追加可能なオブジェクトでのみ利用できます。

• 再開可能なアップロード：信頼性の低い接続を介して最大 48.8 TB のファイルをアップロードできます。OSS SDK for Java の uploadFile メソッドなどの OSS SDK は、進行状況を自動的にチェックポイントするため、アップロードは中断した箇所から再開されます。ネットワークの中断が予測され、クライアント側の再試行ロジックなしで自動回復が必要な場合は、マルチパートアップロードの代わりとしてこの方法を使用してください。

• フォームベースのアップロード：HTTP POST を介して、ユーザーが HTML ページから直接最大 5 GB のオブジェクトをアップロードできるようにします。サーバーで生成されたポリシーは、オブジェクトのサイズやタイプなどのアップロード制約を制御します。ブラウザがアップロードを開始する Web アプリケーションにはこの方法を使用してください。

• 署名付き URL アップロード：AccessKey ペアを共有することなく、サードパーティに 5 GB 未満のオブジェクトをアップロードする権限を付与できます。定義された有効期限を持つ署名付き URL を生成してください。URL は有効期限が切れると自動的に無効になります。期間限定でアップロードアクセスを委任する必要がある場合に、この方法を使用してください。

関連機能

• OSS SDK のアップロードプログレスバーを使用して、アップロードの進行状況と推定残り時間を表示できます。詳細については、「アップロードプログレスバー」をご参照ください。

• アップロードコールバックを使用して、アップロード後にアプリケーションサーバーへのコールバックをトリガーできます。詳細については、「アップロードコールバック」をご参照ください。

• キャッシュ、ダウンロード、処理の動作を制御するには、アップロード時に Content-Type などの標準 HTTP ヘッダーを含むオブジェクトメタデータを設定してください。詳細については、「オブジェクトメタデータの管理」をご参照ください。

• クライアントから OSS にファイルを直接アップロードすることで、アプリケーションサーバーの負荷を軽減し、アップロード速度を向上させることができます。詳細については、「概要」をご参照ください。

• ウォーターマーク、フォーマット変換、メタデータクエリなどの画像処理操作については、「画像処理方法」をご参照ください。

• アップロード後の動画トランスコーディングとフレームキャプチャについては、「オーディオとビデオの処理」をご参照ください。

• PowerPoint および Word ドキュメントのオンラインプレビューと編集については、「WebOffice オンラインプレビュー」および「WebOffice オンライン編集」をご参照ください。

• アップロードされたオブジェクトをサードパーティと共有するには、オブジェクト URL に署名情報を追加し、署名付き URL を配布してください。詳細については、「署名付き URL を使用したファイルのダウンロードまたはプレビュー」をご参照ください。