Skip to content
Sample project to demonstrate usage of the AWS SDK for Ruby
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

AWS SDK for Ruby Sample Project

A simple Ruby application illustrating usage of the AWS SDK for Ruby (aws-sdk gem).


The only requirement of this application is Bundler. All other dependencies can be installed with:

bundle install

You can also install the SDK directly with:

gem install aws-sdk

Basic Configuration

You need to set up your AWS security credentials before the sample code is able to connect to AWS. You can do this by creating a file named "credentials" at ~/.aws/ (C:\Users\\ for Windows users) and saving the following lines in the file:

aws_access_key_id = <your access key id>
aws_secret_access_key = <your secret key>

See the Security Credentials page for more information on getting your keys.

Running the S3 sample

This sample application connects to Amazon's Simple Storage Service (S3), creates a bucket, and uploads a file to that bucket. The s3_sample.rb script will generate a unique bucket name for you as well as an object to upload. All you need to do is run it:

ruby s3_sample.rb

The S3 documentation has a good overview of the restrictions for bucket names for when you start making your own buckets.


This sample application is distributed under the Apache License, Version 2.0.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.