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

使用上の注意

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

• このトピックでは、64ビットLinuxシステムに基づくサンプルコマンドラインを提供します。 他のシステムのために、取り替えて下さい./ossutil64対応するバイナリ名を持つコマンドで 詳細は、「ossutilコマンドリファレンス」をご参照ください。

バケットの一覧表示

• コマンド構文

  ./ossutil64 ls [-s] [-- limited-num] [-- marker]

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

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

• 例

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

    ./ossutil64 ls

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

    ./ossutil64 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標準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
    バケット番号は: 4
    0.252174経過 

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

    ./ossutil64 ls -s

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

    oss:// examplebucketA
    oss:// examplebucketB
    oss:// examplebucketC
    oss:// examplebucketD
    バケット番号は: 4
    0.235104経過 

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

    ./ossutil64 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
    バケット番号は: 2
    0.132174経過 

オブジェクトの一覧表示

• コマンド構文

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

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

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

• 例

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

    ./ossutil64 ls oss:// examplebucket

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

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

    LastModifiedTimeサイズ (B) StorageClass ETag ObjectName
    2020-12-01 15:06:37 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB oss:// examplebucket/example.txt
    2020-12-01 15:06:42 0800 CST 363812標準E7581E5D2EBC56ECCB6FB6050B4C6545 oss:// examplebucket/examplefolder/photo.jpg
    2020-12-01 15:06:45 0800 CST 57374182標準BE97B7AD7A2C1277B11221E5C9537544 oss:// examplebucket/video.mp4
    オブジェクト番号は: 3
    0.007379経過 

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

    ./ossutil64 ls oss:// examplebucket/example

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

    LastModifiedTimeサイズ (B) StorageClass ETag ObjectName
    2020-12-01 15:06:37 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB oss:// examplebucket/example.txt
    2020-12-01 15:06:42 0800 CST 363812標準E7581E5D2EBC56ECCB6FB6050B4C6545 oss:// examplebucket/examplefolder/photo.jpg
    オブジェクト番号: 2
    0.007379経過 

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

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

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

    LastModifiedTimeサイズ (B) StorageClass ETag ObjectName
    2020-12-01 15:06:45 0800 CST 57374182標準BE97B7AD7A2C1277B11221E5C9537544 oss:// examplebucket/video.mp4
    オブジェクト番号: 1
    0.007379経過 

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

    ./ossutil64 ls oss:// examplebucket -d

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

    oss:// examplebucket/example.txt
    oss:// examplebucket/examplefolder /
    oss:// examplebucket/video.mp4
    オブジェクトとディレクトリの番号: 3
    
    0.278489経過 

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

    ./ossutil64 ls oss:// examplebucket -- すべてのバージョン

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

    LastModifiedTimeサイズ (B) StorageClass ETag VERSIONID IS-LATEST DELETE-MARKER ObjectName
    2020-12-01 15:06:37 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB true false oss:// examplebucket/example.txt
    2020-06-11 11:03:37 0800 CST 363812標準E7581E5D2EBC56ECCB6FB6050B4C6545 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標準BE97B7AD7A2C1277B11221E5C9537544 true false oss:// examplebucket/video.mp4
    2016-06-11 10:53:46 0800 CST 118076標準FFDB300F053AAF06F4C4C58A4869C427 CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk false oss:// examplebucket/example.txt
    2016-06-11 11:02:05 0800 CST 345374標準078A9852BCF81DC4811E6EDCBFD121BE CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw false oss:// examplebucket/examplefolder/photo.jpg
    オブジェクト番号は: 6
    
    0.692000経過 

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

    ./ossutil64 ls oss:// examplebucket/example.txt -- すべてのバージョン

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

    LastModifiedTimeサイズ (B) StorageClass ETag VERSIONID IS-LATEST DELETE-MARKER ObjectName
    2020-12-01 15:06:37 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB true false oss:// examplebucket/example.txt
    2016-06-11 10:53:46 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk false oss:// examplebucket/example.txt
    オブジェクト番号: 2
    
    0.361000経過 

部品のリスト

• コマンド構文

  ./ossutil64 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という名前のバケット内のすべての部品を一覧表示します。

    ./ossutil64 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番号: 4
    0.191289経過 

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

    ./ossutil64 ls oss:// examplebucket -a

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

    LastModifiedTimeサイズ (B) StorageClass ETag ObjectName
    2020-12-01 15:06:37 0800 CST 114標準61DE142E5AFF9A6748707D4A77BFBCFB oss:// examplebucket/example.txt
    2020-12-01 15:06:42 0800 CST 363812標準E7581E5D2EBC56ECCB6FB6050B4C6545 oss:// examplebucket/examplefolder/photo.jpg
    2020-12-01 15:06:45 0800 CST 57374182標準BE97B7AD7A2C1277B11221E5C9537544 oss:// examplebucket/video.mp4
    オブジェクト番号は: 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番号: 4
    0.791289経過 

一般的なオプション

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

./ossutil64 ls oss:// テストe oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

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