What is aws-sdk-ruby?

The AWS SDK for Ruby is the official Ruby toolkit for talking to Amazon Web Services, built and maintained by AWS itself. If you write Ruby code and need your application to create S3 buckets, launch EC2 instances, or call almost any other AWS service, this library gives you a set of client objects, one per service, that turn ordinary Ruby method calls into API requests. Version 3 of the SDK is modular. Instead of installing one giant gem, you add only the service gems you actually use, such as aws-sdk-s3 or aws-sdk-ec2, which keeps your project smaller and your dependencies clearer. A combined aws-sdk gem bundling every service also exists, useful mainly if you are migrating from an older version or genuinely depend on many AWS services at once. Before making calls you configure two things: credentials and a region. The SDK can pick these up automatically from environment variables, from shared configuration files in your home directory, or from an instance profile when running on EC2 or in an ECS container. You can also set them directly in code through an Aws.config hash or when creating a specific client. The README repeatedly warns against committing credentials to source control and recommends loading them from an external source instead. Once a client is set up, each method maps to one AWS API operation and returns structured response data you work with as normal Ruby objects, for example listing S3 bucket names or object keys. For operations that return paged results, response objects can be iterated directly to walk through every page automatically, or you can step through pages yourself. The SDK also includes waiters, helper methods that poll AWS until a resource reaches a particular state, such as confirming an EC2 instance has finished starting up. This is core infrastructure tooling meant for Ruby developers already building on AWS, not a beginner's first project. Detailed API documentation, a developer guide, and a guide for upgrading from version 2 are all linked from the README for anyone getting started. The full README is longer than what was shown.