aws-sdk 1.8.5 → 1.9.0

data/lib/aws/cloud_watch/config.rb

@@ -13,6 +13,6 @@
 
 AWS::Core::Configuration.module_eval do
 
-  add_service 'CloudWatch', 'cloud_watch', 'monitoring.us-east-1.amazonaws.com'
+  add_service 'CloudWatch', 'cloud_watch', 'monitoring.%s.amazonaws.com'
 
 end

data/lib/aws/cloud_watch/metric.rb

@@ -17,7 +17,7 @@ require 'time'
 module AWS
   class CloudWatch
 
-    # = Metric
+    # # Metric
     #
     # Represents a single metric.
     #
@@ -26,8 +26,8 @@ module AWS
       # @param [String] namespace The metric namespace.
       # @param [String] metric_name The metric name.
       # @param [Hash] options
-      # @option options [Array<Hash>] :dimensions An array of dimensions.  
-      #   Each hash must have a +:name+ and a +value+ key (with string values).
+      # @option options [Array<Hash>] :dimensions An array of dimensions.
+      #   Each hash must have a `:name` and a `value` key (with string values).
       def initialize namespace, metric_name, options = {}
         @namespace = namespace
         @metric_name = metric_name
@@ -53,10 +53,10 @@ module AWS
 
       # Publishes metric data points to Amazon CloudWatch.
       # @param [Array<Hash>] metric_data An array of hashes.  Each hash
-      #   must pass +:value+ (number) or +:statistic_values+ (hash).
+      #   must pass `:value` (number) or `:statistic_values` (hash).
       # @return [nil]
       def put_data *metric_data
-        
+
         metric_opts = {}
         metric_opts[:metric_name] = metric_name
         metric_opts[:dimensions] = dimensions unless dimensions.empty?
@@ -74,17 +74,17 @@ module AWS
 
       # Gets statistics for this metric.
       #
-      #   metric = CloudWatch::Metric.new('my/namepace', 'metric-name')
+      #     metric = CloudWatch::Metric.new('my/namepace', 'metric-name')
       #
-      #   stats = metric.statistics(
-      #     :start_time => Time.now - 3600,
-      #     :end_time => Time.now,
-      #     :statistics => ['Average'])
+      #     stats = metric.statistics(
+      #       :start_time => Time.now - 3600,
+      #       :end_time => Time.now,
+      #       :statistics => ['Average'])
       #
-      #   stats.label #=> 'some-label'
-      #   stats.each do |datapoint|
-      #     # datapoint is a hash
-      #   end
+      #     stats.label #=> 'some-label'
+      #     stats.each do |datapoint|
+      #       # datapoint is a hash
+      #     end
       #
       # @param [Hash] options
       # @option options [Time,required] :start_time
@@ -111,7 +111,7 @@ module AWS
 
       end
 
-      # @return [Boolean] Returns +true+ if this metric exists.
+      # @return [Boolean] Returns `true` if this metric exists.
       def exists?
         !get_resource.data[:metrics].empty?
       end

data/lib/aws/cloud_watch/metric_alarm_collection.rb

@@ -14,32 +14,32 @@
 module AWS
   class CloudWatch
 
-    # = MetricAlarmCollection
+    # # MetricAlarmCollection
     #
     # Represents all alarms for a single metric.
     #
-    # == Getting an alarm by name
+    # ## Getting an alarm by name
     #
     # If you know the name of the alarm, you can get a reference using
     # the {#[]} method.
     #
-    #   metric.alarms['alarm-name']
+    #     metric.alarms['alarm-name']
     #
-    # == Enumerating Alarms
+    # ## Enumerating Alarms
     #
     # You can enumerate all alarms for a metric using each (or any of the
     # methods defined in {Core::Collection}).
     #
-    #   metric.alarms.each do |alarm|
-    #     puts alarm.name
-    #   end
+    #     metric.alarms.each do |alarm|
+    #       puts alarm.name
+    #     end
     #
-    # == Filtering Alarms
+    # ## Filtering Alarms
     #
     # Use one of the filtering methods to reduce the number of alarms
     # returned.
     #
-    #   metric.alarms.with_unit('Seconds').each {|alarm| ... }
+    #     metric.alarms.with_unit('Seconds').each {|alarm| ... }
     #
     class MetricAlarmCollection < AlarmCollection
 
@@ -80,15 +80,15 @@ module AWS
       #
       # @example Filtering by a 1 hour period
       #
-      #   metric.alarms.filter('period', 3600)
+      #     metric.alarms.filter('period', 3600)
       #
-      # @example Filtering by statistic 
+      # @example Filtering by statistic
       #
-      #   my_metric = metrics.filter('statistic', 'maximum')
+      #     my_metric = metrics.filter('statistic', 'maximum')
       #
       # @example Filtering by a unit
       #
-      #   metrics = metrics.filter('unit', 'Megabits')
+      #     metrics = metrics.filter('unit', 'Megabits')
       #
       # @param [String,Symbol] name
       # @param [String,Integer] value
