You can list all created buckets to view their information.
Important Notes
By default, bucket listing requests are happened in the CN North-Beijing1 region. Therefore, the expenditures for ListAllMyBucketsOperation requests are included in this region.
Ways to List Buckets
You can use OBS Console, APIs, SDKs, OBS Browser+, or obsutil to list buckets.
Using OBS Console
- Log in to OBS Console.
- Go to the bucket list page, which displays all buckets under your account.
Using the GUI Tool - OBS Browser+
Log in to OBS Browser+. All buckets under your account are displayed in the bucket list.
Using the CLI Tool - obsutil
Command Line Structure
- In Windows
obsutil ls [-s] [-fs] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
- In Linux or macOS
./obsutil ls [-s] [-fs] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
Examples
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.
|
sc |
Optional (additional parameter) |
Queries the storage classes of the buckets when listing buckets. |
j |
Optional (additional parameter). It must be used together with sc. |
The maximum number of concurrent tasks for querying the bucket storage class. The default value is the value of defaultJobs in the configuration file.
NOTE:
The value is ensured to be greater than or equal to 1.
|
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.
|
fs |
Optional (additional parameter) |
Whether the method of listing parallel file systems is applied. If you are listing parallel file systems, you are recommended to add this parameter.
CAUTION:
- With this method, the listing time required varies largely depending on the directory structures.
- After this parameter is enabled, marker and limit will be ignored. Then, the size of the bucket, parallel file system, or directory will be calculated.
- This parameter is only supported by obsutil 5.5.12 and later.
|
limit |
Optional (additional parameter) |
The 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) |
The user-defined configuration file for executing the current command. To learn the parameters that can be configured in this file, see
Configuration Parameters. |
e |
Optional (additional parameter) |
The endpoint |
i |
Optional (additional parameter) |
The user's AK |
k |
Optional (additional parameter) |
The user's SK |
t |
Optional (additional parameter) |
The user's security token |
In a bucket listing result, BucketType indicates the bucket type. OBJECT indicates an object storage bucket, while POSIX indicates a parallel file system.