aws-sdk 1.8.5 → 1.9.0

data/lib/aws/cloud_search/config.rb

@@ -13,6 +13,6 @@
 
 AWS::Core::Configuration.module_eval do
 
-  add_service 'CloudSearch', 'cloud_search', 'cloudsearch.us-east-1.amazonaws.com'
+  add_service 'CloudSearch', 'cloud_search', 'cloudsearch.%s.amazonaws.com'
 
 end

data/lib/aws/cloud_watch.rb

@@ -19,41 +19,41 @@ module AWS
   # This class is the starting point for working with Amazon CloudWatch.
   #
   # To use Amazon CloudWatch you must first
-  # {sign up here}[http://aws.amazon.com/cloudwatch/].
+  # [sign up here](http://aws.amazon.com/cloudwatch/).
   #
   # For more information about Amazon CloudWatch:
   #
-  # * {Amazon CloudWatch}[http://aws.amazon.com/cloudwatch/]
-  # * {Amazon CloudWatch Documentation}[http://aws.amazon.com/documentation/cloudwatch/]
+  # * [Amazon CloudWatch](http://aws.amazon.com/cloudwatch/)
+  # * [Amazon CloudWatch Documentation](http://aws.amazon.com/documentation/cloudwatch/)
   #
-  # = Credentials
+  # # Credentials
   #
   # You can setup default credentials for all AWS services via
   # AWS.config:
   #
-  #   AWS.config(
-  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
-  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #     AWS.config(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
   #
   # Or you can set them directly on the AWS::Route53 interface:
   #
-  #   cw = AWS::CloudWatch.new(
-  #     :access_key_id => 'YOUR_ACCESS_KEY_ID',
-  #     :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
+  #     cw = AWS::CloudWatch.new(
+  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
+  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
   #
-  # = Using the Client
+  # # Using the Client
   #
   # AWS::CloudWatch does not provide higher level abstractions for CloudWatch at
   # this time.  You can still access all of the API methods using
   # {AWS::CloudWatch::Client}.  Here is how you access the client and make
   # a simple request:
   #
-  #   cw = AWS::CloudWatch.new
+  #     cw = AWS::CloudWatch.new
   #
-  #   resp = cw.client.describe_alarms
-  #   resp[:metric_alarms].each do |alarm|
-  #     puts alarm[:alarm_name]
-  #   end
+  #     resp = cw.client.describe_alarms
+  #     resp[:metric_alarms].each do |alarm|
+  #       puts alarm[:alarm_name]
+  #     end
   #
   # See {Client} for documentation on all of the supported operations.
   #
@@ -61,35 +61,35 @@ module AWS
   #   @return [Client] the low-level CloudWatch client object
   class CloudWatch
 
-    AWS.register_autoloads(self, 'aws/cloud_watch') do
-      autoload :Alarm, 'alarm'
-      autoload :AlarmCollection, 'alarm_collection'
-      autoload :AlarmHistoryItem, 'alarm_history_item'
-      autoload :AlarmHistoryItemCollection, 'alarm_history_item_collection'
-      autoload :Client, 'client'
-      autoload :Errors, 'errors'
-      autoload :Metric, 'metric'
-      autoload :MetricCollection, 'metric_collection'
-      autoload :MetricAlarmCollection, 'metric_alarm_collection'
-      autoload :MetricStatistics, 'metric_statistics'
-      autoload :Request, 'request'
-    end
+    autoload :Alarm, 'aws/cloud_watch/alarm'
+    autoload :AlarmCollection, 'aws/cloud_watch/alarm_collection'
+    autoload :AlarmHistoryItem, 'aws/cloud_watch/alarm_history_item'
+    autoload :AlarmHistoryItemCollection, 'aws/cloud_watch/alarm_history_item_collection'
+    autoload :Client, 'aws/cloud_watch/client'
+    autoload :Errors, 'aws/cloud_watch/errors'
+    autoload :Metric, 'aws/cloud_watch/metric'
+    autoload :MetricCollection, 'aws/cloud_watch/metric_collection'
+    autoload :MetricAlarmCollection, 'aws/cloud_watch/metric_alarm_collection'
+    autoload :MetricStatistics, 'aws/cloud_watch/metric_statistics'
+    autoload :Request, 'aws/cloud_watch/request'
 
     include Core::ServiceInterface
 
+    endpoint_prefix 'monitoring'
+
     # Puts data for a metric.  The metric is created if it does not already
     # exist.
     #
-    #   cw.put_metric_data(
-    #     :namespace => 'test/cli',
-    #     :metric_data => [
-    #       { :metric_name => 'sample', :value => 1 },
-    #       { :metric_name => 'sample', :value => 2 },
-    #       { :metric_name => 'sample', :value => 3 },
-    #       { :metric_name => 'sample', :value => 4 },
-    #       { :metric_name => 'sample', :value => 5 },
-    #     ]
-    #   )
+    #     cw.put_metric_data(
+    #       :namespace => 'test/cli',
+    #       :metric_data => [
+    #         { :metric_name => 'sample', :value => 1 },
+    #         { :metric_name => 'sample', :value => 2 },
+    #         { :metric_name => 'sample', :value => 3 },
+    #         { :metric_name => 'sample', :value => 4 },
+    #         { :metric_name => 'sample', :value => 5 },
+    #       ]
+    #     )
     #
     # @param [Hash] options
     # @see Client#put_metric_data

