aws-sdk 1.5.8 → 1.6.0

data/lib/aws/core/uri_escape.rb

@@ -25,6 +25,7 @@ module AWS
         value = value.encode("UTF-8") if value.respond_to?(:encode)
         CGI::escape(value.to_s).gsub('+', '%20').gsub('%7E', '~')
       end
+      module_function :escape
 
       # @param [String] value
       # @return [String] Returns a URI-escaped path without escaping the 
@@ -36,6 +37,7 @@ module AWS
         end
         escaped
       end
+      module_function :escape_path
 
     end
   end

data/lib/aws/core/xml/frame.rb

@@ -172,14 +172,14 @@ module AWS
             rules[:type] == :boolean ? false : nil
           else
             case rules[:type]
-            when nil       then @text
-            when :datetime then datetime_like_value(DateTime, :civil)
-            when :time     then datetime_like_value(Time, :utc)
-            when :integer  then @text.to_i
-            when :float    then @text.to_f
-            when :boolean  then @text == 'true'
-            when :blob     then Base64.decode64(@text)
-            when :symbol   then Core::Inflection.ruby_name(@text).to_sym
+            when nil, :string then @text
+            when :datetime    then datetime_like_value(DateTime, :civil)
+            when :time        then datetime_like_value(Time, :utc)
+            when :integer     then @text.to_i
+            when :float       then @text.to_f
+            when :boolean     then @text == 'true'
+            when :blob        then Base64.decode64(@text)
+            when :symbol      then Core::Inflection.ruby_name(@text).to_sym
             else raise "unhandled type"
             end
           end

data/lib/aws/core/xml/grammar.rb

@@ -127,9 +127,8 @@ module AWS
 
         def validate_config_method(method)
           allow_methods = %w(
-            rename attribute_name boolean integer long float list force
-            ignore collect_values symbol_value timestamp map_entry map
-            blob string
+            rename attribute_name boolean integer long float list force string
+            ignore collect_values symbol_value timestamp map_entry map blob
           )
           unless allow_methods.include?(method.to_s)
             raise "#{method} cannot be used in configuration"
@@ -286,6 +285,12 @@ module AWS
         end
         alias_method :==, :eql?
 
+        def http_trait *args; end
+        alias_method :http_header, :http_trait
+        alias_method :http_uri_label, :http_trait
+        alias_method :http_payload, :http_trait
+        alias_method :http_status, :http_trait
+
         protected
         def context_for_child child_element_name
           @context[:children] ||= {}

data/lib/aws/dynamo_db/client.rb

@@ -19,7 +19,7 @@ module AWS
 
       API_VERSION = '2011-12-05'
 
-      extend Core::Client::QueryJSON
+      extend Core::JSONClient
 
       # @private
       REGION_US_E1 = 'dynamodb.us-east-1.amazonaws.com'
@@ -34,88 +34,9 @@ module AWS
 
       # Calls the BatchGetItem API operation.
       # @method batch_get_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:request_items+ - *required* - (Hash<String,Hash>)
-      #   * +:keys+ - *required* - (Array<Hash>)
-      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #       treated as the primary key, and can be a string or a number.
-      #       Single attribute primary keys have one index value. The value can
-      #       be String, Number, StringSet, NumberSet.
-      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #         The maximum size is limited by the size of the primary key
-      #         (1024 bytes as a range part of a key or 2048 bytes as a single
-      #         part hash key) or the item size (64k).
-      #       * +:n+ - (String) Numbers are positive or negative exact-value
-      #         decimals and integers. A number can have up to 38 digits
-      #         precision and can be between 10^-128 to 10^+126.
-      #       * +:ss+ - (Array<String>) A set of strings.
-      #       * +:ns+ - (Array<String>) A set of numbers.
-      #     * +:range_key_element+ - (Hash) A range key element is treated as a
-      #       secondary key (used in conjunction with the primary key), and can
-      #       be a string or a number, and is only used for hash-and-range
-      #       primary keys. The value can be String, Number, StringSet,
-      #       NumberSet.
-      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #         The maximum size is limited by the size of the primary key
-      #         (1024 bytes as a range part of a key or 2048 bytes as a single
-      #         part hash key) or the item size (64k).
-      #       * +:n+ - (String) Numbers are positive or negative exact-value
-      #         decimals and integers. A number can have up to 38 digits
-      #         precision and can be between 10^-128 to 10^+126.
-      #       * +:ss+ - (Array<String>) A set of strings.
-      #       * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:attributes_to_get+ - (Array<String>)
-      #
-      # === Response Structure:
-      #
-      # * +Responses+ - (Hash<String,Hash>)
-      #   * +member+ - (Hash<String,Hash>)
-      #     * +S+ - (String)
-      #     * +N+ - (String)
-      #     * +SS+ - (Array<String>)
-      #     * +NS+ - (Array<String>)
-      #   * +ConsumedCapacityUnits+ - (Numeric)
-      # * +UnprocessedKeys+ - (Hash<String,Hash>)
-      #   * +Keys+ - (Array<Hash>)
-      #     * +HashKeyElement+ - (Hash)
-      #       * +S+ - (String)
-      #       * +N+ - (String)
-      #       * +SS+ - (Array<String>)
-      #       * +NS+ - (Array<String>)
-      #     * +RangeKeyElement+ - (Hash)
-      #       * +S+ - (String)
-      #       * +N+ - (String)
-      #       * +SS+ - (Array<String>)
-      #       * +NS+ - (Array<String>)
-      #   * +AttributesToGet+ - (Array<String>)
-      #
-      # @return [Core::Response]
-      #
-      define_client_method :batch_get_item, 'BatchGetItem'
-
-      # Calls the BatchWriteItem API operation.
-      # @method batch_write_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:request_items+ - *required* - (Hash<String,Array<Hash>>) A map of
-      #   table name to list-of-write-requests. Used as input to the
-      #   BatchWriteItem API call
-      #   * +:put_request+ - (Hash)
-      #     * +:item+ - *required* - (Hash<String,Hash>) The item to put
-      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #         The maximum size is limited by the size of the primary key
-      #         (1024 bytes as a range part of a key or 2048 bytes as a single
-      #         part hash key) or the item size (64k).
-      #       * +:n+ - (String) Numbers are positive or negative exact-value
-      #         decimals and integers. A number can have up to 38 digits
-      #         precision and can be between 10^-128 to 10^+126.
-      #       * +:ss+ - (Array<String>) A set of strings.
-      #       * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:delete_request+ - (Hash)
-      #     * +:key+ - *required* - (Hash) The item's key to be delete
+      # @param [Hash] options
+      #   * +:request_items+ - *required* - (Hash<String,Hash>)
+      #     * +:keys+ - *required* - (Array<Hash>)
       #       * +:hash_key_element+ - *required* - (Hash) A hash key element is
       #         treated as the primary key, and can be a string or a number.
       #         Single attribute primary keys have one index value. The value
