list-buckets(get-service)_对象存储(OSS)-阿里云帮助中心

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
```