aws-sdk-dynamodb 1.149.0 → 1.150.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 435be107fbcf4d44bb424f39e45923b17340aa6721d4c4bb83dadf36016812db
-  data.tar.gz: 4cf8e4d56449726fe2b90a59e7e61e53497413041ac528436abf5dafdf5f50c4
+  metadata.gz: 389e107d8e77c70c218525a734f193b615cc8de6ec27d38d8adf26716e0c7031
+  data.tar.gz: b60017c380d224910ffb8ea5b92ec6c14eda8faf8233c4f651b52d4c67eb0154
 SHA512:
-  metadata.gz: 77245a354cdaa2075e415defa7f17481cb9428482453150c5dd3a547b140768981892e82d008b2edbb342deed8965054f1a54d29ed1c202c25882abcb7b724e0
-  data.tar.gz: 2d2c96bbff1d4da05d50bd9d3645e76104f6c67f5b3727a64e35cffb722e32c29e9c1e20311f945d85f3c54e3ebad5ec3568dca2ac2c30264bf8c76fb19655f2
+  metadata.gz: 4a564f504a0778bca9f47e0fcf6dc16eab3864890289e6438ee08131521cffb2e571934744e1ba69ab26a607e2d4f7ec50f6af1b360e4797a1f82f53bea1545c
+  data.tar.gz: 968be7ffa061e2edba0a24fe19628fab7dcc2be1edf0e0744d520c08a28d12672bc2830a4afcf40645cc700da0a7c29ceeb34c47b49e19924d9b4382f8717379

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.150.0 (2025-08-14)
+------------------
+
+* Feature - This release 1/ Adds support for throttled keys mode for CloudWatch Contributor Insights, 2/ Adds throttling reasons to exceptions across dataplane APIs. 3/ Explicitly models ThrottlingException as a class in statically typed languages. Refer to the launch day blog post for more details.
+
 1.149.0 (2025-08-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.149.0
+1.150.0

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

@@ -2648,6 +2648,7 @@ module Aws::DynamoDB
     #   * {Types::DescribeContributorInsightsOutput#contributor_insights_status #contributor_insights_status} => String
     #   * {Types::DescribeContributorInsightsOutput#last_update_date_time #last_update_date_time} => Time
     #   * {Types::DescribeContributorInsightsOutput#failure_exception #failure_exception} => Types::FailureException
+    #   * {Types::DescribeContributorInsightsOutput#contributor_insights_mode #contributor_insights_mode} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -2666,6 +2667,7 @@ module Aws::DynamoDB
     #   resp.last_update_date_time #=> Time
     #   resp.failure_exception.exception_name #=> String
     #   resp.failure_exception.exception_description #=> String
+    #   resp.contributor_insights_mode #=> String, one of "ACCESSED_AND_THROTTLED_KEYS", "THROTTLED_KEYS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeContributorInsights AWS API Documentation
     #
@@ -4449,6 +4451,7 @@ module Aws::DynamoDB
     #   resp.contributor_insights_summaries[0].table_name #=> String
     #   resp.contributor_insights_summaries[0].index_name #=> String
     #   resp.contributor_insights_summaries[0].contributor_insights_status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED", "FAILED"
+    #   resp.contributor_insights_summaries[0].contributor_insights_mode #=> String, one of "ACCESSED_AND_THROTTLED_KEYS", "THROTTLED_KEYS"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListContributorInsights AWS API Documentation
@@ -7151,11 +7154,16 @@ module Aws::DynamoDB
     # @option params [required, String] :contributor_insights_action
     #   Represents the contributor insights action.
     #
+    # @option params [String] :contributor_insights_mode
+    #   Specifies whether to track all access and throttled events or
+    #   throttled events only for the DynamoDB table or index.
+    #
     # @return [Types::UpdateContributorInsightsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateContributorInsightsOutput#table_name #table_name} => String
     #   * {Types::UpdateContributorInsightsOutput#index_name #index_name} => String
     #   * {Types::UpdateContributorInsightsOutput#contributor_insights_status #contributor_insights_status} => String
+    #   * {Types::UpdateContributorInsightsOutput#contributor_insights_mode #contributor_insights_mode} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -7163,6 +7171,7 @@ module Aws::DynamoDB
     #     table_name: "TableArn", # required
     #     index_name: "IndexName",
     #     contributor_insights_action: "ENABLE", # required, accepts ENABLE, DISABLE
+    #     contributor_insights_mode: "ACCESSED_AND_THROTTLED_KEYS", # accepts ACCESSED_AND_THROTTLED_KEYS, THROTTLED_KEYS
     #   })
     #
     # @example Response structure
@@ -7170,6 +7179,7 @@ module Aws::DynamoDB
     #   resp.table_name #=> String
     #   resp.index_name #=> String
     #   resp.contributor_insights_status #=> String, one of "ENABLING", "ENABLED", "DISABLING", "DISABLED", "FAILED"
+    #   resp.contributor_insights_mode #=> String, one of "ACCESSED_AND_THROTTLED_KEYS", "THROTTLED_KEYS"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateContributorInsights AWS API Documentation
     #
@@ -8671,7 +8681,7 @@ module Aws::DynamoDB
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.149.0'
+      context[:gem_version] = '1.150.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -36,6 +36,7 @@ module Aws::DynamoDB
     AutoScalingSettingsUpdate = Shapes::StructureShape.new(name: 'AutoScalingSettingsUpdate')
     AutoScalingTargetTrackingScalingPolicyConfigurationDescription = Shapes::StructureShape.new(name: 'AutoScalingTargetTrackingScalingPolicyConfigurationDescription')
     AutoScalingTargetTrackingScalingPolicyConfigurationUpdate = Shapes::StructureShape.new(name: 'AutoScalingTargetTrackingScalingPolicyConfigurationUpdate')
+    AvailabilityErrorMessage = Shapes::StringShape.new(name: 'AvailabilityErrorMessage')
     Backfilling = Shapes::BooleanShape.new(name: 'Backfilling')
     BackupArn = Shapes::StringShape.new(name: 'BackupArn')
     BackupCreationDateTime = Shapes::TimestampShape.new(name: 'BackupCreationDateTime')
@@ -93,6 +94,7 @@ module Aws::DynamoDB
     ContinuousBackupsStatus = Shapes::StringShape.new(name: 'ContinuousBackupsStatus')
     ContinuousBackupsUnavailableException = Shapes::StructureShape.new(name: 'ContinuousBackupsUnavailableException')
     ContributorInsightsAction = Shapes::StringShape.new(name: 'ContributorInsightsAction')
+    ContributorInsightsMode = Shapes::StringShape.new(name: 'ContributorInsightsMode')
     ContributorInsightsRule = Shapes::StringShape.new(name: 'ContributorInsightsRule')
     ContributorInsightsRuleList = Shapes::ListShape.new(name: 'ContributorInsightsRuleList')
     ContributorInsightsStatus = Shapes::StringShape.new(name: 'ContributorInsightsStatus')
@@ -350,6 +352,7 @@ module Aws::DynamoDB
     PutResourcePolicyOutput = Shapes::StructureShape.new(name: 'PutResourcePolicyOutput')
     QueryInput = Shapes::StructureShape.new(name: 'QueryInput')
     QueryOutput = Shapes::StructureShape.new(name: 'QueryOutput')
+    Reason = Shapes::StringShape.new(name: 'Reason')
     RecoveryPeriodInDays = Shapes::IntegerShape.new(name: 'RecoveryPeriodInDays')
     RegionName = Shapes::StringShape.new(name: 'RegionName')
     Replica = Shapes::StructureShape.new(name: 'Replica')
@@ -387,6 +390,7 @@ module Aws::DynamoDB
     ReplicationGroupUpdate = Shapes::StructureShape.new(name: 'ReplicationGroupUpdate')
     ReplicationGroupUpdateList = Shapes::ListShape.new(name: 'ReplicationGroupUpdateList')
     RequestLimitExceeded = Shapes::StructureShape.new(name: 'RequestLimitExceeded')
+    Resource = Shapes::StringShape.new(name: 'Resource')
     ResourceArnString = Shapes::StringShape.new(name: 'ResourceArnString')
     ResourceInUseException = Shapes::StructureShape.new(name: 'ResourceInUseException')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
@@ -449,6 +453,9 @@ module Aws::DynamoDB
     TagList = Shapes::ListShape.new(name: 'TagList')
     TagResourceInput = Shapes::StructureShape.new(name: 'TagResourceInput')
     TagValueString = Shapes::StringShape.new(name: 'TagValueString')
+    ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
+    ThrottlingReason = Shapes::StructureShape.new(name: 'ThrottlingReason')
+    ThrottlingReasonList = Shapes::ListShape.new(name: 'ThrottlingReasonList')
     TimeRangeLowerBound = Shapes::TimestampShape.new(name: 'TimeRangeLowerBound')
     TimeRangeUpperBound = Shapes::TimestampShape.new(name: 'TimeRangeUpperBound')
     TimeToLiveAttributeName = Shapes::StringShape.new(name: 'TimeToLiveAttributeName')
@@ -714,6 +721,7 @@ module Aws::DynamoDB
     ContributorInsightsSummary.add_member(:table_name, Shapes::ShapeRef.new(shape: TableName, location_name: "TableName"))
     ContributorInsightsSummary.add_member(:index_name, Shapes::ShapeRef.new(shape: IndexName, location_name: "IndexName"))
     ContributorInsightsSummary.add_member(:contributor_insights_status, Shapes::ShapeRef.new(shape: ContributorInsightsStatus, location_name: "ContributorInsightsStatus"))
+    ContributorInsightsSummary.add_member(:contributor_insights_mode, Shapes::ShapeRef.new(shape: ContributorInsightsMode, location_name: "ContributorInsightsMode"))
     ContributorInsightsSummary.struct_class = Types::ContributorInsightsSummary
 
     CreateBackupInput.add_member(:table_name, Shapes::ShapeRef.new(shape: TableArn, required: true, location_name: "TableName", metadata: {"contextParam" => {"name" => "ResourceArn"}}))
@@ -860,6 +868,7 @@ module Aws::DynamoDB
     DescribeContributorInsightsOutput.add_member(:contributor_insights_status, Shapes::ShapeRef.new(shape: ContributorInsightsStatus, location_name: "ContributorInsightsStatus"))
     DescribeContributorInsightsOutput.add_member(:last_update_date_time, Shapes::ShapeRef.new(shape: LastUpdateDateTime, location_name: "LastUpdateDateTime"))
     DescribeContributorInsightsOutput.add_member(:failure_exception, Shapes::ShapeRef.new(shape: FailureException, location_name: "FailureException"))
+    DescribeContributorInsightsOutput.add_member(:contributor_insights_mode, Shapes::ShapeRef.new(shape: ContributorInsightsMode, location_name: "ContributorInsightsMode"))
     DescribeContributorInsightsOutput.struct_class = Types::DescribeContributorInsightsOutput
 
     DescribeEndpointsRequest.struct_class = Types::DescribeEndpointsRequest
@@ -1440,6 +1449,7 @@ module Aws::DynamoDB
     ProvisionedThroughputDescription.struct_class = Types::ProvisionedThroughputDescription
 
     ProvisionedThroughputExceededException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
+    ProvisionedThroughputExceededException.add_member(:throttling_reasons, Shapes::ShapeRef.new(shape: ThrottlingReasonList, location_name: "ThrottlingReasons"))
     ProvisionedThroughputExceededException.struct_class = Types::ProvisionedThroughputExceededException
 
     ProvisionedThroughputOverride.add_member(:read_capacity_units, Shapes::ShapeRef.new(shape: PositiveLongObject, location_name: "ReadCapacityUnits"))
@@ -1639,6 +1649,7 @@ module Aws::DynamoDB
     ReplicationGroupUpdateList.member = Shapes::ShapeRef.new(shape: ReplicationGroupUpdate)
 
     RequestLimitExceeded.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
+    RequestLimitExceeded.add_member(:throttling_reasons, Shapes::ShapeRef.new(shape: ThrottlingReasonList, location_name: "ThrottlingReasons"))
     RequestLimitExceeded.struct_class = Types::RequestLimitExceeded
 
     ResourceInUseException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
@@ -1827,6 +1838,16 @@ module Aws::DynamoDB
     TagResourceInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, required: true, location_name: "Tags"))
     TagResourceInput.struct_class = Types::TagResourceInput
 
