aws-cdk-lib 2.177.0__py3-none-any.whl → 2.178.1__py3-none-any.whl

aws_cdk/aws_dynamodb/__init__.py

@@ -20,7 +20,9 @@ table = dynamodb.TableV2(self, "Table",
     partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
     contributor_insights=True,
     table_class=dynamodb.TableClass.STANDARD_INFREQUENT_ACCESS,
-    point_in_time_recovery=True
+    point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+        point_in_time_recovery_enabled=True
+    )
 )
 ```
 
@@ -68,7 +70,7 @@ The following properties are configurable on a per-replica basis, but will be in
 
 * contributorInsights
 * deletionProtection
-* pointInTimeRecovery
+* pointInTimeRecoverySpecification
 * tableClass
 * readCapacity (only configurable if the `TableV2` billing mode is `PROVISIONED`)
 * globalSecondaryIndexes (only `contributorInsights` and `readCapacity`)
@@ -85,11 +87,15 @@ stack = cdk.Stack(app, "Stack", env=cdk.Environment(region="us-west-2"))
 global_table = dynamodb.TableV2(stack, "GlobalTable",
     partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
     contributor_insights=True,
-    point_in_time_recovery=True,
+    point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+        point_in_time_recovery_enabled=True
+    ),
     replicas=[dynamodb.ReplicaTableProps(
         region="us-east-1",
         table_class=dynamodb.TableClass.STANDARD_INFREQUENT_ACCESS,
-        point_in_time_recovery=False
+        point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+            point_in_time_recovery_enabled=False
+        )
     ), dynamodb.ReplicaTableProps(
         region="us-east-2",
         contributor_insights=False
@@ -601,12 +607,17 @@ global_table = dynamodb.TableV2(stack, "GlobalTable",
 
 ## Point-in-Time Recovery
 
-`pointInTimeRecovery` provides automatic backups of your DynamoDB table data which helps protect your tables from accidental write or delete operations.
+`pointInTimeRecoverySpecifcation` provides automatic backups of your DynamoDB table data which helps protect your tables from accidental write or delete operations.
+
+You can also choose to set `recoveryPeriodInDays` to a value between `1` and `35` which dictates how many days of recoverable data is stored. If no value is provided, the recovery period defaults to `35` days.
 
 ```python
 table = dynamodb.TableV2(self, "Table",
     partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
-    point_in_time_recovery=True
+    point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+        point_in_time_recovery_enabled=True,
+        recovery_period_in_days=4
+    )
 )
 ```
 
@@ -9406,6 +9417,83 @@ class Operation(enum.Enum):
     '''ExecuteStatement.'''
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_dynamodb.PointInTimeRecoverySpecification",
+    jsii_struct_bases=[],
+    name_mapping={
+        "point_in_time_recovery_enabled": "pointInTimeRecoveryEnabled",
+        "recovery_period_in_days": "recoveryPeriodInDays",
+    },
+)
+class PointInTimeRecoverySpecification:
+    def __init__(
+        self,
+        *,
+        point_in_time_recovery_enabled: builtins.bool,
+        recovery_period_in_days: typing.Optional[jsii.Number] = None,
+    ) -> None:
+        '''Reference to PointInTimeRecovey Specification for continuous backups.
+
+        :param point_in_time_recovery_enabled: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table. Default: false
+        :param recovery_period_in_days: The number of preceding days for which continuous backups are taken and maintained. Your table data is only recoverable to any point-in-time from within the configured recovery period. If no value is provided, the value will default to 35. Default: 35
+
+        :exampleMetadata: infused
+
+        Example::
+
+            table = dynamodb.TableV2(self, "Table",
+                partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
+                contributor_insights=True,
+                table_class=dynamodb.TableClass.STANDARD_INFREQUENT_ACCESS,
+                point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+                    point_in_time_recovery_enabled=True
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__4073f2e85ef31d8deba5f90be11b466e4a3f1ea003482bf5c4df5706f50fbc77)
+            check_type(argname="argument point_in_time_recovery_enabled", value=point_in_time_recovery_enabled, expected_type=type_hints["point_in_time_recovery_enabled"])
+            check_type(argname="argument recovery_period_in_days", value=recovery_period_in_days, expected_type=type_hints["recovery_period_in_days"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "point_in_time_recovery_enabled": point_in_time_recovery_enabled,
+        }
+        if recovery_period_in_days is not None:
+            self._values["recovery_period_in_days"] = recovery_period_in_days
+
+    @builtins.property
+    def point_in_time_recovery_enabled(self) -> builtins.bool:
+        '''Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
+
+        :default: false
+        '''
+        result = self._values.get("point_in_time_recovery_enabled")
+        assert result is not None, "Required property 'point_in_time_recovery_enabled' is missing"
+        return typing.cast(builtins.bool, result)
+
+    @builtins.property
+    def recovery_period_in_days(self) -> typing.Optional[jsii.Number]:
+        '''The number of preceding days for which continuous backups are taken and maintained.
+
+        Your table data is only recoverable to any point-in-time from within the configured recovery period.
+        If no value is provided, the value will default to 35.
+
+        :default: 35
+        '''
+        result = self._values.get("recovery_period_in_days")
+        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 "PointInTimeRecoverySpecification(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.enum(jsii_type="aws-cdk-lib.aws_dynamodb.ProjectionType")
 class ProjectionType(enum.Enum):
     '''The set of attributes that are projected into the index.
@@ -12093,7 +12181,9 @@ class TableClass(enum.Enum):
             partition_key=dynamodb.Attribute(name="pk", type=dynamodb.AttributeType.STRING),
             contributor_insights=True,
             table_class=dynamodb.TableClass.STANDARD_INFREQUENT_ACCESS,
-            point_in_time_recovery=True
+            point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+                point_in_time_recovery_enabled=True
+            )
         )
     '''
 
@@ -12226,6 +12316,7 @@ typing.cast(typing.Any, TableEncryptionV2).__jsii_proxy_class__ = lambda : _Tabl
         "max_read_request_units": "maxReadRequestUnits",
         "max_write_request_units": "maxWriteRequestUnits",
         "point_in_time_recovery": "pointInTimeRecovery",
+        "point_in_time_recovery_specification": "pointInTimeRecoverySpecification",
         "read_capacity": "readCapacity",
         "removal_policy": "removalPolicy",
         "replication_regions": "replicationRegions",
@@ -12254,6 +12345,7 @@ class TableOptions(SchemaOptions):
         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,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -12280,7 +12372,8 @@ class TableOptions(SchemaOptions):
         :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 point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :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
         :param replication_regions: Regions where replica tables will be created. Default: - no replica tables are created
@@ -12334,6 +12427,12 @@ class TableOptions(SchemaOptions):
                 max_read_request_units=123,
                 max_write_request_units=123,
                 point_in_time_recovery=False,
+                point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+                    point_in_time_recovery_enabled=False,
+            
+                    # the properties below are optional
+                    recovery_period_in_days=123
+                ),
                 read_capacity=123,
                 removal_policy=cdk.RemovalPolicy.DESTROY,
                 replication_regions=["replicationRegions"],
@@ -12360,6 +12459,8 @@ class TableOptions(SchemaOptions):
             sort_key = Attribute(**sort_key)
         if isinstance(import_source, dict):
             import_source = ImportSourceSpecification(**import_source)
+        if isinstance(point_in_time_recovery_specification, dict):
+            point_in_time_recovery_specification = PointInTimeRecoverySpecification(**point_in_time_recovery_specification)
         if isinstance(warm_throughput, dict):
             warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
@@ -12375,6 +12476,7 @@ class TableOptions(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 point_in_time_recovery", value=point_in_time_recovery, expected_type=type_hints["point_in_time_recovery"])
+            check_type(argname="argument point_in_time_recovery_specification", value=point_in_time_recovery_specification, expected_type=type_hints["point_in_time_recovery_specification"])
             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"])
             check_type(argname="argument replication_regions", value=replication_regions, expected_type=type_hints["replication_regions"])
@@ -12409,6 +12511,8 @@ class TableOptions(SchemaOptions):
             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 point_in_time_recovery_specification is not None:
+            self._values["point_in_time_recovery_specification"] = point_in_time_recovery_specification
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
         if removal_policy is not None:
@@ -12549,13 +12653,28 @@ class TableOptions(SchemaOptions):
 
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
-        '''Whether point-in-time recovery is enabled.
+        '''(deprecated) Whether point-in-time recovery is enabled.
+
+        :default: false - point in time recovery is not enabled.
+
+        :deprecated: use ``pointInTimeRecoverySpecification`` instead
 
-        :default: - point-in-time recovery is disabled
+        :stability: deprecated
         '''
         result = self._values.get("point_in_time_recovery")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def point_in_time_recovery_specification(
+        self,
+    ) -> typing.Optional[PointInTimeRecoverySpecification]:
+        '''Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.
+
+        :default: - point in time recovery is not enabled.
+        '''
+        result = self._values.get("point_in_time_recovery_specification")
+        return typing.cast(typing.Optional[PointInTimeRecoverySpecification], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[jsii.Number]:
         '''The read capacity for the table.
@@ -12709,6 +12828,7 @@ class TableOptions(SchemaOptions):
         "deletion_protection": "deletionProtection",
         "kinesis_stream": "kinesisStream",
         "point_in_time_recovery": "pointInTimeRecovery",
+        "point_in_time_recovery_specification": "pointInTimeRecoverySpecification",
         "resource_policy": "resourcePolicy",
         "table_class": "tableClass",
         "tags": "tags",
@@ -12722,6 +12842,7 @@ class TableOptionsV2:
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
         table_class: typing.Optional[TableClass] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -12731,7 +12852,8 @@ class TableOptionsV2:
         :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
-        :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: false
+        :param point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :param resource_policy: Resource policy to assign to DynamoDB Table. Default: - No resource policy statements are added to the created table.
         :param table_class: The table class. Default: TableClass.STANDARD
         :param tags: Tags to be applied to the primary table (default replica table). Default: - no tags
@@ -12754,6 +12876,12 @@ class TableOptionsV2:
                 deletion_protection=False,
                 kinesis_stream=stream,
                 point_in_time_recovery=False,
+                point_in_time_recovery_specification=dynamodb.PointInTimeRecoverySpecification(
+                    point_in_time_recovery_enabled=False,
+            
+                    # the properties below are optional
+                    recovery_period_in_days=123
+                ),
                 resource_policy=policy_document,
                 table_class=dynamodb.TableClass.STANDARD,
                 tags=[CfnTag(
@@ -12762,12 +12890,15 @@ class TableOptionsV2:
                 )]
             )
         '''
+        if isinstance(point_in_time_recovery_specification, dict):
+            point_in_time_recovery_specification = PointInTimeRecoverySpecification(**point_in_time_recovery_specification)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__1b65ee3c8ef5c3b632f4d1fad233252caadaa5f607c0fd92f49b64933f1de51c)
             check_type(argname="argument contributor_insights", value=contributor_insights, expected_type=type_hints["contributor_insights"])
             check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
             check_type(argname="argument kinesis_stream", value=kinesis_stream, expected_type=type_hints["kinesis_stream"])
             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 point_in_time_recovery_specification", value=point_in_time_recovery_specification, expected_type=type_hints["point_in_time_recovery_specification"])
             check_type(argname="argument resource_policy", value=resource_policy, expected_type=type_hints["resource_policy"])
             check_type(argname="argument table_class", value=table_class, expected_type=type_hints["table_class"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
@@ -12780,6 +12911,8 @@ class TableOptionsV2:
             self._values["kinesis_stream"] = kinesis_stream
         if point_in_time_recovery is not None:
             self._values["point_in_time_recovery"] = point_in_time_recovery
+        if point_in_time_recovery_specification is not None:
+            self._values["point_in_time_recovery_specification"] = point_in_time_recovery_specification
         if resource_policy is not None:
             self._values["resource_policy"] = resource_policy
         if table_class is not None:
@@ -12816,13 +12949,28 @@ class TableOptionsV2:
 
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
-        '''Whether point-in-time recovery is enabled.
+        '''(deprecated) Whether point-in-time recovery is enabled.
 
-        :default: false
+        :default: false - point in time recovery is not enabled.
+
+        :deprecated: use ``pointInTimeRecoverySpecification`` instead
+
+        :stability: deprecated
         '''
         result = self._values.get("point_in_time_recovery")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def point_in_time_recovery_specification(
+        self,
+    ) -> typing.Optional[PointInTimeRecoverySpecification]:
+        '''Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.
+
+        :default: - point in time recovery is not enabled.
+        '''
+        result = self._values.get("point_in_time_recovery_specification")
+        return typing.cast(typing.Optional[PointInTimeRecoverySpecification], result)
+
     @builtins.property
     def resource_policy(self) -> typing.Optional[_PolicyDocument_3ac34393]:
         '''Resource policy to assign to DynamoDB Table.
@@ -12879,6 +13027,7 @@ class TableOptionsV2:
         "max_read_request_units": "maxReadRequestUnits",
         "max_write_request_units": "maxWriteRequestUnits",
         "point_in_time_recovery": "pointInTimeRecovery",
+        "point_in_time_recovery_specification": "pointInTimeRecoverySpecification",
         "read_capacity": "readCapacity",
         "removal_policy": "removalPolicy",
         "replication_regions": "replicationRegions",
@@ -12910,6 +13059,7 @@ class TableProps(TableOptions):
         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,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -12937,7 +13087,8 @@ class TableProps(TableOptions):
         :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 point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :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
         :param replication_regions: Regions where replica tables will be created. Default: - no replica tables are created
@@ -12985,6 +13136,8 @@ class TableProps(TableOptions):
             sort_key = Attribute(**sort_key)
         if isinstance(import_source, dict):
             import_source = ImportSourceSpecification(**import_source)
+        if isinstance(point_in_time_recovery_specification, dict):
+            point_in_time_recovery_specification = PointInTimeRecoverySpecification(**point_in_time_recovery_specification)
         if isinstance(warm_throughput, dict):
             warm_throughput = WarmThroughput(**warm_throughput)
         if __debug__:
@@ -13000,6 +13153,7 @@ class TableProps(TableOptions):
             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 point_in_time_recovery_specification", value=point_in_time_recovery_specification, expected_type=type_hints["point_in_time_recovery_specification"])
             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"])
             check_type(argname="argument replication_regions", value=replication_regions, expected_type=type_hints["replication_regions"])
@@ -13037,6 +13191,8 @@ class TableProps(TableOptions):
             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 point_in_time_recovery_specification is not None:
+            self._values["point_in_time_recovery_specification"] = point_in_time_recovery_specification
         if read_capacity is not None:
             self._values["read_capacity"] = read_capacity
         if removal_policy is not None:
@@ -13183,13 +13339,28 @@ class TableProps(TableOptions):
 
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
-        '''Whether point-in-time recovery is enabled.
+        '''(deprecated) Whether point-in-time recovery is enabled.
 
-        :default: - point-in-time recovery is disabled
+        :default: false - point in time recovery is not enabled.
+
+        :deprecated: use ``pointInTimeRecoverySpecification`` instead
+
+        :stability: deprecated
         '''
         result = self._values.get("point_in_time_recovery")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def point_in_time_recovery_specification(
+        self,
+    ) -> typing.Optional[PointInTimeRecoverySpecification]:
+        '''Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.
+
+        :default: - point in time recovery is not enabled.
+        '''
+        result = self._values.get("point_in_time_recovery_specification")
+        return typing.cast(typing.Optional[PointInTimeRecoverySpecification], result)
+
     @builtins.property
     def read_capacity(self) -> typing.Optional[jsii.Number]:
         '''The read capacity for the table.
@@ -13372,6 +13543,7 @@ class TableProps(TableOptions):
         "deletion_protection": "deletionProtection",
         "kinesis_stream": "kinesisStream",
         "point_in_time_recovery": "pointInTimeRecovery",
+        "point_in_time_recovery_specification": "pointInTimeRecoverySpecification",
         "resource_policy": "resourcePolicy",
         "table_class": "tableClass",
         "tags": "tags",
@@ -13397,6 +13569,7 @@ class TablePropsV2(TableOptionsV2):
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
         table_class: typing.Optional[TableClass] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -13418,7 +13591,8 @@ class TablePropsV2(TableOptionsV2):
         :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
-        :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: false
+        :param point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :param resource_policy: Resource policy to assign to DynamoDB Table. Default: - No resource policy statements are added to the created table.
         :param table_class: The table class. Default: TableClass.STANDARD
         :param tags: Tags to be applied to the primary table (default replica table). Default: - no tags
@@ -13453,6 +13627,8 @@ class TablePropsV2(TableOptionsV2):
                 ]
             )
         '''
+        if isinstance(point_in_time_recovery_specification, dict):
+            point_in_time_recovery_specification = PointInTimeRecoverySpecification(**point_in_time_recovery_specification)
         if isinstance(partition_key, dict):
             partition_key = Attribute(**partition_key)
         if isinstance(sort_key, dict):
@@ -13465,6 +13641,7 @@ class TablePropsV2(TableOptionsV2):
             check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
             check_type(argname="argument kinesis_stream", value=kinesis_stream, expected_type=type_hints["kinesis_stream"])
             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 point_in_time_recovery_specification", value=point_in_time_recovery_specification, expected_type=type_hints["point_in_time_recovery_specification"])
             check_type(argname="argument resource_policy", value=resource_policy, expected_type=type_hints["resource_policy"])
             check_type(argname="argument table_class", value=table_class, expected_type=type_hints["table_class"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
@@ -13491,6 +13668,8 @@ class TablePropsV2(TableOptionsV2):
             self._values["kinesis_stream"] = kinesis_stream
         if point_in_time_recovery is not None:
             self._values["point_in_time_recovery"] = point_in_time_recovery
+        if point_in_time_recovery_specification is not None:
+            self._values["point_in_time_recovery_specification"] = point_in_time_recovery_specification
         if resource_policy is not None:
             self._values["resource_policy"] = resource_policy
         if table_class is not None:
@@ -13549,13 +13728,28 @@ class TablePropsV2(TableOptionsV2):
 
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
-        '''Whether point-in-time recovery is enabled.
+        '''(deprecated) Whether point-in-time recovery is enabled.
 
-        :default: false
+        :default: false - point in time recovery is not enabled.
+
+        :deprecated: use ``pointInTimeRecoverySpecification`` instead
+
+        :stability: deprecated
         '''
         result = self._values.get("point_in_time_recovery")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def point_in_time_recovery_specification(
+        self,
+    ) -> typing.Optional[PointInTimeRecoverySpecification]:
+        '''Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.
+
+        :default: - point in time recovery is not enabled.
+        '''
+        result = self._values.get("point_in_time_recovery_specification")
+        return typing.cast(typing.Optional[PointInTimeRecoverySpecification], result)
+
     @builtins.property
     def resource_policy(self) -> typing.Optional[_PolicyDocument_3ac34393]:
         '''Resource policy to assign to DynamoDB Table.
@@ -13766,6 +13960,7 @@ class TableV2(
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
         table_class: typing.Optional[TableClass] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -13788,7 +13983,8 @@ class TableV2(
         :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
-        :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: false
+        :param point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :param resource_policy: Resource policy to assign to DynamoDB Table. Default: - No resource policy statements are added to the created table.
         :param table_class: The table class. Default: TableClass.STANDARD
         :param tags: Tags to be applied to the primary table (default replica table). Default: - no tags
@@ -13814,6 +14010,7 @@ class TableV2(
             deletion_protection=deletion_protection,
             kinesis_stream=kinesis_stream,
             point_in_time_recovery=point_in_time_recovery,
+            point_in_time_recovery_specification=point_in_time_recovery_specification,
             resource_policy=resource_policy,
             table_class=table_class,
             tags=tags,
@@ -13993,6 +14190,7 @@ class TableV2(
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
         table_class: typing.Optional[TableClass] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -14008,7 +14206,8 @@ class TableV2(
         :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
-        :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: false
+        :param point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :param resource_policy: Resource policy to assign to DynamoDB Table. Default: - No resource policy statements are added to the created table.
         :param table_class: The table class. Default: TableClass.STANDARD
         :param tags: Tags to be applied to the primary table (default replica table). Default: - no tags
@@ -14022,6 +14221,7 @@ class TableV2(
             deletion_protection=deletion_protection,
             kinesis_stream=kinesis_stream,
             point_in_time_recovery=point_in_time_recovery,
+            point_in_time_recovery_specification=point_in_time_recovery_specification,
             resource_policy=resource_policy,
             table_class=table_class,
             tags=tags,
@@ -15196,6 +15396,7 @@ class OperationsMetricOptions(SystemErrorsForOperationsMetricOptions):
         "deletion_protection": "deletionProtection",
         "kinesis_stream": "kinesisStream",
         "point_in_time_recovery": "pointInTimeRecovery",
+        "point_in_time_recovery_specification": "pointInTimeRecoverySpecification",
         "resource_policy": "resourcePolicy",
         "table_class": "tableClass",
         "tags": "tags",
@@ -15213,6 +15414,7 @@ class ReplicaTableProps(TableOptionsV2):
         deletion_protection: typing.Optional[builtins.bool] = None,
         kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
         point_in_time_recovery: typing.Optional[builtins.bool] = None,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
         table_class: typing.Optional[TableClass] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -15226,7 +15428,8 @@ class ReplicaTableProps(TableOptionsV2):
         :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
-        :param point_in_time_recovery: Whether point-in-time recovery is enabled. Default: false
+        :param point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :param resource_policy: Resource policy to assign to DynamoDB Table. Default: - No resource policy statements are added to the created table.
         :param table_class: The table class. Default: TableClass.STANDARD
         :param tags: Tags to be applied to the primary table (default replica table). Default: - no tags
@@ -15252,12 +15455,15 @@ class ReplicaTableProps(TableOptionsV2):
             
             global_table.add_replica(region="us-east-2", deletion_protection=True)
         '''
+        if isinstance(point_in_time_recovery_specification, dict):
+            point_in_time_recovery_specification = PointInTimeRecoverySpecification(**point_in_time_recovery_specification)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7500a741eaeb840f48aaefcd8fc5fbbb8b1082165601116ca363e5ddbaa79e6f)
             check_type(argname="argument contributor_insights", value=contributor_insights, expected_type=type_hints["contributor_insights"])
             check_type(argname="argument deletion_protection", value=deletion_protection, expected_type=type_hints["deletion_protection"])
             check_type(argname="argument kinesis_stream", value=kinesis_stream, expected_type=type_hints["kinesis_stream"])
             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 point_in_time_recovery_specification", value=point_in_time_recovery_specification, expected_type=type_hints["point_in_time_recovery_specification"])
             check_type(argname="argument resource_policy", value=resource_policy, expected_type=type_hints["resource_policy"])
             check_type(argname="argument table_class", value=table_class, expected_type=type_hints["table_class"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
@@ -15276,6 +15482,8 @@ class ReplicaTableProps(TableOptionsV2):
             self._values["kinesis_stream"] = kinesis_stream
         if point_in_time_recovery is not None:
             self._values["point_in_time_recovery"] = point_in_time_recovery
+        if point_in_time_recovery_specification is not None:
+            self._values["point_in_time_recovery_specification"] = point_in_time_recovery_specification
         if resource_policy is not None:
             self._values["resource_policy"] = resource_policy
         if table_class is not None:
@@ -15318,13 +15526,28 @@ class ReplicaTableProps(TableOptionsV2):
 
     @builtins.property
     def point_in_time_recovery(self) -> typing.Optional[builtins.bool]:
-        '''Whether point-in-time recovery is enabled.
+        '''(deprecated) Whether point-in-time recovery is enabled.
 
-        :default: false
+        :default: false - point in time recovery is not enabled.
+
+        :deprecated: use ``pointInTimeRecoverySpecification`` instead
+
+        :stability: deprecated
         '''
         result = self._values.get("point_in_time_recovery")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def point_in_time_recovery_specification(
+        self,
+    ) -> typing.Optional[PointInTimeRecoverySpecification]:
+        '''Whether point-in-time recovery is enabled and recoveryPeriodInDays is set.
+
+        :default: - point in time recovery is not enabled.
+        '''
+        result = self._values.get("point_in_time_recovery_specification")
+        return typing.cast(typing.Optional[PointInTimeRecoverySpecification], result)
+
     @builtins.property
     def resource_policy(self) -> typing.Optional[_PolicyDocument_3ac34393]:
         '''Resource policy to assign to DynamoDB Table.
@@ -15457,6 +15680,7 @@ class Table(
         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,
+        point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
         read_capacity: typing.Optional[jsii.Number] = None,
         removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
         replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -15485,7 +15709,8 @@ class Table(
         :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 point_in_time_recovery: (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
+        :param point_in_time_recovery_specification: Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
         :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
         :param replication_regions: Regions where replica tables will be created. Default: - no replica tables are created
@@ -15517,6 +15742,7 @@ class Table(
             max_read_request_units=max_read_request_units,
             max_write_request_units=max_write_request_units,
             point_in_time_recovery=point_in_time_recovery,
+            point_in_time_recovery_specification=point_in_time_recovery_specification,
             read_capacity=read_capacity,
             removal_policy=removal_policy,
             replication_regions=replication_regions,
@@ -15878,6 +16104,7 @@ __all__ = [
     "MaxThroughputProps",
     "Operation",
     "OperationsMetricOptions",
+    "PointInTimeRecoverySpecification",
     "ProjectionType",
     "ReplicaGlobalSecondaryIndexOptions",
     "ReplicaTableProps",
@@ -16725,6 +16952,14 @@ def _typecheckingstub__be7ea0183d8be6420b32efcd6b8d4ab24e05bd813b7c0abb65a713b53
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__4073f2e85ef31d8deba5f90be11b466e4a3f1ea003482bf5c4df5706f50fbc77(
+    *,
+    point_in_time_recovery_enabled: builtins.bool,
+    recovery_period_in_days: typing.Optional[jsii.Number] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__eaa3a170e1978a5997011b8319bcd83bf34642dac50e342aad0705ee28b15714(
     *,
     contributor_insights: typing.Optional[builtins.bool] = None,
@@ -17032,6 +17267,7 @@ def _typecheckingstub__dadf5733fac70178ab246582a0b777b8c203659229753a8396594d751
     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,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -17053,6 +17289,7 @@ def _typecheckingstub__1b65ee3c8ef5c3b632f4d1fad233252caadaa5f607c0fd92f49b64933
     deletion_protection: typing.Optional[builtins.bool] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
     table_class: typing.Optional[TableClass] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17073,6 +17310,7 @@ def _typecheckingstub__00475a5e14af8c4c7049089f69b3d29ad81bc91e7e1f0a5a5b7b794a5
     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,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -17097,6 +17335,7 @@ def _typecheckingstub__205e5df85e01c6c2d91d5922a57e3ed5903027748a8b3222622bebd10
     deletion_protection: typing.Optional[builtins.bool] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
     table_class: typing.Optional[TableClass] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17136,6 +17375,7 @@ def _typecheckingstub__9ea47b003cdb497ff620f1410260696f97dbb2b00fa8558235f23771f
     deletion_protection: typing.Optional[builtins.bool] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
     table_class: typing.Optional[TableClass] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17280,6 +17520,7 @@ def _typecheckingstub__7500a741eaeb840f48aaefcd8fc5fbbb8b1082165601116ca363e5ddb
     deletion_protection: typing.Optional[builtins.bool] = None,
     kinesis_stream: typing.Optional[_IStream_4e2457d2] = None,
     point_in_time_recovery: typing.Optional[builtins.bool] = None,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     resource_policy: typing.Optional[_PolicyDocument_3ac34393] = None,
     table_class: typing.Optional[TableClass] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17307,6 +17548,7 @@ def _typecheckingstub__b92f0ed514f00b57a2a41d754e55fe495d22b05b0ad4711b80ce00457
     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,
+    point_in_time_recovery_specification: typing.Optional[typing.Union[PointInTimeRecoverySpecification, typing.Dict[builtins.str, typing.Any]]] = None,
     read_capacity: typing.Optional[jsii.Number] = None,
     removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
     replication_regions: typing.Optional[typing.Sequence[builtins.str]] = None,