您可以通過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資訊
建立本地檔案,並在檔案中配置Endpoint資訊。
在本地建立名為
localfile.txt
檔案,並根據使用情境填寫待擷取Bucket資訊所在Region對應的Endpoint。localfile.txt
配置如下:oss-cn-hangzhou.aliyuncs.com oss-cn-shenzhen.aliyuncs.com oss-cn-shanghai.aliyuncs.com
擷取華東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****
關於此命令的其他通用選項的更多資訊,請參見通用選項。