帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

Ruby SDK

QingStor Ruby SDK 已在 GitHub 开源,下文为简要使用文档。更多详细信息请参见 https://github.com/yunify/qingstor-sdk-ruby

安装

直接 Ruby Gem 安装:

> gem install qingstor-sdk

从源码安装:

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

快速开始

使用 SDK 之前请先在 青云控制台 申请 access key 。

初始化服务

发起请求前首先建立需要初始化服务:

require 'qingstor/sdk'

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

上面代码初始化了一个 QingStor Service

获取账户下的 Bucket 列表

result = qs_service.list_buckets

# Print HTTP status code
puts result[:status_code]

# Print bucket count
puts result[:buckets].length

创建 Bucket

初始化并创建 Bucket, 需要指定 Bucket 名称和所在 Zone:

bucket = qs_service.bucket 'test-bucket', 'pek3a'
putBucketOutput, _ := bucket.put

获取 Bucket 中存储的 Object 列表

result = bucket.list_objects

# Print HTTP status code
puts result[:status_code]

# Print keys count
puts result[:keys].length

创建一个 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]