aws-cdk-lib 2.194.0__py3-none-any.whl → 2.196.0__py3-none-any.whl

aws_cdk/aws_route53_targets/__init__.py

@@ -225,6 +225,47 @@ route53.ARecord(self, "AliasRecord",
 )
 ```
 
+If Elastic Beanstalk environment URL is not avaiable at synth time, you can specify Hosted Zone ID of the target
+
+```python
+from aws_cdk.region_info import RegionInfo
+
+# zone: route53.HostedZone
+# ebs_environment_url: str
+
+
+route53.ARecord(self, "AliasRecord",
+    zone=zone,
+    target=route53.RecordTarget.from_alias(
+        targets.ElasticBeanstalkEnvironmentEndpointTarget(ebs_environment_url, {
+            "hosted_zone_id": RegionInfo.get("us-east-1").ebs_env_endpoint_hosted_zone_id
+        }))
+)
+```
+
+Or you can specify Stack region for CDK to generate the correct Hosted Zone ID.
+
+```python
+from aws_cdk import App
+
+# app: App
+# zone: route53.HostedZone
+# ebs_environment_url: str
+
+
+stack = Stack(app, "my-stack",
+    env=Environment(
+        region="us-east-1"
+    )
+)
+
+route53.ARecord(stack, "AliasRecord",
+    zone=zone,
+    target=route53.RecordTarget.from_alias(
+        targets.ElasticBeanstalkEnvironmentEndpointTarget(ebs_environment_url))
+)
+```
+
 See the documentation of `aws-cdk-lib/aws-route53` for more information.
 '''
 from pkgutil import extend_path
@@ -652,6 +693,8 @@ class ElasticBeanstalkEnvironmentEndpointTarget(
 
     Example::
 
+        from aws_cdk.region_info import RegionInfo
+        
         # zone: route53.HostedZone
         # ebs_environment_url: str
         
@@ -660,7 +703,7 @@ class ElasticBeanstalkEnvironmentEndpointTarget(
             zone=zone,
             target=route53.RecordTarget.from_alias(
                 targets.ElasticBeanstalkEnvironmentEndpointTarget(ebs_environment_url, {
-                    "evaluate_target_health": True
+                    "hosted_zone_id": RegionInfo.get("us-east-1").ebs_env_endpoint_hosted_zone_id
                 }))
         )
     '''
@@ -818,6 +861,15 @@ class IAliasRecordTargetProps(typing_extensions.Protocol):
         '''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="hostedZoneId")
+    def hosted_zone_id(self) -> typing.Optional[builtins.str]:
+        '''Target Hosted zone ID.
+
+        :default: - hosted zone ID for the EBS endpoint will be retrieved based on the stack's region.
+        '''
+        ...
+
 
 class _IAliasRecordTargetPropsProxy:
     '''Properties the alias record target.'''
@@ -833,6 +885,15 @@ class _IAliasRecordTargetPropsProxy:
         '''
         return typing.cast(typing.Optional[builtins.bool], jsii.get(self, "evaluateTargetHealth"))
 
+    @builtins.property
+    @jsii.member(jsii_name="hostedZoneId")
+    def hosted_zone_id(self) -> typing.Optional[builtins.str]:
+        '''Target Hosted zone ID.
+
+        :default: - hosted zone ID for the EBS endpoint will be retrieved based on the stack's region.
+        '''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "hostedZoneId"))
+
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
 typing.cast(typing.Any, IAliasRecordTargetProps).__jsii_proxy_class__ = lambda : _IAliasRecordTargetPropsProxy
 

aws_cdk/aws_route53profiles/__init__.py

@@ -714,7 +714,7 @@ class CfnProfileResourceAssociation(
     @builtins.property
     @jsii.member(jsii_name="attrResourceType")
     def attr_resource_type(self) -> builtins.str:
-        '''Resource type, such as a private hosted zone, or DNS Firewall rule group.
+        '''Resource type, such as a private hosted zone, interface VPC endpoint, or DNS Firewall rule group.
 
         :cloudformationAttribute: ResourceType
         '''

aws_cdk/aws_s3/__init__.py

@@ -183,8 +183,8 @@ To use a bucket in a different stack in the same CDK application, pass the objec
 #
 class Producer(Stack):
 
-    def __init__(self, scope, id, *, description=None, env=None, stackName=None, tags=None, notificationArns=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None, suppressTemplateIndentation=None):
-        super().__init__(scope, id, description=description, env=env, stackName=stackName, tags=tags, notificationArns=notificationArns, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary, suppressTemplateIndentation=suppressTemplateIndentation)
+    def __init__(self, scope, id, *, description=None, env=None, stackName=None, tags=None, notificationArns=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None, suppressTemplateIndentation=None, propertyInjectors=None):
+        super().__init__(scope, id, description=description, env=env, stackName=stackName, tags=tags, notificationArns=notificationArns, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary, suppressTemplateIndentation=suppressTemplateIndentation, propertyInjectors=propertyInjectors)
 
         bucket = s3.Bucket(self, "MyBucket",
             removal_policy=cdk.RemovalPolicy.DESTROY
@@ -195,8 +195,8 @@ class Producer(Stack):
 # Stack that consumes the bucket
 #
 class Consumer(Stack):
-    def __init__(self, scope, id, *, userBucket, description=None, env=None, stackName=None, tags=None, notificationArns=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None, suppressTemplateIndentation=None):
-        super().__init__(scope, id, userBucket=userBucket, description=description, env=env, stackName=stackName, tags=tags, notificationArns=notificationArns, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary, suppressTemplateIndentation=suppressTemplateIndentation)
+    def __init__(self, scope, id, *, userBucket, description=None, env=None, stackName=None, tags=None, notificationArns=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None, suppressTemplateIndentation=None, propertyInjectors=None):
+        super().__init__(scope, id, userBucket=userBucket, description=description, env=env, stackName=stackName, tags=tags, notificationArns=notificationArns, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary, suppressTemplateIndentation=suppressTemplateIndentation, propertyInjectors=propertyInjectors)
 
         user = iam.User(self, "MyUser")
         user_bucket.grant_read_write(user)
@@ -360,19 +360,19 @@ bucket = s3.Bucket(self, "MyBlockedBucket",
 )
 ```
 