data/lib/aws/cloud_watch/alarm.rb

@@ -20,11 +20,11 @@ module AWS
     #
     # @attr_reader [Array<Hash>] dimensions
     #
-    # @attr_reader [Boolean] enabled Indicates whether actions 
+    # @attr_reader [Boolean] enabled Indicates whether actions
     #   should be executed during any changes to the alarm's state.
     #
-    # @attr_reader [Array<String>] alarm_actions The list of actions to execute 
-    #   when this alarm transitions into an ALARM state from any other 
+    # @attr_reader [Array<String>] alarm_actions The list of actions to execute
+    #   when this alarm transitions into an ALARM state from any other
     #   state.
     #
     # @attr_reader [String] arn The Amazon Resource Name (ARN) of the alarm.
@@ -34,11 +34,11 @@ module AWS
     #
     # @attr_reader [String] description The description for the alarm.
     #
-    # @attr_reader [String] comparison_operator The arithmetic operation to 
-    #   use when comparing the specified Statistic and Threshold. The 
+    # @attr_reader [String] comparison_operator The arithmetic operation to
+    #   use when comparing the specified Statistic and Threshold. The
     #   specified Statistic value is used as the first operand.
     #
-    # @attr_reader [Integer] evaluation_periods The number of periods over 
+    # @attr_reader [Integer] evaluation_periods The number of periods over
     #   which data is compared to the specified threshold.
     #
     # @attr_reader [Array<Hash>] insufficient_data_actions The list of
@@ -48,7 +48,7 @@ module AWS
     # @attr_reader [Array<Hash>] ok_actions The list of actions to execute
     #   when this alarm transitions into an OK state.
     #
-    # @attr_reader [Integer] period The period in seconds over which the 
+    # @attr_reader [Integer] period The period in seconds over which the
     #   statistic is applied.
     #
     # @attr_reader [String] state_reason A human-readable explanation for
@@ -102,7 +102,7 @@ module AWS
 
       attribute :alarm_configuration_updated_timestamp
 
-      alias_method :configuration_updated_timestamp, 
+      alias_method :configuration_updated_timestamp,
         :alarm_configuration_updated_timestamp
 
       attribute :alarm_description
@@ -152,50 +152,63 @@ module AWS
       # Updates the metric alarm.
       #
       # @option options [String,required] :comparison_operator The arithmetic
-      #   operation to use when comparing the specified Statistic and 
-      #   Threshold. The specified Statistic value is used as the first 
+      #   operation to use when comparing the specified Statistic and
+      #   Threshold. The specified Statistic value is used as the first
       #   operand.  Valid values include:
-      #   * 'GreaterThanOrEqualToThreshold'
-      #   * 'GreaterThanThreshold'
-      #   * 'LessThanThreshold'
-      #   * 'LessThanOrEqualToThreshold'
-      # @option options [Integer,required] :evaluation_periods The number 
+      #
+      #     * 'GreaterThanOrEqualToThreshold'
+      #     * 'GreaterThanThreshold'
+      #     * 'LessThanThreshold'
+      #     * 'LessThanOrEqualToThreshold'
+      #
+      # @option options [Integer,required] :evaluation_periods The number
       #   of periods over which data is compared to the specified threshold.
-      # @option options [Integer,required] :period The period in seconds 
+      #
+      # @option options [Integer,required] :period The period in seconds
       #   over which the specified statistic is applied.
-      # @option options [String,required] :statistic The statistic to apply 
+      #
+      # @option options [String,required] :statistic The statistic to apply
       #   to the alarm's associated metric. Valid values include:
-      #   * 'SampleCount'
-      #   * 'Average'
-      #   * 'Sum'
-      #   * 'Minimum'
-      #   * 'Maximum'
+      #
+      #     * 'SampleCount'
+      #     * 'Average'
+      #     * 'Sum'
+      #     * 'Minimum'
+      #     * 'Maximum'
+      #
       # @option options [Number,required] :threshold The value against which
       #   the specified statistic is compared.
+      #
       # @option options [Array<String>] :insufficient_data_actions
-      #   The list of actions to execute when this alarm transitions into an 
-      #   INSUFFICIENT_DATA state from any other state. Each action is 
-      #   specified as an Amazon Resource Number (ARN). Currently the only 
-      #   action supported is publishing to an Amazon SNS topic or an 
+      #   The list of actions to execute when this alarm transitions into an
+      #   INSUFFICIENT_DATA state from any other state. Each action is
+      #   specified as an Amazon Resource Number (ARN). Currently the only
+      #   action supported is publishing to an Amazon SNS topic or an
       #   Amazon Auto Scaling policy.
+      #
       # @option options [Array<String>] :ok_actions The list of actions to
       #   execute when this alarm transitions into an OK state from any
       #   other state. Each action is specified as an Amazon Resource
       #   Number (ARN). Currently the only action supported is publishing to
       #   an Amazon SNS topic or an Amazon Auto Scaling policy.
