すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:Irb

最終更新日:Jan 02, 2025

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
  • 複数のリージョン内のバケットの一覧表示

    1. ローカルファイルを作成し、ローカルファイルでこれらのリージョンのエンドポイントを指定します。

      localfile.txtという名前のローカルファイルを作成し、ファイル内のエンドポイントを指定します。 次のコードは、localfile.txtの設定方法の例を示しています。

      oss-cn-hangzhou.aliyuncs.com
      oss-cn-shenzhen.aliyuncs.com
      oss-cn-shanghai.aliyuncs.com
    2. 指定したリージョン内のバケットを一覧表示します。

      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****

共通オプションの詳細については、「共通オプション」をご参照ください。