すべてのプロダクト
Search

このプロダクト

    Object Storage Service:list-objects (get-bucket)

    ドキュメントセンター

    Object Storage Service:list-objects (get-bucket)

    最終更新日:Jan 14, 2025

    指定されたObject Storage Service (OSS) バケット内のすべてのオブジェクトを一覧表示します。

    使用上の注意

    • デフォルトでは、Alibaba Cloudアカウントには、バケット内のすべてのオブジェクトを一覧表示する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケット内のすべてのオブジェクトを一覧表示するには、oss:ListObjects権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。

    • list-objects (get-bucket) コマンドが新しいバージョンに更新されました: list-objects-v2 (get-bucket-v2) 。 アプリケーション開発では、list-objects-v2 (get-bucket-v2) を使用することを推奨します。 下位互換性を維持するために、OSSは引き続きlist-objects (get-bucket) コマンドをサポートします。

    • list-objects (get-bucket) コマンドは、オブジェクトのユーザーメタデータを返しません。

    コマンド構文

    ossutil api list-objects --bucket value [flags]

    パラメーター

    タイプ

    説明

    -- bucket

    String

    バケットの名前です。

    -区切り文字

    String

    オブジェクトを名前でグループ化するために使用する文字。

    -- encoding-type

    String

    レスポンス内のオブジェクト名のエンコードタイプ。

    -- マーカー

    String

    list-objects操作が開始されるオブジェクトの名前。 このパラメーターを指定すると、markerの値の後に名前がアルファベット順に表示されるオブジェクトが返されます。

    -最大キー

    int

    返されるオブジェクトの最大数。

    -- プレフィックス

    String

    返されるオブジェクト名に含める必要があるプレフィックス。

    説明

    • list-objectsコマンドは、GetBucket (ListObjects) 操作に相当します。 API操作の詳細については、「GetBucket (ListObjects) 」をご参照ください。

    • サポートされているグローバルコマンドラインオプションの詳細については、「コマンドラインオプション」をご参照ください。

    例

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

    ossutil api list-objects --bucket examplebucket

    examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、出力をJSONでフォーマットします。 

    ossutil api list-objects --bucket examplebucket --output-format json

    examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、YAMLで出力をフォーマットします。 

    ossutil api list-objects --bucket examplebucket --output-format yaml

    examplebucketという名前のバケットに、dirプレフィックスを持つすべてのオブジェクトを一覧表示します。 

    ossutil api list-objects --bucket examplebucket --prefix dir

    examplebucketという名前のバケットに、名前にdirプレフィックスが付いた最初の100オブジェクトを一覧表示します。 

    ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100

    現在のディレクトリにあるすべてのオブジェクトをexamplebucketという名前のバケットに一覧表示します。

    ossutil api list-objects --bucket examplebucket --delimiter /

    examplebucketという名前のバケットで、名前がtest.txtの後のアルファベット順のオブジェクトを一覧表示します。 

    ossutil api list-objects --bucket examplebucket --marker test.txt

    examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、レスポンスでオブジェクト名をURLエンコードします。 

    ossutil api list-objects --bucket examplebucket --encoding-type url