-      # @option options [Boolean] :actions_enabled Indicates whether or not 
-      #   actions should be executed during any changes to the alarm's 
+      #
+      # @option options [Boolean] :actions_enabled Indicates whether or not
+      #   actions should be executed during any changes to the alarm's
       #   state.
-      # @option options [Array<String>] :alarm_actions The list of actions 
-      #   to execute when this alarm transitions into an ALARM state from 
-      #   any other state. Each action is specified as an Amazon Resource 
-      #   Number (ARN). Currently the only action supported is publishing 
+      #
+      # @option options [Array<String>] :alarm_actions The list of actions
+      #   to execute when this alarm transitions into an ALARM state from
+      #   any other state. Each action is specified as an Amazon Resource
+      #   Number (ARN). Currently the only action supported is publishing
       #   to an Amazon SNS topic or an Amazon Auto Scaling policy.
       #   Maximum of 5 alarm actions.
-      # @option options [String] :alarm_description The description for 
+      #
+      # @option options [String] :alarm_description The description for
       #   the alarm.
-      # @option options [String] :unit The unit for the alarm's associated 
+      #
+      # @option options [String] :unit The unit for the alarm's associated
       #   metric.
+      #
       # @return [nil]
       def update options = {}
         options[:alarm_name] = alarm_name
@@ -238,16 +251,21 @@ module AWS
       alias_method :histories, :history_items
 
       # Temporarily sets the state of current alarm.
-      # @param [String] reason The reason that this alarm is set to this 
+      # @param [String] reason The reason that this alarm is set to this
       #   specific state (in human-readable text format).
+      #
       # @param [String] value Valid values include:
+      #
       #   * 'OK'
       #   * 'ALARM'
       #   * 'INSUFFICIENT_DATA'
+      #
       # @param [Hash] options
-      # @option options [String] :state_reason_data The reason that this 
-      #   alarm is set to this specific state (in machine-readable JSON 
+      # @option options [String] :state_reason_data The reason that this
+      #
+      #   alarm is set to this specific state (in machine-readable JSON
       #   format)
+      #
       # @return [nil]
       def set_state reason, value, options = {}
         options[:alarm_name] = alarm_name

data/lib/aws/cloud_watch/alarm_collection.rb

@@ -14,33 +14,33 @@
 module AWS
   class CloudWatch
 
-    # = AlarmCollection
-    # 
+    # # AlarmCollection
+    #
     # Represents alarms for an AWS account.
     #
-    # == 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.
     #
-    #   cw = AWS::CloudWatch.new
-    #   alarm = cw.alarms['alarm-name']
+    #     cw = AWS::CloudWatch.new
+    #     alarm = cw.alarms['alarm-name']
     #
-    # == Enumerating Alarms
+    # ## Enumerating Alarms
     #
     # You can enumerate all alarms using each (or any of the
     # methods defined in {Core::Collection}).
     #
-    #   cw.alarms.each do |alarm|
-    #     puts alarm.name
-    #   end
+    #     cw.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.
     #
-    #   cw.alarms.with_name_prefix('some-prefix-').each {|alarm| ... }
+    #     cw.alarms.with_name_prefix('some-prefix-').each {|alarm| ... }
     #
     class AlarmCollection
 
@@ -59,16 +59,16 @@ module AWS
 
       # Creates an alarm and associates it with the specified metric.
       #
-      # @param [String] alarm_name The descriptive name for the alarm. 
+      # @param [String] alarm_name The descriptive name for the alarm.
       #   This name must be unique within the user's AWS account.
       # @param [Hash] options
-      # @option options [String,required] :namespace The namespace for the 
+      # @option options [String,required] :namespace The namespace for the
       #   alarm's associated metric.
-      # @option options [String,required] :metric_name The name for the 
+      # @option options [String,required] :metric_name The name for the
       #   alarm's associated metric.
-      # @option options [Array<Hash>] :dimensions The dimensions for the 
+      # @option options [Array<Hash>] :dimensions The dimensions for the
       #   alarm's associated metric.  Each dimension must specify a
-      #   +:name+ and a +:value+.
+      #   `:name` and a `:value`.
       # @option (see Alarm#update)
       # @return [Alarm]
       def create alarm_name, options = {}
@@ -79,7 +79,7 @@ module AWS
 
       # Delete one or more alarms by name.
       #
-      #   cloud_watch.alarms.delete('alarm1', 'alarm2')
+      #     cloud_watch.alarms.delete('alarm1', 'alarm2')
       #
       # @param [String,Array<String>] alarm_names
       # @return [nil]
@@ -136,7 +136,7 @@ module AWS
 
           alarm = Alarm.new_from(
             :describe_alarms,
-            details, 
+            details,
             details[:alarm_name],
             :config => config)
 

data/lib/aws/cloud_watch/alarm_history_item_collection.rb

@@ -63,14 +63,14 @@ module AWS
       protected
 
       def _each_item next_token, limit, options = {}, &block
-        
+
         options = @filters.merge(options)
         options[:max_records] = limit if limit
         options[:next_token] = next_token if next_token
 
         resp = client.describe_alarm_history(options)
         resp.data[:alarm_history_items].each do |details|
-          
+
           yield(AlarmHistoryItem.new(details))
 
         end

data/lib/aws/cloud_watch/client.rb

