Object Storage Service:lsコマンドを実行して、アカウント内のバケット、オブジェクト、パーツを一覧表示します。

使用上の注意

• バケットを一覧表示するには、oss:ListBuckets権限が必要です。 オブジェクトを一覧表示するには、oss:ListObjects権限が必要です。 オブジェクトのすべてのバージョンを一覧表示するには、oss:ListObjectVersions権限が必要です。 すべての部品を一覧表示するには、oss:ListPartsおよびoss:ListMultipartUploads権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

• ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。

バケットの一覧表示

• コマンド構文

  ossutil ls [-s] [--limited-num] [--marker] 

  次の表に、構文のパラメーターを示します。

  パラメーター	説明
  -s	バケット名のみを一覧表示するように指定します。
  -- 限られたnum	返される結果の最大数。 このパラメーターをmarkerパラメーターと一緒に指定すると、返された結果をページごとに表示できます。
  -- マーカー	リスト操作の開始位置。 マーカーの後に名前がアルファベット順になっているバケットがリストされます。

• 例

  • 現在のAlibaba Cloudアカウントのすべてのバケットを一覧表示します。

    ossutil ls

    次のコマンドを実行して、現在のAlibaba Cloudアカウントのすべてのバケットを一覧表示することもできます。

    ossutil ls oss://

    次の出力は、現在のAlibaba Cloudアカウントのすべてのバケットがリストされていることを示しています。 リストされている情報には、バケット名、作成時刻、リージョン、ストレージクラス、およびバケット数が含まれます。

    2016-10-21 16:18:37 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketA
    2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
    2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
    2016-10-21 17:31:27 +0800 CST       oss-cn-hangzhou         Archive    oss://examplebucketD
    Bucket Number is:4
    0.252174(s) elapsed  

  • 現在のAlibaba Cloudアカウントのすべてのバケットをシンプルモードで一覧表示します。

    ossutil ls -s

    次の出力は、現在のAlibaba Cloudアカウントのすべてのバケットがリストされていることを示しています。 リストされている情報には、バケット名とバケット数のみが含まれます。

    oss://examplebucketA
    oss://examplebucketB
    oss://examplebucketC
    oss://examplebucketD
    Bucket Number is:4
    0.235104(s) elapsed  

  • examplebucketAマーカーの後に名前がアルファベット順になっているバケットをリストします。

    ossutil ls oss:// --limited-num=2 -s --marker examplebucketA

    次の出力は、名前がexamplebucketAの後のアルファベット順の2つのバケットがリストされていることを示します。

    2016-12-01 15:06:21 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucketB
    2016-07-20 10:36:24 +0800 CST       oss-cn-hangzhou              IA    oss://examplebucketC
    Bucket Number is:2
    0.132174(s) elapsed                        

オブジェクトの一覧表示

• コマンド構文

  ossutil ls oss://bucketname[/prefix] [-s] [-d] [--limited-num] [--marker] [--include] [--exclude]  [--version-id-marker] [--all-versions]

  次の表に、構文のパラメーターを示します。

  パラメーター	説明
  bucketname	バケットの名前です。
  プレフィックス	一覧表示するオブジェクトの名前のプレフィックス。 指定したプレフィックスを名前に含むオブジェクトを一覧表示する場合は、このパラメーターを指定します。
  -s	オブジェクト名のみを一覧表示するように指定します。
  -d	バケットのルートディレクトリにあるオブジェクトとサブディレクトリのみを一覧表示するように指定します。 サブディレクトリ内のオブジェクトはリストされません。
  -- 限られたnum	返される結果の最大数。 このパラメーターをmarkerパラメーターと一緒に指定すると、返された結果をページごとに表示できます。
  -- マーカー	リスト操作の開始位置。 名前がマーカーの後にアルファベット順であるオブジェクトがリストされます。
  -含める	指定された条件を満たすすべてのオブジェクトを含みます。 詳細については、「-含めると-除外」をご参照ください。
  -除外	指定された条件を満たすすべてのオブジェクトを除外します。 詳細については、「-含めると-除外」をご参照ください。
  -- version-id-marker	リスト操作を開始するオブジェクトのバージョンを指定します。 このパラメーターは、バケットのバージョン管理が有効になっている場合にのみ指定できます。
  -すべてのバージョン	バケット内のオブジェクトのすべてのバージョンが一覧表示されるように指定します。 このパラメーターは、バケットのバージョン管理が有効になっている場合にのみ指定できます。

