All Products
Search
Document Center

Object Storage Service:List-cloud-boxes

Last Updated:Mar 13, 2025

The list-cloud-boxes command lists CloudBox information associated with your current Alibaba Cloud account.

Notes

Your Alibaba Cloud account has default permission to list CloudBox information. To list information using a RAM user or Security Token Service (STS), you must have the oss-cloudbox:* permission. For detailed operations, see Grant custom policy to RAM users.

Command format

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 supported global command line options, see Supported global command line options.

Examples

  • List all CloudBoxes under the requester's Alibaba Cloud account.

    ossutil api list-cloud-boxes
  • List all CloudBoxes under the requester's Alibaba Cloud account and display them in JSON format.

    ossutil api list-cloud-boxes --output-format json
  • List all CloudBoxes under the requester's Alibaba Cloud account and display them in YAML format.

    ossutil api list-cloud-boxes --output-format yaml
  • List all CloudBoxes under the requester's Alibaba Cloud account with the prefix example.

    ossutil api list-cloud-boxes --prefix example
  • List the first 10 CloudBoxes under the requester's Alibaba Cloud account.

    ossutil api list-cloud-boxes --max-keys 10
  • List all CloudBoxes under the requester's Alibaba Cloud account after the specified marker example.

    ossutil api list-cloud-boxes --marker example