aws-cdk-lib 2.172.0__py3-none-any.whl → 2.173.1__py3-none-any.whl

aws_cdk/aws_dynamodb/__init__.py

@@ -221,6 +221,27 @@ global_table = dynamodb.TableV2(self, "Table",
 Further reading:
 https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html
 
+## Warm Throughput
+
+Warm throughput refers to the number of read and write operations your DynamoDB table can instantaneously support.
+
+This optional configuration allows you to pre-warm your table or index to handle anticipated throughput, ensuring optimal performance under expected load.
+
+The Warm Throughput configuration settings are automatically replicated across all Global Table replicas.
+
+```python
+table = dynamodb.TableV2(self, "Table",
+    partition_key=dynamodb.Attribute(name="id", type=dynamodb.AttributeType.STRING),
+    warm_throughput=dynamodb.WarmThroughput(
+        read_units_per_second=15000,
+        write_units_per_second=20000
+    )
+)
+```
+
+Further reading:
+https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/warm-throughput.html
+
 ## Encryption
 
 All user data stored in a DynamoDB table is fully encrypted at rest. When creating an instance of the `TableV2` construct, you can select the following table encryption options:
@@ -991,6 +1012,21 @@ from ..aws_kms import IKey as _IKey_5f11635f
 from ..aws_s3 import IBucket as _IBucket_42e086fd
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_dynamodb.ApproximateCreationDateTimePrecision")
+class ApproximateCreationDateTimePrecision(enum.Enum):
+    '''The precision associated with the DynamoDB write timestamps that will be replicated to Kinesis.
+
+    The default setting for record timestamp precision is microseconds. You can change this setting at any time.
+
+    :see: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-dynamodb-table-kinesisstreamspecification.html#aws-properties-dynamodb-table-kinesisstreamspecification-properties
+    '''
+
+    MILLISECOND = "MILLISECOND"
+    '''Millisecond precision.'''
+    MICROSECOND = "MICROSECOND"
+    '''Microsecond precision.'''
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_dynamodb.Attribute",
     jsii_struct_bases=[],
@@ -11864,6 +11900,7 @@ typing.cast(typing.Any, TableEncryptionV2).__jsii_proxy_class__ = lambda : _Tabl
         "table_class": "tableClass",
         "time_to_live_attribute": "timeToLiveAttribute",
         "wait_for_replication_to_finish": "waitForReplicationToFinish",
+        "warm_throughput": "warmThroughput",
         "write_capacity": "writeCapacity",
     },
 )