@@ -100,7 +100,7 @@ module AWS
 
       # Returns a new collection that filters alarms by a period.
       #
-      #   metric.alarms.with_period(3600).each {|alarm| ... }
+      #     metric.alarms.with_period(3600).each {|alarm| ... }
       #
       # @param [Integer] period
       # @return [MetricAlarmCollection]
@@ -110,7 +110,7 @@ module AWS
 
       # Returns a new collection that filters alarms by a statistic.
       #
-      #   metric.alarms.with_statistic('Average').each {|alarm| ... }
+      #     metric.alarms.with_statistic('Average').each {|alarm| ... }
       #
       # @param [String] statistic
       # @return [MetricAlarmCollection]
@@ -120,7 +120,7 @@ module AWS
 
       # Returns a new collection that filters alarms by a unit.
       #
-      #   metric.alarms.with_unit('Percent').each {|alarm| ... }
+      #     metric.alarms.with_unit('Percent').each {|alarm| ... }
       #
       # @param [String] unit
       # @return [MetricAlarmCollection]
@@ -143,7 +143,7 @@ module AWS
 
           alarm = Alarm.new_from(
             :describe_alarms_for_metric,
-            details, 
+            details,
             details[:alarm_name],
             :config => config)
 

data/lib/aws/cloud_watch/metric_collection.rb

@@ -63,17 +63,17 @@ module AWS
 
       # Returns a collection filtered by the given dimension:
       #
-      #   metric = metrics.with_dimension('name', 'value').first
+      #     metric = metrics.with_dimension('name', 'value').first
       #
       # You can chain calls to #with_dimension.  Additional dimensions are
       # added.
       #
-      #   metrics = metrics.
-      #     with_dimension('d1', 'v1').
-      #     with_dimension('d2', 'v2').
-      #     with_dimension('d3', 'v3')
+      #     metrics = metrics.
+      #       with_dimension('d1', 'v1').
+      #       with_dimension('d2', 'v2').
+      #       with_dimension('d3', 'v3')
       #
-      #   metrics.each{|metric|} # filtered by all three dimensions
+      #     metrics.each{|metric|} # filtered by all three dimensions
       #
       # @param [String] name
       # @param [String] value
@@ -84,24 +84,24 @@ module AWS
 
       # Returns a collection filtered by the given dimensions.
       #
-      #   metrics.with_dimensions([
-      #     { :name => 'd1', :value => 'v1' },
-      #     { :name => 'd2', :value => 'v2' },
-      #     { :name => 'd3', :value => 'v3' },
-      #   ]).each do |metric|
-      #     # ...
-      #   end
+      #     metrics.with_dimensions([
+      #       { :name => 'd1', :value => 'v1' },
+      #       { :name => 'd2', :value => 'v2' },
+      #       { :name => 'd3', :value => 'v3' },
+      #     ]).each do |metric|
+      #       # ...
+      #     end
       #
       # Multiple calls to #with_dimensions will add to previous dimensions.
       # @param [Array<Hash>] dimensions An array of dimensions.  Each dimension
-      #   should be a Hash with a +:name+ and +:value+.
+      #   should be a Hash with a `:name` and `:value`.
       # @return [MetricCollection]
       def with_dimensions *dimensions
         dimensions = @filters[:dimensions] || []
         dimensions += dimensions.flatten
         filter(:dimensions, dimensions)
       end
-      
+
       protected
 
       def _each_item next_token, options = {}, &block
@@ -113,7 +113,7 @@ module AWS
         resp.data[:metrics].each do |details|
 
           metric = Metric.new_from(
-            :list_metrics, details, 
+            :list_metrics, details,
             details[:namespace],
             details[:metric_name],
             details.merge(:config => config))

data/lib/aws/cloud_watch/metric_statistics.rb

@@ -18,22 +18,22 @@ module AWS
     #
     # This class is an enumerable collection of data points.
     #
-    # == Enumerating Statistics
+    # ## Enumerating Statistics
     #
-    #   metric = CloudWatch::Metric.new('my/namepace', 'metric-name')
+    #     metric = CloudWatch::Metric.new('my/namepace', 'metric-name')
     #
-    #   stats = metric.statistics(
-    #     :start_time => Time.now - 3600,
-    #     :end_time => Time.now,
-    #     :statistics => ['Average'])
+    #     stats = metric.statistics(
+    #       :start_time => Time.now - 3600,
+    #       :end_time => Time.now,
+    #       :statistics => ['Average'])
     #
-    #   stats.label #=> 'some-label'
-    #   stats.each do |datapoint|
-    #     # datapoint is a hash
-    #   end
+    #     stats.label #=> 'some-label'
+    #     stats.each do |datapoint|
+    #       # datapoint is a hash
+    #     end
     #
     # @see Core::Collection
-    # 
+    #
     class MetricStatistics
 
       include Core::Collection::Simple

