aws-sdk-dynamodb 1.74.0 → 1.82.0

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

@@ -37,6 +37,8 @@ module Aws::DynamoDB
   # * {GlobalTableAlreadyExistsException}
   # * {GlobalTableNotFoundException}
   # * {IdempotentParameterMismatchException}
+  # * {ImportConflictException}
+  # * {ImportNotFoundException}
   # * {IndexNotFoundException}
   # * {InternalServerError}
   # * {InvalidExportTimeException}
@@ -213,6 +215,36 @@ module Aws::DynamoDB
       end
     end
 
+    class ImportConflictException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::DynamoDB::Types::ImportConflictException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
+    class ImportNotFoundException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::DynamoDB::Types::ImportNotFoundException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+    end
+
     class IndexNotFoundException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

data/lib/aws-sdk-dynamodb/plugins/endpoints.rb

@@ -0,0 +1,174 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+
+module Aws::DynamoDB
+  module Plugins
+    class Endpoints < Seahorse::Client::Plugin
+      option(
+        :endpoint_provider,
+        doc_type: 'Aws::DynamoDB::EndpointProvider',
+        docstring: 'The endpoint provider used to resolve endpoints. Any '\
+                   'object that responds to `#resolve_endpoint(parameters)` '\
+                   'where `parameters` is a Struct similar to '\
+                   '`Aws::DynamoDB::EndpointParameters`'
+      ) do |cfg|
+        Aws::DynamoDB::EndpointProvider.new
+      end
+
+      # @api private
+      class Handler < Seahorse::Client::Handler
+        def call(context)
+          # If endpoint was discovered, do not resolve or apply the endpoint.
+          unless context[:discovered_endpoint]
+            params = parameters_for_operation(context)
+            endpoint = context.config.endpoint_provider.resolve_endpoint(params)
+
+            context.http_request.endpoint = endpoint.url
+            apply_endpoint_headers(context, endpoint.headers)
+          end
+
+          context[:endpoint_params] = params
+          context[:auth_scheme] =
+            Aws::Endpoints.resolve_auth_scheme(context, endpoint)
+
+          @handler.call(context)
+        end
+
+        private
+
+        def apply_endpoint_headers(context, headers)
+          headers.each do |key, values|
+            value = values
+              .compact
+              .map { |s| Seahorse::Util.escape_header_list_string(s.to_s) }
+              .join(',')
+
+            context.http_request.headers[key] = value
+          end
+        end
+
+        def parameters_for_operation(context)
+          case context.operation_name
+          when :batch_execute_statement
+            Aws::DynamoDB::Endpoints::BatchExecuteStatement.build(context)
+          when :batch_get_item
+            Aws::DynamoDB::Endpoints::BatchGetItem.build(context)
+          when :batch_write_item
+            Aws::DynamoDB::Endpoints::BatchWriteItem.build(context)
+          when :create_backup
+            Aws::DynamoDB::Endpoints::CreateBackup.build(context)
+          when :create_global_table
+            Aws::DynamoDB::Endpoints::CreateGlobalTable.build(context)
+          when :create_table
+            Aws::DynamoDB::Endpoints::CreateTable.build(context)
+          when :delete_backup
+            Aws::DynamoDB::Endpoints::DeleteBackup.build(context)
+          when :delete_item
+            Aws::DynamoDB::Endpoints::DeleteItem.build(context)
+          when :delete_table
+            Aws::DynamoDB::Endpoints::DeleteTable.build(context)
+          when :describe_backup
+            Aws::DynamoDB::Endpoints::DescribeBackup.build(context)
+          when :describe_continuous_backups
+            Aws::DynamoDB::Endpoints::DescribeContinuousBackups.build(context)
+          when :describe_contributor_insights
+            Aws::DynamoDB::Endpoints::DescribeContributorInsights.build(context)
+          when :describe_endpoints
+            Aws::DynamoDB::Endpoints::DescribeEndpoints.build(context)
+          when :describe_export
+            Aws::DynamoDB::Endpoints::DescribeExport.build(context)
+          when :describe_global_table
+            Aws::DynamoDB::Endpoints::DescribeGlobalTable.build(context)
+          when :describe_global_table_settings
+            Aws::DynamoDB::Endpoints::DescribeGlobalTableSettings.build(context)
+          when :describe_import
+            Aws::DynamoDB::Endpoints::DescribeImport.build(context)
+          when :describe_kinesis_streaming_destination
+            Aws::DynamoDB::Endpoints::DescribeKinesisStreamingDestination.build(context)
+          when :describe_limits
+            Aws::DynamoDB::Endpoints::DescribeLimits.build(context)
+          when :describe_table
+            Aws::DynamoDB::Endpoints::DescribeTable.build(context)
+          when :describe_table_replica_auto_scaling
+            Aws::DynamoDB::Endpoints::DescribeTableReplicaAutoScaling.build(context)
+          when :describe_time_to_live
+            Aws::DynamoDB::Endpoints::DescribeTimeToLive.build(context)
+          when :disable_kinesis_streaming_destination
+            Aws::DynamoDB::Endpoints::DisableKinesisStreamingDestination.build(context)
+          when :enable_kinesis_streaming_destination
+            Aws::DynamoDB::Endpoints::EnableKinesisStreamingDestination.build(context)
+          when :execute_statement
+            Aws::DynamoDB::Endpoints::ExecuteStatement.build(context)
+          when :execute_transaction
+            Aws::DynamoDB::Endpoints::ExecuteTransaction.build(context)
+          when :export_table_to_point_in_time
+            Aws::DynamoDB::Endpoints::ExportTableToPointInTime.build(context)
+          when :get_item
+            Aws::DynamoDB::Endpoints::GetItem.build(context)
+          when :import_table
+            Aws::DynamoDB::Endpoints::ImportTable.build(context)
+          when :list_backups
+            Aws::DynamoDB::Endpoints::ListBackups.build(context)
+          when :list_contributor_insights
+            Aws::DynamoDB::Endpoints::ListContributorInsights.build(context)
+          when :list_exports
+            Aws::DynamoDB::Endpoints::ListExports.build(context)
+          when :list_global_tables
+            Aws::DynamoDB::Endpoints::ListGlobalTables.build(context)
+          when :list_imports
+            Aws::DynamoDB::Endpoints::ListImports.build(context)
+          when :list_tables
+            Aws::DynamoDB::Endpoints::ListTables.build(context)
+          when :list_tags_of_resource
+            Aws::DynamoDB::Endpoints::ListTagsOfResource.build(context)
+          when :put_item
+            Aws::DynamoDB::Endpoints::PutItem.build(context)
+          when :query
+            Aws::DynamoDB::Endpoints::Query.build(context)
+          when :restore_table_from_backup
+            Aws::DynamoDB::Endpoints::RestoreTableFromBackup.build(context)
+          when :restore_table_to_point_in_time
+            Aws::DynamoDB::Endpoints::RestoreTableToPointInTime.build(context)
+          when :scan
+            Aws::DynamoDB::Endpoints::Scan.build(context)
+          when :tag_resource
+            Aws::DynamoDB::Endpoints::TagResource.build(context)
+          when :transact_get_items
+            Aws::DynamoDB::Endpoints::TransactGetItems.build(context)
+          when :transact_write_items
+            Aws::DynamoDB::Endpoints::TransactWriteItems.build(context)
+          when :untag_resource
+            Aws::DynamoDB::Endpoints::UntagResource.build(context)
+          when :update_continuous_backups
+            Aws::DynamoDB::Endpoints::UpdateContinuousBackups.build(context)
+          when :update_contributor_insights
+            Aws::DynamoDB::Endpoints::UpdateContributorInsights.build(context)
+          when :update_global_table
+            Aws::DynamoDB::Endpoints::UpdateGlobalTable.build(context)
+          when :update_global_table_settings
+            Aws::DynamoDB::Endpoints::UpdateGlobalTableSettings.build(context)
+          when :update_item
+            Aws::DynamoDB::Endpoints::UpdateItem.build(context)
+          when :update_table
+            Aws::DynamoDB::Endpoints::UpdateTable.build(context)
+          when :update_table_replica_auto_scaling
+            Aws::DynamoDB::Endpoints::UpdateTableReplicaAutoScaling.build(context)
+          when :update_time_to_live
+            Aws::DynamoDB::Endpoints::UpdateTimeToLive.build(context)
+          end
+        end
+      end
+
+      def add_handlers(handlers, _config)
+        handlers.add(Handler, step: :build, priority: 75)
+      end
+    end
+  end
+end

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