@@ -11891,6 +11928,7 @@ class TableOptions(SchemaOptions):
         table_class: typing.Optional[TableClass] = None,
         time_to_live_attribute: typing.Optional[builtins.str] = None,
         wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+        warm_throughput: typing.Optional[typing.Union["WarmThroughput", typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''Properties of a DynamoDB Table.
@@ -11917,6 +11955,7 @@ class TableOptions(SchemaOptions):
         :param table_class: Specify the table class. Default: STANDARD
         :param time_to_live_attribute: The name of TTL attribute. Default: - TTL is disabled
         :param wait_for_replication_to_finish: [WARNING: Use this flag with caution, misusing this flag may cause deleting existing replicas, refer to the detailed documentation for more information] Indicates whether CloudFormation stack waits for replication to finish. If set to false, the CloudFormation resource will mark the resource as created and replication will be completed asynchronously. This property is ignored if replicationRegions property is not set. WARNING: DO NOT UNSET this property if adding/removing multiple replicationRegions in one deployment, as CloudFormation only supports one region replication at a time. CDK overcomes this limitation by waiting for replication to finish before starting new replicationRegion. If the custom resource which handles replication has a physical resource ID with the format ``region`` instead of ``tablename-region`` (this would happen if the custom resource hasn't received an event since v1.91.0), DO NOT SET this property to false without making a change to the table name. This will cause the existing replicas to be deleted. Default: true
+        :param warm_throughput: Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the ``Table`` construct. To enable Warm Throughput, use the ``TableV2`` construct instead. Default: - warm throughput is not configured
         :param write_capacity: The write 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
 
         :exampleMetadata: fixture=_generated
@@ -11973,6 +12012,10 @@ class TableOptions(SchemaOptions):
                 table_class=dynamodb.TableClass.STANDARD,
                 time_to_live_attribute="timeToLiveAttribute",
                 wait_for_replication_to_finish=False,
+                warm_throughput=dynamodb.WarmThroughput(
+                    read_units_per_second=123,
+                    write_units_per_second=123
+                ),
                 write_capacity=123
             )
         '''
@@ -11982,6 +12025,8 @@ class TableOptions(SchemaOptions):
             sort_key = Attribute(**sort_key)
         if isinstance(import_source, dict):
             import_source = ImportSourceSpecification(**import_source)
+        if isinstance(warm_throughput, dict):
+            warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__dadf5733fac70178ab246582a0b777b8c203659229753a8396594d751c99cb52)
             check_type(argname="argument partition_key", value=partition_key, expected_type=type_hints["partition_key"])
@@ -12004,6 +12049,7 @@ class TableOptions(SchemaOptions):
             check_type(argname="argument table_class", value=table_class, expected_type=type_hints["table_class"])
             check_type(argname="argument time_to_live_attribute", value=time_to_live_attribute, expected_type=type_hints["time_to_live_attribute"])
             check_type(argname="argument wait_for_replication_to_finish", value=wait_for_replication_to_finish, expected_type=type_hints["wait_for_replication_to_finish"])
+            check_type(argname="argument warm_throughput", value=warm_throughput, expected_type=type_hints["warm_throughput"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "partition_key": partition_key,
@@ -12046,6 +12092,8 @@ class TableOptions(SchemaOptions):
             self._values["time_to_live_attribute"] = time_to_live_attribute
         if wait_for_replication_to_finish is not None:
             self._values["wait_for_replication_to_finish"] = wait_for_replication_to_finish
+        if warm_throughput is not None:
+            self._values["warm_throughput"] = warm_throughput
         if write_capacity is not None:
             self._values["write_capacity"] = write_capacity
 
@@ -12279,6 +12327,19 @@ class TableOptions(SchemaOptions):
         result = self._values.get("wait_for_replication_to_finish")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def warm_throughput(self) -> typing.Optional["WarmThroughput"]:
+        '''Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the ``Table`` construct.
+
+        To enable Warm Throughput, use the ``TableV2`` construct instead.
+
+        :default: - warm throughput is not configured
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html#cfn-dynamodb-table-warmthroughput
+        '''
+        result = self._values.get("warm_throughput")
+        return typing.cast(typing.Optional["WarmThroughput"], result)
+
     @builtins.property
     def write_capacity(self) -> typing.Optional[jsii.Number]:
         '''The write capacity for the table.
@@ -12492,7 +12553,9 @@ class TableOptionsV2:
         "table_class": "tableClass",
         "time_to_live_attribute": "timeToLiveAttribute",
         "wait_for_replication_to_finish": "waitForReplicationToFinish",
+        "warm_throughput": "warmThroughput",
         "write_capacity": "writeCapacity",
+        "kinesis_precision_timestamp": "kinesisPrecisionTimestamp",
         "kinesis_stream": "kinesisStream",
         "table_name": "tableName",
     },
@@ -12521,7 +12584,9 @@ class TableProps(TableOptions):
         table_class: typing.Optional[TableClass] = None,
         time_to_live_attribute: typing.Optional[builtins.str] = None,
         wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+        warm_throughput: typing.Optional[typing.Union["WarmThroughput", typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
+        kinesis_precision_timestamp: typing.Optional[ApproximateCreationDateTimePrecision] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         table_name: typing.Optional[builtins.str] = None,
     ) -> None:
@@ -12547,7 +12612,9 @@ class TableProps(TableOptions):
         :param table_class: Specify the table class. Default: STANDARD
         :param time_to_live_attribute: The name of TTL attribute. Default: - TTL is disabled
         :param wait_for_replication_to_finish: [WARNING: Use this flag with caution, misusing this flag may cause deleting existing replicas, refer to the detailed documentation for more information] Indicates whether CloudFormation stack waits for replication to finish. If set to false, the CloudFormation resource will mark the resource as created and replication will be completed asynchronously. This property is ignored if replicationRegions property is not set. WARNING: DO NOT UNSET this property if adding/removing multiple replicationRegions in one deployment, as CloudFormation only supports one region replication at a time. CDK overcomes this limitation by waiting for replication to finish before starting new replicationRegion. If the custom resource which handles replication has a physical resource ID with the format ``region`` instead of ``tablename-region`` (this would happen if the custom resource hasn't received an event since v1.91.0), DO NOT SET this property to false without making a change to the table name. This will cause the existing replicas to be deleted. Default: true
+        :param warm_throughput: Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the ``Table`` construct. To enable Warm Throughput, use the ``TableV2`` construct instead. Default: - warm throughput is not configured
         :param write_capacity: The write 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 kinesis_precision_timestamp: Kinesis Data Stream approximate creation timestamp prescision. Default: ApproximateCreationDateTimePrecision.MICROSECOND
         :param kinesis_stream: Kinesis Data Stream to capture item-level changes for the table. Default: - no Kinesis Data Stream
         :param table_name: Enforces a particular physical table name. Default: 
 
@@ -12583,6 +12650,8 @@ class TableProps(TableOptions):
             sort_key = Attribute(**sort_key)
         if isinstance(import_source, dict):
             import_source = ImportSourceSpecification(**import_source)
+        if isinstance(warm_throughput, dict):
+            warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__00475a5e14af8c4c7049089f69b3d29ad81bc91e7e1f0a5a5b7b794a54003a08)
             check_type(argname="argument partition_key", value=partition_key, expected_type=type_hints["partition_key"])
@@ -12605,7 +12674,9 @@ class TableProps(TableOptions):
             check_type(argname="argument table_class", value=table_class, expected_type=type_hints["table_class"])
             check_type(argname="argument time_to_live_attribute", value=time_to_live_attribute, expected_type=type_hints["time_to_live_attribute"])
             check_type(argname="argument wait_for_replication_to_finish", value=wait_for_replication_to_finish, expected_type=type_hints["wait_for_replication_to_finish"])
+            check_type(argname="argument warm_throughput", value=warm_throughput, expected_type=type_hints["warm_throughput"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
+            check_type(argname="argument kinesis_precision_timestamp", value=kinesis_precision_timestamp, expected_type=type_hints["kinesis_precision_timestamp"])
             check_type(argname="argument kinesis_stream", value=kinesis_stream, expected_type=type_hints["kinesis_stream"])
             check_type(argname="argument table_name", value=table_name, expected_type=type_hints["table_name"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -12649,8 +12720,12 @@ class TableProps(TableOptions):
             self._values["time_to_live_attribute"] = time_to_live_attribute
         if wait_for_replication_to_finish is not None:
             self._values["wait_for_replication_to_finish"] = wait_for_replication_to_finish
+        if warm_throughput is not None:
+            self._values["warm_throughput"] = warm_throughput
         if write_capacity is not None:
             self._values["write_capacity"] = write_capacity
+        if kinesis_precision_timestamp is not None:
+            self._values["kinesis_precision_timestamp"] = kinesis_precision_timestamp
         if kinesis_stream is not None:
             self._values["kinesis_stream"] = kinesis_stream
         if table_name is not None:
@@ -12886,6 +12961,19 @@ class TableProps(TableOptions):
         result = self._values.get("wait_for_replication_to_finish")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def warm_throughput(self) -> typing.Optional["WarmThroughput"]:
+        '''Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the ``Table`` construct.
+
+        To enable Warm Throughput, use the ``TableV2`` construct instead.
+
+        :default: - warm throughput is not configured
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html#cfn-dynamodb-table-warmthroughput
+        '''
+        result = self._values.get("warm_throughput")
+        return typing.cast(typing.Optional["WarmThroughput"], result)
+
     @builtins.property
     def write_capacity(self) -> typing.Optional[jsii.Number]:
         '''The write capacity for the table.
@@ -12900,6 +12988,17 @@ class TableProps(TableOptions):
         result = self._values.get("write_capacity")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def kinesis_precision_timestamp(
+        self,
+    ) -> typing.Optional[ApproximateCreationDateTimePrecision]:
+        '''Kinesis Data Stream approximate creation timestamp prescision.
+
+        :default: ApproximateCreationDateTimePrecision.MICROSECOND
+        '''
+        result = self._values.get("kinesis_precision_timestamp")
+        return typing.cast(typing.Optional[ApproximateCreationDateTimePrecision], result)
+
     @builtins.property
     def kinesis_stream(self) -> typing.Optional[_IStream_4e2457d2]:
         '''Kinesis Data Stream to capture item-level changes for the table.
@@ -12952,6 +13051,7 @@ class TableProps(TableOptions):
         "sort_key": "sortKey",
         "table_name": "tableName",
         "time_to_live_attribute": "timeToLiveAttribute",
+        "warm_throughput": "warmThroughput",
     },
 )
 class TablePropsV2(TableOptionsV2):
@@ -12976,6 +13076,7 @@ class TablePropsV2(TableOptionsV2):
         sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
         table_name: typing.Optional[builtins.str] = None,
         time_to_live_attribute: typing.Optional[builtins.str] = None,
+        warm_throughput: typing.Optional[typing.Union["WarmThroughput", typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''Properties used to configure a DynamoDB table.
 
@@ -12997,6 +13098,7 @@ class TablePropsV2(TableOptionsV2):
         :param sort_key: Sort key attribute definition. Default: - no sort key
         :param table_name: The name of the table. Default: - generated by CloudFormation
         :param time_to_live_attribute: The name of the TTL attribute. Default: - TTL is disabled
+        :param warm_throughput: The warm throughput configuration for the table. Default: - no warm throughput is configured
 
         :exampleMetadata: infused
 
@@ -13020,6 +13122,8 @@ class TablePropsV2(TableOptionsV2):
             partition_key = Attribute(**partition_key)
         if isinstance(sort_key, dict):
             sort_key = Attribute(**sort_key)
+        if isinstance(warm_throughput, dict):
+            warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__205e5df85e01c6c2d91d5922a57e3ed5903027748a8b3222622bebd1077e84ba)
             check_type(argname="argument contributor_insights", value=contributor_insights, expected_type=type_hints["contributor_insights"])
@@ -13040,6 +13144,7 @@ class TablePropsV2(TableOptionsV2):
             check_type(argname="argument sort_key", value=sort_key, expected_type=type_hints["sort_key"])
             check_type(argname="argument table_name", value=table_name, expected_type=type_hints["table_name"])
             check_type(argname="argument time_to_live_attribute", value=time_to_live_attribute, expected_type=type_hints["time_to_live_attribute"])
+            check_type(argname="argument warm_throughput", value=warm_throughput, expected_type=type_hints["warm_throughput"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "partition_key": partition_key,
         }
@@ -13077,6 +13182,8 @@ class TablePropsV2(TableOptionsV2):
             self._values["table_name"] = table_name
         if time_to_live_attribute is not None:
             self._values["time_to_live_attribute"] = time_to_live_attribute
+        if warm_throughput is not None:
+            self._values["warm_throughput"] = warm_throughput
 
     @builtins.property
     def contributor_insights(self) -> typing.Optional[builtins.bool]:
@@ -13256,6 +13363,15 @@ class TablePropsV2(TableOptionsV2):
         result = self._values.get("time_to_live_attribute")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def warm_throughput(self) -> typing.Optional["WarmThroughput"]:
+        '''The warm throughput configuration for the table.
+
+        :default: - no warm throughput is configured
+        '''
+        result = self._values.get("warm_throughput")
+        return typing.cast(typing.Optional["WarmThroughput"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -13310,6 +13426,7 @@ class TableV2(
         sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
         table_name: typing.Optional[builtins.str] = None,
         time_to_live_attribute: typing.Optional[builtins.str] = None,
+        warm_throughput: typing.Optional[typing.Union["WarmThroughput", typing.Dict[builtins.str, typing.Any]]] = None,
         contributor_insights: typing.Optional[builtins.bool] = None,
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
@@ -13332,6 +13449,7 @@ class TableV2(
         :param sort_key: Sort key attribute definition. Default: - no sort key
         :param table_name: The name of the table. Default: - generated by CloudFormation
         :param time_to_live_attribute: The name of the TTL attribute. Default: - TTL is disabled
+        :param warm_throughput: The warm throughput configuration for the table. Default: - no warm throughput is configured
         :param contributor_insights: Whether CloudWatch contributor insights is enabled. Default: false
         :param deletion_protection: Whether deletion protection is enabled. Default: false
         :param kinesis_stream: Kinesis Data Stream to capture item level changes. Default: - no Kinesis Data Stream
@@ -13356,6 +13474,7 @@ class TableV2(
             sort_key=sort_key,
             table_name=table_name,
             time_to_live_attribute=time_to_live_attribute,
+            warm_throughput=warm_throughput,
             contributor_insights=contributor_insights,
             deletion_protection=deletion_protection,
             kinesis_stream=kinesis_stream,
@@ -13464,6 +13583,7 @@ class TableV2(
         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,
+        warm_throughput: typing.Optional[typing.Union["WarmThroughput", typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[Capacity] = None,
         index_name: builtins.str,
         non_key_attributes: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -13478,6 +13598,7 @@ class TableV2(
         :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 warm_throughput: The warm throughput configuration for the global secondary index. Default: - no warm throughput is configured
         :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.
         :param index_name: The name of the secondary index.
         :param non_key_attributes: The non-key attributes that are projected into the secondary index. Default: - No additional attributes
@@ -13489,6 +13610,7 @@ class TableV2(
             max_write_request_units=max_write_request_units,
             read_capacity=read_capacity,
             sort_key=sort_key,
+            warm_throughput=warm_throughput,
             write_capacity=write_capacity,
             index_name=index_name,
             non_key_attributes=non_key_attributes,
@@ -13870,6 +13992,78 @@ class UtilizationScalingProps(_BaseTargetTrackingProps_540ba713):
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_dynamodb.WarmThroughput",
+    jsii_struct_bases=[],
+    name_mapping={
+        "read_units_per_second": "readUnitsPerSecond",
+        "write_units_per_second": "writeUnitsPerSecond",
+    },
+)
+class WarmThroughput:
+    def __init__(
+        self,
+        *,
+        read_units_per_second: typing.Optional[jsii.Number] = None,
+        write_units_per_second: typing.Optional[jsii.Number] = None,
+    ) -> None:
+        '''Reference to WarmThroughput for a DynamoDB table.
+
+        :param read_units_per_second: Configures the number of read units per second a table will be able to handle instantly. Default: - no readUnitsPerSecond configured
+        :param write_units_per_second: Configures the number of write units per second a table will be able to handle instantly. Default: - no writeUnitsPerSecond configured
+
+        :exampleMetadata: infused
+
+        Example::
+
+            table = dynamodb.TableV2(self, "Table",
+                partition_key=dynamodb.Attribute(name="id", type=dynamodb.AttributeType.STRING),
+                warm_throughput=dynamodb.WarmThroughput(
+                    read_units_per_second=15000,
+                    write_units_per_second=20000
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__ea3f07e08dc05c8371a6d7c241d22bd88e7f4c275408314c3875915b1c8db940)
+            check_type(argname="argument read_units_per_second", value=read_units_per_second, expected_type=type_hints["read_units_per_second"])
+            check_type(argname="argument write_units_per_second", value=write_units_per_second, expected_type=type_hints["write_units_per_second"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if read_units_per_second is not None:
+            self._values["read_units_per_second"] = read_units_per_second
+        if write_units_per_second is not None:
+            self._values["write_units_per_second"] = write_units_per_second
+
+    @builtins.property
+    def read_units_per_second(self) -> typing.Optional[jsii.Number]:
+        '''Configures the number of read units per second a table will be able to handle instantly.
+
+        :default: - no readUnitsPerSecond configured
+        '''
+        result = self._values.get("read_units_per_second")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def write_units_per_second(self) -> typing.Optional[jsii.Number]:
+        '''Configures the number of write units per second a table will be able to handle instantly.
+
+        :default: - no writeUnitsPerSecond configured
+        '''
+        result = self._values.get("write_units_per_second")
+        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 "WarmThroughput(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_dynamodb.GlobalSecondaryIndexProps",
     jsii_struct_bases=[SecondaryIndexProps, SchemaOptions],
@@ -13883,6 +14077,7 @@ class UtilizationScalingProps(_BaseTargetTrackingProps_540ba713):
         "max_read_request_units": "maxReadRequestUnits",
         "max_write_request_units": "maxWriteRequestUnits",
         "read_capacity": "readCapacity",
+        "warm_throughput": "warmThroughput",
         "write_capacity": "writeCapacity",
     },
 )
@@ -13899,6 +14094,7 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         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,
+        warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''Properties for a global secondary index.
@@ -13912,6 +14108,7 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         :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 warm_throughput: The warm throughput configuration for the global secondary index. Default: - no warm throughput is configured
         :param write_capacity: The write capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
 
         :exampleMetadata: infused
@@ -13933,6 +14130,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
             partition_key = Attribute(**partition_key)
         if isinstance(sort_key, dict):
             sort_key = Attribute(**sort_key)
+        if isinstance(warm_throughput, dict):
+            warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7f586bf63a567e16bde337be791f392306be66abca1c4abb791989fb9dc7b4e2)
             check_type(argname="argument index_name", value=index_name, expected_type=type_hints["index_name"])
@@ -13944,6 +14143,7 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
             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 warm_throughput", value=warm_throughput, expected_type=type_hints["warm_throughput"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "index_name": index_name,
@@ -13963,6 +14163,8 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
             self._values["max_write_request_units"] = max_write_request_units
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
+        if warm_throughput is not None:
+            self._values["warm_throughput"] = warm_throughput
         if write_capacity is not None:
             self._values["write_capacity"] = write_capacity
 
@@ -14049,6 +14251,15 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         result = self._values.get("read_capacity")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def warm_throughput(self) -> typing.Optional[WarmThroughput]:
+        '''The warm throughput configuration for the global secondary index.
+
+        :default: - no warm throughput is configured
+        '''
+        result = self._values.get("warm_throughput")
+        return typing.cast(typing.Optional[WarmThroughput], result)
+
     @builtins.property
     def write_capacity(self) -> typing.Optional[jsii.Number]:
         '''The write capacity for the global secondary index.
@@ -14084,6 +14295,7 @@ class GlobalSecondaryIndexProps(SecondaryIndexProps, SchemaOptions):
         "max_write_request_units": "maxWriteRequestUnits",
         "read_capacity": "readCapacity",
         "sort_key": "sortKey",
+        "warm_throughput": "warmThroughput",
         "write_capacity": "writeCapacity",
     },
 )
@@ -14099,6 +14311,7 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         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,
+        warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[Capacity] = None,
     ) -> None:
         '''Properties used to configure a global secondary index.
@@ -14111,6 +14324,7 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         :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 warm_throughput: The warm throughput configuration for the global secondary index. Default: - no warm throughput is configured
         :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.
 
         :exampleMetadata: infused
@@ -14135,6 +14349,8 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
             partition_key = Attribute(**partition_key)
         if isinstance(sort_key, dict):
             sort_key = Attribute(**sort_key)
+        if isinstance(warm_throughput, dict):
+            warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4d662ce35086830139f09f255840ae92cf556a93d47e96653c908cc7a298d1e1)
             check_type(argname="argument index_name", value=index_name, expected_type=type_hints["index_name"])
@@ -14145,6 +14361,7 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
             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 warm_throughput", value=warm_throughput, expected_type=type_hints["warm_throughput"])
             check_type(argname="argument write_capacity", value=write_capacity, expected_type=type_hints["write_capacity"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "index_name": index_name,
@@ -14162,6 +14379,8 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
             self._values["read_capacity"] = read_capacity
         if sort_key is not None:
             self._values["sort_key"] = sort_key
+        if warm_throughput is not None:
+            self._values["warm_throughput"] = warm_throughput
         if write_capacity is not None:
             self._values["write_capacity"] = write_capacity
 
@@ -14239,6 +14458,15 @@ class GlobalSecondaryIndexPropsV2(SecondaryIndexProps):
         result = self._values.get("sort_key")
         return typing.cast(typing.Optional[Attribute], result)
 
+    @builtins.property
+    def warm_throughput(self) -> typing.Optional[WarmThroughput]:
+        '''The warm throughput configuration for the global secondary index.
+
+        :default: - no warm throughput is configured
+        '''
+        result = self._values.get("warm_throughput")
+        return typing.cast(typing.Optional[WarmThroughput], result)
+
     @builtins.property
     def write_capacity(self) -> typing.Optional[Capacity]:
         '''The write capacity.
@@ -14850,6 +15078,7 @@ class Table(
         scope: _constructs_77d1e7e8.Construct,
         id: builtins.str,
         *,
+        kinesis_precision_timestamp: typing.Optional[ApproximateCreationDateTimePrecision] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         table_name: typing.Optional[builtins.str] = None,
         billing_mode: typing.Optional[BillingMode] = None,
@@ -14870,6 +15099,7 @@ class Table(
         table_class: typing.Optional[TableClass] = None,
         time_to_live_attribute: typing.Optional[builtins.str] = None,
         wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+        warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[jsii.Number] = 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,
@@ -14877,6 +15107,7 @@ class Table(
         '''
         :param scope: -
         :param id: -
+        :param kinesis_precision_timestamp: Kinesis Data Stream approximate creation timestamp prescision. Default: ApproximateCreationDateTimePrecision.MICROSECOND
         :param kinesis_stream: Kinesis Data Stream to capture item-level changes for the table. Default: - no Kinesis Data Stream
         :param table_name: Enforces a particular physical table name. Default: 
         :param billing_mode: Specify how you are charged for read and write throughput and how you manage capacity. Default: PROVISIONED if ``replicationRegions`` is not specified, PAY_PER_REQUEST otherwise
@@ -14897,6 +15128,7 @@ class Table(
         :param table_class: Specify the table class. Default: STANDARD
         :param time_to_live_attribute: The name of TTL attribute. Default: - TTL is disabled
         :param wait_for_replication_to_finish: [WARNING: Use this flag with caution, misusing this flag may cause deleting existing replicas, refer to the detailed documentation for more information] Indicates whether CloudFormation stack waits for replication to finish. If set to false, the CloudFormation resource will mark the resource as created and replication will be completed asynchronously. This property is ignored if replicationRegions property is not set. WARNING: DO NOT UNSET this property if adding/removing multiple replicationRegions in one deployment, as CloudFormation only supports one region replication at a time. CDK overcomes this limitation by waiting for replication to finish before starting new replicationRegion. If the custom resource which handles replication has a physical resource ID with the format ``region`` instead of ``tablename-region`` (this would happen if the custom resource hasn't received an event since v1.91.0), DO NOT SET this property to false without making a change to the table name. This will cause the existing replicas to be deleted. Default: true
+        :param warm_throughput: Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the ``Table`` construct. To enable Warm Throughput, use the ``TableV2`` construct instead. Default: - warm throughput is not configured
         :param write_capacity: The write 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 partition_key: Partition key attribute definition.
         :param sort_key: Sort key attribute definition. Default: no sort key
@@ -14906,6 +15138,7 @@ class Table(
             check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
         props = TableProps(
+            kinesis_precision_timestamp=kinesis_precision_timestamp,
             kinesis_stream=kinesis_stream,
             table_name=table_name,
             billing_mode=billing_mode,
@@ -14926,6 +15159,7 @@ class Table(
             table_class=table_class,
             time_to_live_attribute=time_to_live_attribute,
             wait_for_replication_to_finish=wait_for_replication_to_finish,
+            warm_throughput=warm_throughput,
             write_capacity=write_capacity,
             partition_key=partition_key,
             sort_key=sort_key,
@@ -15026,6 +15260,7 @@ class Table(
         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,
+        warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
         write_capacity: typing.Optional[jsii.Number] = None,
         index_name: builtins.str,
         non_key_attributes: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -15039,6 +15274,7 @@ class 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 warm_throughput: The warm throughput configuration for the global secondary index. Default: - no warm throughput is configured
         :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.
         :param non_key_attributes: The non-key attributes that are projected into the secondary index. Default: - No additional attributes
@@ -15051,6 +15287,7 @@ class Table(
             max_read_request_units=max_read_request_units,
             max_write_request_units=max_write_request_units,
             read_capacity=read_capacity,
+            warm_throughput=warm_throughput,
             write_capacity=write_capacity,
             index_name=index_name,
             non_key_attributes=non_key_attributes,
@@ -15248,6 +15485,7 @@ class Table(
 
 
 __all__ = [
+    "ApproximateCreationDateTimePrecision",
     "Attribute",
     "AttributeType",
     "AutoscaledCapacityOptions",
@@ -15295,6 +15533,7 @@ __all__ = [
     "TableV2",
     "ThroughputProps",
     "UtilizationScalingProps",
+    "WarmThroughput",
 ]
 
 publication.publish()
@@ -16413,6 +16652,7 @@ def _typecheckingstub__dadf5733fac70178ab246582a0b777b8c203659229753a8396594d751
     table_class: typing.Optional[TableClass] = None,
     time_to_live_attribute: typing.Optional[builtins.str] = None,
     wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
@@ -16453,7 +16693,9 @@ def _typecheckingstub__00475a5e14af8c4c7049089f69b3d29ad81bc91e7e1f0a5a5b7b794a5
     table_class: typing.Optional[TableClass] = None,
     time_to_live_attribute: typing.Optional[builtins.str] = None,
     wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[jsii.Number] = None,
+    kinesis_precision_timestamp: typing.Optional[ApproximateCreationDateTimePrecision] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     table_name: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -16480,6 +16722,7 @@ def _typecheckingstub__205e5df85e01c6c2d91d5922a57e3ed5903027748a8b3222622bebd10
     sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
     table_name: typing.Optional[builtins.str] = None,
     time_to_live_attribute: typing.Optional[builtins.str] = None,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -16499,6 +16742,7 @@ def _typecheckingstub__9ea47b003cdb497ff620f1410260696f97dbb2b00fa8558235f23771f
     sort_key: typing.Optional[typing.Union[Attribute, typing.Dict[builtins.str, typing.Any]]] = None,
     table_name: typing.Optional[builtins.str] = None,
     time_to_live_attribute: typing.Optional[builtins.str] = None,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     contributor_insights: typing.Optional[builtins.bool] = None,
     deletion_protection: typing.Optional[builtins.bool] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
@@ -16573,6 +16817,14 @@ def _typecheckingstub__c4ff699feae0a38c5f10e2a5642e047a70a3e0efba02b8c1f70810eb7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__ea3f07e08dc05c8371a6d7c241d22bd88e7f4c275408314c3875915b1c8db940(
+    *,
+    read_units_per_second: typing.Optional[jsii.Number] = None,
+    write_units_per_second: typing.Optional[jsii.Number] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__7f586bf63a567e16bde337be791f392306be66abca1c4abb791989fb9dc7b4e2(
     *,
     index_name: builtins.str,
@@ -16584,6 +16836,7 @@ def _typecheckingstub__7f586bf63a567e16bde337be791f392306be66abca1c4abb791989fb9
     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,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
@@ -16599,6 +16852,7 @@ def _typecheckingstub__4d662ce35086830139f09f255840ae92cf556a93d47e96653c908cc7a
     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,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[Capacity] = None,
 ) -> None:
     """Type checking stubs"""
@@ -16650,6 +16904,7 @@ def _typecheckingstub__b92f0ed514f00b57a2a41d754e55fe495d22b05b0ad4711b80ce00457
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
     *,
+    kinesis_precision_timestamp: typing.Optional[ApproximateCreationDateTimePrecision] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     table_name: typing.Optional[builtins.str] = None,
     billing_mode: typing.Optional[BillingMode] = None,
@@ -16670,6 +16925,7 @@ def _typecheckingstub__b92f0ed514f00b57a2a41d754e55fe495d22b05b0ad4711b80ce00457
     table_class: typing.Optional[TableClass] = None,
     time_to_live_attribute: typing.Optional[builtins.str] = None,
     wait_for_replication_to_finish: typing.Optional[builtins.bool] = None,
+    warm_throughput: typing.Optional[typing.Union[WarmThroughput, typing.Dict[builtins.str, typing.Any]]] = None,
     write_capacity: typing.Optional[jsii.Number] = 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,