Get started quickly using AWS with the AWS SDK for Ruby. The SDK helps take the complexity out of coding by providing Ruby classes for many AWS services including Amazon S3, Amazon EC2, DynamoDB, and more. The single, downloadable package includes the AWS Ruby Library and documentation. The SDK is also available through Ruby Gems (

The Version 2 of the AWS SDK for Ruby introduces a number of improvements including waiters, response paging, data-driven Resource APIs, streamlined plugin architecture, improved documentation, and more.

Version 2 consists of two separate gems: 'aws-sdk-core' and aws-sdk-resources'.

Gem 'aws-sdk-core'

The Core gem, 'aws-sdk-core', provides full one-to-one mapping to AWS APIs, in a RPC-style programming model. It also has a number of new built-in features such as automatic response paging, waiters, parameter validation, and Ruby type support in the Amazon DynamoDB client.

Gem 'aws-sdk-resources'

The Resources gem, 'aws-sdk-resources', provides an object-oriected abstraction over the "low-level" or RPC-style interface in the Core, for a simpler and more intuitive coding experience. A resource object is a reference to an AWS resource (such as an Amazon EC2 instance or an Amazon S3 object) that exposes the resource's attributes and actions as instance variables and methods. Supported services include Amazon EC2, Amazon S3, Amazon SNS, Amazon SQS, AWS IAM, Amazon Glacier, AWS OpsWorks, and AWS CloudFormation, and more services will continue to be added.

Download from GitHub »

Install the gem

gem install aws-sdk

or Add to Gemfile

gem 'aws-sdk', '~> 2'

Follow @awsforruby on Twitter

Find examples and more in the Developer Guide »

Connect with other developers in the Ruby Community Forum »

Learn the details of the latest SDK in the Release Notes »

Dig through the source code in the GitHub Repository »

Looking for the legacy version 1 of AWS SDK for Ruby?


Source on GitHub

Side-by-side usage