存储空间（Bucket）是用来存储对象（Object）的容器。对象都隶属于存储空间。存储空间按照字母顺序排列。您可以列举当前账号所有地域下符合指定条件的存储空间。

列举存储空间

以下代码用于列举当前账号所有地域下的存储空间。

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
# 列举当前账号所有地域下的存储空间。
buckets = client.list_buckets
buckets.each { |b| puts b.name }

列举指定前缀的存储空间

以下代码用于列举当前账号所有地域下以example为前缀（prefix）的存储空间。

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  # Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
# 列举当前账号所有地域下指定前缀的存储空间。
buckets = client.list_buckets(:prefix => 'example')
buckets.each { |b| puts b.name }

相关文档

关于列举存储空间的API接口说明，请参见ListBuckets（GetService）。