aws-sdk-dynamodb 1.176.0 → 1.177.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35697eb019066aa283304ec68458c74307923fde5ebe7419b45940cddf2ce657
-  data.tar.gz: 11faa1afeebfca6664772cbef077b77d898f19de9dda541006179384b9ed02fa
+  metadata.gz: d42e91e842e0413a3c93a71f21a58d3b60a3b6d9bce7964b61cfab469137c90b
+  data.tar.gz: fb9d6a693f9a7028a9cf99178842f2590d8a2a426d89fd7eb26cd9bece5f38d6
 SHA512:
-  metadata.gz: 59490f8bb5ed93283a5d1be8073e5d34e46e64aefb05008ac07283a2c4cac8d35c07cb4f2436a75557709b7af7e59ba29d96629950c21a8f51d3a4471851bf2c
-  data.tar.gz: e55467c983471dafa766a3546d7fdcda6adb717b603b2e5465acd215e446c837dfd167c5a0a49079cc8b43a05dd30bba498618d05b3b1cc7b326def06e3c6580
+  metadata.gz: b235cd6b59a1843fcf975a11793500d18ec13a00b4cc30f076a088fb541e8797f15a23ae3fe0eb9ea36c23a319805b149b91ac7936f27069ef17f3e3283c9d67
+  data.tar.gz: dd851c3b3f1cb97ac9736b91d225a3a4a919a01c4ce880aab241a8664969c1ad79c9fe379ee275a6bae293245d3f5c5631321c0291677738f81629b2d44f0509

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.177.0 (2026-10-20)
+------------------
+
+* Feature - Adds support for disassociating a replica from an Amazon DynamoDB multi-Region eventual consistency global table, so you can keep it as a single-Region table with its existing data. Also adds disassociation protection, on by default, to help prevent accidental disassociation.
+
 1.176.0 (2026-10-19)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.176.0
+1.177.0

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

@@ -211,13 +211,20 @@ module Aws::DynamoDB
     #     the required types.
     #
     #   @option options [Boolean] :correct_clock_skew (true)
-    #     Used only in `standard` and `adaptive` retry modes. Specifies whether to apply
-    #     a clock skew correction and retry requests with skewed client clocks.
+    #     Used only in `standard` and `adaptive` retry modes. Specifies whether
+    #     to apply a clock skew correction and retry requests with skewed client
+    #     clocks. Takes effect only when `disable_clock_skew_correction` is not set.
     #
     #   @option options [String] :defaults_mode ("legacy")
     #     See {Aws::DefaultsModeConfiguration} for a list of the
     #     accepted modes and the configuration defaults that are included.
     #
+    #   @option options [Boolean] :disable_clock_skew_correction
+    #     Used only in `standard` and `adaptive` retry modes. When `true`, the
+    #     SDK does not apply a clock skew correction, does not update its stored
+    #     skew from responses, and does not retry clock skew errors. Clock skew
+    #     correction is enabled by default.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
     #
@@ -1948,6 +1955,7 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.disassociation_protection_enabled #=> Boolean
     #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.warm_throughput.read_units_per_second #=> Integer
@@ -2587,6 +2595,7 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.disassociation_protection_enabled #=> Boolean
     #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.warm_throughput.read_units_per_second #=> Integer
@@ -3490,6 +3499,7 @@ module Aws::DynamoDB
     #   resp.table.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table.table_class_summary.last_update_date_time #=> Time
     #   resp.table.deletion_protection_enabled #=> Boolean
+    #   resp.table.disassociation_protection_enabled #=> Boolean
     #   resp.table.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table.warm_throughput.read_units_per_second #=> Integer
@@ -6225,6 +6235,7 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.disassociation_protection_enabled #=> Boolean
     #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.warm_throughput.read_units_per_second #=> Integer
@@ -6545,6 +6556,7 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.disassociation_protection_enabled #=> Boolean
     #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.warm_throughput.read_units_per_second #=> Integer
@@ -8521,7 +8533,8 @@ module Aws::DynamoDB
     end
 
     # Modifies the provisioned throughput settings, global secondary
-    # indexes, or DynamoDB Streams settings for a given table.
+    # indexes, DynamoDB Streams settings, or global table replica settings
+    # for a given table.
     #
     # You can only perform one of the following operations at once:
     #
@@ -8533,11 +8546,38 @@ module Aws::DynamoDB
     #   begins backfilling, you can use `UpdateTable` to perform other
     #   operations.
     #
