指定された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