data/lib/aws/core.rb

@@ -12,19 +12,21 @@
 # language governing permissions and limitations under the License.
 
 require 'aws/version'
-require 'aws/core/autoloader'
 
 # 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
+# # 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}
@@ -33,25 +35,27 @@ require 'aws/core/autoloader'
 # * {AWS::ELB}
 # * {AWS::EMR}
 # * {AWS::Glacier}
-# * {AWS::OpsWorks}
 # * {AWS::IAM}
-# * {AWS::Redshift}
+# * {AWS::ImportExport}
+# * {AWS::OpsWorks}
 # * {AWS::RDS}
+# * {AWS::Redshift}
 # * {AWS::Route53}
 # * {AWS::S3}
-# * {AWS::SNS}
-# * {AWS::SQS}
-# * {AWS::STS}
 # * {AWS::SimpleDB}
 # * {AWS::SimpleEmailService}
 # * {AWS::SimpleWorkflow}
+# * {AWS::SNS}
+# * {AWS::SQS}
+# * {AWS::StorageGateway}
+# * {AWS::STS}
 #
-# = AWS::Record
+# # AWS::Record
 #
 # In addition to the above services, bundled is an ORM based on AWS services
 # See {AWS::Record} for more information.
 #
-# = Configuration
+# # Configuration
 #
 # You call {AWS.config} with a hash of options to configure your
 # access to the Amazon Web Services.
@@ -61,9 +65,10 @@ require 'aws/core/autoloader'
 #
 #    AWS.config(
 #      :access_key_id => 'ACCESS_KEY_ID',
-#      :secret_access_key => 'SECRET_ACCESS_KEY')
+#      :secret_access_key => 'SECRET_ACCESS_KEY',
+#      :region => 'us-west-2')
 #
-# == Rails
+# ## Rails
 #
 # If you are loading AWS inside a Rails web application, it is recommended to
 # place your configuration inside:
@@ -77,103 +82,127 @@ require 'aws/core/autoloader'
 #
 module AWS
 
-  register_autoloads(self) do
-    autoload :Errors, 'errors'
-  end
+  # @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',
+  }
+
+  # @private
+  ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..', '..'))
+
+  autoload :Errors, 'aws/errors'
 
   module Core
 
-    AWS.register_autoloads(self) do
-
-      autoload :AsyncHandle,               'async_handle'
-      autoload :Cacheable,                 'cacheable'
-      autoload :Client,                    'client'
-      autoload :Collection,                'collection'
-      autoload :Configuration,             'configuration'
-      autoload :CredentialProviders,       'credential_providers'
-      autoload :Data,                      'data'
-      autoload :IndifferentHash,           'indifferent_hash'
-      autoload :Inflection,                'inflection'
-      autoload :JSONParser,                'json_parser'
-
-      autoload :JSONClient,                'json_client'
-      autoload :JSONRequestBuilder,        'json_request_builder'
-      autoload :JSONResponseParser,        'json_response_parser'
-
-      autoload :LazyErrorClasses,          'lazy_error_classes'
-      autoload :LogFormatter,              'log_formatter'
-      autoload :MetaUtils,                 'meta_utils'
-      autoload :ManagedFile,               'managed_file'
-      autoload :Model,                     'model'
-      autoload :Naming,                    'naming'
-      autoload :OptionGrammar,             'option_grammar'
-      autoload :PageResult,                'page_result'
-      autoload :Policy,                    'policy'
-
-      autoload :QueryClient,               'query_client'
-      autoload :QueryRequestBuilder,       'query_request_builder'
-      autoload :QueryResponseParser,       'query_response_parser'
-
-      autoload :Resource,                  'resource'
-      autoload :ResourceCache,             'resource_cache'
-      autoload :Response,                  'response'
-      autoload :ResponseCache,             'response_cache'
-
-      autoload :RESTClient,                'rest_xml_client'
-      autoload :RESTJSONClient,            'rest_json_client'
-      autoload :RESTXMLClient,             'rest_xml_client'
-      autoload :RESTRequestBuilder,        'rest_request_builder'
-      autoload :RESTResponseParser,        'rest_response_parser'
-
-      autoload :ServiceInterface,          'service_interface'
-      autoload :Signer,                    'signer'
-      autoload :UriEscape,                 'uri_escape'
+    autoload :AsyncHandle, 'aws/core/async_handle'
+    autoload :Cacheable, 'aws/core/cacheable'
+    autoload :Client, 'aws/core/client'
+    autoload :Collection, 'aws/core/collection'
+    autoload :Configuration, 'aws/core/configuration'
+    autoload :CredentialProviders, 'aws/core/credential_providers'
+    autoload :Data, 'aws/core/data'
+    autoload :IndifferentHash, 'aws/core/indifferent_hash'
+    autoload :Inflection, 'aws/core/inflection'
+    autoload :JSONParser, 'aws/core/json_parser'
 
