oss-ruby

oss-ruby is the Ruby SDK of Aliyun OSS API service. All oss api methods are available through this SDK.

What is Aliyun OSS
Aliyun OSS API Official Doc

Note It's released on RubyGems. If something doesn't work, feel free to report a bug or start an issue.

Add this line to your application's Gemfile:

gem 'oss-ruby'

And then execute:

$ bundle

Or install it yourself as:

$ gem install oss-ruby

If you prefer to use the latest code, you can build from source:

gem build oss-ruby.gemspec
gem install oss-ruby-<VERSION>.gem

oss-ruby requires you to initialize an instance before usage.

# Initialize oss-ruby
require 'oss'

oss = OSS.new({
  endpoint: 'oss-cn-hangzhou.aliyuncs.com',
  access_key_id: 'your_access_key',
  access_key_secret: 'your_access_secret'
})

Using sdk to call oss service is quite straight forward.

# Get Service
res = oss.get_service
p res.status # => 200

Some of the APIs returns with a xml string as response body. oss-ruby uses Nokogiri to parse the xml document internally.

res = oss.get_service
p res.status # => 200
p res.body # => "<?xml version=\"1.0\"..."
p res.doc.xpath("//ID").text # => "1216909307023357"
# and it can be shorter
p res.xpath("//ID").text # => "1216909307023357"

When API responds with an error. oss-ruby provide a error method in response object to easily parse error messages.

res = oss.get_bucket('non-exist-bucket')
p res.status # => 404
p res.body # => "<?xml version=\"1.0\"..."
p res.error.code #=> "NoSuchBucket"
p res.error.message #=> "The specified bucket does not exist."

And if network connection fails, oss-ruby will raise a OSS::HTTPClientError with backtrace and error message.

• Quick Start
• Bucket API
• Object API
• Multipart Upload
• Cross-Origin Resource Sharing