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

Object Storage Service:ファイルのアップロード (Python SDK V2)

最終更新日:Nov 09, 2025

OSS SDK for Python V2 は、ファイルをアップロードするためのさまざまな操作を提供します。シナリオに最も適した操作を選択できます。

タイプ

操作名

説明

シンプルアップロード (Python SDK V2)

client.put_object

  • シンプルアップロードを実行します。アップロードできるオブジェクトの最大サイズは 5 GiB です。

  • 64 ビット巡回冗長検査 (CRC-64) データ検証をサポートします。この機能はデフォルトで有効になっています。

  • 進捗横棒グラフをサポートします。

  • リクエストボディは io.Reader タイプです。io.Seeker タイプがサポートされている場合、アップロードに失敗すると再送が実行されます。

client.put_object_from_file

  • client.put_object 操作と同じ機能を提供します。

  • リクエストボディデータはファイルパスから取得されます。

追加アップロード (Python SDK V2)

client.append_object

  • 追加アップロードを実行します。最終的なオブジェクトの最大サイズは 5 GiB です。

  • CRC-64 データ検証をサポートします。この機能はデフォルトで有効になっています。

  • 進捗横棒グラフをサポートします。

  • リクエストボディは BodyType タイプです。アップロードに失敗すると再送が実行されます。この操作はべき等ではありません。再送が失敗する可能性があります。

AppendOnlyFile 操作

AppendOnlyFile.write

AppendOnlyFile.write_from

  • client.append_object 操作と同じ機能を提供します。

  • 再送失敗に対するフォールトトレランスを最適化します。

マルチパートアップロード (Python SDK V2)

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

client.initiate_multipart_upload

client.upload_part

client.complete_multipart_upload

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

  • upload_part 操作は CRC-64 検証をサポートします。この機能はデフォルトで有効になっています。

  • upload_part 操作は進捗横棒グラフをサポートします。

  • upload_part 操作のリクエストボディは BodyType タイプです。str、bytes、Iterable[bytes]、IO[str]、および IO[bytes] タイプもサポートされています。

フォームアップロード (Python SDK V2)

/

  • Post 署名や Post ポリシーなどの情報を生成し、HTTP POST メソッドを呼び出してファイルを OSS にアップロードします。

署名付き URL を使用したアップロード (Python SDK V2)

client.presign

  • 有効期限付きの PUT メソッド用の署名付き URL を生成します。これにより、他のユーザーが一時的にファイルをアップロードできるようになります。

ファイルアップロードマネージャー (Python SDK V2)

Uploader.upload_from

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

  • CRC-64 データ検証をサポートします。この機能はデフォルトで有効になっています。

  • 進捗横棒グラフをサポートします。

  • リクエストボディパラメーターは IO[bytes] タイプです。

Uploader.upload_file

  • Uploader.upload_from 操作と同じ機能を提供します。

  • リクエストボディデータはファイルパスから取得されます。

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