+    # * Enable or disable disassociation protection for the local global
+    #   table replica.
+    #
+    # * Disassociate the local global table replica and keep it as a
+    #   standalone regional table. The `Disassociate` action must be the
+    #   only replica update in the request. If the request includes any
+    #   other update, `UpdateTable` fails with a `ValidationException` and
+    #   the disassociation does not start.
+    #
     # `UpdateTable` is an asynchronous operation; while it's executing, the
     # table status changes from `ACTIVE` to `UPDATING`. While it's
-    # `UPDATING`, you can't issue another `UpdateTable` request. When the
-    # table returns to the `ACTIVE` state, the `UpdateTable` operation is
-    # complete.
+    # `UPDATING`, you can't issue another `UpdateTable` request. Use
+    # `DescribeTable` to monitor the table's status.
+    #
+    # To use this operation to disassociate a local replica, you must have
+    # the `dynamodb:UpdateTable` and `dynamodb:DisassociateTableReplica` IAM
+    # permissions on the local replica. Send disassociation and
+    # disassociation protection requests to the replica's Region using
+    # credentials for the account that owns the replica. For prerequisites
+    # and the procedure, see [Disassociating a global table replica][1] in
+    # the *Amazon DynamoDB Developer Guide*.
+    #
+    # To confirm successful disassociation, call `DescribeTable` in the
+    # replica's Region and verify that `TableStatus` is `ACTIVE` and
+    # `Replicas` is absent or empty. If `TableStatus` returns to `ACTIVE`
+    # but the response still includes a `Replicas` list, the disassociation
+    # did not complete. Check `ReplicaStatus` for a replication-permission
+    # or encryption-access problem, resolve it, and retry.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html
     #
     # @option params [Array<Types::AttributeDefinition>] :attribute_definitions
     #   An array of attributes that describe the key schema for the table and
@@ -8609,8 +8649,8 @@ module Aws::DynamoDB
     #   The new server-side encryption settings for the specified table.
     #
     # @option params [Array<Types::ReplicationGroupUpdate>] :replica_updates
-    #   A list of replica update actions (create, delete, or update) for the
-    #   table.
+    #   A list of replica update actions (create, delete, update, or
+    #   disassociate) for the table.
     #
     # @option params [String] :table_class
     #   The table class of the table to be updated. Valid values are
@@ -8686,6 +8726,18 @@ module Aws::DynamoDB
     #     Settings replication needs to be defined to ENABLED again in order
     #     to create a Multi-Account Global Table using this table.
     #
+    # @option params [Boolean] :disassociation_protection_enabled
+    #   Specifies whether disassociation protection is enabled (`true`) or
+    #   disabled (`false`) for the local replica of a multi-Region eventual
+    #   consistency (MREC) global table using Version 2019.11.21.
+    #
+    #   Disassociation protection is enabled by default. If you omit this
+    #   parameter, the existing setting is unchanged. This setting is
+    #   independent of `DeletionProtectionEnabled`.
+    #
+    #   You can't combine this change with any other change in the same
+    #   `UpdateTable` request.
+    #
     # @option params [Array<Types::VectorIndexUpdate>] :vector_index_updates
     #   A list of vector indexes to be added to or removed from the table. You
     #   can add or remove one vector index for each `UpdateTable` operation.
@@ -8724,7 +8776,7 @@ module Aws::DynamoDB
     #           attribute_type: "S", 
     #         }, 
     #       ], 
-    #       creation_date_time: Time.parse("1421866952.062"), 
+    #       creation_date_time: Time.parse(1421866952.062), 
     #       item_count: 0, 
     #       key_schema: [
     #         {
@@ -8737,7 +8789,7 @@ module Aws::DynamoDB
     #         }, 
     #       ], 
     #       provisioned_throughput: {
-    #         last_increase_date_time: Time.parse("1421874759.194"), 
+    #         last_increase_date_time: Time.parse(1421874759.194), 
     #         number_of_decreases_today: 1, 
     #         read_capacity_units: 1, 
     #         write_capacity_units: 1, 
@@ -8748,6 +8800,74 @@ module Aws::DynamoDB
     #     }, 
     #   }
     #
