Run the lrb command to list buckets - Object Storage Service

You can run the lrb command to list buckets within one or more regions. The command returns basic bucket information, such as bucket names, creation time, storage classes, and the number of buckets.

Usage notes

To list buckets, you must have the oss:ListBuckets permission. For more information, see Attach a custom policy to a RAM user.
This topic provides sample command lines that are based on the 64-bit Linux system. For other systems, replace ./ossutil64 in the commands with the corresponding binary name. For more information, see ossutil command reference.

Command syntax

./ossutil64 lrb conf_file [-e <value>]

The following table describes the parameters and options in the syntax.

Parameter/Option	Description
conf_file	If you want to list buckets within multiple regions, specify a local configuration file and enter the endpoints of these regions in the configuration file. Separate multiple endpoints with line feeds.
-e	If you want to list buckets within a single region, set this parameter to the endpoint of the region.

Examples

List buckets within a single region
The following command lists buckets within the China (Hangzhou) region:
```
./ossutil64 lrb -e oss-cn-hangzhou.aliyuncs.com
```
List buckets within the region whose endpoint is specified in the ossutil configuration file. For more information about how to specify an endpoint in the ossutil configuration file, see config.
```
./ossutil64 lrb
```
List buckets within multiple regions
1. Create a local file and specify the endpoints of these regions in the local file.
  Create a local file named localfile.txt and specify the endpoints in the file.
```
oss-cn-hangzhou.aliyuncs.com
oss-cn-shenzhen.aliyuncs.com
oss-cn-shanghai.aliyuncs.com
```
2. List buckets within the specified regions.
```
./ossutil64 lrb localfile.txt
```

Sample output

After the command is successful, the output includes bucket names, creation time, storage classes, number of buckets, and time consumed to list the buckets. The following example is the output of the command to list buckets within multiple regions:

CreationTime                                 Region    StorageClass    BucketName
2021-07-06 14:21:09 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucket1
2021-07-06 14:21:44 +0800 CST       oss-cn-hangzhou        Standard    oss://examplebucket2
2021-06-16 18:32:32 +0800 CST       oss-cn-shanghai        Standard    oss://examplebucket3
2021-06-30 16:04:41 +0800 CST       oss-cn-shanghai        Standard    oss://examplebucket4
2021-07-07 12:33:35 +0800 CST       oss-cn-shenzhen        Standard    oss://examplebucket5

Bucket Number is: 5
0.124193(s) elapsed

Common options

If you use ossutil to switch to a bucket that is located in another region, add the -e option to the command to specify the endpoint of the region in which the specified bucket is located. If you use ossutil to switch to a bucket that belongs to another Alibaba Cloud account, add the -i option to the command to specify the AccessKey ID of the specified account, and add the -k option to the command to specify the AccessKey secret of the specified account.

The following sample command shows how to list buckets that are located in the China (Shanghai) region and owned by another Alibaba Cloud account:

./ossutil64 lrb -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA****  -k 67DLVBkH7EamOjy2W5RVAHUY9H****

For more information about other common options that you can use for the sync command, see Common options.