-    end
+    autoload :JSONClient, 'aws/core/json_client'
+    autoload :JSONRequestBuilder, 'aws/core/json_request_builder'
+    autoload :JSONResponseParser, 'aws/core/json_response_parser'
+
+    autoload :LazyErrorClasses, 'aws/core/lazy_error_classes'
+    autoload :LogFormatter, 'aws/core/log_formatter'
+    autoload :MetaUtils, 'aws/core/meta_utils'
+    autoload :ManagedFile, 'aws/core/managed_file'
+    autoload :Model, 'aws/core/model'
+    autoload :Naming, 'aws/core/naming'
+    autoload :OptionGrammar, 'aws/core/option_grammar'
+    autoload :PageResult, 'aws/core/page_result'
+    autoload :Policy, 'aws/core/policy'
+
+    autoload :QueryClient, 'aws/core/query_client'
+    autoload :QueryRequestBuilder, 'aws/core/query_request_builder'
+    autoload :QueryResponseParser, 'aws/core/query_response_parser'
+
+    autoload :Region, 'aws/core/region'
+    autoload :RegionCollection, 'aws/core/region_collection'
+
+    autoload :Resource, 'aws/core/resource'
+    autoload :ResourceCache, 'aws/core/resource_cache'
+    autoload :Response, 'aws/core/response'
+    autoload :ResponseCache, 'aws/core/response_cache'
+
+    autoload :RESTClient, 'aws/core/rest_xml_client'
+    autoload :RESTJSONClient, 'aws/core/rest_json_client'
+    autoload :RESTXMLClient, 'aws/core/rest_xml_client'
+    autoload :RESTRequestBuilder, 'aws/core/rest_request_builder'
+    autoload :RESTResponseParser, 'aws/core/rest_response_parser'
+
+    autoload :ServiceInterface, 'aws/core/service_interface'
+    autoload :Signer, 'aws/core/signer'
+    autoload :UriEscape, 'aws/core/uri_escape'
 
     module Options
-      AWS.register_autoloads(self) do
-        autoload :JSONSerializer, 'json_serializer'
-        autoload :XMLSerializer, 'xml_serializer'
-        autoload :Validator, 'validator'
-      end
+      autoload :JSONSerializer, 'aws/core/options/json_serializer'
+      autoload :XMLSerializer, 'aws/core/options/xml_serializer'
+      autoload :Validator, 'aws/core/options/validator'
     end
 
     module Signature
-      AWS.register_autoloads(self) do
-        autoload :Version2,      'version_2'
-        autoload :Version3,      'version_3'
-        autoload :Version3HTTPS, 'version_3_https'
-        autoload :Version4,      'version_4'
-      end
+      autoload :Version2, 'aws/core/signature/version_2'
+      autoload :Version3, 'aws/core/signature/version_3'
+      autoload :Version3HTTPS, 'aws/core/signature/version_3_https'
+      autoload :Version4, 'aws/core/signature/version_4'
     end
 
     module XML
-      AWS.register_autoloads(self) do
-        autoload :Parser,     'parser'
-        autoload :Grammar,    'grammar'
-        autoload :Stub,       'stub'
-        autoload :Frame,      'frame'
-        autoload :RootFrame,  'root_frame'
-        autoload :FrameStack, 'frame_stack'
-      end
+
+      autoload :Parser, 'aws/core/xml/parser'
+      autoload :Grammar, 'aws/core/xml/grammar'
+      autoload :Stub, 'aws/core/xml/stub'
+      autoload :Frame, 'aws/core/xml/frame'
+      autoload :RootFrame, 'aws/core/xml/root_frame'
+      autoload :FrameStack, 'aws/core/xml/frame_stack'
 
       module SaxHandlers
-        AWS.register_autoloads(self, 'aws/core/xml/sax_handlers') do
-          autoload :Nokogiri, 'nokogiri'
-          autoload :REXML,    'rexml'
-        end
+        autoload :Nokogiri, 'aws/core/xml/sax_handlers/nokogiri'
+        autoload :REXML, 'aws/core/xml/sax_handlers/rexml'
       end
 
     end
 
     module Http
-      AWS.register_autoloads(self) do
-        autoload :Handler,         'handler'
-        autoload :NetHttpHandler,  'net_http_handler'
-        autoload :Request,         'request'
-        autoload :Response,        'response'
-      end
+      autoload :ConnectionPool, 'aws/core/http/connection_pool'
+      autoload :Handler, 'aws/core/http/handler'
+      autoload :NetHttpHandler, 'aws/core/http/net_http_handler'
+      autoload :Request, 'aws/core/http/request'
+      autoload :Response, 'aws/core/http/response'
     end
 
   end
@@ -186,25 +215,24 @@ module AWS
     # The global configuration for AWS.  Generally you set your preferred
     # configuration operations once after loading the aws-sdk gem.
     #
