Amazon DynamoDB Update: This change adds support for global tables with multi-Region strong consistency (in preview). The UpdateTable API now supports a new attribute MultiRegionConsistency to set consistency when creating global tables. The DescribeTable output now optionally includes the MultiRegionConsistency attribute.

AWS · AWS · commit 95a22760cfd6 · 2024-12-03T19:08:09.000Z
diff --git a/.changes/next-release/feature-AmazonDynamoDB-5823bca.json b/.changes/next-release/feature-AmazonDynamoDB-5823bca.json
@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon DynamoDB",
+    "contributor": "",
+    "description": "This change adds support for global tables with multi-Region strong consistency (in preview). The UpdateTable API now supports a new attribute MultiRegionConsistency to set consistency when creating global tables. The DescribeTable output now optionally includes the MultiRegionConsistency attribute."
+}
diff --git a/services/dynamodb/src/main/resources/codegen-resources/dynamodb/endpoint-rule-set.json b/services/dynamodb/src/main/resources/codegen-resources/dynamodb/endpoint-rule-set.json
@@ -170,9 +170,9 @@
                                         "properties": {
                                             "authSchemes": [
                                                 {
-                                                    "name": "sigv4",
+                                                    "signingRegion": "us-east-1",
                                                     "signingName": "dynamodb",
-                                                    "signingRegion": "us-east-1"
+                                                    "name": "sigv4"
                                                 }
                                             ]
                                         },
diff --git a/services/dynamodb/src/main/resources/codegen-resources/dynamodb/service-2.json b/services/dynamodb/src/main/resources/codegen-resources/dynamodb/service-2.json
@@ -154,7 +154,8 @@
         {"shape":"ItemCollectionSizeLimitExceededException"},
         {"shape":"TransactionConflictException"},
         {"shape":"RequestLimitExceeded"},
-        {"shape":"InternalServerError"}
+        {"shape":"InternalServerError"},
+        {"shape":"ReplicatedWriteConflictException"}
       ],
       "documentation":"<p>Deletes a single item in a table by primary key. You can perform a conditional delete operation that deletes the item if it exists, or if it has an expected attribute value.</p> <p>In addition to deleting an item, you can also return the item's attribute values in the same operation, using the <code>ReturnValues</code> parameter.</p> <p>Unless you specify conditions, the <code>DeleteItem</code> is an idempotent operation; running it multiple times on the same item or attribute does <i>not</i> result in an error response.</p> <p>Conditional deletes are useful for deleting items only if specific conditions are met. If those conditions are met, DynamoDB performs the delete. Otherwise, the item is not deleted.</p>",
       "endpointdiscovery":{
@@ -651,7 +652,8 @@
         {"shape":"ItemCollectionSizeLimitExceededException"},
         {"shape":"TransactionConflictException"},
         {"shape":"RequestLimitExceeded"},
-        {"shape":"InternalServerError"}
+        {"shape":"InternalServerError"},
+        {"shape":"ReplicatedWriteConflictException"}
       ],
       "documentation":"<p>Creates a new item, or replaces an old item with a new item. If an item that has the same primary key as the new item already exists in the specified table, the new item completely replaces the existing item. You can perform a conditional put operation (add a new item if one with the specified primary key doesn't exist), or replace an existing item if it has certain attribute values. You can return the item's attribute values in the same operation, using the <code>ReturnValues</code> parameter.</p> <p>When you add an item, the primary key attributes are the only required attributes. </p> <p>Empty String and Binary attribute values are allowed. Attribute values of type String and Binary must have a length greater than zero if the attribute is used as a key attribute for a table or index. Set type attributes cannot be empty. </p> <p>Invalid Requests with empty values will be rejected with a <code>ValidationException</code> exception.</p> <note> <p>To prevent a new item from replacing an existing item, use a conditional expression that contains the <code>attribute_not_exists</code> function with the name of the attribute being used as the partition key for the table. Since every record must contain that attribute, the <code>attribute_not_exists</code> function will only succeed if no matching item exists.</p> </note> <p>For more information about <code>PutItem</code>, see <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html\">Working with Items</a> in the <i>Amazon DynamoDB Developer Guide</i>.</p>",
       "endpointdiscovery":{
@@ -912,7 +914,8 @@
         {"shape":"ItemCollectionSizeLimitExceededException"},
         {"shape":"TransactionConflictException"},
         {"shape":"RequestLimitExceeded"},
-        {"shape":"InternalServerError"}
+        {"shape":"InternalServerError"},
+        {"shape":"ReplicatedWriteConflictException"}
       ],
       "documentation":"<p>Edits an existing item's attributes, or adds a new item to the table if it does not already exist. You can put, delete, or add attribute values. You can also perform a conditional update on an existing item (insert a new attribute name-value pair if it doesn't exist, or replace an existing name-value pair if it has certain expected attribute values).</p> <p>You can also return the item's attribute values in the same <code>UpdateItem</code> operation using the <code>ReturnValues</code> parameter.</p>",
       "endpointdiscovery":{
@@ -4343,6 +4346,13 @@
       "key":{"shape":"AttributeName"},
       "value":{"shape":"AttributeValue"}
     },