@@ -30,212 +30,426 @@ module AWS
       # @!method delete_alarms(options = {})
       # Calls the DeleteAlarms API operation.
       # @param [Hash] options
-      #   * +:alarm_names+ - *required* - (Array<String>)
+      #   * `:alarm_names` - *required* - (Array<String>) A list of alarms to
+      #     be deleted.
       # @return [Core::Response]
 
       # @!method describe_alarm_history(options = {})
       # Calls the DescribeAlarmHistory API operation.
       # @param [Hash] options
-      #   * +:alarm_name+ - (String)
-      #   * +:history_item_type+ - (String)
-      #   * +:start_date+ - (String<ISO8601 datetime>)
-      #   * +:end_date+ - (String<ISO8601 datetime>)
-      #   * +:max_records+ - (Integer)
-      #   * +:next_token+ - (String)
+      #   * `:alarm_name` - (String) The name of the alarm.
+      #   * `:history_item_type` - (String) The type of alarm histories to
+      #     retrieve. Valid values include:
+      #     * `ConfigurationUpdate`
+      #     * `StateUpdate`
+      #     * `Action`
+      #   * `:start_date` - (String<ISO8601 datetime>) The starting date to
+      #     retrieve alarm history.
+      #   * `:end_date` - (String<ISO8601 datetime>) The ending date to
+      #     retrieve alarm history.
+      #   * `:max_records` - (Integer) The maximum number of alarm history
+      #     records to retrieve.
+      #   * `:next_token` - (String) The token returned by a previous call to
+      #     indicate that there is more data available.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:alarm_history_items+ - (Array<Hash>)
-      #     * +:alarm_name+ - (String)
-      #     * +:timestamp+ - (Time)
-      #     * +:history_item_type+ - (String)
-      #     * +:history_summary+ - (String)
-      #     * +:history_data+ - (String)
-      #   * +:next_token+ - (String)
+      #   * `:alarm_history_items` - (Array<Hash>)
+      #     * `:alarm_name` - (String)
+      #     * `:timestamp` - (Time)
+      #     * `:history_item_type` - (String)
+      #     * `:history_summary` - (String)
+      #     * `:history_data` - (String)
+      #   * `:next_token` - (String)
 
       # @!method describe_alarms(options = {})
       # Calls the DescribeAlarms API operation.
       # @param [Hash] options
-      #   * +:alarm_names+ - (Array<String>)
-      #   * +:alarm_name_prefix+ - (String)
-      #   * +:state_value+ - (String)
-      #   * +:action_prefix+ - (String)
-      #   * +:max_records+ - (Integer)
-      #   * +:next_token+ - (String)
+      #   * `:alarm_names` - (Array<String>) A list of alarm names to retrieve
+      #     information for.
+      #   * `:alarm_name_prefix` - (String) The alarm name prefix. AlarmNames
+      #     cannot be specified if this parameter is specified.
+      #   * `:state_value` - (String) The state value to be used in matching
+      #     alarms. Valid values include:
+      #     * `OK`
+      #     * `ALARM`
+      #     * `INSUFFICIENT_DATA`
+      #   * `:action_prefix` - (String) The action name prefix.
+      #   * `:max_records` - (Integer) The maximum number of alarm descriptions
+      #     to retrieve.
+      #   * `:next_token` - (String) The token returned by a previous call to
+      #     indicate that there is more data available.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:metric_alarms+ - (Array<Hash>)
-      #     * +:alarm_name+ - (String)
-      #     * +:alarm_arn+ - (String)
-      #     * +:alarm_description+ - (String)
-      #     * +:alarm_configuration_updated_timestamp+ - (Time)
-      #     * +:actions_enabled+ - (Boolean)
-      #     * +:ok_actions+ - (Array<String>)
-      #     * +:alarm_actions+ - (Array<String>)
-      #     * +:insufficient_data_actions+ - (Array<String>)
-      #     * +:state_value+ - (String)
-      #     * +:state_reason+ - (String)
-      #     * +:state_reason_data+ - (String)
-      #     * +:state_updated_timestamp+ - (Time)
-      #     * +:metric_name+ - (String)
-      #     * +:namespace+ - (String)
-      #     * +:statistic+ - (String)
-      #     * +:dimensions+ - (Array<Hash>)
-      #       * +:name+ - (String)
-      #       * +:value+ - (String)
-      #     * +:period+ - (Integer)
-      #     * +:unit+ - (String)
-      #     * +:evaluation_periods+ - (Integer)
-      #     * +:threshold+ - (Numeric)
-      #     * +:comparison_operator+ - (String)
-      #   * +:next_token+ - (String)
+      #   * `:metric_alarms` - (Array<Hash>)
+      #     * `:alarm_name` - (String)
+      #     * `:alarm_arn` - (String)
+      #     * `:alarm_description` - (String)
+      #     * `:alarm_configuration_updated_timestamp` - (Time)
+      #     * `:actions_enabled` - (Boolean)
+      #     * `:ok_actions` - (Array<String>)
+      #     * `:alarm_actions` - (Array<String>)
+      #     * `:insufficient_data_actions` - (Array<String>)
+      #     * `:state_value` - (String)
+      #     * `:state_reason` - (String)
+      #     * `:state_reason_data` - (String)
+      #     * `:state_updated_timestamp` - (Time)
+      #     * `:metric_name` - (String)
+      #     * `:namespace` - (String)
+      #     * `:statistic` - (String)
+      #     * `:dimensions` - (Array<Hash>)
+      #       * `:name` - (String)
+      #       * `:value` - (String)
+      #     * `:period` - (Integer)
+      #     * `:unit` - (String)
+      #     * `:evaluation_periods` - (Integer)
+      #     * `:threshold` - (Numeric)
+      #     * `:comparison_operator` - (String)
+      #   * `:next_token` - (String)
 
       # @!method describe_alarms_for_metric(options = {})
       # Calls the DescribeAlarmsForMetric API operation.
       # @param [Hash] options