-    #   AWS.config({
-    #     :access_key_id => 'ACCESS_KEY_ID',
-    #     :secret_access_key => 'SECRET_ACCESS_KEY',
-    #     :simple_db_endpoint => 'sdb.us-west-1.amazonaws.com',
-    #     :max_retries => 2,
-    #   })
+    #     AWS.config({
+    #       :access_key_id => 'ACCESS_KEY_ID',
+    #       :secret_access_key => 'SECRET_ACCESS_KEY',
+    #       :region => 'us-west-2',
+    #     })
     #
     # When using AWS classes they will always default to use configuration
     # values defined in {AWS.config}.
     #
-    #   AWS.config(:max_retries => 2)
+    #     AWS.config(:max_retries => 2)
     #
-    #   sqs = AWS::SQS.new
-    #   sqs.config.max_retries #=> 2
+    #     sqs = AWS::SQS.new
+    #     sqs.config.max_retries #=> 2
     #
     # If you want to change a configuration value for a single instance you
     # pass the new configuration value to that object's initializer:
     #
-    #   AWS::SQS.new(:max_retries => 0)
+    #     AWS::SQS.new(:max_retries => 0)
     #
     # @note Changing the global configuration does not affect objects
     #   that have already been constructed.
@@ -220,50 +248,36 @@ module AWS
     # @option options [String,nil] :session_token AWS secret token
     #   credential.
     #
-    # @option options [String] :auto_scaling_endpoint ('autoscaling.us-east-1.amazonaws.com')
-    #   The service endpoint for Auto Scaling.
-    #
-    # @option options [String] :cloud_formation_endpoint ('cloudformation.us-east-1.amazonaws.com')
-    #   The service endpoint for AWS CloudFormation.
-    #
-    # @option options [String] :cloud_front_endpoint ('cloudfront.amazonaws.com')
-    #   The service endpoint for Amazon CloudFront.
-    #
-    # @option options [String] :cloud_search ('cloudsearch.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon CloudSearch.
+    # @option options [String] :region ('us-east-1') The default AWS region.
     #
-    # @option options [String] :cloud_watch_endpoint ('monitoring.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon CloudWatch.
-    #
-    # @option options [Boolean] :dynamo_db_big_decimals (true) When +true+,
+    # @option options [Boolean] :dynamo_db_big_decimals (true) When `true`,
     #   {DynamoDB} will convert number values returned by {DynamoDB::Client}
-    #   from strings to BigDecimal objects.  If you set this to +false+,
+    #   from strings to BigDecimal objects.  If you set this to `false`,
     #   they will be converted from strings into floats (with a potential
     #   loss of precision).
     #
-    # @option options [String] :dynamo_db_endpoint ('dynamodb.amazonaws.com')
-    #   The service endpoint for Amazon DynamoDB.
-    #
     # @option options [Boolean] :dynamo_db_retry_throughput_errors (true) When
     #   true, AWS::DynamoDB::Errors::ProvisionedThroughputExceededException
     #   errors will be retried.
     #
-    # @option options [String] :ec2_endpoint ('ec2.amazonaws.com') The
-    #   service endpoint for Amazon EC2.
-    #
-    # @option options [String] :elasticache_endpoint ('elasticache.us-east-1.amazonaws.com')
-    #
-    # @option options [String] :elastic_beanstalk_endpoint ('elasticbeanstalk.us-east-1.amazonaws.com')
-    #   The service endpoint for AWS Elastic Beanstalk.
-    #
-    # @option options [String] :elastic_transcoder_endpoint ('elastictranscoder.us-east-1.amazonaws.com')
-    #   The service endpoint for Elastic Transcoder.
-    #
-    # @option options [String] :elb_endpoint ('elasticloadbalancing.us-east-1.amazonaws.com')
-    #   The service endpoint for Elastic Load Balancing.
-    #
-    # @option options [String] :glacier_endpoint ('glacier.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon Glacier.
+    # @option options [Float] :http_continue_timeout (1) The number of
+    #   seconds to wait for a "100-continue" response before sending the request
+    #   payload.  **This option has no effect unless the `:http_continue_threshold`
+    #   is configured to a positive integer and the payload exeedes the
+    #   threshold.** NOTE: currently there is a bug in Net::HTTP.
+    #   You must call `AWS.patch_net_http_100_continue!` for this feature to work.
+    #   Not supported in Ruby < 1.9.
+    #
+    # @option options [Integer,false] :http_continue_threshold (false) If a request
+    #   body exceedes the `:http_continue_threshold` size (in bytes), then
+    #   an "Expect" header will be added to the request with the value of
+    #   "100-continue".  This will cause the SDK to wait up to
+    #   `:http_continue_timeout` seconds for a 100 Contiue HTTP response
+    #   before sending the request payload.  By default, this feature
+    #   is disbled.  Set this option to a positive number of bytes
+    #   to enable 100 continues.  NOTE: currently there is a bug in Net::HTTP.
+    #   You must call `AWS.patch_net_http_100_continue!` for this feature to work.
+    #   Not supported in Ruby < 1.9.
     #
     # @option options [Object] :http_handler (AWS::Core::Http::NetHttpHandler)
     #   The http handler that sends requests to AWS.
