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

Object Storage Service:部品の操作のコマンド

最終更新日:Dec 20, 2023

このトピックでは、部品の管理に使用できるコマンドについて説明します。

重要 osscmdは2019年7月31日以降利用できません。 Alibaba Cloudはosscmdを更新または維持しなくなりました。 osscmd操作コマンドはossutilに統合されています。

init

Command:

init oss:// bucket/object

アップロードイベントを初期化してアップロードIDを生成します。 このアップロードIDをmultiuploadコマンドに追加して、部品の操作を実行できます。

例:

python osscmd init oss:// mybucket/myobject

listpart

Command:

listpart oss:// bucket/object -- upload_id=xxx

指定したオブジェクトのアップロードIDを使用してアップロードされたパーツを一覧表示します。 関連する概念の詳細については、「OSS APIリファレンス」をご参照ください。 アップロードIDを指定する必要があります。

例:

python osscmd listpart oss:// mybucket/myobject -- upload_id=
          75835E389EA648C0B93571B6A46023F 3 

listparts

Command:

listparts oss:// bucket

バケットに対して完了していないマルチパートアップロードイベントのオブジェクトとアップロードIDを一覧表示します。 バケットを削除したいが、バケットが空ではないことを求めるプロンプトが表示された場合は、このコマンドを実行して、バケット内にフラグメントがあるかどうかを確認できます。

例:

python osscmdリストパーツoss:// mybucket

getallpartsize

Command:

getallpartsize oss:// bucket

既存のアップロードIDを使用してアップロードされたパーツの合計サイズを一覧表示します。

例:

python osscmd getallpartsize oss:// mybucket

cancel

Command:

cancel oss:// bucket/object -- upload_id=xxx

アップロードIDを使用するマルチパートアップロードイベントを終了します。

例:

python osscmd cancel oss:// mybucket/myobject -- upload_id=
          D9D278DB6F8845E9AFE797DD235DC576 

multiupload(multi_upload,mp)

Command:

multiupload(multi_upload,mp) localfile oss:// bucket/object -- check_md5=false
        -- thread_num=10 

マルチパートアップロードを使用して、ローカルファイルをOSSにアップロードします。

例:

  • python osscmdマルチアップロード /tmp/localfile.txt oss:// mybucket/object
  • python osscmd multiup_load /tmp/localfile.txt oss:// mybucket/object
  • python osscmd mp /tmp/localfile.txt oss:// mybucket/object

Command:

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パラメーターで定義されます。 このコマンドを実行すると、アップロードIDを使用するパーツのETagsのMD5値がローカルファイルのMD5値と同じかどうかが最初に判断されます。 値が同じ場合は、パーツがアップロードされます。 このアップロードイベントが開始される前にアップロードIDを生成します。 アップロードIDをコマンドに追加します。 アップロードが失敗した場合は、再開可能アップロードを使用するのと同じ方法で、同じマルチアップロードコマンドを実行してパーツをアップロードできます。 -- check_md5=falseは、Content-MD5がリクエストヘッダーに含まれておらず、MD5検証が実行されないことを示します。 -- check_md5=trueは、MD5検証が実行されることを示します。

例:

  • python osscmdマルチアップロード /tmp/localfile.txt oss:// mybucket/object -- upload_id=
              D9D278DB6F8845E9AFE797DD235DC576 
  • python osscmd multiup_load /tmp/localfile.txt oss:// mybucket/object
            -- thread_num=5 
  • python osscmd mp /tmp/localfile.txt oss:// mybucket/object -- max_part_num=100

copylargefile

Command:

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の値が100 KBより小さい場合、プログラムは自動的に部品サイズを調整します。

例:

python osscmd copylargefile oss:// source_bucket/source_object
          oss:// target_bucket/target_object -- part_size=10*1024*1024 

uploadpartfromfile (upff)

Command:

uploadpartfromfile (upff) localfile oss:// bucket/object -- upload_id=xxx
        -- part_number=xxx 

このコマンドはテストにのみ使用されます。

uploadpartfromstring(upfs)

Command:

uploadpartfromstring(upfs) oss:// bucket/object -- upload_id=xxx -- part_number=xxx
        -- data=xxx 

このコマンドはテストにのみ使用されます。