aws-cdk-lib 2.187.0__py3-none-any.whl → 2.189.0__py3-none-any.whl

aws_cdk/aws_rds/__init__.py

@@ -153,6 +153,20 @@ rds.DatabaseCluster(self, "DatabaseCluster",
 )
 ```
 
+To configure [the life cycle type of the cluster](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html), use the `engineLifecycleSupport` property:
+
+```python
+# vpc: ec2.IVpc
+
+
+rds.DatabaseCluster(self, "DatabaseCluster",
+    engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_07_0),
+    writer=rds.ClusterInstance.serverless_v2("writerInstance"),
+    vpc=vpc,
+    engine_lifecycle_support=rds.EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT
+)
+```
+
 ### Updating the database instances in a cluster
 
 Database cluster instances may be updated in bulk or on a rolling basis.
@@ -21128,6 +21142,7 @@ class DatabaseClusterEngine(
         "enable_data_api": "enableDataApi",
         "enable_local_write_forwarding": "enableLocalWriteForwarding",
         "enable_performance_insights": "enablePerformanceInsights",
+        "engine_lifecycle_support": "engineLifecycleSupport",
         "iam_authentication": "iamAuthentication",
         "instance_identifier_base": "instanceIdentifierBase",
         "instance_props": "instanceProps",
@@ -21187,6 +21202,7 @@ class DatabaseClusterFromSnapshotProps:
         enable_data_api: typing.Optional[builtins.bool] = None,
         enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
         enable_performance_insights: typing.Optional[builtins.bool] = None,
+        engine_lifecycle_support: typing.Optional["EngineLifecycleSupport"] = None,
         iam_authentication: typing.Optional[builtins.bool] = None,
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_props: typing.Optional[typing.Union["InstanceProps", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -21243,6 +21259,7 @@ class DatabaseClusterFromSnapshotProps:
         :param enable_data_api: Whether to enable the Data API for the cluster. Default: - false
         :param enable_local_write_forwarding: Whether read replicas can forward write operations to the writer DB instance in the DB cluster. This setting can only be enabled for Aurora MySQL 3.04 or higher, and for Aurora PostgreSQL 16.4 or higher (for version 16), 15.8 or higher (for version 15), and 14.13 or higher (for version 14). Default: false
         :param enable_performance_insights: Whether to enable Performance Insights for the DB cluster. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set, or ``databaseInsightsMode`` is set to ``DatabaseInsightsMode.ADVANCED``.
+        :param engine_lifecycle_support: The life cycle type for this DB cluster. Default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
         :param iam_authentication: Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. Default: false
         :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - clusterIdentifier is used with the word "Instance" appended. If clusterIdentifier is not provided, the identifier is automatically generated.
         :param instance_props: (deprecated) Settings for the individual instances that are launched.
@@ -21318,6 +21335,7 @@ class DatabaseClusterFromSnapshotProps:
             check_type(argname="argument enable_data_api", value=enable_data_api, expected_type=type_hints["enable_data_api"])
             check_type(argname="argument enable_local_write_forwarding", value=enable_local_write_forwarding, expected_type=type_hints["enable_local_write_forwarding"])
             check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
+            check_type(argname="argument engine_lifecycle_support", value=engine_lifecycle_support, expected_type=type_hints["engine_lifecycle_support"])
             check_type(argname="argument iam_authentication", value=iam_authentication, expected_type=type_hints["iam_authentication"])
             check_type(argname="argument instance_identifier_base", value=instance_identifier_base, expected_type=type_hints["instance_identifier_base"])
             check_type(argname="argument instance_props", value=instance_props, expected_type=type_hints["instance_props"])
@@ -21393,6 +21411,8 @@ class DatabaseClusterFromSnapshotProps:
             self._values["enable_local_write_forwarding"] = enable_local_write_forwarding
         if enable_performance_insights is not None:
             self._values["enable_performance_insights"] = enable_performance_insights
+        if engine_lifecycle_support is not None:
+            self._values["engine_lifecycle_support"] = engine_lifecycle_support
         if iam_authentication is not None:
             self._values["iam_authentication"] = iam_authentication
         if instance_identifier_base is not None:
@@ -21711,6 +21731,17 @@ class DatabaseClusterFromSnapshotProps:
         result = self._values.get("enable_performance_insights")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def engine_lifecycle_support(self) -> typing.Optional["EngineLifecycleSupport"]:
+        '''The life cycle type for this DB cluster.
+
+        :default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
+
+        :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html
+        '''
+        result = self._values.get("engine_lifecycle_support")
+        return typing.cast(typing.Optional["EngineLifecycleSupport"], result)
+
     @builtins.property
     def iam_authentication(self) -> typing.Optional[builtins.bool]:
         '''Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
@@ -22108,6 +22139,7 @@ class DatabaseClusterFromSnapshotProps:
         "enable_data_api": "enableDataApi",
         "enable_local_write_forwarding": "enableLocalWriteForwarding",
         "enable_performance_insights": "enablePerformanceInsights",
+        "engine_lifecycle_support": "engineLifecycleSupport",
         "iam_authentication": "iamAuthentication",
         "instance_identifier_base": "instanceIdentifierBase",
         "instance_props": "instanceProps",
@@ -22166,6 +22198,7 @@ class DatabaseClusterProps:
         enable_data_api: typing.Optional[builtins.bool] = None,
         enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
         enable_performance_insights: typing.Optional[builtins.bool] = None,
+        engine_lifecycle_support: typing.Optional["EngineLifecycleSupport"] = None,
         iam_authentication: typing.Optional[builtins.bool] = None,
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_props: typing.Optional[typing.Union["InstanceProps", typing.Dict[builtins.str, typing.Any]]] = None,
@@ -22221,6 +22254,7 @@ class DatabaseClusterProps:
         :param enable_data_api: Whether to enable the Data API for the cluster. Default: - false
         :param enable_local_write_forwarding: Whether read replicas can forward write operations to the writer DB instance in the DB cluster. This setting can only be enabled for Aurora MySQL 3.04 or higher, and for Aurora PostgreSQL 16.4 or higher (for version 16), 15.8 or higher (for version 15), and 14.13 or higher (for version 14). Default: false
         :param enable_performance_insights: Whether to enable Performance Insights for the DB cluster. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set, or ``databaseInsightsMode`` is set to ``DatabaseInsightsMode.ADVANCED``.
+        :param engine_lifecycle_support: The life cycle type for this DB cluster. Default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
         :param iam_authentication: Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. Default: false
         :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - clusterIdentifier is used with the word "Instance" appended. If clusterIdentifier is not provided, the identifier is automatically generated.
         :param instance_props: (deprecated) Settings for the individual instances that are launched.
@@ -22304,6 +22338,7 @@ class DatabaseClusterProps:
             check_type(argname="argument enable_data_api", value=enable_data_api, expected_type=type_hints["enable_data_api"])
             check_type(argname="argument enable_local_write_forwarding", value=enable_local_write_forwarding, expected_type=type_hints["enable_local_write_forwarding"])
             check_type(argname="argument enable_performance_insights", value=enable_performance_insights, expected_type=type_hints["enable_performance_insights"])
+            check_type(argname="argument engine_lifecycle_support", value=engine_lifecycle_support, expected_type=type_hints["engine_lifecycle_support"])
             check_type(argname="argument iam_authentication", value=iam_authentication, expected_type=type_hints["iam_authentication"])
             check_type(argname="argument instance_identifier_base", value=instance_identifier_base, expected_type=type_hints["instance_identifier_base"])
             check_type(argname="argument instance_props", value=instance_props, expected_type=type_hints["instance_props"])
@@ -22378,6 +22413,8 @@ class DatabaseClusterProps:
             self._values["enable_local_write_forwarding"] = enable_local_write_forwarding
         if enable_performance_insights is not None:
             self._values["enable_performance_insights"] = enable_performance_insights
+        if engine_lifecycle_support is not None:
+            self._values["engine_lifecycle_support"] = engine_lifecycle_support
         if iam_authentication is not None:
             self._values["iam_authentication"] = iam_authentication
         if instance_identifier_base is not None:
@@ -22673,6 +22710,17 @@ class DatabaseClusterProps:
         result = self._values.get("enable_performance_insights")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def engine_lifecycle_support(self) -> typing.Optional["EngineLifecycleSupport"]:
+        '''The life cycle type for this DB cluster.
+
+        :default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
+
+        :see: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html
+        '''
+        result = self._values.get("engine_lifecycle_support")
+        return typing.cast(typing.Optional["EngineLifecycleSupport"], result)
+
     @builtins.property
     def iam_authentication(self) -> typing.Optional[builtins.bool]:
         '''Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts.
@@ -27328,6 +27376,31 @@ class Endpoint(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_rds.Endpoint"
         return typing.cast(builtins.str, jsii.get(self, "socketAddress"))
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_rds.EngineLifecycleSupport")
+class EngineLifecycleSupport(enum.Enum):
+    '''Engine lifecycle support for Amazon RDS and Amazon Aurora.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # vpc: ec2.IVpc
+        
+        
+        rds.DatabaseCluster(self, "DatabaseCluster",
+            engine=rds.DatabaseClusterEngine.aurora_mysql(version=rds.AuroraMysqlEngineVersion.VER_3_07_0),
+            writer=rds.ClusterInstance.serverless_v2("writerInstance"),
+            vpc=vpc,
+            engine_lifecycle_support=rds.EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT
+        )
+    '''
+
+    OPEN_SOURCE_RDS_EXTENDED_SUPPORT = "OPEN_SOURCE_RDS_EXTENDED_SUPPORT"
+    '''Using Amazon RDS extended support.'''
+    OPEN_SOURCE_RDS_EXTENDED_SUPPORT_DISABLED = "OPEN_SOURCE_RDS_EXTENDED_SUPPORT_DISABLED"
+    '''Not using Amazon RDS extended support.'''
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_rds.EngineVersion",
     jsii_struct_bases=[],
@@ -42217,6 +42290,7 @@ class DatabaseClusterFromSnapshot(
         enable_data_api: typing.Optional[builtins.bool] = None,
         enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
         enable_performance_insights: typing.Optional[builtins.bool] = None,
+        engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
         iam_authentication: typing.Optional[builtins.bool] = None,
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -42274,6 +42348,7 @@ class DatabaseClusterFromSnapshot(
         :param enable_data_api: Whether to enable the Data API for the cluster. Default: - false
         :param enable_local_write_forwarding: Whether read replicas can forward write operations to the writer DB instance in the DB cluster. This setting can only be enabled for Aurora MySQL 3.04 or higher, and for Aurora PostgreSQL 16.4 or higher (for version 16), 15.8 or higher (for version 15), and 14.13 or higher (for version 14). Default: false
         :param enable_performance_insights: Whether to enable Performance Insights for the DB cluster. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set, or ``databaseInsightsMode`` is set to ``DatabaseInsightsMode.ADVANCED``.
+        :param engine_lifecycle_support: The life cycle type for this DB cluster. Default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
         :param iam_authentication: Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. Default: false
         :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - clusterIdentifier is used with the word "Instance" appended. If clusterIdentifier is not provided, the identifier is automatically generated.
         :param instance_props: (deprecated) Settings for the individual instances that are launched.
@@ -42333,6 +42408,7 @@ class DatabaseClusterFromSnapshot(
             enable_data_api=enable_data_api,
             enable_local_write_forwarding=enable_local_write_forwarding,
             enable_performance_insights=enable_performance_insights,
+            engine_lifecycle_support=engine_lifecycle_support,
             iam_authentication=iam_authentication,
             instance_identifier_base=instance_identifier_base,
             instance_props=instance_props,
@@ -46374,6 +46450,7 @@ class DatabaseCluster(
         enable_data_api: typing.Optional[builtins.bool] = None,
         enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
         enable_performance_insights: typing.Optional[builtins.bool] = None,
+        engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
         iam_authentication: typing.Optional[builtins.bool] = None,
         instance_identifier_base: typing.Optional[builtins.str] = None,
         instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -46430,6 +46507,7 @@ class DatabaseCluster(
         :param enable_data_api: Whether to enable the Data API for the cluster. Default: - false
         :param enable_local_write_forwarding: Whether read replicas can forward write operations to the writer DB instance in the DB cluster. This setting can only be enabled for Aurora MySQL 3.04 or higher, and for Aurora PostgreSQL 16.4 or higher (for version 16), 15.8 or higher (for version 15), and 14.13 or higher (for version 14). Default: false
         :param enable_performance_insights: Whether to enable Performance Insights for the DB cluster. Default: - false, unless ``performanceInsightRetention`` or ``performanceInsightEncryptionKey`` is set, or ``databaseInsightsMode`` is set to ``DatabaseInsightsMode.ADVANCED``.
+        :param engine_lifecycle_support: The life cycle type for this DB cluster. Default: undefined - AWS RDS default setting is ``EngineLifecycleSupport.OPEN_SOURCE_RDS_EXTENDED_SUPPORT``
         :param iam_authentication: Whether to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. Default: false
         :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - clusterIdentifier is used with the word "Instance" appended. If clusterIdentifier is not provided, the identifier is automatically generated.
         :param instance_props: (deprecated) Settings for the individual instances that are launched.
@@ -46488,6 +46566,7 @@ class DatabaseCluster(
             enable_data_api=enable_data_api,
             enable_local_write_forwarding=enable_local_write_forwarding,
             enable_performance_insights=enable_performance_insights,
+            engine_lifecycle_support=engine_lifecycle_support,
             iam_authentication=iam_authentication,
             instance_identifier_base=instance_identifier_base,
             instance_props=instance_props,
@@ -47415,6 +47494,7 @@ __all__ = [
     "DatabaseSecret",
     "DatabaseSecretProps",
     "Endpoint",
+    "EngineLifecycleSupport",
     "EngineVersion",
     "IAuroraClusterInstance",
     "IClusterEngine",
@@ -50189,6 +50269,7 @@ def _typecheckingstub__1e44b5aef872ca17869a17181382f06cd0166bdbe07e2c33701d3bf1e
     enable_data_api: typing.Optional[builtins.bool] = None,
     enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
     enable_performance_insights: typing.Optional[builtins.bool] = None,
+    engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
     iam_authentication: typing.Optional[builtins.bool] = None,
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -50247,6 +50328,7 @@ def _typecheckingstub__a32e21c90ab65d3cfdb3b7ef2a0d741ba1528ec8824cd1817d1e485b4
     enable_data_api: typing.Optional[builtins.bool] = None,
     enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
     enable_performance_insights: typing.Optional[builtins.bool] = None,
+    engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
     iam_authentication: typing.Optional[builtins.bool] = None,
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -51475,6 +51557,7 @@ def _typecheckingstub__d1a2e259091e12a41b0f5818df495769518e049ebcc89ed340ffc7ba4
     enable_data_api: typing.Optional[builtins.bool] = None,
     enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
     enable_performance_insights: typing.Optional[builtins.bool] = None,
+    engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
     iam_authentication: typing.Optional[builtins.bool] = None,
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -51972,6 +52055,7 @@ def _typecheckingstub__c6184cbbefaa372690b9776dafecbf5857cf9bfbab91d1666aad22c56
     enable_data_api: typing.Optional[builtins.bool] = None,
     enable_local_write_forwarding: typing.Optional[builtins.bool] = None,
     enable_performance_insights: typing.Optional[builtins.bool] = None,
+    engine_lifecycle_support: typing.Optional[EngineLifecycleSupport] = None,
     iam_authentication: typing.Optional[builtins.bool] = None,
     instance_identifier_base: typing.Optional[builtins.str] = None,
     instance_props: typing.Optional[typing.Union[InstanceProps, typing.Dict[builtins.str, typing.Any]]] = None,

aws_cdk/aws_redshiftserverless/__init__.py

@@ -1272,7 +1272,11 @@ class CfnWorkgroup(
                 status="status"
             ),
             publicly_accessible=False,
+            recovery_point_id="recoveryPointId",
             security_group_ids=["securityGroupIds"],
+            snapshot_arn="snapshotArn",
+            snapshot_name="snapshotName",
+            snapshot_owner_account="snapshotOwnerAccount",
             subnet_ids=["subnetIds"],
             tags=[CfnTag(
                 key="key",
@@ -1333,7 +1337,11 @@ class CfnWorkgroup(
         port: typing.Optional[jsii.Number] = None,
         price_performance_target: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnWorkgroup.PerformanceTargetProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         publicly_accessible: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        recovery_point_id: typing.Optional[builtins.str] = None,
         security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
+        snapshot_arn: typing.Optional[builtins.str] = None,
+        snapshot_name: typing.Optional[builtins.str] = None,
+        snapshot_owner_account: typing.Optional[builtins.str] = None,
         subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         track_name: typing.Optional[builtins.str] = None,
@@ -1351,7 +1359,11 @@ class CfnWorkgroup(
         :param port: The custom port to use when connecting to a workgroup. Valid port ranges are 5431-5455 and 8191-8215. The default is 5439.
         :param price_performance_target: An object that represents the price performance target settings for the workgroup.
         :param publicly_accessible: A value that specifies whether the workgroup can be accessible from a public network. Default: - false
+        :param recovery_point_id: The recovery point id to restore from.
         :param security_group_ids: A list of security group IDs to associate with the workgroup.
+        :param snapshot_arn: The Amazon Resource Name (ARN) of the snapshot to restore from.
+        :param snapshot_name: The snapshot name to restore from.
+        :param snapshot_owner_account: The owner AWS ; account of the snapshot.
         :param subnet_ids: A list of subnet IDs the workgroup is associated with.
         :param tags: The map of the key-value pairs used to tag the workgroup.
         :param track_name: An optional parameter for the name of the track for the workgroup. If you don't provide a track name, the workgroup is assigned to the current track.
@@ -1371,7 +1383,11 @@ class CfnWorkgroup(
             port=port,
             price_performance_target=price_performance_target,
             publicly_accessible=publicly_accessible,
+            recovery_point_id=recovery_point_id,
             security_group_ids=security_group_ids,
+            snapshot_arn=snapshot_arn,
+            snapshot_name=snapshot_name,
+            snapshot_owner_account=snapshot_owner_account,
             subnet_ids=subnet_ids,
             tags=tags,
             track_name=track_name,
@@ -1717,6 +1733,19 @@ class CfnWorkgroup(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "publiclyAccessible", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="recoveryPointId")
+    def recovery_point_id(self) -> typing.Optional[builtins.str]:
+        '''The recovery point id to restore from.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "recoveryPointId"))
+
+    @recovery_point_id.setter
+    def recovery_point_id(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__330f25021814c2fb98578117b6d4b45cb103383dd78a1ec221ad5ee1da1af776)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "recoveryPointId", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="securityGroupIds")
     def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
@@ -1733,6 +1762,45 @@ class CfnWorkgroup(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "securityGroupIds", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="snapshotArn")
+    def snapshot_arn(self) -> typing.Optional[builtins.str]:
+        '''The Amazon Resource Name (ARN) of the snapshot to restore from.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "snapshotArn"))
+
+    @snapshot_arn.setter
+    def snapshot_arn(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__22c9552850e931e5526d6b100685f6e372509370d50247f9134b09b667c31905)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "snapshotArn", value) # pyright: ignore[reportArgumentType]
+
+    @builtins.property
+    @jsii.member(jsii_name="snapshotName")
+    def snapshot_name(self) -> typing.Optional[builtins.str]:
+        '''The snapshot name to restore from.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "snapshotName"))
+
+    @snapshot_name.setter
+    def snapshot_name(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9001e412e7a006803ae5b51d6b1ec1486aa95db2939acfaa5b88a397dfaf1e7b)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "snapshotName", value) # pyright: ignore[reportArgumentType]
+
+    @builtins.property
+    @jsii.member(jsii_name="snapshotOwnerAccount")
+    def snapshot_owner_account(self) -> typing.Optional[builtins.str]:
+        '''The owner AWS ;'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "snapshotOwnerAccount"))
+
+    @snapshot_owner_account.setter
+    def snapshot_owner_account(self, value: typing.Optional[builtins.str]) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e20f0edef13cea8274ed0af3c59774d9e6b1dc49c1c6cd25ad2a5807f42500fe)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "snapshotOwnerAccount", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="subnetIds")
     def subnet_ids(self) -> typing.Optional[typing.List[builtins.str]]:
@@ -2584,7 +2652,11 @@ class CfnWorkgroup(
         "port": "port",
         "price_performance_target": "pricePerformanceTarget",
         "publicly_accessible": "publiclyAccessible",
+        "recovery_point_id": "recoveryPointId",
         "security_group_ids": "securityGroupIds",
+        "snapshot_arn": "snapshotArn",
+        "snapshot_name": "snapshotName",
+        "snapshot_owner_account": "snapshotOwnerAccount",
         "subnet_ids": "subnetIds",
         "tags": "tags",
         "track_name": "trackName",
@@ -2604,7 +2676,11 @@ class CfnWorkgroupProps:
         port: typing.Optional[jsii.Number] = None,
         price_performance_target: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnWorkgroup.PerformanceTargetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
         publicly_accessible: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        recovery_point_id: typing.Optional[builtins.str] = None,
         security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
+        snapshot_arn: typing.Optional[builtins.str] = None,
+        snapshot_name: typing.Optional[builtins.str] = None,
+        snapshot_owner_account: typing.Optional[builtins.str] = None,
         subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         track_name: typing.Optional[builtins.str] = None,
@@ -2621,7 +2697,11 @@ class CfnWorkgroupProps:
         :param port: The custom port to use when connecting to a workgroup. Valid port ranges are 5431-5455 and 8191-8215. The default is 5439.
         :param price_performance_target: An object that represents the price performance target settings for the workgroup.
         :param publicly_accessible: A value that specifies whether the workgroup can be accessible from a public network. Default: - false
+        :param recovery_point_id: The recovery point id to restore from.
         :param security_group_ids: A list of security group IDs to associate with the workgroup.
+        :param snapshot_arn: The Amazon Resource Name (ARN) of the snapshot to restore from.
+        :param snapshot_name: The snapshot name to restore from.
+        :param snapshot_owner_account: The owner AWS ; account of the snapshot.
         :param subnet_ids: A list of subnet IDs the workgroup is associated with.
         :param tags: The map of the key-value pairs used to tag the workgroup.
         :param track_name: An optional parameter for the name of the track for the workgroup. If you don't provide a track name, the workgroup is assigned to the current track.
@@ -2654,7 +2734,11 @@ class CfnWorkgroupProps:
                     status="status"
                 ),
                 publicly_accessible=False,
+                recovery_point_id="recoveryPointId",
                 security_group_ids=["securityGroupIds"],
+                snapshot_arn="snapshotArn",
+                snapshot_name="snapshotName",
+                snapshot_owner_account="snapshotOwnerAccount",
                 subnet_ids=["subnetIds"],
                 tags=[CfnTag(
                     key="key",
@@ -2711,7 +2795,11 @@ class CfnWorkgroupProps:
             check_type(argname="argument port", value=port, expected_type=type_hints["port"])
             check_type(argname="argument price_performance_target", value=price_performance_target, expected_type=type_hints["price_performance_target"])
             check_type(argname="argument publicly_accessible", value=publicly_accessible, expected_type=type_hints["publicly_accessible"])
+            check_type(argname="argument recovery_point_id", value=recovery_point_id, expected_type=type_hints["recovery_point_id"])
             check_type(argname="argument security_group_ids", value=security_group_ids, expected_type=type_hints["security_group_ids"])
+            check_type(argname="argument snapshot_arn", value=snapshot_arn, expected_type=type_hints["snapshot_arn"])
+            check_type(argname="argument snapshot_name", value=snapshot_name, expected_type=type_hints["snapshot_name"])
+            check_type(argname="argument snapshot_owner_account", value=snapshot_owner_account, expected_type=type_hints["snapshot_owner_account"])
             check_type(argname="argument subnet_ids", value=subnet_ids, expected_type=type_hints["subnet_ids"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
             check_type(argname="argument track_name", value=track_name, expected_type=type_hints["track_name"])
@@ -2735,8 +2823,16 @@ class CfnWorkgroupProps:
             self._values["price_performance_target"] = price_performance_target
         if publicly_accessible is not None:
             self._values["publicly_accessible"] = publicly_accessible
+        if recovery_point_id is not None:
+            self._values["recovery_point_id"] = recovery_point_id
         if security_group_ids is not None:
             self._values["security_group_ids"] = security_group_ids
+        if snapshot_arn is not None:
+            self._values["snapshot_arn"] = snapshot_arn
+        if snapshot_name is not None:
+            self._values["snapshot_name"] = snapshot_name
+        if snapshot_owner_account is not None:
+            self._values["snapshot_owner_account"] = snapshot_owner_account
         if subnet_ids is not None:
             self._values["subnet_ids"] = subnet_ids
         if tags is not None:
@@ -2846,6 +2942,15 @@ class CfnWorkgroupProps:
         result = self._values.get("publicly_accessible")
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
 
+    @builtins.property
+    def recovery_point_id(self) -> typing.Optional[builtins.str]:
+        '''The recovery point id to restore from.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshiftserverless-workgroup.html#cfn-redshiftserverless-workgroup-recoverypointid
+        '''
+        result = self._values.get("recovery_point_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
         '''A list of security group IDs to associate with the workgroup.
@@ -2855,6 +2960,35 @@ class CfnWorkgroupProps:
         result = self._values.get("security_group_ids")
         return typing.cast(typing.Optional[typing.List[builtins.str]], result)
 
+    @builtins.property
+    def snapshot_arn(self) -> typing.Optional[builtins.str]:
+        '''The Amazon Resource Name (ARN) of the snapshot to restore from.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshiftserverless-workgroup.html#cfn-redshiftserverless-workgroup-snapshotarn
+        '''
+        result = self._values.get("snapshot_arn")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def snapshot_name(self) -> typing.Optional[builtins.str]:
+        '''The snapshot name to restore from.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshiftserverless-workgroup.html#cfn-redshiftserverless-workgroup-snapshotname
+        '''
+        result = self._values.get("snapshot_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def snapshot_owner_account(self) -> typing.Optional[builtins.str]:
+        '''The owner AWS ;
+
+        account of the snapshot.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-redshiftserverless-workgroup.html#cfn-redshiftserverless-workgroup-snapshotowneraccount
+        '''
+        result = self._values.get("snapshot_owner_account")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def subnet_ids(self) -> typing.Optional[typing.List[builtins.str]]:
         '''A list of subnet IDs the workgroup is associated with.
@@ -3111,7 +3245,11 @@ def _typecheckingstub__61a1b6ebbdacc577619f4e17ddabdaa553ffe5fe072b72e14ddf7d9c3
     port: typing.Optional[jsii.Number] = None,
     price_performance_target: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnWorkgroup.PerformanceTargetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     publicly_accessible: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    recovery_point_id: typing.Optional[builtins.str] = None,
     security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
+    snapshot_arn: typing.Optional[builtins.str] = None,
+    snapshot_name: typing.Optional[builtins.str] = None,
+    snapshot_owner_account: typing.Optional[builtins.str] = None,
     subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     track_name: typing.Optional[builtins.str] = None,
@@ -3186,12 +3324,36 @@ def _typecheckingstub__974542b0d8aa6c1847dd536dcf795ef2c4719aed798ea365b0767f6ad
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__330f25021814c2fb98578117b6d4b45cb103383dd78a1ec221ad5ee1da1af776(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__b2864d0fac41ac305963b5532a731665cbc0d93a810a41ea2d2fe98a5285e8aa(
     value: typing.Optional[typing.List[builtins.str]],
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__22c9552850e931e5526d6b100685f6e372509370d50247f9134b09b667c31905(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__9001e412e7a006803ae5b51d6b1ec1486aa95db2939acfaa5b88a397dfaf1e7b(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e20f0edef13cea8274ed0af3c59774d9e6b1dc49c1c6cd25ad2a5807f42500fe(
+    value: typing.Optional[builtins.str],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__67e139cef151f144f2bb04082850da469be0ab0515cff591edf9fc1e44df78a9(
     value: typing.Optional[typing.List[builtins.str]],
 ) -> None:
@@ -3293,7 +3455,11 @@ def _typecheckingstub__1ee3941005026bdab05d38183c12cc7cf5ff218e6db3877161b60d823
     port: typing.Optional[jsii.Number] = None,
     price_performance_target: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnWorkgroup.PerformanceTargetProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     publicly_accessible: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    recovery_point_id: typing.Optional[builtins.str] = None,
     security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
+    snapshot_arn: typing.Optional[builtins.str] = None,
+    snapshot_name: typing.Optional[builtins.str] = None,
+    snapshot_owner_account: typing.Optional[builtins.str] = None,
     subnet_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     track_name: typing.Optional[builtins.str] = None,

aws_cdk/aws_route53/__init__.py

@@ -2254,7 +2254,7 @@ class CfnHostedZone(
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param hosted_zone_config: A complex type that contains an optional comment. If you don't want to specify a comment, omit the ``HostedZoneConfig`` and ``Comment`` elements.
-        :param hosted_zone_tags: Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *AWS Billing and Cost Management User Guide* .
+        :param hosted_zone_tags: Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *Billing and Cost Management User Guide* .
         :param name: The name of the domain. Specify a fully qualified domain name, for example, *www.example.com* . The trailing dot is optional; Amazon Route 53 assumes that the domain name is fully qualified. This means that Route 53 treats *www.example.com* (without a trailing dot) and *www.example.com.* (with a trailing dot) as identical. If you're creating a public hosted zone, this is the name you have registered with your DNS registrar. If your domain name is registered with a registrar other than Route 53, change the name servers for your domain to the set of ``NameServers`` that are returned by the ``Fn::GetAtt`` intrinsic function.
         :param query_logging_config: Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group. DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following: - Route 53 edge location that responded to the DNS query - Domain or subdomain that was requested - DNS record type, such as A or AAAA - DNS response code, such as ``NoError`` or ``ServFail`` - **Log Group and Resource Policy** - Before you create a query logging configuration, perform the following operations. .. epigraph:: If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically. - Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following: - You must create the log group in the us-east-1 region. - You must use the same AWS account to create the log group and the hosted zone that you want to configure query logging for. - When you create log groups for query logging, we recommend that you use a consistent prefix, for example: ``/aws/route53/ *hosted zone name*`` In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated AWS resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging. - Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to send query logs to log streams. You must create the CloudWatch Logs resource policy in the us-east-1 region. For the value of ``Resource`` , specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with ``*`` , for example: ``arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*`` To avoid the confused deputy problem, a security issue where an entity without a permission for an action can coerce a more-privileged entity to perform it, you can optionally limit the permissions that a service has to a resource in a resource-based policy by supplying the following values: - For ``aws:SourceArn`` , supply the hosted zone ARN used in creating the query logging configuration. For example, ``aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID`` . - For ``aws:SourceAccount`` , supply the account ID for the account that creates the query logging configuration. For example, ``aws:SourceAccount:111111111111`` . For more information, see `The confused deputy problem <https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html>`_ in the *AWS IAM User Guide* . .. epigraph:: You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the AWS SDKs, or the AWS CLI . - **Log Streams and Edge Locations** - When Route 53 finishes creating the configuration for DNS query logging, it does the following: - Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location. - Begins to send query logs to the applicable log stream. The name of each log stream is in the following format: ``*hosted zone ID* / *edge location code*`` The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see "The Route 53 Global Network" on the `Route 53 Product Details <https://docs.aws.amazon.com/route53/details/>`_ page. - **Queries That Are Logged** - Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see `Routing Internet Traffic to Your Website or Web Application <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/welcome-dns-service.html>`_ in the *Amazon Route 53 Developer Guide* . - **Log File Format** - For a list of the values in each query log and the format of each value, see `Logging DNS Queries <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html>`_ in the *Amazon Route 53 Developer Guide* . - **Pricing** - For information about charges for query logs, see `Amazon CloudWatch Pricing <https://docs.aws.amazon.com/cloudwatch/pricing/>`_ . - **How to Stop Logging** - If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see `DeleteQueryLoggingConfig <https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteQueryLoggingConfig.html>`_ .
         :param vpcs: *Private hosted zones:* A complex type that contains information about the VPCs that are associated with the specified hosted zone. .. epigraph:: For public hosted zones, omit ``VPCs`` , ``VPCId`` , and ``VPCRegion`` .