@@ -143,323 +64,349 @@ module AWS
       #           precision and can be between 10^-128 to 10^+126.
       #         * +:ss+ - (Array<String>) A set of strings.
       #         * +:ns+ - (Array<String>) A set of numbers.
-      #
-      # === Response Structure:
-      #
-      # * +Responses+ - (Hash<String,Hash>)
-      #   * +ConsumedCapacityUnits+ - (Numeric)
-      # * +UnprocessedItems+ - (Hash<String,Hash>)
-      #   * +value+ - (Array<Hash>)
-      #     * +PutRequest+ - (Hash)
-      #       * +Item+ - (Hash<String,Hash>)
+      #     * +:attributes_to_get+ - (Array<String>)
+      # @return [Core::Response]
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Responses+ - (Hash<String,Hash>)
+      #     * +member+ - (Hash<String,Hash>)
+      #       * +S+ - (String)
+      #       * +N+ - (String)
+      #       * +SS+ - (Array<String>)
+      #       * +NS+ - (Array<String>)
+      #     * +ConsumedCapacityUnits+ - (Numeric)
+      #   * +UnprocessedKeys+ - (Hash<String,Hash>)
+      #     * +Keys+ - (Array<Hash>)
+      #       * +HashKeyElement+ - (Hash)
       #         * +S+ - (String)
       #         * +N+ - (String)
       #         * +SS+ - (Array<String>)
       #         * +NS+ - (Array<String>)
-      #     * +DeleteRequest+ - (Hash)
-      #       * +Key+ - (Hash)
-      #         * +HashKeyElement+ - (Hash)
-      #           * +S+ - (String)
-      #           * +N+ - (String)
-      #           * +SS+ - (Array<String>)
-      #           * +NS+ - (Array<String>)
-      #         * +RangeKeyElement+ - (Hash)
+      #       * +RangeKeyElement+ - (Hash)
+      #         * +S+ - (String)
+      #         * +N+ - (String)
+      #         * +SS+ - (Array<String>)
+      #         * +NS+ - (Array<String>)
+      #     * +AttributesToGet+ - (Array<String>)
+      define_client_method :batch_get_item, 'BatchGetItem'
+
+      # Calls the BatchWriteItem API operation.
+      # @method batch_write_item(options = {})
+      # @param [Hash] options
+      #   * +:request_items+ - *required* - (Hash<String,Array<Hash>>) A map of
+      #     table name to list-of-write-requests. Used as input to the
+      #     BatchWriteItem API call
+      #     * +:put_request+ - (Hash)
+      #       * +:item+ - *required* - (Hash<String,Hash>) The item to put
+      #         * +:s+ - (String) Strings are Unicode with UTF-8 binary
+      #           encoding. The maximum size is limited by the size of the
+      #           primary key (1024 bytes as a range part of a key or 2048
+      #           bytes as a single part hash key) or the item size (64k).
+      #         * +:n+ - (String) Numbers are positive or negative exact-value
+      #           decimals and integers. A number can have up to 38 digits
+      #           precision and can be between 10^-128 to 10^+126.
+      #         * +:ss+ - (Array<String>) A set of strings.
+      #         * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:delete_request+ - (Hash)
+      #       * +:key+ - *required* - (Hash) The item's key to be delete
+      #         * +:hash_key_element+ - *required* - (Hash) A hash key element
+      #           is treated as the primary key, and can be a string or a
+      #           number. Single attribute primary keys have one index value.
+      #           The value can be String, Number, StringSet, NumberSet.
+      #           * +:s+ - (String) Strings are Unicode with UTF-8 binary
+      #             encoding. The maximum size is limited by the size of the
+      #             primary key (1024 bytes as a range part of a key or 2048
+      #             bytes as a single part hash key) or the item size (64k).
+      #           * +:n+ - (String) Numbers are positive or negative
+      #             exact-value decimals and integers. A number can have up to
+      #             38 digits precision and can be between 10^-128 to 10^+126.
+      #           * +:ss+ - (Array<String>) A set of strings.
+      #           * +:ns+ - (Array<String>) A set of numbers.
+      #         * +:range_key_element+ - (Hash) A range key element is treated
+      #           as a secondary key (used in conjunction with the primary
+      #           key), and can be a string or a number, and is only used for
+      #           hash-and-range primary keys. The value can be String, Number,
+      #           StringSet, NumberSet.
+      #           * +:s+ - (String) Strings are Unicode with UTF-8 binary
+      #             encoding. The maximum size is limited by the size of the
+      #             primary key (1024 bytes as a range part of a key or 2048
+      #             bytes as a single part hash key) or the item size (64k).
+      #           * +:n+ - (String) Numbers are positive or negative
+      #             exact-value decimals and integers. A number can have up to
+      #             38 digits precision and can be between 10^-128 to 10^+126.
+      #           * +:ss+ - (Array<String>) A set of strings.
+      #           * +:ns+ - (Array<String>) A set of numbers.
+      # @return [Core::Response]
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Responses+ - (Hash<String,Hash>)
+      #     * +ConsumedCapacityUnits+ - (Numeric)
+      #   * +UnprocessedItems+ - (Hash<String,Hash>)
+      #     * +value+ - (Array<Hash>)
+      #       * +PutRequest+ - (Hash)
+      #         * +Item+ - (Hash<String,Hash>)
       #           * +S+ - (String)
       #           * +N+ - (String)
       #           * +SS+ - (Array<String>)
       #           * +NS+ - (Array<String>)