@@ -86,7 +86,8 @@ module Aws::DynamoDB
     #
     # * `CREATING` - The table is being created.
     #
-    # * `UPDATING` - The table is being updated.
+    # * `UPDATING` - The table/index configuration is being updated. The
+    #   table/index remains available for data operations when `UPDATING`.
     #
     # * `DELETING` - The table is being deleted.
     #
@@ -194,9 +195,9 @@ module Aws::DynamoDB
     #   * `NonKeyAttributes` - A list of one or more non-key attribute names
     #     that are projected into the secondary index. The total count of
     #     attributes provided in `NonKeyAttributes`, summed across all of
-    #     the secondary indexes, must not exceed 20. If you project the same
-    #     attribute into two different indexes, this counts as two distinct
-    #     attributes when determining the total.
+    #     the secondary indexes, must not exceed 100. If you project the
+    #     same attribute into two different indexes, this counts as two
+    #     distinct attributes when determining the total.
     #
     # * `IndexSizeBytes` - Represents the total size of the index, in bytes.
     #   DynamoDB updates this value approximately every six hours. Recent
@@ -275,9 +276,9 @@ module Aws::DynamoDB
     #   * `NonKeyAttributes` - A list of one or more non-key attribute names
     #     that are projected into the secondary index. The total count of
     #     attributes provided in `NonKeyAttributes`, summed across all of
