バケット内のすべてのオブジェクトを一覧表示します。
使用上の注意
デフォルトでは、Alibaba Cloudアカウントには、バケット内のすべてのオブジェクトを一覧表示する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してバケット内のすべてのオブジェクトを一覧表示するには、
oss:ListObjects権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。ユーザーメタデータは、GetBucketV2 (ListObjectsV2) リクエストに対して返されません。
コマンド構文
ossutil api list-objects-v2 --bucket value [flags]パラメーター | タイプ | 説明 |
-- bucket | String | バケットの名前です。 |
-- continuation-token | String | リスト操作の開始元となるトークン。 |
-区切り文字 | String | オブジェクトを名前でグループ化するために使用する文字。 |
-- encoding-type | String | レスポンス内のオブジェクト名のエンコードタイプ。 |
-- fetch-owner | String | レスポンスにオブジェクト所有者情報を含めるかどうかを指定します。 |
-最大キー | int | 返されるオブジェクトの最大数。 |
-- プレフィックス | String | 返されるオブジェクト名に含める必要があるプレフィックス。 |
-- start-after | String | リスト操作の開始位置。 このパラメーターの値の後に名前がアルファベット順になっているオブジェクトが順番に返されます。 |
list-objects-v2 (get-bucket-v2) コマンドは、ListObjectsV2 (GetBucketV2) オペレーションに対応する。 ListObjectsV2 (GetBucketV2) 操作のパラメーターの詳細については、「ListObjectsV2 (GetBucketV2) 」をご参照ください。
サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。
例
次のコマンドを実行して、examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket次のコマンドを実行して、examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、結果をJSON形式で表示します。
ossutil api list-objects-v2 --bucket examplebucket --output-format json次のコマンドを実行して、examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、結果をYAML形式で表示します。
ossutil api list-objects-v2 --bucket examplebucket --output-format yaml次のコマンドを実行して、名前にdirプレフィックスが含まれるすべてのオブジェクトをexamplebucketという名前のバケットに一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir次のコマンドを実行して、名前がdirプレフィックスを含む最初の100オブジェクトをexamplebucketという名前のバケットに一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket --prefix dir --max-keys 100次のコマンドを実行して、examplebucketという名前のバケットの現在のディレクトリにあるオブジェクトを一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket --delimiter /次のコマンドを実行して、examplebucketという名前のバケット内の名前がtest.txtの後にアルファベット順になっているオブジェクトを一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket --start-after test.txt次のコマンドを実行して、examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、オブジェクトの名前をURLエンコードします。
ossutil api list-objects-v2 --bucket examplebucket --encoding-type url次のコマンドを実行して、examplebucketという名前のバケット内のすべてのオブジェクトを一覧表示し、返された結果に所有者情報を含めます。
ossutil api list-objects-v2 --bucket examplebucket --fetch-owner次のコマンドを実行して、examplebucketという名前のバケット内のCgJiYw123の後のオブジェクトを一覧表示します。
ossutil api list-objects-v2 --bucket examplebucket --continuation-token CgJiYw123