-      #
-      # @return [Core::Response]
-      #
+      #       * +DeleteRequest+ - (Hash)
+      #         * +Key+ - (Hash)
+      #           * +HashKeyElement+ - (Hash)
+      #             * +S+ - (String)
+      #             * +N+ - (String)
+      #             * +SS+ - (Array<String>)
+      #             * +NS+ - (Array<String>)
+      #           * +RangeKeyElement+ - (Hash)
+      #             * +S+ - (String)
+      #             * +N+ - (String)
+      #             * +SS+ - (Array<String>)
+      #             * +NS+ - (Array<String>)
       define_client_method :batch_write_item, 'BatchWriteItem'
 
       # Calls the CreateTable API operation.
       # @method create_table(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table you want
-      #   to create. Allowed characters are a-z, A-Z, 0-9, _ (underscore), -
-      #   (hyphen) and . (period).
-      # * +:key_schema+ - *required* - (Hash)
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:attribute_name+ - *required* - (String) The AttributeName of
-      #       the KeySchemaElement.
-      #     * +:attribute_type+ - *required* - (String) The AttributeType of
-      #       the KeySchemaElement which can be a String or a Number.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
-      #     * +:attribute_name+ - *required* - (String) The AttributeName of
-      #       the KeySchemaElement.
-      #     * +:attribute_type+ - *required* - (String) The AttributeType of
-      #       the KeySchemaElement which can be a String or a Number.
-      # * +:provisioned_throughput+ - *required* - (Hash)
-      #   * +:read_capacity_units+ - *required* - (Integer) ReadCapacityUnits
-      #     are in terms of strictly consistent reads, assuming items of 1k. 2k
-      #     items require twice the ReadCapacityUnits. Eventually-consistent
-      #     reads only require half the ReadCapacityUnits of stirctly
-      #     consistent reads.
-      #   * +:write_capacity_units+ - *required* - (Integer) WriteCapacityUnits
-      #     are in terms of strictly consistent reads, assuming items of 1k. 2k
-      #     items require twice the WriteCapacityUnits.
-      #
-      # === Response Structure:
-      #
-      # * +TableDescription+ - (Hash)
-      #   * +TableName+ - (String)
-      #   * +KeySchema+ - (Hash)
-      #     * +HashKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #     * +RangeKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #   * +TableStatus+ - (String)
-      #   * +CreationDateTime+ - (Time)
-      #   * +ProvisionedThroughput+ - (Hash)
-      #     * +LastIncreaseDateTime+ - (Time)
-      #     * +LastDecreaseDateTime+ - (Time)
-      #     * +ReadCapacityUnits+ - (Integer)
-      #     * +WriteCapacityUnits+ - (Integer)
-      #   * +TableSizeBytes+ - (Integer)
-      #   * +ItemCount+ - (Integer)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table you
+      #     want to create. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
+      #   * +:key_schema+ - *required* - (Hash)
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:attribute_name+ - *required* - (String) The AttributeName of
+      #         the KeySchemaElement.
+      #       * +:attribute_type+ - *required* - (String) The AttributeType of
+      #         the KeySchemaElement which can be a String or a Number.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:attribute_name+ - *required* - (String) The AttributeName of
+      #         the KeySchemaElement.
+      #       * +:attribute_type+ - *required* - (String) The AttributeType of
+      #         the KeySchemaElement which can be a String or a Number.
+      #   * +:provisioned_throughput+ - *required* - (Hash)
+      #     * +:read_capacity_units+ - *required* - (Integer) ReadCapacityUnits
+      #       are in terms of strictly consistent reads, assuming items of 1k.
+      #       2k items require twice the ReadCapacityUnits.
+      #       Eventually-consistent reads only require half the
+      #       ReadCapacityUnits of stirctly consistent reads.
+      #     * +:write_capacity_units+ - *required* - (Integer)
+      #       WriteCapacityUnits are in terms of strictly consistent reads,
+      #       assuming items of 1k. 2k items require twice the
+      #       WriteCapacityUnits.
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +TableDescription+ - (Hash)
+      #     * +TableName+ - (String)
+      #     * +KeySchema+ - (Hash)
+      #       * +HashKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #       * +RangeKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #     * +TableStatus+ - (String)
+      #     * +CreationDateTime+ - (Time)
+      #     * +ProvisionedThroughput+ - (Hash)
+      #       * +LastIncreaseDateTime+ - (Time)
+      #       * +LastDecreaseDateTime+ - (Time)
+      #       * +ReadCapacityUnits+ - (Integer)
+      #       * +WriteCapacityUnits+ - (Integer)
+      #     * +TableSizeBytes+ - (Integer)
+      #     * +ItemCount+ - (Integer)
       define_client_method :create_table, 'CreateTable'
 
       # Calls the DeleteItem API operation.
       # @method delete_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to delete an item. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:key+ - *required* - (Hash)
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      # * +:expected+ - (Hash<String,Hash>)
-      #   * +:value+ - (Hash) Specify whether or not a value already exists and
-      #     has a specific content for the attribute name-value pair.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:exists+ - (Boolean) Specify whether or not a value already exists
-      #     for the attribute name-value pair.
-      # * +:return_values+ - (String)
-      #
-      # === Response Structure:
-      #
-      # * +Attributes+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to delete an item. Allowed characters are a-z, A-Z,
+      #     0-9, _ (underscore), - (hyphen) and . (period).
+      #   * +:key+ - *required* - (Hash)
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #   * +:expected+ - (Hash<String,Hash>)
+      #     * +:value+ - (Hash) Specify whether or not a value already exists
+      #       and has a specific content for the attribute name-value pair.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:exists+ - (Boolean) Specify whether or not a value already
+      #       exists for the attribute name-value pair.
+      #   * +:return_values+ - (String)
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Attributes+ - (Hash<String,Hash>)
+      #     * +S+ - (String)
+      #     * +N+ - (String)
+      #     * +SS+ - (Array<String>)
+      #     * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :delete_item, 'DeleteItem'
 
       # Calls the DeleteTable API operation.
       # @method delete_table(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table you want