@@ -2702,7 +2702,7 @@ class CfnHostedZoneProps:
         '''Properties for defining a ``CfnHostedZone``.
 
         :param hosted_zone_config: A complex type that contains an optional comment. If you don't want to specify a comment, omit the ``HostedZoneConfig`` and ``Comment`` elements.
-        :param hosted_zone_tags: Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *AWS Billing and Cost Management User Guide* .
+        :param hosted_zone_tags: Adds, edits, or deletes tags for a health check or a hosted zone. For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *Billing and Cost Management User Guide* .
         :param name: The name of the domain. Specify a fully qualified domain name, for example, *www.example.com* . The trailing dot is optional; Amazon Route 53 assumes that the domain name is fully qualified. This means that Route 53 treats *www.example.com* (without a trailing dot) and *www.example.com.* (with a trailing dot) as identical. If you're creating a public hosted zone, this is the name you have registered with your DNS registrar. If your domain name is registered with a registrar other than Route 53, change the name servers for your domain to the set of ``NameServers`` that are returned by the ``Fn::GetAtt`` intrinsic function.
         :param query_logging_config: Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group. DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following: - Route 53 edge location that responded to the DNS query - Domain or subdomain that was requested - DNS record type, such as A or AAAA - DNS response code, such as ``NoError`` or ``ServFail`` - **Log Group and Resource Policy** - Before you create a query logging configuration, perform the following operations. .. epigraph:: If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically. - Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following: - You must create the log group in the us-east-1 region. - You must use the same AWS account to create the log group and the hosted zone that you want to configure query logging for. - When you create log groups for query logging, we recommend that you use a consistent prefix, for example: ``/aws/route53/ *hosted zone name*`` In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated AWS resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging. - Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to send query logs to log streams. You must create the CloudWatch Logs resource policy in the us-east-1 region. For the value of ``Resource`` , specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with ``*`` , for example: ``arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*`` To avoid the confused deputy problem, a security issue where an entity without a permission for an action can coerce a more-privileged entity to perform it, you can optionally limit the permissions that a service has to a resource in a resource-based policy by supplying the following values: - For ``aws:SourceArn`` , supply the hosted zone ARN used in creating the query logging configuration. For example, ``aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID`` . - For ``aws:SourceAccount`` , supply the account ID for the account that creates the query logging configuration. For example, ``aws:SourceAccount:111111111111`` . For more information, see `The confused deputy problem <https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html>`_ in the *AWS IAM User Guide* . .. epigraph:: You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the AWS SDKs, or the AWS CLI . - **Log Streams and Edge Locations** - When Route 53 finishes creating the configuration for DNS query logging, it does the following: - Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location. - Begins to send query logs to the applicable log stream. The name of each log stream is in the following format: ``*hosted zone ID* / *edge location code*`` The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see "The Route 53 Global Network" on the `Route 53 Product Details <https://docs.aws.amazon.com/route53/details/>`_ page. - **Queries That Are Logged** - Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see `Routing Internet Traffic to Your Website or Web Application <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/welcome-dns-service.html>`_ in the *Amazon Route 53 Developer Guide* . - **Log File Format** - For a list of the values in each query log and the format of each value, see `Logging DNS Queries <https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html>`_ in the *Amazon Route 53 Developer Guide* . - **Pricing** - For information about charges for query logs, see `Amazon CloudWatch Pricing <https://docs.aws.amazon.com/cloudwatch/pricing/>`_ . - **How to Stop Logging** - If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see `DeleteQueryLoggingConfig <https://docs.aws.amazon.com/Route53/latest/APIReference/API_DeleteQueryLoggingConfig.html>`_ .
         :param vpcs: *Private hosted zones:* A complex type that contains information about the VPCs that are associated with the specified hosted zone. .. epigraph:: For public hosted zones, omit ``VPCs`` , ``VPCId`` , and ``VPCRegion`` .
@@ -2772,7 +2772,7 @@ class CfnHostedZoneProps:
     ) -> typing.Optional[typing.List[CfnHostedZone.HostedZoneTagProperty]]:
         '''Adds, edits, or deletes tags for a health check or a hosted zone.
 
-        For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *AWS Billing and Cost Management User Guide* .
+        For information about using tags for cost allocation, see `Using Cost Allocation Tags <https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html>`_ in the *Billing and Cost Management User Guide* .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-route53-hostedzone.html#cfn-route53-hostedzone-hostedzonetags
         '''