+    # @example Example: To disable disassociation protection on a local replica
+    #
+    #   # This example disables disassociation protection on the MusicCollection replica in us-west-2. You must send the request
+    #   # to us-west-2 using credentials for the account that owns the replica. Your table must be a global table that uses
+    #   # Version 2019.11.21 and multi-Region eventual consistency (MREC). You cannot combine this change with any other change in
+    #   # the same UpdateTable request. Before requesting disassociation, use DescribeTable to confirm that
+    #   # DisassociationProtectionEnabled is false and TableStatus is ACTIVE.
+    #
+    #   resp = client.update_table({
+    #     disassociation_protection_enabled: false, 
+    #     table_name: "MusicCollection", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     table_description: {
+    #       disassociation_protection_enabled: false, 
+    #       global_table_version: "2019.11.21", 
+    #       replicas: [
+    #         {
+    #           region_name: "us-east-1", 
+    #           replica_status: "ACTIVE", 
+    #         }, 
+    #       ], 
+    #       table_arn: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", 
+    #       table_name: "MusicCollection", 
+    #       table_status: "ACTIVE", 
+    #     }, 
+    #   }
+    #
+    # @example Example: To disassociate a local global table replica
+    #
+    #   # This example disassociates the MusicCollection replica in us-west-2. You must first disable protection in a separate
+    #   # UpdateTable request. You must send the request to us-west-2 using credentials for account 123456789012, the account that
+    #   # owns the replica. This request works for global tables that use Version 2019.11.21 and multi-Region eventual consistency
+    #   # (MREC). Replicas can belong to one account or multiple accounts. You must specify WAIT_FOR_REPLICATION. The response
+    #   # shows that DynamoDB accepted the asynchronous request. To confirm completion, use DescribeTable in us-west-2. Verify
+    #   # that TableStatus is ACTIVE and Replicas is absent or empty. ACTIVE alone does not confirm successful disassociation.
+    #
+    #   resp = client.update_table({
+    #     replica_updates: [
+    #       {
+    #         disassociate: {
+    #           disassociation_mode: "WAIT_FOR_REPLICATION", 
+    #           region_name: "us-west-2", 
+    #         }, 
+    #       }, 
+    #     ], 
+    #     table_name: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     table_description: {
+    #       disassociation_protection_enabled: false, 
+    #       global_table_version: "2019.11.21", 
+    #       replicas: [
+    #         {
+    #           region_name: "us-east-1", 
+    #           replica_status: "ACTIVE", 
+    #         }, 
+    #       ], 
+    #       table_arn: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection", 
+    #       table_name: "MusicCollection", 
+    #       table_status: "UPDATING", 
+    #     }, 
+    #   }
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_table({
@@ -8868,6 +8988,10 @@ module Aws::DynamoDB
     #         delete: {
     #           region_name: "RegionName", # required
     #         },
+    #         disassociate: {
+    #           region_name: "RegionName", # required
+    #           disassociation_mode: "WAIT_FOR_REPLICATION", # required, accepts WAIT_FOR_REPLICATION
+    #         },
     #       },
     #     ],
     #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
@@ -8892,6 +9016,7 @@ module Aws::DynamoDB
     #       write_units_per_second: 1,
     #     },
     #     global_table_settings_replication_mode: "ENABLED", # accepts ENABLED, DISABLED, ENABLED_WITH_OVERRIDES
+    #     disassociation_protection_enabled: false,
     #     vector_index_updates: [
     #       {
     #         create: {
@@ -9021,6 +9146,7 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.disassociation_protection_enabled #=> Boolean
     #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
     #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.warm_throughput.read_units_per_second #=> Integer
@@ -9307,7 +9433,7 @@ module Aws::DynamoDB
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.176.0'
+      context[:gem_version] = '1.177.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -159,6 +159,9 @@ module Aws::DynamoDB
     DescribeTimeToLiveInput = Shapes::StructureShape.new(name: 'DescribeTimeToLiveInput')
     DescribeTimeToLiveOutput = Shapes::StructureShape.new(name: 'DescribeTimeToLiveOutput')
     DestinationStatus = Shapes::StringShape.new(name: 'DestinationStatus')
+    DisassociateReplicationGroupMemberAction = Shapes::StructureShape.new(name: 'DisassociateReplicationGroupMemberAction')
+    DisassociationMode = Shapes::StringShape.new(name: 'DisassociationMode')
+    DisassociationProtectionEnabled = Shapes::BooleanShape.new(name: 'DisassociationProtectionEnabled')
     DoubleObject = Shapes::FloatShape.new(name: 'DoubleObject')
     DuplicateItemException = Shapes::StructureShape.new(name: 'DuplicateItemException')
     EnableKinesisStreamingConfiguration = Shapes::StructureShape.new(name: 'EnableKinesisStreamingConfiguration')
@@ -976,6 +979,10 @@ module Aws::DynamoDB
     DescribeTimeToLiveOutput.add_member(:time_to_live_description, Shapes::ShapeRef.new(shape: TimeToLiveDescription, location_name: "TimeToLiveDescription"))
     DescribeTimeToLiveOutput.struct_class = Types::DescribeTimeToLiveOutput
 
+    DisassociateReplicationGroupMemberAction.add_member(:region_name, Shapes::ShapeRef.new(shape: RegionName, required: true, location_name: "RegionName"))
+    DisassociateReplicationGroupMemberAction.add_member(:disassociation_mode, Shapes::ShapeRef.new(shape: DisassociationMode, required: true, location_name: "DisassociationMode"))
+    DisassociateReplicationGroupMemberAction.struct_class = Types::DisassociateReplicationGroupMemberAction
+
     DuplicateItemException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "message"))
     DuplicateItemException.struct_class = Types::DuplicateItemException
 
