aws-cdk-lib 2.153.0__py3-none-any.whl → 2.154.1__py3-none-any.whl

aws_cdk/aws_dynamodb/__init__.py

@@ -140,6 +140,7 @@ Note: You can create an instance of the `TableV2` construct with as many `replic
 The `TableV2` construct can be configured with on-demand or provisioned billing:
 
 * On-demand - The default option. This is a flexible billing option capable of serving requests without capacity planning. The billing mode will be `PAY_PER_REQUEST`.
+* You can optionally specify the `maxReadRequestUnits` or `maxWriteRequestUnits` on individual tables and associated global secondary indexes (GSIs). When you configure maximum throughput for an on-demand table, throughput requests that exceed the maximum amount specified will be throttled.
 * Provisioned - Specify the `readCapacity` and `writeCapacity` that you need for your application. The billing mode will be `PROVISIONED`. Capacity can be configured using one of the following modes:
 
   * Fixed - provisioned throughput capacity is configured with a fixed number of I/O operations per second.
@@ -156,6 +157,18 @@ table = dynamodb.TableV2(self, "Table",
 )
 ```
 
+The following example shows how to configure `TableV2` with on-demand billing with optional maximum throughput configured:
+
+```python
+table = dynamodb.TableV2(self, "Table",
+    partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
+    billing=dynamodb.Billing.on_demand(
+        max_read_request_units=100,
+        max_write_request_units=115
+    )
+)
+```
+
 When using provisioned billing, you must also specify `readCapacity` and `writeCapacity`. You can choose to configure `readCapacity` with fixed capacity or autoscaled capacity, but `writeCapacity` can only be configured with autoscaled capacity. The following example shows how to configure `TableV2` with provisioned billing:
 
 ```python
@@ -1195,12 +1208,25 @@ class Billing(
 
     @jsii.member(jsii_name="onDemand")
     @builtins.classmethod
-    def on_demand(cls) -> "Billing":
+    def on_demand(
+        cls,
+        *,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
+    ) -> "Billing":
         '''Flexible billing option capable of serving requests without capacity planning.
 
         Note: Billing mode will be PAY_PER_REQUEST.
+
+        :param max_read_request_units: The max read request units. Default: - if table mode is on-demand and this property is undefined, no maximum throughput limit will be put in place for read requests. This property is only applicable for tables using on-demand mode.
+        :param max_write_request_units: The max write request units. Default: - if table mode is on-demand and this property is undefined, no maximum throughput limit will be put in place for write requests. This property is only applicable for tables using on-demand mode.
         '''
-        return typing.cast("Billing", jsii.sinvoke(cls, "onDemand", []))
+        props = MaxThroughputProps(
+            max_read_request_units=max_read_request_units,
+            max_write_request_units=max_write_request_units,
+        )
+
+        return typing.cast("Billing", jsii.sinvoke(cls, "onDemand", [props]))
 
     @jsii.member(jsii_name="provisioned")
     @builtins.classmethod
@@ -1734,7 +1760,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__f732bb8272361b5800f36f0c389121597f9a72868d0f90932b3744684600e75e)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "attributeDefinitions", value)
+        jsii.set(self, "attributeDefinitions", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="keySchema")
@@ -1752,7 +1778,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__6ef890475efd870bf55df50bbfa6efc88da22eca84273a283f67749593f5b884)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "keySchema", value)
+        jsii.set(self, "keySchema", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="replicas")
@@ -1770,7 +1796,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a097f89adcd67d171d1cf0c2f82a8189f354dac15e39c6b6cc82e65b8e315806)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "replicas", value)
+        jsii.set(self, "replicas", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="billingMode")
@@ -1786,7 +1812,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b7a91e461bd5e49ff4dc2350ae1ceae8597a286d7e21db96c7ec976ba3537e3c)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "billingMode", value)
+        jsii.set(self, "billingMode", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="globalSecondaryIndexes")
@@ -1804,7 +1830,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__484436e7e1867a9d477f3fa0bdee0dfdfb2646ba7497c71d398076d9872d332b)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "globalSecondaryIndexes", value)
+        jsii.set(self, "globalSecondaryIndexes", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="localSecondaryIndexes")
@@ -1822,7 +1848,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a0b3191b7117186bc41f62e22fff4e4f50d0835a5f174dde9b2b8188ceee5162)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "localSecondaryIndexes", value)
+        jsii.set(self, "localSecondaryIndexes", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="sseSpecification")
@@ -1840,7 +1866,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ccb739aac1de1ded207a80b782298c972ccf113dd96de224fea60f9ce1b43833)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "sseSpecification", value)
+        jsii.set(self, "sseSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="streamSpecification")
@@ -1858,7 +1884,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0b312fc3bf6b9413081bae5b2557691650d4bf70fd047bf867dd8ce608971cd7)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "streamSpecification", value)
+        jsii.set(self, "streamSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="tableName")
@@ -1871,7 +1897,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__db38617fc8b7b8f4ed3d8858186d464cb90a597e2acb75a0d09d8fecadfb89b6)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "tableName", value)
+        jsii.set(self, "tableName", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="timeToLiveSpecification")
@@ -1889,7 +1915,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__0b2a71693eba1f1adfbaa4a2d1968a10f7e914f3714a169453fb5831d2b159f7)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "timeToLiveSpecification", value)
+        jsii.set(self, "timeToLiveSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="writeOnDemandThroughputSettings")
@@ -1907,7 +1933,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e9e1941bc70970aa12bf29b98d00fed94dd701aea1acb0d4280e0f96ab3ca8bc)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "writeOnDemandThroughputSettings", value)
+        jsii.set(self, "writeOnDemandThroughputSettings", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="writeProvisionedThroughputSettings")
@@ -1925,7 +1951,7 @@ class CfnGlobalTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__575a6fcd8e2e451f04b5c40c3e6da53aad798e3089f98afaa25d709c7d291a10)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "writeProvisionedThroughputSettings", value)
+        jsii.set(self, "writeProvisionedThroughputSettings", value) # pyright: ignore[reportArgumentType]
 
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_dynamodb.CfnGlobalTable.AttributeDefinitionProperty",
@@ -4835,7 +4861,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b23ffa0600490aa85e7d7d78bfa21eab76ec61e446848fa311842ae651fa9836)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "keySchema", value)
+        jsii.set(self, "keySchema", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="attributeDefinitions")
@@ -4853,7 +4879,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__5daf5ddc396c2de639d9ab720b24bd4802cb6b1935c3acaabde5b29c25732fd7)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "attributeDefinitions", value)
+        jsii.set(self, "attributeDefinitions", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="billingMode")
@@ -4866,7 +4892,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__859e18c7e0169484ae1438c12328e5f08e77b8ce32d6fc9d190d1d453358f8b8)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "billingMode", value)
+        jsii.set(self, "billingMode", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="contributorInsightsSpecification")
@@ -4884,7 +4910,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4418562f8958ca4e57cc994ee87a0b27423f94d0f99284b5f04311b9e61b238f)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "contributorInsightsSpecification", value)
+        jsii.set(self, "contributorInsightsSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="deletionProtectionEnabled")
@@ -4902,7 +4928,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__d91900a3abfeb455a4849c52c7f1d034e09b1b0ceb4a50b598d8c938f15c012b)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "deletionProtectionEnabled", value)
+        jsii.set(self, "deletionProtectionEnabled", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="globalSecondaryIndexes")
@@ -4923,7 +4949,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__97df696d6ba063acb98f58f09adb6516d0fc1d41d4d4a37c39f7ffac09e0d5cd)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "globalSecondaryIndexes", value)
+        jsii.set(self, "globalSecondaryIndexes", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="importSourceSpecification")
@@ -4941,7 +4967,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__61eb67e9e79c54ed8659ffe201d838bdf08b6b20da8fa03693734f4336da76c2)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "importSourceSpecification", value)
+        jsii.set(self, "importSourceSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="kinesisStreamSpecification")
@@ -4959,7 +4985,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__5d983fc83d1717d6aa76c247a0250e28278e9d16c940822fa16986ff229e9043)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "kinesisStreamSpecification", value)
+        jsii.set(self, "kinesisStreamSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="localSecondaryIndexes")
@@ -4977,7 +5003,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__45185c524451628b623abf4663f9427843c4d4a709a2cf82b14f8d2b3a9a7ffd)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "localSecondaryIndexes", value)
+        jsii.set(self, "localSecondaryIndexes", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="onDemandThroughput")
@@ -4995,7 +5021,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__510f5c7d4293f98a55434a588a20db69cf20ac7b409105b7335eb2699ba8c570)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "onDemandThroughput", value)
+        jsii.set(self, "onDemandThroughput", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="pointInTimeRecoverySpecification")
@@ -5013,7 +5039,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__06f7cca9d14af75b709b53e94a6fb51bba6dfa0cb31a23e0b70f506be9551e8d)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "pointInTimeRecoverySpecification", value)
+        jsii.set(self, "pointInTimeRecoverySpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="provisionedThroughput")
@@ -5031,7 +5057,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__6fa8ca064a9e23781245ca2f3d32d36a2324726abba76565a2e12ac5e399a599)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "provisionedThroughput", value)
+        jsii.set(self, "provisionedThroughput", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="resourcePolicy")
@@ -5049,7 +5075,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4166d9b0a925b24598927de15ecb1935d22d14f9a49469ba893db8d18421bf02)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourcePolicy", value)
+        jsii.set(self, "resourcePolicy", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="sseSpecification")
@@ -5067,7 +5093,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__bc5e50032964d91e0cf5ec36aba75b6ae325bfe6129ad9f55764353e645b28c6)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "sseSpecification", value)
+        jsii.set(self, "sseSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="streamSpecification")
@@ -5085,7 +5111,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c4ba4ef955ba0e9ac6474c62ea545a637752c92fffc5fe0868d55987f8b593ba)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "streamSpecification", value)
+        jsii.set(self, "streamSpecification", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="tableClass")
@@ -5098,7 +5124,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__df6efdc84208b4dd6d9307c0da182d301e83373407c8e72b4e33094a16f0e9ee)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "tableClass", value)
+        jsii.set(self, "tableClass", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="tableName")
@@ -5111,7 +5137,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b9a680d2bfdc5e6712f2c0338c7388d0ee2bbf8560c324a2398466ed5efe5e1b)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "tableName", value)
+        jsii.set(self, "tableName", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="tagsRaw")
@@ -5124,7 +5150,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ae8c7d0ef496e4ff46af1a1db46d7b3840fc5e44d90dd5539a886f2d9ef19658)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "tagsRaw", value)
+        jsii.set(self, "tagsRaw", value) # pyright: ignore[reportArgumentType]
 
     @builtins.property
     @jsii.member(jsii_name="timeToLiveSpecification")
@@ -5142,7 +5168,7 @@ class CfnTable(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__13f09e3b5bed84728f44ababaa84b1754ef531ec7fc1a8800692ac3ee9bba9a0)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "timeToLiveSpecification", value)
+        jsii.set(self, "timeToLiveSpecification", value) # pyright: ignore[reportArgumentType]
 
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_dynamodb.CfnTable.AttributeDefinitionProperty",
@@ -8723,6 +8749,86 @@ class _InputFormatProxy(InputFormat):
 typing.cast(typing.Any, InputFormat).__jsii_proxy_class__ = lambda : _InputFormatProxy
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_dynamodb.MaxThroughputProps",
+    jsii_struct_bases=[],
+    name_mapping={
+        "max_read_request_units": "maxReadRequestUnits",
+        "max_write_request_units": "maxWriteRequestUnits",
+    },
+)
+class MaxThroughputProps:
+    def __init__(
+        self,
+        *,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
+    ) -> None:
+        '''Properties used to configure maximum throughput for an on-demand table.
+
+        :param max_read_request_units: The max read request units. Default: - if table mode is on-demand and this property is undefined, no maximum throughput limit will be put in place for read requests. This property is only applicable for tables using on-demand mode.
+        :param max_write_request_units: The max write request units. Default: - if table mode is on-demand and this property is undefined, no maximum throughput limit will be put in place for write requests. This property is only applicable for tables using on-demand mode.
+
+        :exampleMetadata: infused
+
+        Example::
+
+            table = dynamodb.TableV2(self, "Table",
+                partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
+                billing=dynamodb.Billing.on_demand(
+                    max_read_request_units=100,
+                    max_write_request_units=115
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__be7ea0183d8be6420b32efcd6b8d4ab24e05bd813b7c0abb65a713b53d61464f)
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
+            check_type(argname="argument max_write_request_units", value=max_write_request_units, expected_type=type_hints["max_write_request_units"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
+        if max_write_request_units is not None:
+            self._values["max_write_request_units"] = max_write_request_units
+
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The max read request units.
+
+        :default:
+
+        - if table mode is on-demand and this property is undefined,
+        no maximum throughput limit will be put in place for read requests.
+        This property is only applicable for tables using on-demand mode.
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def max_write_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The max write request units.
+
+        :default:
+
+        - if table mode is on-demand and this property is undefined,
+        no maximum throughput limit will be put in place for write requests.
+        This property is only applicable for tables using on-demand mode.
+        '''
+        result = self._values.get("max_write_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "MaxThroughputProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.enum(jsii_type="aws-cdk-lib.aws_dynamodb.Operation")
 class Operation(enum.Enum):
     '''Supported DynamoDB table operations.'''
@@ -8781,6 +8887,7 @@ class ProjectionType(enum.Enum):
     jsii_struct_bases=[],
     name_mapping={
         "contributor_insights": "contributorInsights",
+        "max_read_request_units": "maxReadRequestUnits",
         "read_capacity": "readCapacity",
     },
 )
@@ -8789,11 +8896,13 @@ class ReplicaGlobalSecondaryIndexOptions:
         self,
         *,
         contributor_insights: typing.Optional[builtins.bool] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[Capacity] = None,
     ) -> None:
         '''Options used to configure global secondary indexes on a replica table.
 
         :param contributor_insights: Whether CloudWatch contributor insights is enabled for a specific global secondary index on a replica table. Default: - inherited from the primary table
+        :param max_read_request_units: The maximum read request units for a specific global secondary index on a replica table. Note: This can only be configured if primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table
         :param read_capacity: The read capacity for a specific global secondary index on a replica table. Note: This can only be configured if primary table billing is provisioned. Default: - inherited from the primary table
 
         :exampleMetadata: infused
@@ -8845,10 +8954,13 @@ class ReplicaGlobalSecondaryIndexOptions:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__eaa3a170e1978a5997011b8319bcd83bf34642dac50e342aad0705ee28b15714)
             check_type(argname="argument contributor_insights", value=contributor_insights, expected_type=type_hints["contributor_insights"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if contributor_insights is not None:
             self._values["contributor_insights"] = contributor_insights
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
 
@@ -8861,6 +8973,17 @@ class ReplicaGlobalSecondaryIndexOptions:
         result = self._values.get("contributor_insights")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum read request units for a specific global secondary index on a replica table.
+
+        Note: This can only be configured if primary table billing is PAY_PER_REQUEST.
+
+        :default: - inherited from the primary table
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[Capacity]:
         '''The read capacity for a specific global secondary index on a replica table.
@@ -10439,7 +10562,7 @@ class _TableBaseProxy(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__385df27fafa61fd6d1e8ebb872e4af26b3119795ee6bb9684e56f891cd86ba94)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourcePolicy", value)
+        jsii.set(self, "resourcePolicy", value) # pyright: ignore[reportArgumentType]
 
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the abstract class
 typing.cast(typing.Any, TableBase).__jsii_proxy_class__ = lambda : _TableBaseProxy
@@ -11241,7 +11364,7 @@ class _TableBaseV2Proxy(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__cb944fe3dd5a924cda3570a3226b526ff95d46099b3de4b4ab2a005c34091870)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourcePolicy", value)
+        jsii.set(self, "resourcePolicy", value) # pyright: ignore[reportArgumentType]
 
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the abstract class
 typing.cast(typing.Any, TableBaseV2).__jsii_proxy_class__ = lambda : _TableBaseV2Proxy
@@ -11390,6 +11513,8 @@ typing.cast(typing.Any, TableEncryptionV2).__jsii_proxy_class__ = lambda : _Tabl
         "encryption": "encryption",
         "encryption_key": "encryptionKey",
         "import_source": "importSource",
+        "max_read_request_units": "maxReadRequestUnits",
+        "max_write_request_units": "maxWriteRequestUnits",
         "point_in_time_recovery": "pointInTimeRecovery",
         "read_capacity": "readCapacity",
         "removal_policy": "removalPolicy",
@@ -11415,6 +11540,8 @@ class TableOptions(SchemaOptions):
         encryption: typing.Optional[TableEncryption] = None,
         encryption_key: typing.Optional[_IKey_5f11635f] = None,
         import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
@@ -11439,6 +11566,8 @@ class TableOptions(SchemaOptions):
         :param encryption: Whether server-side encryption with an AWS managed customer master key is enabled. This property cannot be set if ``serverSideEncryption`` is set. .. epigraph:: **NOTE**: if you set this to ``CUSTOMER_MANAGED`` and ``encryptionKey`` is not specified, the key that the Tablet generates for you will be created with default permissions. If you are using CDKv2, these permissions will be sufficient to enable the key for use with DynamoDB tables. If you are using CDKv1, make sure the feature flag ``@aws-cdk/aws-kms:defaultKeyPolicies`` is set to ``true`` in your ``cdk.json``. Default: - The table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param encryption_key: External KMS key to use for table encryption. This property can only be set if ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED``. Default: - If ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED`` and this property is undefined, a new KMS key will be created and associated with this table. If ``encryption`` and this property are both undefined, then the table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param import_source: The properties of data being imported from the S3 bucket source to the table. Default: - no data import from the S3 bucket
+        :param max_read_request_units: The maximum read request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
+        :param max_write_request_units: The write request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
         :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: - point-in-time recovery is disabled
         :param read_capacity: The read capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table's provisioned throughput. Can only be provided if billingMode is Provisioned. Default: 5
         :param removal_policy: The removal policy to apply to the DynamoDB Table. Default: RemovalPolicy.RETAIN
@@ -11489,6 +11618,8 @@ class TableOptions(SchemaOptions):
                     compression_type=dynamodb.InputCompressionType.GZIP,
                     key_prefix="keyPrefix"
                 ),
+                max_read_request_units=123,
+                max_write_request_units=123,
                 point_in_time_recovery=False,
                 read_capacity=123,
                 removal_policy=cdk.RemovalPolicy.DESTROY,
@@ -11522,6 +11653,8 @@ class TableOptions(SchemaOptions):
             check_type(argname="argument encryption", value=encryption, expected_type=type_hints["encryption"])
             check_type(argname="argument encryption_key", value=encryption_key, expected_type=type_hints["encryption_key"])
             check_type(argname="argument import_source", value=import_source, expected_type=type_hints["import_source"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
+            check_type(argname="argument max_write_request_units", value=max_write_request_units, expected_type=type_hints["max_write_request_units"])
             check_type(argname="argument point_in_time_recovery", value=point_in_time_recovery, expected_type=type_hints["point_in_time_recovery"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
             check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
@@ -11550,6 +11683,10 @@ class TableOptions(SchemaOptions):
             self._values["encryption_key"] = encryption_key
         if import_source is not None:
             self._values["import_source"] = import_source
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
+        if max_write_request_units is not None:
+            self._values["max_write_request_units"] = max_write_request_units
         if point_in_time_recovery is not None:
             self._values["point_in_time_recovery"] = point_in_time_recovery
         if read_capacity is not None:
@@ -11660,6 +11797,34 @@ class TableOptions(SchemaOptions):
         result = self._values.get("import_source")
         return typing.cast(typing.Optional[ImportSourceSpecification], result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum read request units for the table.
+
+        Careful if you add Global Secondary Indexes, as
+        those will share the table's maximum on-demand throughput.
+
+        Can only be provided if billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def max_write_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The write request units for the table.
+
+        Careful if you add Global Secondary Indexes, as
+        those will share the table's maximum on-demand throughput.
+
+        Can only be provided if billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_write_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
         '''Whether point-in-time recovery is enabled.
@@ -11976,6 +12141,8 @@ class TableOptionsV2:
         "encryption": "encryption",
         "encryption_key": "encryptionKey",
         "import_source": "importSource",
+        "max_read_request_units": "maxReadRequestUnits",
+        "max_write_request_units": "maxWriteRequestUnits",
         "point_in_time_recovery": "pointInTimeRecovery",
         "read_capacity": "readCapacity",
         "removal_policy": "removalPolicy",
@@ -12003,6 +12170,8 @@ class TableProps(TableOptions):
         encryption: typing.Optional[TableEncryption] = None,
         encryption_key: typing.Optional[_IKey_5f11635f] = None,
         import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
@@ -12027,6 +12196,8 @@ class TableProps(TableOptions):
         :param encryption: Whether server-side encryption with an AWS managed customer master key is enabled. This property cannot be set if ``serverSideEncryption`` is set. .. epigraph:: **NOTE**: if you set this to ``CUSTOMER_MANAGED`` and ``encryptionKey`` is not specified, the key that the Tablet generates for you will be created with default permissions. If you are using CDKv2, these permissions will be sufficient to enable the key for use with DynamoDB tables. If you are using CDKv1, make sure the feature flag ``@aws-cdk/aws-kms:defaultKeyPolicies`` is set to ``true`` in your ``cdk.json``. Default: - The table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param encryption_key: External KMS key to use for table encryption. This property can only be set if ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED``. Default: - If ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED`` and this property is undefined, a new KMS key will be created and associated with this table. If ``encryption`` and this property are both undefined, then the table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param import_source: The properties of data being imported from the S3 bucket source to the table. Default: - no data import from the S3 bucket
+        :param max_read_request_units: The maximum read request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
+        :param max_write_request_units: The write request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
         :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: - point-in-time recovery is disabled
         :param read_capacity: The read capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table's provisioned throughput. Can only be provided if billingMode is Provisioned. Default: 5
         :param removal_policy: The removal policy to apply to the DynamoDB Table. Default: RemovalPolicy.RETAIN
@@ -12083,6 +12254,8 @@ class TableProps(TableOptions):
             check_type(argname="argument encryption", value=encryption, expected_type=type_hints["encryption"])
             check_type(argname="argument encryption_key", value=encryption_key, expected_type=type_hints["encryption_key"])
             check_type(argname="argument import_source", value=import_source, expected_type=type_hints["import_source"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
+            check_type(argname="argument max_write_request_units", value=max_write_request_units, expected_type=type_hints["max_write_request_units"])
             check_type(argname="argument point_in_time_recovery", value=point_in_time_recovery, expected_type=type_hints["point_in_time_recovery"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
             check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
@@ -12113,6 +12286,10 @@ class TableProps(TableOptions):
             self._values["encryption_key"] = encryption_key
         if import_source is not None:
             self._values["import_source"] = import_source
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
+        if max_write_request_units is not None:
+            self._values["max_write_request_units"] = max_write_request_units
         if point_in_time_recovery is not None:
             self._values["point_in_time_recovery"] = point_in_time_recovery
         if read_capacity is not None:
@@ -12227,6 +12404,34 @@ class TableProps(TableOptions):
         result = self._values.get("import_source")
         return typing.cast(typing.Optional[ImportSourceSpecification], result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum read request units for the table.
+
+        Careful if you add Global Secondary Indexes, as
+        those will share the table's maximum on-demand throughput.
+
+        Can only be provided if billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def max_write_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The write request units for the table.
+
+        Careful if you add Global Secondary Indexes, as
+        those will share the table's maximum on-demand throughput.
+
+        Can only be provided if billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_write_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
         '''Whether point-in-time recovery is enabled.
@@ -12916,6 +13121,8 @@ class TableV2(
         self,
         *,
         partition_key: typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]],
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[Capacity] = None,
         sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[Capacity] = None,
@@ -12928,6 +13135,8 @@ class TableV2(
         Note: Global secondary indexes will be inherited by all replica tables.
 
         :param partition_key: Partition key attribute definition.
+        :param max_read_request_units: The maximum read request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table.
+        :param max_write_request_units: The maximum write request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table.
         :param read_capacity: The read capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table.
         :param sort_key: Sort key attribute definition. Default: - no sort key
         :param write_capacity: The write capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table.
@@ -12937,6 +13146,8 @@ class TableV2(
         '''
         props = GlobalSecondaryIndexPropsV2(
             partition_key=partition_key,
+            max_read_request_units=max_read_request_units,
+            max_write_request_units=max_write_request_units,
             read_capacity=read_capacity,
             sort_key=sort_key,
             write_capacity=write_capacity,
@@ -12980,6 +13191,7 @@ class TableV2(
         *,
         region: builtins.str,
         global_secondary_index_options: typing.Optional[typing.Mapping[builtins.str, typing.Union[ReplicaGlobalSecondaryIndexOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[Capacity] = None,
         contributor_insights: typing.Optional[builtins.bool] = None,
         deletion_protection: typing.Optional[builtins.bool] = None,
@@ -12995,6 +13207,7 @@ class TableV2(
 
         :param region: The region that the replica table will be created in.
         :param global_secondary_index_options: Options used to configure global secondary index properties. Default: - inherited from the primary table
+        :param max_read_request_units: The maxium read request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table
         :param read_capacity: The read capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table
         :param contributor_insights: Whether CloudWatch contributor insights is enabled. Default: false
         :param deletion_protection: Whether deletion protection is enabled. Default: false
@@ -13007,6 +13220,7 @@ class TableV2(
         props = ReplicaTableProps(
             region=region,
             global_secondary_index_options=global_secondary_index_options,
+            max_read_request_units=max_read_request_units,
             read_capacity=read_capacity,
             contributor_insights=contributor_insights,
             deletion_protection=deletion_protection,
@@ -13098,7 +13312,7 @@ class TableV2(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7c681fc6a08524e2909b1c97c77ad38edec11b1f8bd3f666a073a61c09638e19)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourcePolicy", value)
+        jsii.set(self, "resourcePolicy", value) # pyright: ignore[reportArgumentType]
 
 
 @jsii.data_type(
@@ -13321,6 +13535,8 @@ class UtilizationScalingProps(_BaseTargetTrackingProps_540ba713):
         "projection_type": "projectionType",
         "partition_key": "partitionKey",
         "sort_key": "sortKey",
+        "max_read_request_units": "maxReadRequestUnits",
+        "max_write_request_units": "maxWriteRequestUnits",
         "read_capacity": "readCapacity",
         "write_capacity": "writeCapacity",
     },
@@ -13334,6 +13550,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         projection_type: typing.Optional[ProjectionType] = None,
         partition_key: typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]],
         sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
     ) -> None:
@@ -13344,6 +13562,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         :param projection_type: The set of attributes that are projected into the secondary index. Default: ALL
         :param partition_key: Partition key attribute definition.
         :param sort_key: Sort key attribute definition. Default: no sort key
+        :param max_read_request_units: The maximum read request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
+        :param max_write_request_units: The maximum write request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
         :param read_capacity: The read capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
         :param write_capacity: The write capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
 
@@ -13363,6 +13583,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
                 ),
             
                 # the properties below are optional
+                max_read_request_units=123,
+                max_write_request_units=123,
                 non_key_attributes=["nonKeyAttributes"],
                 projection_type=dynamodb.ProjectionType.KEYS_ONLY,
                 read_capacity=123,
@@ -13384,6 +13606,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
             check_type(argname="argument projection_type", value=projection_type, expected_type=type_hints["projection_type"])
             check_type(argname="argument partition_key", value=partition_key, expected_type=type_hints["partition_key"])
             check_type(argname="argument sort_key", value=sort_key, expected_type=type_hints["sort_key"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
+            check_type(argname="argument max_write_request_units", value=max_write_request_units, expected_type=type_hints["max_write_request_units"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -13396,6 +13620,10 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
             self._values["projection_type"] = projection_type
         if sort_key is not None:
             self._values["sort_key"] = sort_key
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
+        if max_write_request_units is not None:
+            self._values["max_write_request_units"] = max_write_request_units
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
         if write_capacity is not None:
@@ -13442,6 +13670,28 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         result = self._values.get("sort_key")
         return typing.cast(typing.Optional[Attribute], result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum read request units for the global secondary index.
+
+        Can only be provided if table billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def max_write_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum write request units for the global secondary index.
+
+        Can only be provided if table billingMode is PAY_PER_REQUEST.
+
+        :default: - on-demand throughput is disabled
+        '''
+        result = self._values.get("max_write_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[jsii.Number]:
         '''The read capacity for the global secondary index.
@@ -13484,6 +13734,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         "non_key_attributes": "nonKeyAttributes",
         "projection_type": "projectionType",
         "partition_key": "partitionKey",
+        "max_read_request_units": "maxReadRequestUnits",
+        "max_write_request_units": "maxWriteRequestUnits",
         "read_capacity": "readCapacity",
         "sort_key": "sortKey",
         "write_capacity": "writeCapacity",
@@ -13497,6 +13749,8 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         non_key_attributes: typing.Optional[typing.Sequence[builtins.str]] = None,
         projection_type: typing.Optional[ProjectionType] = None,
         partition_key: typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]],
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[Capacity] = None,
         sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[Capacity] = None,
@@ -13507,6 +13761,8 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         :param non_key_attributes: The non-key attributes that are projected into the secondary index. Default: - No additional attributes
         :param projection_type: The set of attributes that are projected into the secondary index. Default: ALL
         :param partition_key: Partition key attribute definition.
+        :param max_read_request_units: The maximum read request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table.
+        :param max_write_request_units: The maximum write request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table.
         :param read_capacity: The read capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table.
         :param sort_key: Sort key attribute definition. Default: - no sort key
         :param write_capacity: The write capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table.
@@ -13539,6 +13795,8 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
             check_type(argname="argument non_key_attributes", value=non_key_attributes, expected_type=type_hints["non_key_attributes"])
             check_type(argname="argument projection_type", value=projection_type, expected_type=type_hints["projection_type"])
             check_type(argname="argument partition_key", value=partition_key, expected_type=type_hints["partition_key"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
+            check_type(argname="argument max_write_request_units", value=max_write_request_units, expected_type=type_hints["max_write_request_units"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
             check_type(argname="argument sort_key", value=sort_key, expected_type=type_hints["sort_key"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
@@ -13550,6 +13808,10 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
             self._values["non_key_attributes"] = non_key_attributes
         if projection_type is not None:
             self._values["projection_type"] = projection_type
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
+        if max_write_request_units is not None:
+            self._values["max_write_request_units"] = max_write_request_units
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
         if sort_key is not None:
@@ -13589,6 +13851,28 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         assert result is not None, "Required property 'partition_key' is missing"
         return typing.cast(Attribute, result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum read request units.
+
+        Note: This can only be configured if the primary table billing is PAY_PER_REQUEST.
+
+        :default: - inherited from the primary table.
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def max_write_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maximum write request units.
+
+        Note: This can only be configured if the primary table billing is PAY_PER_REQUEST.
+
+        :default: - inherited from the primary table.
+        '''
+        result = self._values.get("max_write_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[Capacity]:
         '''The read capacity.
@@ -13976,6 +14260,7 @@ class OperationsMetricOptions(SystemErrorsForOperationsMetricOptions):
         "tags": "tags",
         "region": "region",
         "global_secondary_index_options": "globalSecondaryIndexOptions",
+        "max_read_request_units": "maxReadRequestUnits",
         "read_capacity": "readCapacity",
     },
 )
@@ -13992,6 +14277,7 @@ class ReplicaTableProps(TableOptionsV2):
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         region: builtins.str,
         global_secondary_index_options: typing.Optional[typing.Mapping[builtins.str, typing.Union[ReplicaGlobalSecondaryIndexOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[Capacity] = None,
     ) -> None:
         '''Properties used to configure a replica table.
@@ -14005,6 +14291,7 @@ class ReplicaTableProps(TableOptionsV2):
         :param tags: Tags to be applied to the table or replica table. Default: - no tags
         :param region: The region that the replica table will be created in.
         :param global_secondary_index_options: Options used to configure global secondary index properties. Default: - inherited from the primary table
+        :param max_read_request_units: The maxium read request units. Note: This can only be configured if the primary table billing is PAY_PER_REQUEST. Default: - inherited from the primary table
         :param read_capacity: The read capacity. Note: This can only be configured if the primary table billing is provisioned. Default: - inherited from the primary table
 
         :exampleMetadata: infused
@@ -14035,6 +14322,7 @@ class ReplicaTableProps(TableOptionsV2):
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument global_secondary_index_options", value=global_secondary_index_options, expected_type=type_hints["global_secondary_index_options"])
+            check_type(argname="argument max_read_request_units", value=max_read_request_units, expected_type=type_hints["max_read_request_units"])
             check_type(argname="argument read_capacity", value=read_capacity, expected_type=type_hints["read_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "region": region,
@@ -14055,6 +14343,8 @@ class ReplicaTableProps(TableOptionsV2):
             self._values["tags"] = tags
         if global_secondary_index_options is not None:
             self._values["global_secondary_index_options"] = global_secondary_index_options
+        if max_read_request_units is not None:
+            self._values["max_read_request_units"] = max_read_request_units
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
 
@@ -14141,6 +14431,17 @@ class ReplicaTableProps(TableOptionsV2):
         result = self._values.get("global_secondary_index_options")
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, ReplicaGlobalSecondaryIndexOptions]], result)
 
+    @builtins.property
+    def max_read_request_units(self) -> typing.Optional[jsii.Number]:
+        '''The maxium read request units.
+
+        Note: This can only be configured if the primary table billing is PAY_PER_REQUEST.
+
+        :default: - inherited from the primary table
+        '''
+        result = self._values.get("max_read_request_units")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[Capacity]:
         '''The read capacity.
@@ -14211,6 +14512,8 @@ class Table(
         encryption: typing.Optional[TableEncryption] = None,
         encryption_key: typing.Optional[_IKey_5f11635f] = None,
         import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
@@ -14236,6 +14539,8 @@ class Table(
         :param encryption: Whether server-side encryption with an AWS managed customer master key is enabled. This property cannot be set if ``serverSideEncryption`` is set. .. epigraph:: **NOTE**: if you set this to ``CUSTOMER_MANAGED`` and ``encryptionKey`` is not specified, the key that the Tablet generates for you will be created with default permissions. If you are using CDKv2, these permissions will be sufficient to enable the key for use with DynamoDB tables. If you are using CDKv1, make sure the feature flag ``@aws-cdk/aws-kms:defaultKeyPolicies`` is set to ``true`` in your ``cdk.json``. Default: - The table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param encryption_key: External KMS key to use for table encryption. This property can only be set if ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED``. Default: - If ``encryption`` is set to ``TableEncryption.CUSTOMER_MANAGED`` and this property is undefined, a new KMS key will be created and associated with this table. If ``encryption`` and this property are both undefined, then the table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
         :param import_source: The properties of data being imported from the S3 bucket source to the table. Default: - no data import from the S3 bucket
+        :param max_read_request_units: The maximum read request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
+        :param max_write_request_units: The write request units for the table. Careful if you add Global Secondary Indexes, as those will share the table's maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
         :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: - point-in-time recovery is disabled
         :param read_capacity: The read capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table's provisioned throughput. Can only be provided if billingMode is Provisioned. Default: 5
         :param removal_policy: The removal policy to apply to the DynamoDB Table. Default: RemovalPolicy.RETAIN
@@ -14263,6 +14568,8 @@ class Table(
             encryption=encryption,
             encryption_key=encryption_key,
             import_source=import_source,
+            max_read_request_units=max_read_request_units,
+            max_write_request_units=max_write_request_units,
             point_in_time_recovery=point_in_time_recovery,
             read_capacity=read_capacity,
             removal_policy=removal_policy,
@@ -14369,6 +14676,8 @@ class Table(
     def add_global_secondary_index(
         self,
         *,
+        max_read_request_units: typing.Optional[jsii.Number] = None,
+        max_write_request_units: typing.Optional[jsii.Number] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
         index_name: builtins.str,
@@ -14379,6 +14688,8 @@ class Table(
     ) -> None:
         '''Add a global secondary index of table.
 
+        :param max_read_request_units: The maximum read request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
+        :param max_write_request_units: The maximum write request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
         :param read_capacity: The read capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
         :param write_capacity: The write capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
         :param index_name: The name of the secondary index.
@@ -14388,6 +14699,8 @@ class Table(
         :param sort_key: Sort key attribute definition. Default: no sort key
         '''
         props = GlobalSecondaryIndexProps(
+            max_read_request_units=max_read_request_units,
+            max_write_request_units=max_write_request_units,
             read_capacity=read_capacity,
             write_capacity=write_capacity,
             index_name=index_name,
@@ -14582,7 +14895,7 @@ class Table(
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b85333b9f4a3ca55431a35f4006c1aeb1fcd34f68dee45d5355498d8a1b77806)
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
-        jsii.set(self, "resourcePolicy", value)
+        jsii.set(self, "resourcePolicy", value) # pyright: ignore[reportArgumentType]
 
 
 __all__ = [
@@ -14608,6 +14921,7 @@ __all__ = [
     "InputCompressionType",
     "InputFormat",
     "LocalSecondaryIndexProps",
+    "MaxThroughputProps",
     "Operation",
     "OperationsMetricOptions",
     "ProjectionType",
@@ -15402,9 +15716,18 @@ def _typecheckingstub__085db855741db88e396eec35bbd4cd5d6e9c4cc7ae855a18cfe091ce2
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__be7ea0183d8be6420b32efcd6b8d4ab24e05bd813b7c0abb65a713b53d61464f(
+    *,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__eaa3a170e1978a5997011b8319bcd83bf34642dac50e342aad0705ee28b15714(
     *,
     contributor_insights: typing.Optional[builtins.bool] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
     read_capacity: typing.Optional[Capacity] = None,
 ) -> None:
     """Type checking stubs"""
@@ -15695,6 +16018,8 @@ def _typecheckingstub__dadf5733fac70178ab246582a0b777b8c203659229753a8396594d751
     encryption: typing.Optional[TableEncryption] = None,
     encryption_key: typing.Optional[_IKey_5f11635f] = None,
     import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
@@ -15733,6 +16058,8 @@ def _typecheckingstub__00475a5e14af8c4c7049089f69b3d29ad81bc91e7e1f0a5a5b7b794a5
     encryption: typing.Optional[TableEncryption] = None,
     encryption_key: typing.Optional[_IKey_5f11635f] = None,
     import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
@@ -15870,6 +16197,8 @@ def _typecheckingstub__7f586bf63a567e16bde337be791f392306be66abca1c4abb791989fb9
     projection_type: typing.Optional[ProjectionType] = None,
     partition_key: typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]],
     sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     write_capacity: typing.Optional[jsii.Number] = None,
 ) -> None:
@@ -15882,6 +16211,8 @@ def _typecheckingstub__4d662ce35086830139f09f255840ae92cf556a93d47e96653c908cc7a
     non_key_attributes: typing.Optional[typing.Sequence[builtins.str]] = None,
     projection_type: typing.Optional[ProjectionType] = None,
     partition_key: typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]],
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
     read_capacity: typing.Optional[Capacity] = None,
     sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[Capacity] = None,
@@ -15925,6 +16256,7 @@ def _typecheckingstub__7500a741eaeb840f48aaefcd8fc5fbbb8b1082165601116ca363e5ddb
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     region: builtins.str,
     global_secondary_index_options: typing.Optional[typing.Mapping[builtins.str, typing.Union[ReplicaGlobalSecondaryIndexOptions, typing.Dict[builtins.str, typing.Any]]]] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
     read_capacity: typing.Optional[Capacity] = None,
 ) -> None:
     """Type checking stubs"""
@@ -15942,6 +16274,8 @@ def _typecheckingstub__b92f0ed514f00b57a2a41d754e55fe495d22b05b0ad4711b80ce00457
     encryption: typing.Optional[TableEncryption] = None,
     encryption_key: typing.Optional[_IKey_5f11635f] = None,
     import_source: typing.Optional[typing.Union[ImportSourceSpecification, typing.Dict[builtins.str, typing.Any]]] = None,
+    max_read_request_units: typing.Optional[jsii.Number] = None,
+    max_write_request_units: typing.Optional[jsii.Number] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,