aws-sdk-dynamodb 1.60.0 → 1.80.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/resource.rb

@@ -143,8 +143,8 @@ module Aws::DynamoDB
     #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html
     #   [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -219,8 +219,8 @@ module Aws::DynamoDB
     #       the data types for those attributes must match those of the schema
     #       in the table's attribute definition.
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -315,6 +315,7 @@ module Aws::DynamoDB
     #         value: "TagValueString", # required
     #       },
     #     ],
+    #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #   })
     # @param [Hash] options ({})
     # @option options [required, Array<Types::AttributeDefinition>] :attribute_definitions
@@ -508,6 +509,9 @@ module Aws::DynamoDB
     #
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html
+    # @option options [String] :table_class
+    #   The table class of the new table. Valid values are `STANDARD` and
+    #   `STANDARD_INFREQUENT_ACCESS`.
     # @return [Table]
     def create_table(options = {})
       resp = @client.create_table(options)

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

@@ -86,17 +86,18 @@ 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.
     #
     # * `ACTIVE` - The table is ready for use.
     #
-    # * `INACCESSIBLE_ENCRYPTION_CREDENTIALS` - The AWS KMS key used to
-    #   encrypt the table in inaccessible. Table operations may fail due to
-    #   failure to use the AWS KMS key. DynamoDB will initiate the table
-    #   archival process when a table's AWS KMS key remains inaccessible
-    #   for more than seven days.
+    # * `INACCESSIBLE_ENCRYPTION_CREDENTIALS` - The KMS key used to encrypt
+    #   the table in inaccessible. Table operations may fail due to failure
+    #   to use the KMS key. DynamoDB will initiate the table archival
+    #   process when a table's KMS key remains inaccessible for more than
+    #   seven days.
     #
     # * `ARCHIVING` - The table is being archived. Operations are not
     #   allowed until archival is complete.
@@ -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
@@ -303,7 +304,7 @@ module Aws::DynamoDB
     # have the same timestamp. However, the combination of the following
     # three elements is guaranteed to be unique:
     #
-    # * AWS customer ID
+    # * Amazon Web Services customer ID
     #
     # * Table name
     #
@@ -321,7 +322,7 @@ module Aws::DynamoDB
     end
 
     # Represents the version of [global tables][1] in use, if the table is
-    # replicated across AWS Regions.
+    # replicated across Amazon Web Services Regions.
     #
     #
     #
@@ -356,6 +357,12 @@ module Aws::DynamoDB
       data[:archival_summary]
     end
 
+    # Contains details of the table class.
+    # @return [Types::TableClassSummary]
+    def table_class_summary
+      data[:table_class_summary]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -563,14 +570,18 @@ 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`.
     #
     #    </note>
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -728,8 +739,8 @@ module Aws::DynamoDB
     #   operation uses strongly consistent reads; otherwise, the operation
     #   uses eventually consistent reads.
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -889,14 +900,20 @@ module Aws::DynamoDB
     #   * `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair,
     #     then the content of the old item is returned.
     #
+    #   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`.
     #
     #    </note>
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -1089,8 +1106,9 @@ module Aws::DynamoDB
     #     matching items themselves.
     #
     #   * `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
@@ -1103,12 +1121,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
@@ -1196,8 +1214,8 @@ module Aws::DynamoDB
     #   The data type for `ExclusiveStartKey` must be String, Number, or
     #   Binary. No set data types are allowed.
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -1246,7 +1264,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.
@@ -1493,8 +1511,9 @@ module Aws::DynamoDB
     #     matching items themselves.
     #
     #   * `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
@@ -1507,12 +1526,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
@@ -1548,8 +1567,8 @@ module Aws::DynamoDB
     #   must specify the same segment whose previous `Scan` returned the
     #   corresponding value of `LastEvaluatedKey`.
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -1625,7 +1644,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
@@ -1795,6 +1814,7 @@ module Aws::DynamoDB
     #               },
     #             },
     #           ],
+    #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #         },
     #         update: {
     #           region_name: "RegionName", # required
@@ -1810,12 +1830,14 @@ module Aws::DynamoDB
     #               },
     #             },
     #           ],
+    #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #         },
     #         delete: {
     #           region_name: "RegionName", # required
     #         },
     #       },
     #     ],
+    #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #   })
     # @param [Hash] options ({})
     # @option options [Array<Types::AttributeDefinition>] :attribute_definitions
@@ -1888,6 +1910,9 @@ module Aws::DynamoDB
     #
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
+    # @option options [String] :table_class
+    #   The table class of the table to be updated. Valid values are
+    #   `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.
     # @return [Table]
     def update(options = {})
       options = options.merge(table_name: @name)
@@ -1992,8 +2017,8 @@ module Aws::DynamoDB
     #
     #   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:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table