@@ -1697,6 +1704,7 @@ module Aws::DynamoDB
     ReplicationGroupUpdate.add_member(:create, Shapes::ShapeRef.new(shape: CreateReplicationGroupMemberAction, location_name: "Create"))
     ReplicationGroupUpdate.add_member(:update, Shapes::ShapeRef.new(shape: UpdateReplicationGroupMemberAction, location_name: "Update"))
     ReplicationGroupUpdate.add_member(:delete, Shapes::ShapeRef.new(shape: DeleteReplicationGroupMemberAction, location_name: "Delete"))
+    ReplicationGroupUpdate.add_member(:disassociate, Shapes::ShapeRef.new(shape: DisassociateReplicationGroupMemberAction, location_name: "Disassociate"))
     ReplicationGroupUpdate.struct_class = Types::ReplicationGroupUpdate
 
     ReplicationGroupUpdateList.member = Shapes::ShapeRef.new(shape: ReplicationGroupUpdate)
@@ -1895,6 +1903,7 @@ module Aws::DynamoDB
     TableDescription.add_member(:archival_summary, Shapes::ShapeRef.new(shape: ArchivalSummary, location_name: "ArchivalSummary"))
     TableDescription.add_member(:table_class_summary, Shapes::ShapeRef.new(shape: TableClassSummary, location_name: "TableClassSummary"))
     TableDescription.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, location_name: "DeletionProtectionEnabled"))
+    TableDescription.add_member(:disassociation_protection_enabled, Shapes::ShapeRef.new(shape: DisassociationProtectionEnabled, location_name: "DisassociationProtectionEnabled"))
     TableDescription.add_member(:on_demand_throughput, Shapes::ShapeRef.new(shape: OnDemandThroughput, location_name: "OnDemandThroughput"))
     TableDescription.add_member(:warm_throughput, Shapes::ShapeRef.new(shape: TableWarmThroughputDescription, location_name: "WarmThroughput"))
     TableDescription.add_member(:multi_region_consistency, Shapes::ShapeRef.new(shape: MultiRegionConsistency, location_name: "MultiRegionConsistency"))
@@ -2099,6 +2108,7 @@ module Aws::DynamoDB
     UpdateTableInput.add_member(:on_demand_throughput, Shapes::ShapeRef.new(shape: OnDemandThroughput, location_name: "OnDemandThroughput"))
     UpdateTableInput.add_member(:warm_throughput, Shapes::ShapeRef.new(shape: WarmThroughput, location_name: "WarmThroughput"))
     UpdateTableInput.add_member(:global_table_settings_replication_mode, Shapes::ShapeRef.new(shape: GlobalTableSettingsReplicationMode, location_name: "GlobalTableSettingsReplicationMode"))
+    UpdateTableInput.add_member(:disassociation_protection_enabled, Shapes::ShapeRef.new(shape: DisassociationProtectionEnabled, location_name: "DisassociationProtectionEnabled"))
     UpdateTableInput.add_member(:vector_index_updates, Shapes::ShapeRef.new(shape: VectorIndexUpdateList, location_name: "VectorIndexUpdates"))
     UpdateTableInput.struct_class = Types::UpdateTableInput
 

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

@@ -336,6 +336,9 @@ module Aws::DynamoDB
     end
 
     # Represents replicas of the table.