-      #   to delete. Allowed characters are a-z, A-Z, 0-9, _ (underscore), -
-      #   (hyphen) and . (period).
-      #
-      # === Response Structure:
-      #
-      # * +TableDescription+ - (Hash)
-      #   * +TableName+ - (String)
-      #   * +KeySchema+ - (Hash)
-      #     * +HashKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #     * +RangeKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #   * +TableStatus+ - (String)
-      #   * +CreationDateTime+ - (Time)
-      #   * +ProvisionedThroughput+ - (Hash)
-      #     * +LastIncreaseDateTime+ - (Time)
-      #     * +LastDecreaseDateTime+ - (Time)
-      #     * +ReadCapacityUnits+ - (Integer)
-      #     * +WriteCapacityUnits+ - (Integer)
-      #   * +TableSizeBytes+ - (Integer)
-      #   * +ItemCount+ - (Integer)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table you
+      #     want to delete. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +TableDescription+ - (Hash)
+      #     * +TableName+ - (String)
+      #     * +KeySchema+ - (Hash)
+      #       * +HashKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #       * +RangeKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #     * +TableStatus+ - (String)
+      #     * +CreationDateTime+ - (Time)
+      #     * +ProvisionedThroughput+ - (Hash)
+      #       * +LastIncreaseDateTime+ - (Time)
+      #       * +LastDecreaseDateTime+ - (Time)
+      #       * +ReadCapacityUnits+ - (Integer)
+      #       * +WriteCapacityUnits+ - (Integer)
+      #     * +TableSizeBytes+ - (Integer)
+      #     * +ItemCount+ - (Integer)
       define_client_method :delete_table, 'DeleteTable'
 
       # Calls the DescribeTable API operation.
       # @method describe_table(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table you want
-      #   to describe. Allowed characters are a-z, A-Z, 0-9, _ (underscore), -
-      #   (hyphen) and . (period).
-      #
-      # === Response Structure:
-      #
-      # * +Table+ - (Hash)
-      #   * +TableName+ - (String)
-      #   * +KeySchema+ - (Hash)
-      #     * +HashKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #     * +RangeKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #   * +TableStatus+ - (String)
-      #   * +CreationDateTime+ - (Time)
-      #   * +ProvisionedThroughput+ - (Hash)
-      #     * +LastIncreaseDateTime+ - (Time)
-      #     * +LastDecreaseDateTime+ - (Time)
-      #     * +ReadCapacityUnits+ - (Integer)
-      #     * +WriteCapacityUnits+ - (Integer)
-      #   * +TableSizeBytes+ - (Integer)
-      #   * +ItemCount+ - (Integer)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table you
+      #     want to describe. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Table+ - (Hash)
+      #     * +TableName+ - (String)
+      #     * +KeySchema+ - (Hash)
+      #       * +HashKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #       * +RangeKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #     * +TableStatus+ - (String)
+      #     * +CreationDateTime+ - (Time)
+      #     * +ProvisionedThroughput+ - (Hash)
+      #       * +LastIncreaseDateTime+ - (Time)
+      #       * +LastDecreaseDateTime+ - (Time)
+      #       * +ReadCapacityUnits+ - (Integer)
+      #       * +WriteCapacityUnits+ - (Integer)
+      #     * +TableSizeBytes+ - (Integer)
+      #     * +ItemCount+ - (Integer)
       define_client_method :describe_table, 'DescribeTable'
 
       # Calls the GetItem API operation.
       # @method get_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to get an item. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:key+ - *required* - (Hash)
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      # * +:attributes_to_get+ - (Array<String>)
-      # * +:consistent_read+ - (Boolean)
-      #
-      # === Response Structure:
-      #
-      # * +Item+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to get an item. Allowed characters are a-z, A-Z,
+      #     0-9, _ (underscore), - (hyphen) and . (period).
+      #   * +:key+ - *required* - (Hash)
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #   * +:attributes_to_get+ - (Array<String>)
+      #   * +:consistent_read+ - (Boolean)
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Item+ - (Hash<String,Hash>)
+      #     * +S+ - (String)
+      #     * +N+ - (String)
+      #     * +SS+ - (Array<String>)
+      #     * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :get_item, 'GetItem'
 
       # Calls the ListTables API operation.
       # @method list_tables(options = {})