-      #   * +:metric_name+ - *required* - (String)
-      #   * +:namespace+ - *required* - (String)
-      #   * +:statistic+ - (String)
-      #   * +:dimensions+ - (Array<Hash>)
-      #     * +:name+ - *required* - (String)
-      #     * +:value+ - *required* - (String)
-      #   * +:period+ - (Integer)
-      #   * +:unit+ - (String)
+      #   * `:metric_name` - *required* - (String) The name of the metric.
+      #   * `:namespace` - *required* - (String) The namespace of the metric.
+      #   * `:statistic` - (String) The statistic for the metric. Valid values
+      #     include:
+      #     * `SampleCount`
+      #     * `Average`
+      #     * `Sum`
+      #     * `Minimum`
+      #     * `Maximum`
+      #   * `:dimensions` - (Array<Hash>) The list of dimensions associated
+      #     with the metric.
+      #     * `:name` - *required* - (String) The name of the dimension.
+      #     * `:value` - *required* - (String) The value representing the
+      #       dimension measurement
+      #   * `:period` - (Integer) The period in seconds over which the
+      #     statistic is applied.
+      #   * `:unit` - (String) The unit for the metric. Valid values include:
+      #     * `Seconds`
+      #     * `Microseconds`
+      #     * `Milliseconds`
+      #     * `Bytes`
+      #     * `Kilobytes`
+      #     * `Megabytes`
+      #     * `Gigabytes`
+      #     * `Terabytes`
+      #     * `Bits`
+      #     * `Kilobits`
+      #     * `Megabits`
+      #     * `Gigabits`
+      #     * `Terabits`
+      #     * `Percent`
+      #     * `Count`
+      #     * `Bytes/Second`
+      #     * `Kilobytes/Second`
+      #     * `Megabytes/Second`
+      #     * `Gigabytes/Second`
+      #     * `Terabytes/Second`
+      #     * `Bits/Second`
+      #     * `Kilobits/Second`
+      #     * `Megabits/Second`
+      #     * `Gigabits/Second`
+      #     * `Terabits/Second`
+      #     * `Count/Second`
+      #     * `None`
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:metric_alarms+ - (Array<Hash>)
-      #     * +:alarm_name+ - (String)
-      #     * +:alarm_arn+ - (String)
-      #     * +:alarm_description+ - (String)
-      #     * +:alarm_configuration_updated_timestamp+ - (Time)
-      #     * +:actions_enabled+ - (Boolean)
-      #     * +:ok_actions+ - (Array<String>)
-      #     * +:alarm_actions+ - (Array<String>)
-      #     * +:insufficient_data_actions+ - (Array<String>)
-      #     * +:state_value+ - (String)
-      #     * +:state_reason+ - (String)
-      #     * +:state_reason_data+ - (String)
-      #     * +:state_updated_timestamp+ - (Time)
-      #     * +:metric_name+ - (String)
-      #     * +:namespace+ - (String)
-      #     * +:statistic+ - (String)
-      #     * +:dimensions+ - (Array<Hash>)
-      #       * +:name+ - (String)
-      #       * +:value+ - (String)
-      #     * +:period+ - (Integer)
-      #     * +:unit+ - (String)
-      #     * +:evaluation_periods+ - (Integer)
-      #     * +:threshold+ - (Numeric)
-      #     * +:comparison_operator+ - (String)
+      #   * `:metric_alarms` - (Array<Hash>)
+      #     * `:alarm_name` - (String)
+      #     * `:alarm_arn` - (String)
+      #     * `:alarm_description` - (String)
+      #     * `:alarm_configuration_updated_timestamp` - (Time)
+      #     * `:actions_enabled` - (Boolean)
+      #     * `:ok_actions` - (Array<String>)
+      #     * `:alarm_actions` - (Array<String>)
+      #     * `:insufficient_data_actions` - (Array<String>)
+      #     * `:state_value` - (String)
+      #     * `:state_reason` - (String)
+      #     * `:state_reason_data` - (String)
+      #     * `:state_updated_timestamp` - (Time)
+      #     * `:metric_name` - (String)
+      #     * `:namespace` - (String)
+      #     * `:statistic` - (String)
+      #     * `:dimensions` - (Array<Hash>)
+      #       * `:name` - (String)
+      #       * `:value` - (String)
+      #     * `:period` - (Integer)
+      #     * `:unit` - (String)
+      #     * `:evaluation_periods` - (Integer)
+      #     * `:threshold` - (Numeric)
+      #     * `:comparison_operator` - (String)
 
       # @!method disable_alarm_actions(options = {})
       # Calls the DisableAlarmActions API operation.
       # @param [Hash] options
