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

Object Storage Service:オブジェクトに対する操作のコマンド

最終更新日:Dec 20, 2023

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

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

ls(list)

Command:

ls (リスト) oss:// bucket/[prefix] [marker] [delimiter] [maxkeys]

バケット内のオブジェクトを一覧表示します。 プレフィックスを指定して、名前が指定されたプレフィックスで始まるすべてのオブジェクトを一覧表示できます。 たとえば、名前がabcで始まるすべてのオブジェクトを一覧表示するプレフィックスとしてabcを指定できます。

例:

  • python osscmd ls oss:// mybucket/folder1/folder2
  • python osscmd ls oss:// mybucket/folder1/folder2 marker1
  • python osscmd ls oss:// mybucket/folder1/folder2 marker1 /
  • python osscmd ls oss:// mybucket/
  • python osscmdリストoss:// mybucket/ "" "" 100

Command:

ls (リスト) oss:// bucket/[prefix] -- marker=xxx -- delimiter=xxx -- maxkeys=xxx
        -- encoding_type=url 

バケット内のオブジェクトを一覧表示します。 encoding_typeを設定して、送信時に使用するエンコード方法を指定できます。 encoding_typeをurlに設定すると、名前にコントロール文字が含まれるオブジェクトがエンコードされます。

例:

  • python osscmd ls oss:// mybucket/folder1/folder2 -- delimiter=/
  • python osscmd ls oss:// mybucket/folder1/folder2 -- marker=a
  • python osscmd ls oss:// mybucket/folder1/folder2 -- maxkeys=10

mkdir

Command:

mkdir oss:// bucket/dirname

フォルダを作成します。

例:

python osscmd mkdir oss:// mybucket /フォルダー

listallobject

Command:

listallobject oss:// bucket/[prefix]

バケット内のすべてのオブジェクトを一覧表示します。 プレフィックスを指定して、名前がプレフィックスで始まるオブジェクトを一覧表示できます。

例:

  • python osscmd listallobject oss:// mybucket
  • python osscmd listallobject oss:// mybucket/testfolder/

deleteallobject

Command:

deleteallobject oss:// bucket/[prefix]

バケット内のすべてのオブジェクトを削除します。 プレフィックスを指定して、名前がプレフィックスで始まるオブジェクトを削除することもできます。

例:

  • python osscmd deleteallobject oss:// mybucket
  • python osscmd deleteallobject oss:// mybucket/testfolder/

downloadallobject

Command:

downloadallobject oss:// bucket/[prefix] localdir -- replace=false
      -- thread_num=5 

バケットからローカルディレクトリにオブジェクトをダウンロードします。 この操作は、元のディレクトリ構造が同じままであることを保証する。 プレフィックスを指定して、名前が指定されたプレフィックスで始まるオブジェクトをダウンロードできます。 -- replace=falseは、オブジェクトと同じ名前のローカルファイルがダウンロード中に上書きされないことを示します。 -- replace=trueは、オブジェクトと同じ名前のローカルファイルが上書きされることを示します。 thread_numを使用してダウンロードスレッドを設定することもできます。

例:

  • python osscmd downloadallobject oss:// mybucket /tmp /フォルダー
  • python osscmd downloadallobject oss:// mybucket /tmp /フォルダー
            -- replace=false 
  • python osscmd downloadallobject oss:// mybucket /tmp/folder -- replace=true
              -- thread_num=5 

downloadtodir

Command:

downloadtodir oss:// bucket/[prefix] localdir -- replace=false

バケットからローカルディレクトリにオブジェクトをダウンロードします。 この操作は、元のディレクトリ構造が同じままであることを保証する。 プレフィックスを指定して、名前が指定されたプレフィックスで始まるオブジェクトをダウンロードできます。 -- replace=falseは、オブジェクトと同じ名前のローカルファイルがダウンロード中に上書きされないことを示します。 -- replace=trueは、オブジェクトと同じ名前のローカルファイルが上書きされることを示します。 downloadtodirは、downloadallobjectと同じロジックに従います。

例:

  • python osscmd downloadtodir oss:// mybucket /tmp /フォルダー
  • python osscmd downloadtodir oss:// mybucket /tmp/folder -- replace=false
  • python osscmd downloadtodir oss:// mybucket /tmp /フォルダー
          -- replace=true 

uploadfromdir

Command:

uploadfromdir localdir oss:// bucket/[prefix] -- check_point=check_point_file -- replace=false
        -- check_md5=false -- thread_num=5 

ローカルファイルをバケットにアップロードします。

ローカルディレクトリ /tmp/ にa/b、a/c、およびaファイルが含まれている場合、OSS内のこれらのファイルのパスはoss:// bucket/a/b、oss:// bucket/a/c、oss:// bucket/aです。 プレフィックスがmytestに設定されている場合、OSS内のこれらのファイルのパスは、oss:// bucket/mytest/a/b、oss:// bucket/mytest/a/c、oss:// bucket/mytest/aです。