+    #
+    # After a successful disassociation, this list is absent or empty. To
+    # confirm disassociation, also verify that `TableStatus` is `ACTIVE`.
     # @return [Array<Types::ReplicaDescription>]
     def replicas
       data[:replicas]
@@ -397,6 +400,14 @@ module Aws::DynamoDB
       data[:deletion_protection_enabled]
     end
 
+    # Specifies whether disassociation protection is enabled (`true`) or
+    # disabled (`false`) for the local global table replica. Protection is
+    # enabled by default.
+    # @return [Boolean]
+    def disassociation_protection_enabled
+      data[:disassociation_protection_enabled]
+    end
+
     # The maximum number of read and write units for the specified on-demand
     # table. If you use this parameter, you must specify
     # `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
@@ -2015,6 +2026,10 @@ module Aws::DynamoDB
     #         delete: {
     #           region_name: "RegionName", # required
     #         },
+    #         disassociate: {
+    #           region_name: "RegionName", # required
+    #           disassociation_mode: "WAIT_FOR_REPLICATION", # required, accepts WAIT_FOR_REPLICATION
+    #         },
     #       },
     #     ],
     #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
@@ -2039,6 +2054,7 @@ module Aws::DynamoDB
     #       write_units_per_second: 1,
     #     },
     #     global_table_settings_replication_mode: "ENABLED", # accepts ENABLED, DISABLED, ENABLED_WITH_OVERRIDES
+    #     disassociation_protection_enabled: false,
     #     vector_index_updates: [
     #       {
     #         create: {
@@ -2126,8 +2142,8 @@ module Aws::DynamoDB
     # @option options [Types::SSESpecification] :sse_specification
     #   The new server-side encryption settings for the specified table.
     # @option options [Array<Types::ReplicationGroupUpdate>] :replica_updates
-    #   A list of replica update actions (create, delete, or update) for the
-    #   table.
+    #   A list of replica update actions (create, delete, update, or
+    #   disassociate) for the table.
     # @option options [String] :table_class
     #   The table class of the table to be updated. Valid values are
     #   `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.
@@ -2195,6 +2211,17 @@ module Aws::DynamoDB
     #   * `DISABLED`: Remove settings replication on a regional table.
     #     Settings replication needs to be defined to ENABLED again in order
     #     to create a Multi-Account Global Table using this table.
+    # @option options [Boolean] :disassociation_protection_enabled
+    #   Specifies whether disassociation protection is enabled (`true`) or
+    #   disabled (`false`) for the local replica of a multi-Region eventual
+    #   consistency (MREC) global table using Version 2019.11.21.
+    #
+    #   Disassociation protection is enabled by default. If you omit this
+    #   parameter, the existing setting is unchanged. This setting is
+    #   independent of `DeletionProtectionEnabled`.
+    #
+    #   You can't combine this change with any other change in the same
+    #   `UpdateTable` request.
     # @option options [Array<Types::VectorIndexUpdate>] :vector_index_updates
     #   A list of vector indexes to be added to or removed from the table. You
     #   can add or remove one vector index for each `UpdateTable` operation.

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

@@ -3221,6 +3221,48 @@ module Aws::DynamoDB
       include Aws::Structure
     end
 
+    # The parameters for disassociating the local replica from a global
+    # table using Version 2019.11.21 with multi-Region eventual consistency
+    # (MREC).
+    #
+    # After disassociation completes, the replica remains a standalone
+    # regional table that keeps its data, indexes, and table settings.
+    #
+    # For request requirements, see [UpdateTable][1]. For prerequisites, the
+    # protection update, and completion checks, see [Disassociating a global
+    # table replica][2] in the *Amazon DynamoDB Developer Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html
+    #
+    # @!attribute [rw] region_name
+    #   The Region of the replica to disassociate. Set this value to the
+    #   Region where you send the `UpdateTable` request. You must use
+    #   credentials for the account that owns the replica.
+    #   @return [String]
+    #
+    # @!attribute [rw] disassociation_mode
+    #   The mode for handling pending replication before disassociation
+    #   completes. You must specify `WAIT_FOR_REPLICATION`. For more
+    #   information, see [Disassociating a global table replica][1] in the
+    #   *Amazon DynamoDB Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DisassociateReplicationGroupMemberAction AWS API Documentation
+    #
+    class DisassociateReplicationGroupMemberAction < Struct.new(
+      :region_name,
+      :disassociation_mode)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # There was an attempt to insert an item with the same primary key as an
     # item that already exists in the DynamoDB table.
     #
