すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ls (バケット、オブジェクト、またはパートのリスト表示)

    ドキュメントセンター

    Object Storage Service:ls (バケット、オブジェクト、またはパートのリスト表示)

    最終更新日:Nov 14, 2025

    アカウント内の Object Storage Service (OSS) リソース (大きいファイルの検索や削除など) をクエリおよび管理するには、ls コマンドを使用してバケット、オブジェクト、およびパートをリスト表示できます。

    使用上の注意

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

      権限の説明

      デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 Alibaba Cloud アカウントに属する RAM ユーザーまたは RAM ロールには、デフォルトでは権限がありません。 Alibaba Cloud アカウントまたは管理者は、RAM ポリシーまたはバケットポリシーを使用して権限を付与する必要があります。

      API アクション

      説明

      oss:ListBuckets

      ls コマンドを実行してアカウント内のバケットをリスト表示するために必要な権限。

      oss:ListObjects

      指定されたバケット内のオブジェクトをリスト表示するために ls コマンドを実行するのに必要な権限。

      oss:ListObjectVersions

      オプション。 --all-versions オプションが指定されたときにオブジェクトのすべてのバージョンをリスト表示するために必要な権限。

      oss:ListMultipartUploads

      オプション。 未完了または中止されたマルチパートアップロードタスクをリスト表示するために必要な権限。

      oss:ListParts

      オプション。 パートをリスト表示するために必要な権限。

      コマンド構文

      ossutil ls cloud_url [options]

      パラメーターの説明

      パラメーター

      説明

      cloud_url

      操作対象のリソースを指定します。 形式は oss://[bucket_name[/prefix]] です。

      • 省略した場合、現在のアカウントでアクセス権限を持つすべてのバケットがリスト表示されます。

      • oss://bucket_name を指定すると、バケット内のすべてのオブジェクトが再帰的にリスト表示されます。

      • oss://bucket_name/prefix を指定すると、バケット内で指定されたプレフィックスに一致するすべてのオブジェクトが再帰的にリスト表示されます。

      -s, --short-format

      出力を簡略化された形式で表示します。 結果にはリソース名のみが含まれます。

      -d, --directory

      非再帰的なリスト表示を実行します。 現在のパス内のオブジェクトと第 1 レベルのサブディレクトリ (/ で終わる共通プレフィックス) のみをリスト表示します。

      -m, --multipart

      指定されたバケット内の未完了または中止されたすべてのマルチパートアップロードタスクをリスト表示します。
      注 未完了のパートはストレージ領域を占有し、料金が発生します。 定期的に確認してクリアしてください。

      -a, --all-type

      オブジェクトや未完了のパートを含む、すべてのタイプのリソースをリスト表示します。

      --limited-num

      1 回のリクエストで返す結果の最大数を設定します。 このオプションはページネーションに使用できます。 バケットに多数のオブジェクトが含まれている場合は、このオプションを --marker オプションとともにページネーションに使用して、一度に多数のオブジェクトをリスト表示することによって発生するリクエストのタイムアウトを防ぎます。

      --marker

      指定されたマーカーからリスト表示を開始します。 バケットに多数のオブジェクトが含まれている場合は、このオプションを --limited-num オプションとともにページネーションに使用します。

      --upload-id-marker

      指定された UploadID の後から未完了のマルチパートアップロードタスクのリスト表示を続行します。

      --payer

      リクエスタがアクセス料金を支払うことを指定します。 このオプションを `requester` に設定すると、トラフィック料金やリクエスト料金などの生成された料金はリクエスタが支払います。

      --include

      指定されたワイルドカード文字形式に一致するオブジェクトをリスト表示します。 詳細については、「--include および --exclude オプション」をご参照ください。

      --exclude

      指定されたワイルドカード文字形式に一致しないオブジェクトをリスト表示します。 詳細については、「--include および --exclude オプション」をご参照ください。

      --all-versions

      オブジェクトのすべての履歴バージョンをリスト表示します。 このオプションは、バージョン管理が有効なバケットでのみ有効です。

      --version-id-marker

      指定されたバージョン ID の後からオブジェクトの履歴バージョンのリスト表示を続行します。 このオプションは、バージョン管理が有効なバケットでのみ有効です。

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

      出力結果

      返されたオブジェクトリストの ETag 値は、オブジェクトコンテンツの整合性を検証するために使用されます。

      • PutObject リクエストを使用して作成されたオブジェクトの場合、その ETag はオブジェクトコンテンツの MD5 ハッシュです。

      • マルチパートアップロードなどのメソッドを使用して作成されたオブジェクトの場合、その ETag は一意の識別子であり、オブジェクトコンテンツの MD5 ハッシュではありません。

      使用例

      すべてのバケットをリスト表示する

      アカウントでアクセス権限を持つすべてのバケットをリスト表示するには、パラメーターなしで ls コマンドを実行します。

      ossutil ls

      または

      ossutil ls oss://

      出力：

      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

      シンプルモードでバケットをリスト表示する

      ossutil ls -s

      出力例：

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

      ページごとにバケットをリスト表示する

      多数のバケットがある場合は、--limited-num および --marker オプションを使用してページごとにリスト表示できます。

      マーカー examplebucketA のアルファベット順で後にあるバケットをリスト表示します。

      ossutil ls  --limited-num=2 -s --marker 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
