list-buckets命令用于列举请求者拥有的所有存储空间（Bucket）。
注意事项
要列举请求者拥有的所有存储空间（Bucket），您必须有
oss: ListBuckets（GetService）权限。具体操作，请参见为RAM用户授权自定义的权限策略。您也可以通过设置prefix、marker或者max-keys参数列举满足指定条件的存储空间。
调用命令时，如果所有Bucket已返回，则返回参数的XML中不包含Prefix、Marker、MaxKeys、IsTruncated和NextMarker响应元素。
命令格式
ossutil api list-buckets [flags]参数 | 类型 | 说明 |
--marker | string | Bucket名称。 |
--max-keys | int | 限定此次返回Bucket的最大个数。 |
--prefix | string | 限定返回的Bucket名称必须以prefix作为前缀。 |
--resource-group-id | string | Bucket所属资源组Id。 |
说明
list-buckets命令对应API接口ListBuckets（GetService）。关于API中的具体参数含义，请参见ListBuckets（GetService）。
关于支持的全局命令行选项，请参见支持的全局命令行选项。
使用示例
列举请求者拥有的所有存储空间。
ossutil api list-buckets列举请求者拥有的所有存储空间，以JSON格式显示。
ossutil api list-buckets --output-format json列举请求者拥有的所有存储空间，以YAML格式显示。
ossutil api list-buckets --output-format yaml列举请求者拥有的以
example为前缀的所有存储空间。ossutil api list-buckets --prefix example列举请求者拥有的前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