list-buckets(get-service) - Object Storage Service

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