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

aws_cdk/aws_s3/__init__.py

@@ -1,10 +1,9 @@
 '''
 # Amazon S3 Construct Library
 
-Define an unencrypted S3 bucket.
+Define an S3 bucket.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyFirstBucket")
 ```
 
@@ -34,7 +33,6 @@ bucket = s3.Bucket(self, "MyFirstBucket")
 Define a KMS-encrypted bucket:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyEncryptedBucket",
     encryption=s3.BucketEncryption.KMS
 )
@@ -46,7 +44,6 @@ assert(bucket.encryption_key instanceof kms.Key)
 You can also supply your own key:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 my_kms_key = kms.Key(self, "MyKey")
 
 bucket = s3.Bucket(self, "MyEncryptedBucket",
@@ -60,7 +57,6 @@ assert(bucket.encryption_key == my_kms_key)
 Enable KMS-SSE encryption via [S3 Bucket Keys](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html):
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyEncryptedBucket",
     encryption=s3.BucketEncryption.KMS,
     bucket_key_enabled=True
@@ -70,7 +66,6 @@ bucket = s3.Bucket(self, "MyEncryptedBucket",
 Use `BucketEncryption.ManagedKms` to use the S3 master KMS key:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "Buck",
     encryption=s3.BucketEncryption.KMS_MANAGED
 )
@@ -84,7 +79,6 @@ A bucket policy will be automatically created for the bucket upon the first call
 `addToResourcePolicy(statement)`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket")
 result = bucket.add_to_resource_policy(
     iam.PolicyStatement(
@@ -98,7 +92,6 @@ If you try to add a policy statement to an existing bucket, this method will
 not do anything:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket.from_bucket_name(self, "existingBucket", "bucket-name")
 
 # No policy statement will be added to the resource
@@ -115,7 +108,6 @@ already has a policy attached, let alone to re-use that policy to add more
 statements to it. We recommend that you always check the result of the call:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket")
 result = bucket.add_to_resource_policy(
     iam.PolicyStatement(
@@ -132,7 +124,6 @@ The bucket policy can be directly accessed after creation to add statements or
 adjust the removal policy.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket")
 bucket.policy.apply_removal_policy(cdk.RemovalPolicy.RETAIN)
 ```
@@ -142,7 +133,6 @@ Instead, buckets have "grant" methods called to give prepackaged sets of permiss
 to other resources. For example:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_lambda: lambda.Function
 
 
@@ -160,7 +150,6 @@ from the bucket.
 To require all requests use Secure Socket Layer (SSL):
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "Bucket",
     enforce_sSL=True
 )
@@ -171,11 +160,10 @@ bucket = s3.Bucket(self, "Bucket",
 To use a bucket in a different stack in the same CDK application, pass the object to the other stack:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 #
 # Stack that defines the bucket
 #
-class Producer(cdk.Stack):
+class Producer(Stack):
 
     def __init__(self, scope, id, *, description=None, env=None, stackName=None, tags=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None):
         super().__init__(scope, id, description=description, env=env, stackName=stackName, tags=tags, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary)
@@ -188,13 +176,14 @@ class Producer(cdk.Stack):
 #
 # Stack that consumes the bucket
 #
-class Consumer(cdk.Stack):
+class Consumer(Stack):
     def __init__(self, scope, id, *, userBucket, description=None, env=None, stackName=None, tags=None, synthesizer=None, terminationProtection=None, analyticsReporting=None, crossRegionReferences=None, permissionsBoundary=None):
         super().__init__(scope, id, userBucket=userBucket, description=description, env=env, stackName=stackName, tags=tags, synthesizer=synthesizer, terminationProtection=terminationProtection, analyticsReporting=analyticsReporting, crossRegionReferences=crossRegionReferences, permissionsBoundary=permissionsBoundary)
 
         user = iam.User(self, "MyUser")
         user_bucket.grant_read_write(user)
 
+app = App()
 producer = Producer(app, "ProducerStack")
 Consumer(app, "ConsumerStack", user_bucket=producer.my_bucket)
 ```
@@ -206,7 +195,6 @@ factory method. This method accepts `BucketAttributes` which describes the prope
 existing bucket:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_lambda: lambda.Function
 
 bucket = s3.Bucket.from_bucket_attributes(self, "ImportedBucket",
@@ -224,7 +212,6 @@ Alternatively, short-hand factories are available as `Bucket.fromBucketName` and
 name or ARN respectively:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 by_name = s3.Bucket.from_bucket_name(self, "BucketByName", "my-bucket")
 by_arn = s3.Bucket.from_bucket_arn(self, "BucketByArn", "arn:aws:s3:::my-bucket")
 ```
@@ -233,7 +220,6 @@ The bucket's region defaults to the current stack's region, but can also be expl
 regional properties needs to contain the correct values.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 my_cross_region_bucket = s3.Bucket.from_bucket_attributes(self, "CrossRegionImport",
     bucket_arn="arn:aws:s3:::my-bucket",
     region="us-east-1"
@@ -253,7 +239,6 @@ these common use cases.
 The following example will subscribe an SNS topic to be notified of all `s3:ObjectCreated:*` events:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket")
 topic = sns.Topic(self, "MyTopic")
 bucket.add_event_notification(s3.EventType.OBJECT_CREATED, s3n.SnsDestination(topic))
@@ -269,7 +254,6 @@ following example will notify `myQueue` when objects prefixed with `foo/` and
 have the `.jpg` suffix are removed from the bucket.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_queue: sqs.Queue
 
 bucket = s3.Bucket(self, "MyBucket")
@@ -282,7 +266,6 @@ bucket.add_event_notification(s3.EventType.OBJECT_REMOVED, s3n.SqsDestination(my
 Adding notifications on existing buckets:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # topic: sns.Topic
 
 bucket = s3.Bucket.from_bucket_attributes(self, "ImportedBucket",
@@ -297,7 +280,6 @@ function that implements this feature. If you want to use your own role instead,
 you should provide it in the `Bucket` constructor:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # my_role: iam.IRole
 
 bucket = s3.Bucket(self, "MyBucket",
@@ -312,7 +294,6 @@ If you’re passing an imported role, and you don’t want this to happen, confi
 it to be immutable:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 imported_role = iam.Role.from_role_arn(self, "role", "arn:aws:iam::123456789012:role/RoleName",
     mutable=False
 )
@@ -329,7 +310,6 @@ Unlike other destinations, you don't need to select which event types you want t
 The following example will enable EventBridge notifications:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyEventBridgeBucket",
     event_bridge_enabled=True
 )
@@ -342,7 +322,6 @@ Use `blockPublicAccess` to specify [block public access settings](https://docs.a
 Enable all block public access settings:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBlockedBucket",
     block_public_access=s3.BlockPublicAccess.BLOCK_ALL
 )
@@ -351,7 +330,6 @@ bucket = s3.Bucket(self, "MyBlockedBucket",
 Block and ignore public ACLs:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBlockedBucket",
     block_public_access=s3.BlockPublicAccess.BLOCK_ACLS
 )
@@ -360,7 +338,6 @@ bucket = s3.Bucket(self, "MyBlockedBucket",
 Alternatively, specify the settings manually:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBlockedBucket",
     block_public_access=s3.BlockPublicAccess(block_public_policy=True)
 )
@@ -373,7 +350,6 @@ When `blockPublicPolicy` is set to `true`, `grantPublicRead()` throws an error.
 Use `serverAccessLogsBucket` to describe where server access logs are to be stored.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 access_logs_bucket = s3.Bucket(self, "AccessLogsBucket")
 
 bucket = s3.Bucket(self, "MyBucket",
@@ -384,7 +360,6 @@ bucket = s3.Bucket(self, "MyBucket",
 It's also possible to specify a prefix for Amazon S3 to assign to all log object keys.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 access_logs_bucket = s3.Bucket(self, "AccessLogsBucket")
 
 bucket = s3.Bucket(self, "MyBucket",
@@ -403,7 +378,6 @@ bucket support using bucket policy instead of ACLs), you can set object ownershi
 to [bucket owner enforced](#bucket-owner-enforced-recommended), as is recommended.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 access_logs_bucket = s3.Bucket(self, "AccessLogsBucket",
     object_ownership=s3.ObjectOwnership.BUCKET_OWNER_ENFORCED
 )
@@ -421,7 +395,6 @@ An [inventory](https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory
 You can configure multiple inventory lists for a bucket. You can configure what object metadata to include in the inventory, whether to list all object versions or only current versions, where to store the inventory list file output, and whether to generate the inventory on a daily or weekly basis.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 inventory_bucket = s3.Bucket(self, "InventoryBucket")
 
 data_bucket = s3.Bucket(self, "DataBucket",
@@ -470,7 +443,6 @@ You can use the two following properties to specify the bucket [redirection poli
 You can statically redirect a to a given Bucket URL or any other host name with `websiteRedirect`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyRedirectedBucket",
     website_redirect=s3.RedirectTarget(host_name="www.example.com")
 )
@@ -481,7 +453,6 @@ bucket = s3.Bucket(self, "MyRedirectedBucket",
 Alternatively, you can also define multiple `websiteRoutingRules`, to define complex, conditional redirections:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyRedirectedBucket",
     website_routing_rules=[s3.RoutingRule(
         host_name="www.example.com",
@@ -514,7 +485,6 @@ We recommend to use Virtual Hosted-Style URL for newly made bucket.
 You can generate both of them.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket")
 bucket.url_for_object("objectname") # Path-Style URL
 bucket.virtual_hosted_url_for_object("objectname") # Virtual Hosted-Style URL
@@ -530,7 +500,6 @@ You can use one of following properties to specify the bucket [object Ownership]
 The Uploading account will own the object.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 s3.Bucket(self, "MyBucket",
     object_ownership=s3.ObjectOwnership.OBJECT_WRITER
 )
@@ -541,7 +510,6 @@ s3.Bucket(self, "MyBucket",
 The bucket owner will own the object if the object is uploaded with the bucket-owner-full-control canned ACL. Without this setting and canned ACL, the object is uploaded and remains owned by the uploading account.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 s3.Bucket(self, "MyBucket",
     object_ownership=s3.ObjectOwnership.BUCKET_OWNER_PREFERRED
 )
@@ -554,7 +522,6 @@ over every object in the bucket. ACLs no longer affect permissions to data in th
 S3 bucket. The bucket uses policies to define access control.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 s3.Bucket(self, "MyBucket",
     object_ownership=s3.ObjectOwnership.BUCKET_OWNER_ENFORCED
 )
@@ -577,7 +544,6 @@ To override this and force all objects to get deleted during bucket deletion,
 enable the`autoDeleteObjects` option.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyTempFileBucket",
     removal_policy=cdk.RemovalPolicy.DESTROY,
     auto_delete_objects=True
@@ -594,7 +560,6 @@ by deploying with CDK version `1.126.0` or later **before** switching this value
 [Transfer Acceleration](https://docs.aws.amazon.com/AmazonS3/latest/userguide/transfer-acceleration.html) can be configured to enable fast, easy, and secure transfers of files over long distances:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket",
     transfer_acceleration=True
 )
@@ -603,7 +568,6 @@ bucket = s3.Bucket(self, "MyBucket",
 To access the bucket that is enabled for Transfer Acceleration, you must use a special endpoint. The URL can be generated using method `transferAccelerationUrlForObject`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket",
     transfer_acceleration=True
 )
@@ -615,13 +579,12 @@ bucket.transfer_acceleration_url_for_object("objectname")
 [Intelligent Tiering](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intelligent-tiering.html) can be configured to automatically move files to glacier:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 s3.Bucket(self, "MyBucket",
     intelligent_tiering_configurations=[s3.IntelligentTieringConfiguration(
         name="foo",
         prefix="folder/name",
-        archive_access_tier_time=cdk.Duration.days(90),
-        deep_archive_access_tier_time=cdk.Duration.days(180),
+        archive_access_tier_time=Duration.days(90),
+        deep_archive_access_tier_time=Duration.days(180),
         tags=[s3.Tag(key="tagname", value="tagvalue")]
     )
     ]
@@ -633,22 +596,21 @@ s3.Bucket(self, "MyBucket",
 [Managing lifecycle](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) can be configured transition or expiration actions.
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket",
     lifecycle_rules=[s3.LifecycleRule(
-        abort_incomplete_multipart_upload_after=cdk.Duration.minutes(30),
+        abort_incomplete_multipart_upload_after=Duration.minutes(30),
         enabled=False,
-        expiration=cdk.Duration.days(30),
+        expiration=Duration.days(30),
         expiration_date=Date(),
         expired_object_delete_marker=False,
         id="id",
-        noncurrent_version_expiration=cdk.Duration.days(30),
+        noncurrent_version_expiration=Duration.days(30),
 
         # the properties below are optional
         noncurrent_versions_to_retain=123,
         noncurrent_version_transitions=[s3.NoncurrentVersionTransition(
             storage_class=s3.StorageClass.GLACIER,
-            transition_after=cdk.Duration.days(30),
+            transition_after=Duration.days(30),
 
             # the properties below are optional
             noncurrent_versions_to_retain=123
@@ -661,7 +623,7 @@ bucket = s3.Bucket(self, "MyBucket",
             storage_class=s3.StorageClass.GLACIER,
 
             # the properties below are optional
-            transition_after=cdk.Duration.days(30),
+            transition_after=Duration.days(30),
             transition_date=Date()
         )
         ]
@@ -680,7 +642,6 @@ enabled later via the CDK.
 Object Lock can be enabled on an S3 bucket by specifying:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 bucket = s3.Bucket(self, "MyBucket",
     object_lock_enabled=True
 )
@@ -692,15 +653,14 @@ and a [retention period](https://docs.aws.amazon.com/AmazonS3/latest/userguide/o
 These can be specified by providing `objectLockDefaultRetention`:
 
 ```python
-# Example automatically generated from non-compiling source. May contain errors.
 # Configure for governance mode with a duration of 7 years
 s3.Bucket(self, "Bucket1",
-    object_lock_default_retention=s3.ObjectLockRetention.governance(cdk.Duration.days(7 * 365))
+    object_lock_default_retention=s3.ObjectLockRetention.governance(Duration.days(7 * 365))
 )
 
 # Configure for compliance mode with a duration of 1 year
 s3.Bucket(self, "Bucket2",
-    object_lock_default_retention=s3.ObjectLockRetention.compliance(cdk.Duration.days(365))
+    object_lock_default_retention=s3.ObjectLockRetention.compliance(Duration.days(365))
 )
 ```
 '''
