Ruby SDK
山河对象存储的 Ruby SDK 已在 GitHub 开源，本文为简要使用文档。更多详细信息请参见 GitHub 项目。
使用 SDK 之前请先在 管理控制台 申请 Access key。
安装
山河对象存储提供两个安装方式，用户可根据需求选用。
方式一： 直接 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
代码示例
获取账户下的 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]