すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:OSS SDK for Go 2.0 を使用してオブジェクトをアップロードする

最終更新日:Aug 13, 2025

Object Storage Service (OSS) SDK for Go V2 は、さまざまなアップロード操作を提供します。ビジネスシナリオに基づいて、オブジェクトをアップロードする適切な操作を選択できます。

種類

操作

説明

シンプルアップロード

Client.PutObject

  • シンプルアップロードを実行して、最大 5 GiB のオブジェクトをアップロードします。

  • CRC-64 をサポートします(デフォルトで有効)。

  • プログレスバーにアップロードタスクの進捗状況を表示します。

  • 種類が io.Reader のリクエストボディをサポートします。リクエストボディの種類が io.Seeker の場合、アップロードタスクが失敗すると、オブジェクトが再アップロードされます。

Client.PutObjectFromFile

  • Client.PutObject と同じ機能を提供します。

  • ローカルファイルのパスからリクエストボディを取得します。

追加アップロード

Client.AppendObject

  • 追加アップロードを実行して、最大 5 GiB のオブジェクトをアップロードします。

  • CRC-64 をサポートします(デフォルトで有効)。

  • プログレスバーにアップロードタスクの進捗状況を表示します。

  • 種類が io.Reader のリクエストボディをサポートします。リクエストボディの種類が io.Seeker の場合、アップロードタスクが失敗すると、オブジェクトが再アップロードされます。この操作は冪等であり、オブジェクトの再アップロードは失敗する可能性があります。

AppendOnlyFile 操作

AppendOnlyFile.Write

AppendOnlyFile.WriteFrom

  • Client.AppendObject と同じ機能を提供します。

  • オブジェクトの再アップロードが失敗した後のフォールトトレランスを最適化します。

マルチパートアップロード

マルチパートアップロード操作

Client.InitiateMultipartUpload

Client.UploadPart

Client.CompleteMultipartUpload

  • マルチパートアップロードを実行して、最大 48.8 TiB のオブジェクトをアップロードし、パートのサイズを最大 5 GiB に設定します。

  • UploadPart は CRC-64 をサポートします(デフォルトで有効)。

  • UploadPart を使用すると、プログレスバーでアップロードタスクの進捗状況を確認できます。

  • 種類が io.Reader のリクエストボディをサポートします。リクエストボディの種類が io.Seeker の場合、アップロードタスクが失敗すると、オブジェクトが再アップロードされます。

フォームアップロード

/

  • 署名やアップロードポリシーなどの情報を生成し、HTTP Post メソッドを使用してオブジェクトを OSS にアップロードします。

署名付き URL

Client.Presign

  • HTTP PUT リクエストを許可し、有効期間を持つ署名付き URL を生成して、ユーザーにオブジェクトのアップロードを承認します。

アップローダー

Uploader.UploadFrom

  • シンプルアップロード操作とマルチパートアップロード操作をカプセル化し、最大 48.8 TiB のオブジェクトをアップロードできるようにします。

  • CRC-64 をサポートします(デフォルトで有効)。

  • プログレスバーにアップロードタスクの進捗状況を表示します。

  • 種類が io.Reader のリクエストボディをサポートします。リクエストボディの io.Reader、io.Seeker、および io.ReaderAt の種類がサポートされている場合、データをメモリにキャッシュする必要はありません。そうでない場合は、データをメモリにキャッシュしてからアップロードする必要があります。

Uploader.UploadFile

  • Uploader.UploadFrom と同じ機能を提供します。

  • ローカルファイルのパスからリクエストボディを取得します。

  • 再開可能なアップロードをサポートします。