Skip to content
This repository has been archived by the owner on Jun 22, 2023. It is now read-only.
/ amazon-pricing Public archive

A Ruby library for retrieving pricing for Amazon Web Services

License

Notifications You must be signed in to change notification settings

CloudHealth/amazon-pricing

Repository files navigation

DEPRECATED: Amazon Web Services Pricing Ruby Gem

⛔️ NOTICE OF FUTURE UPDATES TO THE GEM ⛔️

This project is no longer being maintained and will be deprecated in the future. Issues and pull requests will no longer be accepted. If you have scripts that utilize this project, consider using alternate libraries.

Amazon has updated the method it uses to provide pricing information to be an API; as such the methods contained within this Gem are no longer useful for obtaining pricing information.

Updates to the gem will be few and far between; please contact cht-aws-pricing-services@groups.vmware.com with any questions.

Information on Amazon's pricing api is available here: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/price-changes.html

No Maintenance Intended Test Report Gem Version Code Climate Code Coverage

About amazon-pricing

Amazon Web Services offers cloud-based on demand compute, storage and application services. Due to the number of services, and the number of pricing variables in each service, the pricing model is very complex. In addition, this pricing changes periodically. The amazon-pricing Ruby Gem is an interface library that simplifies the real-time retrieval of pricing information from Amazon.

For the most complete and up-to date README information please visit the project homepage at:

http://github.com/CloudHealth/amazon-pricing/tree/master

Installation

This gem follows the standard conventions for installation on any system with Ruby and RubyGems installed and uses Bundler for gem installation and build management.

Get an AWS account

Before you can make use of this gem you will need an Amazon Web Services account.

Install the amazon-pricing gem (Canonical Release)

This is the standard install for stable releases from RubyGems.

  • Install the gem: [sudo] gem install amazon-pricing

Install from local Git clone (for amazon-pricing developers)

To install from git for adding features or fixing bugs, you'll need to clone and build.

git clone git://github.com/CloudHealth/amazon-pricing.git
cd amazon-pricing
bundle install
rake test
rake build
rake install

Using amazon-pricing

The library exposes one main interface class AwsPricing::PriceList that allows you to retrieve pricing information from Amazon. The information is retrieved using undocumented json APIs - so has the potential to undergo change from time to time.

The following article provides a good introduction to using the gem:

http://www.hightechinthehub.com/2012/03/programmatically-retrieving-aws-pricing/

The Basics

The library exposes one main interface module

AwsPricing::PriceList

Additional Resources

Project Websites

Credits

Thanks for Amazon developers for provided JSON APIs to the pricing data (albeit undocumented).

Contact

Comments, patches, Git pull requests and bug reports are welcome. Send an email to mailto:joe.kinsella@gmail.com.

Patches & Pull Requests

Please follow these steps if you want to send a patch or a GitHub pull request:

  • Fork CloudHealth/amazon-pricing
  • Create a topic branch: git checkout -b my_fix
  • Make sure you add tests for your changes and that they all pass with 'rake test'
  • Don't change files that you don't own like the gemspec or version.rb
  • Commit your changes, one change/fix per commit
  • Push your fixes branch: git push origin my_fix
  • Open an Issue on GitHub referencing your branch and send a pull request.
  • Please do not push to master on your fork. Using a feature/bugfix branch will make everyone’s life easier.

Enjoy!

CloudHealth