lrb(列舉地域級(jí)別下的Bucket)
您可以通過lrb命令獲取單個(gè)或多個(gè)地域(Region)下存儲(chǔ)空間(Bucket)的基本信息,包括Bucket的名稱、創(chuàng)建時(shí)間、存儲(chǔ)類型以及個(gè)數(shù)等。
注意事項(xiàng)
要列舉存儲(chǔ)空間,您必須具有oss:ListBuckets權(quán)限。具體操作,請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。
從ossutil 1.6.16版本開始,命令行中Binary名稱支持直接使用ossutil,您無需根據(jù)系統(tǒng)刷新Binary名稱。如果您的ossutil版本低于1.6.16,則需要根據(jù)系統(tǒng)刷新Binary名稱。更多信息,請(qǐng)參見命令行工具ossutil命令參考。
命令格式
ossutil lrb conf_file [-e <value>]
參數(shù)及選項(xiàng)說明如下:
配置項(xiàng) | 說明 |
conf_file | 如果您希望獲取多個(gè)Region下的Bucket信息時(shí),請(qǐng)輸入一個(gè)本地配置文件,并在文件中換行填寫多個(gè)Region對(duì)應(yīng)的Endpoint。 |
-e | 如果您僅希望獲取單個(gè)Region下的Bucket信息,請(qǐng)通過此選項(xiàng)指定該Region對(duì)應(yīng)的Endpoint。 |
使用示例
獲取單個(gè)地域的Bucket信息
獲取華東1(杭州)地域下的Bucket信息。
ossutil lrb -e oss-cn-hangzhou.aliyuncs.com
獲取與ossutil配置文件中指定Endpoint關(guān)聯(lián)Region下的Bucket信息。有關(guān)ossutil配置文件中Endpoint的信息,請(qǐng)參見config命令。
ossutil lrb
獲取多個(gè)地域的Bucket信息
創(chuàng)建本地文件,并在文件中配置Endpoint信息。
在本地創(chuàng)建名為
localfile.txt
文件,并根據(jù)使用場(chǎng)景填寫待獲取Bucket信息所在Region對(duì)應(yīng)的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
返回結(jié)果
獲取Bucket信息成功后,返回結(jié)果中將包含Bucket的名稱、創(chuàng)建時(shí)間、存儲(chǔ)類型以及個(gè)數(shù)以及獲取所用時(shí)長。以獲取多個(gè)Region下的Bucket信息為例,其返回結(jié)果如下:
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
通用選項(xiàng)
當(dāng)您需要通過命令行工具ossutil切換至另一個(gè)地域的Bucket時(shí),可以通過-e選項(xiàng)指定該Bucket所屬的Endpoint。當(dāng)您需要通過命令行工具ossutil切換至另一個(gè)阿里云賬號(hào)下的Bucket時(shí),可以通過-i選項(xiàng)指定該賬號(hào)的AccessKey ID,并通過-k選項(xiàng)指定該賬號(hào)的AccessKey Secret。
例如您需要獲取另一個(gè)阿里云賬號(hào)下,華東2(上海)地域下的Bucket信息,命令如下:
ossutil lrb -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
關(guān)于此命令的其他通用選項(xiàng)的更多信息,請(qǐng)參見通用選項(xiàng)。