Bucket Number is:2
0.132174(s) elapsed

      指定されたバケット内のすべてのオブジェクトをリスト表示する

      examplebucket バケット内のすべてのオブジェクトをリスト表示します。

      ossutil ls oss://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
0.007379(s) elapsed

      ETag 値は、オブジェクトのコンテンツを識別するために使用されます。 PutObject リクエストを使用して作成されたオブジェクトの場合、ETag 値はオブジェクトコンテンツの MD5 ハッシュです。 他のメソッドを使用して作成されたオブジェクトの場合、ETag 値は特定のルールに基づいて生成される一意の値であり、オブジェクトコンテンツの MD5 ハッシュではありません。

      指定されたディレクトリ (プレフィックス) 内のオブジェクトをリスト表示する

      examplebucket バケット内で example プレフィックスを持つオブジェクトをリスト表示します。

      ossutil ls oss://examplebucket/example

      出力例：

      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

      指定されたサフィックスを持つオブジェクトをリスト表示する

      --include オプションを使用して、examplebucket バケット内のすべての .mp4 ファイルをリスト表示できます。

      ossutil ls oss://examplebucket --include *.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

      オブジェクトと第 1 レベルのサブディレクトリを非再帰的にリスト表示する

      -d オプションを使用して、examplebucket バケットのルートディレクトリにあるオブジェクトと第 1 レベルのサブディレクトリのみをリスト表示します。 サブディレクトリのコンテンツは再帰的にリスト表示されません。

      ossutil ls oss://examplebucket -d

      出力：

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

      すべてのオブジェクトのすべてのバージョンをリスト表示する

      バージョン管理が有効なバケットの場合、--all-versions オプションを使用してすべてのオブジェクトバージョンをリスト表示します。

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

      出力：

      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

      指定されたオブジェクトのすべてのバージョンをリスト表示する

      バージョン管理が有効なバケットの場合、--all-versions オプションを使用して example.txt のすべてのバージョンをリスト表示します。

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

      出力例：

      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.361(s) elapsed

      すべてのパートをリスト表示する

      -m オプションを使用して、アップロードが中断または失敗した結果として examplebucket にあるすべての未完了のパートをリスト表示します。 これらのパートはストレージ領域を消費し、料金が発生します。 不要なコストを避けるために、これらのパートを定期的に削除してください。

      ossutil ls oss://examplebucket -m

      出力例：

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

      すべてのオブジェクトとパートをリスト表示する

      -m オプションを使用して、examplebucket 内のすべてのオブジェクトとパートをリスト表示できます。

      ossutil ls oss://examplebucket -a

      出力例：

      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

      別のアカウントによって承認されたリソースをリスト表示する

      中国 (杭州) リージョンにある別の Alibaba Cloud アカウントに属するテストバケット内のすべてのファイルをリスト表示できます。

      ossutil ls oss://test -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret