このトピックでは、マルチパートアップロードに関連するコマンドについて説明します。
osscmd は 2019 年 7 月 31 日に非推奨となりました。Alibaba Cloud は osscmd のメンテナンスおよび更新を終了しました。osscmd のコマンドは ossutil に統合されています。代わりに ossutil を使用してください。
init
説明:
init oss://bucket/object
マルチパートアップロードを初期化し、アップロード ID を返します。この ID は、後続のマルチパートアップロードコマンドで使用されます。
例:
python osscmd init oss://mybucket/myobject
listpart
説明:
listpart oss://bucket/object --upload_id=xxx
特定のオブジェクトについて、アップロード済みのパートを一覧表示します。マルチパートアップロードタスクのアップロード ID を指定する必要があります。関連する概念の詳細については、「OSS API Reference」をご参照ください。
例:
python osscmd listpart oss://mybucket/myobject --upload_id=
75835E389EA648C0B93571B6A46023F3
listparts
説明:
listparts oss://bucket
バケット内の未完了のマルチパートアップロードをすべて一覧表示します。これには、オブジェクト名とアップロード ID が含まれます。バケットを削除しようとした際にバケットが空ではないことを示すエラーが発生した場合は、このコマンドを使用して未完了のマルチパートアップロードがないか確認できます。
例:
python osscmd listparts oss://mybucket
getallpartsize
説明:
getallpartsize oss://bucket
バケット内で進行中のすべてのマルチパートアップロードについて、アップロード済みのすべてのパートの合計サイズを表示します。
例:
python osscmd getallpartsize oss://mybucket
cancel
説明:
cancel oss://bucket/object --upload_id=xxx
指定したアップロード ID に対応するマルチパートアップロードイベントを中止します。
例:
python osscmd cancel oss://mybucket/myobject --upload_id=
D9D278DB6F8845E9AFE797DD235DC576
multiupload(multi_upload,mp)
説明:
multiupload(multi_upload,mp) localfile oss://bucket/object --check_md5=false
--thread_num=10マルチパートアップロードを使用して、ローカルファイルを OSS にアップロードします。
例:
-
python osscmd multiupload /tmp/localfile.txt oss://mybucket/object -
python osscmd multi_upload /tmp/localfile.txt oss://mybucket/object -
python osscmd mp /tmp/localfile.txt oss://mybucket/object
説明:
multiupload(multi_upload,mp) localfile oss://bucket/object --upload_id=xxx --thread_num=10
--max_part_num=1000 --check_md5=falseマルチパートアップロードを使用して、ローカルファイルを OSS にアップロードします。max_part_num パラメータはパート数を指定します。再開可能なアップロードを有効にするには、init コマンドを実行してアップロード ID を取得し、このコマンドでその ID を指定します。アップロードが中断した場合は、同じアップロード ID を指定してコマンドを再実行することで、アップロードを再開できます。このコマンドは、すでにアップロードされ検証済みのパートをスキップします。検証のために Content-MD5 リクエストヘッダーを含めるには、--check_md5 を true に設定します。デフォルト値は false です。
例:
python osscmd multiupload /tmp/localfile.txt oss://mybucket/object --upload_id= D9D278DB6F8845E9AFE797DD235DC576python osscmd multi_upload /tmp/localfile.txt oss://mybucket/object --thread_num=5-
python osscmd mp /tmp/localfile.txt oss://mybucket/object --max_part_num=100
copylargefile
説明:
copylargefile oss://source_bucket/source_object oss://target_bucket/target_object
--part_size=10*1024*1024 --upload_id=xxx
マルチパートコピーを使用して、サイズの大きいオブジェクト (1 GB 超) を指定した宛先にコピーします。コピー元とコピー先のバケットは同じリージョンに存在する必要があります。upload_id パラメータは任意です。中断したコピー操作を再開するには、元のコピーイベントの upload_id を指定します。part_size パラメータを使用して、各パートのサイズを設定できます。最小パートサイズは 100 KB で、最大 10,000 パートがサポートされています。指定した part_size が OSS の制限に違反している場合、ツールはサイズを自動的に調整します。
例:
python osscmd copylargefile oss://source_bucket/source_object
oss://target_bucket/target_object --part_size=10*1024*1024
uploadpartfromfile (upff)
説明:
uploadpartfromfile (upff) localfile oss://bucket/object --upload_id=xxx
--part_number=xxxこのコマンドはテスト目的でのみ使用し、一般的な用途での使用は推奨しません。
uploadpartfromstring (upfs)
説明:
uploadpartfromstring (upfs) oss://bucket/object --upload_id=xxx --part_number=xxx
--data=xxxこのコマンドはテスト目的でのみ使用し、一般的な用途での使用は推奨しません。