-      #
-      # === Options:
-      #
-      # * +:exclusive_start_table_name+ - (String) The name of the table that
-      #   starts the list. If you already ran a ListTables operation and
-      #   recieved a LastEvaluatedTableName value in the response, use that
-      #   value here to continue the list.
-      # * +:limit+ - (Integer)
-      #
-      # === Response Structure:
-      #
-      # * +TableNames+ - (Array<String>)
-      # * +LastEvaluatedTableName+ - (String)
-      #
+      # @param [Hash] options
+      #   * +:exclusive_start_table_name+ - (String) The name of the table that
+      #     starts the list. If you already ran a ListTables operation and
+      #     recieved a LastEvaluatedTableName value in the response, use that
+      #     value here to continue the list.
+      #   * +:limit+ - (Integer)
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +TableNames+ - (Array<String>)
+      #   * +LastEvaluatedTableName+ - (String)
       define_client_method :list_tables, 'ListTables'
 
       # Calls the PutItem API operation.
       # @method put_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to put an item. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:item+ - *required* - (Hash<String,Hash>)
-      #   * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding. The
-      #     maximum size is limited by the size of the primary key (1024 bytes
-      #     as a range part of a key or 2048 bytes as a single part hash key)
-      #     or the item size (64k).
-      #   * +:n+ - (String) Numbers are positive or negative exact-value
-      #     decimals and integers. A number can have up to 38 digits precision
-      #     and can be between 10^-128 to 10^+126.
-      #   * +:ss+ - (Array<String>) A set of strings.
-      #   * +:ns+ - (Array<String>) A set of numbers.
-      # * +:expected+ - (Hash<String,Hash>)
-      #   * +:value+ - (Hash) Specify whether or not a value already exists and
-      #     has a specific content for the attribute name-value pair.
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to put an item. Allowed characters are a-z, A-Z,
+      #     0-9, _ (underscore), - (hyphen) and . (period).
+      #   * +:item+ - *required* - (Hash<String,Hash>)
       #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
       #       The maximum size is limited by the size of the primary key (1024
       #       bytes as a range part of a key or 2048 bytes as a single part
@@ -469,98 +416,55 @@ module AWS
       #       precision and can be between 10^-128 to 10^+126.
       #     * +:ss+ - (Array<String>) A set of strings.
       #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:exists+ - (Boolean) Specify whether or not a value already exists
-      #     for the attribute name-value pair.
-      # * +:return_values+ - (String)
-      #
-      # === Response Structure:
-      #
-      # * +Attributes+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
+      #   * +:expected+ - (Hash<String,Hash>)
+      #     * +:value+ - (Hash) Specify whether or not a value already exists
+      #       and has a specific content for the attribute name-value pair.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:exists+ - (Boolean) Specify whether or not a value already
+      #       exists for the attribute name-value pair.
+      #   * +:return_values+ - (String)
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Attributes+ - (Hash<String,Hash>)
+      #     * +S+ - (String)
+      #     * +N+ - (String)
+      #     * +SS+ - (Array<String>)
+      #     * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :put_item, 'PutItem'
 
       # Calls the Query API operation.
       # @method query(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to query. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:attributes_to_get+ - (Array<String>)
