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

:マルチパートコマンド

最終更新日:Sep 24, 2026

このトピックでは、マルチパートアップロードに関連するコマンドについて説明します。

重要

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=
              D9D278DB6F8845E9AFE797DD235DC576
  • python 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

このコマンドはテスト目的でのみ使用し、一般的な用途での使用は推奨しません。