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

Object Storage Service:ダウンロードの進捗プログレスバー

最終更新日:Feb 23, 2024

進行状況バーを設定して、アップロードまたはダウンロードタスクの進行状況を表示できます。

使用上の注意

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

  • このトピックでは、アクセス資格情報は環境変数から取得します。 アクセス資格情報の設定方法の詳細については、「アクセス資格情報の設定」をご参照ください。

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

次のサンプルコードは、bucket.get_object_to_fileを使用してオブジェクトをダウンロードするときにプログレスバーを使用する方法の例を示しています。

# -*-コーディング: utf-8 -*-
__future__ import print_functionから
os、sysのインポート
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 ', 'yourBucketName')
# Content-LengthがHTTPレスポンスヘッダーにない場合、total_bytesの値はNoneです。 
# consumed_bytesは、ダウンロードされたデータのサイズを指定します。 単位:バイト 
# total_bytesは、ダウンロードするオブジェクトの合計サイズを指定します。 単位:バイト 
def percentage(consumed_bytes, total_bytes):
    if total_bytes:
        rate = int(100 * (float(consumed_bytes) / float(total_bytes)))
        # rateはダウンロードの進行状況を指定します。 
        print('\r{0}% '.format(rate), end='')

        sys.stdout.flush()

# progress_callbackは、進行状況情報を返すために使用されるオプションのパラメーターです。 
bucket.get_object_to_file('yourObjectName', 'yourLocalFile ', progress_callback=percentage) 

参考資料

オブジェクトダウンロードタスクのプログレスバーを設定するための完全なサンプルコードについては、GitHubをご覧ください。