-      # * +:limit+ - (Integer) The maximum number of items to return. If Amazon
-      #   DynamoDB hits this limit while querying the table, it stops the query
-      #   and returns the matching values up to the limit, and a
-      #   LastEvaluatedKey to apply in a subsequent operation to continue the
-      #   query. Also, if the result set size exceeds 1MB before Amazon
-      #   DynamoDB hits this limit, it stops the query and returns the matching
-      #   values, and a LastEvaluatedKey to apply in a subsequent operation to
-      #   continue the query.
-      # * +:consistent_read+ - (Boolean)
-      # * +:count+ - (Boolean) If set to +true+ , Amazon DynamoDB returns a
-      #   total number of items that match the query parameters, instead of a
-      #   list of the matching items and their attributes. Do not set Count to
-      #   +true+ while providing a list of AttributesToGet, otherwise Amazon
-      #   DynamoDB returns a validation error.
-      # * +:hash_key_value+ - *required* - (Hash) Attribute value of the hash
-      #   component of the composite primary key.
-      #   * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding. The
-      #     maximum size is limited by the size of the primary key (1024 bytes
-      #     as a range part of a key or 2048 bytes as a single part hash key)
-      #     or the item size (64k).
-      #   * +:n+ - (String) Numbers are positive or negative exact-value
-      #     decimals and integers. A number can have up to 38 digits precision
-      #     and can be between 10^-128 to 10^+126.
-      #   * +:ss+ - (Array<String>) A set of strings.
-      #   * +:ns+ - (Array<String>) A set of numbers.
-      # * +:range_key_condition+ - (Hash) A container for the attribute values
-      #   and comparison operators to use for the query.
-      #   * +:attribute_value_list+ - (Array<Hash>)
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:comparison_operator+ - *required* - (String)
-      # * +:scan_index_forward+ - (Boolean) Specifies forward or backward
-      #   traversal of the index. Amazon DynamoDB returns results reflecting
-      #   the requested order, determined by the range key. Default is +true+
-      #   (forward).
-      # * +:exclusive_start_key+ - (Hash) Primary key of the item from which to
-      #   continue an earlier query. An earlier query might provide this value
-      #   as the LastEvaluatedKey if that query operation was interrupted
-      #   before completing the query; either because of the result set size or
-      #   the Limit parameter. The LastEvaluatedKey can be passed back in a new
-      #   query request to continue the operation from that point.
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to query. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
+      #   * +:attributes_to_get+ - (Array<String>)
+      #   * +:limit+ - (Integer) The maximum number of items to return. If
+      #     Amazon DynamoDB hits this limit while querying the table, it stops
+      #     the query and returns the matching values up to the limit, and a
+      #     LastEvaluatedKey to apply in a subsequent operation to continue the
+      #     query. Also, if the result set size exceeds 1MB before Amazon
+      #     DynamoDB hits this limit, it stops the query and returns the
+      #     matching values, and a LastEvaluatedKey to apply in a subsequent
+      #     operation to continue the query.
+      #   * +:consistent_read+ - (Boolean)
+      #   * +:count+ - (Boolean) If set to +true+ , Amazon DynamoDB returns a
+      #     total number of items that match the query parameters, instead of a
+      #     list of the matching items and their attributes. Do not set Count
+      #     to +true+ while providing a list of AttributesToGet, otherwise
+      #     Amazon DynamoDB returns a validation error.
+      #   * +:hash_key_value+ - *required* - (Hash) Attribute value of the hash
+      #     component of the composite primary key.
       #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
       #       The maximum size is limited by the size of the primary key (1024
       #       bytes as a range part of a key or 2048 bytes as a single part
@@ -570,245 +474,279 @@ module AWS
       #       precision and can be between 10^-128 to 10^+126.
       #     * +:ss+ - (Array<String>) A set of strings.
       #     * +:ns+ - (Array<String>) A set of numbers.
-      #
-      # === Response Structure:
-      #
-      # * +member+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +Count+ - (Integer)
-      # * +LastEvaluatedKey+ - (Hash)
-      #   * +HashKeyElement+ - (Hash)
-      #     * +S+ - (String)
-      #     * +N+ - (String)
-      #     * +SS+ - (Array<String>)
-      #     * +NS+ - (Array<String>)
-      #   * +RangeKeyElement+ - (Hash)
+      #   * +:range_key_condition+ - (Hash) A container for the attribute
+      #     values and comparison operators to use for the query.
+      #     * +:attribute_value_list+ - (Array<Hash>)
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:comparison_operator+ - *required* - (String)
+      #   * +:scan_index_forward+ - (Boolean) Specifies forward or backward
+      #     traversal of the index. Amazon DynamoDB returns results reflecting
+      #     the requested order, determined by the range key. Default is +true+
+      #     (forward).
+      #   * +:exclusive_start_key+ - (Hash) Primary key of the item from which
+      #     to continue an earlier query. An earlier query might provide this
+      #     value as the LastEvaluatedKey if that query operation was
+      #     interrupted before completing the query; either because of the
+      #     result set size or the Limit parameter. The LastEvaluatedKey can be
+      #     passed back in a new query request to continue the operation from
+      #     that point.
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      # @return [Core::Response]
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +member+ - (Hash<String,Hash>)
       #     * +S+ - (String)
       #     * +N+ - (String)
       #     * +SS+ - (Array<String>)
       #     * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
-      # @return [Core::Response]
-      #
+      #   * +Count+ - (Integer)
+      #   * +LastEvaluatedKey+ - (Hash)
+      #     * +HashKeyElement+ - (Hash)
+      #       * +S+ - (String)
+      #       * +N+ - (String)
+      #       * +SS+ - (Array<String>)
+      #       * +NS+ - (Array<String>)
+      #     * +RangeKeyElement+ - (Hash)
+      #       * +S+ - (String)
+      #       * +N+ - (String)
+      #       * +SS+ - (Array<String>)
+      #       * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :query, 'Query'
 
       # Calls the Scan API operation.
       # @method scan(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to scan. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:attributes_to_get+ - (Array<String>)