@@ -8025,6 +8067,13 @@ module Aws::DynamoDB
     #   `DeleteTableReplica` action in the destination Region, deleting the
     #   replica and all if its items in the destination Region.
     #
+    # * The local replica to be disassociated from a global table and
+    #   retained as a standalone regional table.
+    #
+    # Each `ReplicationGroupUpdate` contains exactly one action. A
+    # `Disassociate` action must be the only replica update in the request;
+    # including other updates causes the request to fail.
+    #
     # <note markdown="1"> When you manually remove a table or global table replica, you do not
     # automatically remove any associated scalable targets, scaling
     # policies, or CloudWatch alarms.
@@ -8043,12 +8092,18 @@ module Aws::DynamoDB
     #   The parameters required for deleting a replica for the table.
     #   @return [Types::DeleteReplicationGroupMemberAction]
     #
+    # @!attribute [rw] disassociate
+    #   The parameters for disassociating the local replica from the global
+    #   table and retaining it as a standalone regional table.
+    #   @return [Types::DisassociateReplicationGroupMemberAction]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ReplicationGroupUpdate AWS API Documentation
     #
     class ReplicationGroupUpdate < Struct.new(
       :create,
       :update,
-      :delete)
+      :delete,
+      :disassociate)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9581,6 +9636,9 @@ module Aws::DynamoDB
     #
     # @!attribute [rw] replicas
     #   Represents replicas of the table.
+    #
+    #   After a successful disassociation, this list is absent or empty. To
+    #   confirm disassociation, also verify that `TableStatus` is `ACTIVE`.
     #   @return [Array<Types::ReplicaDescription>]
     #
     # @!attribute [rw] global_table_witnesses
@@ -9625,6 +9683,12 @@ module Aws::DynamoDB
     #   (false) on the table.
     #   @return [Boolean]
     #
+    # @!attribute [rw] disassociation_protection_enabled
+    #   Specifies whether disassociation protection is enabled (`true`) or
+    #   disabled (`false`) for the local global table replica. Protection is
+    #   enabled by default.
+    #   @return [Boolean]
+    #
     # @!attribute [rw] on_demand_throughput
     #   The maximum number of read and write units for the specified
     #   on-demand table. If you use this parameter, you must specify
@@ -9720,6 +9784,7 @@ module Aws::DynamoDB
       :archival_summary,
       :table_class_summary,
       :deletion_protection_enabled,
+      :disassociation_protection_enabled,
       :on_demand_throughput,
       :warm_throughput,
       :multi_region_consistency,
@@ -11306,8 +11371,8 @@ module Aws::DynamoDB
     #   @return [Types::SSESpecification]
     #
     # @!attribute [rw] replica_updates
-    #   A list of replica update actions (create, delete, or update) for the
-    #   table.
+    #   A list of replica update actions (create, delete, update, or
+    #   disassociate) for the table.
     #   @return [Array<Types::ReplicationGroupUpdate>]
     #
     # @!attribute [rw] table_class
@@ -11393,6 +11458,19 @@ module Aws::DynamoDB
     #     to create a Multi-Account Global Table using this table.
     #   @return [String]
     #
+    # @!attribute [rw] disassociation_protection_enabled
+    #   Specifies whether disassociation protection is enabled (`true`) or
+    #   disabled (`false`) for the local replica of a multi-Region eventual
+    #   consistency (MREC) global table using Version 2019.11.21.
+    #
+    #   Disassociation protection is enabled by default. If you omit this
+    #   parameter, the existing setting is unchanged. This setting is
+    #   independent of `DeletionProtectionEnabled`.
+    #
+    #   You can't combine this change with any other change in the same
+    #   `UpdateTable` request.
+    #   @return [Boolean]
+    #
     # @!attribute [rw] vector_index_updates
     #   A list of vector indexes to be added to or removed from the table.
     #   You can add or remove one vector index for each `UpdateTable`
@@ -11421,6 +11499,7 @@ module Aws::DynamoDB
       :on_demand_throughput,
       :warm_throughput,
       :global_table_settings_replication_mode,
+      :disassociation_protection_enabled,
       :vector_index_updates)
       SENSITIVE = []
       include Aws::Structure

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.176.0'
+  GEM_VERSION = '1.177.0'
 
 end
 

data/sig/client.rbs