@@ -273,55 +287,49 @@ module AWS
     #   longer be used.
     #
     # @option options [Integer] :http_open_timeout (15) The number of seconds
-    #   before the +:http_handler+ should timeout while trying to open a new
+    #   before the `:http_handler` should timeout while trying to open a new
     #   HTTP session.
     #
     # @option options [Integer] :http_read_timeout (60) The number of seconds
-    #   before the +:http_handler+ should timeout while waiting for a HTTP
+    #   before the `:http_handler` should timeout while waiting for a HTTP
     #   response.
     #
-    # @option options [Boolean] :http_wire_trace (false) When +true+, the
-    #   http handler will log all wire traces to the +:logger+.  If a
-    #   +:logger+ is not configured, then wire traces will be sent to
+    # @option options [Boolean] :http_wire_trace (false) When `true`, the
+    #   http handler will log all wire traces to the `:logger`.  If a
+    #   `:logger` is not configured, then wire traces will be sent to
     #   standard out.
     #
-    # @option options [String] :iam_endpoint ('iam.amazonaws.com') The
-    #   service endpoint for AWS Identity Access Management (IAM).
-    #
-    # @option options [String] :import_export_endpoint ('importexport.amazonaws.com')
-    #   The service endpoint for AWS Import/Export.
-    #
     # @option options [Logger,nil] :logger (nil) A logger to send
     #   log messages to.  Here is an example that logs to standard out.
     #
-    #     require 'logger'
-    #     AWS.config(:logger => Logger.new($stdout))
+    #       require 'logger'
+    #       AWS.config(:logger => Logger.new($stdout))
     #
     # @option options [Symbol] :log_level (:info) The level log messages are
-    #   sent to the logger with (e.g. +:notice+, +:info+, +:warn+,
-    #   +:debug+, etc).
+    #   sent to the logger with (e.g. `:notice`, `:info`, `:warn`,
+    #   `:debug`, etc).
     #
     # @option options [Object] :log_formatter The log formatter is responsible
     #   for building log messages from responses. You can quickly change
     #   log formats by providing a pre-configured log formatter.
     #
-    #     AWS.config(:log_formatter => AWS::Core::LogFormatter.colored)
+    #       AWS.config(:log_formatter => AWS::Core::LogFormatter.colored)
     #
     #   Here is a list of pre-configured log formatters:
     #
-    #   * +AWS::Core::LogFormatter.default+
-    #   * +AWS::Core::LogFormatter.short+
-    #   * +AWS::Core::LogFormatter.debug+
-    #   * +AWS::Core::LogFormatter.colored+
+    #     * `AWS::Core::LogFormatter.default`
+    #     * `AWS::Core::LogFormatter.short`
+    #     * `AWS::Core::LogFormatter.debug`
+    #     * `AWS::Core::LogFormatter.colored`
     #
     #   You can also create an instance of AWS::Core::LogFormatter
     #   with a custom log message pattern. See {Core::LogFormatter} for
     #   a complete list of pattern substitutions.
     #
-    #     pattern = "[AWS :operation :duration] :error_message"
-    #     AWS.config(:log_formatter => AWS::Core::LogFormatter.new(pattern))
+    #       pattern = "[AWS :operation :duration] :error_message"
+    #       AWS.config(:log_formatter => AWS::Core::LogFormatter.new(pattern))
     #
-    #   Lastly you can pass any object that responds to +#format+ accepting
+    #   Lastly you can pass any object that responds to `#format` accepting
     #   and instance of {Core::Response} and returns a string.
     #
     # @option options [Integer] :max_retries (3) The maximum number of times
@@ -333,25 +341,10 @@ module AWS
     #    to send service requests through.  You can pass a URI object or a
     #    URI string:
     #
-    #       AWS.config(:proxy_uri => 'https://user:password@my.proxy:443/path?query')
-    #
-    # @option options [String] :ops_works_endpoint ('opsworks.us-east-1.amazonaws.com')
-    #   The service endpoint for AWS OpsWorks.
-    #
-    # @option options [String] :redshift_endpoint ('redshift.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon Redshift.
-    #
-    # @option options [String] :rds_endpoint ('rds.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon Relational Database Service (RDS).
-    #
-    # @option options [String] :route_53_endpoint ('route53.amazonaws.com')
-    #   The service endpoint for Amazon Route 53.
-    #
-    # @option options [String] :s3_endpoint ('s3.amazonaws.com') The
-    #   service endpoint for Amazon S3.
+    #        AWS.config(:proxy_uri => 'https://user:password@my.proxy:443/path?query')
     #
     # @option options [Boolean] :s3_force_path_style (false) When
-    #   +true+, requests will always use path style.  This can be useful
+    #   `true`, requests will always use path style.  This can be useful
     #   for testing environments.
     #
     # @option options [Integer] :s3_multipart_max_parts (10000) The maximum
