ls(list)

コマンドの説明:

ls(list) oss://bucket/[prefix] [marker] [delimiter] [maxkeys]

バケット内のオブジェクトを一覧表示します。

例:

  • 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 list oss://mybucket/ "" "" 100

コマンドの説明:

ls(list) oss://bucket/[prefix] --marker=xxx --delimiter=xxx --maxkeys=xxx

バケット内のオブジェクトを一覧表示します。 name_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

コマンドの説明:

mkdir oss://bucket/dirname

“/“ で終わる、サイズが 0 のオブジェクトを作成します。

例:

  • python osscmd mkdir oss://mybucket/folder

listallobject

コマンドの説明:

listallobject oss://bucket/[prefix]

バケット内のすべてのオブジェクトを表示し、プレフィックスを指定します。

例:

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

deleteallobject

コマンドの説明:

deleteallobject oss://bucket/[prefix]

バケット内のすべてのオブジェクトを削除し、プレフィックスを指定します。

例:

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

downloadallobject

コマンドの説明:

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

ディレクトリ構造を変更せずに、バケット内のオブジェクトをローカルディレクトリにダウンロードします。 プレフィックスを指定してダウンロードすることができます。—replace = false は、同じ名前のローカルファイルがすでに存在する場合、ダウンロード中に置き換えられないことを示します。 —replace = true とすると、同じ名前のローカルファイルは置き換え可能であることを示します。 thread_num を使用してダウンロードスレッドを設定することもできます。

例:

  • python osscmd downloadallobject oss://mybucket /tmp/folder
  • python osscmd downloadallobject oss://mybucket /tmp/folder –-replace=false
  • python osscmd downloadallobject oss://mybucket /tmp/folder –-replace=true --thread_num=5

downloadtodir

コマンドの説明:

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

ディレクトリ構造を変更せずに、バケット内のオブジェクトをローカルディレクトリにダウンロードします。 プレフィックスを指定してダウンロードすることができます。—replace = false は、同じ名前のローカルファイルがすでに存在する場合、ダウンロード中に置き換えられないことを示します。 —replace = true とすると、同じ名前のローカルファイルは置き換え可能であることを示します。 このコマンドの実行は、downloadallobject と同じ効果が得られます。

例:

  • python osscmd downloadtodir oss://mybucket /tmp/folder
  • python osscmd downloadtodir oss://mybucket /tmp/folder –-replace=false
  • python osscmd downloadtodir oss://mybucket /tmp/folder –-replace=true

uploadfromdir

コマンドの説明:

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

ローカルファイルをバケットにアップロードします。 たとえば、localdirは /tmp/ です。

次の 3 つのファイル a/b、a/c、および a がある場合、これらを OSS にアップロードすると、それぞれ oss://bucket/a/b、oss://bucket/a/c、および oss://bucket/a となります。 prefix を mytest として指定した場合、OSS にアップロードしたファイルは oss://bucket/mytest/a/b、oss://bucket/mytest/a/c、および oss://bucket/mytest/a となります。

--check_point=check_point_file は指定されたファイルです。 ファイルが指定された後、osscmd はアップロードされたローカルファイルをタイムスタンプとして check_point_file に格納されます。uploadfromdir コマンドはアップロードされるファイルのタイムスタンプと、check_point_file に記録されたファイルのタイムスタンプとを比較します。 各ファイルに変更があると、各ファイルは再アップロードされます。 それ以外の場合、ファイルはスキップされます。 check_point_file は既定では存在しません。 --replace=false は、同じ名前のローカルファイルがすでに存在する場合、ダウンロード中に置き換えられないことを示します。—replace = true は、同じ名前のローカルファイルが置き換え可能であることを示します。 --check_md5=false は、ファイルがアップロードされているときに、Content-MD5 要求ヘッダーの検証が行われないことを示します。 true は、Content-MD5 リクエストヘッダーの検証が行われることを示します。

注 check_point_file 内のログには、アップロードされたすべてのファイルのログが記録されます。 アップロードするファイルが多すぎると、check_point_file のサイズは相当に大きくなります。

例:

  • python osscmd uploadfromdir /mytemp/folder oss://mybucket
  • python osscmd uploadfromdir /mytemp/folder oss://mybucket --check_point_file=/tmp/mytemp_record.txt
  • python osscmd uploadfromdir C:\Documents and Settings\User\My Documents\Downloads oss://mybucket --check_point_file=C:\cp.txt

put

コマンドの説明:

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

ローカルファイルをバケットにアップロードするときは、オブジェクトの content-type を指定するか、またはカスタマイズしたヘッダーを指定します。 --check_md5=false は、ファイルがアップロードされているときに、Content-MD5 要求ヘッダーの検証が行われないことを示します。 true は、Content-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=plain/text

Upload

コマンドの説明:

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

ローカルファイルをオブジェクトグループにアップロードします。 推奨されていません。 --check_md5=false は、ファイルがアップロードされているときに、Content-MD5 要求ヘッダーの検証が行われないことを示します。 true は、Content-MD5 リクエストヘッダーの検証が行われることを示します。

例:

  • python osscmd upload myfile.txt oss://mybucket/test.txt --content-type=plain/text

get

コマンド説明:

get oss://bucket/object localfile

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

例:

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

multiget(multi_get)

コマンドの説明:

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

cat

コマンドの説明

cat oss://bucket/object

オブジェクトのメタ情報を読み取り、それを出力します。 オブジェクトのサイズが大きい場合は使用しないでください。

例:

  • python osscmd cat oss://mybucket/myobject

meta

コマンドの説明:

meta oss://bucket/object

オブジェクトのメタ情報を読み取り、それを出力します。 メタ情報には、コンテンツタイプ、ファイル長、カスタムメタなどが含まれます。

例:

  • python osscmd meta oss://mybucket/myobject

copy

コマンドの説明:

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

ソースバケットのソースオブジェクトを宛先バケットの宛先オブジェクトにコピーします。

例:

  • python osscmd copy oss://bucket1/object1 oss://bucket2/object2

rm(delete,del)

コマンドの説明:

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

オブジェクトを削除します。 encoding-type がURL エンコードの場合、削除する文字列も URL エンコードである必要があります。

例:

  • python osscmd rm oss://mybucket/myobject
  • python osscmd delete oss://mybucket/myobject
  • python osscmd del oss://mybucket/myobject
  • python osscmd del oss://mybucket/my%01object --encoding_type=url

signurl(sign)

コマンドの説明

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

署名を含む URL を生成し、タイムアウト値を指定します。 このコマンドは、プライベートバケット内の指定されたオブジェクトに他のユーザーがアクセスできる場合、実行することができます。

例:

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