@awboost/cfn-resource-types 0.1.21 → 0.1.23

package/lib/AWS-S3-Bucket.d.ts

@@ -1,47 +1,53 @@
 import { Resource as $Resource } from "@awboost/cfn-template-builder/template/resource";
 import type { ResourceOptions as $ResourceOptions } from "@awboost/cfn-template-builder/template";
 /**
- * Resource Type definition for AWS::S3::Bucket
+ * The ``AWS::S3::Bucket`` resource creates an Amazon S3 bucket in the same AWS Region where you create the AWS CloudFormation stack.
+ To control how AWS CloudFormation handles the bucket when the stack is deleted, you can set a deletion policy for your bucket. You can choose to *retain* the bucket or to *delete* the bucket. For more information, see [DeletionPolicy Attribute](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html).
+  You can only delete empty buckets. Deletion fails for buckets that have contents.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-bucket.html}
  */
 export type S3BucketProperties = {
     /**
-     * Configuration for the transfer acceleration state.
+     * Configures the transfer acceleration state for an Amazon S3 bucket. For more information, see [Amazon S3 Transfer Acceleration](https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html) in the *Amazon S3 User Guide*.
      */
     AccelerateConfiguration?: AccelerateConfiguration;
     /**
-     * A canned access control list (ACL) that grants predefined permissions to the bucket.
-     */
+       * This is a legacy property, and it is not recommended for most use cases. A majority of modern use cases in Amazon S3 no longer require the use of ACLs, and we recommend that you keep ACLs disabled. For more information, see [Controlling object ownership](https://docs.aws.amazon.com//AmazonS3/latest/userguide/about-object-ownership.html) in the *Amazon S3 User Guide*.
+        A canned access control list (ACL) that grants predefined permissions to the bucket. For more information about canned ACLs, see [Canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) in the *Amazon S3 User Guide*.
+        S3 buckets are created with ACLs disabled by default. Therefore, unless you explicitly set the [AWS::S3::OwnershipControls](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrols.html) property to enable ACLs, your resource will fail to deploy with any value other than Private. Use cases requiring ACLs are uncommon.
+        The majority of access control configurations can be successfully and more easily achieved with bucket policies. For more information, see [AWS::S3::BucketPolicy](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html). For examples of common policy configurations, including S3 Server Access Logs buckets and more, see [Bucket policy examples](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html) in the *Amazon S3 User Guide*.
+       */
     AccessControl?: "AuthenticatedRead" | "AwsExecRead" | "BucketOwnerFullControl" | "BucketOwnerRead" | "LogDeliveryWrite" | "Private" | "PublicRead" | "PublicReadWrite";
     /**
-     * The configuration and any analyses for the analytics filter of an Amazon S3 bucket.
+     * Specifies the configuration and any analyses for the analytics filter of an Amazon S3 bucket.
      */
     AnalyticsConfigurations?: AnalyticsConfiguration[];
     /**
-     * Specifies default encryption for a bucket using server-side encryption with either Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys (SSE-KMS).
+     * Specifies default encryption for a bucket using server-side encryption with Amazon S3-managed keys (SSE-S3), AWS KMS-managed keys (SSE-KMS), or dual-layer server-side encryption with KMS-managed keys (DSSE-KMS). For information about the Amazon S3 default encryption feature, see [Amazon S3 Default Encryption for S3 Buckets](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the *Amazon S3 User Guide*.
      */
     BucketEncryption?: BucketEncryption;
     /**
-     * A name for the bucket. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the bucket name.
-     * @minLength `3`
-     * @maxLength `63`
-     * @pattern `^[a-z0-9][a-z0-9//.//-]*[a-z0-9]$`
-     */
+       * A name for the bucket. If you don't specify a name, AWS CloudFormation generates a unique ID and uses that ID for the bucket name. The bucket name must contain only lowercase letters, numbers, periods (.), and dashes (-) and must follow [Amazon S3 bucket restrictions and limitations](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html). For more information, see [Rules for naming Amazon S3 buckets](https://docs.aws.amazon.com/AmazonS3/latest/dev/BucketRestrictions.html#bucketnamingrules) in the *Amazon S3 User Guide*.
+        If you specify a name, you can't perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you need to replace the resource, specify a new name.
+       * @minLength `3`
+       * @maxLength `63`
+       * @pattern `^[a-z0-9][a-z0-9//.//-]*[a-z0-9]$`
+       */
     BucketName?: string;
     /**
-     * Rules that define cross-origin resource sharing of objects in this bucket.
+     * Describes the cross-origin access configuration for objects in an Amazon S3 bucket. For more information, see [Enabling Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) in the *Amazon S3 User Guide*.
      */
     CorsConfiguration?: CorsConfiguration;
     /**
-     * Specifies the S3 Intelligent-Tiering configuration for an Amazon S3 bucket.
+     * Defines how Amazon S3 handles Intelligent-Tiering storage.
      */
     IntelligentTieringConfigurations?: IntelligentTieringConfiguration[];
     /**
-     * The inventory configuration for an Amazon S3 bucket.
+     * Specifies the inventory configuration for an Amazon S3 bucket. For more information, see [GET Bucket inventory](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETInventoryConfig.html) in the *Amazon S3 API Reference*.
      */
     InventoryConfigurations?: InventoryConfiguration[];
     /**
-     * Rules that define how Amazon S3 manages objects during their lifetime.
+     * Specifies the lifecycle configuration for objects in an Amazon S3 bucket. For more information, see [Object Lifecycle Management](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html) in the *Amazon S3 User Guide*.
      */
     LifecycleConfiguration?: LifecycleConfiguration;
     /**
@@ -49,7 +55,7 @@ export type S3BucketProperties = {
      */
     LoggingConfiguration?: LoggingConfiguration;
     /**
-     * Settings that define a metrics configuration for the CloudWatch request metrics from the bucket.
+     * Specifies a metrics configuration for the CloudWatch request metrics (specified by the metrics configuration ID) from an Amazon S3 bucket. If you're updating an existing metrics configuration, note that this is a full replacement of the existing metrics configuration. If you don't include the elements you want to keep, they are erased. For more information, see [PutBucketMetricsConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html).
      */
     MetricsConfigurations?: MetricsConfiguration[];
     /**
@@ -57,15 +63,19 @@ export type S3BucketProperties = {
      */
     NotificationConfiguration?: NotificationConfiguration;
     /**
-     * Places an Object Lock configuration on the specified bucket.
-     */
+       * This operation is not supported by directory buckets.
+        Places an Object Lock configuration on the specified bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket. For more information, see [Locking Objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
+         +  The ``DefaultRetention`` settings require both a mode and a period.
+        +  The ``DefaultRetention`` period can be either ``Days`` or ``Years`` but you must select one. You cannot specify ``Days`` and ``Years`` at the same time.
+        +  You can enable Object Lock for new or existing buckets. For more information, see [Configuring Object Lock](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html).
+       */
     ObjectLockConfiguration?: ObjectLockConfiguration;
     /**
-     * Indicates whether this bucket has an Object Lock configuration enabled.
+     * Indicates whether this bucket has an Object Lock configuration enabled. Enable ``ObjectLockEnabled`` when you apply ``ObjectLockConfiguration`` to a bucket.
      */
     ObjectLockEnabled?: boolean;
     /**
-     * Specifies the container element for object ownership rules.
+     * Configuration that defines how Amazon S3 handles Object Ownership rules.
      */
     OwnershipControls?: OwnershipControls;
     /**
@@ -73,19 +83,20 @@ export type S3BucketProperties = {
      */
     PublicAccessBlockConfiguration?: PublicAccessBlockConfiguration;
     /**
-     * Configuration for replicating objects in an S3 bucket.
-     */
+       * Configuration for replicating objects in an S3 bucket. To enable replication, you must also enable versioning by using the ``VersioningConfiguration`` property.
+       Amazon S3 can store replicated objects in a single destination bucket or multiple destination buckets. The destination bucket or buckets must already exist.
+       */
     ReplicationConfiguration?: ReplicationConfiguration;
     /**
      * An arbitrary set of tags (key-value pairs) for this S3 bucket.
      */
     Tags?: Tag[];
     /**
-     * Describes the versioning state of an Amazon S3 bucket.
+     * Enables multiple versions of all objects in this bucket. You might enable versioning to prevent objects from being deleted or overwritten by mistake or to archive objects so that you can retrieve previous versions of them.
      */
     VersioningConfiguration?: VersioningConfiguration;
     /**
-     * Specifies website configuration parameters for an Amazon S3 bucket.
+     * Information used to configure the bucket as a static website. For more information, see [Hosting Websites on Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html).
      */
     WebsiteConfiguration?: WebsiteConfiguration;
 };
@@ -117,32 +128,36 @@ export type S3BucketAttributes = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.AbortIncompleteMultipartUpload`.
- * Specifies the days since the initiation of an incomplete multipart upload that Amazon S3 will wait before permanently removing all parts of the upload.
+ * Specifies the days since the initiation of an incomplete multipart upload that Amazon S3 will wait before permanently removing all parts of the upload. For more information, see [Stopping Incomplete Multipart Uploads Using a Bucket Lifecycle Policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-abortincompletemultipartupload.html}
  */
 export type AbortIncompleteMultipartUpload = {
     /**
-     * Specifies the number of days after which Amazon S3 aborts an incomplete multipart upload.
+     * Specifies the number of days after which Amazon S3 stops an incomplete multipart upload.
      * @min `0`
      */
     DaysAfterInitiation: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.AccelerateConfiguration`.
+ * Configures the transfer acceleration state for an Amazon S3 bucket. For more information, see [Amazon S3 Transfer Acceleration](https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accelerateconfiguration.html}
  */
 export type AccelerateConfiguration = {
     /**
-     * Configures the transfer acceleration state for an Amazon S3 bucket.
+     * Specifies the transfer acceleration status of the bucket.
      */
     AccelerationStatus: "Enabled" | "Suspended";
 };
 /**
  * Type definition for `AWS::S3::Bucket.AccessControlTranslation`.
- * Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the AWS account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS account that owns the source object.
+ * Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the AWS-account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS-account that owns the source object.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accesscontroltranslation.html}
  */
 export type AccessControlTranslation = {
+    /**
+     * Specifies the replica ownership. For default and valid values, see [PUT bucket replication](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html) in the *Amazon S3 API Reference*.
+     */
     Owner: "Destination";
 };
 /**
@@ -160,14 +175,18 @@ export type AnalyticsConfiguration = {
      */
     Prefix?: string;
     /**
-     * Specifies data related to access patterns to be collected and made available to analyze the tradeoffs between different storage classes for an Amazon S3 bucket.
+     * Contains data related to access patterns to be collected and made available to analyze the tradeoffs between different storage classes.
      */
     StorageClassAnalysis: StorageClassAnalysis;
+    /**
+       * The tags to use when evaluating an analytics filter.
+       The analytics only includes objects that meet the filter's criteria. If no filter is specified, all of the contents of the bucket are included in the analysis.
+       */
     TagFilters?: TagFilter[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.BucketEncryption`.
- * Specifies default encryption for a bucket using server-side encryption with either Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys (SSE-KMS).
+ * Specifies default encryption for a bucket using server-side encryption with Amazon S3-managed keys (SSE-S3), AWS KMS-managed keys (SSE-KMS), or dual-layer server-side encryption with KMS-managed keys (DSSE-KMS). For information about the Amazon S3 default encryption feature, see [Amazon S3 Default Encryption for S3 Buckets](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-bucketencryption.html}
  */
 export type BucketEncryption = {
@@ -178,23 +197,28 @@ export type BucketEncryption = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.CorsConfiguration`.
+ * Describes the cross-origin access configuration for objects in an Amazon S3 bucket. For more information, see [Enabling Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-corsconfiguration.html}
  */
 export type CorsConfiguration = {
+    /**
+     * A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration.
+     */
     CorsRules: CorsRule[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.CorsRule`.
- * A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration.
+ * Specifies a cross-origin access rule for an Amazon S3 bucket.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-corsrule.html}
  */
 export type CorsRule = {
     /**
-     * Headers that are specified in the Access-Control-Request-Headers header.
+     * Headers that are specified in the ``Access-Control-Request-Headers`` header. These headers are allowed in a preflight OPTIONS request. In response to any preflight OPTIONS request, Amazon S3 returns any requested headers that are allowed.
      */
     AllowedHeaders?: string[];
     /**
-     * An HTTP method that you allow the origin to execute.
+     * An HTTP method that you allow the origin to run.
+     *Allowed values*: ``GET`` | ``PUT`` | ``HEAD`` | ``POST`` | ``DELETE``
      */
     AllowedMethods: ("GET" | "PUT" | "HEAD" | "POST" | "DELETE")[];
     /**
@@ -202,11 +226,11 @@ export type CorsRule = {
      */
     AllowedOrigins: string[];
     /**
-     * One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript XMLHttpRequest object).
+     * One or more headers in the response that you want customers to be able to access from their applications (for example, from a JavaScript ``XMLHttpRequest`` object).
      */
     ExposedHeaders?: string[];
     /**
-     * A unique identifier for this rule.
+     * A unique identifier for this rule. The value must be no more than 255 characters.
      * @maxLength `255`
      */
     Id?: string;
@@ -223,40 +247,58 @@ export type CorsRule = {
  */
 export type DataExport = {
     /**
-     * Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket and S3 Replication Time Control (S3 RTC).
+     * The place to store the data for an analysis.
      */
     Destination: Destination;
     /**
-     * The version of the output schema to use when exporting data.
+     * The version of the output schema to use when exporting data. Must be ``V_1``.
      */
     OutputSchemaVersion: "V_1";
 };
 /**
  * Type definition for `AWS::S3::Bucket.DefaultRetention`.
- * The default retention period that you want to apply to new objects placed in the specified bucket.
+ * The container element for specifying the default Object Lock retention settings for new objects placed in the specified bucket.
+   +  The ``DefaultRetention`` settings require both a mode and a period.
+  +  The ``DefaultRetention`` period can be either ``Days`` or ``Years`` but you must select one. You cannot specify ``Days`` and ``Years`` at the same time.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html}
  */
 export type DefaultRetention = {
+    /**
+     * The number of days that you want to specify for the default retention period. If Object Lock is turned on, you must specify ``Mode`` and specify either ``Days`` or ``Years``.
+     */
     Days?: number;
+    /**
+     * The default Object Lock retention mode you want to apply to new objects placed in the specified bucket. If Object Lock is turned on, you must specify ``Mode`` and specify either ``Days`` or ``Years``.
+     */
     Mode?: "COMPLIANCE" | "GOVERNANCE";
+    /**
+     * The number of years that you want to specify for the default retention period. If Object Lock is turned on, you must specify ``Mode`` and specify either ``Days`` or ``Years``.
+     */
     Years?: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.DeleteMarkerReplication`.
+ * Specifies whether Amazon S3 replicates delete markers. If you specify a ``Filter`` in your replication configuration, you must also include a ``DeleteMarkerReplication`` element. If your ``Filter`` includes a ``Tag`` element, the ``DeleteMarkerReplication`` ``Status`` must be set to Disabled, because Amazon S3 does not support replicating delete markers for tag-based rules. For an example configuration, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config).
+ For more information about delete marker replication, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html).
+  If you are using an earlier version of the replication configuration, Amazon S3 handles replication of delete markers differently. For more information, see [Backward Compatibility](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-deletemarkerreplication.html}
  */
 export type DeleteMarkerReplication = {
+    /**
+     * Indicates whether to replicate delete markers. Disabled by default.
+     */
     Status?: "Disabled" | "Enabled";
 };
 /**
  * Type definition for `AWS::S3::Bucket.Destination`.
- * Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket and S3 Replication Time Control (S3 RTC).
+ * Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html}
  */
 export type Destination = {
     /**
-     * The account ID that owns the destination S3 bucket.
-     */
+       * The account ID that owns the destination S3 bucket. If no account ID is provided, the owner is not validated before exporting data.
+         Although this value is optional, we strongly recommend that you set it to help prevent problems if the destination bucket ownership changes.
+       */
     BucketAccountId?: string;
     /**
      * The Amazon Resource Name (ARN) of the bucket to which data is exported.
@@ -264,6 +306,7 @@ export type Destination = {
     BucketArn: string;
     /**
      * Specifies the file format used when exporting data to Amazon S3.
+     *Allowed values*: ``CSV`` | ``ORC`` | ``Parquet``
      */
     Format: "CSV" | "ORC" | "Parquet";
     /**
@@ -278,35 +321,42 @@ export type Destination = {
  */
 export type EncryptionConfiguration = {
     /**
-     * Specifies the ID (Key ARN or Alias ARN) of the customer managed customer master key (CMK) stored in AWS Key Management Service (KMS) for the destination bucket.
+     * Specifies the ID (Key ARN or Alias ARN) of the customer managed AWS KMS key stored in AWS Key Management Service (KMS) for the destination bucket. Amazon S3 uses this key to encrypt replica objects. Amazon S3 only supports symmetric encryption KMS keys. For more information, see [Asymmetric keys in KMS](https://docs.aws.amazon.com//kms/latest/developerguide/symmetric-asymmetric.html) in the *Key Management Service Developer Guide*.
      */
     ReplicaKmsKeyID: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.EventBridgeConfiguration`.
- * Describes the Amazon EventBridge notification configuration for an Amazon S3 bucket.
+ * Amazon S3 can send events to Amazon EventBridge whenever certain events happen in your bucket, see [Using EventBridge](https://docs.aws.amazon.com/AmazonS3/latest/userguide/EventBridge.html) in the *Amazon S3 User Guide*.
+ Unlike other destinations, delivery of events to EventBridge can be either enabled or disabled for a bucket. If enabled, all events will be sent to EventBridge and you can use EventBridge rules to route events to additional targets. For more information, see [What Is Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) in the *Amazon EventBridge User Guide*
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-eventbridgeconfiguration.html}
  */
 export type EventBridgeConfiguration = {
     /**
-     * Specifies whether to send notifications to Amazon EventBridge when events occur in an Amazon S3 bucket.
+     * Enables delivery of events to Amazon EventBridge.
      */
     EventBridgeEnabled: boolean;
 };
 /**
  * Type definition for `AWS::S3::Bucket.FilterRule`.
- * Specifies the Amazon S3 object key name to filter on and whether to filter on the suffix or prefix of the key name.
+ * Specifies the Amazon S3 object key name to filter on. An object key name is the name assigned to an object in your Amazon S3 bucket. You specify whether to filter on the suffix or prefix of the object key name. A prefix is a specific string of characters at the beginning of an object key name, which you can use to organize objects. For example, you can start the key names of related objects with a prefix, such as ``2023-`` or ``engineering/``. Then, you can use ``FilterRule`` to find objects in a bucket with key names that have the same prefix. A suffix is similar to a prefix, but it is at the end of the object key name instead of at the beginning.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-filterrule.html}
  */
 export type FilterRule = {
     /**
+     * The object key name prefix or suffix identifying one or more objects to which the filtering rule applies. The maximum length is 1,024 characters. Overlapping prefixes and suffixes are not supported. For more information, see [Configuring Event Notifications](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the *Amazon S3 User Guide*.
      * @maxLength `1024`
      */
     Name: string;
+    /**
+     * The value that the filter searches for in object key names.
+     */
     Value: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.IntelligentTieringConfiguration`.
+ * Specifies the S3 Intelligent-Tiering configuration for an Amazon S3 bucket.
+ For information about the S3 Intelligent-Tiering storage class, see [Storage class for automatically optimizing frequently and infrequently accessed objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html}
  */
 export type IntelligentTieringConfiguration = {
@@ -327,21 +377,23 @@ export type IntelligentTieringConfiguration = {
      */
     TagFilters?: TagFilter[];
     /**
-     * Specifies a list of S3 Intelligent-Tiering storage class tiers in the configuration. At least one tier must be defined in the list. At most, you can specify two tiers in the list, one for each available AccessTier: ARCHIVE_ACCESS and DEEP_ARCHIVE_ACCESS.
-     */
+       * Specifies a list of S3 Intelligent-Tiering storage class tiers in the configuration. At least one tier must be defined in the list. At most, you can specify two tiers in the list, one for each available AccessTier: ``ARCHIVE_ACCESS`` and ``DEEP_ARCHIVE_ACCESS``.
+        You only need Intelligent Tiering Configuration enabled on a bucket if you want to automatically move objects stored in the Intelligent-Tiering storage class to Archive Access or Deep Archive Access tiers.
+       */
     Tierings: Tiering[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.InventoryConfiguration`.
+ * Specifies the inventory configuration for an Amazon S3 bucket. For more information, see [GET Bucket inventory](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETInventoryConfig.html) in the *Amazon S3 API Reference*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html}
  */
 export type InventoryConfiguration = {
     /**
-     * Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket and S3 Replication Time Control (S3 RTC).
+     * Contains information about where to publish the inventory results.
      */
     Destination: Destination;
     /**
-     * Specifies whether the inventory is enabled or disabled.
+     * Specifies whether the inventory is enabled or disabled. If set to ``True``, an inventory list is generated. If set to ``False``, no inventory list is generated.
      */
     Enabled: boolean;
     /**
@@ -349,7 +401,7 @@ export type InventoryConfiguration = {
      */
     Id: string;
     /**
-     * Object versions to include in the inventory list.
+     * Object versions to include in the inventory list. If set to ``All``, the list includes all the object versions, which adds the version-related fields ``VersionId``, ``IsLatest``, and ``DeleteMarker`` to the list. If set to ``Current``, the list does not contain these version-related fields.
      */
     IncludedObjectVersions: "All" | "Current";
     /**
@@ -357,7 +409,7 @@ export type InventoryConfiguration = {
      */
     OptionalFields?: ("Size" | "LastModifiedDate" | "StorageClass" | "ETag" | "IsMultipartUploaded" | "ReplicationStatus" | "EncryptionStatus" | "ObjectLockRetainUntilDate" | "ObjectLockMode" | "ObjectLockLegalHoldStatus" | "IntelligentTieringAccessTier" | "BucketKeyStatus" | "ChecksumAlgorithm" | "ObjectAccessControlList" | "ObjectOwner")[];
     /**
-     * The prefix that is prepended to all inventory results.
+     * Specifies the inventory filter prefix.
      */
     Prefix?: string;
     /**
@@ -367,25 +419,26 @@ export type InventoryConfiguration = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.LambdaConfiguration`.
- * Describes the AWS Lambda functions to invoke and the events for which to invoke them.
+ * Describes the LAMlong functions to invoke and the events for which to invoke them.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lambdaconfiguration.html}
  */
 export type LambdaConfiguration = {
     /**
-     * The Amazon S3 bucket event for which to invoke the AWS Lambda function.
+     * The Amazon S3 bucket event for which to invoke the LAMlong function. For more information, see [Supported Event Types](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the *Amazon S3 User Guide*.
      */
     Event: string;
     /**
-     * The filtering rules that determine which objects invoke the AWS Lambda function.
+     * The filtering rules that determine which objects invoke the AWS Lambda function. For example, you can create a filter so that only image files with a ``.jpg`` extension invoke the function when they are added to the Amazon S3 bucket.
      */
     Filter?: NotificationFilter;
     /**
-     * The Amazon Resource Name (ARN) of the AWS Lambda function that Amazon S3 invokes when the specified event type occurs.
+     * The Amazon Resource Name (ARN) of the LAMlong function that Amazon S3 invokes when the specified event type occurs.
      */
     Function: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.LifecycleConfiguration`.
+ * Specifies the lifecycle configuration for objects in an Amazon S3 bucket. For more information, see [Object Lifecycle Management](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfiguration.html}
  */
 export type LifecycleConfiguration = {
@@ -396,60 +449,85 @@ export type LifecycleConfiguration = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.LoggingConfiguration`.
+ * Describes where logs are stored and the prefix that Amazon S3 assigns to all log object keys for a bucket. For examples and more information, see [PUT Bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html) in the *Amazon S3 API Reference*.
+  To successfully complete the ``AWS::S3::Bucket LoggingConfiguration`` request, you must have ``s3:PutObject`` and ``s3:PutObjectAcl`` in your IAM permissions.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-loggingconfiguration.html}
  */
 export type LoggingConfiguration = {
     /**
-     * The name of an Amazon S3 bucket where Amazon S3 store server access log files. You can store log files in any bucket that you own. By default, logs are stored in the bucket where the LoggingConfiguration property is defined.
+     * The name of the bucket where Amazon S3 should store server access log files. You can store log files in any bucket that you own. By default, logs are stored in the bucket where the ``LoggingConfiguration`` property is defined.
      */
     DestinationBucketName?: string;
+    /**
+     * A prefix for all log object keys. If you store log files from multiple Amazon S3 buckets in a single bucket, you can use a prefix to distinguish which log files came from which bucket.
+     */
     LogFilePrefix?: string;
     /**
-     * Describes the key format for server access log file in the target bucket. You can choose between SimplePrefix and PartitionedPrefix.
+     * Amazon S3 key format for log objects. Only one format, either PartitionedPrefix or SimplePrefix, is allowed.
      */
     TargetObjectKeyFormat?: TargetObjectKeyFormat;
 };
 /**
  * Type definition for `AWS::S3::Bucket.Metrics`.
+ * A container specifying replication metrics-related settings enabling replication metrics and events.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metrics.html}
  */
 export type Metrics = {
+    /**
+     * A container specifying the time threshold for emitting the ``s3:Replication:OperationMissedThreshold`` event.
+     */
     EventThreshold?: ReplicationTimeValue;
+    /**
+     * Specifies whether the replication metrics are enabled.
+     */
     Status: "Disabled" | "Enabled";
 };
 /**
  * Type definition for `AWS::S3::Bucket.MetricsConfiguration`.
+ * Specifies a metrics configuration for the CloudWatch request metrics (specified by the metrics configuration ID) from an Amazon S3 bucket. If you're updating an existing metrics configuration, note that this is a full replacement of the existing metrics configuration. If you don't include the elements you want to keep, they are erased. For examples, see [AWS::S3::Bucket](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#aws-properties-s3-bucket--examples). For more information, see [PUT Bucket metrics](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html) in the *Amazon S3 API Reference*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html}
  */
 export type MetricsConfiguration = {
+    /**
+     * The access point that was used while performing operations on the object. The metrics configuration only includes objects that meet the filter's criteria.
+     */
     AccessPointArn?: string;
+    /**
+     * The ID used to identify the metrics configuration. This can be any value you choose that helps you identify your metrics configuration.
+     */
     Id: string;
+    /**
+     * The prefix that an object must have to be included in the metrics results.
+     */
     Prefix?: string;
+    /**
+     * Specifies a list of tag filters to use as a metrics configuration filter. The metrics configuration includes only objects that meet the filter's criteria.
+     */
     TagFilters?: TagFilter[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.NoncurrentVersionExpiration`.
- * Container for the expiration rule that describes when noncurrent objects are expired. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 expire noncurrent object versions at a specific period in the object's lifetime
+ * Specifies when noncurrent object versions expire. Upon expiration, S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that S3 delete noncurrent object versions at a specific period in the object's lifetime. For more information about setting a lifecycle rule configuration, see [AWS::S3::Bucket Rule](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-noncurrentversionexpiration.html}
  */
 export type NoncurrentVersionExpiration = {
     /**
-     * Specified the number of newer noncurrent and current versions that must exists before performing the associated action
+     * Specifies how many noncurrent versions S3 will retain. If there are this many more recent noncurrent versions, S3 will take the associated action. For more information about noncurrent versions, see [Lifecycle configuration elements](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html) in the *Amazon S3 User Guide*.
      */
     NewerNoncurrentVersions?: number;
     /**
-     * Specified the number of days an object is noncurrent before Amazon S3 can perform the associated action
+     * Specifies the number of days an object is noncurrent before S3 can perform the associated action. For information about the noncurrent days calculations, see [How Amazon S3 Calculates When an Object Became Noncurrent](https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations) in the *Amazon S3 User Guide*.
      */
     NoncurrentDays: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.NoncurrentVersionTransition`.
- * Container for the transition rule that describes when noncurrent objects transition to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class at a specific period in the object's lifetime.
+ * Container for the transition rule that describes when noncurrent objects transition to the ``STANDARD_IA``, ``ONEZONE_IA``, ``INTELLIGENT_TIERING``, ``GLACIER_IR``, ``GLACIER``, or ``DEEP_ARCHIVE`` storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the ``STANDARD_IA``, ``ONEZONE_IA``, ``INTELLIGENT_TIERING``, ``GLACIER_IR``, ``GLACIER``, or ``DEEP_ARCHIVE`` storage class at a specific period in the object's lifetime. If you specify this property, don't specify the ``NoncurrentVersionTransitions`` property.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-noncurrentversiontransition.html}
  */
 export type NoncurrentVersionTransition = {
     /**
-     * Specified the number of newer noncurrent and current versions that must exists before performing the associated action
+     * Specifies how many noncurrent versions S3 will retain. If there are this many more recent noncurrent versions, S3 will take the associated action. For more information about noncurrent versions, see [Lifecycle configuration elements](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html) in the *Amazon S3 User Guide*.
      */
     NewerNoncurrentVersions?: number;
     /**
@@ -457,27 +535,40 @@ export type NoncurrentVersionTransition = {
      */
     StorageClass: "DEEP_ARCHIVE" | "GLACIER" | "Glacier" | "GLACIER_IR" | "INTELLIGENT_TIERING" | "ONEZONE_IA" | "STANDARD_IA";
     /**
-     * Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action.
+     * Specifies the number of days an object is noncurrent before Amazon S3 can perform the associated action. For information about the noncurrent days calculations, see [How Amazon S3 Calculates How Long an Object Has Been Noncurrent](https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations) in the *Amazon S3 User Guide*.
      */
     TransitionInDays: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.NotificationConfiguration`.
  * Describes the notification configuration for an Amazon S3 bucket.
+  If you create the target resource and related permissions in the same template, you might have a circular dependency.
+ For example, you might use the ``AWS::Lambda::Permission`` resource to grant the bucket permission to invoke an AWS Lambda function. However, AWS CloudFormation can't create the bucket until the bucket has permission to invoke the function (AWS CloudFormation checks whether the bucket can invoke the function). If you're using Refs to pass the bucket name, this leads to a circular dependency.
+ To avoid this dependency, you can create all resources without specifying the notification configuration. Then, update the stack with a notification configuration.
+ For more information on permissions, see [AWS::Lambda::Permission](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-permission.html) and [Granting Permissions to Publish Event Notification Messages to a Destination](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#grant-destinations-permissions-to-s3).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration.html}
  */
 export type NotificationConfiguration = {
     /**
-     * Describes the Amazon EventBridge notification configuration for an Amazon S3 bucket.
+     * Enables delivery of events to Amazon EventBridge.
      */
     EventBridgeConfiguration?: EventBridgeConfiguration;
+    /**
+     * Describes the LAMlong functions to invoke and the events for which to invoke them.
+     */
     LambdaConfigurations?: LambdaConfiguration[];
+    /**
+     * The Amazon Simple Queue Service queues to publish messages to and the events for which to publish messages.
+     */
     QueueConfigurations?: QueueConfiguration[];
+    /**
+     * The topic to which notifications are sent and the events for which notifications are generated.
+     */
     TopicConfigurations?: TopicConfiguration[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.NotificationFilter`.
- * Specifies object key name filtering rules.
+ * Specifies object key name filtering rules. For information about key name filtering, see [Configuring event notifications using object key name filtering](https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationfilter.html}
  */
 export type NotificationFilter = {
@@ -488,35 +579,46 @@ export type NotificationFilter = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.ObjectLockConfiguration`.
+ * Places an Object Lock configuration on the specified bucket. The rule specified in the Object Lock configuration will be applied by default to every new object placed in the specified bucket. For more information, see [Locking Objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockconfiguration.html}
  */
 export type ObjectLockConfiguration = {
+    /**
+     * Indicates whether this bucket has an Object Lock configuration enabled. Enable ``ObjectLockEnabled`` when you apply ``ObjectLockConfiguration`` to a bucket.
+     */
     ObjectLockEnabled?: "Enabled";
     /**
-     * The Object Lock rule in place for the specified object.
+     * Specifies the Object Lock rule for the specified object. Enable this rule when you apply ``ObjectLockConfiguration`` to a bucket. If Object Lock is turned on, bucket settings require both ``Mode`` and a period of either ``Days`` or ``Years``. You cannot specify ``Days`` and ``Years`` at the same time. For more information, see [ObjectLockRule](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockrule.html) and [DefaultRetention](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html).
      */
     Rule?: ObjectLockRule;
 };
 /**
  * Type definition for `AWS::S3::Bucket.ObjectLockRule`.
- * The Object Lock rule in place for the specified object.
+ * Specifies the Object Lock rule for the specified object. Enable the this rule when you apply ``ObjectLockConfiguration`` to a bucket.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockrule.html}
  */
 export type ObjectLockRule = {
     /**
-     * The default retention period that you want to apply to new objects placed in the specified bucket.
+     * The default Object Lock retention mode and period that you want to apply to new objects placed in the specified bucket. If Object Lock is turned on, bucket settings require both ``Mode`` and a period of either ``Days`` or ``Years``. You cannot specify ``Days`` and ``Years`` at the same time. For more information about allowable values for mode and period, see [DefaultRetention](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html).
      */
     DefaultRetention?: DefaultRetention;
 };
 /**
  * Type definition for `AWS::S3::Bucket.OwnershipControls`.
+ * Specifies the container element for Object Ownership rules.
+ S3 Object Ownership is an Amazon S3 bucket-level setting that you can use to disable access control lists (ACLs) and take ownership of every object in your bucket, simplifying access management for data stored in Amazon S3. For more information, see [Controlling ownership of objects and disabling ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrols.html}
  */
 export type OwnershipControls = {
+    /**
+     * Specifies the container element for Object Ownership rules.
+     */
     Rules: OwnershipControlsRule[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.OwnershipControlsRule`.
+ * Specifies an Object Ownership rule.
+ S3 Object Ownership is an Amazon S3 bucket-level setting that you can use to disable access control lists (ACLs) and take ownership of every object in your bucket, simplifying access management for data stored in Amazon S3. For more information, see [Controlling ownership of objects and disabling ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrolsrule.html}
  */
 export type OwnershipControlsRule = {
@@ -527,60 +629,64 @@ export type OwnershipControlsRule = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.PartitionedPrefix`.
- * This format appends a time based prefix to the given log file prefix for delivering server access log file.
+ * Amazon S3 keys for log objects are partitioned in the following format:
+  ``[DestinationPrefix][SourceAccountId]/[SourceRegion]/[SourceBucket]/[YYYY]/[MM]/[DD]/[YYYY]-[MM]-[DD]-[hh]-[mm]-[ss]-[UniqueString]``
+ PartitionedPrefix defaults to EventTime delivery when server access logs are delivered.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-partitionedprefix.html}
  */
 export type PartitionedPrefix = {
     /**
-     * Date Source for creating a partitioned prefix. This can be event time or delivery time.
+     * Specifies the partition date source for the partitioned prefix. PartitionDateSource can be EventTime or DeliveryTime.
      */
     PartitionDateSource?: "EventTime" | "DeliveryTime";
 };
 /**
  * Type definition for `AWS::S3::Bucket.PublicAccessBlockConfiguration`.
- * Configuration that defines how Amazon S3 handles public access.
+ * The PublicAccessBlock configuration that you want to apply to this Amazon S3 bucket. You can enable the configuration options in any combination. For more information about when Amazon S3 considers a bucket or object public, see [The Meaning of "Public"](https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html}
  */
 export type PublicAccessBlockConfiguration = {
     /**
-       * Specifies whether Amazon S3 should block public access control lists (ACLs) for this bucket and objects in this bucket. Setting this element to TRUE causes the following behavior:
-      - PUT Bucket acl and PUT Object acl calls fail if the specified ACL is public.
-       - PUT Object calls fail if the request includes a public ACL.
-      Enabling this setting doesn't affect existing policies or ACLs.
+       * Specifies whether Amazon S3 should block public access control lists (ACLs) for this bucket and objects in this bucket. Setting this element to ``TRUE`` causes the following behavior:
+        +  PUT Bucket ACL and PUT Object ACL calls fail if the specified ACL is public.
+        +  PUT Object calls fail if the request includes a public ACL.
+        +  PUT Bucket calls fail if the request includes a public ACL.
+        
+       Enabling this setting doesn't affect existing policies or ACLs.
        */
     BlockPublicAcls?: boolean;
     /**
-       * Specifies whether Amazon S3 should block public bucket policies for this bucket. Setting this element to TRUE causes Amazon S3 to reject calls to PUT Bucket policy if the specified bucket policy allows public access.
-      Enabling this setting doesn't affect existing bucket policies.
+       * Specifies whether Amazon S3 should block public bucket policies for this bucket. Setting this element to ``TRUE`` causes Amazon S3 to reject calls to PUT Bucket policy if the specified bucket policy allows public access.
+       Enabling this setting doesn't affect existing bucket policies.
        */
     BlockPublicPolicy?: boolean;
     /**
-       * Specifies whether Amazon S3 should ignore public ACLs for this bucket and objects in this bucket. Setting this element to TRUE causes Amazon S3 to ignore all public ACLs on this bucket and objects in this bucket.
-      Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.
+       * Specifies whether Amazon S3 should ignore public ACLs for this bucket and objects in this bucket. Setting this element to ``TRUE`` causes Amazon S3 to ignore all public ACLs on this bucket and objects in this bucket.
+       Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.
        */
     IgnorePublicAcls?: boolean;
     /**
-       * Specifies whether Amazon S3 should restrict public bucket policies for this bucket. Setting this element to TRUE restricts access to this bucket to only AWS services and authorized users within this account if the bucket has a public policy.
-      Enabling this setting doesn't affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked.
+       * Specifies whether Amazon S3 should restrict public bucket policies for this bucket. Setting this element to ``TRUE`` restricts access to this bucket to only AWS-service principals and authorized users within this account if the bucket has a public policy.
+       Enabling this setting doesn't affect previously stored bucket policies, except that public and cross-account access within any public bucket policy, including non-public delegation to specific accounts, is blocked.
        */
     RestrictPublicBuckets?: boolean;
 };
 /**
  * Type definition for `AWS::S3::Bucket.QueueConfiguration`.
- * The Amazon Simple Queue Service queues to publish messages to and the events for which to publish messages.
+ * Specifies the configuration for publishing messages to an Amazon Simple Queue Service (Amazon SQS) queue when Amazon S3 detects specified events.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-queueconfiguration.html}
  */
 export type QueueConfiguration = {
     /**
-     * The Amazon S3 bucket event about which you want to publish messages to Amazon SQS.
+     * The Amazon S3 bucket event about which you want to publish messages to Amazon SQS. For more information, see [Supported Event Types](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the *Amazon S3 User Guide*.
      */
     Event: string;
     /**
-     * The filtering rules that determine which objects trigger notifications.
+     * The filtering rules that determine which objects trigger notifications. For example, you can create a filter so that Amazon S3 sends notifications only when image files with a ``.jpg`` extension are added to the bucket. For more information, see [Configuring event notifications using object key name filtering](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/notification-how-to-filtering.html) in the *Amazon S3 User Guide*.
      */
     Filter?: NotificationFilter;
     /**
-     * The Amazon Resource Name (ARN) of the Amazon SQS queue to which Amazon S3 publishes a message when it detects events of the specified type.
+     * The Amazon Resource Name (ARN) of the Amazon SQS queue to which Amazon S3 publishes a message when it detects events of the specified type. FIFO queues are not allowed when enabling an SQS queue as the event notification destination.
      */
     Queue: string;
 };
@@ -618,60 +724,78 @@ export type RedirectRule = {
      */
     Protocol?: "http" | "https";
     /**
-     * The object key prefix to use in the redirect request.
-     */
+       * The object key prefix to use in the redirect request. For example, to redirect requests for all pages with prefix ``docs/`` (objects in the ``docs/`` folder) to ``documents/``, you can set a condition block with ``KeyPrefixEquals`` set to ``docs/`` and in the Redirect set ``ReplaceKeyPrefixWith`` to ``/documents``. Not required if one of the siblings is present. Can be present only if ``ReplaceKeyWith`` is not provided.
+        Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see [XML related object key constraints](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
+       */
     ReplaceKeyPrefixWith?: string;
     /**
-     * The specific object key to use in the redirect request.d
-     */
+       * The specific object key to use in the redirect request. For example, redirect request to ``error.html``. Not required if one of the siblings is present. Can be present only if ``ReplaceKeyPrefixWith`` is not provided.
+        Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see [XML related object key constraints](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
+       */
     ReplaceKeyWith?: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicaModifications`.
+ * A filter that you can specify for selection for modifications on replicas.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicamodifications.html}
  */
 export type ReplicaModifications = {
     /**
      * Specifies whether Amazon S3 replicates modifications on replicas.
+     *Allowed values*: ``Enabled`` | ``Disabled``
      */
     Status: "Enabled" | "Disabled";
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationConfiguration`.
- * A container for replication rules. You can add up to 1,000 rules. The maximum size of a replication configuration is 2 MB.
+ * A container for replication rules. You can add up to 1,000 rules. The maximum size of a replication configuration is 2 MB. The latest version of the replication configuration XML is V2. For more information about XML V2 replication configurations, see [Replication configuration](https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication-add-config.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration.html}
  */
 export type ReplicationConfiguration = {
     /**
-     * The Amazon Resource Name (ARN) of the AWS Identity and Access Management (IAM) role that Amazon S3 assumes when replicating objects.
+     * The Amazon Resource Name (ARN) of the IAMlong (IAM) role that Amazon S3 assumes when replicating objects. For more information, see [How to Set Up Replication](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-how-setup.html) in the *Amazon S3 User Guide*.
      */
     Role: string;
     /**
-     * A container for one or more replication rules.
+     * A container for one or more replication rules. A replication configuration must have at least one rule and can contain a maximum of 1,000 rules.
      */
     Rules: ReplicationRule[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationDestination`.
- * Specifies which Amazon S3 bucket to store replicated objects in and their storage class.
+ * A container for information about the replication destination and its configurations including enabling the S3 Replication Time Control (S3 RTC).
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationdestination.html}
  */
 export type ReplicationDestination = {
     /**
-     * Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the AWS account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS account that owns the source object.
+     * Specify this only in a cross-account scenario (where source and destination bucket owners are not the same), and you want to change replica ownership to the AWS-account that owns the destination bucket. If this is not specified in the replication configuration, the replicas are owned by same AWS-account that owns the source object.
      */
     AccessControlTranslation?: AccessControlTranslation;
+    /**
+       * Destination bucket owner account ID. In a cross-account scenario, if you direct Amazon S3 to change replica ownership to the AWS-account that owns the destination bucket by specifying the ``AccessControlTranslation`` property, this is the account ID of the destination bucket owner. For more information, see [Cross-Region Replication Additional Configuration: Change Replica Owner](https://docs.aws.amazon.com/AmazonS3/latest/dev/crr-change-owner.html) in the *Amazon S3 User Guide*.
+       If you specify the ``AccessControlTranslation`` property, the ``Account`` property is required.
+       */
     Account?: string;
+    /**
+     * The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to store the results.
+     */
     Bucket: string;
     /**
-     * Specifies encryption-related information for an Amazon S3 bucket that is a destination for replicated objects.
+     * Specifies encryption-related information.
      */
     EncryptionConfiguration?: EncryptionConfiguration;
+    /**
+     * A container specifying replication metrics-related settings enabling replication metrics and events.
+     */
     Metrics?: Metrics;
-    ReplicationTime?: ReplicationTime;
     /**
-     * The storage class to use when replicating objects, such as S3 Standard or reduced redundancy.
+     * A container specifying S3 Replication Time Control (S3 RTC), including whether S3 RTC is enabled and the time when all objects and operations on objects must be replicated. Must be specified together with a ``Metrics`` block.
      */
+    ReplicationTime?: ReplicationTime;
+    /**
+       * The storage class to use when replicating objects, such as S3 Standard or reduced redundancy. By default, Amazon S3 uses the storage class of the source object to create the object replica.
+       For valid values, see the ``StorageClass`` element of the [PUT Bucket replication](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html) action in the *Amazon S3 API Reference*.
+       */
     StorageClass?: "DEEP_ARCHIVE" | "GLACIER" | "GLACIER_IR" | "INTELLIGENT_TIERING" | "ONEZONE_IA" | "REDUCED_REDUNDANCY" | "STANDARD" | "STANDARD_IA";
 };
 /**
@@ -680,25 +804,39 @@ export type ReplicationDestination = {
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrule.html}
  */
 export type ReplicationRule = {
+    /**
+       * Specifies whether Amazon S3 replicates delete markers. If you specify a ``Filter`` in your replication configuration, you must also include a ``DeleteMarkerReplication`` element. If your ``Filter`` includes a ``Tag`` element, the ``DeleteMarkerReplication`` ``Status`` must be set to Disabled, because Amazon S3 does not support replicating delete markers for tag-based rules. For an example configuration, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config).
+       For more information about delete marker replication, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html).
+        If you are using an earlier version of the replication configuration, Amazon S3 handles replication of delete markers differently. For more information, see [Backward Compatibility](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations).
+       */
     DeleteMarkerReplication?: DeleteMarkerReplication;
     /**
-     * Specifies which Amazon S3 bucket to store replicated objects in and their storage class.
+     * A container for information about the replication destination and its configurations including enabling the S3 Replication Time Control (S3 RTC).
      */
     Destination: ReplicationDestination;
+    /**
+       * A filter that identifies the subset of objects to which the replication rule applies. A ``Filter`` must specify exactly one ``Prefix``, ``TagFilter``, or an ``And`` child element. The use of the filter field indicates that this is a V2 replication configuration. This field isn't supported in a V1 replication configuration.
+        V1 replication configuration only supports filtering by key prefix. To filter using a V1 replication configuration, add the ``Prefix`` directly as a child element of the ``Rule`` element.
+       */
     Filter?: ReplicationRuleFilter;
     /**
-     * A unique identifier for the rule.
+     * A unique identifier for the rule. The maximum value is 255 characters. If you don't specify a value, AWS CloudFormation generates a random ID. When using a V2 replication configuration this property is capitalized as "ID".
      * @maxLength `255`
      */
     Id?: string;
     /**
-     * An object key name prefix that identifies the object or objects to which the rule applies.
-     * @maxLength `1024`
-     */
+       * An object key name prefix that identifies the object or objects to which the rule applies. The maximum prefix length is 1,024 characters. To include all objects in a bucket, specify an empty string. To filter using a V1 replication configuration, add the ``Prefix`` directly as a child element of the ``Rule`` element.
+        Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see [XML related object key constraints](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
+       * @maxLength `1024`
+       */
     Prefix?: string;
+    /**
+       * The priority indicates which rule has precedence whenever two or more replication rules conflict. Amazon S3 will attempt to replicate objects according to all replication rules. However, if there are two or more rules with the same destination bucket, then objects will be replicated according to the rule with the highest priority. The higher the number, the higher the priority.
+       For more information, see [Replication](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html) in the *Amazon S3 User Guide*.
+       */
     Priority?: number;
     /**
-     * A container that describes additional filters for identifying the source objects that you want to replicate.
+     * A container that describes additional filters for identifying the source objects that you want to replicate. You can choose to enable or disable the replication of these objects.
      */
     SourceSelectionCriteria?: SourceSelectionCriteria;
     /**
@@ -708,42 +846,75 @@ export type ReplicationRule = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationRuleAndOperator`.
+ * A container for specifying rule filters. The filters determine the subset of objects to which the rule applies. This element is required only if you specify more than one filter.
+ For example:
+  +  If you specify both a ``Prefix`` and a ``TagFilter``, wrap these filters in an ``And`` tag.
+  +  If you specify a filter based on multiple tags, wrap the ``TagFilter`` elements in an ``And`` tag
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationruleandoperator.html}
  */
 export type ReplicationRuleAndOperator = {
+    /**
+     * An object key name prefix that identifies the subset of objects to which the rule applies.
+     */
     Prefix?: string;
+    /**
+     * An array of tags containing key and value pairs.
+     */
     TagFilters?: TagFilter[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationRuleFilter`.
+ * A filter that identifies the subset of objects to which the replication rule applies. A ``Filter`` must specify exactly one ``Prefix``, ``TagFilter``, or an ``And`` child element.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrulefilter.html}
  */
 export type ReplicationRuleFilter = {
+    /**
+       * A container for specifying rule filters. The filters determine the subset of objects to which the rule applies. This element is required only if you specify more than one filter. For example:
+        +  If you specify both a ``Prefix`` and a ``TagFilter``, wrap these filters in an ``And`` tag.
+        +  If you specify a filter based on multiple tags, wrap the ``TagFilter`` elements in an ``And`` tag.
+       */
     And?: ReplicationRuleAndOperator;
+    /**
+       * An object key name prefix that identifies the subset of objects to which the rule applies.
+        Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see [XML related object key constraints](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
+       */
     Prefix?: string;
     /**
-     * Tags to use to identify a subset of objects for an Amazon S3 bucket.
-     */
+       * A container for specifying a tag key and value.
+       The rule applies only to objects that have the tag in their tag set.
+       */
     TagFilter?: TagFilter;
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationTime`.
+ * A container specifying S3 Replication Time Control (S3 RTC) related information, including whether S3 RTC is enabled and the time when all objects and operations on objects must be replicated. Must be specified together with a ``Metrics`` block.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtime.html}
  */
 export type ReplicationTime = {
+    /**
+     * Specifies whether the replication time is enabled.
+     */
     Status: "Disabled" | "Enabled";
+    /**
+     * A container specifying the time by which replication should be complete for all objects and operations on objects.
+     */
     Time: ReplicationTimeValue;
 };
 /**
  * Type definition for `AWS::S3::Bucket.ReplicationTimeValue`.
+ * A container specifying the time value for S3 Replication Time Control (S3 RTC) and replication metrics ``EventThreshold``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtimevalue.html}
  */
 export type ReplicationTimeValue = {
+    /**
+       * Contains an integer specifying time in minutes.
+        Valid value: 15
+       */
     Minutes: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.RoutingRule`.
- * Specifies the redirect behavior and when a redirect is applied.
+ * Specifies the redirect behavior and when a redirect is applied. For more information about routing rules, see [Configuring advanced conditional redirects](https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html#advanced-conditional-redirects) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-routingrule.html}
  */
 export type RoutingRule = {
@@ -752,93 +923,139 @@ export type RoutingRule = {
      */
     RedirectRule: RedirectRule;
     /**
-     * A container for describing a condition that must be met for the specified redirect to apply.You must specify at least one of HttpErrorCodeReturnedEquals and KeyPrefixEquals
+     * A container for describing a condition that must be met for the specified redirect to apply. For example, 1. If request is for pages in the ``/docs`` folder, redirect to the ``/documents`` folder. 2. If request results in HTTP error 4xx, redirect request to another host where you might process the error.
      */
     RoutingRuleCondition?: RoutingRuleCondition;
 };
 /**
  * Type definition for `AWS::S3::Bucket.RoutingRuleCondition`.
- * A container for describing a condition that must be met for the specified redirect to apply.You must specify at least one of HttpErrorCodeReturnedEquals and KeyPrefixEquals
+ * A container for describing a condition that must be met for the specified redirect to apply. For example, 1. If request is for pages in the ``/docs`` folder, redirect to the ``/documents`` folder. 2. If request results in HTTP error 4xx, redirect request to another host where you might process the error.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-routingrulecondition.html}
  */
 export type RoutingRuleCondition = {
     /**
-     * The HTTP error code when the redirect is applied.
-     */
+       * The HTTP error code when the redirect is applied. In the event of an error, if the error code equals this value, then the specified redirect is applied.
+       Required when parent element ``Condition`` is specified and sibling ``KeyPrefixEquals`` is not specified. If both are specified, then both must be true for the redirect to be applied.
+       */
     HttpErrorCodeReturnedEquals?: string;
     /**
-     * The object key name prefix when the redirect is applied.
-     */
+       * The object key name prefix when the redirect is applied. For example, to redirect requests for ``ExamplePage.html``, the key prefix will be ``ExamplePage.html``. To redirect request for all pages with the prefix ``docs/``, the key prefix will be ``/docs``, which identifies all objects in the docs/ folder.
+       Required when the parent element ``Condition`` is specified and sibling ``HttpErrorCodeReturnedEquals`` is not specified. If both conditions are specified, both must be true for the redirect to be applied.
+       */
     KeyPrefixEquals?: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.Rule`.
- * You must specify at least one of the following properties: AbortIncompleteMultipartUpload, ExpirationDate, ExpirationInDays, NoncurrentVersionExpirationInDays, NoncurrentVersionTransition, NoncurrentVersionTransitions, Transition, or Transitions.
+ * Specifies lifecycle rules for an Amazon S3 bucket. For more information, see [Put Bucket Lifecycle Configuration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlifecycle.html) in the *Amazon S3 API Reference*.
+ You must specify at least one of the following properties: ``AbortIncompleteMultipartUpload``, ``ExpirationDate``, ``ExpirationInDays``, ``NoncurrentVersionExpirationInDays``, ``NoncurrentVersionTransition``, ``NoncurrentVersionTransitions``, ``Transition``, or ``Transitions``.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-rule.html}
  */
 export type Rule = {
     /**
-     * Specifies the days since the initiation of an incomplete multipart upload that Amazon S3 will wait before permanently removing all parts of the upload.
+     * Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3 bucket.
      */
     AbortIncompleteMultipartUpload?: AbortIncompleteMultipartUpload;
     /**
-     * The date value in ISO 8601 format. The timezone is always UTC. (YYYY-MM-DDThh:mm:ssZ)
+     * Indicates when objects are deleted from Amazon S3 and Amazon S3 Glacier. The date value must be in ISO 8601 format. The time is always midnight UTC. If you specify an expiration and transition time, you must use the same time unit for both properties (either in days or by date). The expiration time must also be later than the transition time.
      * @pattern `^([0-2]\d{3})-(0[0-9]|1[0-2])-([0-2]\d|3[01])T([01]\d|2[0-4]):([0-5]\d):([0-6]\d)((\.\d{3})?)Z$`
      */
     ExpirationDate?: string;
+    /**
+     * Indicates the number of days after creation when objects are deleted from Amazon S3 and Amazon S3 Glacier. If you specify an expiration and transition time, you must use the same time unit for both properties (either in days or by date). The expiration time must also be later than the transition time.
+     */
     ExpirationInDays?: number;
+    /**
+     * Indicates whether Amazon S3 will remove a delete marker without any noncurrent versions. If set to true, the delete marker will be removed if there are no noncurrent versions. This cannot be specified with ``ExpirationInDays``, ``ExpirationDate``, or ``TagFilters``.
+     */
     ExpiredObjectDeleteMarker?: boolean;
     /**
+     * Unique identifier for the rule. The value can't be longer than 255 characters.
      * @maxLength `255`
      */
     Id?: string;
     /**
-     * Container for the expiration rule that describes when noncurrent objects are expired. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 expire noncurrent object versions at a specific period in the object's lifetime
+     * Specifies when noncurrent object versions expire. Upon expiration, S3 permanently deletes the noncurrent object versions. You set this lifecycle configuration action on a bucket that has versioning enabled (or suspended) to request that S3 delete noncurrent object versions at a specific period in the object's lifetime.
      */
     NoncurrentVersionExpiration?: NoncurrentVersionExpiration;
+    /**
+     * (Deprecated.) For buckets with versioning enabled (or suspended), specifies the time, in days, between when a new version of the object is uploaded to the bucket and when old versions of the object expire. When object versions expire, Amazon S3 permanently deletes them. If you specify a transition and expiration time, the expiration time must be later than the transition time.
+     */
     NoncurrentVersionExpirationInDays?: number;
     /**
-     * Container for the transition rule that describes when noncurrent objects transition to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class. If your bucket is versioning-enabled (or versioning is suspended), you can set this action to request that Amazon S3 transition noncurrent object versions to the STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER_IR, GLACIER, or DEEP_ARCHIVE storage class at a specific period in the object's lifetime.
+     * (Deprecated.) For buckets with versioning enabled (or suspended), specifies when non-current objects transition to a specified storage class. If you specify a transition and expiration time, the expiration time must be later than the transition time. If you specify this property, don't specify the ``NoncurrentVersionTransitions`` property.
      */
     NoncurrentVersionTransition?: NoncurrentVersionTransition;
+    /**
+     * For buckets with versioning enabled (or suspended), one or more transition rules that specify when non-current objects transition to a specified storage class. If you specify a transition and expiration time, the expiration time must be later than the transition time. If you specify this property, don't specify the ``NoncurrentVersionTransition`` property.
+     */
     NoncurrentVersionTransitions?: NoncurrentVersionTransition[];
     /**
+     * Specifies the minimum object size in bytes for this rule to apply to. Objects must be larger than this value in bytes. For more information about size based rules, see [Lifecycle configuration using size-based rules](https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-configuration-examples.html#lc-size-rules) in the *Amazon S3 User Guide*.
      * @maxLength `20`
      * @pattern `[0-9]+`
      */
     ObjectSizeGreaterThan?: string;
     /**
+     * Specifies the maximum object size in bytes for this rule to apply to. Objects must be smaller than this value in bytes. For more information about sized based rules, see [Lifecycle configuration using size-based rules](https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-configuration-examples.html#lc-size-rules) in the *Amazon S3 User Guide*.
      * @maxLength `20`
      * @pattern `[0-9]+`
      */
     ObjectSizeLessThan?: string;
+    /**
+       * Object key prefix that identifies one or more objects to which this rule applies.
+        Replacement must be made for object keys containing special characters (such as carriage returns) when using XML requests. For more information, see [XML related object key constraints](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints).
+       */
     Prefix?: string;
+    /**
+     * If ``Enabled``, the rule is currently being applied. If ``Disabled``, the rule is not currently being applied.
+     */
     Status: "Enabled" | "Disabled";
+    /**
+     * Tags to use to identify a subset of objects to which the lifecycle rule applies.
+     */
     TagFilters?: TagFilter[];
     /**
-     * You must specify at least one of "TransitionDate" and "TransitionInDays"
+     * (Deprecated.) Specifies when an object transitions to a specified storage class. If you specify an expiration and transition time, you must use the same time unit for both properties (either in days or by date). The expiration time must also be later than the transition time. If you specify this property, don't specify the ``Transitions`` property.
      */
     Transition?: Transition;
+    /**
+     * One or more transition rules that specify when an object transitions to a specified storage class. If you specify an expiration and transition time, you must use the same time unit for both properties (either in days or by date). The expiration time must also be later than the transition time. If you specify this property, don't specify the ``Transition`` property.
+     */
     Transitions?: Transition[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.S3KeyFilter`.
- * A container for object key name prefix and suffix filtering rules.
+ * A container for object key name prefix and suffix filtering rules. For more information about object key name filtering, see [Configuring event notifications using object key name filtering](https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html) in the *Amazon S3 User Guide*.
+  The same type of filter rule cannot be used more than once. For example, you cannot specify two prefix rules.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-s3keyfilter.html}
  */
 export type S3KeyFilter = {
+    /**
+     * A list of containers for the key-value pair that defines the criteria for the filter rule.
+     */
     Rules: FilterRule[];
 };
 /**
  * Type definition for `AWS::S3::Bucket.ServerSideEncryptionByDefault`.
- * Specifies the default server-side encryption to apply to new objects in the bucket. If a PUT Object request doesn't specify any server-side encryption, this default encryption will be applied.
+ * Describes the default server-side encryption to apply to new objects in the bucket. If a PUT Object request doesn't specify any server-side encryption, this default encryption will be applied. If you don't specify a customer managed key at configuration, Amazon S3 automatically creates an AWS KMS key in your AWS account the first time that you add an object encrypted with SSE-KMS to a bucket. By default, Amazon S3 uses this KMS key for SSE-KMS. For more information, see [PUT Bucket encryption](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTencryption.html) in the *Amazon S3 API Reference*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionbydefault.html}
  */
 export type ServerSideEncryptionByDefault = {
     /**
-     * "KMSMasterKeyID" can only be used when you set the value of SSEAlgorithm as aws:kms or aws:kms:dsse.
-     */
+       * AWS Key Management Service (KMS) customer AWS KMS key ID to use for the default encryption. This parameter is allowed if and only if ``SSEAlgorithm`` is set to ``aws:kms`` or ``aws:kms:dsse``.
+       You can specify the key ID, key alias, or the Amazon Resource Name (ARN) of the KMS key.
+        +  Key ID: ``1234abcd-12ab-34cd-56ef-1234567890ab``
+        +  Key ARN: ``arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab``
+        +  Key Alias: ``alias/alias-name``
+        
+       If you use a key ID, you can run into a LogDestination undeliverable error when creating a VPC flow log.
+       If you are using encryption with cross-account or AWS service operations you must use a fully qualified KMS key ARN. For more information, see [Using encryption for cross-account operations](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html#bucket-encryption-update-bucket-policy).
+        Amazon S3 only supports symmetric encryption KMS keys. For more information, see [Asymmetric keys in KMS](https://docs.aws.amazon.com//kms/latest/developerguide/symmetric-asymmetric.html) in the *Key Management Service Developer Guide*.
+       */
     KMSMasterKeyID?: string;
+    /**
+     * Server-side encryption algorithm to use for the default encryption.
+     */
     SSEAlgorithm: "aws:kms" | "AES256" | "aws:kms:dsse";
 };
 /**
@@ -848,8 +1065,9 @@ export type ServerSideEncryptionByDefault = {
  */
 export type ServerSideEncryptionRule = {
     /**
-     * Specifies whether Amazon S3 should use an S3 Bucket Key with server-side encryption using KMS (SSE-KMS) for new objects in the bucket. Existing objects are not affected. Setting the BucketKeyEnabled element to true causes Amazon S3 to use an S3 Bucket Key. By default, S3 Bucket Key is not enabled.
-     */
+       * Specifies whether Amazon S3 should use an S3 Bucket Key with server-side encryption using KMS (SSE-KMS) for new objects in the bucket. Existing objects are not affected. Setting the ``BucketKeyEnabled`` element to ``true`` causes Amazon S3 to use an S3 Bucket Key. By default, S3 Bucket Key is not enabled.
+       For more information, see [Amazon S3 Bucket Keys](https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html) in the *Amazon S3 User Guide*.
+       */
     BucketKeyEnabled?: boolean;
     /**
      * Specifies the default server-side encryption to apply to new objects in the bucket. If a PUT Object request doesn't specify any server-side encryption, this default encryption will be applied.
@@ -858,7 +1076,7 @@ export type ServerSideEncryptionRule = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.SourceSelectionCriteria`.
- * A container that describes additional filters for identifying the source objects that you want to replicate.
+ * A container that describes additional filters for identifying the source objects that you want to replicate. You can choose to enable or disable the replication of these objects.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-sourceselectioncriteria.html}
  */
 export type SourceSelectionCriteria = {
@@ -878,7 +1096,7 @@ export type SourceSelectionCriteria = {
  */
 export type SseKmsEncryptedObjects = {
     /**
-     * Specifies whether Amazon S3 replicates objects created with server-side encryption using a customer master key (CMK) stored in AWS Key Management Service.
+     * Specifies whether Amazon S3 replicates objects created with server-side encryption using an AWS KMS key stored in AWS Key Management Service.
      */
     Status: "Disabled" | "Enabled";
 };
@@ -895,26 +1113,35 @@ export type StorageClassAnalysis = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.Tag`.
+ * A container of a key value name pair.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tag.html}
  */
 export type Tag = {
     /**
+     * Name of the object key.
      * @minLength `1`
      * @maxLength `128`
      */
     Key: string;
     /**
+     * Value of the tag.
      * @maxLength `256`
      */
     Value: string;
 };
 /**
  * Type definition for `AWS::S3::Bucket.TagFilter`.
- * Tags to use to identify a subset of objects for an Amazon S3 bucket.
+ * Specifies tags to use to identify a subset of objects for an Amazon S3 bucket.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tagfilter.html}
  */
 export type TagFilter = {
+    /**
+     * The tag key.
+     */
     Key: string;
+    /**
+     * The tag value.
+     */
     Value: string;
 };
 /**
@@ -929,17 +1156,20 @@ export type TargetObjectKeyFormat = {
     SimplePrefix: Record<string, any>;
 } | {
     /**
-     * This format appends a time based prefix to the given log file prefix for delivering server access log file.
-     */
+   * Amazon S3 keys for log objects are partitioned in the following format:
+    ``[DestinationPrefix][SourceAccountId]/[SourceRegion]/[SourceBucket]/[YYYY]/[MM]/[DD]/[YYYY]-[MM]-[DD]-[hh]-[mm]-[ss]-[UniqueString]``
+   PartitionedPrefix defaults to EventTime delivery when server access logs are delivered.
+   */
     PartitionedPrefix: PartitionedPrefix;
 };
 /**
  * Type definition for `AWS::S3::Bucket.Tiering`.
+ * The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without additional operational overhead.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tiering.html}
  */
 export type Tiering = {
     /**
-     * S3 Intelligent-Tiering access tier. See Storage class for automatically optimizing frequently and infrequently accessed objects for a list of access tiers in the S3 Intelligent-Tiering storage class.
+     * S3 Intelligent-Tiering access tier. See [Storage class for automatically optimizing frequently and infrequently accessed objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access) for a list of access tiers in the S3 Intelligent-Tiering storage class.
      */
     AccessTier: "ARCHIVE_ACCESS" | "DEEP_ARCHIVE_ACCESS";
     /**
@@ -949,16 +1179,16 @@ export type Tiering = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.TopicConfiguration`.
- * The topic to which notifications are sent and the events for which notifications are generated.
+ * A container for specifying the configuration for publication of messages to an Amazon Simple Notification Service (Amazon SNS) topic when Amazon S3 detects specified events.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-topicconfiguration.html}
  */
 export type TopicConfiguration = {
     /**
-     * The Amazon S3 bucket event about which to send notifications.
+     * The Amazon S3 bucket event about which to send notifications. For more information, see [Supported Event Types](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the *Amazon S3 User Guide*.
      */
     Event: string;
     /**
-     * The filtering rules that determine for which objects to send notifications.
+     * The filtering rules that determine for which objects to send notifications. For example, you can create a filter so that Amazon S3 sends notifications only when image files with a ``.jpg`` extension are added to the bucket.
      */
     Filter?: NotificationFilter;
     /**
@@ -968,21 +1198,27 @@ export type TopicConfiguration = {
 };
 /**
  * Type definition for `AWS::S3::Bucket.Transition`.
- * You must specify at least one of "TransitionDate" and "TransitionInDays"
+ * Specifies when an object transitions to a specified storage class. For more information about Amazon S3 lifecycle configuration rules, see [Transitioning Objects Using Amazon S3 Lifecycle](https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-transition-general-considerations.html) in the *Amazon S3 User Guide*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-transition.html}
  */
 export type Transition = {
+    /**
+     * The storage class to which you want the object to transition.
+     */
     StorageClass: "DEEP_ARCHIVE" | "GLACIER" | "Glacier" | "GLACIER_IR" | "INTELLIGENT_TIERING" | "ONEZONE_IA" | "STANDARD_IA";
     /**
-     * The date value in ISO 8601 format. The timezone is always UTC. (YYYY-MM-DDThh:mm:ssZ)
+     * Indicates when objects are transitioned to the specified storage class. The date value must be in ISO 8601 format. The time is always midnight UTC.
      * @pattern `^([0-2]\d{3})-(0[0-9]|1[0-2])-([0-2]\d|3[01])T([01]\d|2[0-4]):([0-5]\d):([0-6]\d)((\.\d{3})?)Z$`
      */
     TransitionDate?: string;
+    /**
+     * Indicates the number of days after creation when objects are transitioned to the specified storage class. The value must be a positive integer.
+     */
     TransitionInDays?: number;
 };
 /**
  * Type definition for `AWS::S3::Bucket.VersioningConfiguration`.
- * Describes the versioning state of an Amazon S3 bucket.
+ * Describes the versioning state of an Amazon S3 bucket. For more information, see [PUT Bucket versioning](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTVersioningStatus.html) in the *Amazon S3 API Reference*.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-versioningconfiguration.html}
  */
 export type VersioningConfiguration = {
@@ -1006,13 +1242,19 @@ export type WebsiteConfiguration = {
      */
     IndexDocument?: string;
     /**
-     * Specifies the redirect behavior of all requests to a website endpoint of an Amazon S3 bucket.
-     */
+       * The redirect behavior for every request to this bucket's website endpoint.
+        If you specify this property, you can't specify any other property.
+       */
     RedirectAllRequestsTo?: RedirectAllRequestsTo;
+    /**
+     * Rules that define when a redirect is applied and the redirect behavior.
+     */
     RoutingRules?: RoutingRule[];
 };
 /**
- * Resource Type definition for AWS::S3::Bucket
+ * The ``AWS::S3::Bucket`` resource creates an Amazon S3 bucket in the same AWS Region where you create the AWS CloudFormation stack.
+ To control how AWS CloudFormation handles the bucket when the stack is deleted, you can set a deletion policy for your bucket. You can choose to *retain* the bucket or to *delete* the bucket. For more information, see [DeletionPolicy Attribute](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-attribute-deletionpolicy.html).
+  You can only delete empty buckets. Deletion fails for buckets that have contents.
  * @see {@link https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-bucket.html}
  */
 export declare class S3Bucket extends $Resource<"AWS::S3::Bucket", S3BucketProperties, S3BucketAttributes> {