存储空间(Bucket)是OSS上的命名空间,也是计费、权限控制、日志记录等高级功能的管理实体。

查看所有Bucket

使用Client#list_buckets接口列出当前用户下的所有Bucket,用户还可以指 定:prefix参数,列出Bucket名字为特定前缀的所有Bucket:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

buckets = client.list_buckets
buckets.each { |b| puts b.name }

buckets = client.list_buckets(:prefix => 'my-')
buckets.each { |b| puts b.name }

创建Bucket

使用Client#create_bucket接口创建一个Bucket,用户需要指定Bucket的名字:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

client.create_bucket('my-bucket')

说明
  • Bucket的命名规范请查看OSS 基本概念
  • 由于存储空间的名字是全局唯一的,所以必须保证您的Bucket名字不与别人的重复。

删除Bucket

使用Client#delete_bucket接口删除一个Bucket,用户需要指定Bucket的名字:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

client.delete_bucket('my-bucket')
说明
  • 如果该Bucket下还有文件存在,则需要先删除所有文件才能删除Bucket
  • 如果该Bucket下还有未完成的上传请求,则需要通过list_uploadsabort_upload先取消那些请求才能删除Bucket。用法请参考API文档

查看Bucket是否存在

用户可以通过Client#bucket_exists?接口查看当前用户的某个Bucket是否存在:

require 'aliyun/oss'

client = Aliyun::OSS::Client.new(
  endpoint: 'endpoint',
  access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')

puts client.bucket_exists?('my-bucket')

Bucket访问权限

用户可以设置Bucket的访问权限,允许或者禁止匿名用户对其内容进行读写。更 多关于访问权限的内容请参考访问权限

  • 获取Bucket的访问权限(ACL)

    通过Bucket#acl查看Bucket的ACL:

    require 'aliyun/oss'
    
    client = Aliyun::OSS::Client.new(
      endpoint: 'endpoint',
      access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
    
    bucket = client.get_bucket('my-bucket')
    puts bucket.acl
    
  • 设置Bucket的访问权限(ACL)

    通过Bucket#acl=设置Bucket的ACL:

    require 'aliyun/oss'
    
    client = Aliyun::OSS::Client.new(
      endpoint: 'endpoint',
      access_key_id: 'AccessKeyId', access_key_secret: 'AccessKeySecret')
    
    bucket = client.get_bucket('my-bucket')
    bucket.acl = Aliyun::OSS::ACL::PUBLIC_READ
    puts bucket.acl