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

Object Storage Service:ファイルのダウンロード (Python SDK V2)

最終更新日:Nov 09, 2025

Python SDK V2 は、オブジェクトのダウンロード用に複数のインターフェイスを提供しており、シナリオに最も適したものを選択できます。

タイプ

インターフェイス名

説明

シンプルダウンロード

client.get_object

  • ストリーミングダウンロード、応答本文は StreamBody 型

  • CRC-64 を直接サポートしない

  • プログレスバー機能を直接サポートしない

  • ストリーミング読み取り中の失敗した接続に対する再接続をサポートしない

client.get_object_to_file

  • オブジェクトをローカルファイルとしてダウンロード

  • 単一接続を使用してダウンロード

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

  • プログレスバー機能をサポート

  • 失敗した接続に対する再接続をサポート

レンジダウンロード

client.get_object

  • 特定のデータ範囲をダウンロード

読み取り専用クラスファイル

ReadOnlyFile

ReadOnlyFile.read

ReadOnlyFile.seek

ReadOnlyFile.close

  • File-Like インターフェイス、read、seek、close インターフェイスを提供

  • シーク機能を提供

  • シングルストリームモードをサポート (デフォルト)

  • 非同期プリフェッチモードをサポートし、読み取り速度を向上

  • ブロックのプリフェッチとプリフェッチチャンク数を指定

  • CRC-64 を直接サポートしない

  • プログレスバー機能を直接サポートしない

  • 失敗した接続に対する再接続をサポート

署名付き URL を使用したダウンロード

client.presign

  • HTTP GET リクエストを許可し、ユーザーがオブジェクトをダウンロードすることを承認するための有効期間を持つ署名付き URL を生成

ファイルダウンロードマネージャー

Downloader.download_file

  • マルチパートダウンロードを実行して、オブジェクトをローカルファイルとしてダウンロード

  • パートサイズと並列ダウンロード可能なパート数を指定

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

  • プログレスバー機能をサポート

  • 失敗した接続に対する再接続をサポート

  • レジューム転送を提供

  • 最初に一時ファイルに書き込み、次に名前を変更 (設定可能、デフォルトで有効)