lrb（列举地域级别下的Bucket）

注意事项

• 要列举存储空间，您必须具有oss:ListBuckets权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• 从ossutil 1.6.16版本开始，命令行中Binary名称支持直接使用ossutil，您无需根据系统刷新Binary名称。如果您的ossutil版本低于1.6.16，则需要根据系统刷新Binary名称。更多信息，请参见命令行工具ossutil命令参考。

命令格式

ossutil lrb conf_file [-e <value>]

参数及选项说明如下：

使用示例

• 获取单个地域的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。

ossutil lrb -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

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