+    ThrottlingException.add_member(:message, Shapes::ShapeRef.new(shape: AvailabilityErrorMessage, location_name: "message"))
+    ThrottlingException.add_member(:throttling_reasons, Shapes::ShapeRef.new(shape: ThrottlingReasonList, location_name: "throttlingReasons"))
+    ThrottlingException.struct_class = Types::ThrottlingException
+
+    ThrottlingReason.add_member(:reason, Shapes::ShapeRef.new(shape: Reason, location_name: "reason"))
+    ThrottlingReason.add_member(:resource, Shapes::ShapeRef.new(shape: Resource, location_name: "resource"))
+    ThrottlingReason.struct_class = Types::ThrottlingReason
+
+    ThrottlingReasonList.member = Shapes::ShapeRef.new(shape: ThrottlingReason)
+
     TimeToLiveDescription.add_member(:time_to_live_status, Shapes::ShapeRef.new(shape: TimeToLiveStatus, location_name: "TimeToLiveStatus"))
     TimeToLiveDescription.add_member(:attribute_name, Shapes::ShapeRef.new(shape: TimeToLiveAttributeName, location_name: "AttributeName"))
     TimeToLiveDescription.struct_class = Types::TimeToLiveDescription
@@ -1899,11 +1920,13 @@ module Aws::DynamoDB
     UpdateContributorInsightsInput.add_member(:table_name, Shapes::ShapeRef.new(shape: TableArn, required: true, location_name: "TableName", metadata: {"contextParam" => {"name" => "ResourceArn"}}))
     UpdateContributorInsightsInput.add_member(:index_name, Shapes::ShapeRef.new(shape: IndexName, location_name: "IndexName"))
     UpdateContributorInsightsInput.add_member(:contributor_insights_action, Shapes::ShapeRef.new(shape: ContributorInsightsAction, required: true, location_name: "ContributorInsightsAction"))