@@ -758,7 +718,6 @@ class BlockPublicAccess(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyBlockedBucket",
             block_public_access=s3.BlockPublicAccess.BLOCK_ALL
         )
@@ -875,7 +834,6 @@ class BlockPublicAccessOptions:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             bucket = s3.Bucket(self, "MyBlockedBucket",
                 block_public_access=s3.BlockPublicAccess(block_public_policy=True)
             )
@@ -1075,7 +1033,6 @@ class BucketAttributes:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_lambda: lambda.Function
             
             bucket = s3.Bucket.from_bucket_attributes(self, "ImportedBucket",
@@ -1267,7 +1224,6 @@ class BucketEncryption(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyEncryptedBucket",
             encryption=s3.BucketEncryption.KMS
         )
@@ -1277,7 +1233,18 @@ class BucketEncryption(enum.Enum):
     '''
 
     UNENCRYPTED = "UNENCRYPTED"
-    '''Objects in the bucket are not encrypted.'''
+    '''(deprecated) Previous option.
+
+    Buckets can not be unencrypted now.
+
+    :deprecated:
+
+    S3 applies server-side encryption with SSE-S3 for every bucket
+    that default encryption is not configured.
+
+    :see: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
+    :stability: deprecated
+    '''
     KMS_MANAGED = "KMS_MANAGED"
     '''Server-side KMS encryption with a master key managed by KMS.'''
     S3_MANAGED = "S3_MANAGED"
@@ -1716,7 +1683,7 @@ class BucketProps:
         :param bucket_key_enabled: Whether Amazon S3 should use its own intermediary key to generate data keys. Only relevant when using KMS for encryption. - If not enabled, every object GET and PUT will cause an API call to KMS (with the attendant cost implications of that). - If enabled, S3 will use its own time-limited key instead. Only relevant, when Encryption is set to ``BucketEncryption.KMS`` or ``BucketEncryption.KMS_MANAGED``. Default: - false
         :param bucket_name: Physical name of this bucket. Default: - Assigned by CloudFormation (recommended).
         :param cors: The CORS configuration of this bucket. Default: - No CORS configuration.
-        :param encryption: The kind of server-side encryption to apply to this bucket. If you choose KMS, you can specify a KMS key via ``encryptionKey``. If encryption key is not specified, a key will automatically be created. Default: - ``Kms`` if ``encryptionKey`` is specified, or ``Unencrypted`` otherwise.
+        :param encryption: The kind of server-side encryption to apply to this bucket. If you choose KMS, you can specify a KMS key via ``encryptionKey``. If encryption key is not specified, a key will automatically be created. Default: - ``Kms`` if ``encryptionKey`` is specified, or ``Managed`` otherwise.
         :param encryption_key: External KMS key to use for bucket encryption. The 'encryption' property must be either not specified or set to "Kms". An error will be emitted if encryption is set to "Unencrypted" or "Managed". Default: - If encryption is set to "Kms" and this property is undefined, a new KMS key will be created and associated with this bucket.
         :param enforce_ssl: Enforces SSL for requests. S3.5 of the AWS Foundational Security Best Practices Regarding S3. Default: false
         :param event_bridge_enabled: Whether this bucket should send notifications to Amazon EventBridge or not. Default: false
@@ -1743,7 +1710,6 @@ class BucketProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             source_bucket = s3.Bucket(self, "MyBucket",
                 versioned=True
             )
@@ -1931,7 +1897,7 @@ class BucketProps:
         If you choose KMS, you can specify a KMS key via ``encryptionKey``. If
         encryption key is not specified, a key will automatically be created.
 
-        :default: - ``Kms`` if ``encryptionKey`` is specified, or ``Unencrypted`` otherwise.
+        :default: - ``Kms`` if ``encryptionKey`` is specified, or ``Managed`` otherwise.
         '''
         result = self._values.get("encryption")
         return typing.cast(typing.Optional[BucketEncryption], result)
@@ -9347,7 +9313,6 @@ class CfnBucketProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             raw_bucket = s3.CfnBucket(self, "Bucket")
             # -or-
             raw_bucket_alt = my_bucket.node.default_child
@@ -12559,7 +12524,6 @@ class EventType(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_queue: sqs.Queue
         
         bucket = s3.Bucket(self, "MyBucket")
@@ -12836,7 +12800,6 @@ class IBucket(_IResource_c80c4260, typing_extensions.Protocol):
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_lambda: lambda.Function
             
             bucket = s3.Bucket(self, "MyBucket")
@@ -13352,7 +13315,6 @@ class _IBucketProxy(
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_lambda: lambda.Function
             
             bucket = s3.Bucket(self, "MyBucket")
@@ -14241,7 +14203,6 @@ class InventoryDestination:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             inventory_bucket = s3.Bucket(self, "InventoryBucket")
             
             data_bucket = s3.Bucket(self, "DataBucket",
@@ -14335,7 +14296,6 @@ class InventoryFrequency(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         inventory_bucket = s3.Bucket(self, "InventoryBucket")
         
         data_bucket = s3.Bucket(self, "DataBucket",
@@ -14371,7 +14331,6 @@ class InventoryObjectVersion(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         inventory_bucket = s3.Bucket(self, "InventoryBucket")
         
         data_bucket = s3.Bucket(self, "DataBucket",
@@ -15032,7 +14991,6 @@ class NotificationKeyFilter:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_queue: sqs.Queue
             
             bucket = s3.Bucket(self, "MyBucket")
@@ -15110,15 +15068,14 @@ class ObjectLockRetention(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # Configure for governance mode with a duration of 7 years
         s3.Bucket(self, "Bucket1",
-            object_lock_default_retention=s3.ObjectLockRetention.governance(cdk.Duration.days(7 * 365))
+            object_lock_default_retention=s3.ObjectLockRetention.governance(Duration.days(7 * 365))
         )
         
         # Configure for compliance mode with a duration of 1 year
         s3.Bucket(self, "Bucket2",
-            object_lock_default_retention=s3.ObjectLockRetention.compliance(cdk.Duration.days(365))
+            object_lock_default_retention=s3.ObjectLockRetention.compliance(Duration.days(365))
         )
     '''
 
@@ -15184,7 +15141,6 @@ class ObjectOwnership(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         s3.Bucket(self, "MyBucket",
             object_ownership=s3.ObjectOwnership.OBJECT_WRITER
         )
@@ -15375,7 +15331,6 @@ class RedirectProtocol(enum.Enum):
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyRedirectedBucket",
             website_routing_rules=[s3.RoutingRule(
                 host_name="www.example.com",
@@ -15416,7 +15371,6 @@ class RedirectTarget:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             bucket = s3.Bucket(self, "MyRedirectedBucket",
                 website_redirect=s3.RedirectTarget(host_name="www.example.com")
             )
@@ -15465,7 +15419,6 @@ class ReplaceKey(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_s3.ReplaceK
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyRedirectedBucket",
             website_routing_rules=[s3.RoutingRule(
                 host_name="www.example.com",
@@ -15668,7 +15621,6 @@ class RoutingRuleCondition:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             bucket = s3.Bucket(self, "MyRedirectedBucket",
                 website_routing_rules=[s3.RoutingRule(
                     host_name="www.example.com",
@@ -15739,22 +15691,21 @@ class StorageClass(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyBucket",
             lifecycle_rules=[s3.LifecycleRule(
-                abort_incomplete_multipart_upload_after=cdk.Duration.minutes(30),
+                abort_incomplete_multipart_upload_after=Duration.minutes(30),
                 enabled=False,
-                expiration=cdk.Duration.days(30),
+                expiration=Duration.days(30),
                 expiration_date=Date(),
                 expired_object_delete_marker=False,
                 id="id",
-                noncurrent_version_expiration=cdk.Duration.days(30),
+                noncurrent_version_expiration=Duration.days(30),
         
                 # the properties below are optional
                 noncurrent_versions_to_retain=123,
                 noncurrent_version_transitions=[s3.NoncurrentVersionTransition(
                     storage_class=s3.StorageClass.GLACIER,
-                    transition_after=cdk.Duration.days(30),
+                    transition_after=Duration.days(30),
         
                     # the properties below are optional
                     noncurrent_versions_to_retain=123
@@ -15767,7 +15718,7 @@ class StorageClass(
                     storage_class=s3.StorageClass.GLACIER,
         
                     # the properties below are optional
-                    transition_after=cdk.Duration.days(30),
+                    transition_after=Duration.days(30),
                     transition_date=Date()
                 )
                 ]
@@ -16086,7 +16037,6 @@ class VirtualHostedStyleUrlOptions:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             bucket = s3.Bucket(self, "MyBucket")
             bucket.url_for_object("objectname") # Path-Style URL
             bucket.virtual_hosted_url_for_object("objectname") # Virtual Hosted-Style URL
@@ -16190,7 +16140,6 @@ class BucketBase(
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             # my_lambda: lambda.Function
             
             bucket = s3.Bucket(self, "MyBucket")
@@ -16931,10 +16880,12 @@ class Bucket(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
-        Bucket(scope, "Bucket",
-            block_public_access=BlockPublicAccess.BLOCK_ALL,
-            encryption=BucketEncryption.S3_MANAGED,
+        from aws_cdk import RemovalPolicy
+        
+        
+        s3.Bucket(scope, "Bucket",
+            block_public_access=s3.BlockPublicAccess.BLOCK_ALL,
+            encryption=s3.BucketEncryption.S3_MANAGED,
             enforce_sSL=True,
             versioned=True,
             removal_policy=RemovalPolicy.RETAIN
@@ -16984,7 +16935,7 @@ class Bucket(
         :param bucket_key_enabled: Whether Amazon S3 should use its own intermediary key to generate data keys. Only relevant when using KMS for encryption. - If not enabled, every object GET and PUT will cause an API call to KMS (with the attendant cost implications of that). - If enabled, S3 will use its own time-limited key instead. Only relevant, when Encryption is set to ``BucketEncryption.KMS`` or ``BucketEncryption.KMS_MANAGED``. Default: - false
         :param bucket_name: Physical name of this bucket. Default: - Assigned by CloudFormation (recommended).
         :param cors: The CORS configuration of this bucket. Default: - No CORS configuration.
-        :param encryption: The kind of server-side encryption to apply to this bucket. If you choose KMS, you can specify a KMS key via ``encryptionKey``. If encryption key is not specified, a key will automatically be created. Default: - ``Kms`` if ``encryptionKey`` is specified, or ``Unencrypted`` otherwise.
+        :param encryption: The kind of server-side encryption to apply to this bucket. If you choose KMS, you can specify a KMS key via ``encryptionKey``. If encryption key is not specified, a key will automatically be created. Default: - ``Kms`` if ``encryptionKey`` is specified, or ``Managed`` otherwise.
         :param encryption_key: External KMS key to use for bucket encryption. The 'encryption' property must be either not specified or set to "Kms". An error will be emitted if encryption is set to "Unencrypted" or "Managed". Default: - If encryption is set to "Kms" and this property is undefined, a new KMS key will be created and associated with this bucket.
         :param enforce_ssl: Enforces SSL for requests. S3.5 of the AWS Foundational Security Best Practices Regarding S3. Default: false
         :param event_bridge_enabled: Whether this bucket should send notifications to Amazon EventBridge or not. Default: false

aws_cdk/aws_s3_notifications/__init__.py

@@ -84,7 +84,6 @@ class LambdaDestination(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_lambda: lambda.Function
         
         bucket = s3.Bucket.from_bucket_attributes(self, "ImportedBucket",
@@ -139,7 +138,6 @@ class SnsDestination(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         bucket = s3.Bucket(self, "MyBucket")
         topic = sns.Topic(self, "MyTopic")
         bucket.add_event_notification(s3.EventType.OBJECT_CREATED, s3n.SnsDestination(topic))
@@ -187,7 +185,6 @@ class SqsDestination(
 
     Example::
 
-        # Example automatically generated from non-compiling source. May contain errors.
         # my_queue: sqs.Queue
         
         bucket = s3.Bucket(self, "MyBucket")