-      #   * +:alarm_names+ - *required* - (Array<String>)
+      #   * `:alarm_names` - *required* - (Array<String>) The names of the
+      #     alarms to disable actions for.
       # @return [Core::Response]
 
       # @!method enable_alarm_actions(options = {})
       # Calls the EnableAlarmActions API operation.
       # @param [Hash] options
-      #   * +:alarm_names+ - *required* - (Array<String>)
+      #   * `:alarm_names` - *required* - (Array<String>) The names of the
+      #     alarms to enable actions for.
       # @return [Core::Response]
 
       # @!method get_metric_statistics(options = {})
       # Calls the GetMetricStatistics API operation.
       # @param [Hash] options
-      #   * +:namespace+ - *required* - (String)
-      #   * +:metric_name+ - *required* - (String)
-      #   * +:dimensions+ - (Array<Hash>)
-      #     * +:name+ - *required* - (String)
-      #     * +:value+ - *required* - (String)
-      #   * +:start_time+ - *required* - (String<ISO8601 datetime>)
-      #   * +:end_time+ - *required* - (String<ISO8601 datetime>)
-      #   * +:period+ - *required* - (Integer)
-      #   * +:statistics+ - *required* - (Array<String>)
-      #   * +:unit+ - (String)
+      #   * `:namespace` - *required* - (String) The namespace of the metric.
+      #   * `:metric_name` - *required* - (String) The name of the metric.
+      #   * `:dimensions` - (Array<Hash>) A list of dimensions describing
+      #     qualities of the metric.
+      #     * `:name` - *required* - (String) The name of the dimension.
+      #     * `:value` - *required* - (String) The value representing the
+      #       dimension measurement
+      #   * `:start_time` - *required* - (String<ISO8601 datetime>) The time
+      #     stamp to use for determining the first datapoint to return. The
+      #     value specified is inclusive; results include datapoints with the
+      #     time stamp specified. The specified start time is rounded down to
+      #     the nearest value. Datapoints are returned for start times up to
+      #     two weeks in the past. Specified start times that are more than two
+      #     weeks in the past will not return datapoints for metrics that are
+      #     older than two weeks.
+      #   * `:end_time` - *required* - (String<ISO8601 datetime>) The time
+      #     stamp to use for determining the last datapoint to return. The
+      #     value specified is exclusive; results will include datapoints up to
+      #     the time stamp specified.
+      #   * `:period` - *required* - (Integer) The granularity, in seconds, of
+      #     the returned datapoints. Period must be at least 60 seconds and
+      #     must be a multiple of 60. The default value is 60.
+      #   * `:statistics` - *required* - (Array<String>) The metric statistics
+      #     to return.
+      #   * `:unit` - (String) The unit for the metric. Valid values include:
+      #     * `Seconds`
+      #     * `Microseconds`
+      #     * `Milliseconds`
+      #     * `Bytes`
+      #     * `Kilobytes`
+      #     * `Megabytes`
+      #     * `Gigabytes`
+      #     * `Terabytes`
+      #     * `Bits`
+      #     * `Kilobits`
+      #     * `Megabits`
+      #     * `Gigabits`
+      #     * `Terabits`
+      #     * `Percent`
+      #     * `Count`
+      #     * `Bytes/Second`
+      #     * `Kilobytes/Second`
+      #     * `Megabytes/Second`
+      #     * `Gigabytes/Second`
+      #     * `Terabytes/Second`
+      #     * `Bits/Second`
+      #     * `Kilobits/Second`
+      #     * `Megabits/Second`
+      #     * `Gigabits/Second`
+      #     * `Terabits/Second`
+      #     * `Count/Second`
+      #     * `None`
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:label+ - (String)
-      #   * +:datapoints+ - (Array<Hash>)
-      #     * +:timestamp+ - (Time)
-      #     * +:sample_count+ - (Numeric)
-      #     * +:average+ - (Numeric)
-      #     * +:sum+ - (Numeric)
-      #     * +:minimum+ - (Numeric)
-      #     * +:maximum+ - (Numeric)
-      #     * +:unit+ - (String)
+      #   * `:label` - (String)
+      #   * `:datapoints` - (Array<Hash>)
+      #     * `:timestamp` - (Time)
+      #     * `:sample_count` - (Numeric)
+      #     * `:average` - (Numeric)
+      #     * `:sum` - (Numeric)
+      #     * `:minimum` - (Numeric)
+      #     * `:maximum` - (Numeric)
+      #     * `:unit` - (String)
 
       # @!method list_metrics(options = {})
       # Calls the ListMetrics API operation.
       # @param [Hash] options
-      #   * +:namespace+ - (String)
-      #   * +:metric_name+ - (String)
-      #   * +:dimensions+ - (Array<Hash>)
-      #     * +:name+ - *required* - (String)
-      #     * +:value+ - (String)
-      #   * +:next_token+ - (String)
+      #   * `:namespace` - (String) The namespace to filter against.
+      #   * `:metric_name` - (String) The name of the metric to filter against.
+      #   * `:dimensions` - (Array<Hash>) A list of dimensions to filter
+      #     against.
+      #     * `:name` - *required* - (String) The dimension name to be matched.
+      #     * `:value` - (String) The value of the dimension to be matched.
+      #       Specifying a Name without specifying a Value returns all values
+      #       associated with that Name.
+      #   * `:next_token` - (String) The token returned by a previous call to
+      #     indicate that there is more data available.
       # @return [Core::Response]
       #   The #data method of the response object returns
       #   a hash with the following structure:
