lrbコマンドを実行して、1つ以上のリージョン内のバケットを一覧表示できます。 このコマンドは、バケット名、作成時刻、ストレージクラス、バケット数などの基本的なバケット情報を返します。
使用上の注意
バケットを一覧表示するには、oss:ListBuckets権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。
ossutil 1.6.16以降の場合、コマンドラインでossutilをバイナリ名として直接使用できます。 オペレーティングシステムに基づいてバイナリ名を更新する必要はありません。 1.6.16より前のossutilの場合、オペレーティングシステムに基づいてバイナリ名を更新する必要があります。 詳細は、「ossutilコマンドリファレンス」をご参照ください。
コマンド構文
ossutil lrb conf_file [-e <value>]
次の表に、コマンド構文のパラメーターとオプションを示します。
パラメータ /オプション | 説明 |
conf_ファイル | 複数のリージョン内のバケットを一覧表示する場合は、ローカル設定ファイルを指定し、これらのリージョンのエンドポイントを設定ファイルに入力します。 複数のエンドポイントをラインフィードで区切ります。 |
-e | 1つのリージョン内のバケットを一覧表示する場合は、このパラメーターをリージョンのエンドポイントに設定します。 |
例
単一リージョン内のバケットの一覧表示
次のコマンドは、中国 (杭州) リージョン内のバケットを一覧表示します。
ossutil lrb -e oss-cn-hangzhou.aliyuncs.com
ossutil構成ファイルでエンドポイントが指定されているリージョン内のバケットを一覧表示します。 ossutil構成ファイルでエンドポイントを指定する方法の詳細については、「config」をご参照ください。
ossutil lrb
複数のリージョン内のバケットの一覧表示
ローカルファイルを作成し、ローカルファイルでこれらのリージョンのエンドポイントを指定します。
localfile.txt
という名前のローカルファイルを作成し、ファイル内のエンドポイントを指定します。 次のコードは、localfile.txt
の設定方法の例を示しています。oss-cn-hangzhou.aliyuncs.com oss-cn-shenzhen.aliyuncs.com oss-cn-shanghai.aliyuncs.com
指定したリージョン内のバケットを一覧表示します。
ossutil lrb localfile.txt
サンプル出力
コマンドが成功すると、出力にはバケット名、作成時間、ストレージクラス、バケット数、およびバケットの一覧表示にかかる時間が含まれます。 次の例は、複数のリージョン内のバケットを一覧表示するコマンドの出力です。
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を使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKey secretを指定します。
次のサンプルコマンドは、中国 (上海) リージョンにあり、別のAlibaba Cloudアカウントが所有するバケットを一覧表示する方法を示しています。
ossutil lrb -e oss-cn-shanghai.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA**** -k 67DLVBkH7EamOjy2W5RVAHUY9H****
共通オプションの詳細については、「共通オプション」をご参照ください。