aws-sdk 1.9.1 → 1.9.2

data/README.md

@@ -0,0 +1,249 @@
+# AWS SDK for Ruby [![Build Status](https://travis-ci.org/aws/aws-sdk-ruby.png?branch=master)](https://travis-ci.org/aws/aws-sdk-ruby)
+
+The official AWS SDK for Ruby.
+
+## Installation
+
+You can install the AWS SDK for Ruby with rubygems:
+
+    gem install aws-sdk
+
+If you are using Bundler, we recommend that you express a major version
+dependency (aws-sdk follows [semantic versioning](http://semver.org/)):
+
+    gem 'aws-sdk', '~> 1.0'
+
+## Basic Configuration
+
+You need to provide your AWS security credentials and choose a default region.
+
+```ruby
+AWS.config(access_key_id: '...', secret_access_key: '...', region: 'us-west-2)
+```
+
+You can also specify these values via `ENV`:
+
+    export AWS_ACCESS_KEY_ID='...'
+    export AWS_SECRET_ACCESS_KEY='...'
+    export AWS_REGION='us-west-2'
+
+## Basic Usage
+
+Each service provides a service interface and a client.
+
+```
+ec2 = AWS.ec2 #=> AWS::EC2
+ec2.client #=> AWS::EC2::Client
+```
+
+The client provides one method for each API operation.  The client methods
+accept a hash of request params and return a response with a hash of
+response data. The service interfaces provide a higher level abstration built using the client.
+
+**Example: list instance tags using a client**
+
+```ruby
+resp = ec2.client.describe_tags(filters: [{ name: "resource-id", values: ["i-12345678"] }])
+resp[:tag_set].first
+#=> {:resource_id=>"i-12345678", :resource_type=>"instance", :key=>"role", :value=>"web"}
+```
+
+**Example: list instance tags using the AWS::EC2 higher level interface**
+
+```ruby
+ec2.instances['i-12345678'].tags.to_h
+#=> {"role"=>"web"}
+```
+
+See the [API Documentation](http://docs.aws.amazon.com/AWSRubySDK/latest/frames.html) for more examples.
+
+## Links of Interest
+
+* [API Documentation](http://docs.aws.amazon.com/AWSRubySDK/latest/frames.html)
+* [Release Notes](http://aws.amazon.com/releasenotes/Ruby)
+* [Issues](http://github.com/aws/aws-sdk-ruby/issues)
+* [Forums](https://forums.aws.amazon.com/forum.jspa?forumID=125)
+* [License](http://aws.amazon.com/apache2.0/)
+
+## Supported Services
+
+The SDK currently supports the following services:
+
+  <table class="supported-services" border="1">
+    <thead>
+      <th>Class</th>
+      <th>API Version</th>
+      <th>AWS Service Name</th>
+    </thead>
+    <tbody>
+      <tr>
+      <td>AWS::AutoScaling</td>
+      <td>2011-01-01</td>
+      <td>Auto Scaling</td>
+    </tr>
+    <tr>
+      <td>AWS::CloudFormation</td>
+      <td>2010-05-15</td>
+      <td>AWS CloudFormation</td>
+    </tr>
+    <tr>
+      <td>AWS::CloudFront</td>
+      <td>2012-07-01</td>
+      <td>Amazon CloudFront</td>
+    </tr>
+    <tr>
+      <td>AWS::CloudSearch</td>
+      <td>2011-02-01</td>
+      <td>Amazon CloudSearch</td>
+    </tr>
+    <tr>
+      <td>AWS::CloudWatch</td>
+      <td>2010-08-01</td>
+      <td>Amazon CloudWatch</td>
+    </tr>
+    <tr>
+      <td>AWS::DataPipeline</td>
+      <td>2012-10-29</td>
+      <td>AWS Data Pipeline</td>
+    </tr>
+    <tr>
+      <td>AWS::DirectConnect</td>
+      <td>2012-10-25</td>
+      <td>AWS Direct Connect</td>
+    </tr>
+    <tr>
+      <td rowspan="2">AWS::DynamoDB</td>
+      <td>2011-12-05</td>
+      <td rowspan="2">Amazon DynamoDB</td>
+    </tr>
+    <tr>
+      <td>2012-08-10</td>
+    </tr>
+    <tr>
+      <td>AWS::EC2</td>
+      <td>2013-02-01</td>
+      <td>Amazon Elastic Compute Cloud</td>
+    </tr>
+    <tr>
+      <td>AWS::ElastiCache</td>
+      <td>2012-11-15</td>
+      <td>Amazon ElastiCache</td>
+    </tr>
+    <tr>
+      <td>AWS::ElasticBeanstalk</td>
+      <td>2010-12-01</td>
+      <td>AWS Elastic Beanstalk</td>
+    </tr>
+    <tr>
+      <td>AWS::ElasticTranscoder</td>
+      <td>2012-09-25</td>
+      <td>Amazon Elastic Transcoder</td>
+    </tr>
+    <tr>
+      <td>AWS::ELB</td>
+      <td>2012-06-01</td>
+      <td>Elastic Load Balancing</td>
+    </tr>
+    <tr>
+      <td>AWS::EMR</td>
+      <td>2009-03-31</td>
+      <td>Amazon Elastic MapReduce</td>
+    </tr>
+    <tr>
+      <td>AWS::Glacier</td>
+      <td>2012-06-01</td>
+      <td>Amazon Glacier</td>
+    </tr>
+    <tr>
+      <td>AWS::IAM</td>
+      <td>2010-05-08</td>
+      <td>AWS Identity and Access Management</td>
+    </tr>
+    <tr>
+      <td>AWS::ImportExport</td>
+      <td>2010-06-01</td>
+      <td>AWS Import/Export</td>
+    </tr>
+    <tr>
+      <td>AWS::OpsWorks</td>
+      <td>2013-02-18</td>
+      <td>AWS OpsWorks</td>
+    </tr>
+    <tr>
+      <td>AWS::RDS</td>
+      <td>2013-02-12</td>
+      <td>Amazon Relational Database Service (Beta)</td>
+    </tr>
+    <tr>
+      <td>AWS::Redshift</td>
+      <td>2012-12-01</td>
+      <td>Amazon Redshift</td>
+    </tr>
+    <tr>
+      <td>AWS::Route53</td>
+      <td>2012-12-12</td>
+      <td>Amazon Route 53</td>
+    </tr>
+    <tr>
+      <td>AWS::S3</td>
+      <td>2006-03-01</td>
+      <td>Amazon Simple Storage Service</td>
+    </tr>
+    <tr>
+      <td>AWS::SimpleDB</td>
+      <td>2009-04-15</td>
+      <td>Amazon SimpleDB</td>
+    </tr>
+    <tr>
+      <td>AWS::SimpleEmailService</td>
+      <td>2010-12-01</td>
+      <td>Amazon Simple E-mail Service</td>
+    </tr>
+    <tr>
+      <td>AWS::SimpleWorkflow</td>
+      <td>2012-01-25</td>
+      <td>Amazon Simple Workflow Service</td>
+    </tr>
+    <tr>
+      <td>AWS::SNS</td>
+      <td>2010-03-31</td>
+      <td>Amazon Simple Notifications Service</td>
+    </tr>
+    <tr>
+      <td>AWS::SQS</td>
+      <td>2012-11-05</td>
+      <td>Amazon Simple Queue Service</td>
+    </tr>
+    <tr>
+      <td>AWS::StorageGateway</td>
+      <td>2012-06-30</td>
+      <td>AWS Storage Gateway</td>
+    </tr>
+    <tr>
+      <td>AWS::STS</td>
+      <td>2011-06-15</td>
+      <td>AWS Security Token Service</td>
+    </tr>
+    </tbody>
+  </table>
+
+## License
+
+This SDK is distributed under the
+[Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
+
+```no-highlight
+Copyright 2012. Amazon Web Services, Inc. All Rights Reserved.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```

data/lib/aws-sdk.rb

@@ -12,72 +12,4 @@
 # language governing permissions and limitations under the License.
 
 require 'aws/core'
-
-require 'aws/auto_scaling/config'
-require 'aws/cloud_formation/config'
-require 'aws/cloud_front/config'
-require 'aws/cloud_search/config'
-require 'aws/cloud_watch/config'
-require 'aws/data_pipeline/config'
-require 'aws/direct_connect/config'
-require 'aws/dynamo_db/config'
-require 'aws/ec2/config'
-require 'aws/elasticache/config'
-require 'aws/elastic_beanstalk/config'
-require 'aws/elastic_transcoder/config'
-require 'aws/elb/config'
-require 'aws/emr/config'
-require 'aws/glacier/config'
-require 'aws/iam/config'
-require 'aws/import_export/config'
-require 'aws/ops_works/config'
-require 'aws/rds/config'
-require 'aws/redshift/config'
-require 'aws/route_53/config'
-require 'aws/s3/config'
-require 'aws/simple_db/config'
-require 'aws/simple_email_service/config'
-require 'aws/simple_workflow/config'
-require 'aws/sns/config'
-require 'aws/sqs/config'
-require 'aws/storage_gateway/config'
-require 'aws/sts/config'
-
-module AWS
-
-  # services
-  autoload :AutoScaling, 'aws/auto_scaling'
-  autoload :CloudFormation, 'aws/cloud_formation'
-  autoload :CloudFront, 'aws/cloud_front'
-  autoload :CloudSearch, 'aws/cloud_search'
-  autoload :CloudWatch, 'aws/cloud_watch'
-  autoload :DataPipeline, 'aws/data_pipeline'
-  autoload :DirectConnect, 'aws/direct_connect'
-  autoload :DynamoDB, 'aws/dynamo_db'
-  autoload :EC2, 'aws/ec2'
-  autoload :ElastiCache, 'aws/elasticache'
-  autoload :ElasticBeanstalk, 'aws/elastic_beanstalk'
-  autoload :ElasticTranscoder, 'aws/elastic_transcoder'
-  autoload :ELB, 'aws/elb'
-  autoload :EMR, 'aws/emr'
-  autoload :Glacier, 'aws/glacier'
-  autoload :IAM, 'aws/iam'
-  autoload :ImportExport, 'aws/import_export'
-  autoload :OpsWorks, 'aws/ops_works'
-  autoload :RDS, 'aws/rds'
-  autoload :Redshift, 'aws/redshift'
-  autoload :Route53, 'aws/route_53'
-  autoload :S3, 'aws/s3'
-  autoload :SimpleDB, 'aws/simple_db'
-  autoload :SimpleEmailService, 'aws/simple_email_service'
-  autoload :SimpleWorkflow, 'aws/simple_workflow'
-  autoload :SNS, 'aws/sns'
-  autoload :SQS, 'aws/sqs'
-  autoload :StorageGateway, 'aws/storage_gateway'
-  autoload :STS, 'aws/sts'
-
-  autoload :Record, 'aws/record'
-
-end
-
 require 'aws/rails'

data/lib/aws/core.rb

@@ -16,48 +16,9 @@ require 'aws/version'
 # AWS is the root module for all of the Amazon Web Services.  It is also
 # where you can configure you access to AWS.
 #
-# # Supported Services
-#
-# The currently supported services are:
-#
-# * {AWS::AutoScaling}
-# * {AWS::CloudFormation}
-# * {AWS::CloudFront}
-# * {AWS::CloudSearch}
-# * {AWS::CloudWatch}
-# * {AWS::DataPipeline}
-# * {AWS::DirectConnect}
-# * {AWS::DynamoDB}
-# * {AWS::EC2}
-# * {AWS::ElastiCache}
-# * {AWS::ElasticBeanstalk}
-# * {AWS::ElasticTranscoder}
-# * {AWS::ELB}
-# * {AWS::EMR}
-# * {AWS::Glacier}
-# * {AWS::IAM}
-# * {AWS::ImportExport}
-# * {AWS::OpsWorks}
-# * {AWS::RDS}
-# * {AWS::Redshift}
-# * {AWS::Route53}
-# * {AWS::S3}
-# * {AWS::SimpleDB}
-# * {AWS::SimpleEmailService}
-# * {AWS::SimpleWorkflow}
-# * {AWS::SNS}
-# * {AWS::SQS}
-# * {AWS::StorageGateway}
-# * {AWS::STS}
-#
-# # AWS::Record
-#
-# In addition to the above services, bundled is an ORM based on AWS services
-# See {AWS::Record} for more information.
-#
 # # Configuration
 #
-# You call {AWS.config} with a hash of options to configure your
+# Call {AWS.config} with a hash of options to configure your
 # access to the Amazon Web Services.
 #
 # At a minimum you need to set your access credentials. See {AWS.config}
@@ -68,56 +29,108 @@ require 'aws/version'
 #      :secret_access_key => 'SECRET_ACCESS_KEY',
 #      :region => 'us-west-2')
 #
-# ## Rails
-#
-# If you are loading AWS inside a Rails web application, it is recommended to
-# place your configuration inside:
-#
-#   config/initializers/aws-sdk.rb
-#
-# Optionally you can create a Yaml configuration file at
-# RAILS_ROOT/config/aws.yml; This should be formatted in the same manor
-# as the default RAILS_ROOT/config/database.yml file (one section for
-# each Rails environment).
-#
 module AWS
 
   # @api private
   SERVICES = {
-    'AutoScaling' => 'auto_scaling',
-    'CloudFormation' => 'cloud_formation',
-    'CloudFront' => 'cloud_front',
-    'CloudSearch' => 'cloud_search',
-    'CloudWatch' => 'cloud_watch',
-    'DynamoDB' => 'dynamo_db',
-    'DataPipeline' => 'data_pipeline',
-    'EC2' => 'ec2',
-    'ElastiCache' => 'elasticache',
-    'ElasticBeanstalk' => 'elastic_beanstalk',
-    'ElasticTranscoder' => 'elastic_transcoder',
-    'ELB' => 'elb',
-    'EMR' => 'emr',
-    'Glacier' => 'glacier',
-    'IAM' => 'iam',
-    'ImportExport' => 'import_export',
-    'OpsWorks' => 'ops_works',
-    'RDS' => 'rds',
-    'Redshift' => 'redshift',
-    'Route53' => 'route_53',
-    'S3' => 's3',
-    'SimpleDB' => 'simple_db',
-    'SimpleEmailService' => 'simple_email_service',
-    'SimpleWorkflow' => 'simple_workflow',
-    'SNS' => 'sns',
-    'SQS' => 'sqs',
-    'StorageGateway' => 'storage_gateway',
-    'STS' => 'sts',
+    "CloudFront" => {
+      :full_name => "Amazon CloudFront",
+      :ruby_name => :cloud_front },
+    "CloudSearch" => {
+      :full_name => "Amazon CloudSearch",
+      :ruby_name => :cloud_search },
+    "CloudWatch" => {
+      :full_name => "Amazon CloudWatch",
+      :ruby_name => :cloud_watch },
+    "DynamoDB" => {
+      :full_name => "Amazon DynamoDB",
+      :ruby_name => :dynamo_db },
+    "EC2" => {
+      :full_name => "Amazon Elastic Compute Cloud",
+      :ruby_name => :ec2 },
+    "EMR" => {
+      :full_name => "Amazon Elastic MapReduce",
+      :ruby_name => :emr },
+    "ElastiCache" => {
+      :full_name => "Amazon ElastiCache",
+      :ruby_name => :elasticache },
+    "Glacier" => {
+      :full_name => "Amazon Glacier",
+      :ruby_name => :glacier },
+    "RDS" => {
+      :full_name => "Amazon Relational Database Service (Beta)",
+      :ruby_name => :rds },
+    "Route53" => {
+      :full_name => "Amazon Route 53",
+      :ruby_name => :route_53 },
+    "SimpleEmailService" => {
+      :full_name => "Amazon Simple E-mail Service",
+      :ruby_name => :simple_email_service },
+    "SNS" => {
+      :full_name => "Amazon Simple Notifications Service",
+      :ruby_name => :sns },
+    "SQS" => {
+      :full_name => "Amazon Simple Queue Service",
+      :ruby_name => :sqs },
+    "SimpleWorkflow" => {
+      :full_name => "Amazon Simple Workflow Service",
+      :ruby_name => :simple_workflow },
+    "SimpleDB" => {
+      :full_name => "Amazon SimpleDB",
+      :ruby_name => :simple_db },
+    "AutoScaling" => {
+      :full_name => "Auto Scaling",
+      :ruby_name => :auto_scaling },
+    "CloudFormation" => {
+      :full_name => "AWS CloudFormation",
+      :ruby_name => :cloud_formation },
+    "DataPipeline" => {
+      :full_name => "AWS Data Pipeline",
+      :ruby_name => :data_pipeline },
+    "DirectConnect" => {
+      :full_name => "AWS Direct Connect",
+      :ruby_name => :direct_connect },
+    "ElasticBeanstalk" => {
+      :full_name => "AWS Elastic Beanstalk",
+      :ruby_name => :elastic_beanstalk },
+    "IAM" => {
+      :full_name => "AWS Identity and Access Management",
+      :ruby_name => :iam },
+    "ImportExport" => {
+      :full_name => "AWS Import/Export",
+      :ruby_name => :import_export },
+    "OpsWorks" => {
+      :full_name => "AWS OpsWorks",
+      :ruby_name => :ops_works },
+    "STS" => {
+      :full_name => "AWS Security Token Service",
+      :ruby_name => :sts },
+    "StorageGateway" => {
+      :full_name => "AWS Storage Gateway",
+      :ruby_name => :storage_gateway },
+    "ELB" => {
+      :full_name => "Elastic Load Balancing",
+      :ruby_name => :elb },
+    "ElasticTranscoder" => {
+      :full_name => "Amazon Elastic Transcoder",
+      :ruby_name => :elastic_transcoder },
+    "Redshift" => {
+      :full_name => "Amazon Redshift",
+      :ruby_name => :redshift },
+    "S3" => {
+      :full_name => "Amazon Simple Storage Service",
+      :ruby_name => :s3 }
   }
 
   # @api private
   ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
 
+  SERVICES.each_pair do |klass,service|
+    autoload(klass, "aws/#{service[:ruby_name]}")
+  end
+
   autoload :Errors, 'aws/errors'
+  autoload :Record, 'aws/record'
 
   module Core
 
@@ -128,6 +141,7 @@ module AWS
     autoload :Configuration, 'aws/core/configuration'
     autoload :CredentialProviders, 'aws/core/credential_providers'
     autoload :Data, 'aws/core/data'
+    autoload :Deprecations, 'aws/core/deprecations'
     autoload :IndifferentHash, 'aws/core/indifferent_hash'
     autoload :Inflection, 'aws/core/inflection'
     autoload :JSONParser, 'aws/core/json_parser'
@@ -209,6 +223,99 @@ module AWS
 
   class << self
 
+    # @!method cloud_front
+    # @return [CloudFront]
+
+    # @!method cloud_search
+    # @return [CloudSearch]
+
+    # @!method cloud_watch
+    # @return [CloudWatch]
+
+    # @!method dynamo_db
+    # @return [DynamoDB]
+
+    # @!method ec2
+    # @return [EC2]
+
+    # @!method emr
+    # @return [EMR]
+
+    # @!method elasticache
+    # @return [ElastiCache]
+
+    # @!method glacier
+    # @return [Glacier]
+
+    # @!method rds
+    # @return [RDS]
+
+    # @!method route_53
+    # @return [Route53]
+
+    # @!method simple_email_service
+    # @return [SimpleEmailService]
+
+    # @!method sns
+    # @return [SNS]
+
+    # @!method sqs
+    # @return [SQS]
+
+    # @!method simple_workflow
+    # @return [SimpleWorkflow]
+
+    # @!method simple_db
+    # @return [SimpleDB]
+
+    # @!method auto_scaling
+    # @return [AutoScaling]
+
+    # @!method cloud_formation
+    # @return [CloudFormation]
+
+    # @!method data_pipeline
+    # @return [DataPipeline]
+
+    # @!method direct_connect
+    # @return [DirectConnect]
+
+    # @!method elastic_beanstalk
+    # @return [ElasticBeanstalk]
+
+    # @!method iam
+    # @return [IAM]
+
+    # @!method import_export
+    # @return [ImportExport]
+
+    # @!method ops_works
+    # @return [OpsWorks]
+
+    # @!method sts
+    # @return [STS]
+
+    # @!method storage_gateway
+    # @return [StorageGateway]
+
+    # @!method elb
+    # @return [ELB]
+
+    # @!method elastic_transcoder
+    # @return [ElasticTranscoder]
+
+    # @!method redshift
+    # @return [Redshift]
+
+    # @!method s3
+    # @return [S3]
+
+    SERVICES.each_pair do |klass,svc|
+      define_method(svc[:ruby_name]) do |*args|
+        AWS.const_get(klass).new(args.first || {})
+      end
+    end
+
     # @api private
     @@config = nil