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

Object Storage Service:ストリーミングダウンロード

最終更新日:Feb 26, 2024

ストリーミングダウンロードを使用すると、オブジェクトをストリーム単位でダウンロードできます。 大きなオブジェクトをダウンロードしたい場合、またはダウンロードの完了に長時間を要する場合は、ストリーミングダウンロードを実行してオブジェクトを増分単位でダウンロードできます。

使用上の注意

  • このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。 OSSと同じリージョンにある他のAlibaba CloudサービスからOSSにアクセスする場合は、内部エンドポイントを使用します。 OSSリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

  • このトピックでは、OSSエンドポイントを使用してOSSClientインスタンスを作成します。 カスタムドメイン名またはSTS (Security Token Service) を使用してOSSClientインスタンスを作成する場合は、「初期化」をご参照ください。

  • ストリーミングダウンロードを使用するには、oss:GetObject権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

サンプルコード

次のサンプルコードは、ストリーミングダウンロードを実行して、examplebucketという名前のバケットからexampleobject.txtという名前のオブジェクトをダウンロードする方法の例を示しています。

# -*-コーディング: utf-8 -*-
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# サーバーオブジェクトを作成します。 
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')

# bucket.get_objectによって返される値は、繰り返し処理できるファイルのようなオブジェクトです。 
# オブジェクトのフルパスを指定します。 オブジェクトのフルパスにバケット名を含めないでください。 
object_stream = bucket.get_object ('exampleobject.txt ')
プリント (object_stream.read())

# オブジェクトのCRC-64値を計算する前に、get_objectによって返されたストリームからオブジェクトを読み取るには、read() 操作を呼び出す必要があります。 
object_stream.client_crcの場合! =object_stream.server_crc:
    印刷 (「クライアントとサーバー間のCRCチェックサムに矛盾があります! 」) 

次のサンプルコードは、exampleobject.txtという名前のオブジェクトのデータを、D:\localpathディレクトリのexamplefile.txtという名前のファイルとしてストリームからダウンロードする方法の例を示しています。

インポートshutil
oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# サーバーオブジェクトを作成します。 
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')

# object_streamはファイルのようなオブジェクトです。 shutil.copyfileobjメソッドを使用して、ストリームからローカルファイルにデータをダウンロードできます。 
# オブジェクトのフルパスを指定します。 オブジェクトのフルパスにバケット名を含めないでください。 
object_stream = bucket.get_object ('exampleobject.txt ')
# 指定したパスのローカルファイルとしてオブジェクトをダウンロードします。 指定されたパスに同じ名前のファイルがすでに存在する場合、ダウンロードされたオブジェクトはファイルを上書きします。 それ以外の場合、ダウンロードしたファイルはパスに保存されます。 
# ダウンロードしたオブジェクトのパスを指定しない場合、ダウンロードしたオブジェクトはサンプルプログラムが属するプロジェクトのパスに保存されます。 
オープン ('D :\\ localpath\\examplefile.txt '、'wb') をlocal_fileobjとして:
    shutil.copyfileobj(object_stream, local_fileobj) 

次のサンプルコードは、exampleobject.txtという名前のオブジェクトのデータをストリームからexampleobjectnew.txtという名前のオブジェクトにコピーする方法の例を示しています。

oss2のインポート
oss2.credentialsからEnvironmentVariableCredentialsProviderをインポート

# サーバーオブジェクトを作成します。 
# 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。 
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# バケットが配置されているリージョンのエンドポイントを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、エンドポイントをhttps://oss-cn-hangzhou.aliyuncs.comに設定します。 
# バケットの名前を指定します。 
bucket = oss2.Bucket(auth, 'https:// oss-cn-hangzhou.aliyuncs.com ', 'examplebucket')

# object_streamは反復可能なオブジェクトです。 オブジェクトのデータをストリームから同じバケット内の別のオブジェクトにコピーできます。 
# オブジェクトのフルパスを指定します。 オブジェクトのフルパスにバケット名を含めないでください。 
object_stream = bucket.get_object ('exampleobject.txt ')
# 宛先オブジェクトのフルパスを指定します。 オブジェクトのフルパスにバケット名を含めないでください。 
bucket.put_object ('exampleobjectnew.txt ', object_stream) 

参考資料

  • ストリーミングダウンロードの実行に使用される完全なサンプルコードについては、『GitHub』をご参照ください。

  • ストリーミングダウンロードを実行するために呼び出すことができるAPI操作の詳細については、「GetObject」をご参照ください。