QingStor 对象存储的 Ruby SDK 已在 GitHub 开源,本文为简要使用文档。更多详细信息请参见 GitHub 项目

使用 SDK 之前请先在 QingCloud 管理控制台申请 Access key。

安装

QingStor 对象存储提供两个安装方式,用户可根据需求选用。

  • 方式一:直接 Ruby Gem 安装:

    gem install qingstor-sdk
  • 方式二:从源码安装:

    git clone git@github.com:qingstor/qingstor-sdk-ruby.git
    cd qingstor-sdk-ruby
    bundle install
    bundle exec rake install

初始化服务

发起请求前需要初始化服务。以下代码初始化了一个 QingStor Service。

require 'qingstor/sdk'

config = QingStor::SDK::Config.init 'ACCESS_KEY_ID', 'SECRET_ACCESS_KEY'
qs_service = QingStor::SDK::Service.new config

代码示例

  1. 获取账户下的 Bucket 列表

    result = qs_service.list_buckets
    
    # Print HTTP status code
    puts result[:status_code]
    
    # Print bucket count
    puts result[:buckets].length
  2. 初始化并创建 Bucket, 需要指定 Bucket 名称和所在 Zone:

    bucket = qs_service.bucket 'test-bucket', 'pek3a'
    putBucketOutput = bucket.put
  3. 获取 Bucket 中存储的 Object 列表

    result = bucket.list_objects
    
    # Print HTTP status code
    puts result[:status_code]
    
    # Print keys count
    puts result[:keys].length
  4. 创建一个 Object,例如上传一张屏幕截图:

    file_path = File.expand_path '~/Desktop/Screenshot.jpg'
    result = bucket.put_object 'Screenshot.jpg', body: File.open(file_path)
    
    # Print HTTP status code.
    puts result[:status_code]