@aws-sdk/client-dynamodb 3.1153.0 → 3.1155.0

package/dist-cjs/index.js

@@ -756,10 +756,13 @@ const _DKSDi = "DisableKinesisStreamingDestination";
 const _DL = "DescribeLimits";
 const _DLI = "DescribeLimitsInput";
 const _DLO = "DescribeLimitsOutput";
+const _DM = "DisassociationMode";
 const _DPE = "DeletionProtectionEnabled";
+const _DPEi = "DisassociationProtectionEnabled";
 const _DR = "DeleteRequest";
 const _DRA = "DeleteReplicaAction";
 const _DRGMA = "DeleteReplicationGroupMemberAction";
+const _DRGMAi = "DisassociateReplicationGroupMemberAction";
 const _DRP = "DeleteResourcePolicy";
 const _DRPI = "DeleteResourcePolicyInput";
 const _DRPO = "DeleteResourcePolicyOutput";
@@ -781,6 +784,7 @@ const _DTe = "DescribeTable";
 const _DVIA = "DeleteVectorIndexAction";
 const _De = "Delimiter";
 const _Del = "Delete";
+const _Di = "Disassociate";
 const _E = "Error";
 const _EA = "ExportArn";
 const _EAM = "ExpectedAttributeMap";
@@ -1921,6 +1925,11 @@ var DescribeTimeToLiveOutput$ = [3, n0, _DTTLO,
     [_TTLD],
     [() => TimeToLiveDescription$]
 ];