@@ -359,9 +352,9 @@ module AWS
     #
     # @option options [Integer] :s3_multipart_threshold (16777216) When
     #   uploading data to S3, if the number of bytes to send exceeds
-    #   +:s3_multipart_threshold+ then a multi part session is automatically
+    #   `:s3_multipart_threshold` then a multi part session is automatically
     #   started and the data is sent up in chunks.  The size of each part
-    #   is specified by +:s3_multipart_min_part_size+. Defaults to
+    #   is specified by `:s3_multipart_min_part_size`. Defaults to
     #   16777216 (16MB).
     #
     # @option options [Integer] :s3_multipart_min_part_size (5242880) The
@@ -370,18 +363,18 @@ module AWS
     #
     # @option options [Symbol] :s3_server_side_encryption (nil) The
     #   algorithm to use when encrypting object data on the server
-    #   side.  The only valid value is +:aes256+, which specifies that
+    #   side.  The only valid value is `:aes256`, which specifies that
     #   the object should be stored using the AES encryption algorithm
-    #   with 256 bit keys.  Defaults to +nil+, meaning server side
+    #   with 256 bit keys.  Defaults to `nil`, meaning server side
     #   encryption is not used unless specified on each individual
     #   call to upload an object.  This option controls the default
     #   behavior for the following methods:
     #
-    #   * {S3::S3Object#write}
-    #   * {S3::S3Object#multipart_upload}
-    #   * {S3::S3Object#copy_from} and {S3::S3Object#copy_to}
-    #   * {S3::S3Object#presigned_post}
-    #   * {S3::Bucket#presigned_post}
+    #     * {S3::S3Object#write}
+    #     * {S3::S3Object#multipart_upload}
+    #     * {S3::S3Object#copy_from} and {S3::S3Object#copy_to}
+    #     * {S3::S3Object#presigned_post}
+    #     * {S3::Bucket#presigned_post}
     #
     # @option options [OpenSSL::PKey::RSA, String] :s3_encryption_key (nil)
     #   If this is set, AWS::S3::S3Object #read and #write methods will always
@@ -390,23 +383,14 @@ module AWS
     #   means that client-side encryption will not be used.
     #
     # @option options [Symbol] :s3_encryption_materials_location (:metadata)
-    #   When set to +:instruction_file+, AWS::S3::S3Object will store
+    #   When set to `:instruction_file`, AWS::S3::S3Object will store
     #   encryption materials in a separate object, instead of the object
     #   metadata.
     #
-    # @option options [String] :simple_db_endpoint ('sdb.amazonaws.com')
-    #   The service endpoint for Amazon SimpleDB.
-    #
     # @option options [Boolean] :simple_db_consistent_reads (false) Determines
     #   if all SimpleDB read requests should be done consistently.
     #   Consistent reads are slower, but reflect all changes to SDB.
     #
-    # @option options [String] :simple_email_service_endpoint ('email.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon Simple Email Service.
-    #
-    # @option options [String] :simple_workflow_endpoint ('swf.us-east-1.amazonaws.com')
-    #   The service endpoint for Amazon Simple Workflow Service.
-    #
     # @option options [CredentialProviders::Provider] :credential_provider (AWS::Core::CredentialProviders::DefaultProvider.new)
     #   Returns the credential provider.  The default credential provider
     #   attempts to check for statically assigned credentials, ENV credentials
@@ -415,7 +399,7 @@ module AWS
     # @option options [String] :ssl_ca_file The path to a CA cert bundle in
     #   PEM format.
     #
-    #   If +:ssl_verify_peer+ is +true+ (the default) this bundle will be
+    #   If `:ssl_verify_peer` is `true` (the default) this bundle will be
     #   used to validate the server certificate in each HTTPS request.
     #   The AWS SDK for Ruby ships with a CA cert bundle, which is the
     #   default value for this option.
@@ -423,31 +407,19 @@ module AWS
     # @option options [String] :ssl_ca_path (nil)
     #   The path the a CA cert directory.
     #
-    # @option options [Boolean] :ssl_verify_peer (true) When +true+
+    # @option options [Boolean] :ssl_verify_peer (true) When `true`
     #   the HTTP handler validate server certificates for HTTPS requests.
     #
     #   This option should only be disabled for diagnostic purposes;
-    #   leaving this option set to +false+ exposes your application to
+    #   leaving this option set to `false` exposes your application to
     #   man-in-the-middle attacks and can pose a serious security
     #   risk.
     #
-    # @option options [Boolean] :stub_requests (false) When +true+ requests
+    # @option options [Boolean] :stub_requests (false) When `true` requests
     #   are not sent to AWS, instead empty responses are generated and
     #   returned to each service request.
     #