-      #   * +:metrics+ - (Array<Hash>)
-      #     * +:namespace+ - (String)
-      #     * +:metric_name+ - (String)
-      #     * +:dimensions+ - (Array<Hash>)
-      #       * +:name+ - (String)
-      #       * +:value+ - (String)
-      #   * +:next_token+ - (String)
+      #   * `:metrics` - (Array<Hash>)
+      #     * `:namespace` - (String)
+      #     * `:metric_name` - (String)
+      #     * `:dimensions` - (Array<Hash>)
+      #       * `:name` - (String)
+      #       * `:value` - (String)
+      #   * `:next_token` - (String)
 
       # @!method put_metric_alarm(options = {})
       # Calls the PutMetricAlarm API operation.
       # @param [Hash] options
-      #   * +:alarm_name+ - *required* - (String)
-      #   * +:alarm_description+ - (String)
-      #   * +:actions_enabled+ - (Boolean)
-      #   * +:ok_actions+ - (Array<String>)
-      #   * +:alarm_actions+ - (Array<String>)
-      #   * +:insufficient_data_actions+ - (Array<String>)
-      #   * +:metric_name+ - *required* - (String)
-      #   * +:namespace+ - *required* - (String)
-      #   * +:statistic+ - *required* - (String)
-      #   * +:dimensions+ - (Array<Hash>)
-      #     * +:name+ - *required* - (String)
-      #     * +:value+ - *required* - (String)
-      #   * +:period+ - *required* - (Integer)
-      #   * +:unit+ - (String)
-      #   * +:evaluation_periods+ - *required* - (Integer)
-      #   * +:threshold+ - *required* - (Float)
-      #   * +:comparison_operator+ - *required* - (String)
+      #   * `:alarm_name` - *required* - (String) The descriptive name for the
+      #     alarm. This name must be unique within the user's AWS account
+      #   * `:alarm_description` - (String) The description for the alarm.
+      #   * `:actions_enabled` - (Boolean) Indicates whether or not actions
+      #     should be executed during any changes to the alarm's state.
+      #   * `:ok_actions` - (Array<String>) The list of actions to execute when
+      #     this alarm transitions into an OK state from any other state. Each
+      #     action is specified as an Amazon Resource Number (ARN). Currently
+      #     the only action supported is publishing to an Amazon SNS topic or
+      #     an Amazon Auto Scaling policy.
+      #   * `:alarm_actions` - (Array<String>) The list of actions to execute
+      #     when this alarm transitions into an ALARM state from any other
+      #     state. Each action is specified as an Amazon Resource Number (ARN).
+      #     Currently the only action supported is publishing to an Amazon SNS
+      #     topic or an Amazon Auto Scaling policy.
+      #   * `:insufficient_data_actions` - (Array<String>) The list of actions
+      #     to execute when this alarm transitions into an INSUFFICIENT_DATA
+      #     state from any other state. Each action is specified as an Amazon
+      #     Resource Number (ARN). Currently the only action supported is
+      #     publishing to an Amazon SNS topic or an Amazon Auto Scaling policy.
+      #   * `:metric_name` - *required* - (String) The name for the alarm's
+      #     associated metric.
+      #   * `:namespace` - *required* - (String) The namespace for the alarm's
+      #     associated metric.
+      #   * `:statistic` - *required* - (String) The statistic to apply to the
+      #     alarm's associated metric. Valid values include:
+      #     * `SampleCount`
+      #     * `Average`
+      #     * `Sum`
+      #     * `Minimum`
+      #     * `Maximum`
+      #   * `:dimensions` - (Array<Hash>) The dimensions for the alarm's
+      #     associated metric.
+      #     * `:name` - *required* - (String) The name of the dimension.
+      #     * `:value` - *required* - (String) The value representing the
+      #       dimension measurement
+      #   * `:period` - *required* - (Integer) The period in seconds over which
+      #     the specified statistic is applied.
+      #   * `:unit` - (String) The unit for the alarm's associated metric.
+      #     Valid values include:
+      #     * `Seconds`
+      #     * `Microseconds`
+      #     * `Milliseconds`
+      #     * `Bytes`
+      #     * `Kilobytes`
+      #     * `Megabytes`
+      #     * `Gigabytes`
+      #     * `Terabytes`
+      #     * `Bits`
+      #     * `Kilobits`
+      #     * `Megabits`
+      #     * `Gigabits`
+      #     * `Terabits`
+      #     * `Percent`
+      #     * `Count`
+      #     * `Bytes/Second`
+      #     * `Kilobytes/Second`
+      #     * `Megabytes/Second`
+      #     * `Gigabytes/Second`
+      #     * `Terabytes/Second`
+      #     * `Bits/Second`
+      #     * `Kilobits/Second`
+      #     * `Megabits/Second`
+      #     * `Gigabits/Second`
+      #     * `Terabits/Second`
+      #     * `Count/Second`
+      #     * `None`
+      #   * `:evaluation_periods` - *required* - (Integer) The number of
+      #     periods over which data is compared to the specified threshold.
+      #   * `:threshold` - *required* - (Float) The value against which the
+      #     specified statistic is compared.
+      #   * `:comparison_operator` - *required* - (String) The arithmetic
+      #     operation to use when comparing the specified Statistic and
+      #     Threshold. The specified Statistic value is used as the first
+      #     operand. Valid values include:
+      #     * `GreaterThanOrEqualToThreshold`
+      #     * `GreaterThanThreshold`
+      #     * `LessThanThreshold`
+      #     * `LessThanOrEqualToThreshold`
       # @return [Core::Response]
 
       # @!method put_metric_data(options = {})
       # Calls the PutMetricData API operation.
       # @param [Hash] options
