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

Object Storage Service:バケットのリスト (Ruby SDK)

最終更新日:Nov 30, 2025

バケットはオブジェクトを格納するために使用されるコンテナーです。すべてのオブジェクトはバケットに格納する必要があります。バケットはアルファベット順にリストされます。ご利用の Alibaba Cloud アカウントに属するすべてのリージョンにわたるバケットをリストし、特定の条件に基づいてフィルター処理できます。

バケットのリスト

次のコードは、アカウント内のすべてのリージョンにあるすべてのバケットをリストする方法を示しています。

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # 中国 (杭州) エンドポイントを例として使用します。実際のエンドポイントに置き換えてください。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 環境変数からアクセス認証情報を取得します。このコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# アカウント内のすべてのリージョンにあるすべてのバケットをリストします。
buckets = client.list_buckets
buckets.each { |b| puts b.name }

指定されたプレフィックスを持つバケットのリスト

次のコードは、アカウント内のすべてのリージョンでプレフィックスが「example」のバケットをリストする方法を示しています。

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # 中国 (杭州) エンドポイントを例として使用します。実際のエンドポイントに置き換えてください。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 環境変数からアクセス認証情報を取得します。このコードを実行する前に、環境変数 OSS_ACCESS_KEY_ID と OSS_ACCESS_KEY_SECRET が設定されていることを確認してください。
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# アカウント内のすべてのリージョンで、指定されたプレフィックスを持つバケットをリストします。
buckets = client.list_buckets(:prefix => 'example')
buckets.each { |b| puts b.name }

関連ドキュメント

ListBuckets API 操作の詳細については、「ListBuckets (GetService)」をご参照ください。