-      # * +:limit+ - (Integer) The maximum number of items to return. If Amazon
-      #   DynamoDB hits this limit while scanning the table, it stops the scan
-      #   and returns the matching values up to the limit, and a
-      #   LastEvaluatedKey to apply in a subsequent operation to continue the
-      #   scan. Also, if the scanned data set size exceeds 1MB before Amazon
-      #   DynamoDB hits this limit, it stops the scan and returns the matching
-      #   values up to the limit, and a LastEvaluatedKey to apply in a
-      #   subsequent operation to continue the scan.
-      # * +:count+ - (Boolean) If set to +true+ , Amazon DynamoDB returns a
-      #   total number of items for the Scan operation, even if the operation
-      #   has no matching items for the assigned filter. Do not set Count to
-      #   +true+ while providing a list of AttributesToGet, otherwise Amazon
-      #   DynamoDB returns a validation error.
-      # * +:scan_filter+ - (Hash<String,Hash>) Evaluates the scan results and
-      #   returns only the desired values.
-      #   * +:attribute_value_list+ - (Array<Hash>)
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:comparison_operator+ - *required* - (String)
-      # * +:exclusive_start_key+ - (Hash) Primary key of the item from which to
-      #   continue an earlier scan. An earlier scan might provide this value if
-      #   that scan operation was interrupted before scanning the entire table;
-      #   either because of the result set size or the Limit parameter. The
-      #   LastEvaluatedKey can be passed back in a new scan request to continue
-      #   the operation from that point.
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #
-      # === Response Structure:
-      #
-      # * +member+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +Count+ - (Integer)
-      # * +ScannedCount+ - (Integer)
-      # * +LastEvaluatedKey+ - (Hash)
-      #   * +HashKeyElement+ - (Hash)
-      #     * +S+ - (String)
-      #     * +N+ - (String)
-      #     * +SS+ - (Array<String>)
-      #     * +NS+ - (Array<String>)
-      #   * +RangeKeyElement+ - (Hash)
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to scan. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
+      #   * +:attributes_to_get+ - (Array<String>)
+      #   * +:limit+ - (Integer) The maximum number of items to return. If
+      #     Amazon DynamoDB hits this limit while scanning the table, it stops
+      #     the scan and returns the matching values up to the limit, and a
+      #     LastEvaluatedKey to apply in a subsequent operation to continue the
+      #     scan. Also, if the scanned data set size exceeds 1MB before Amazon
+      #     DynamoDB hits this limit, it stops the scan and returns the
+      #     matching values up to the limit, and a LastEvaluatedKey to apply in
+      #     a subsequent operation to continue the scan.
+      #   * +:count+ - (Boolean) If set to +true+ , Amazon DynamoDB returns a
+      #     total number of items for the Scan operation, even if the operation
+      #     has no matching items for the assigned filter. Do not set Count to
+      #     +true+ while providing a list of AttributesToGet, otherwise Amazon
+      #     DynamoDB returns a validation error.
+      #   * +:scan_filter+ - (Hash<String,Hash>) Evaluates the scan results and
+      #     returns only the desired values.
+      #     * +:attribute_value_list+ - (Array<Hash>)
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:comparison_operator+ - *required* - (String)
+      #   * +:exclusive_start_key+ - (Hash) Primary key of the item from which
+      #     to continue an earlier scan. An earlier scan might provide this
+      #     value if that scan operation was interrupted before scanning the
+      #     entire table; either because of the result set size or the Limit
+      #     parameter. The LastEvaluatedKey can be passed back in a new scan
+      #     request to continue the operation from that point.
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      # @return [Core::Response]
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +member+ - (Hash<String,Hash>)
       #     * +S+ - (String)
       #     * +N+ - (String)
       #     * +SS+ - (Array<String>)
       #     * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
-      # @return [Core::Response]
-      #
+      #   * +Count+ - (Integer)
+      #   * +ScannedCount+ - (Integer)
+      #   * +LastEvaluatedKey+ - (Hash)
+      #     * +HashKeyElement+ - (Hash)
+      #       * +S+ - (String)
+      #       * +N+ - (String)
+      #       * +SS+ - (Array<String>)
+      #       * +NS+ - (Array<String>)
+      #     * +RangeKeyElement+ - (Hash)
+      #       * +S+ - (String)
+      #       * +N+ - (String)
+      #       * +SS+ - (Array<String>)
+      #       * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :scan, 'Scan'
 
       # Calls the UpdateItem API operation.
       # @method update_item(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table in which
-      #   you want to update an item. Allowed characters are a-z, A-Z, 0-9, _
-      #   (underscore), - (hyphen) and . (period).
-      # * +:key+ - *required* - (Hash)
-      #   * +:hash_key_element+ - *required* - (Hash) A hash key element is
-      #     treated as the primary key, and can be a string or a number. Single
-      #     attribute primary keys have one index value. The value can be
-      #     String, Number, StringSet, NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:range_key_element+ - (Hash) A range key element is treated as a
-      #     secondary key (used in conjunction with the primary key), and can
-      #     be a string or a number, and is only used for hash-and-range
-      #     primary keys. The value can be String, Number, StringSet,
-      #     NumberSet.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      # * +:attribute_updates+ - *required* - (Hash<String,Hash>)
-      #   * +:value+ - (Hash)
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:action+ - (String)
-      # * +:expected+ - (Hash<String,Hash>)
-      #   * +:value+ - (Hash) Specify whether or not a value already exists and
-      #     has a specific content for the attribute name-value pair.
-      #     * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
-      #       The maximum size is limited by the size of the primary key (1024
-      #       bytes as a range part of a key or 2048 bytes as a single part
-      #       hash key) or the item size (64k).
-      #     * +:n+ - (String) Numbers are positive or negative exact-value
-      #       decimals and integers. A number can have up to 38 digits
-      #       precision and can be between 10^-128 to 10^+126.
-      #     * +:ss+ - (Array<String>) A set of strings.
-      #     * +:ns+ - (Array<String>) A set of numbers.
-      #   * +:exists+ - (Boolean) Specify whether or not a value already exists
-      #     for the attribute name-value pair.
-      # * +:return_values+ - (String)
-      #
-      # === Response Structure:
-      #
-      # * +Attributes+ - (Hash<String,Hash>)
-      #   * +S+ - (String)
-      #   * +N+ - (String)
-      #   * +SS+ - (Array<String>)
-      #   * +NS+ - (Array<String>)
-      # * +ConsumedCapacityUnits+ - (Numeric)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table in
+      #     which you want to update an item. Allowed characters are a-z, A-Z,
+      #     0-9, _ (underscore), - (hyphen) and . (period).
+      #   * +:key+ - *required* - (Hash)
+      #     * +:hash_key_element+ - *required* - (Hash) A hash key element is
+      #       treated as the primary key, and can be a string or a number.
+      #       Single attribute primary keys have one index value. The value can
+      #       be String, Number, StringSet, NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:range_key_element+ - (Hash) A range key element is treated as a
+      #       secondary key (used in conjunction with the primary key), and can
+      #       be a string or a number, and is only used for hash-and-range
+      #       primary keys. The value can be String, Number, StringSet,
+      #       NumberSet.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #   * +:attribute_updates+ - *required* - (Hash<String,Hash>)
+      #     * +:value+ - (Hash)
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:action+ - (String)
+      #   * +:expected+ - (Hash<String,Hash>)
+      #     * +:value+ - (Hash) Specify whether or not a value already exists
+      #       and has a specific content for the attribute name-value pair.
+      #       * +:s+ - (String) Strings are Unicode with UTF-8 binary encoding.
+      #         The maximum size is limited by the size of the primary key
+      #         (1024 bytes as a range part of a key or 2048 bytes as a single
+      #         part hash key) or the item size (64k).
+      #       * +:n+ - (String) Numbers are positive or negative exact-value
+      #         decimals and integers. A number can have up to 38 digits
+      #         precision and can be between 10^-128 to 10^+126.
+      #       * +:ss+ - (Array<String>) A set of strings.
+      #       * +:ns+ - (Array<String>) A set of numbers.
+      #     * +:exists+ - (Boolean) Specify whether or not a value already
+      #       exists for the attribute name-value pair.
+      #   * +:return_values+ - (String)
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +Attributes+ - (Hash<String,Hash>)
+      #     * +S+ - (String)
+      #     * +N+ - (String)
+      #     * +SS+ - (Array<String>)
+      #     * +NS+ - (Array<String>)
+      #   * +ConsumedCapacityUnits+ - (Numeric)
       define_client_method :update_item, 'UpdateItem'
 
       # Calls the UpdateTable API operation.
       # @method update_table(options = {})