@@ -28,6 +28,7 @@ module Aws
                       ?convert_params: bool,
                       ?correct_clock_skew: bool,
                       ?defaults_mode: String,
+                      ?disable_clock_skew_correction: bool,
                       ?disable_host_prefix_injection: bool,
                       ?disable_request_compression: bool,
                       ?endpoint: String,
@@ -1219,6 +1220,10 @@ module Aws
                               }?,
                               delete: {
                                 region_name: ::String
+                              }?,
+                              disassociate: {
+                                region_name: ::String,
+                                disassociation_mode: ("WAIT_FOR_REPLICATION")
                               }?
                             }
                           ],
@@ -1244,6 +1249,7 @@ module Aws
                             write_units_per_second: ::Integer?
                           },
                           ?global_table_settings_replication_mode: ("ENABLED" | "DISABLED" | "ENABLED_WITH_OVERRIDES"),
+                          ?disassociation_protection_enabled: bool,
                           ?vector_index_updates: Array[
                             {
                               create: {

data/sig/resource.rbs

@@ -28,6 +28,7 @@ module Aws
                         ?convert_params: bool,
                         ?correct_clock_skew: bool,
                         ?defaults_mode: String,
+                        ?disable_clock_skew_correction: bool,
                         ?disable_host_prefix_injection: bool,
                         ?disable_request_compression: bool,
                         ?endpoint: String,

data/sig/table.rbs

@@ -90,6 +90,9 @@ module Aws
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Table.html#deletion_protection_enabled-instance_method
       def deletion_protection_enabled: () -> bool
 
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Table.html#disassociation_protection_enabled-instance_method
+      def disassociation_protection_enabled: () -> bool
+
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Table.html#on_demand_throughput-instance_method
       def on_demand_throughput: () -> Types::OnDemandThroughput
 
@@ -338,6 +341,10 @@ module Aws
                         }?,
                         delete: {
                           region_name: ::String
+                        }?,
+                        disassociate: {
+                          region_name: ::String,
+                          disassociation_mode: ("WAIT_FOR_REPLICATION")
                         }?
                       }
                     ],
@@ -363,6 +370,7 @@ module Aws
                       write_units_per_second: ::Integer?
                     },
                     ?global_table_settings_replication_mode: ("ENABLED" | "DISABLED" | "ENABLED_WITH_OVERRIDES"),
+                    ?disassociation_protection_enabled: bool,
                     ?vector_index_updates: Array[
                       {
                         create: {

data/sig/types.rbs

@@ -589,6 +589,12 @@ module Aws::DynamoDB
       SENSITIVE: []
     end
 
+    class DisassociateReplicationGroupMemberAction
+      attr_accessor region_name: ::String
+      attr_accessor disassociation_mode: ("WAIT_FOR_REPLICATION")
+      SENSITIVE: []
+    end
+
     class DuplicateItemException
       attr_accessor message: ::String
       SENSITIVE: []
@@ -1415,6 +1421,7 @@ module Aws::DynamoDB
       attr_accessor create: Types::CreateReplicationGroupMemberAction
       attr_accessor update: Types::UpdateReplicationGroupMemberAction
       attr_accessor delete: Types::DeleteReplicationGroupMemberAction
+      attr_accessor disassociate: Types::DisassociateReplicationGroupMemberAction
       SENSITIVE: []
     end
 
@@ -1650,6 +1657,7 @@ module Aws::DynamoDB
       attr_accessor archival_summary: Types::ArchivalSummary
       attr_accessor table_class_summary: Types::TableClassSummary
       attr_accessor deletion_protection_enabled: bool
+      attr_accessor disassociation_protection_enabled: bool
       attr_accessor on_demand_throughput: Types::OnDemandThroughput
       attr_accessor warm_throughput: Types::TableWarmThroughputDescription
       attr_accessor multi_region_consistency: ("EVENTUAL" | "STRONG")
@@ -1914,6 +1922,7 @@ module Aws::DynamoDB
       attr_accessor on_demand_throughput: Types::OnDemandThroughput
       attr_accessor warm_throughput: Types::WarmThroughput
       attr_accessor global_table_settings_replication_mode: ("ENABLED" | "DISABLED" | "ENABLED_WITH_OVERRIDES")
+      attr_accessor disassociation_protection_enabled: bool
       attr_accessor vector_index_updates: ::Array[Types::VectorIndexUpdate]
       SENSITIVE: []
     end

metadata

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