-Block and ignore public ACLs:
+Block and ignore public ACLs (other options remain unblocked):
 
 ```python
 bucket = s3.Bucket(self, "MyBlockedBucket",
-    block_public_access=s3.BlockPublicAccess.BLOCK_ACLS
+    block_public_access=s3.BlockPublicAccess.BLOCK_ACLS_ONLY
 )
 ```
 
-Alternatively, specify the settings manually:
+Alternatively, specify the settings manually (unspecified options will remain blocked):
 
 ```python
 bucket = s3.Bucket(self, "MyBlockedBucket",
-    block_public_access=s3.BlockPublicAccess(block_public_policy=True)
+    block_public_access=s3.BlockPublicAccess(block_public_policy=False)
 )
 ```
 
@@ -1075,7 +1075,7 @@ class BlockPublicAccess(
     Example::
 
         bucket = s3.Bucket(self, "MyBlockedBucket",
-            block_public_access=s3.BlockPublicAccess.BLOCK_ALL
+            block_public_access=s3.BlockPublicAccess(block_public_policy=False)
         )
     '''
 
@@ -1105,11 +1105,26 @@ class BlockPublicAccess(
     @jsii.python.classproperty
     @jsii.member(jsii_name="BLOCK_ACLS")
     def BLOCK_ACLS(cls) -> "BlockPublicAccess":
+        '''
+        :deprecated: Use ``BLOCK_ACLS_ONLY`` instead.
+
+        :stability: deprecated
+        '''
         return typing.cast("BlockPublicAccess", jsii.sget(cls, "BLOCK_ACLS"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="BLOCK_ACLS_ONLY")
+    def BLOCK_ACLS_ONLY(cls) -> "BlockPublicAccess":
+        '''Use this option if you want to only block the ACLs, using this will set blockPublicPolicy and restrictPublicBuckets to false.'''
+        return typing.cast("BlockPublicAccess", jsii.sget(cls, "BLOCK_ACLS_ONLY"))
+
     @jsii.python.classproperty
     @jsii.member(jsii_name="BLOCK_ALL")
     def BLOCK_ALL(cls) -> "BlockPublicAccess":
+        '''Use this option if you want to ensure every public access method is blocked.
+
+        However keep in mind that this is the default state of an S3 bucket, and leaving blockPublicAccess undefined would also work.
+        '''
         return typing.cast("BlockPublicAccess", jsii.sget(cls, "BLOCK_ALL"))
 
     @builtins.property
@@ -1191,7 +1206,7 @@ class BlockPublicAccessOptions:
         Example::
 
             bucket = s3.Bucket(self, "MyBlockedBucket",
-                block_public_access=s3.BlockPublicAccess(block_public_policy=True)
+                block_public_access=s3.BlockPublicAccess(block_public_policy=False)
             )
         '''
         if __debug__:
@@ -1919,6 +1934,12 @@ class BucketPolicy(
             check_type(argname="argument removal_policy", value=removal_policy, expected_type=type_hints["removal_policy"])
         return typing.cast(None, jsii.invoke(self, "applyRemovalPolicy", [removal_policy]))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
     @builtins.property
     @jsii.member(jsii_name="bucket")
     def bucket(self) -> "IBucket":
@@ -21035,6 +21056,12 @@ class Bucket(
 
         return typing.cast(None, jsii.invoke(self, "addMetric", [metric]))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
     @builtins.property
     @jsii.member(jsii_name="bucketArn")
     def bucket_arn(self) -> builtins.str:

aws_cdk/aws_s3_deployment/__init__.py

@@ -781,6 +781,12 @@ class BucketDeployment(
             check_type(argname="argument source", value=source, expected_type=type_hints["source"])
         return typing.cast(None, jsii.invoke(self, "addSource", [source]))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
     @builtins.property
     @jsii.member(jsii_name="deployedBucket")
     def deployed_bucket(self) -> _IBucket_42e086fd:

aws_cdk/aws_s3_notifications/__init__.py

@@ -173,7 +173,7 @@ class SnsDestination(
     @jsii.member(jsii_name="bind")
     def bind(
         self,
-        _scope: _constructs_77d1e7e8.Construct,
+        scope: _constructs_77d1e7e8.Construct,
         bucket: _IBucket_42e086fd,
     ) -> _BucketNotificationDestinationConfig_a4c4f83d:
         '''Registers this resource to receive notifications for the specified bucket.
@@ -182,14 +182,14 @@ class SnsDestination(
         pair and the result will be cached, so there is no need to implement
         idempotency in each destination.
 
-        :param _scope: -
+        :param scope: -
         :param bucket: -
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__3553ece4b599ce7e526b55722477cb04771e1907840471521f08a9dbdea726a1)
-            check_type(argname="argument _scope", value=_scope, expected_type=type_hints["_scope"])
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
             check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
-        return typing.cast(_BucketNotificationDestinationConfig_a4c4f83d, jsii.invoke(self, "bind", [_scope, bucket]))
+        return typing.cast(_BucketNotificationDestinationConfig_a4c4f83d, jsii.invoke(self, "bind", [scope, bucket]))
 
 
 @jsii.implements(_IBucketNotificationDestination_ae5ca51a)
@@ -268,7 +268,7 @@ def _typecheckingstub__88bc302a2eb7b4d1c7dc00b1564ab4c536d2626942f2cec60d543582b
     pass
 
 def _typecheckingstub__3553ece4b599ce7e526b55722477cb04771e1907840471521f08a9dbdea726a1(
-    _scope: _constructs_77d1e7e8.Construct,
+    scope: _constructs_77d1e7e8.Construct,
     bucket: _IBucket_42e086fd,
 ) -> None:
     """Type checking stubs"""