-    # @option options [String] :sns_endpoint ('sns.us-east-1.amazonaws.com') The
-    #   service endpoint for Amazon SNS.
-    #
-    # @option options [String] :sqs_endpoint ('sqs.us-east-1.amazonaws.com') The
-    #   service endpoint for Amazon SQS.
-    #
-    # @option options [String] :storage_gateway_endpoint ('storagegateway.us-east-1.amazonaws.com')
-    #   The service endpoint for AWS Storage Gateway.
-    #
-    # @option options [String] :sts_endpoint ('sts.amazonaws.com') The
-    #   service endpoint for AWS Security Token Service.
-    #
-    # @option options [Boolean] :use_ssl (true) When +true+, all requests
+    # @option options [Boolean] :use_ssl (true) When `true`, all requests
     #   to AWS are sent using HTTPS instead vanilla HTTP.
     #
     # @option options [String] :user_agent_prefix (nil) A string prefix to
@@ -462,6 +434,31 @@ module AWS
       @@config
     end
 
+    # Returns a collection that represents public (non-gov-cloud) AWS
+    # regions.  You can use this collection to get a specific region by name
+    # or to enumerate all regions.
+    #
+    # When enumerating regions, a single HTTP request is made to get a current
+    # list of regions (this is cached).  When getting a region by name
+    # no requests are made.
+    #
+    # @example Getting a region by name
+    #
+    #   region = AWS.regions['us-west-1']
+    #   region.dynamo_db.tables.map(&:name)
+    #
+    # @example Enumerating all regions
+    #
+    #   AWS.regions.each do |region|
+    #     puts "EC2 Instances in #{region.name}:"
+    #     puts region.ec2.instances.map(&:id)
+    #   end
+    #
+    # @return [Core::RegionCollection]
+    def regions
+      Core::RegionCollection.new
+    end
+
     # @note Memoization is currently only supported for the EC2 APIs;
     #   other APIs are unaffected by the status of memoization.  To
     #   protect your code from future changes in memoization support,
@@ -510,18 +507,18 @@ module AWS
     # For example, consider the following code to get the most
     # recently launched EC2 instance:
     #
-    #  latest = ec2.instances.sort_by(&:launch_time).last
+    #     latest = ec2.instances.sort_by(&:launch_time).last
     #
     # The above code would make N+1 requests (where N is the number of
     # instances in the account); iterating the collection of instances
-    # is one request, and +Enumerable#sort_by+ calls
+    # is one request, and `Enumerable#sort_by` calls
     # {AWS::EC2::Instance#launch_time} for each instance, causing
     # another request per instance.  We can rewrite the code as
     # follows to make only one request:
     #
-    #  latest = AWS.memoize do
-    #    ec2.instances.sort_by(&:launch_time).last
-    #  end
+    #     latest = AWS.memoize do
+    #       ec2.instances.sort_by(&:launch_time).last
+    #     end
     #
     # Iterating the collection still causes a request, but each
     # subsequent call to {AWS::EC2::Instance#launch_time} uses the
@@ -534,17 +531,17 @@ module AWS
     # relatively small numbers of requests.  The cached responses are
     # used in two ways while memoization is enabled:
     #
-    # 1. Before making a request, the SDK checks the cache for a
-    #    response to a request with the same signature (credentials,
-    #    service endpoint, operation name, and parameters).  If such a
-    #    response is found, it is used instead of making a new
-    #    request.
+    #   * Before making a request, the SDK checks the cache for a
+    #     response to a request with the same signature (credentials,
+    #     service endpoint, operation name, and parameters).  If such a
+    #     response is found, it is used instead of making a new
+    #     request.
     #
-    # 2. Before retrieving data for an attribute of a resource
-    #    (e.g. {AWS::EC2::Instance#launch_time}), the SDK attempts to
-    #    find a cached response that contains the requested data.  If
-    #    such a response is found, the cached data is returned instead
-    #    of making a new request.
+    #   * Before retrieving data for an attribute of a resource
+    #     (e.g. {AWS::EC2::Instance#launch_time}), the SDK attempts to
+    #     find a cached response that contains the requested data.  If
+    #     such a response is found, the cached data is returned instead
+    #     of making a new request.
     #
     # When memoization is disabled, all previously cached responses
     # are discarded.
@@ -583,5 +580,26 @@ module AWS
       nil
     end
 
+    # Eagerly loads all AWS classes/modules registered with autoload.
+    # @return [nil]
+    def eager_autoload! klass_or_module = AWS
+      klass_or_module.constants.each do |const_name|
+        if path = klass_or_module.autoload?(const_name)
+          require(path)
+          if const = klass_or_module.const_get(const_name) and const.is_a?(Module)
+            eager_autoload!(const)
+          end
+        end
+      end
+    end
+
+    # Patches Net::HTTP, fixing a bug in how it handles non 100-continue
+    # responses while waiting for a 100-continue.
+    def patch_net_http_100_continue!
+      require 'aws/core/http/patch'
+      AWS::Core::Http.patch_net_http_100_continue!
+      nil
+    end
+
   end
 end