list-cloud-boxes-Object Storage Service(OSS)-阿里云帮助中心

Note

By default, an Alibaba Cloud account has the permission to list CloudBoxes. Listing as a RAM user or by using Security Token Service (STS) requires the oss-cloudbox:* permission. For further instructions, see Grant a custom policy.

Syntax

ossutil api list-cloud-boxes [flags]

Parameter	Type	Description
--marker	string	Specifies the name of the bucket returned by the CloudBox.
--max-keys	int	Specifies the maximum number of CloudBoxes returned.
--prefix	string	Specifies the prefix that must be included in the name of the returned CloudBoxes.

Note

For information about the supported global command-line options, see Supported global command line options.

Examples

List all CloudBoxes associated with the requester's Alibaba Cloud account.
```
ossutil api list-cloud-boxes
```
List all CloudBoxes associated with the requester's Alibaba Cloud account and display the results in the JSON format.
```
ossutil api list-cloud-boxes --output-format json
```
List all CloudBoxes associated with the requester's Alibaba Cloud account and display the results in the YAML format.
```
ossutil api list-cloud-boxes --output-format yaml
```
List all CloudBoxes associated with the requester's Alibaba Cloud account, filtered by the example name prefix.
```
ossutil api list-cloud-boxes --prefix example
```
List the first 10 CloudBoxes associated with the requester's Alibaba Cloud account.
```
ossutil api list-cloud-boxes --max-keys 10
```
List the CloudBoxes starting from the example marker.
```
ossutil api list-cloud-boxes --marker example
```