+    UpdateContributorInsightsInput.add_member(:contributor_insights_mode, Shapes::ShapeRef.new(shape: ContributorInsightsMode, location_name: "ContributorInsightsMode"))
     UpdateContributorInsightsInput.struct_class = Types::UpdateContributorInsightsInput
 
     UpdateContributorInsightsOutput.add_member(:table_name, Shapes::ShapeRef.new(shape: TableName, location_name: "TableName"))
     UpdateContributorInsightsOutput.add_member(:index_name, Shapes::ShapeRef.new(shape: IndexName, location_name: "IndexName"))
     UpdateContributorInsightsOutput.add_member(:contributor_insights_status, Shapes::ShapeRef.new(shape: ContributorInsightsStatus, location_name: "ContributorInsightsStatus"))
+    UpdateContributorInsightsOutput.add_member(:contributor_insights_mode, Shapes::ShapeRef.new(shape: ContributorInsightsMode, location_name: "ContributorInsightsMode"))
     UpdateContributorInsightsOutput.struct_class = Types::UpdateContributorInsightsOutput
 
     UpdateGlobalSecondaryIndexAction.add_member(:index_name, Shapes::ShapeRef.new(shape: IndexName, required: true, location_name: "IndexName"))
@@ -2048,6 +2071,7 @@ module Aws::DynamoDB
         o.output = Shapes::ShapeRef.new(shape: BatchExecuteStatementOutput)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:batch_get_item, Seahorse::Model::Operation.new.tap do |o|
