全部產品
Search
文件中心

Object Storage Service:lrb(列舉地區層級下的Bucket)

更新時間:Jul 31, 2024

您可以通過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****

關於此命令的其他通用選項的更多資訊,請參見通用選項