aws-cdk-lib 2.75.1__py3-none-any.whl → 2.76.0__py3-none-any.whl

aws_cdk/aws_rds/__init__.py

@@ -341,19 +341,18 @@ Use the `storageType` property to specify the [type of storage](https://docs.aws
 to use for the instance:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # vpc: ec2.Vpc
 
 
 iops_instance = rds.DatabaseInstance(self, "IopsInstance",
-    engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+    engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
     vpc=vpc,
     storage_type=rds.StorageType.IO1,
     iops=5000
 )
 
 gp3_instance = rds.DatabaseInstance(self, "Gp3Instance",
-    engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+    engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
     vpc=vpc,
     allocated_storage=500,
     storage_type=rds.StorageType.GP3,
@@ -521,7 +520,7 @@ import aws_cdk as cdk
 # my_security_group: ec2.SecurityGroup
 
 instance.add_rotation_single_user(
-    automatically_after=cdk.Duration.days(7),  # defaults to 30 days
+    automatically_after=Duration.days(7),  # defaults to 30 days
     exclude_characters="!@#$%^&*",  # defaults to the set " %+~`#/// here*()|[]{}:;<>?!'/@\"\\"
     security_group=my_security_group
 )
@@ -17152,7 +17151,7 @@ class DatabaseClusterFromSnapshotProps:
         :param copy_tags_to_snapshot: Whether to copy tags to the snapshot when a snapshot is created. Default: - true
         :param credentials: (deprecated) Credentials for the administrative user. Note - using this prop only works with ``Credentials.fromPassword()`` with the username of the snapshot, ``Credentials.fromUsername()`` with the username and password of the snapshot or ``Credentials.fromSecret()`` with a secret containing the username and password of the snapshot. Default: - A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password that **will not be applied** to the cluster, use ``snapshotCredentials`` for the correct behavior.
         :param default_database_name: Name of a database which is automatically created inside the cluster. Default: - Database is not created in cluster.
-        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection. To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         :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 instances: How many replicas/instances to create. Has to be at least 1. Default: 2
@@ -17430,7 +17429,10 @@ class DatabaseClusterFromSnapshotProps:
     def deletion_protection(self) -> typing.Optional[builtins.bool]:
         '''Indicates whether the DB cluster should have deletion protection enabled.
 
-        :default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :default:
+
+        - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection.
+        To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         '''
         result = self._values.get("deletion_protection")
         return typing.cast(typing.Optional[builtins.bool], result)
@@ -17763,7 +17765,7 @@ class DatabaseClusterProps:
         :param copy_tags_to_snapshot: Whether to copy tags to the snapshot when a snapshot is created. Default: - true
         :param credentials: Credentials for the administrative user. Default: - A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password
         :param default_database_name: Name of a database which is automatically created inside the cluster. Default: - Database is not created in cluster.
-        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection. To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         :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 instances: How many replicas/instances to create. Has to be at least 1. Default: 2
@@ -18017,7 +18019,10 @@ class DatabaseClusterProps:
     def deletion_protection(self) -> typing.Optional[builtins.bool]:
         '''Indicates whether the DB cluster should have deletion protection enabled.
 
-        :default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :default:
+
+        - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection.
+        To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         '''
         result = self._values.get("deletion_protection")
         return typing.cast(typing.Optional[builtins.bool], result)
@@ -26192,19 +26197,18 @@ class MySqlInstanceEngineProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # vpc: ec2.Vpc
             
             
             iops_instance = rds.DatabaseInstance(self, "IopsInstance",
-                engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+                engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
                 vpc=vpc,
                 storage_type=rds.StorageType.IO1,
                 iops=5000
             )
             
             gp3_instance = rds.DatabaseInstance(self, "Gp3Instance",
-                engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+                engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
                 vpc=vpc,
                 allocated_storage=500,
                 storage_type=rds.StorageType.GP3,
@@ -26247,19 +26251,18 @@ class MysqlEngineVersion(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # vpc: ec2.Vpc
         
         
         iops_instance = rds.DatabaseInstance(self, "IopsInstance",
-            engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+            engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
             vpc=vpc,
             storage_type=rds.StorageType.IO1,
             iops=5000
         )
         
         gp3_instance = rds.DatabaseInstance(self, "Gp3Instance",
-            engine=rds.DatabaseInstanceEngine.mysql(version=MysqlEngineVersion.VER_8_0_30),
+            engine=rds.DatabaseInstanceEngine.mysql(version=rds.MysqlEngineVersion.VER_8_0_30),
             vpc=vpc,
             allocated_storage=500,
             storage_type=rds.StorageType.GP3,
@@ -29410,15 +29413,13 @@ class RotationSingleUserOptions(CommonRotationUserOptions):
 
         Example::
 
-            import aws_cdk as cdk
-            
             # instance: rds.DatabaseInstance
-            # my_security_group: ec2.SecurityGroup
+            # my_endpoint: ec2.InterfaceVpcEndpoint
+            
             
             instance.add_rotation_single_user(
-                automatically_after=cdk.Duration.days(7),  # defaults to 30 days
-                exclude_characters="!@#$%^&*",  # defaults to the set " %+~`#/// here*()|[]{}:;<>?!'/@\"\\"
-                security_group=my_security_group
+                vpc_subnets=ec2.SubnetSelection(subnet_type=ec2.SubnetType.PRIVATE_WITH_EGRESS),  # Place rotation Lambda in private subnets
+                endpoint=my_endpoint
             )
         '''
         if isinstance(vpc_subnets, dict):
@@ -33154,7 +33155,7 @@ class DatabaseClusterFromSnapshot(
         :param copy_tags_to_snapshot: Whether to copy tags to the snapshot when a snapshot is created. Default: - true
         :param credentials: (deprecated) Credentials for the administrative user. Note - using this prop only works with ``Credentials.fromPassword()`` with the username of the snapshot, ``Credentials.fromUsername()`` with the username and password of the snapshot or ``Credentials.fromSecret()`` with a secret containing the username and password of the snapshot. Default: - A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password that **will not be applied** to the cluster, use ``snapshotCredentials`` for the correct behavior.
         :param default_database_name: Name of a database which is automatically created inside the cluster. Default: - Database is not created in cluster.
-        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection. To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         :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 instances: How many replicas/instances to create. Has to be at least 1. Default: 2
@@ -36827,7 +36828,7 @@ class DatabaseCluster(
         :param copy_tags_to_snapshot: Whether to copy tags to the snapshot when a snapshot is created. Default: - true
         :param credentials: Credentials for the administrative user. Default: - A username of 'admin' (or 'postgres' for PostgreSQL) and SecretsManager-generated password
         :param default_database_name: Name of a database which is automatically created inside the cluster. Default: - Database is not created in cluster.
-        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, false otherwise
+        :param deletion_protection: Indicates whether the DB cluster should have deletion protection enabled. Default: - true if ``removalPolicy`` is RETAIN, ``undefined`` otherwise, which will not enable deletion protection. To disable deletion protection after it has been enabled, you must explicitly set this value to ``false``.
         :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 instances: How many replicas/instances to create. Has to be at least 1. Default: 2

aws_cdk/aws_route53/__init__.py

@@ -270,24 +270,21 @@ this construct sets up the private DNS configuration on the endpoint service,
 creates all the necessary Route53 entries, and verifies domain ownership.
 
 ```python
-from aws_cdk import Stack
-from aws_cdk.aws_ec2 import Vpc, VpcEndpointService
 from aws_cdk.aws_elasticloadbalancingv2 import NetworkLoadBalancer
-from aws_cdk.aws_route53 import PublicHostedZone, VpcEndpointServiceDomainName
 
-stack = Stack()
-vpc = Vpc(stack, "VPC")
-nlb = NetworkLoadBalancer(stack, "NLB",
+
+vpc = ec2.Vpc(self, "VPC")
+nlb = NetworkLoadBalancer(self, "NLB",
     vpc=vpc
 )
-vpces = VpcEndpointService(stack, "VPCES",
+vpces = ec2.VpcEndpointService(self, "VPCES",
     vpc_endpoint_service_load_balancers=[nlb]
 )
 # You must use a public hosted zone so domain ownership can be verified
-zone = PublicHostedZone(stack, "PHZ",
+zone = route53.PublicHostedZone(self, "PHZ",
     zone_name="aws-cdk.dev"
 )
-VpcEndpointServiceDomainName(stack, "EndpointDomain",
+route53.VpcEndpointServiceDomainName(self, "EndpointDomain",
     endpoint_service=vpces,
     domain_name="my-stuff.aws-cdk.dev",
     public_hosted_zone=zone
@@ -1255,7 +1252,7 @@ class CfnHealthCheck(
             :param regions: A complex type that contains one ``Region`` element for each region from which you want Amazon Route 53 health checkers to check the specified endpoint. If you don't specify any regions, Route 53 health checkers automatically performs checks from all of the regions that are listed under *Valid Values* . If you update a health check to remove a region that has been performing health checks, Route 53 will briefly continue to perform checks from that region to ensure that some health checkers are always checking the endpoint (for example, if you replace three regions with four different regions).
             :param request_interval: The number of seconds between the time that Amazon Route 53 gets a response from your endpoint and the time that it sends the next health check request. Each Route 53 health checker makes requests at this interval. .. epigraph:: You can't change the value of ``RequestInterval`` after you create a health check. If you don't specify a value for ``RequestInterval`` , the default value is ``30`` seconds.
             :param resource_path: The path, if any, that you want Amazon Route 53 to request when performing health checks. The path can be any value for which your endpoint will return an HTTP status code of 2xx or 3xx when the endpoint is healthy, for example, the file /docs/route53-health-check.html. You can also include query string parameters, for example, ``/welcome.html?language=jp&login=y`` .
-            :param routing_control_arn: The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control. For more information about Route 53 Application Recovery Controller, see `Route 53 Application Recovery Controller Developer Guide. <https://docs.aws.amazon.com/r53recovery/latest/dg/what-is-route-53-recovery.html>`_ .
+            :param routing_control_arn: ``CfnHealthCheck.HealthCheckConfigProperty.RoutingControlArn``.
             :param search_string: If the value of Type is ``HTTP_STR_MATCH`` or ``HTTPS_STR_MATCH`` , the string that you want Amazon Route 53 to search for in the response body from the specified resource. If the string appears in the response body, Route 53 considers the resource healthy. Route 53 considers case when searching for ``SearchString`` in the response body.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-healthcheck-healthcheckconfig.html
@@ -1601,9 +1598,7 @@ class CfnHealthCheck(
 
         @builtins.property
         def routing_control_arn(self) -> typing.Optional[builtins.str]:
-            '''The Amazon Resource Name (ARN) for the Route 53 Application Recovery Controller routing control.
-
-            For more information about Route 53 Application Recovery Controller, see `Route 53 Application Recovery Controller Developer Guide. <https://docs.aws.amazon.com/r53recovery/latest/dg/what-is-route-53-recovery.html>`_ .
+            '''``CfnHealthCheck.HealthCheckConfigProperty.RoutingControlArn``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-route53-healthcheck-healthcheckconfig.html#cfn-route53-healthcheck-healthcheckconfig-routingcontrolarn
             '''
@@ -7922,7 +7917,6 @@ class VpcEndpointServiceDomainName(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         from aws_cdk.aws_route53 import HostedZone, VpcEndpointServiceDomainName
         # zone: HostedZone
         # vpces: ec2.VpcEndpointService
@@ -8004,7 +7998,6 @@ class VpcEndpointServiceDomainNameProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             from aws_cdk.aws_route53 import HostedZone, VpcEndpointServiceDomainName
             # zone: HostedZone
             # vpces: ec2.VpcEndpointService
@@ -10265,7 +10258,6 @@ class PublicHostedZone(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         stack1 = Stack(app, "Stack1",
             env=Environment(
                 region="us-east-1"

aws_cdk/aws_route53_targets/__init__.py

@@ -20,8 +20,7 @@ This library contains Route53 Alias Record targets for:
 * API Gateway V2 custom domains
 
   ```python
-  # Example automatically generated from non-compiling source. May contain errors.
-  import aws_cdk.aws_apigatewayv2 as apigwv2
+  import aws_cdk.aws_apigatewayv2_alpha as apigwv2
 
   # zone: route53.HostedZone
   # domain_name: apigwv2.DomainName
@@ -280,8 +279,7 @@ class ApiGatewayv2DomainProperties(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
-        import aws_cdk.aws_apigatewayv2 as apigwv2
+        import aws_cdk.aws_apigatewayv2_alpha as apigwv2
         
         # zone: route53.HostedZone
         # domain_name: apigwv2.DomainName