信頼できないネットワーク接続は、ファイルのアップロードやダウンロードを中断し、多くの不便を引き起こします。 ossutilは、中断されたデータ転送を再開し、完全かつ効率的なアップロードとダウンロードを保証するために使用できる再開可能な転送を提供します。 このトピックでは、再開可能転送を使用して、不安定なネットワーク接続でファイル転送効率を維持する方法について説明します。
シナリオ
ネットワーク接続が不安定または失われた場合、ossutilはアップロードまたはダウンロードを終了する可能性があります。 重複したアップロードや同じデータのダウンロードを防ぎ、アップロードとダウンロードの効率を維持するために、ossutilの再開可能転送機能を使用できます。
説明
デフォルトでは、再開可能転送は無効になっています。
前提条件
Object Storage Service (OSS) が有効化されています。 詳細については、「OSSの有効化」をご参照ください。
バケット作成についての 詳細は、「バケットの作成」をご参照ください。
ossutil 2.0がインストールされています。 詳細については、「ossutilのインストール」をご参照ください。
再開可能なアップロード
大きなファイルは部分的にアップロードされます。 再開可能なアップロードでは、オブジェクト名、サイズ、アップロードIDなどのアップロード情報がチェックポイントファイルに格納されます。指定されたディレクトリのucp拡張子。 アップロードが中断から再開されると、ossutilはチェックポイントファイルからアップロードIDを読み取り、アップロードIDを使用してアップロードされたパーツを照会し、残りのパーツのみをアップロードします。
再開可能なダウンロード
大きなファイルは部分的にダウンロードされます。 再開可能なダウンロードでは、ダウンロード情報は指定されたディレクトリのチェックポイントファイルに格納されます。 ダウンロードが中断から再開されると、ossutilはチェックポイントファイルからアップロード情報を読み取り、ダウンロードされていない部分のみをダウンロードします。
Parameters
パラメーター | 説明 |
-- checkpoint-dir | チェックポイントファイルを格納するディレクトリ。 |
例
1つのファイルをアップロード
一度に複数のファイルをアップロード
次のサンプルcpコマンドは、再開可能アップロードを使用して、upload.rarファイルを "bucket" という名前のバケットにアップロードします。 ossutilはaを作成します。-checkpoint-dirディレクトリにあるucp checkpointファイルで、アップロードの進行状況情報を保存します。 接続の喪失やディスクの読み取り /書き込み例外などの理由でアップロードが中断された場合は、同じコマンドを実行してアップロードを再開できます。
ossutil cp upload.rar oss://bucket --checkpoint-dir D:\\your-checkpoint-dir\
次のサンプルcpコマンドは、"local_directory" という名前のローカルディレクトリから "bucket" という名前のバケットに複数のファイルをアップロードします。 コマンドでは、-uオプションは、アップロード先オブジェクトよりも最後に変更されたファイルのみを含むことを指定します。-rオプションは、ディレクトリ内のすべてのオブジェクトとそのすべてのサブディレクトリに対してコマンドを実行することを指定します。 ossutilはaを作成します。-checkpoint-dirディレクトリにあるucp checkpointファイルで、アップロードの進行状況情報を保存します。 接続の喪失やディスクの読み取り /書き込み例外などの理由でアップロードが中断された場合は、同じコマンドを実行してアップロードを再開できます。
ossutil cp -u -r local_directory oss://bucket --checkpoint-dir D:\\your-checkpoint-dir\