-- check_point=check_point_fileは、チェックポイントファイルを指定するために使用されます。 チェックポイントファイルを指定すると、osscmdツールを使用して、ローカルファイルのアップロード時に記録されるタイムスタンプが保存されます。 uploadfromdirコマンドは、アップロードされているファイルのタイムスタンプとチェックポイントファイルに記録されているタイムスタンプを比較するために使用されます。 タイムスタンプが異なる場合、ファイルは再アップロードされます。 check_point_fileはデフォルトで指定されていません。 -- replace=falseは、オブジェクトと同じ名前のローカルファイルがアップロード中に上書きされないことを示します。 -- replace=trueは、オブジェクトと同じ名前のローカルファイルが上書きされることを示します。 -- check_md5=falseは、Content-MD5がリクエストヘッダーに含まれておらず、MD5検証が実行されないことを示します。 -- check_md5=trueは、MD5検証が実行されることを示します。

注: チェックポイントファイルには、すべてのオブジェクトのアップロードレコードが保存されます。

例:

  • python osscmd uploadfromdir /mytemp /フォルダoss:// mybucket
  • python osscmd uploadfromdir /mytemp /フォルダoss:// mybucket
              -- check_point_file=/tmp/mytemp_record.txt 
  • python osscmd uploadfromdir C:\ドキュメントと設定 \ユーザー \マイドキュメント \ダウンロード
              oss:// mybucket -- check_point_file=C:\cp.txt 

put

Command:

put localfile oss:// bucket/object -- content-type=[content_type]
        -- headers="key1:value1#key2:value2" -- check_md5=false 

ローカルファイルをバケットにアップロードするときに、content-typeなどのHTTPヘッダーフィールドを設定できます。 -- check_md5=falseは、Content-MD5がリクエストヘッダーに含まれておらず、MD5検証が実行されないことを示します。 -- check_md5=trueは、MD5検証が実行されることを示します。

例:

  • python osscmd put myfile.txt oss:// mybucket
  • python osscmd put myfile.txt oss:// mybucket/myobject.txt
  • python osscmd put myfile.txt oss:// mybucket/test.txt -- content-type=plain/text
              -- headers=“x-oss-meta-des:test#x-oss-meta-location:CN” 
  • python osscmd put myfile.txt oss:// mybucket/test.txt
            -- content-type=プレーン /テキスト 

アップロード

Command:

localfile oss:// bucket/object -- content-type=[content_type]
      -- check_md5=false 

ローカルファイルをバケットにアップロードします。 -- check_md5=falseは、Content-MD5がリクエストヘッダーに含まれておらず、MD5検証が実行されないことを示します。 -- check_md5=trueは、MD5検証が実行されることを示します。

例:

python osscmdアップロードmyfile.txt oss:// mybucket/test.txt
        -- content-type=プレーン /テキスト 

get

Command:

get oss:// bucket/object localfile

オブジェクトをローカルファイルにダウンロードします。

例:

python osscmd get oss:// mybucket/myobject /tmp/localfile

multiget(multi_get)

Command:

multiget(multi_get) oss:// bucket/object localfile -- thread_num=5

マルチスレッドを使用して、オブジェクトをローカルファイルにダウンロードします。 オブジェクトのダウンロードに使用されるスレッドの数を設定できます。

例:

  • python osscmd multiget oss:// mybucket/myobject /tmp/localfile
  • python osscmd multi_get oss:// mybucket/myobject /tmp/localfile

ネコ

Command:

cat oss:// bucket/object

オブジェクトコンテンツを読み取り、表示します。 オブジェクトが大きい場合は、このコマンドを実行しないでください。

例:

python osscmd cat oss:// mybucket/myobject

meta

Command:

meta oss:// bucket/object

オブジェクトのメタ情報を読み取り、表示します。 メタ情報は、コンテンツタイプ、ファイル長、およびユーザメタデータを含む。

例:

python osscmdメタoss:// mybucket/myobject

copy

Command:

copy oss:// source_bucket/source_object oss:// target_bucket/target_object
        -- headers="key1:value1#key2:value2" 

オブジェクトをソースバケットから宛先バケットにレプリケートします。

例:

python osscmdコピーoss:// bucket1/object1 oss:// bucket2/object2

rm(delete,del)

Command:

rm(delete,del) oss:// bucket/object -- encoding_type=url

オブジェクトの削除 encoding-typeがurlに設定されている場合、削除する制御文字もURLエンコードする必要があります。

例:

  • python osscmd rm oss:// mybucket/myobject
  • python osscmd削除oss:// mybucket/myobject
  • python osscmd del oss:// mybucket/myobject
  • python osscmd del oss:// mybucket/my % 01オブジェクト -- encoding_type=url

signurl(sign)

Command:

signurl(sign) oss:// bucket/object -- timeout=[timeout_seconds]

タイムアウト値を含む署名付きURLを生成します。 署名付きURLは、バケットACLがプライベートの場合に特定のオブジェクトへのアクセスを提供するために使用されます。

例:

  • python osscmd sign oss:// mybucket/myobject
  • python osscmd signurl oss:// mybucket/myobject