リクエスタが所有するすべてのバケットを一覧表示します。
使用上の注意
リクエスタが所有するすべてのバケットを一覧表示するには、
oss: ListBuckets(GetService)権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。prefix、marker、またはmax-keysパラメーターを指定して、指定した条件を満たすバケットを照会できます。
コマンドの実行時にすべてのバケットが返された場合、XML形式のレスポンスパラメーターには、Prefix、Marker、MaxKeys、IsTruncated、またはNextMarkerのレスポンス要素は含まれません。
コマンド構文
ossutil api list-buckets [flags]パラメーター | データ型 | 説明 |
-- マーカー | String | バケットの名前です。 |
-最大キー | int | リクエストに対して返すことができるバケットの最大数。 |
-- プレフィックス | String | 返すバケットの名前に含める必要があるプレフィックス。 |
-- resource-group-id | String | バケットが属するリソースグループのID。 |
list-bucketsコマンドは、ListBuckets (GetService) 操作に対応します。 ListBuckets (GetService) 操作のパラメーターの詳細については、「ListBuckets (GetService) 」をご参照ください。
サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。
例
次のコマンドを実行して、リクエスタが所有するすべてのバケットを一覧表示します。
ossutil api list-buckets次のコマンドを実行して、リクエスタが所有するすべてのバケットを一覧表示し、バケットをJSON形式で表示します。
ossutil api list-buckets -- output-format json次のコマンドを実行して、リクエスタが所有するすべてのバケットを一覧表示し、バケットをYAML形式で表示します。
ossutil api list-buckets -- 出力形式yaml次のコマンドを実行して、名前に
exampleプレフィックスが含まれ、リクエスタが所有するバケットを一覧表示します。ossutil api list-buckets -- prefixの例次のコマンドを実行して、リクエスタが所有する最初の100バケットを一覧表示します。
ossutil api list-buckets -- max-keys 100次のコマンドを実行して、名前がexamplebucketの後にアルファベット順であり、リクエスタが所有するバケットを一覧表示します。
ossutil api list-buckets -- marker examplebucket次のコマンドを実行して、IDが
rg-123のリソースグループに属するバケットを一覧表示します。ossutil api list-buckets -- resource-group-id rg-123