@@ -2062,6 +2086,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o[:pager] = Aws::Pager.new(
           tokens: {
             "unprocessed_keys" => "request_items"
@@ -2083,6 +2108,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ReplicatedWriteConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:create_backup, Seahorse::Model::Operation.new.tap do |o|
@@ -2158,6 +2184,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ReplicatedWriteConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:delete_resource_policy, Seahorse::Model::Operation.new.tap do |o|
@@ -2375,6 +2402,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: DuplicateItemException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:execute_transaction, Seahorse::Model::Operation.new.tap do |o|
@@ -2390,6 +2418,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:export_table_to_point_in_time, Seahorse::Model::Operation.new.tap do |o|
@@ -2418,6 +2447,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:get_resource_policy, Seahorse::Model::Operation.new.tap do |o|
@@ -2558,6 +2588,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ReplicatedWriteConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:put_resource_policy, Seahorse::Model::Operation.new.tap do |o|
@@ -2587,6 +2618,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o[:pager] = Aws::Pager.new(
           limit_key: "limit",
           tokens: {
@@ -2640,6 +2672,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
         o[:pager] = Aws::Pager.new(
           limit_key: "limit",
           tokens: {
@@ -2675,6 +2708,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:transact_write_items, Seahorse::Model::Operation.new.tap do |o|
@@ -2692,6 +2726,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:untag_resource, Seahorse::Model::Operation.new.tap do |o|
@@ -2778,6 +2813,7 @@ module Aws::DynamoDB
         o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
         o.errors << Shapes::ShapeRef.new(shape: ReplicatedWriteConflictException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:update_kinesis_streaming_destination, Seahorse::Model::Operation.new.tap do |o|

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

@@ -57,6 +57,7 @@ module Aws::DynamoDB
   # * {TableAlreadyExistsException}
   # * {TableInUseException}
   # * {TableNotFoundException}
+  # * {ThrottlingException}
   # * {TransactionCanceledException}
   # * {TransactionConflictException}
   # * {TransactionInProgressException}
@@ -385,6 +386,11 @@ module Aws::DynamoDB
       def message
         @message || @data[:message]
       end
+
+      # @return [String]
+      def throttling_reasons
+        @data[:throttling_reasons]
+      end
     end
 
     class ReplicaAlreadyExistsException < ServiceError
@@ -449,6 +455,11 @@ module Aws::DynamoDB
       def message
         @message || @data[:message]
       end
+
+      # @return [String]
+      def throttling_reasons
+        @data[:throttling_reasons]
+      end
     end
 
     class ResourceInUseException < ServiceError
@@ -526,6 +537,26 @@ module Aws::DynamoDB
       end
     end
 
+    class ThrottlingException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::DynamoDB::Types::ThrottlingException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+      # @return [String]
+      def throttling_reasons
+        @data[:throttling_reasons]
+      end
+    end
+
     class TransactionCanceledException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -1649,12 +1649,19 @@ module Aws::DynamoDB
     #   table and index, if applicable.
     #   @return [String]
     #
+    # @!attribute [rw] contributor_insights_mode
+    #   Indicates the current mode of CloudWatch Contributor Insights,
+    #   specifying whether it tracks all access and throttled events or
+    #   throttled events only for the DynamoDB table or index.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ContributorInsightsSummary AWS API Documentation
     #
     class ContributorInsightsSummary < Struct.new(
       :table_name,
       :index_name,
-      :contributor_insights_status)
+      :contributor_insights_status,
+      :contributor_insights_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2799,6 +2806,12 @@ module Aws::DynamoDB
     #     Contributor Insights rules. Please retry request.
     #   @return [Types::FailureException]
     #
+    # @!attribute [rw] contributor_insights_mode
+    #   The mode of CloudWatch Contributor Insights for DynamoDB that
+    #   determines which events are emitted. Can be set to track all access
+    #   and throttled events or throttled events only.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeContributorInsightsOutput AWS API Documentation
     #
     class DescribeContributorInsightsOutput < Struct.new(
@@ -2807,7 +2820,8 @@ module Aws::DynamoDB
       :contributor_insights_rule_list,
       :contributor_insights_status,
       :last_update_date_time,
-      :failure_exception)
+      :failure_exception,
+      :contributor_insights_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6185,25 +6199,39 @@ module Aws::DynamoDB
       include Aws::Structure
     end
 
-    # Your request rate is too high. The Amazon Web Services SDKs for
-    # DynamoDB automatically retry requests that receive this exception.
-    # Your request is eventually successful, unless your retry queue is too
-    # large to finish. Reduce the frequency of requests and use exponential
-    # backoff. For more information, go to [Error Retries and Exponential
-    # Backoff][1] in the *Amazon DynamoDB Developer Guide*.
+    # The request was denied due to request throttling. For detailed
+    # information about why the request was throttled and the ARN of the
+    # impacted resource, find the [ThrottlingReason][1] field in the
+    # returned exception. The Amazon Web Services SDKs for DynamoDB
+    # automatically retry requests that receive this exception. Your request
+    # is eventually successful, unless your retry queue is too large to
+    # finish. Reduce the frequency of requests and use exponential backoff.
+    # For more information, go to [Error Retries and Exponential Backoff][2]
+    # in the *Amazon DynamoDB Developer Guide*.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Programming.Errors.html#Programming.Errors.RetryAndBackoff
     #
     # @!attribute [rw] message
     #   You exceeded your maximum allowed provisioned throughput.
     #   @return [String]
     #
+    # @!attribute [rw] throttling_reasons
+    #   A list of [ThrottlingReason][1] that provide detailed diagnostic
+    #   information about why the request was throttled.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    #   @return [Array<Types::ThrottlingReason>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ProvisionedThroughputExceededException AWS API Documentation
     #
     class ProvisionedThroughputExceededException < Struct.new(
-      :message)
+      :message,
+      :throttling_reasons)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -7775,21 +7803,34 @@ module Aws::DynamoDB
       include Aws::Structure
     end
 
-    # Throughput exceeds the current throughput quota for your account.
-    # Please contact [Amazon Web ServicesSupport][1] to request a quota
-    # increase.
+    # Throughput exceeds the current throughput quota for your account. For
+    # detailed information about why the request was throttled and the ARN
+    # of the impacted resource, find the [ThrottlingReason][1] field in the
+    # returned exception. Contact [Amazon Web ServicesSupport][2] to request
+    # a quota increase.
     #
     #
     #
-    # [1]: https://aws.amazon.com/support
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    # [2]: https://aws.amazon.com/support
     #
     # @!attribute [rw] message
     #   @return [String]
     #
+    # @!attribute [rw] throttling_reasons
+    #   A list of [ThrottlingReason][1] that provide detailed diagnostic
+    #   information about why the request was throttled.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    #   @return [Array<Types::ThrottlingReason>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RequestLimitExceeded AWS API Documentation
     #
     class RequestLimitExceeded < Struct.new(
-      :message)
+      :message,
+      :throttling_reasons)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9298,6 +9339,101 @@ module Aws::DynamoDB
       include Aws::Structure
     end
 
+    # The request was denied due to request throttling. For detailed
+    # information about why the request was throttled and the ARN of the
+    # impacted resource, find the [ThrottlingReason][1] field in the
+    # returned exception.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    #
+    # @!attribute [rw] message
+    #   @return [String]
+    #
+    # @!attribute [rw] throttling_reasons
+    #   A list of [ThrottlingReason][1] that provide detailed diagnostic
+    #   information about why the request was throttled.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ThrottlingReason.html
+    #   @return [Array<Types::ThrottlingReason>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ThrottlingException AWS API Documentation
+    #
+    class ThrottlingException < Struct.new(
+      :message,
+      :throttling_reasons)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Represents the specific reason why a DynamoDB request was throttled
+    # and the ARN of the impacted resource. This helps identify exactly what
+    # resource is being throttled, what type of operation caused it, and why
+    # the throttling occurred.
+    #
+    # @!attribute [rw] reason
+    #   The reason for throttling. The throttling reason follows a specific
+    #   format: `ResourceType+OperationType+LimitType`:
+    #
+    #   * Resource Type (What is being throttled): Table or Index
+    #
+    #   * Operation Type (What kind of operation): Read or Write
+    #
+    #   * Limit Type (Why the throttling occurred):
+    #
+    #     * `ProvisionedThroughputExceeded`: The request rate is exceeding
+    #       the [provisioned throughput capacity][1] (read or write capacity
+    #       units) configured for a table or a global secondary index (GSI)
+    #       in provisioned capacity mode.
+    #
+    #     * `AccountLimitExceeded`: The request rate has caused a table or
+    #       global secondary index (GSI) in on-demand mode to exceed the
+    #       [per-table account-level service quotas][2] for read/write
+    #       throughput in the current Amazon Web Services Region.
+    #
+    #     * `KeyRangeThroughputExceeded`: The request rate directed at a
+    #       specific partition key value has exceeded the [internal
+    #       partition-level throughput limits][3], indicating uneven access
+    #       patterns across the table's or GSI's key space.
+    #
+    #     * `MaxOnDemandThroughputExceeded`: The request rate has exceeded
+    #       the [configured maximum throughput limits][4] set for a table or
+    #       index in on-demand capacity mode.
+    #
+    #   Examples of complete throttling reasons:
+    #
+    #   * TableReadProvisionedThroughputExceeded
+    #
+    #   * IndexWriteAccountLimitExceeded
+    #
+    #   This helps identify exactly what resource is being throttled, what
+    #   type of operation caused it, and why the throttling occurred.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/provisioned-capacity-mode.html
+    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ServiceQuotas.html#default-limits-throughput
+    #   [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-partition-key-design.html
+    #   [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/on-demand-capacity-mode-max-throughput.html
+    #   @return [String]
+    #
+    # @!attribute [rw] resource
+    #   The Amazon Resource Name (ARN) of the DynamoDB table or index that
+    #   experienced the throttling event.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ThrottlingReason AWS API Documentation
+    #
+    class ThrottlingReason < Struct.new(
+      :reason,
+      :resource)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The description of the Time to Live (TTL) status on the specified
     # table.
     #
@@ -9892,12 +10028,18 @@ module Aws::DynamoDB
     #   Represents the contributor insights action.
     #   @return [String]
     #
+    # @!attribute [rw] contributor_insights_mode
+    #   Specifies whether to track all access and throttled events or
+    #   throttled events only for the DynamoDB table or index.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateContributorInsightsInput AWS API Documentation
     #
     class UpdateContributorInsightsInput < Struct.new(
       :table_name,
       :index_name,
-      :contributor_insights_action)
+      :contributor_insights_action,
+      :contributor_insights_mode)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9914,12 +10056,19 @@ module Aws::DynamoDB
     #   The status of contributor insights
     #   @return [String]
     #
+    # @!attribute [rw] contributor_insights_mode
+    #   The updated mode of CloudWatch Contributor Insights that determines
+    #   whether to monitor all access and throttled events or to track
+    #   throttled events exclusively.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateContributorInsightsOutput AWS API Documentation
     #
     class UpdateContributorInsightsOutput < Struct.new(
       :table_name,
       :index_name,
-      :contributor_insights_status)
+      :contributor_insights_status,
+      :contributor_insights_mode)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-dynamodb.rb

@@ -56,7 +56,7 @@ module Aws::DynamoDB
   autoload :Endpoints, 'aws-sdk-dynamodb/endpoints'
   autoload :Table, 'aws-sdk-dynamodb/table'
 
-  GEM_VERSION = '1.149.0'
+  GEM_VERSION = '1.150.0'
 
 end
 

data/sig/client.rbs

@@ -352,6 +352,7 @@ module Aws
         def contributor_insights_status: () -> ("ENABLING" | "ENABLED" | "DISABLING" | "DISABLED" | "FAILED")
         def last_update_date_time: () -> ::Time
         def failure_exception: () -> Types::FailureException
+        def contributor_insights_mode: () -> ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Client.html#describe_contributor_insights-instance_method
       def describe_contributor_insights: (
@@ -1112,12 +1113,14 @@ module Aws
         def table_name: () -> ::String
         def index_name: () -> ::String
         def contributor_insights_status: () -> ("ENABLING" | "ENABLED" | "DISABLING" | "DISABLED" | "FAILED")
+        def contributor_insights_mode: () -> ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Client.html#update_contributor_insights-instance_method
       def update_contributor_insights: (
                                          table_name: ::String,
                                          ?index_name: ::String,
-                                         contributor_insights_action: ("ENABLE" | "DISABLE")
+                                         contributor_insights_action: ("ENABLE" | "DISABLE"),
+                                         ?contributor_insights_mode: ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
                                        ) -> _UpdateContributorInsightsResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateContributorInsightsResponseSuccess
 

data/sig/errors.rbs

@@ -74,6 +74,7 @@ module Aws
       end
       class ProvisionedThroughputExceededException < ::Aws::Errors::ServiceError
         def message: () -> ::String
+        def throttling_reasons: () -> ::String
       end
       class ReplicaAlreadyExistsException < ::Aws::Errors::ServiceError
         def message: () -> ::String
@@ -86,6 +87,7 @@ module Aws
       end
       class RequestLimitExceeded < ::Aws::Errors::ServiceError
         def message: () -> ::String
+        def throttling_reasons: () -> ::String
       end
       class ResourceInUseException < ::Aws::Errors::ServiceError
         def message: () -> ::String
@@ -102,6 +104,10 @@ module Aws
       class TableNotFoundException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class ThrottlingException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+        def throttling_reasons: () -> ::String
+      end
       class TransactionCanceledException < ::Aws::Errors::ServiceError
         def message: () -> ::String
         def cancellation_reasons: () -> ::String

data/sig/types.rbs

@@ -258,6 +258,7 @@ module Aws::DynamoDB
       attr_accessor table_name: ::String
       attr_accessor index_name: ::String
       attr_accessor contributor_insights_status: ("ENABLING" | "ENABLED" | "DISABLING" | "DISABLED" | "FAILED")
+      attr_accessor contributor_insights_mode: ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       SENSITIVE: []
     end
 
@@ -464,6 +465,7 @@ module Aws::DynamoDB
       attr_accessor contributor_insights_status: ("ENABLING" | "ENABLED" | "DISABLING" | "DISABLED" | "FAILED")
       attr_accessor last_update_date_time: ::Time
       attr_accessor failure_exception: Types::FailureException
+      attr_accessor contributor_insights_mode: ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       SENSITIVE: []
     end
 
@@ -1163,6 +1165,7 @@ module Aws::DynamoDB
 
     class ProvisionedThroughputExceededException
       attr_accessor message: ::String
+      attr_accessor throttling_reasons: ::Array[Types::ThrottlingReason]
       SENSITIVE: []
     end
 
@@ -1385,6 +1388,7 @@ module Aws::DynamoDB
 
     class RequestLimitExceeded
       attr_accessor message: ::String
+      attr_accessor throttling_reasons: ::Array[Types::ThrottlingReason]
       SENSITIVE: []
     end
 
@@ -1613,6 +1617,18 @@ module Aws::DynamoDB
       SENSITIVE: []
     end
 
+    class ThrottlingException
+      attr_accessor message: ::String
+      attr_accessor throttling_reasons: ::Array[Types::ThrottlingReason]
+      SENSITIVE: []
+    end
+
+    class ThrottlingReason
+      attr_accessor reason: ::String
+      attr_accessor resource: ::String
+      SENSITIVE: []
+    end
+
     class TimeToLiveDescription
       attr_accessor time_to_live_status: ("ENABLING" | "DISABLING" | "ENABLED" | "DISABLED")
       attr_accessor attribute_name: ::String
@@ -1712,6 +1728,7 @@ module Aws::DynamoDB
       attr_accessor table_name: ::String
       attr_accessor index_name: ::String
       attr_accessor contributor_insights_action: ("ENABLE" | "DISABLE")
+      attr_accessor contributor_insights_mode: ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       SENSITIVE: []
     end
 
@@ -1719,6 +1736,7 @@ module Aws::DynamoDB
       attr_accessor table_name: ::String
       attr_accessor index_name: ::String
       attr_accessor contributor_insights_status: ("ENABLING" | "ENABLED" | "DISABLING" | "DISABLED" | "FAILED")
+      attr_accessor contributor_insights_mode: ("ACCESSED_AND_THROTTLED_KEYS" | "THROTTLED_KEYS")
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodb
 version: !ruby/object:Gem::Version
-  version: 1.149.0
+  version: 1.150.0
 platform: ruby
 authors:
 - Amazon Web Services