如何通过lrb命令获取Bucket的信息 - 对象存储 OSS

您可以通过lrb命令获取单个或多个地域（Region）下存储空间（Bucket）的基本信息，包括Bucket的名称、创建时间、存储类型以及个数等。

注意事项

要列举存储空间，您必须具有oss:ListBuckets权限。具体操作，请参见为RAM用户授权自定义的权限策略。
从ossutil 1.6.16版本开始，命令行中Binary名称支持直接使用ossutil，您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16，则需要根据系统刷新Binary名称。更多信息，请参见命令行工具ossutil命令参考。

命令格式

ossutil lrb conf_file [-e <value>]

参数及选项说明如下：

配置项	说明
conf_file	如果您希望获取多个Region下的Bucket信息时，请输入一个本地配置文件，并在文件中换行填写多个Region对应的Endpoint。
-e	如果您仅希望获取单个Region下的Bucket信息，请通过此选项指定该Region对应的Endpoint。

使用示例

获取单个地域的Bucket信息
获取华东1（杭州）地域下的Bucket信息。
```
ossutil lrb -e oss-cn-hangzhou.aliyuncs.com
```
获取与ossutil配置文件中指定Endpoint关联Region下的Bucket信息。有关ossutil配置文件中Endpoint的信息，请参见config命令。
```
ossutil lrb
```
获取多个地域的Bucket信息
1. 创建本地文件，并在文件中配置Endpoint信息。
  在本地创建名为localfile.txt文件，并根据使用场景填写待获取Bucket信息所在Region对应的Endpoint。localfile.txt配置如下：
```
oss-cn-hangzhou.aliyuncs.com
oss-cn-shenzhen.aliyuncs.com
oss-cn-shanghai.aliyuncs.com
```
2. 获取华东1（杭州）、华南1（深圳）以及华东2（上海）地域下的Bucket信息。
```
ossutil lrb localfile.txt
```

返回结果

获取Bucket信息成功后，返回结果中将包含Bucket的名称、创建时间、存储类型以及个数以及获取所用时长。以获取多个Region下的Bucket信息为例，其返回结果如下：

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

通用选项

当您需要通过命令行工具ossutil切换至另一个地域的Bucket时，可以通过-e选项指定该Bucket所属的Endpoint。当您需要通过命令行工具ossutil切换至另一个阿里云账号下的Bucket时，可以通过-i选项指定该账号的AccessKey ID，并通过-k选项指定该账号的AccessKey Secret。

例如您需要获取另一个阿里云账号下，华东2（上海）地域下的Bucket信息，命令如下：

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

关于此命令的其他通用选项的更多信息，请参见通用选项。