AWS SDK v2 for s3

Question

Can any one provide me a good documentation for uploading files to S3 using asw-sdk Version 2. I checked out the main doc and in v1 we used to do like

s3 = AWS::S3.new
obj = s3.buckets['my-bucket']

Now in v2 when I try as

s3 = Aws::S3::Client.new

am ending up with

Aws::Errors::MissingRegionError: missing region; use :region option or export region name to ENV['AWS_REGION']

Can anyone help me with this?

Answer 1

As per official documentation :

To use the Ruby SDK, you must configure a region and credentials.

Therefore,

s3 = Aws::S3::Client.new(region:'us-west-2')

Alternatively, a default region can be loaded from one of the following locations:

Aws.config[:region]
ENV['AWS_REGION']

Answer 2

Here's a complete S3 demo on aws v2 gem that worked for me:

Aws.config.update(
  region: 'us-east-1',
  credentials: Aws::Credentials.new(
    Figaro.env.s3_access_key_id,
    Figaro.env.s3_secret_access_key
  )
)
s3 = Aws::S3::Client.new
resp = s3.list_buckets
puts resp.buckets.map(&:name)

Gist

Official list of AWS region IDs here.

If you're unsure of the region, the best guess would be US Standard, which has the ID us-east-1 for config purposes, as shown above.

Answer 3

If you were using a aws.yml file for your credentials in Rails, you might want to create a file config/initializers/aws.rb with the following content:

filename = File.expand_path(File.join(Rails.root, "config", "aws.yml"))
config = YAML.load_file(filename)
aws_config = config[Rails.env.to_s].symbolize_keys

Aws.config.update({
                  region: aws_config[:region],
                  credentials: Aws::Credentials.new(aws_config[:access_key_id], aws_config[:secret_access_key])
              })

The config/aws.yml file would need to be adapter to include the region.

development: &development
  region: 'your region'
  access_key_id: 'your access key'
  secret_access_key: 'your secret access key'
production:
  <<: *development