:オブジェクト操作コマンド

ls (list)

コマンド：

ls(list) 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 list oss://mybucket/ "" "" 100

コマンド：

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

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

コマンド：

mkdir oss://bucket/dirname

フォルダーを作成します。

例：

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 に設定すると、上書きされます。downloadtodir コマンドは、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

ローカルディレクトリからバケットにファイルをアップロードします。

たとえば、ローカルディレクトリ /tmp/ に a/b、a/c、および a が含まれている場合、ファイルは oss://bucket/a/b、oss://bucket/a/c、および oss://bucket/a にアップロードされます。プレフィックスを mytest に指定した場合、ファイルは oss://bucket/mytest/a/b、oss://bucket/mytest/a/c、および oss://bucket/mytest/a にアップロードされます。

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

注：チェックポイントファイルには、アップロードされたすべてのファイルに関する情報が記録されます。

例：

• 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 リクエストヘッダーは含まれず、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=plain/text

upload

コマンド：

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

ローカルファイルを Object group としてアップロードできます。この操作は推奨しません。--check_md5=false は、ファイルのアップロード時に Content-MD5 リクエストヘッダーの検証を無効にします。このパラメーターを true に設定すると、ヘッダーが検証されます。

例：

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

オブジェクトのメタデータを読み取り、出力します。メタデータには、Content-Type、ファイル長、およびカスタムメタデータが含まれます。

例：

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