ls コマンドは、バケット、オブジェクト、またはパートを一覧表示する場合に使用します。

コマンド構文

./ossutil ls [oss://bucket[/prefix]] [-s] [-d] [--limited-num num] [--marker marker] [--upload-id-marker umarker] [--payer requester] [-c file] [--include include-pattern] [--exclude exclude-pattern] [--payer requester]

  • バケットを一覧表示する
    ./ossutil ls
    CreationTime                                 Region    StorageClass    BucketName
    2016-10-2116:18:37 +0800 CST       oss-cn-hangzhou         Archive    oss://bucket1
    2016-12-0115:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://bucket2
    2016-07-2010:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://bucket3
    Bucket Number is:3
    0.252174(s) elapsed                        
    ./ossutil ls oss:// コマンドを使用して、バケットを一覧表示することもできます。
  • ページごとにバケットを一覧表示する
    ./ossutil ls oss:// --limited-num=${num} --marker=${bucketname}
    バケット数が多い場合、--limited-num--marker オプションを使用して、ページごとにバケットを一覧表示できます。
    • --limited-num は、各ページに表示されるエントリ数の制御に使用されます。
    • --marker には、一覧表示を開始するバケットを指定します。 marker 値が設定された後、表示される結果は、先頭のバケットからアルファベット順に返されます。 ほとんどの場合、このパラメーター値には、前のページに表示された最後のバケット名を設定します。
    次のコードは、各ページに先頭 2 つのバケットを一覧表示する方法の例を示しています。
    ./ossutil ls oss:// --limited-num=1 -s 
    oss://bucket1
    Bucket Number is:1
    0.303869(s) elapsed
    ./ossutil ls oss:// --limited-num=1 -s --marker=bucket1
    oss://bucket2
    Bucket Number is:1
    0.257636(s) elapsed
  • 特定のバケット内のすべてのオブジェクトを一覧表示する
    ./ossutil ls oss://bucket1
    LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
    2016-12-0115:06:37 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://bucket1/a1
    2016-12-0115:06:42 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://bucket1/a2
    2016-12-0115:06:45 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://bucket1/a3
    Object Number is:3
    0.007379(s) elapsed                 
  • すべてのオブジェクトをページごとに一覧表示する
    ./ossutil ls oss://bucket --limited-num=${num} --marker=${obj}
    ページごとにバケットを一覧表示する操作と同様に、--limited-num オプションと --marker オプションを使用して、ページごとにオブジェクトを一覧表示できます。 次のコードは、ルートディレクトリ bucket1 の先頭 2 つのオブジェクトを一覧表示する方法の例を示しています。
    ./ossutil ls oss://bucket1 --limited-num=1
    LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
    2016-12-0115:06:37 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://bucket1/a1
    Object Number is:1
    0.007379(s) elapsed
    $./ossutil ls oss://bucket1 --limited-num=1 --marker=a1
    LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
    2016-12-0115:06:42 +0800 CST      10363812      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://bucket1/a2
    Object Number is:1
    0.008392(s) elapsed
    						
  • 特定の条件を満たすオブジェクトを一覧表示する
    --include/--exclude を設定して、特定の条件を満たすオブジェクトを一覧表示できます。 --include/--exclude の詳細は、「cp」をご参照ください。
    • 形式が jpg 以外のすべてのオブジェクトを一覧表示する
      ./ossutil ls oss://my-bucket/path  --exclude "*.jpg" -r
    • 名前に abc を含み、形式が jpg または txt 以外のすべてのオブジェクトを一覧表示する
      ./ossutil ls oss://my-bucket1/path  --include "*abc*" --exclude "*.jpg" --exclude "*.txt" -r
  • アップロード ID を一覧表示する
    -m オプションを ls コマンドに追加して、特定のプレフィックスで始まるオブジェクトに対する未完了のマルチパートアップロードタスクのアップロード ID を一覧表示します。
    ./ossutil ls oss://bucket1/obj1 -m
    InitiatedTime                     UploadID                               ObjectName
    2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://bucket1/obj1
    2017-01-13 03:43:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://bucket1/obj1
    UploadId Number is: 2
    0.070070(s) elapsed
  • すべてのオブジェクトと未完了のマルチパートアップロードタスクを一覧表示する
    -a オプションを ls コマンドに追加して、特定のプレフィックスで始まるオブジェクトに対する未完了のマルチパートアップロードタスクのアップロード ID と、このプレフィックスで始まるアップロード済みのオブジェクトを一覧表示します。
    ./ossutil ls oss://bucket1 -a 
    LastModifiedTime                    Size(B)  StorageClass   ETAG                                    ObjectName
    2015-06-0514:06:29 +0000 CST        201933      Standard   7E2F4A7F1AC9D2F0996E8332D5EA5B41        oss://bucket1/dir1/obj11
    2015-06-0514:36:21 +0000 CST        201933      Standard   6185CA2E8EB8510A61B3A845EAFE4174        oss://bucket1/obj1
    2016-04-0814:50:47 +0000 CST       6476984      Standard   4F16FDAE7AC404CEC8B727FCC67779D6        oss://bucket1/sample.txt
    Object Number is:3
    InitiatedTime                     UploadID                           ObjectName
    2017-01-1303:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://bucket1/obj1
    2017-01-1303:43:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://bucket1/obj1
    2017-01-1303:45:25 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://bucket1/obj2
    2017-01-2011:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://bucket1/tobj
    UploadId Number is:4
    0.191289(s) elapsed                           
  • 一覧表示の結果を短い形式で表示する
    ./ossutil ls oss://bucket1 -s
    oss://bucket1/a1
    oss://bucket1/a2
    oss://bucket1/a3
    Object Number is:3
    0.007379(s) elapsed  
  • バケットをディレクトリ形式で一覧表示する

    -d オプションを使用して、すべてのサブディレクトリ内のすべてのオブジェクトを再帰的に表示するのではなく、現在のディレクトリ内のオブジェクトとサブディレクトリを一覧表示します。 例:

    ./ossutil ls oss://bucket1 -s -d
    oss://bucket1/obj1
    oss://bucket1/sample.txt
    oss://bucket1/dir1/
    Object and Directory Number is:3 
    0.119884(s) elapsed                   
  • 現在のディレクトリ内で、特定のプレフィックスで始まるオブジェクトまたはサブディレクトリを一覧表示する
    ./ossutil ls oss://bucket1/test -d
    oss://bucket1/test.jpg
    oss://bucket1/test/
    Object and Directory Number is: 2
  • pay-by-requester モードでバケットを一覧表示する
    ./ossutil ls oss://bucket --payer=requester
  • バージョン管理が有効になっているバケット内の全オブジェクトの特定バージョンを一覧表示する
    ./ossutil ls oss://bucket1 --all-versions
    LastModifiedTime                   Size(B)  StorageClass  ETAG                                  VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
    2019-06-11 10:54:51 +0800 CST            0                                                      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        true           oss://bucket1/test1.jpg
    2019-06-11 11:03:37 +0800 CST            0                                                      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        true           oss://bucket1/test.jpg
    2019-06-11 10:53:46 +0800 CST       118076      Standard  FFDB300F053AAF06F4C4C58A4869C427      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false          oss://bucket1/test1.jpg
    2019-06-11 11:02:05 +0800 CST       345374      Standard  078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false          oss://bucket1/test.jpg
    Object Number is: 4
    
    0.692000(s) elapsed
  • バージョン管理が有効になっているバケット内の特定のオブジェクトの全バージョンを一覧表示する
    ./ossutil ls oss://bucket1/test.jpg --all-versions
    LastModifiedTime                   Size(B)  StorageClass  ETAG                                  VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
    2019-06-11 11:03:37 +0800 CST            0                                                      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        true           oss://bucket1/test.jpg
    2019-06-11 11:02:05 +0800 CST       345374      Standard  078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false          oss://bucket1/test.jpg
    Object Number is: 2
    
    0.361000(s) elapsed

一般的なオプション

次の表に、一覧表示する項目と一覧表示の方法を指定するために ls コマンドに追加できるオプションを示します。
オプション 説明
-s 項目を短い形式で一覧表示します。
-d すべてのサブディレクトリ内のすべてのオブジェクトを再帰的に表示するのではなく、現在のディレクトリ内のオブジェクトとサブディレクトリを一覧表示します。
-m バケット内の未完了のマルチパートアップロードタスクのみを一覧表示します。 オブジェクトは表示されません。
-a バケット内のオブジェクトと未完了のマルチパートアップロードタスクの両方を一覧表示します。
--limited-num 返される結果の最大数を指定します。 ページごとにオブジェクトを一覧表示するには、このオプションを --marker オプションと一緒に使用します。
--marker 一覧表示を開始するバケット名、オブジェクト名、またはマルチパートアップロード ID を指定します。
--upload-id-marker 一覧表示を開始するマルチパートアップロード ID を指定します。
--payer リクエストの支払者を指定します。 pay-by-requester モードを有効にするには、このオプションを requester に設定します。
--encoding-type オブジェクト名のエンコードタイプを指定します。 このオプションを指定する場合、値は url でなければなりません。 このオプションが指定されていない場合、オブジェクト名はエンコードされません。 バケット名は URL エンコードできません。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--include *.jpg など、特定の文字列に一致するオブジェクトを含めます。
--exclude *.txt など、特定の文字列に一致するオブジェクトを除外します。
--all-versions 特定のオブジェクトの全バージョンを一覧表示します。 このオプションは、バージョン管理が有効になっているバケット内のオブジェクトにのみ使用できます。
--version-id-marker 一覧表示を開始するオブジェクトバージョンを指定します。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79. **.**:3128、socks5://120.79. **. **:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。