+var DisassociateReplicationGroupMemberAction$ = [3, n0, _DRGMAi,
+    0,
+    [_RN, _DM],
+    [0, 0], 2
+];
 var EnableKinesisStreamingConfiguration$ = [3, n0, _EKSC,
     0,
     [_ACDTP],
@@ -2363,8 +2372,8 @@ var ReplicaSettingsUpdate$ = [3, n0, _RSU,
 ];
 var ReplicationGroupUpdate$ = [3, n0, _RGU,
     0,
-    [_Cr, _U, _Del],
-    [() => CreateReplicationGroupMemberAction$, () => UpdateReplicationGroupMemberAction$, () => DeleteReplicationGroupMemberAction$]
+    [_Cr, _U, _Del, _Di],
+    [() => CreateReplicationGroupMemberAction$, () => UpdateReplicationGroupMemberAction$, () => DeleteReplicationGroupMemberAction$, () => DisassociateReplicationGroupMemberAction$]
 ];
 var ReplicaUpdate$ = [3, n0, _RU,
     0,
@@ -2473,8 +2482,8 @@ var TableCreationParameters$ = [3, n0, _TCP,
 ];
 var TableDescription$ = [3, n0, _TD,
     0,
-    [_ADt, _TN, _KS, _TSa, _CDT, _PT, _TSB, _IC, _TA, _TI, _BMS, _LSI, _GSI, _SS, _LSL, _LSA, _GTV, _Rep, _GTW, _GTSRM, _RSes, _SSED, _AS, _TCS, _DPE, _ODT, _WT, _MRC, _VI],
-    [() => AttributeDefinitions, 0, () => KeySchema, 0, 4, () => ProvisionedThroughputDescription$, 1, 1, 0, 0, () => BillingModeSummary$, () => LocalSecondaryIndexDescriptionList, () => GlobalSecondaryIndexDescriptionList, () => StreamSpecification$, 0, 0, 0, () => ReplicaDescriptionList, () => GlobalTableWitnessDescriptionList, 0, () => RestoreSummary$, () => SSEDescription$, () => ArchivalSummary$, () => TableClassSummary$, 2, () => OnDemandThroughput$, () => TableWarmThroughputDescription$, 0, () => VectorIndexDescriptionList]
+    [_ADt, _TN, _KS, _TSa, _CDT, _PT, _TSB, _IC, _TA, _TI, _BMS, _LSI, _GSI, _SS, _LSL, _LSA, _GTV, _Rep, _GTW, _GTSRM, _RSes, _SSED, _AS, _TCS, _DPE, _DPEi, _ODT, _WT, _MRC, _VI],
+    [() => AttributeDefinitions, 0, () => KeySchema, 0, 4, () => ProvisionedThroughputDescription$, 1, 1, 0, 0, () => BillingModeSummary$, () => LocalSecondaryIndexDescriptionList, () => GlobalSecondaryIndexDescriptionList, () => StreamSpecification$, 0, 0, 0, () => ReplicaDescriptionList, () => GlobalTableWitnessDescriptionList, 0, () => RestoreSummary$, () => SSEDescription$, () => ArchivalSummary$, () => TableClassSummary$, 2, 2, () => OnDemandThroughput$, () => TableWarmThroughputDescription$, 0, () => VectorIndexDescriptionList]
 ];
 var TableWarmThroughputDescription$ = [3, n0, _TWTD,
     0,
@@ -2623,8 +2632,8 @@ var UpdateReplicationGroupMemberAction$ = [3, n0, _URGMA,
 ];
 var UpdateTableInput$ = [3, n0, _UTI,
     0,
-    [_TN, _ADt, _BM, _PT, _GSIUl, _SS, _SSES, _RUe, _TC, _DPE, _MRC, _GTWU, _ODT, _WT, _GTSRM, _VIU],
-    [0, () => AttributeDefinitions, 0, () => ProvisionedThroughput$, () => GlobalSecondaryIndexUpdateList, () => StreamSpecification$, () => SSESpecification$, () => ReplicationGroupUpdateList, 0, 2, 0, () => GlobalTableWitnessGroupUpdateList, () => OnDemandThroughput$, () => WarmThroughput$, 0, () => VectorIndexUpdateList], 1
+    [_TN, _ADt, _BM, _PT, _GSIUl, _SS, _SSES, _RUe, _TC, _DPE, _MRC, _GTWU, _ODT, _WT, _GTSRM, _DPEi, _VIU],
+    [0, () => AttributeDefinitions, 0, () => ProvisionedThroughput$, () => GlobalSecondaryIndexUpdateList, () => StreamSpecification$, () => SSESpecification$, () => ReplicationGroupUpdateList, 0, 2, 0, () => GlobalTableWitnessGroupUpdateList, () => OnDemandThroughput$, () => WarmThroughput$, 0, 2, () => VectorIndexUpdateList], 1
 ];
 var UpdateTableOutput$ = [3, n0, _UTO,
     0,
@@ -3100,7 +3109,7 @@ var UpdateTimeToLive$ = [9, n0, _UTTL,
 class DescribeEndpointsCommand extends command(_ep0, _mw0, "DescribeEndpoints", DescribeEndpoints$) {
 }
 
-var version = "3.1152.0";
+var version = "3.1154.0";
 var packageInfo = {
 	version: version};
 
@@ -4196,6 +4205,9 @@ const DestinationStatus = {
     ENABLING: "ENABLING",
     UPDATING: "UPDATING",
 };
+const DisassociationMode = {
+    WAIT_FOR_REPLICATION: "WAIT_FOR_REPLICATION",
+};
 const Select = {
     ALL_ATTRIBUTES: "ALL_ATTRIBUTES",
     ALL_PROJECTED_ATTRIBUTES: "ALL_PROJECTED_ATTRIBUTES",
@@ -4356,6 +4368,8 @@ exports.DescribeTimeToLiveOutput$ = DescribeTimeToLiveOutput$;
 exports.DestinationStatus = DestinationStatus;
 exports.DisableKinesisStreamingDestination$ = DisableKinesisStreamingDestination$;
 exports.DisableKinesisStreamingDestinationCommand = DisableKinesisStreamingDestinationCommand;
+exports.DisassociateReplicationGroupMemberAction$ = DisassociateReplicationGroupMemberAction$;
+exports.DisassociationMode = DisassociationMode;
 exports.DuplicateItemException = DuplicateItemException;
 exports.DuplicateItemException$ = DuplicateItemException$;
 exports.DynamoDB = DynamoDB;

package/dist-es/models/enums.js

@@ -246,6 +246,9 @@ export const DestinationStatus = {
     ENABLING: "ENABLING",
     UPDATING: "UPDATING",
 };
+export const DisassociationMode = {
+    WAIT_FOR_REPLICATION: "WAIT_FOR_REPLICATION",
+};
 export const Select = {
     ALL_ATTRIBUTES: "ALL_ATTRIBUTES",
     ALL_PROJECTED_ATTRIBUTES: "ALL_PROJECTED_ATTRIBUTES",

package/dist-es/schemas/schemas_0.js

@@ -153,10 +153,13 @@ const _DKSDi = "DisableKinesisStreamingDestination";
 const _DL = "DescribeLimits";
 const _DLI = "DescribeLimitsInput";
 const _DLO = "DescribeLimitsOutput";
+const _DM = "DisassociationMode";
 const _DPE = "DeletionProtectionEnabled";
+const _DPEi = "DisassociationProtectionEnabled";
 const _DR = "DeleteRequest";
 const _DRA = "DeleteReplicaAction";
 const _DRGMA = "DeleteReplicationGroupMemberAction";
+const _DRGMAi = "DisassociateReplicationGroupMemberAction";
 const _DRP = "DeleteResourcePolicy";
 const _DRPI = "DeleteResourcePolicyInput";
 const _DRPO = "DeleteResourcePolicyOutput";
@@ -178,6 +181,7 @@ const _DTe = "DescribeTable";
 const _DVIA = "DeleteVectorIndexAction";
 const _De = "Delimiter";
 const _Del = "Delete";
+const _Di = "Disassociate";
 const _E = "Error";
 const _EA = "ExportArn";
 const _EAM = "ExpectedAttributeMap";
@@ -1321,6 +1325,11 @@ export var DescribeTimeToLiveOutput$ = [3, n0, _DTTLO,
     [_TTLD],
     [() => TimeToLiveDescription$]
 ];
+export var DisassociateReplicationGroupMemberAction$ = [3, n0, _DRGMAi,
+    0,
+    [_RN, _DM],
+    [0, 0], 2
+];
 export var EnableKinesisStreamingConfiguration$ = [3, n0, _EKSC,
     0,
     [_ACDTP],
@@ -1763,8 +1772,8 @@ export var ReplicaSettingsUpdate$ = [3, n0, _RSU,
 ];
 export var ReplicationGroupUpdate$ = [3, n0, _RGU,
     0,
-    [_Cr, _U, _Del],
-    [() => CreateReplicationGroupMemberAction$, () => UpdateReplicationGroupMemberAction$, () => DeleteReplicationGroupMemberAction$]
+    [_Cr, _U, _Del, _Di],
+    [() => CreateReplicationGroupMemberAction$, () => UpdateReplicationGroupMemberAction$, () => DeleteReplicationGroupMemberAction$, () => DisassociateReplicationGroupMemberAction$]
 ];
 export var ReplicaUpdate$ = [3, n0, _RU,
     0,
@@ -1873,8 +1882,8 @@ export var TableCreationParameters$ = [3, n0, _TCP,
 ];
 export var TableDescription$ = [3, n0, _TD,
     0,
-    [_ADt, _TN, _KS, _TSa, _CDT, _PT, _TSB, _IC, _TA, _TI, _BMS, _LSI, _GSI, _SS, _LSL, _LSA, _GTV, _Rep, _GTW, _GTSRM, _RSes, _SSED, _AS, _TCS, _DPE, _ODT, _WT, _MRC, _VI],
-    [() => AttributeDefinitions, 0, () => KeySchema, 0, 4, () => ProvisionedThroughputDescription$, 1, 1, 0, 0, () => BillingModeSummary$, () => LocalSecondaryIndexDescriptionList, () => GlobalSecondaryIndexDescriptionList, () => StreamSpecification$, 0, 0, 0, () => ReplicaDescriptionList, () => GlobalTableWitnessDescriptionList, 0, () => RestoreSummary$, () => SSEDescription$, () => ArchivalSummary$, () => TableClassSummary$, 2, () => OnDemandThroughput$, () => TableWarmThroughputDescription$, 0, () => VectorIndexDescriptionList]
+    [_ADt, _TN, _KS, _TSa, _CDT, _PT, _TSB, _IC, _TA, _TI, _BMS, _LSI, _GSI, _SS, _LSL, _LSA, _GTV, _Rep, _GTW, _GTSRM, _RSes, _SSED, _AS, _TCS, _DPE, _DPEi, _ODT, _WT, _MRC, _VI],
+    [() => AttributeDefinitions, 0, () => KeySchema, 0, 4, () => ProvisionedThroughputDescription$, 1, 1, 0, 0, () => BillingModeSummary$, () => LocalSecondaryIndexDescriptionList, () => GlobalSecondaryIndexDescriptionList, () => StreamSpecification$, 0, 0, 0, () => ReplicaDescriptionList, () => GlobalTableWitnessDescriptionList, 0, () => RestoreSummary$, () => SSEDescription$, () => ArchivalSummary$, () => TableClassSummary$, 2, 2, () => OnDemandThroughput$, () => TableWarmThroughputDescription$, 0, () => VectorIndexDescriptionList]
 ];
 export var TableWarmThroughputDescription$ = [3, n0, _TWTD,
     0,
@@ -2023,8 +2032,8 @@ export var UpdateReplicationGroupMemberAction$ = [3, n0, _URGMA,
 ];
 export var UpdateTableInput$ = [3, n0, _UTI,
     0,
-    [_TN, _ADt, _BM, _PT, _GSIUl, _SS, _SSES, _RUe, _TC, _DPE, _MRC, _GTWU, _ODT, _WT, _GTSRM, _VIU],
-    [0, () => AttributeDefinitions, 0, () => ProvisionedThroughput$, () => GlobalSecondaryIndexUpdateList, () => StreamSpecification$, () => SSESpecification$, () => ReplicationGroupUpdateList, 0, 2, 0, () => GlobalTableWitnessGroupUpdateList, () => OnDemandThroughput$, () => WarmThroughput$, 0, () => VectorIndexUpdateList], 1
+    [_TN, _ADt, _BM, _PT, _GSIUl, _SS, _SSES, _RUe, _TC, _DPE, _MRC, _GTWU, _ODT, _WT, _GTSRM, _DPEi, _VIU],
+    [0, () => AttributeDefinitions, 0, () => ProvisionedThroughput$, () => GlobalSecondaryIndexUpdateList, () => StreamSpecification$, () => SSESpecification$, () => ReplicationGroupUpdateList, 0, 2, 0, () => GlobalTableWitnessGroupUpdateList, () => OnDemandThroughput$, () => WarmThroughput$, 0, 2, () => VectorIndexUpdateList], 1
 ];
 export var UpdateTableOutput$ = [3, n0, _UTO,
     0,

package/dist-types/DynamoDBClient.d.ts

@@ -192,7 +192,8 @@ export interface ClientDefaults extends Partial<__SmithyConfiguration<__HttpHand
     maxAttempts?: number | __Provider<number>;
     /**
      * Specifies which retry algorithm to use.
-     * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-smithy-util-retry/Enum/RETRY_MODES/
+     * Accepted values are "standard" and "adaptive".
+     * @see https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html
      *
      */
     retryMode?: string | __Provider<string>;

package/dist-types/commands/CreateTableCommand.d.ts

@@ -332,6 +332,7 @@ declare const CreateTableCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),

package/dist-types/commands/DeleteTableCommand.d.ts

@@ -225,6 +225,7 @@ declare const DeleteTableCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),

package/dist-types/commands/DescribeTableCommand.d.ts

@@ -216,6 +216,7 @@ declare const DescribeTableCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),

package/dist-types/commands/RestoreTableFromBackupCommand.d.ts

@@ -314,6 +314,7 @@ declare const RestoreTableFromBackupCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),

package/dist-types/commands/RestoreTableToPointInTimeCommand.d.ts

@@ -343,6 +343,7 @@ declare const RestoreTableToPointInTimeCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),

package/dist-types/commands/UpdateTableCommand.d.ts

@@ -24,8 +24,8 @@ declare const UpdateTableCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions;
 };
 /**
- * <p>Modifies the provisioned throughput settings, global secondary indexes, or DynamoDB
- *             Streams settings for a given table.</p>
+ * <p>Modifies the provisioned throughput settings, global secondary indexes, DynamoDB
+ *             Streams settings, or global table replica settings for a given table.</p>
  *          <p>You can only perform one of the following operations at once:</p>
  *          <ul>
  *             <li>
@@ -39,13 +39,36 @@ declare const UpdateTableCommand_base: {
  *                     backfilling, you can use <code>UpdateTable</code> to perform other
  *                     operations.</p>
  *             </li>
+ *             <li>
+ *                <p>Enable or disable disassociation protection for the local global table
+ *                     replica.</p>
+ *             </li>
+ *             <li>
+ *                <p>Disassociate the local global table replica and keep it as a standalone
+ *                     regional table. The <code>Disassociate</code> action must be the only
+ *                     replica update in the request. If the request includes any other update,
+ *                     <code>UpdateTable</code> fails with a <code>ValidationException</code> and
+ *                     the disassociation does not start.</p>
+ *             </li>
  *          </ul>
  *          <p>
  *             <code>UpdateTable</code> is an asynchronous operation; while it's executing, the table
  *             status changes from <code>ACTIVE</code> to <code>UPDATING</code>. While it's
  *                 <code>UPDATING</code>, you can't issue another <code>UpdateTable</code> request.
- *             When the table returns to the <code>ACTIVE</code> state, the <code>UpdateTable</code>
- *             operation is complete.</p>
+ *             Use <code>DescribeTable</code> to monitor the table's status.</p>
+ *          <p>To use this operation to disassociate a local replica, you must have the
+ *             <code>dynamodb:UpdateTable</code> and <code>dynamodb:DisassociateTableReplica</code>
+ *             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
+ *             <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html">Disassociating a global table replica</a> in the <i>Amazon DynamoDB
+ *                 Developer Guide</i>.</p>
+ *          <p>To confirm successful disassociation, call <code>DescribeTable</code> in the
+ *             replica's Region and verify that <code>TableStatus</code> is <code>ACTIVE</code>
+ *             and <code>Replicas</code> is absent or empty. If <code>TableStatus</code> returns to
+ *             <code>ACTIVE</code> but the response still includes a <code>Replicas</code> list, the
+ *             disassociation did not complete. Check <code>ReplicaStatus</code> for a
+ *             replication-permission or encryption-access problem, resolve it, and retry.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -174,6 +197,10 @@ declare const UpdateTableCommand_base: {
  *       Delete: { // DeleteReplicationGroupMemberAction
  *         RegionName: "STRING_VALUE", // required
  *       },
+ *       Disassociate: { // DisassociateReplicationGroupMemberAction
+ *         RegionName: "STRING_VALUE", // required
+ *         DisassociationMode: "WAIT_FOR_REPLICATION", // required
+ *       },
  *     },
  *   ],
  *   TableClass: "STANDARD" || "STANDARD_INFREQUENT_ACCESS",
@@ -198,6 +225,7 @@ declare const UpdateTableCommand_base: {
  *     WriteUnitsPerSecond: Number("long"),
  *   },
  *   GlobalTableSettingsReplicationMode: "ENABLED" || "DISABLED" || "ENABLED_WITH_OVERRIDES",
+ *   DisassociationProtectionEnabled: true || false,
  *   VectorIndexUpdates: [ // VectorIndexUpdateList
  *     { // VectorIndexUpdate
  *       Create: { // CreateVectorIndexAction
@@ -397,6 +425,7 @@ declare const UpdateTableCommand_base: {
  * //       LastUpdateDateTime: new Date("TIMESTAMP"),
  * //     },
  * //     DeletionProtectionEnabled: true || false,
+ * //     DisassociationProtectionEnabled: true || false,
  * //     OnDemandThroughput: {
  * //       MaxReadRequestUnits: Number("long"),
  * //       MaxWriteRequestUnits: Number("long"),
@@ -493,6 +522,120 @@ declare const UpdateTableCommand_base: {
  * <p>Base exception class for all service exceptions from DynamoDB service.</p>
  *
  *
+ * @example To modify a table's provisioned throughput
+ * ```javascript
+ * // This example increases the provisioned read and write capacity on the Music table.
+ * const input = {
+ *   ProvisionedThroughput: {
+ *     ReadCapacityUnits: 10,
+ *     WriteCapacityUnits: 10
+ *   },
+ *   TableName: "MusicCollection"
+ * };
+ * const command = new UpdateTableCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   TableDescription: {
+ *     AttributeDefinitions: [
+ *       {
+ *         AttributeName: "Artist",
+ *         AttributeType: "S"
+ *       },
+ *       {
+ *         AttributeName: "SongTitle",
+ *         AttributeType: "S"
+ *       }
+ *     ],
+ *     CreationDateTime: 1.421866952062E9,
+ *     ItemCount: 0,
+ *     KeySchema: [
+ *       {
+ *         AttributeName: "Artist",
+ *         KeyType: "HASH"
+ *       },
+ *       {
+ *         AttributeName: "SongTitle",
+ *         KeyType: "RANGE"
+ *       }
+ *     ],
+ *     ProvisionedThroughput: {
+ *       LastIncreaseDateTime: 1.421874759194E9,
+ *       NumberOfDecreasesToday: 1,
+ *       ReadCapacityUnits: 1,
+ *       WriteCapacityUnits: 1
+ *     },
+ *     TableName: "MusicCollection",
+ *     TableSizeBytes: 0,
+ *     TableStatus: "UPDATING"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @example To disable disassociation protection on a local replica
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   DisassociationProtectionEnabled: false,
+ *   TableName: "MusicCollection"
+ * };
+ * const command = new UpdateTableCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   TableDescription: {
+ *     DisassociationProtectionEnabled: false,
+ *     GlobalTableVersion: "2019.11.21",
+ *     Replicas: [
+ *       {
+ *         RegionName: "us-east-1",
+ *         ReplicaStatus: "ACTIVE"
+ *       }
+ *     ],
+ *     TableArn: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
+ *     TableName: "MusicCollection",
+ *     TableStatus: "ACTIVE"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
+ * @example To disassociate a local global table replica
+ * ```javascript
+ * // 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.
+ * const input = {
+ *   ReplicaUpdates: [
+ *     {
+ *       Disassociate: {
+ *         DisassociationMode: "WAIT_FOR_REPLICATION",
+ *         RegionName: "us-west-2"
+ *       }
+ *     }
+ *   ],
+ *   TableName: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection"
+ * };
+ * const command = new UpdateTableCommand(input);
+ * const response = await client.send(command);
+ * /* response is
+ * {
+ *   TableDescription: {
+ *     DisassociationProtectionEnabled: false,
+ *     GlobalTableVersion: "2019.11.21",
+ *     Replicas: [
+ *       {
+ *         RegionName: "us-east-1",
+ *         ReplicaStatus: "ACTIVE"
+ *       }
+ *     ],
+ *     TableArn: "arn:aws:dynamodb:us-west-2:123456789012:table/MusicCollection",
+ *     TableName: "MusicCollection",
+ *     TableStatus: "UPDATING"
+ *   }
+ * }
+ * *\/
+ * ```
+ *
  * @public
  */
 export declare class UpdateTableCommand extends UpdateTableCommand_base {

package/dist-types/models/enums.d.ts

@@ -598,6 +598,17 @@ export declare const DestinationStatus: {
  * @public
  */
 export type DestinationStatus = (typeof DestinationStatus)[keyof typeof DestinationStatus];
+/**
+ * @public
+ * @enum
+ */
+export declare const DisassociationMode: {
+    readonly WAIT_FOR_REPLICATION: "WAIT_FOR_REPLICATION";
+};
+/**
+ * @public
+ */
+export type DisassociationMode = (typeof DisassociationMode)[keyof typeof DisassociationMode];
 /**
  * @public
  * @enum

package/dist-types/models/models_0.d.ts

@@ -1,4 +1,4 @@
-import type { ApproximateCreationDateTimePrecision, AttributeAction, BackupStatus, BackupType, BackupTypeFilter, BatchStatementErrorCodeEnum, BillingMode, ComparisonOperator, ConditionalOperator, ContinuousBackupsStatus, ContributorInsightsAction, ContributorInsightsMode, ContributorInsightsStatus, DestinationStatus, ExportFormat, ExportStatus, ExportType, ExportViewType, GlobalTableSettingsReplicationMode, GlobalTableStatus, ImportStatus, IndexStatus, InputCompressionType, InputFormat, KeyType, MultiRegionConsistency, PointInTimeRecoveryStatus, ProjectionType, ReplicaStatus, ReturnConsumedCapacity, ReturnItemCollectionMetrics, ReturnValue, ReturnValuesOnConditionCheckFailure, S3SseAlgorithm, ScalarAttributeType, SearchSchemaElementType, Select, SSEStatus, SSEType, StreamViewType, TableClass, TableStatus, TimeToLiveStatus, VectorDistanceFunction, WitnessStatus } from "./enums";
+import type { ApproximateCreationDateTimePrecision, AttributeAction, BackupStatus, BackupType, BackupTypeFilter, BatchStatementErrorCodeEnum, BillingMode, ComparisonOperator, ConditionalOperator, ContinuousBackupsStatus, ContributorInsightsAction, ContributorInsightsMode, ContributorInsightsStatus, DestinationStatus, DisassociationMode, ExportFormat, ExportStatus, ExportType, ExportViewType, GlobalTableSettingsReplicationMode, GlobalTableStatus, ImportStatus, IndexStatus, InputCompressionType, InputFormat, KeyType, MultiRegionConsistency, PointInTimeRecoveryStatus, ProjectionType, ReplicaStatus, ReturnConsumedCapacity, ReturnItemCollectionMetrics, ReturnValue, ReturnValuesOnConditionCheckFailure, S3SseAlgorithm, ScalarAttributeType, SearchSchemaElementType, Select, SSEStatus, SSEType, StreamViewType, TableClass, TableStatus, TimeToLiveStatus, VectorDistanceFunction, WitnessStatus } from "./enums";
 /**
  * <p>Contains details of a table archival operation.</p>
  * @public
@@ -3125,6 +3125,9 @@ export interface TableDescription {
     GlobalTableVersion?: string | undefined;
     /**
      * <p>Represents replicas of the table.</p>
+     *          <p>After a successful disassociation, this list is absent or empty. To confirm
+     *             disassociation, also verify that <code>TableStatus</code> is
+     *             <code>ACTIVE</code>.</p>
      * @public
      */
     Replicas?: ReplicaDescription[] | undefined;
@@ -3182,6 +3185,13 @@ export interface TableDescription {
      * @public
      */
     DeletionProtectionEnabled?: boolean | undefined;
+    /**
+     * <p>Specifies whether disassociation protection is enabled (<code>true</code>) or
+     *             disabled (<code>false</code>) for the local global table replica. Protection is
+     *             enabled by default.</p>
+     * @public
+     */
+    DisassociationProtectionEnabled?: boolean | undefined;
     /**
      * <p>The maximum number of read and write units for the specified on-demand table. If you
      *             use this parameter, you must specify <code>MaxReadRequestUnits</code>,
@@ -4467,6 +4477,33 @@ export interface KinesisStreamingDestinationOutput {
      */
     EnableKinesisStreamingConfiguration?: EnableKinesisStreamingConfiguration | undefined;
 }
+/**
+ * <p>The parameters for disassociating the local replica from a global table using
+ *             Version 2019.11.21 with multi-Region eventual consistency (MREC).</p>
+ *          <p>After disassociation completes, the replica remains a standalone regional table
+ *             that keeps its data, indexes, and table settings.</p>
+ *          <p>For request requirements, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html">UpdateTable</a>.
+ *             For prerequisites, the protection update, and completion checks, see <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html">Disassociating a global table replica</a> in the <i>Amazon DynamoDB
+ *                 Developer Guide</i>.</p>
+ * @public
+ */
+export interface DisassociateReplicationGroupMemberAction {
+    /**
+     * <p>The Region of the replica to disassociate. Set this value to the Region where
+     *             you send the <code>UpdateTable</code> request. You must use credentials for the
+     *             account that owns the replica.</p>
+     * @public
+     */
+    RegionName: string | undefined;
+    /**
+     * <p>The mode for handling pending replication before disassociation completes.
+     *             You must specify <code>WAIT_FOR_REPLICATION</code>. For more information, see
+     *             <a href="https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables-disassociate.html">Disassociating a global table replica</a> in the <i>Amazon DynamoDB
+     *                 Developer Guide</i>.</p>
+     * @public
+     */
+    DisassociationMode: DisassociationMode | undefined;
+}
 /**
  * @public
  */
@@ -5759,7 +5796,14 @@ export interface UpdateReplicationGroupMemberAction {
  *                         <code>DeleteTableReplica</code> action in the destination Region, deleting
  *                     the replica and all if its items in the destination Region.</p>
  *             </li>
+ *             <li>
+ *                <p>The local replica to be disassociated from a global table and retained as
+ *                     a standalone regional table.</p>
+ *             </li>
  *          </ul>
+ *          <p>Each <code>ReplicationGroupUpdate</code> contains exactly one action. A
+ *             <code>Disassociate</code> action must be the only replica update in the request;
+ *             including other updates causes the request to fail.</p>
  *          <note>
  *             <p>When you manually remove a table or global table replica, you do not automatically
  *                 remove any associated scalable targets, scaling policies, or CloudWatch
@@ -5783,6 +5827,12 @@ export interface ReplicationGroupUpdate {
      * @public
      */
     Delete?: DeleteReplicationGroupMemberAction | undefined;
+    /**
+     * <p>The parameters for disassociating the local replica from the global table and
+     *             retaining it as a standalone regional table.</p>
+     * @public
+     */
+    Disassociate?: DisassociateReplicationGroupMemberAction | undefined;
 }
 /**
  * <p>A vector index to be added to or removed from a table.</p>
@@ -5888,7 +5938,8 @@ export interface UpdateTableInput {
      */
     SSESpecification?: SSESpecification | undefined;
     /**
-     * <p>A list of replica update actions (create, delete, or update) for the table.</p>
+     * <p>A list of replica update actions (create, delete, update, or disassociate) for the
+     *             table.</p>
      * @public
      */
     ReplicaUpdates?: ReplicationGroupUpdate[] | undefined;
@@ -5982,6 +6033,18 @@ export interface UpdateTableInput {
      * @public
      */
     GlobalTableSettingsReplicationMode?: GlobalTableSettingsReplicationMode | undefined;
+    /**
+     * <p>Specifies whether disassociation protection is enabled (<code>true</code>) or
+     *             disabled (<code>false</code>) for the local replica of a multi-Region eventual
+     *             consistency (MREC) global table using Version 2019.11.21.</p>
+     *          <p>Disassociation protection is enabled by default. If you omit this parameter, the
+     *             existing setting is unchanged. This setting is independent of
+     *             <code>DeletionProtectionEnabled</code>.</p>
+     *          <p>You can't combine this change with any other change in the same
+     *             <code>UpdateTable</code> request.</p>
+     * @public
+     */
+    DisassociationProtectionEnabled?: boolean | undefined;
     /**
      * <p>A list of vector indexes to be added to or removed from the table. You can add or
      *             remove one vector index for each <code>UpdateTable</code> operation.</p>

package/dist-types/schemas/schemas_0.d.ts

@@ -124,6 +124,7 @@ export declare var DescribeTableReplicaAutoScalingInput$: StaticStructureSchema;
 export declare var DescribeTableReplicaAutoScalingOutput$: StaticStructureSchema;
 export declare var DescribeTimeToLiveInput$: StaticStructureSchema;
 export declare var DescribeTimeToLiveOutput$: StaticStructureSchema;
+export declare var DisassociateReplicationGroupMemberAction$: StaticStructureSchema;
 export declare var EnableKinesisStreamingConfiguration$: StaticStructureSchema;
 export declare var Endpoint$: StaticStructureSchema;
 export declare var ExecuteStatementInput$: StaticStructureSchema;

package/dist-types/ts3.4/models/enums.d.ts

@@ -304,6 +304,10 @@ export declare const DestinationStatus: {
   readonly UPDATING: "UPDATING";
 };
 export type DestinationStatus = (typeof DestinationStatus)[keyof typeof DestinationStatus];
+export declare const DisassociationMode: {
+  readonly WAIT_FOR_REPLICATION: "WAIT_FOR_REPLICATION";
+};
+export type DisassociationMode = (typeof DisassociationMode)[keyof typeof DisassociationMode];
 export declare const Select: {
   readonly ALL_ATTRIBUTES: "ALL_ATTRIBUTES";
   readonly ALL_PROJECTED_ATTRIBUTES: "ALL_PROJECTED_ATTRIBUTES";

package/dist-types/ts3.4/models/models_0.d.ts

@@ -13,6 +13,7 @@ import {
   ContributorInsightsMode,
   ContributorInsightsStatus,
   DestinationStatus,
+  DisassociationMode,
   ExportFormat,
   ExportStatus,
   ExportType,
@@ -461,6 +462,7 @@ export interface TableDescription {
   ArchivalSummary?: ArchivalSummary | undefined;
   TableClassSummary?: TableClassSummary | undefined;
   DeletionProtectionEnabled?: boolean | undefined;
+  DisassociationProtectionEnabled?: boolean | undefined;
   OnDemandThroughput?: OnDemandThroughput | undefined;
   WarmThroughput?: TableWarmThroughputDescription | undefined;
   MultiRegionConsistency?: MultiRegionConsistency | undefined;
@@ -710,6 +712,10 @@ export interface KinesisStreamingDestinationOutput {
   DestinationStatus?: DestinationStatus | undefined;
   EnableKinesisStreamingConfiguration?: EnableKinesisStreamingConfiguration | undefined;
 }
+export interface DisassociateReplicationGroupMemberAction {
+  RegionName: string | undefined;
+  DisassociationMode: DisassociationMode | undefined;
+}
 export interface GetResourcePolicyInput {
   ResourceArn: string | undefined;
 }
@@ -969,6 +975,7 @@ export interface ReplicationGroupUpdate {
   Create?: CreateReplicationGroupMemberAction | undefined;
   Update?: UpdateReplicationGroupMemberAction | undefined;
   Delete?: DeleteReplicationGroupMemberAction | undefined;
+  Disassociate?: DisassociateReplicationGroupMemberAction | undefined;
 }
 export interface VectorIndexUpdate {
   Create?: CreateVectorIndexAction | undefined;
@@ -990,6 +997,7 @@ export interface UpdateTableInput {
   OnDemandThroughput?: OnDemandThroughput | undefined;
   WarmThroughput?: WarmThroughput | undefined;
   GlobalTableSettingsReplicationMode?: GlobalTableSettingsReplicationMode | undefined;
+  DisassociationProtectionEnabled?: boolean | undefined;
   VectorIndexUpdates?: VectorIndexUpdate[] | undefined;
 }
 export interface UpdateTableOutput {

package/dist-types/ts3.4/schemas/schemas_0.d.ts

@@ -124,6 +124,7 @@ export declare var DescribeTableReplicaAutoScalingInput$: StaticStructureSchema;
 export declare var DescribeTableReplicaAutoScalingOutput$: StaticStructureSchema;
 export declare var DescribeTimeToLiveInput$: StaticStructureSchema;
 export declare var DescribeTimeToLiveOutput$: StaticStructureSchema;
+export declare var DisassociateReplicationGroupMemberAction$: StaticStructureSchema;
 export declare var EnableKinesisStreamingConfiguration$: StaticStructureSchema;
 export declare var Endpoint$: StaticStructureSchema;
 export declare var ExecuteStatementInput$: StaticStructureSchema;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-sdk/client-dynamodb",
-  "version": "3.1153.0",
+  "version": "3.1155.0",
   "description": "AWS SDK for JavaScript Dynamodb Client for Node.js, Browser and React Native",
   "homepage": "https://github.com/aws/aws-sdk-js-v3/tree/main/clients/client-dynamodb",
   "license": "Apache-2.0",
@@ -52,12 +52,12 @@
     "test:index": "tsc -p tsconfig.test.json && node ./test/index-objects.spec.mjs"
   },
   "dependencies": {
-    "@aws-sdk/core": "^3.978.4",
-    "@aws-sdk/credential-provider-node": "^3.972.87",
-    "@aws-sdk/dynamodb-codec": "^3.973.49",
-    "@aws-sdk/middleware-endpoint-discovery": "^3.972.33",
-    "@aws-sdk/types": "^3.974.6",
-    "@smithy/core": "^3.36.0",
+    "@aws-sdk/core": "^3.978.5",
+    "@aws-sdk/credential-provider-node": "^3.972.88",
+    "@aws-sdk/dynamodb-codec": "^3.973.50",
+    "@aws-sdk/middleware-endpoint-discovery": "^3.972.34",
+    "@aws-sdk/types": "^3.975.0",
+    "@smithy/core": "^3.36.1",
     "@smithy/fetch-http-handler": "^5.8.0",
     "@smithy/node-http-handler": "^4.12.1",
     "@smithy/types": "^4.19.0",