-      #
-      # === Options:
-      #
-      # * +:table_name+ - *required* - (String) The name of the table you want
-      #   to update. Allowed characters are a-z, A-Z, 0-9, _ (underscore), -
-      #   (hyphen) and . (period).
-      # * +:provisioned_throughput+ - *required* - (Hash)
-      #   * +:read_capacity_units+ - *required* - (Integer) ReadCapacityUnits
-      #     are in terms of strictly consistent reads, assuming items of 1k. 2k
-      #     items require twice the ReadCapacityUnits. Eventually-consistent
-      #     reads only require half the ReadCapacityUnits of stirctly
-      #     consistent reads.
-      #   * +:write_capacity_units+ - *required* - (Integer) WriteCapacityUnits
-      #     are in terms of strictly consistent reads, assuming items of 1k. 2k
-      #     items require twice the WriteCapacityUnits.
-      #
-      # === Response Structure:
-      #
-      # * +TableDescription+ - (Hash)
-      #   * +TableName+ - (String)
-      #   * +KeySchema+ - (Hash)
-      #     * +HashKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #     * +RangeKeyElement+ - (Hash)
-      #       * +AttributeName+ - (String)
-      #       * +AttributeType+ - (String)
-      #   * +TableStatus+ - (String)
-      #   * +CreationDateTime+ - (Time)
-      #   * +ProvisionedThroughput+ - (Hash)
-      #     * +LastIncreaseDateTime+ - (Time)
-      #     * +LastDecreaseDateTime+ - (Time)
-      #     * +ReadCapacityUnits+ - (Integer)
-      #     * +WriteCapacityUnits+ - (Integer)
-      #   * +TableSizeBytes+ - (Integer)
-      #   * +ItemCount+ - (Integer)
-      #
+      # @param [Hash] options
+      #   * +:table_name+ - *required* - (String) The name of the table you
+      #     want to update. Allowed characters are a-z, A-Z, 0-9, _
+      #     (underscore), - (hyphen) and . (period).
+      #   * +:provisioned_throughput+ - *required* - (Hash)
+      #     * +:read_capacity_units+ - *required* - (Integer) ReadCapacityUnits
+      #       are in terms of strictly consistent reads, assuming items of 1k.
+      #       2k items require twice the ReadCapacityUnits.
+      #       Eventually-consistent reads only require half the
+      #       ReadCapacityUnits of stirctly consistent reads.
+      #     * +:write_capacity_units+ - *required* - (Integer)
+      #       WriteCapacityUnits are in terms of strictly consistent reads,
+      #       assuming items of 1k. 2k items require twice the
+      #       WriteCapacityUnits.
       # @return [Core::Response]
-      #
+      #   The #data method of the response object returns
+      #   a hash with the following structure:
+      #   * +TableDescription+ - (Hash)
+      #     * +TableName+ - (String)
+      #     * +KeySchema+ - (Hash)
+      #       * +HashKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #       * +RangeKeyElement+ - (Hash)
+      #         * +AttributeName+ - (String)
+      #         * +AttributeType+ - (String)
+      #     * +TableStatus+ - (String)
+      #     * +CreationDateTime+ - (Time)
+      #     * +ProvisionedThroughput+ - (Hash)
+      #       * +LastIncreaseDateTime+ - (Time)
+      #       * +LastDecreaseDateTime+ - (Time)
+      #       * +ReadCapacityUnits+ - (Integer)
+      #       * +WriteCapacityUnits+ - (Integer)
+      #     * +TableSizeBytes+ - (Integer)
+      #     * +ItemCount+ - (Integer)
       define_client_method :update_table, 'UpdateTable'
 
       ## end client methods ##