• 例

  • examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示します。

    ossutil ls oss:// examplebucket

    次の出力は、examplebucketバケット内のすべてのオブジェクトが一覧表示されていることを示します。 リストされた情報には、最後に変更された時刻、サイズ、ETag値、およびオブジェクトの名前が含まれます。

    オブジェクトのETag値は、オブジェクトのコンテンツを識別するために使用されます。 PutObject操作を呼び出してオブジェクトを作成した場合、オブジェクトのETagはオブジェクトコンテンツのMD5ハッシュになります。 オブジェクトが他のメソッドを使用して作成された場合、オブジェクトのETagはオブジェクトコンテンツのMD5ハッシュではなく、組み込みルールに基づいて計算された一意の値です。

    LastModifiedTime                    Size(B)  StorageClass   ETag                                    ObjectName
    2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
    2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
    2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
    Object Number is:3
    0.007379(s) elapsed                 

  • examplebucketという名前のバケット内のプレフィックス例を名前に含むオブジェクトを一覧表示します。

    ossutil ls oss://examplebucket/example

    次の出力は、examplebucketバケット内のサンプルプレフィックスを名前に含むすべてのオブジェクトが一覧表示されていることを示します。

    LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
    2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
    2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
    Object Number is:2
    0.007379(s) elapsed                 

  • を含むオブジェクトを一覧表示します。examplebucketという名前のバケット内のmp4拡張:

    ossutil ls oss://examplebucket --include *.mp4

    次の出力は、名前に含まれるオブジェクトを示します。examplebucketバケットのmp4拡張子が一覧表示されます。

    LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
    2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
    Object Number is:1
    0.007379(s) elapsed                 

  • examplebucketという名前のバケットのルートディレクトリにあるオブジェクトとサブディレクトリのみを一覧表示します。

    ossutil ls oss://examplebucket -d

    次の出力は、examplebucketバケットのルートディレクトリにあるオブジェクトとサブディレクトリが一覧表示されていることを示します。

    oss://examplebucket/example.txt
    oss://examplebucket/examplefolder/
    oss://examplebucket/video.mp4
    Object and Directory Number is: 3
    
    0.278489(s) elapsed

  • examplebucketという名前のバケット内のすべてのオブジェクトのすべてのバージョンを一覧表示します。

    ossutil ls oss://examplebucket --all-versions

    次の出力は、examplebucketバケット内のすべてのオブジェクトのすべてのバージョンが一覧表示されていることを示します。

    LastModifiedTime                   Size(B)  StorageClass   ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER   ObjectName
    2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
    2020-06-11 11:03:37 +0800 CST      363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        false           oss://examplebucket/examplefolder/photo.jpg
    2021-01-26 13:27:08 +0800 CST           0                                                       CAEQLxiBgIDd7NH0uRciIDA3Yzg0MTZjOWNlYzQ4ODZhMzVkZWE0MmE2NzBlYTYx    true        true            oss://examplebucket/image.png
    2020-12-01 15:06:45 +0800 CST    57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544      CAEQLBiBgMDZiprwthciIDY2NGM0NTNmZDE3ODRmZmVhZGM4YTUwZGQyNGU3ZjQ3    true        false           oss://examplebucket/video.mp4
    2016-06-11 10:53:46 +0800 CST      118076      Standard   FFDB300F053AAF06F4C4C58A4869C427      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
    2016-06-11 11:02:05 +0800 CST      345374      Standard   078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false           oss://examplebucket/examplefolder/photo.jpg
    Object Number is: 6
    
    0.692000(s) elapsed

  • examplebucketという名前のバケットのルートディレクトリに、example.txtという名前のオブジェクトのすべてのバージョンを一覧表示します。

    ossutil ls oss://examplebucket/example.txt --all-versions

    次の出力は、example.txtオブジェクトのすべてのバージョンが一覧表示されていることを示します。

    LastModifiedTime                   Size(B)  StorageClass  ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
    2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
    2016-06-11 10:53:46 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
    Object Number is: 2
    
    0.361000(s) elapsed

部品のリスト

• コマンド構文

  ossutil ls oss://bucketname[/prefix] [-s] [-d] [-m] [-a] [--limited-num] [--upload-id-marker] 

  次の表に、構文のパラメーターを示します。

  パラメーター	説明
  bucketname	バケットの名前です。 特定のバケット内のリソースを一覧表示する場合は、このパラメーターを指定します。
  プレフィックス	名前に特定のプレフィックスが含まれる部品を一覧表示するように指定します。
  -s	コマンドがアップロードIDとオブジェクト名のみを返すように指定します。
  -d	バケットのルートディレクトリにあるオブジェクトとサブディレクトリのみを一覧表示するように指定します。 サブディレクトリ内のオブジェクトはリストされません。
  -m	コマンドが部品を一覧表示することを指定します。
  -a	コマンドがオブジェクトとパーツを一覧表示することを指定します。
  -- 限られたnum	返される結果の最大数。 このパラメーターを -- upload-id-markerパラメーターと一緒に指定すると、返された結果をページごとに表示できます。
  -- upload-id-marker	リスト操作の開始位置。 アップロードIDがマーカーの後にアルファベット順である部品が一覧表示されます。

• 例

  • examplebucketという名前のバケット内のすべての部品を一覧表示します。

    ossutil ls oss://examplebucket -m

    次の出力は、examplebucketバケット内のすべての部品が一覧表示されていることを示します。

    InitiatedTime                     UploadID                           ObjectName
    2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
    2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
    2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
    2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
    UploadId Number is:4
    0.191289(s) elapsed  

  • examplebucketという名前のバケット内のすべてのオブジェクトとパーツを一覧表示します。

    ossutil ls oss://examplebucket -a

    次の出力は、examplebucketバケット内のすべてのオブジェクトとパーツが一覧表示されていることを示します。

    LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
    2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
    2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
    2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
    Object Number is:3
    InitiatedTime                     UploadID                           ObjectName
    2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
    2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
    2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
    2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
    UploadId Number is:4
    0.791289(s) elapsed  

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、-eオプションを追加して、バケットが配置されているリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、-iオプションを追加して指定されたアカウントのAccessKey IDを指定し、-kオプションを追加して指定されたアカウントのAccessKey secretを指定します。

ossutil ls oss://test -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

共通オプションの詳細については、「共通オプション」をご参照ください。