-      #   * +:namespace+ - *required* - (String)
-      #   * +:metric_data+ - *required* - (Array<Hash>)
-      #     * +:metric_name+ - *required* - (String)
-      #     * +:dimensions+ - (Array<Hash>)
-      #       * +:name+ - *required* - (String)
-      #       * +:value+ - *required* - (String)
-      #     * +:timestamp+ - (String<ISO8601 datetime>)
-      #     * +:value+ - (Float)
-      #     * +:statistic_values+ - (Hash)
-      #       * +:sample_count+ - *required* - (Float)
-      #       * +:sum+ - *required* - (Float)
-      #       * +:minimum+ - *required* - (Float)
-      #       * +:maximum+ - *required* - (Float)
-      #     * +:unit+ - (String)
+      #   * `:namespace` - *required* - (String) The namespace for the metric
+      #     data.
+      #   * `:metric_data` - *required* - (Array<Hash>) A list of data
+      #     describing the metric.
+      #     * `:metric_name` - *required* - (String) The name of the metric.
+      #     * `:dimensions` - (Array<Hash>) A list of dimensions associated
+      #       with the metric.
+      #       * `:name` - *required* - (String) The name of the dimension.
+      #       * `:value` - *required* - (String) The value representing the
+      #         dimension measurement
+      #     * `:timestamp` - (String<ISO8601 datetime>) The time stamp used for
+      #       the metric. If not specified, the default value is set to the
+      #       time the metric data was received.
+      #     * `:value` - (Float) The value for the metric. Although the Value
+      #       parameter accepts numbers of type Double, Amazon CloudWatch
+      #       truncates values with very large exponents. Values with base-10
+      #       exponents greater than 126 (1 x 10^126) are truncated. Likewise,
+      #       values with base-10 exponents less than -130 (1 x 10^-130) are
+      #       also truncated.
+      #     * `:statistic_values` - (Hash) A set of statistical values
+      #       describing the metric.
+      #       * `:sample_count` - *required* - (Float) The number of samples
+      #         used for the statistic set.
+      #       * `:sum` - *required* - (Float) The sum of values for the sample
+      #         set.
+      #       * `:minimum` - *required* - (Float) The minimum value of the
+      #         sample set.
+      #       * `:maximum` - *required* - (Float) The maximum value of the
+      #         sample set.
+      #     * `:unit` - (String) The unit of the metric. Valid values include:
+      #       * `Seconds`
+      #       * `Microseconds`
+      #       * `Milliseconds`
+      #       * `Bytes`
+      #       * `Kilobytes`
+      #       * `Megabytes`
+      #       * `Gigabytes`
+      #       * `Terabytes`
+      #       * `Bits`
+      #       * `Kilobits`
+      #       * `Megabits`
+      #       * `Gigabits`
+      #       * `Terabits`
+      #       * `Percent`
+      #       * `Count`
+      #       * `Bytes/Second`
+      #       * `Kilobytes/Second`
+      #       * `Megabytes/Second`
+      #       * `Gigabytes/Second`
+      #       * `Terabytes/Second`
+      #       * `Bits/Second`
+      #       * `Kilobits/Second`
+      #       * `Megabits/Second`
+      #       * `Gigabits/Second`
+      #       * `Terabits/Second`
+      #       * `Count/Second`
+      #       * `None`
       # @return [Core::Response]
 
       # @!method set_alarm_state(options = {})
       # Calls the SetAlarmState API operation.
       # @param [Hash] options
-      #   * +:alarm_name+ - *required* - (String)
-      #   * +:state_value+ - *required* - (String)
-      #   * +:state_reason+ - *required* - (String)
-      #   * +:state_reason_data+ - (String)
+      #   * `:alarm_name` - *required* - (String) The descriptive name for the
+      #     alarm. This name must be unique within the user's AWS account. The
+      #     maximum length is 255 characters.
+      #   * `:state_value` - *required* - (String) The value of the state.
+      #     Valid values include:
+      #     * `OK`
+      #     * `ALARM`
+      #     * `INSUFFICIENT_DATA`
+      #   * `:state_reason` - *required* - (String) The reason that this alarm
+      #     is set to this specific state (in human-readable text format)
+      #   * `:state_reason_data` - (String) The reason that this alarm is set
+      #     to this specific state (in machine-readable JSON format)
       # @return [Core::Response]
 
       # end client methods #