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

アップロード方法

OSS では、ファイルをアップロードするために次の方法が提供されています。

• シンプルアップロード: この方法は、最大 5 GB の小さなファイルのアップロードに適しています。OSS が提供する PutObject 操作を呼び出して、ファイルをアップロードできます。構成は必要ありません。

• マルチパートアップロード: この方法は、最大 48.8 TB の大きなファイルのアップロードに適しています。 InitiateMultipartUpload、UploadPart、および CompleteMultipartUpload 操作を呼び出して、ファイルを複数の部分に分割し、それらの部分を並行してアップロードできます。部分をアップロードした後、すべての部分を結合して完全なオブジェクトにすることができます。ネットワーク例外によってアップロードが中断された場合、クライアントは失敗した部分を手動で記録し、それらの部分を再アップロードします。

• 追加アップロード: この方法は、ビデオストリームなど、追加するファイルをアップロードするのに適しています。アップロードする単一ファイルのサイズは最大 5 GB です。OSS が提供する AppendObject 操作を呼び出して、ファイルをアップロードし、追加可能なオブジェクトを生成できます。既存の追加可能なオブジェクトにコンテンツを追加できます。追加可能なオブジェクトに追加されたデータはすぐに読み取ることができます。追加アップロードは、追加可能なオブジェクトのみをサポートします。

• 再開可能なアップロード: この方法は、不安定なネットワーク経由で最大 48.8 TB の大きなファイルをアップロードするのに適しています。OSS SDK が提供するマルチパートアップロードベースの方法（OSS SDK for Java が提供する uploadFile メソッドなど）を呼び出して、クライアントのアップロードの進捗状況を自動的に記録し、アップロードが停止した位置からアップロードを再開できます。

• フォームアップロード: この方法は、OSS への HTTP POST リクエストを開始することで、HTML ページで最大 5 GB のオブジェクトをアップロードするのに適しています。サーバーによって生成されたポリシーを使用して、アップロードするオブジェクトの属性（オブジェクトのサイズやタイプなど）を制限できます。

参照

• OSS SDK が提供するアップロードプログレスバーを使用して、アップロードの進捗状況とアップロードの完了に必要な残り時間を表示できます。詳細については、「アップロードプログレスバー」をご参照ください。

• オブジェクトを OSS にアップロードした後、アップロードコールバックを使用して、指定されたアプリケーションサーバーにコールバックリクエストを送信できます。詳細については、「アップロードコールバック」をご参照ください。

• アップロードされたオブジェクトのキャッシュ、ダウンロード、および処理を制御する場合は、オブジェクトをアップロードするときに、オブジェクトメタデータ（Content-Type などの標準 HTTP ヘッダーを含む）を構成できます。詳細については、「オブジェクトメタデータの管理」をご参照ください。

• クライアントから OSS に直接ファイルをアップロードすることをお勧めします。このソリューションは、アプリケーションサーバーとの間でオブジェクトを転送する必要がないため、アップロードを高速化し、アプリケーションサーバーのリソース使用量を削減します。詳細については、「概要」をご参照ください。

• アップロードしたイメージを圧縮し、イメージのカスタムスタイルを構成できます。詳細については、「IMG 実装モード」をご参照ください。

• イメージのアップロード後にイメージサイズを取得する必要がある場合は、?x-oss-process=image/info を指定して、イメージに関する基本情報をクエリできます。詳細については、「イメージの EXIF データのクエリ」をご参照ください。

• アップロードされたイメージまたはビデオで、テキストの認識、字幕の抽出、トランスコード、サムネイルの生成などの操作を実行する場合は、「機能」をご参照ください。

• アップロードされたオブジェクトの URL に署名情報を追加し、署名付き URL を共有して、サードパーティがオブジェクトにアクセスできるようにすることができます。詳細については、「署名付き URL を使用してオブジェクトをダウンロードする」をご参照ください。