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

aws_cdk/aws_s3/__init__.py

@@ -4,7 +4,6 @@
 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
         )
@@ -1754,7 +1710,6 @@ class BucketProps:
 
         Example::
 
-            # Example automatically generated from non-compiling source. May contain errors.
             source_bucket = s3.Bucket(self, "MyBucket",
                 versioned=True
             )
@@ -9358,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
@@ -12570,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")
@@ -12847,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")
@@ -13363,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")
@@ -14252,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",
@@ -14346,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",
@@ -14382,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",
@@ -15043,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")
@@ -15121,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))
         )
     '''
 
@@ -15195,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
         )
@@ -15386,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",
@@ -15427,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")
             )
@@ -15476,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",
@@ -15679,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",
@@ -15750,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
@@ -15778,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()
                 )
                 ]
@@ -16097,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
@@ -16201,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")
@@ -16942,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

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")

aws_cdk/aws_sagemaker/__init__.py

@@ -10399,7 +10399,7 @@ class CfnFeatureGroup(
 
             :param s3_storage_config: The Amazon Simple Storage (Amazon S3) location of ``OfflineStore`` .
             :param data_catalog_config: The meta data of the Glue table that is autogenerated when an ``OfflineStore`` is created.
-            :param disable_glue_table_creation: Set to ``True`` to disable the automatic creation of an AWS Glue table when configuring an ``OfflineStore`` . If set to ``False`` , Feature Store will name the ``OfflineStore`` Glue table following `Athena's naming recommendations <https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html>`_ .
+            :param disable_glue_table_creation: Set to ``True`` to disable the automatic creation of an AWS Glue table when configuring an ``OfflineStore`` . If set to ``False`` , Feature Store will name the ``OfflineStore`` Glue table following `Athena's naming recommendations <https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html>`_ . The default value is ``False`` .
             :param table_format: ``CfnFeatureGroup.OfflineStoreConfigProperty.TableFormat``.
 
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-featuregroup-offlinestoreconfig.html
@@ -10476,6 +10476,8 @@ class CfnFeatureGroup(
 
             If set to ``False`` , Feature Store will name the ``OfflineStore`` Glue table following `Athena's naming recommendations <https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html>`_ .
 
+            The default value is ``False`` .
+
             :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-featuregroup-offlinestoreconfig.html#cfn-sagemaker-featuregroup-offlinestoreconfig-disablegluetablecreation
             '''
             result = self._values.get("disable_glue_table_creation")
@@ -10518,7 +10520,9 @@ class CfnFeatureGroup(
         ) -> None:
             '''Use this to specify the AWS Key Management Service (KMS) Key ID, or ``KMSKeyId`` , for at rest data encryption.
 
-            You can turn ``OnlineStore`` on or off by specifying the ``EnableOnlineStore`` flag at General Assembly; the default value is ``False`` .
+            You can turn ``OnlineStore`` on or off by specifying the ``EnableOnlineStore`` flag at General Assembly.
+
+            The default value is ``False`` .
 
             :param enable_online_store: Turn ``OnlineStore`` off by specifying ``False`` for the ``EnableOnlineStore`` flag. Turn ``OnlineStore`` on by specifying ``True`` for the ``EnableOnlineStore`` flag. The default value is ``False`` .
             :param security_config: Use to specify KMS Key ID ( ``KMSKeyId`` ) for at-rest encryption of your ``OnlineStore`` .