-    #     the secondary indexes, must not exceed 20. If you project the same
-    #     attribute into two different indexes, this counts as two distinct
-    #     attributes when determining the total.
+    #     the secondary indexes, must not exceed 100. If you project the
+    #     same attribute into two different indexes, this counts as two
+    #     distinct attributes when determining the total.
     #
     # * `ProvisionedThroughput` - The provisioned throughput settings for
     #   the global secondary index, consisting of read and write capacity
@@ -538,7 +539,7 @@ module Aws::DynamoDB
     #   A map of attribute names to `AttributeValue` objects, representing the
     #   primary key of the item to delete.
     #
-    #   For the primary key, you must provide all of the attributes. For
+    #   For the 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.
@@ -569,6 +570,10 @@ module Aws::DynamoDB
     #
     #   * `ALL_OLD` - The content of the old item is returned.
     #
+    #   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.
+    #
     #   <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
     #   however, `DeleteItem` does not recognize any values other than `NONE`
     #   or `ALL_OLD`.
@@ -897,6 +902,10 @@ module Aws::DynamoDB
     #
     #   The values returned are strongly consistent.
     #
+    #   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.
+    #
     #   <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
     #   however, `PutItem` does not recognize any values other than `NONE` or
     #   `ALL_OLD`.
@@ -1094,11 +1103,14 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
-    #     `AttributesToGet`. This return value is equivalent to specifying
-    #     `AttributesToGet` without specifying any value for `Select`.
+    #     `ProjectionExpression`. This return value is equivalent to
+    #     specifying `ProjectionExpression` without specifying any value for
+    #     `Select`.
     #
     #     If you query or scan a local secondary index and request only
     #     attributes that are projected into that index, the operation will
@@ -1111,12 +1123,12 @@ module Aws::DynamoDB
     #     attributes that are projected into the index. Global secondary index
     #     queries cannot fetch attributes from the parent table.
     #
-    #   If neither `Select` nor `AttributesToGet` are specified, DynamoDB
+    #   If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
     #   defaults to `ALL_ATTRIBUTES` when accessing a table, and
     #   `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
-    #   both `Select` and `AttributesToGet` together in a single request,
+    #   both `Select` and `ProjectionExpression` together in a single request,
     #   unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
-    #   equivalent to specifying `AttributesToGet` without any value for
+    #   equivalent to specifying `ProjectionExpression` without any value for
     #   `Select`.)
     #
     #   <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -1254,7 +1266,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
     # @option options [String] :key_condition_expression
     #   The condition that specifies the key values for items to be retrieved
     #   by the `Query` action.
@@ -1498,11 +1510,14 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
-    #     `AttributesToGet`. This return value is equivalent to specifying
-    #     `AttributesToGet` without specifying any value for `Select`.
+    #     `ProjectionExpression`. This return value is equivalent to
+    #     specifying `ProjectionExpression` without specifying any value for
+    #     `Select`.
     #
     #     If you query or scan a local secondary index and request only
     #     attributes that are projected into that index, the operation reads
@@ -1515,12 +1530,12 @@ module Aws::DynamoDB
     #     attributes that are projected into the index. Global secondary index
     #     queries cannot fetch attributes from the parent table.
     #
-    #   If neither `Select` nor `AttributesToGet` are specified, DynamoDB
+    #   If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
     #   defaults to `ALL_ATTRIBUTES` when accessing a table, and
     #   `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
-    #   both `Select` and `AttributesToGet` together in a single request,
+    #   both `Select` and `ProjectionExpression` together in a single request,
     #   unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
-    #   equivalent to specifying `AttributesToGet` without any value for
+    #   equivalent to specifying `ProjectionExpression` without any value for
     #   `Select`.)
     #
     #   <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -1633,7 +1648,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
     # @option options [Hash<String,String>] :expression_attribute_names
     #   One or more substitution tokens for attribute names in an expression.
     #   The following are some use cases for using
@@ -1891,8 +1906,8 @@ module Aws::DynamoDB
     #   A list of replica update actions (create, delete, or update) for the
     #   table.
     #
-    #   <note markdown="1"> This property only applies to [Version 2019.11.21][1] of global
-    #   tables.
+    #   <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
+    #   global tables.
     #
     #    </note>
     #
@@ -1981,8 +1996,8 @@ module Aws::DynamoDB
     #   [1]: https://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
-    #   appear before or after they are updated. For `UpdateItem`, the valid
-    #   values are:
+    #   appear before or after they are successfully 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