+    "MultiRegionConsistency":{
+      "type":"string",
+      "enum":[
+        "EVENTUAL",
+        "STRONG"
+      ]
+    },
     "NextTokenString":{"type":"string"},
     "NonKeyAttributeName":{
       "type":"string",
@@ -5228,6 +5238,14 @@
       "type":"list",
       "member":{"shape":"ReplicaUpdate"}
     },
+    "ReplicatedWriteConflictException":{
+      "type":"structure",
+      "members":{
+        "message":{"shape":"ErrorMessage"}
+      },
+      "documentation":"<p>The request was rejected because one or more items in the request are being modified by a request in another Region. </p>",
+      "exception":true
+    },
     "ReplicationGroupUpdate":{
       "type":"structure",
       "members":{
@@ -5979,6 +5997,10 @@
         "WarmThroughput":{
           "shape":"TableWarmThroughputDescription",
           "documentation":"<p>Describes the warm throughput value of the base table.</p>"
+        },
+        "MultiRegionConsistency":{
+          "shape":"MultiRegionConsistency",
+          "documentation":"<p>Indicates one of the following consistency modes for a global table:</p> <ul> <li> <p> <code>EVENTUAL</code>: Indicates that the global table is configured for multi-Region eventual consistency.</p> </li> <li> <p> <code>STRONG</code>: Indicates that the global table is configured for multi-Region strong consistency (preview).</p> <note> <p>Multi-Region strong consistency (MRSC) is a new DynamoDB global tables capability currently available in preview mode. For more information, see <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PreviewFeatures.html#multi-region-strong-consistency-gt\">Global tables multi-Region strong consistency</a>.</p> </note> </li> </ul> <p>If you don't specify this field, the global table consistency mode defaults to <code>EVENTUAL</code>.</p>"
         }
       },
       "documentation":"<p>Represents the properties of a table.</p>"
@@ -6695,6 +6717,10 @@
           "shape":"DeletionProtectionEnabled",
           "documentation":"<p>Indicates whether deletion protection is to be enabled (true) or disabled (false) on the table.</p>"
         },
+        "MultiRegionConsistency":{
+          "shape":"MultiRegionConsistency",
+          "documentation":"<p>Specifies the consistency mode for a new global table. This parameter is only valid when you create a global table by specifying one or more <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ReplicationGroupUpdate.html#DDB-Type-ReplicationGroupUpdate-Create\">Create</a> actions in the <a href=\"https://docs.aws.amazon.com/https:/docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html#DDB-UpdateTable-request-ReplicaUpdates\">ReplicaUpdates</a> action list.</p> <p>You can specify one of the following consistency modes:</p> <ul> <li> <p> <code>EVENTUAL</code>: Configures a new global table for multi-Region eventual consistency. This is the default consistency mode for global tables.</p> </li> <li> <p> <code>STRONG</code>: Configures a new global table for multi-Region strong consistency (preview).</p> <note> <p>Multi-Region strong consistency (MRSC) is a new DynamoDB global tables capability currently available in preview mode. For more information, see <a href=\"https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PreviewFeatures.html#multi-region-strong-consistency-gt\">Global tables multi-Region strong consistency</a>.</p> </note> </li> </ul> <p>If you don't specify this parameter, the global table consistency mode defaults to <code>EVENTUAL</code>.</p>"
+        },
         "OnDemandThroughput":{
           "shape":"OnDemandThroughput",
           "documentation":"<p>Updates the maximum number of read and write units for the specified table in on-demand capacity mode. If you use this parameter, you must specify <code>MaxReadRequestUnits</code>, <code>MaxWriteRequestUnits</code>, or both.</p>"

Original file line number	Diff line number	Diff line change
`@@ -170,9 +170,9 @@`
`170`	`170`	`"properties": {`
`171`	`171`	`"authSchemes": [`
`172`	`172`	`{`
`173`		`- "name": "sigv4",`
	`173`	`+ "signingRegion": "us-east-1",`
`174`	`174`	`"signingName": "dynamodb",`
`175`		`- "signingRegion": "us-east-1"`
	`175`	`+ "name": "sigv4"`
`176`	`176`	`}`
`177`	`177`	`]`
`178`	`178`	`},`