Listing Buckets

Updated on 2025-02-10 GMT+08:00

View PDF

Function

You can use this command to obtain the bucket list. In the list, bucket names are displayed in lexicographical order.

Command Line Structure

In Windows

obsutil ls [-s]  [-limit=1] [-format=default] [-config=xxx]

In Linux or macOS

./obsutil ls [-s]   [-du] [-fs] [-j=1] [-limit=1] [-format=default] [-config=xxx]

Examples

Take the Windows OS as an example. Run the obsutil ls -limit=5 command to obtain the bucket list.

obsutil ls -limit=5
Start at 2024-09-29 07:58:46.0506904 +0000 UTC

Bucket                        CreationDate                  Location         BucketType   
obs://bucket001               2018-09-03T01:53:02Z          example          OBJECT   

obs://bucket002               2018-11-01T01:40:01Z          example          OBJECT      

obs://bucket003               2018-10-25T11:45:45Z          example          OBJECT       

obs://bucket004               2018-10-26T02:33:09Z          example          OBJECT      

obs://bucket005               2018-10-26T02:34:50Z          example          OBJECT      
         
Bucket number : 5

Parameter Description

Parameter	Optional or Mandatory	Description
s	Optional (additional parameter)	Displays simplified query result. NOTE: In the simplified format, the returned result contains only the bucket name.
du	Optional (additional parameter)	Quickly returns the total size of listed objects, without displaying detailed object information. This parameter can be used together with other parameters. NOTE: This parameter takes effect only on listing objects, but not on listing buckets.
limit	Optional (additional parameter)	Maximum number of buckets that can be queried. If the value is less than 0, all buckets are listed. If it is left blank, a maximum of 1000 buckets can be listed by default.
format	Optional (additional parameter)	Prints a listing result in the user-defined format. Currently, the value can only be default, indicating that the listing result is displayed in one row.
config	Optional (additional parameter)	User-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see .

NOTE:

In a bucket listing result, BucketType indicates the bucket type. OBJECT indicates an object storage bucket, while POSIX indicates a parallel file system.

Parent topic: Bucket Commands

Previous topic: Creating a Bucket

Next topic: Querying Bucket Properties

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot