aws-sdk-dynamodb 1.0.0.rc10 → 1.0.0.rc12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 335093c91784056cf21b20186742296b6be20ec8
-  data.tar.gz: 0419590bac02237fe754b94810d7ae37a92bfd32
+  metadata.gz: f3f8958c4b015b88676b1a7ab1fde4493492a227
+  data.tar.gz: c14ffcb74fe09afcce3cd480677870d5849d8916
 SHA512:
-  metadata.gz: c1c1e6ced0ce2abf4d3c6d0427d057f315201d13115aad9258af7f1ff8885a7488b8678c5e75ee463a2f1d7d05bdd00fa73be4baf824142fda40ee726ed91cdf
-  data.tar.gz: e21f784c7e53716808b70077fb0e8a1d276201d93eed8ba7e76977a4797a6904cf13cd7d59480ff0ea0c820ea7f525927544fbf706d3f5a7f6d6e64d6df9c5fc
+  metadata.gz: 5d90ed51f5803de8f3a25f800410af1194f3840503064ca029c9ddd14f5ae356179f1334a0462fce19f09e3148e52db3e29e2b682d52ae450f573debf0109ae3
+  data.tar.gz: 2c99cc0ef38f49666f9dc1fd84626fa71d8605735aead52ab290d5b2b48019539c9254f1740ac5d07e29aa5344bceddde5aa4e09f10286121fe868fcbd710128

data/lib/aws-sdk-dynamodb.rb

@@ -44,6 +44,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
 # @service
 module Aws::DynamoDB
 
-  GEM_VERSION = '1.0.0.rc10'
+  GEM_VERSION = '1.0.0.rc12'
 
 end

data/lib/aws-sdk-dynamodb/client.rb

@@ -563,12 +563,12 @@ module Aws::DynamoDB
     #     item. The item to be deleted is identified by a `Key` subelement:
     #
     #     * `Key` - A map of primary key attribute values that uniquely
-    #       identify the ! item. Each entry in this map consists of an
-    #       attribute name and an attribute value. For each primary key, you
-    #       must provide *all* of the key attributes. For example, with a
-    #       simple primary key, you only need to provide a value for the
-    #       partition key. For a composite primary key, you must provide
-    #       values for *both* the partition key and the sort key.
+    #       identify the item. Each entry in this map consists of an attribute
+    #       name and an attribute value. For each primary key, you must
+    #       provide *all* of the key attributes. For example, with a simple
+    #       primary key, you only need to provide a value for the partition
+    #       key. For a composite primary key, you must provide values for
+    #       *both* the partition key and the sort key.
     #
     #     ^
     #
@@ -1141,7 +1141,7 @@ module Aws::DynamoDB
     #   values for both the partition key and the sort key.
     #
     # @option params [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -2080,11 +2080,32 @@ module Aws::DynamoDB
     # the specified table, the new item completely replaces the existing
     # item. You can perform a conditional put operation (add a new item if
     # one with the specified primary key doesn't exist), or replace an
-    # existing item if it has certain attribute values.
+    # existing item if it has certain attribute values. You can return the
+    # item's attribute values in the same operation, using the
+    # `ReturnValues` parameter.
     #
-    # In addition to putting an item, you can also return the item's
-    # attribute values in the same operation, using the `ReturnValues`
-    # parameter.
+    # This topic provides general information about the `PutItem` API.
+    #
+    #  For information on how to call the `PutItem` API using the AWS SDK in
+    # specific languages, see the following:
+    #
+    #  * [ PutItem in the AWS Command Line Interface ][1]
+    #
+    # * [ PutItem in the AWS SDK for .NET ][2]
+    #
+    # * [ PutItem in the AWS SDK for C++ ][3]
+    #
+    # * [ PutItem in the AWS SDK for Go ][4]
+    #
+    # * [ PutItem in the AWS SDK for Java ][5]
+    #
+    # * [ PutItem in the AWS SDK for JavaScript ][6]
+    #
+    # * [ PutItem in the AWS SDK for PHP V3 ][7]
+    #
+    # * [ PutItem in the AWS SDK for Python ][8]
+    #
+    # * [ PutItem in the AWS SDK for Ruby V2 ][9]
     #
     # When you add an item, the primary key attribute(s) are the only
     # required attributes. Attribute values cannot be null. String and
@@ -2101,12 +2122,21 @@ module Aws::DynamoDB
     #
     #  </note>
     #
-    # For more information about `PutItem`, see [Working with Items][1] in
+    # For more information about `PutItem`, see [Working with Items][10] in
     # the *Amazon DynamoDB Developer Guide*.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
+    # [1]: http://docs.aws.amazon.com/goto/aws-cli/dynamodb-2012-08-10/PutItem
+    # [2]: http://docs.aws.amazon.com/goto/DotNetSDKV3/dynamodb-2012-08-10/PutItem
+    # [3]: http://docs.aws.amazon.com/goto/SdkForCpp/dynamodb-2012-08-10/PutItem
+    # [4]: http://docs.aws.amazon.com/goto/SdkForGoV1/dynamodb-2012-08-10/PutItem
+    # [5]: http://docs.aws.amazon.com/goto/SdkForJava/dynamodb-2012-08-10/PutItem
+    # [6]: http://docs.aws.amazon.com/goto/AWSJavaScriptSDK/dynamodb-2012-08-10/PutItem
+    # [7]: http://docs.aws.amazon.com/goto/SdkForPHPV3/dynamodb-2012-08-10/PutItem
+    # [8]: http://docs.aws.amazon.com/goto/boto3/dynamodb-2012-08-10/PutItem
+    # [9]: http://docs.aws.amazon.com/goto/SdkForRubyV2/dynamodb-2012-08-10/PutItem
+    # [10]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
     #
     # @option params [required, String] :table_name
     #   The name of the table to contain the item.
@@ -2135,7 +2165,7 @@ module Aws::DynamoDB
     #   [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey
     #
     # @option params [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -2380,28 +2410,57 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # A `Query` operation uses the primary key of a table or a secondary
-    # index to directly access items from that table or index.
+    # The `Query` operation finds items based on primary key values. You can
+    # query any table or secondary index that has a composite primary key (a
+    # partition key and a sort key).
     #
     # Use the `KeyConditionExpression` parameter to provide a specific value
     # for the partition key. The `Query` operation will return all of the
     # items from the table or index with that partition key value. You can
     # optionally narrow the scope of the `Query` operation by specifying a
     # sort key value and a comparison operator in `KeyConditionExpression`.
-    # You can use the `ScanIndexForward` parameter to get results in forward
-    # or reverse order, by sort key.
+    # To further refine the `Query` results, you can optionally provide a
+    # `FilterExpression`. A `FilterExpression` determines which items within
+    # the results should be returned to you. All of the other results are
+    # discarded.
+    #
+    # A `Query` operation always returns a result set. If no matching items
+    # are found, the result set will be empty. Queries that do not return
+    # results consume the minimum number of read capacity units for that
+    # type of read operation.
+    #
+    # <note markdown="1"> DynamoDB calculates the number of read capacity units consumed based
+    # on item size, not on the amount of data that is returned to an
+    # application. The number of capacity units consumed will be the same
+    # whether you request all of the attributes (the default behavior) or
+    # just some of them (using a projection expression). The number will
+    # also be the same whether or not you use a `FilterExpression`.
     #
-    # Queries that do not return results consume the minimum number of read
-    # capacity units for that type of read operation.
+    #  </note>
     #
-    # If the total number of items meeting the query criteria exceeds the
-    # result set size limit of 1 MB, the query stops and results are
-    # returned to the user with the `LastEvaluatedKey` element to continue
-    # the query in a subsequent operation. Unlike a `Scan` operation, a
-    # `Query` operation never returns both an empty result set and a
-    # `LastEvaluatedKey` value. `LastEvaluatedKey` is only provided if you
-    # have used the `Limit` parameter, or if the result set exceeds 1 MB
-    # (prior to applying a filter).
+    # `Query` results are always sorted by the sort key value. If the data
+    # type of the sort key is Number, the results are returned in numeric
+    # order; otherwise, the results are returned in order of UTF-8 bytes. By
+    # default, the sort order is ascending. To reverse the order, set the
+    # `ScanIndexForward` parameter to false.
+    #
+    # A single `Query` operation will read up to the maximum number of items
+    # set (if using the `Limit` parameter) or a maximum of 1 MB of data and
+    # then apply any filtering to the results using `FilterExpression`. If
+    # `LastEvaluatedKey` is present in the response, you will need to
+    # paginate the result set. For more information, see [Paginating the
+    # Results][1] in the *Amazon DynamoDB Developer Guide*.
+    #
+    # `FilterExpression` is applied after a `Query` finishes, but before the
+    # results are returned. A `FilterExpression` cannot contain partition
+    # key or sort key attributes. You need to specify those attributes in
+    # the `KeyConditionExpression`.
+    #
+    # <note markdown="1"> A `Query` operation can return an empty result set and a
+    # `LastEvaluatedKey` if all the items read for the page of results are
+    # filtered out.
+    #
+    #  </note>
     #
     # You can query a table, a local secondary index, or a global secondary
     # index. For a query on a table or on a local secondary index, you can
@@ -2410,6 +2469,10 @@ module Aws::DynamoDB
     # consistent reads only, so do not specify `ConsistentRead` when
     # querying a global secondary index.
     #
+    #
+    #
+    # [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.Pagination
+    #
     # @option params [required, String] :table_name
     #   The name of the table containing the requested items.
     #
@@ -2883,21 +2946,29 @@ module Aws::DynamoDB
     # operation. The results also include the number of items exceeding the
     # limit. A scan can result in no table data meeting the filter criteria.
     #
-    # By default, `Scan` operations proceed sequentially; however, for
-    # faster performance on a large table or secondary index, applications
-    # can request a parallel `Scan` operation by providing the `Segment` and
+    # A single `Scan` operation will read up to the maximum number of items
+    # set (if using the `Limit` parameter) or a maximum of 1 MB of data and
+    # then apply any filtering to the results using `FilterExpression`. If
+    # `LastEvaluatedKey` is present in the response, you will need to
+    # paginate the result set. For more information, see [Paginating the
+    # Results][1] in the *Amazon DynamoDB Developer Guide*.
+    #
+    # `Scan` operations proceed sequentially; however, for faster
+    # performance on a large table or secondary index, applications can
+    # request a parallel `Scan` operation by providing the `Segment` and
     # `TotalSegments` parameters. For more information, see [Parallel
-    # Scan][1] in the *Amazon DynamoDB Developer Guide*.
+    # Scan][2] in the *Amazon DynamoDB Developer Guide*.
     #
-    # By default, `Scan` uses eventually consistent reads when accessing the
-    # data in a table; therefore, the result set might not include the
-    # changes to data in the table immediately before the operation began.
-    # If you need a consistent copy of the data, as of the time that the
-    # Scan begins, you can set the `ConsistentRead` parameter to `true`.
+    # `Scan` uses eventually consistent reads when accessing the data in a
+    # table; therefore, the result set might not include the changes to data
+    # in the table immediately before the operation began. If you need a
+    # consistent copy of the data, as of the time that the `Scan` begins,
+    # you can set the `ConsistentRead` parameter to `true`.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#QueryAndScanParallelScan
+    # [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html#Scan.Pagination
+    # [2]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html#Scan.ParallelScan
     #
     # @option params [required, String] :table_name
     #   The name of the table containing the requested items; or, if you
@@ -3417,7 +3488,7 @@ module Aws::DynamoDB
     #   [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributeUpdates.html
     #
     # @option params [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -3436,8 +3507,8 @@ module Aws::DynamoDB
     #
     # @option params [String] :return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appeared either before or after they were updated. For `UpdateItem`,
-    #   the valid values are:
+    #   appear before or after they are updated. For `UpdateItem`, the valid
+    #   values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for
@@ -3457,9 +3528,9 @@ module Aws::DynamoDB
     #
     #   There is no additional cost associated with requesting a return value
     #   aside from the small network and processing overhead of receiving a
-    #   larger response. No Read Capacity Units are consumed.
+    #   larger response. No read capacity units are consumed.
     #
-    #   Values returned are strongly consistent
+    #   The values returned are strongly consistent.
     #
     # @option params [String] :return_consumed_capacity
     #   Determines the level of detail about provisioned throughput
@@ -3712,7 +3783,7 @@ module Aws::DynamoDB
     #   {
     #     attributes: {
     #       "AlbumTitle" => {
-    #         s: "Songs About Life", 
+    #         s: "Louder Than Ever", 
     #       }, 
     #       "Artist" => {
     #         s: "Acme Band", 
@@ -3720,6 +3791,9 @@ module Aws::DynamoDB
     #       "SongTitle" => {
     #         s: "Happy Day", 
     #       }, 
+    #       "Year" => {
+    #         n: "2015", 
+    #       }, 
     #     }, 
     #   }
     #
@@ -4011,12 +4085,12 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # Specify the lifetime of individual table items. The database
-    # automatically removes the item at the expiration of the item. The
-    # UpdateTimeToLive method will enable or disable TTL for the specified
-    # table. A successful `UpdateTimeToLive` call returns the current
-    # `TimeToLiveSpecification`; it may take up to one hour for the change
-    # to fully process.
+    # The UpdateTimeToLive method will enable or disable TTL for the
+    # specified table. A successful `UpdateTimeToLive` call returns the
+    # current `TimeToLiveSpecification`; it may take up to one hour for the
+    # change to fully process. Any additional `UpdateTimeToLive` calls for
+    # the same table during this one hour duration result in a
+    # `ValidationException`.
     #
     # TTL compares the current time in epoch time format to the time stored
     # in the TTL attribute of an item. If the epoch time value stored in the
@@ -4096,7 +4170,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.0.0.rc10'
+      context[:gem_version] = '1.0.0.rc12'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-dynamodb/resource.rb

@@ -181,12 +181,12 @@ module Aws::DynamoDB
     #     item. The item to be deleted is identified by a `Key` subelement:
     #
     #     * `Key` - A map of primary key attribute values that uniquely
-    #       identify the ! item. Each entry in this map consists of an
-    #       attribute name and an attribute value. For each primary key, you
-    #       must provide *all* of the key attributes. For example, with a
-    #       simple primary key, you only need to provide a value for the
-    #       partition key. For a composite primary key, you must provide
-    #       values for *both* the partition key and the sort key.
+    #       identify the item. Each entry in this map consists of an attribute
+    #       name and an attribute value. For each primary key, you must
+    #       provide *all* of the key attributes. For example, with a simple
+    #       primary key, you only need to provide a value for the partition
+    #       key. For a composite primary key, you must provide values for
+    #       *both* the partition key and the sort key.
     #
     #     ^
     #

data/lib/aws-sdk-dynamodb/table.rb

@@ -369,7 +369,7 @@ module Aws::DynamoDB
     #   for the partition key. For a composite primary key, you must provide
     #   values for both the partition key and the sort key.
     # @option options [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -698,7 +698,7 @@ module Aws::DynamoDB
     #
     #   [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey
     # @option options [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -1697,7 +1697,7 @@ module Aws::DynamoDB
     #
     #   [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributeUpdates.html
     # @option options [Hash<String,Types::ExpectedAttributeValue>] :expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB Developer
     #   Guide*.
     #
@@ -1714,8 +1714,8 @@ module Aws::DynamoDB
     #   [1]: http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html
     # @option options [String] :return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appeared either before or after they were updated. For `UpdateItem`,
-    #   the valid values are:
+    #   appear before or after they are updated. For `UpdateItem`, the valid
+    #   values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for
@@ -1735,9 +1735,9 @@ module Aws::DynamoDB
     #
     #   There is no additional cost associated with requesting a return value
     #   aside from the small network and processing overhead of receiving a
-    #   larger response. No Read Capacity Units are consumed.
+    #   larger response. No read capacity units are consumed.
     #
-    #   Values returned are strongly consistent
+    #   The values returned are strongly consistent.
     # @option options [String] :return_consumed_capacity
     #   Determines the level of detail about provisioned throughput
     #   consumption that is returned in the response:

data/lib/aws-sdk-dynamodb/types.rb

@@ -509,7 +509,7 @@ module Aws::DynamoDB
     #     subelement:
     #
     #     * `Key` - A map of primary key attribute values that uniquely
-    #       identify the ! item. Each entry in this map consists of an
+    #       identify the item. Each entry in this map consists of an
     #       attribute name and an attribute value. For each primary key, you
     #       must provide *all* of the key attributes. For example, with a
     #       simple primary key, you only need to provide a value for the
@@ -1332,7 +1332,7 @@ module Aws::DynamoDB
     #   @return [Hash<String,Types::AttributeValue>]
     #
     # @!attribute [rw] expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB
     #   Developer Guide*.
     #
@@ -3094,7 +3094,7 @@ module Aws::DynamoDB
     #   @return [Hash<String,Types::AttributeValue>]
     #
     # @!attribute [rw] expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB
     #   Developer Guide*.
     #
@@ -4879,7 +4879,7 @@ module Aws::DynamoDB
     #   @return [Hash<String,Types::AttributeValueUpdate>]
     #
     # @!attribute [rw] expected
-    #   This is a legacy parameter. Use `ConditionExpresssion` instead. For
+    #   This is a legacy parameter. Use `ConditionExpression` instead. For
     #   more information, see [Expected][1] in the *Amazon DynamoDB
     #   Developer Guide*.
     #
@@ -4900,8 +4900,8 @@ module Aws::DynamoDB
     #
     # @!attribute [rw] return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appeared either before or after they were updated. For `UpdateItem`,
-    #   the valid values are:
+    #   appear before or after they are updated. For `UpdateItem`, the valid
+    #   values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for
@@ -4921,9 +4921,9 @@ module Aws::DynamoDB
     #
     #   There is no additional cost associated with requesting a return
     #   value aside from the small network and processing overhead of
-    #   receiving a larger response. No Read Capacity Units are consumed.
+    #   receiving a larger response. No read capacity units are consumed.
     #
-    #   Values returned are strongly consistent
+    #   The values returned are strongly consistent.
     #   @return [String]
     #
     # @!attribute [rw] return_consumed_capacity
@@ -5173,10 +5173,13 @@ module Aws::DynamoDB
     # Represents the output of an `UpdateItem` operation.
     #
     # @!attribute [rw] attributes
-    #   A map of attribute values as they appeared before the `UpdateItem`
-    #   operation. This map only appears if `ReturnValues` was specified as
-    #   something other than `NONE` in the request. Each element represents
-    #   one attribute.
+    #   A map of attribute values as they appear before or after the
+    #   `UpdateItem` operation, as determined by the `ReturnValues`
+    #   parameter.
+    #
+    #   The `Attributes` map is only present if `ReturnValues` was specified
+    #   as something other than `NONE` in the request. Each element
+    #   represents one attribute.
     #   @return [Hash<String,Types::AttributeValue>]
     #
     # @!attribute [rw] consumed_capacity

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodb
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc10
+  version: 1.0.0.rc12
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-07-13 00:00:00.000000000 Z
+date: 2017-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc17
+        version: 3.0.0.rc18
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.0.rc17
+        version: 3.0.0.rc18
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement