UNPKG

196 kBTypeScriptView Raw
1import * as cdk from '@aws-cdk/core';
2import * as cfn_parse from '@aws-cdk/core/lib/helpers-internal';
3/**
4 * Properties for defining a `CfnAccessPoint`
5 *
6 * @struct
7 * @stability external
8 *
9 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html
10 */
11export interface CfnAccessPointProps {
12 /**
13 * The name of the bucket associated with this access point.
14 *
15 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-bucket
16 */
17 readonly bucket: string;
18 /**
19 * The AWS account ID associated with the S3 bucket associated with this access point.
20 *
21 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-bucketaccountid
22 */
23 readonly bucketAccountId?: string;
24 /**
25 * The name of this access point. If you don't specify a name, AWS CloudFormation generates a unique ID and uses that ID for the access point name.
26 *
27 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-name
28 */
29 readonly name?: string;
30 /**
31 * The access point policy associated with this access point.
32 *
33 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-policy
34 */
35 readonly policy?: any | cdk.IResolvable;
36 /**
37 * 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* .
38 *
39 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-publicaccessblockconfiguration
40 */
41 readonly publicAccessBlockConfiguration?: CfnAccessPoint.PublicAccessBlockConfigurationProperty | cdk.IResolvable;
42 /**
43 * The Virtual Private Cloud (VPC) configuration for this access point, if one exists.
44 *
45 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-vpcconfiguration
46 */
47 readonly vpcConfiguration?: CfnAccessPoint.VpcConfigurationProperty | cdk.IResolvable;
48}
49/**
50 * A CloudFormation `AWS::S3::AccessPoint`
51 *
52 * The AWS::S3::AccessPoint resource is an Amazon S3 resource type that you can use to access buckets.
53 *
54 * @cloudformationResource AWS::S3::AccessPoint
55 * @stability external
56 *
57 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html
58 */
59export declare class CfnAccessPoint extends cdk.CfnResource implements cdk.IInspectable {
60 /**
61 * The CloudFormation resource type name for this resource class.
62 */
63 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::AccessPoint";
64 /**
65 * A factory method that creates a new instance of this class from an object
66 * containing the CloudFormation properties of this resource.
67 * Used in the @aws-cdk/cloudformation-include module.
68 *
69 * @internal
70 */
71 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnAccessPoint;
72 /**
73 * The alias for this access point.
74 * @cloudformationAttribute Alias
75 */
76 readonly attrAlias: string;
77 /**
78 * This property contains the details of the ARN for the access point.
79 * @cloudformationAttribute Arn
80 */
81 readonly attrArn: string;
82 /**
83 * The name of this access point.
84 * @cloudformationAttribute Name
85 */
86 readonly attrName: string;
87 /**
88 * Indicates whether this access point allows access from the internet. If `VpcConfiguration` is specified for this access point, then `NetworkOrigin` is `VPC` , and the access point doesn't allow access from the internet. Otherwise, `NetworkOrigin` is `Internet` , and the access point allows access from the internet, subject to the access point and bucket access policies.
89 *
90 * *Allowed values* : `VPC` | `Internet`
91 * @cloudformationAttribute NetworkOrigin
92 */
93 readonly attrNetworkOrigin: string;
94 /**
95 * The name of the bucket associated with this access point.
96 *
97 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-bucket
98 */
99 bucket: string;
100 /**
101 * The AWS account ID associated with the S3 bucket associated with this access point.
102 *
103 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-bucketaccountid
104 */
105 bucketAccountId: string | undefined;
106 /**
107 * The name of this access point. If you don't specify a name, AWS CloudFormation generates a unique ID and uses that ID for the access point name.
108 *
109 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-name
110 */
111 name: string | undefined;
112 /**
113 * The access point policy associated with this access point.
114 *
115 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-policy
116 */
117 policy: any | cdk.IResolvable | undefined;
118 /**
119 * 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* .
120 *
121 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-publicaccessblockconfiguration
122 */
123 publicAccessBlockConfiguration: CfnAccessPoint.PublicAccessBlockConfigurationProperty | cdk.IResolvable | undefined;
124 /**
125 * The Virtual Private Cloud (VPC) configuration for this access point, if one exists.
126 *
127 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-accesspoint.html#cfn-s3-accesspoint-vpcconfiguration
128 */
129 vpcConfiguration: CfnAccessPoint.VpcConfigurationProperty | cdk.IResolvable | undefined;
130 /**
131 * Create a new `AWS::S3::AccessPoint`.
132 *
133 * @param scope - scope in which this resource is defined
134 * @param id - scoped id of the resource
135 * @param props - resource properties
136 */
137 constructor(scope: cdk.Construct, id: string, props: CfnAccessPointProps);
138 /**
139 * Examines the CloudFormation resource and discloses attributes.
140 *
141 * @param inspector - tree inspector to collect and process attributes
142 *
143 */
144 inspect(inspector: cdk.TreeInspector): void;
145 protected get cfnProperties(): {
146 [key: string]: any;
147 };
148 protected renderProperties(props: {
149 [key: string]: any;
150 }): {
151 [key: string]: any;
152 };
153}
154export declare namespace CfnAccessPoint {
155 /**
156 * 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* .
157 *
158 * @struct
159 * @stability external
160 *
161 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-publicaccessblockconfiguration.html
162 */
163 interface PublicAccessBlockConfigurationProperty {
164 /**
165 * 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:
166 *
167 * - PUT Bucket ACL and PUT Object ACL calls fail if the specified ACL is public.
168 * - PUT Object calls fail if the request includes a public ACL.
169 * - PUT Bucket calls fail if the request includes a public ACL.
170 *
171 * Enabling this setting doesn't affect existing policies or ACLs.
172 *
173 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-publicaccessblockconfiguration.html#cfn-s3-accesspoint-publicaccessblockconfiguration-blockpublicacls
174 */
175 readonly blockPublicAcls?: boolean | cdk.IResolvable;
176 /**
177 * 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.
178 *
179 * Enabling this setting doesn't affect existing bucket policies.
180 *
181 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-publicaccessblockconfiguration.html#cfn-s3-accesspoint-publicaccessblockconfiguration-blockpublicpolicy
182 */
183 readonly blockPublicPolicy?: boolean | cdk.IResolvable;
184 /**
185 * 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.
186 *
187 * Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.
188 *
189 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-publicaccessblockconfiguration.html#cfn-s3-accesspoint-publicaccessblockconfiguration-ignorepublicacls
190 */
191 readonly ignorePublicAcls?: boolean | cdk.IResolvable;
192 /**
193 * 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.
194 *
195 * 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.
196 *
197 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-publicaccessblockconfiguration.html#cfn-s3-accesspoint-publicaccessblockconfiguration-restrictpublicbuckets
198 */
199 readonly restrictPublicBuckets?: boolean | cdk.IResolvable;
200 }
201}
202export declare namespace CfnAccessPoint {
203 /**
204 * The Virtual Private Cloud (VPC) configuration for this access point.
205 *
206 * @struct
207 * @stability external
208 *
209 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-vpcconfiguration.html
210 */
211 interface VpcConfigurationProperty {
212 /**
213 * If this field is specified, the access point will only allow connections from the specified VPC ID.
214 *
215 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-accesspoint-vpcconfiguration.html#cfn-s3-accesspoint-vpcconfiguration-vpcid
216 */
217 readonly vpcId?: string;
218 }
219}
220/**
221 * Properties for defining a `CfnBucket`
222 *
223 * @struct
224 * @stability external
225 *
226 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html
227 */
228export interface CfnBucketProps {
229 /**
230 * 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* .
231 *
232 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-accelerateconfiguration
233 */
234 readonly accelerateConfiguration?: CfnBucket.AccelerateConfigurationProperty | cdk.IResolvable;
235 /**
236 * 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* .
237 *
238 * Be aware that the syntax for this property differs from the information provided in the *Amazon S3 User Guide* . The AccessControl property is case-sensitive and must be one of the following values: Private, PublicRead, PublicReadWrite, AuthenticatedRead, LogDeliveryWrite, BucketOwnerRead, BucketOwnerFullControl, or AwsExecRead.
239 *
240 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-accesscontrol
241 */
242 readonly accessControl?: string;
243 /**
244 * Specifies the configuration and any analyses for the analytics filter of an Amazon S3 bucket.
245 *
246 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-analyticsconfigurations
247 */
248 readonly analyticsConfigurations?: Array<CfnBucket.AnalyticsConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
249 /**
250 * Specifies default encryption for a bucket using server-side encryption with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys (SSE-KMS) bucket. 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* .
251 *
252 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-bucketencryption
253 */
254 readonly bucketEncryption?: CfnBucket.BucketEncryptionProperty | cdk.IResolvable;
255 /**
256 * 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* .
257 *
258 * > 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.
259 *
260 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-name
261 */
262 readonly bucketName?: string;
263 /**
264 * 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* .
265 *
266 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-crossoriginconfig
267 */
268 readonly corsConfiguration?: CfnBucket.CorsConfigurationProperty | cdk.IResolvable;
269 /**
270 * Defines how Amazon S3 handles Intelligent-Tiering storage.
271 *
272 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-intelligenttieringconfigurations
273 */
274 readonly intelligentTieringConfigurations?: Array<CfnBucket.IntelligentTieringConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
275 /**
276 * 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* .
277 *
278 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-inventoryconfigurations
279 */
280 readonly inventoryConfigurations?: Array<CfnBucket.InventoryConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
281 /**
282 * 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* .
283 *
284 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-lifecycleconfig
285 */
286 readonly lifecycleConfiguration?: CfnBucket.LifecycleConfigurationProperty | cdk.IResolvable;
287 /**
288 * Settings that define where logs are stored.
289 *
290 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-loggingconfig
291 */
292 readonly loggingConfiguration?: CfnBucket.LoggingConfigurationProperty | cdk.IResolvable;
293 /**
294 * 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) .
295 *
296 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-metricsconfigurations
297 */
298 readonly metricsConfigurations?: Array<CfnBucket.MetricsConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
299 /**
300 * Configuration that defines how Amazon S3 handles bucket notifications.
301 *
302 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-notification
303 */
304 readonly notificationConfiguration?: CfnBucket.NotificationConfigurationProperty | cdk.IResolvable;
305 /**
306 * 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) .
307 *
308 * > - The `DefaultRetention` settings require both a mode and a period.
309 * > - The `DefaultRetention` period can be either `Days` or `Years` but you must select one. You cannot specify `Days` and `Years` at the same time.
310 * > - You can only enable Object Lock for new buckets. If you want to turn on Object Lock for an existing bucket, contact AWS Support.
311 *
312 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-objectlockconfiguration
313 */
314 readonly objectLockConfiguration?: CfnBucket.ObjectLockConfigurationProperty | cdk.IResolvable;
315 /**
316 * Indicates whether this bucket has an Object Lock configuration enabled. Enable `ObjectLockEnabled` when you apply `ObjectLockConfiguration` to a bucket.
317 *
318 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-objectlockenabled
319 */
320 readonly objectLockEnabled?: boolean | cdk.IResolvable;
321 /**
322 * Configuration that defines how Amazon S3 handles Object Ownership rules.
323 *
324 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-ownershipcontrols
325 */
326 readonly ownershipControls?: CfnBucket.OwnershipControlsProperty | cdk.IResolvable;
327 /**
328 * Configuration that defines how Amazon S3 handles public access.
329 *
330 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-publicaccessblockconfiguration
331 */
332 readonly publicAccessBlockConfiguration?: CfnBucket.PublicAccessBlockConfigurationProperty | cdk.IResolvable;
333 /**
334 * Configuration for replicating objects in an S3 bucket. To enable replication, you must also enable versioning by using the `VersioningConfiguration` property.
335 *
336 * Amazon S3 can store replicated objects in a single destination bucket or multiple destination buckets. The destination bucket or buckets must already exist.
337 *
338 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-replicationconfiguration
339 */
340 readonly replicationConfiguration?: CfnBucket.ReplicationConfigurationProperty | cdk.IResolvable;
341 /**
342 * An arbitrary set of tags (key-value pairs) for this S3 bucket.
343 *
344 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-tags
345 */
346 readonly tags?: cdk.CfnTag[];
347 /**
348 * 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.
349 *
350 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-versioning
351 */
352 readonly versioningConfiguration?: CfnBucket.VersioningConfigurationProperty | cdk.IResolvable;
353 /**
354 * 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) .
355 *
356 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-websiteconfiguration
357 */
358 readonly websiteConfiguration?: CfnBucket.WebsiteConfigurationProperty | cdk.IResolvable;
359}
360/**
361 * A CloudFormation `AWS::S3::Bucket`
362 *
363 * The `AWS::S3::Bucket` resource creates an Amazon S3 bucket in the same AWS Region where you create the AWS CloudFormation stack.
364 *
365 * 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) .
366 *
367 * > You can only delete empty buckets. Deletion fails for buckets that have contents.
368 *
369 * @cloudformationResource AWS::S3::Bucket
370 * @stability external
371 *
372 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html
373 */
374export declare class CfnBucket extends cdk.CfnResource implements cdk.IInspectable {
375 /**
376 * The CloudFormation resource type name for this resource class.
377 */
378 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::Bucket";
379 /**
380 * A factory method that creates a new instance of this class from an object
381 * containing the CloudFormation properties of this resource.
382 * Used in the @aws-cdk/cloudformation-include module.
383 *
384 * @internal
385 */
386 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnBucket;
387 /**
388 * Returns the Amazon Resource Name (ARN) of the specified bucket.
389 *
390 * Example: `arn:aws:s3:::DOC-EXAMPLE-BUCKET`
391 * @cloudformationAttribute Arn
392 */
393 readonly attrArn: string;
394 /**
395 * Returns the IPv4 DNS name of the specified bucket.
396 *
397 * Example: `DOC-EXAMPLE-BUCKET.s3.amazonaws.com`
398 * @cloudformationAttribute DomainName
399 */
400 readonly attrDomainName: string;
401 /**
402 * Returns the IPv6 DNS name of the specified bucket.
403 *
404 * Example: `DOC-EXAMPLE-BUCKET.s3.dualstack.us-east-2.amazonaws.com`
405 *
406 * For more information about dual-stack endpoints, see [Using Amazon S3 Dual-Stack Endpoints](https://docs.aws.amazon.com/AmazonS3/latest/dev/dual-stack-endpoints.html) .
407 * @cloudformationAttribute DualStackDomainName
408 */
409 readonly attrDualStackDomainName: string;
410 /**
411 * Returns the regional domain name of the specified bucket.
412 *
413 * Example: `DOC-EXAMPLE-BUCKET.s3.us-east-2.amazonaws.com`
414 * @cloudformationAttribute RegionalDomainName
415 */
416 readonly attrRegionalDomainName: string;
417 /**
418 * Returns the Amazon S3 website endpoint for the specified bucket.
419 *
420 * Example (IPv4): `http://DOC-EXAMPLE-BUCKET.s3-website.us-east-2.amazonaws.com`
421 *
422 * Example (IPv6): `http://DOC-EXAMPLE-BUCKET.s3.dualstack.us-east-2.amazonaws.com`
423 * @cloudformationAttribute WebsiteURL
424 */
425 readonly attrWebsiteUrl: string;
426 /**
427 * 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* .
428 *
429 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-accelerateconfiguration
430 */
431 accelerateConfiguration: CfnBucket.AccelerateConfigurationProperty | cdk.IResolvable | undefined;
432 /**
433 * 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* .
434 *
435 * Be aware that the syntax for this property differs from the information provided in the *Amazon S3 User Guide* . The AccessControl property is case-sensitive and must be one of the following values: Private, PublicRead, PublicReadWrite, AuthenticatedRead, LogDeliveryWrite, BucketOwnerRead, BucketOwnerFullControl, or AwsExecRead.
436 *
437 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-accesscontrol
438 */
439 accessControl: string | undefined;
440 /**
441 * Specifies the configuration and any analyses for the analytics filter of an Amazon S3 bucket.
442 *
443 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-analyticsconfigurations
444 */
445 analyticsConfigurations: Array<CfnBucket.AnalyticsConfigurationProperty | cdk.IResolvable> | cdk.IResolvable | undefined;
446 /**
447 * Specifies default encryption for a bucket using server-side encryption with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys (SSE-KMS) bucket. 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* .
448 *
449 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-bucketencryption
450 */
451 bucketEncryption: CfnBucket.BucketEncryptionProperty | cdk.IResolvable | undefined;
452 /**
453 * 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* .
454 *
455 * > 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.
456 *
457 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-name
458 */
459 bucketName: string | undefined;
460 /**
461 * 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* .
462 *
463 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-crossoriginconfig
464 */
465 corsConfiguration: CfnBucket.CorsConfigurationProperty | cdk.IResolvable | undefined;
466 /**
467 * Defines how Amazon S3 handles Intelligent-Tiering storage.
468 *
469 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-intelligenttieringconfigurations
470 */
471 intelligentTieringConfigurations: Array<CfnBucket.IntelligentTieringConfigurationProperty | cdk.IResolvable> | cdk.IResolvable | undefined;
472 /**
473 * 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* .
474 *
475 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-inventoryconfigurations
476 */
477 inventoryConfigurations: Array<CfnBucket.InventoryConfigurationProperty | cdk.IResolvable> | cdk.IResolvable | undefined;
478 /**
479 * 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* .
480 *
481 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-lifecycleconfig
482 */
483 lifecycleConfiguration: CfnBucket.LifecycleConfigurationProperty | cdk.IResolvable | undefined;
484 /**
485 * Settings that define where logs are stored.
486 *
487 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-loggingconfig
488 */
489 loggingConfiguration: CfnBucket.LoggingConfigurationProperty | cdk.IResolvable | undefined;
490 /**
491 * 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) .
492 *
493 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-metricsconfigurations
494 */
495 metricsConfigurations: Array<CfnBucket.MetricsConfigurationProperty | cdk.IResolvable> | cdk.IResolvable | undefined;
496 /**
497 * Configuration that defines how Amazon S3 handles bucket notifications.
498 *
499 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-notification
500 */
501 notificationConfiguration: CfnBucket.NotificationConfigurationProperty | cdk.IResolvable | undefined;
502 /**
503 * 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) .
504 *
505 * > - The `DefaultRetention` settings require both a mode and a period.
506 * > - The `DefaultRetention` period can be either `Days` or `Years` but you must select one. You cannot specify `Days` and `Years` at the same time.
507 * > - You can only enable Object Lock for new buckets. If you want to turn on Object Lock for an existing bucket, contact AWS Support.
508 *
509 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-objectlockconfiguration
510 */
511 objectLockConfiguration: CfnBucket.ObjectLockConfigurationProperty | cdk.IResolvable | undefined;
512 /**
513 * Indicates whether this bucket has an Object Lock configuration enabled. Enable `ObjectLockEnabled` when you apply `ObjectLockConfiguration` to a bucket.
514 *
515 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-objectlockenabled
516 */
517 objectLockEnabled: boolean | cdk.IResolvable | undefined;
518 /**
519 * Configuration that defines how Amazon S3 handles Object Ownership rules.
520 *
521 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-ownershipcontrols
522 */
523 ownershipControls: CfnBucket.OwnershipControlsProperty | cdk.IResolvable | undefined;
524 /**
525 * Configuration that defines how Amazon S3 handles public access.
526 *
527 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-publicaccessblockconfiguration
528 */
529 publicAccessBlockConfiguration: CfnBucket.PublicAccessBlockConfigurationProperty | cdk.IResolvable | undefined;
530 /**
531 * Configuration for replicating objects in an S3 bucket. To enable replication, you must also enable versioning by using the `VersioningConfiguration` property.
532 *
533 * Amazon S3 can store replicated objects in a single destination bucket or multiple destination buckets. The destination bucket or buckets must already exist.
534 *
535 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-replicationconfiguration
536 */
537 replicationConfiguration: CfnBucket.ReplicationConfigurationProperty | cdk.IResolvable | undefined;
538 /**
539 * An arbitrary set of tags (key-value pairs) for this S3 bucket.
540 *
541 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-tags
542 */
543 readonly tags: cdk.TagManager;
544 /**
545 * 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.
546 *
547 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-versioning
548 */
549 versioningConfiguration: CfnBucket.VersioningConfigurationProperty | cdk.IResolvable | undefined;
550 /**
551 * 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) .
552 *
553 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket.html#cfn-s3-bucket-websiteconfiguration
554 */
555 websiteConfiguration: CfnBucket.WebsiteConfigurationProperty | cdk.IResolvable | undefined;
556 /**
557 * Create a new `AWS::S3::Bucket`.
558 *
559 * @param scope - scope in which this resource is defined
560 * @param id - scoped id of the resource
561 * @param props - resource properties
562 */
563 constructor(scope: cdk.Construct, id: string, props?: CfnBucketProps);
564 /**
565 * Examines the CloudFormation resource and discloses attributes.
566 *
567 * @param inspector - tree inspector to collect and process attributes
568 *
569 */
570 inspect(inspector: cdk.TreeInspector): void;
571 protected get cfnProperties(): {
572 [key: string]: any;
573 };
574 protected renderProperties(props: {
575 [key: string]: any;
576 }): {
577 [key: string]: any;
578 };
579}
580export declare namespace CfnBucket {
581 /**
582 * 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* .
583 *
584 * @struct
585 * @stability external
586 *
587 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-abortincompletemultipartupload.html
588 */
589 interface AbortIncompleteMultipartUploadProperty {
590 /**
591 * Specifies the number of days after which Amazon S3 stops an incomplete multipart upload.
592 *
593 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-abortincompletemultipartupload.html#cfn-s3-bucket-abortincompletemultipartupload-daysafterinitiation
594 */
595 readonly daysAfterInitiation: number;
596 }
597}
598export declare namespace CfnBucket {
599 /**
600 * 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* .
601 *
602 * @struct
603 * @stability external
604 *
605 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accelerateconfiguration.html
606 */
607 interface AccelerateConfigurationProperty {
608 /**
609 * Specifies the transfer acceleration status of the bucket.
610 *
611 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accelerateconfiguration.html#cfn-s3-bucket-accelerateconfiguration-accelerationstatus
612 */
613 readonly accelerationStatus: string;
614 }
615}
616export declare namespace CfnBucket {
617 /**
618 * 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.
619 *
620 * @struct
621 * @stability external
622 *
623 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accesscontroltranslation.html
624 */
625 interface AccessControlTranslationProperty {
626 /**
627 * 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* .
628 *
629 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-accesscontroltranslation.html#cfn-s3-bucket-accesscontroltranslation-owner
630 */
631 readonly owner: string;
632 }
633}
634export declare namespace CfnBucket {
635 /**
636 * Specifies the configuration and any analyses for the analytics filter of an Amazon S3 bucket.
637 *
638 * @struct
639 * @stability external
640 *
641 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-analyticsconfiguration.html
642 */
643 interface AnalyticsConfigurationProperty {
644 /**
645 * The ID that identifies the analytics configuration.
646 *
647 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-analyticsconfiguration.html#cfn-s3-bucket-analyticsconfiguration-id
648 */
649 readonly id: string;
650 /**
651 * The prefix that an object must have to be included in the analytics results.
652 *
653 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-analyticsconfiguration.html#cfn-s3-bucket-analyticsconfiguration-prefix
654 */
655 readonly prefix?: string;
656 /**
657 * Contains data related to access patterns to be collected and made available to analyze the tradeoffs between different storage classes.
658 *
659 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-analyticsconfiguration.html#cfn-s3-bucket-analyticsconfiguration-storageclassanalysis
660 */
661 readonly storageClassAnalysis: CfnBucket.StorageClassAnalysisProperty | cdk.IResolvable;
662 /**
663 * The tags to use when evaluating an analytics filter.
664 *
665 * 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.
666 *
667 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-analyticsconfiguration.html#cfn-s3-bucket-analyticsconfiguration-tagfilters
668 */
669 readonly tagFilters?: Array<CfnBucket.TagFilterProperty | cdk.IResolvable> | cdk.IResolvable;
670 }
671}
672export declare namespace CfnBucket {
673 /**
674 * Specifies default encryption for a bucket using server-side encryption with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys (SSE-KMS) bucket. 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* .
675 *
676 * @struct
677 * @stability external
678 *
679 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-bucketencryption.html
680 */
681 interface BucketEncryptionProperty {
682 /**
683 * Specifies the default server-side-encryption configuration.
684 *
685 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-bucketencryption.html#cfn-s3-bucket-bucketencryption-serversideencryptionconfiguration
686 */
687 readonly serverSideEncryptionConfiguration: Array<CfnBucket.ServerSideEncryptionRuleProperty | cdk.IResolvable> | cdk.IResolvable;
688 }
689}
690export declare namespace CfnBucket {
691 /**
692 * 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* .
693 *
694 * @struct
695 * @stability external
696 *
697 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors.html
698 */
699 interface CorsConfigurationProperty {
700 /**
701 * A set of origins and methods (cross-origin access that you want to allow). You can add up to 100 rules to the configuration.
702 *
703 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors.html#cfn-s3-bucket-cors-corsrule
704 */
705 readonly corsRules: Array<CfnBucket.CorsRuleProperty | cdk.IResolvable> | cdk.IResolvable;
706 }
707}
708export declare namespace CfnBucket {
709 /**
710 * Specifies a cross-origin access rule for an Amazon S3 bucket.
711 *
712 * @struct
713 * @stability external
714 *
715 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html
716 */
717 interface CorsRuleProperty {
718 /**
719 * 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.
720 *
721 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-allowedheaders
722 */
723 readonly allowedHeaders?: string[];
724 /**
725 * An HTTP method that you allow the origin to run.
726 *
727 * *Allowed values* : `GET` | `PUT` | `HEAD` | `POST` | `DELETE`
728 *
729 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-allowedmethods
730 */
731 readonly allowedMethods: string[];
732 /**
733 * One or more origins you want customers to be able to access the bucket from.
734 *
735 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-allowedorigins
736 */
737 readonly allowedOrigins: string[];
738 /**
739 * 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).
740 *
741 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-exposedheaders
742 */
743 readonly exposedHeaders?: string[];
744 /**
745 * A unique identifier for this rule. The value must be no more than 255 characters.
746 *
747 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-id
748 */
749 readonly id?: string;
750 /**
751 * The time in seconds that your browser is to cache the preflight response for the specified resource.
752 *
753 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-cors-corsrule.html#cfn-s3-bucket-cors-corsrule-maxage
754 */
755 readonly maxAge?: number;
756 }
757}
758export declare namespace CfnBucket {
759 /**
760 * Specifies how data related to the storage class analysis for an Amazon S3 bucket should be exported.
761 *
762 * @struct
763 * @stability external
764 *
765 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-dataexport.html
766 */
767 interface DataExportProperty {
768 /**
769 * The place to store the data for an analysis.
770 *
771 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-dataexport.html#cfn-s3-bucket-dataexport-destination
772 */
773 readonly destination: CfnBucket.DestinationProperty | cdk.IResolvable;
774 /**
775 * The version of the output schema to use when exporting data. Must be `V_1` .
776 *
777 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-dataexport.html#cfn-s3-bucket-dataexport-outputschemaversion
778 */
779 readonly outputSchemaVersion: string;
780 }
781}
782export declare namespace CfnBucket {
783 /**
784 * The container element for specifying the default Object Lock retention settings for new objects placed in the specified bucket.
785 *
786 * > - The `DefaultRetention` settings require both a mode and a period.
787 * > - The `DefaultRetention` period can be either `Days` or `Years` but you must select one. You cannot specify `Days` and `Years` at the same time.
788 *
789 * @struct
790 * @stability external
791 *
792 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html
793 */
794 interface DefaultRetentionProperty {
795 /**
796 * 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` .
797 *
798 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html#cfn-s3-bucket-defaultretention-days
799 */
800 readonly days?: number;
801 /**
802 * 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` .
803 *
804 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html#cfn-s3-bucket-defaultretention-mode
805 */
806 readonly mode?: string;
807 /**
808 * 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` .
809 *
810 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-defaultretention.html#cfn-s3-bucket-defaultretention-years
811 */
812 readonly years?: number;
813 }
814}
815export declare namespace CfnBucket {
816 /**
817 * 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) .
818 *
819 * For more information about delete marker replication, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html) .
820 *
821 * > 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) .
822 *
823 * @struct
824 * @stability external
825 *
826 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-deletemarkerreplication.html
827 */
828 interface DeleteMarkerReplicationProperty {
829 /**
830 * Indicates whether to replicate delete markers. Disabled by default.
831 *
832 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-deletemarkerreplication.html#cfn-s3-bucket-deletemarkerreplication-status
833 */
834 readonly status?: string;
835 }
836}
837export declare namespace CfnBucket {
838 /**
839 * Specifies information about where to publish analysis or configuration results for an Amazon S3 bucket.
840 *
841 * @struct
842 * @stability external
843 *
844 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html
845 */
846 interface DestinationProperty {
847 /**
848 * The account ID that owns the destination S3 bucket. If no account ID is provided, the owner is not validated before exporting data.
849 *
850 * > Although this value is optional, we strongly recommend that you set it to help prevent problems if the destination bucket ownership changes.
851 *
852 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html#cfn-s3-bucket-destination-bucketaccountid
853 */
854 readonly bucketAccountId?: string;
855 /**
856 * The Amazon Resource Name (ARN) of the bucket to which data is exported.
857 *
858 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html#cfn-s3-bucket-destination-bucketarn
859 */
860 readonly bucketArn: string;
861 /**
862 * Specifies the file format used when exporting data to Amazon S3.
863 *
864 * *Allowed values* : `CSV` | `ORC` | `Parquet`
865 *
866 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html#cfn-s3-bucket-destination-format
867 */
868 readonly format: string;
869 /**
870 * The prefix to use when exporting data. The prefix is prepended to all results.
871 *
872 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-destination.html#cfn-s3-bucket-destination-prefix
873 */
874 readonly prefix?: string;
875 }
876}
877export declare namespace CfnBucket {
878 /**
879 * Specifies encryption-related information for an Amazon S3 bucket that is a destination for replicated objects.
880 *
881 * @struct
882 * @stability external
883 *
884 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-encryptionconfiguration.html
885 */
886 interface EncryptionConfigurationProperty {
887 /**
888 * 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 AWS KMS](https://docs.aws.amazon.com//kms/latest/developerguide/symmetric-asymmetric.html) in the *AWS Key Management Service Developer Guide* .
889 *
890 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-encryptionconfiguration.html#cfn-s3-bucket-encryptionconfiguration-replicakmskeyid
891 */
892 readonly replicaKmsKeyId: string;
893 }
894}
895export declare namespace CfnBucket {
896 /**
897 * 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* .
898 *
899 * 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*
900 *
901 * @struct
902 * @stability external
903 *
904 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-eventbridgeconfig.html
905 */
906 interface EventBridgeConfigurationProperty {
907 /**
908 * Enables delivery of events to Amazon EventBridge.
909 *
910 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-eventbridgeconfig.html#cfn-s3-bucket-eventbridgeconfiguration-eventbridgeenabled
911 */
912 readonly eventBridgeEnabled?: boolean | cdk.IResolvable;
913 }
914}
915export declare namespace CfnBucket {
916 /**
917 * Specifies the Amazon S3 object key name to filter on and whether to filter on the suffix or prefix of the key name.
918 *
919 * @struct
920 * @stability external
921 *
922 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter-s3key-rules.html
923 */
924 interface FilterRuleProperty {
925 /**
926 * 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* .
927 *
928 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter-s3key-rules.html#cfn-s3-bucket-notificationconfiguraiton-config-filter-s3key-rules-name
929 */
930 readonly name: string;
931 /**
932 * The value that the filter searches for in object key names.
933 *
934 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter-s3key-rules.html#cfn-s3-bucket-notificationconfiguraiton-config-filter-s3key-rules-value
935 */
936 readonly value: string;
937 }
938}
939export declare namespace CfnBucket {
940 /**
941 * Specifies the S3 Intelligent-Tiering configuration for an Amazon S3 bucket.
942 *
943 * 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) .
944 *
945 * @struct
946 * @stability external
947 *
948 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html
949 */
950 interface IntelligentTieringConfigurationProperty {
951 /**
952 * The ID used to identify the S3 Intelligent-Tiering configuration.
953 *
954 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html#cfn-s3-bucket-intelligenttieringconfiguration-id
955 */
956 readonly id: string;
957 /**
958 * An object key name prefix that identifies the subset of objects to which the rule applies.
959 *
960 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html#cfn-s3-bucket-intelligenttieringconfiguration-prefix
961 */
962 readonly prefix?: string;
963 /**
964 * Specifies the status of the configuration.
965 *
966 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html#cfn-s3-bucket-intelligenttieringconfiguration-status
967 */
968 readonly status: string;
969 /**
970 * A container for a key-value pair.
971 *
972 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html#cfn-s3-bucket-intelligenttieringconfiguration-tagfilters
973 */
974 readonly tagFilters?: Array<CfnBucket.TagFilterProperty | cdk.IResolvable> | cdk.IResolvable;
975 /**
976 * 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` .
977 *
978 * > 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.
979 *
980 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-intelligenttieringconfiguration.html#cfn-s3-bucket-intelligenttieringconfiguration-tierings
981 */
982 readonly tierings: Array<CfnBucket.TieringProperty | cdk.IResolvable> | cdk.IResolvable;
983 }
984}
985export declare namespace CfnBucket {
986 /**
987 * 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* .
988 *
989 * @struct
990 * @stability external
991 *
992 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html
993 */
994 interface InventoryConfigurationProperty {
995 /**
996 * Contains information about where to publish the inventory results.
997 *
998 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-destination
999 */
1000 readonly destination: CfnBucket.DestinationProperty | cdk.IResolvable;
1001 /**
1002 * 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.
1003 *
1004 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-enabled
1005 */
1006 readonly enabled: boolean | cdk.IResolvable;
1007 /**
1008 * The ID used to identify the inventory configuration.
1009 *
1010 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-id
1011 */
1012 readonly id: string;
1013 /**
1014 * 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.
1015 *
1016 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-includedobjectversions
1017 */
1018 readonly includedObjectVersions: string;
1019 /**
1020 * Contains the optional fields that are included in the inventory results.
1021 *
1022 * *Valid values* : `Size | LastModifiedDate | StorageClass | ETag | IsMultipartUploaded | ReplicationStatus | EncryptionStatus | ObjectLockRetainUntilDate | ObjectLockMode | ObjectLockLegalHoldStatus | IntelligentTieringAccessTier | BucketKeyStatus`
1023 *
1024 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-optionalfields
1025 */
1026 readonly optionalFields?: string[];
1027 /**
1028 * Specifies the inventory filter prefix.
1029 *
1030 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-prefix
1031 */
1032 readonly prefix?: string;
1033 /**
1034 * Specifies the schedule for generating inventory results.
1035 *
1036 * *Allowed values* : `Daily` | `Weekly`
1037 *
1038 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-inventoryconfiguration.html#cfn-s3-bucket-inventoryconfiguration-schedulefrequency
1039 */
1040 readonly scheduleFrequency: string;
1041 }
1042}
1043export declare namespace CfnBucket {
1044 /**
1045 * Describes the AWS Lambda functions to invoke and the events for which to invoke them.
1046 *
1047 * @struct
1048 * @stability external
1049 *
1050 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-lambdaconfig.html
1051 */
1052 interface LambdaConfigurationProperty {
1053 /**
1054 * The Amazon S3 bucket event for which to invoke the AWS Lambda function. For more information, see [Supported Event Types](https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html) in the *Amazon S3 User Guide* .
1055 *
1056 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-lambdaconfig.html#cfn-s3-bucket-notificationconfig-lambdaconfig-event
1057 */
1058 readonly event: string;
1059 /**
1060 * 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.
1061 *
1062 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-lambdaconfig.html#cfn-s3-bucket-notificationconfig-lambdaconfig-filter
1063 */
1064 readonly filter?: CfnBucket.NotificationFilterProperty | cdk.IResolvable;
1065 /**
1066 * The Amazon Resource Name (ARN) of the AWS Lambda function that Amazon S3 invokes when the specified event type occurs.
1067 *
1068 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-lambdaconfig.html#cfn-s3-bucket-notificationconfig-lambdaconfig-function
1069 */
1070 readonly function: string;
1071 }
1072}
1073export declare namespace CfnBucket {
1074 /**
1075 * 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* .
1076 *
1077 * @struct
1078 * @stability external
1079 *
1080 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig.html
1081 */
1082 interface LifecycleConfigurationProperty {
1083 /**
1084 * A lifecycle rule for individual objects in an Amazon S3 bucket.
1085 *
1086 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig.html#cfn-s3-bucket-lifecycleconfig-rules
1087 */
1088 readonly rules: Array<CfnBucket.RuleProperty | cdk.IResolvable> | cdk.IResolvable;
1089 }
1090}
1091export declare namespace CfnBucket {
1092 /**
1093 * 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* .
1094 *
1095 * > To successfully complete the `AWS::S3::Bucket LoggingConfiguration` request, you must have `s3:PutObject` and `s3:PutObjectAcl` in your IAM permissions.
1096 *
1097 * @struct
1098 * @stability external
1099 *
1100 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-loggingconfig.html
1101 */
1102 interface LoggingConfigurationProperty {
1103 /**
1104 * 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.
1105 *
1106 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-loggingconfig.html#cfn-s3-bucket-loggingconfig-destinationbucketname
1107 */
1108 readonly destinationBucketName?: string;
1109 /**
1110 * 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.
1111 *
1112 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-loggingconfig.html#cfn-s3-bucket-loggingconfig-logfileprefix
1113 */
1114 readonly logFilePrefix?: string;
1115 }
1116}
1117export declare namespace CfnBucket {
1118 /**
1119 * A container specifying replication metrics-related settings enabling replication metrics and events.
1120 *
1121 * @struct
1122 * @stability external
1123 *
1124 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metrics.html
1125 */
1126 interface MetricsProperty {
1127 /**
1128 * A container specifying the time threshold for emitting the `s3:Replication:OperationMissedThreshold` event.
1129 *
1130 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metrics.html#cfn-s3-bucket-metrics-eventthreshold
1131 */
1132 readonly eventThreshold?: CfnBucket.ReplicationTimeValueProperty | cdk.IResolvable;
1133 /**
1134 * Specifies whether the replication metrics are enabled.
1135 *
1136 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metrics.html#cfn-s3-bucket-metrics-status
1137 */
1138 readonly status: string;
1139 }
1140}
1141export declare namespace CfnBucket {
1142 /**
1143 * 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* .
1144 *
1145 * @struct
1146 * @stability external
1147 *
1148 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html
1149 */
1150 interface MetricsConfigurationProperty {
1151 /**
1152 * The access point that was used while performing operations on the object. The metrics configuration only includes objects that meet the filter's criteria.
1153 *
1154 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html#cfn-s3-bucket-metricsconfiguration-accesspointarn
1155 */
1156 readonly accessPointArn?: string;
1157 /**
1158 * The ID used to identify the metrics configuration. This can be any value you choose that helps you identify your metrics configuration.
1159 *
1160 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html#cfn-s3-bucket-metricsconfiguration-id
1161 */
1162 readonly id: string;
1163 /**
1164 * The prefix that an object must have to be included in the metrics results.
1165 *
1166 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html#cfn-s3-bucket-metricsconfiguration-prefix
1167 */
1168 readonly prefix?: string;
1169 /**
1170 * 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.
1171 *
1172 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-metricsconfiguration.html#cfn-s3-bucket-metricsconfiguration-tagfilters
1173 */
1174 readonly tagFilters?: Array<CfnBucket.TagFilterProperty | cdk.IResolvable> | cdk.IResolvable;
1175 }
1176}
1177export declare namespace CfnBucket {
1178 /**
1179 * Specifies when noncurrent object versions expire. Upon expiration, Amazon 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 Amazon S3 delete noncurrent object versions at a specific period in the object's lifetime.
1180 *
1181 * @struct
1182 * @stability external
1183 *
1184 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration.html
1185 */
1186 interface NoncurrentVersionExpirationProperty {
1187 /**
1188 * Specifies how many noncurrent versions Amazon S3 will retain. If there are this many more recent noncurrent versions, Amazon 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* .
1189 *
1190 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration-newernoncurrentversions
1191 */
1192 readonly newerNoncurrentVersions?: number;
1193 /**
1194 * 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 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* .
1195 *
1196 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration-noncurrentdays
1197 */
1198 readonly noncurrentDays: number;
1199 }
1200}
1201export declare namespace CfnBucket {
1202 /**
1203 * 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.
1204 *
1205 * @struct
1206 * @stability external
1207 *
1208 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition.html
1209 */
1210 interface NoncurrentVersionTransitionProperty {
1211 /**
1212 * Specifies how many noncurrent versions Amazon S3 will retain. If there are this many more recent noncurrent versions, Amazon 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* .
1213 *
1214 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition-newernoncurrentversions
1215 */
1216 readonly newerNoncurrentVersions?: number;
1217 /**
1218 * The class of storage used to store the object.
1219 *
1220 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition-storageclass
1221 */
1222 readonly storageClass: string;
1223 /**
1224 * 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* .
1225 *
1226 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition-transitionindays
1227 */
1228 readonly transitionInDays: number;
1229 }
1230}
1231export declare namespace CfnBucket {
1232 /**
1233 * Describes the notification configuration for an Amazon S3 bucket.
1234 *
1235 * > If you create the target resource and related permissions in the same template, you might have a circular dependency.
1236 * >
1237 * > 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.
1238 * >
1239 * > To avoid this dependency, you can create all resources without specifying the notification configuration. Then, update the stack with a notification configuration.
1240 * >
1241 * > 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) .
1242 *
1243 * @struct
1244 * @stability external
1245 *
1246 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig.html
1247 */
1248 interface NotificationConfigurationProperty {
1249 /**
1250 * Enables delivery of events to Amazon EventBridge.
1251 *
1252 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig.html#cfn-s3-bucket-notificationconfig-eventbridgeconfig
1253 */
1254 readonly eventBridgeConfiguration?: CfnBucket.EventBridgeConfigurationProperty | cdk.IResolvable;
1255 /**
1256 * Describes the AWS Lambda functions to invoke and the events for which to invoke them.
1257 *
1258 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig.html#cfn-s3-bucket-notificationconfig-lambdaconfig
1259 */
1260 readonly lambdaConfigurations?: Array<CfnBucket.LambdaConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
1261 /**
1262 * The Amazon Simple Queue Service queues to publish messages to and the events for which to publish messages.
1263 *
1264 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig.html#cfn-s3-bucket-notificationconfig-queueconfig
1265 */
1266 readonly queueConfigurations?: Array<CfnBucket.QueueConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
1267 /**
1268 * The topic to which notifications are sent and the events for which notifications are generated.
1269 *
1270 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig.html#cfn-s3-bucket-notificationconfig-topicconfig
1271 */
1272 readonly topicConfigurations?: Array<CfnBucket.TopicConfigurationProperty | cdk.IResolvable> | cdk.IResolvable;
1273 }
1274}
1275export declare namespace CfnBucket {
1276 /**
1277 * 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* .
1278 *
1279 * @struct
1280 * @stability external
1281 *
1282 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter.html
1283 */
1284 interface NotificationFilterProperty {
1285 /**
1286 * A container for object key name prefix and suffix filtering rules.
1287 *
1288 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter.html#cfn-s3-bucket-notificationconfiguraiton-config-filter-s3key
1289 */
1290 readonly s3Key: CfnBucket.S3KeyFilterProperty | cdk.IResolvable;
1291 }
1292}
1293export declare namespace CfnBucket {
1294 /**
1295 * 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) .
1296 *
1297 * @struct
1298 * @stability external
1299 *
1300 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockconfiguration.html
1301 */
1302 interface ObjectLockConfigurationProperty {
1303 /**
1304 * Indicates whether this bucket has an Object Lock configuration enabled. Enable `ObjectLockEnabled` when you apply `ObjectLockConfiguration` to a bucket.
1305 *
1306 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockconfiguration.html#cfn-s3-bucket-objectlockconfiguration-objectlockenabled
1307 */
1308 readonly objectLockEnabled?: string;
1309 /**
1310 * 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) .
1311 *
1312 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockconfiguration.html#cfn-s3-bucket-objectlockconfiguration-rule
1313 */
1314 readonly rule?: CfnBucket.ObjectLockRuleProperty | cdk.IResolvable;
1315 }
1316}
1317export declare namespace CfnBucket {
1318 /**
1319 * Specifies the Object Lock rule for the specified object. Enable the this rule when you apply `ObjectLockConfiguration` to a bucket.
1320 *
1321 * @struct
1322 * @stability external
1323 *
1324 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockrule.html
1325 */
1326 interface ObjectLockRuleProperty {
1327 /**
1328 * 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) .
1329 *
1330 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-objectlockrule.html#cfn-s3-bucket-objectlockrule-defaultretention
1331 */
1332 readonly defaultRetention?: CfnBucket.DefaultRetentionProperty | cdk.IResolvable;
1333 }
1334}
1335export declare namespace CfnBucket {
1336 /**
1337 * Specifies the container element for Object Ownership rules.
1338 *
1339 * 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* .
1340 *
1341 * @struct
1342 * @stability external
1343 *
1344 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrols.html
1345 */
1346 interface OwnershipControlsProperty {
1347 /**
1348 * Specifies the container element for Object Ownership rules.
1349 *
1350 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrols.html#cfn-s3-bucket-ownershipcontrols-rules
1351 */
1352 readonly rules: Array<CfnBucket.OwnershipControlsRuleProperty | cdk.IResolvable> | cdk.IResolvable;
1353 }
1354}
1355export declare namespace CfnBucket {
1356 /**
1357 * Specifies an Object Ownership rule.
1358 *
1359 * 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* .
1360 *
1361 * @struct
1362 * @stability external
1363 *
1364 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrolsrule.html
1365 */
1366 interface OwnershipControlsRuleProperty {
1367 /**
1368 * Specifies an Object Ownership rule.
1369 *
1370 * *Allowed values* : `BucketOwnerEnforced` | `ObjectWriter` | `BucketOwnerPreferred`
1371 *
1372 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ownershipcontrolsrule.html#cfn-s3-bucket-ownershipcontrolsrule-objectownership
1373 */
1374 readonly objectOwnership?: string;
1375 }
1376}
1377export declare namespace CfnBucket {
1378 /**
1379 * 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* .
1380 *
1381 * @struct
1382 * @stability external
1383 *
1384 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html
1385 */
1386 interface PublicAccessBlockConfigurationProperty {
1387 /**
1388 * 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:
1389 *
1390 * - PUT Bucket ACL and PUT Object ACL calls fail if the specified ACL is public.
1391 * - PUT Object calls fail if the request includes a public ACL.
1392 * - PUT Bucket calls fail if the request includes a public ACL.
1393 *
1394 * Enabling this setting doesn't affect existing policies or ACLs.
1395 *
1396 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html#cfn-s3-bucket-publicaccessblockconfiguration-blockpublicacls
1397 */
1398 readonly blockPublicAcls?: boolean | cdk.IResolvable;
1399 /**
1400 * 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.
1401 *
1402 * Enabling this setting doesn't affect existing bucket policies.
1403 *
1404 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html#cfn-s3-bucket-publicaccessblockconfiguration-blockpublicpolicy
1405 */
1406 readonly blockPublicPolicy?: boolean | cdk.IResolvable;
1407 /**
1408 * 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.
1409 *
1410 * Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.
1411 *
1412 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html#cfn-s3-bucket-publicaccessblockconfiguration-ignorepublicacls
1413 */
1414 readonly ignorePublicAcls?: boolean | cdk.IResolvable;
1415 /**
1416 * 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.
1417 *
1418 * 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.
1419 *
1420 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-publicaccessblockconfiguration.html#cfn-s3-bucket-publicaccessblockconfiguration-restrictpublicbuckets
1421 */
1422 readonly restrictPublicBuckets?: boolean | cdk.IResolvable;
1423 }
1424}
1425export declare namespace CfnBucket {
1426 /**
1427 * Specifies the configuration for publishing messages to an Amazon Simple Queue Service (Amazon SQS) queue when Amazon S3 detects specified events.
1428 *
1429 * @struct
1430 * @stability external
1431 *
1432 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-queueconfig.html
1433 */
1434 interface QueueConfigurationProperty {
1435 /**
1436 * 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* .
1437 *
1438 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-queueconfig.html#cfn-s3-bucket-notificationconfig-queueconfig-event
1439 */
1440 readonly event: string;
1441 /**
1442 * 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* .
1443 *
1444 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-queueconfig.html#cfn-s3-bucket-notificationconfig-queueconfig-filter
1445 */
1446 readonly filter?: CfnBucket.NotificationFilterProperty | cdk.IResolvable;
1447 /**
1448 * 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.
1449 *
1450 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-queueconfig.html#cfn-s3-bucket-notificationconfig-queueconfig-queue
1451 */
1452 readonly queue: string;
1453 }
1454}
1455export declare namespace CfnBucket {
1456 /**
1457 * Specifies the redirect behavior of all requests to a website endpoint of an Amazon S3 bucket.
1458 *
1459 * @struct
1460 * @stability external
1461 *
1462 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-redirectallrequeststo.html
1463 */
1464 interface RedirectAllRequestsToProperty {
1465 /**
1466 * Name of the host where requests are redirected.
1467 *
1468 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-redirectallrequeststo.html#cfn-s3-websiteconfiguration-redirectallrequeststo-hostname
1469 */
1470 readonly hostName: string;
1471 /**
1472 * Protocol to use when redirecting requests. The default is the protocol that is used in the original request.
1473 *
1474 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-redirectallrequeststo.html#cfn-s3-websiteconfiguration-redirectallrequeststo-protocol
1475 */
1476 readonly protocol?: string;
1477 }
1478}
1479export declare namespace CfnBucket {
1480 /**
1481 * Specifies how requests are redirected. In the event of an error, you can specify a different error code to return.
1482 *
1483 * @struct
1484 * @stability external
1485 *
1486 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html
1487 */
1488 interface RedirectRuleProperty {
1489 /**
1490 * The host name to use in the redirect request.
1491 *
1492 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html#cfn-s3-websiteconfiguration-redirectrule-hostname
1493 */
1494 readonly hostName?: string;
1495 /**
1496 * The HTTP redirect code to use on the response. Not required if one of the siblings is present.
1497 *
1498 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html#cfn-s3-websiteconfiguration-redirectrule-httpredirectcode
1499 */
1500 readonly httpRedirectCode?: string;
1501 /**
1502 * Protocol to use when redirecting requests. The default is the protocol that is used in the original request.
1503 *
1504 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html#cfn-s3-websiteconfiguration-redirectrule-protocol
1505 */
1506 readonly protocol?: string;
1507 /**
1508 * 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.
1509 *
1510 * > 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) .
1511 *
1512 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html#cfn-s3-websiteconfiguration-redirectrule-replacekeyprefixwith
1513 */
1514 readonly replaceKeyPrefixWith?: string;
1515 /**
1516 * 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.
1517 *
1518 * > 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) .
1519 *
1520 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-redirectrule.html#cfn-s3-websiteconfiguration-redirectrule-replacekeywith
1521 */
1522 readonly replaceKeyWith?: string;
1523 }
1524}
1525export declare namespace CfnBucket {
1526 /**
1527 * A filter that you can specify for selection for modifications on replicas.
1528 *
1529 * @struct
1530 * @stability external
1531 *
1532 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicamodifications.html
1533 */
1534 interface ReplicaModificationsProperty {
1535 /**
1536 * Specifies whether Amazon S3 replicates modifications on replicas.
1537 *
1538 * *Allowed values* : `Enabled` | `Disabled`
1539 *
1540 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicamodifications.html#cfn-s3-bucket-replicamodifications-status
1541 */
1542 readonly status: string;
1543 }
1544}
1545export declare namespace CfnBucket {
1546 /**
1547 * A container for replication rules. You can add up to 1,000 rules. The maximum size of a replication configuration is 2 MB.
1548 *
1549 * @struct
1550 * @stability external
1551 *
1552 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration.html
1553 */
1554 interface ReplicationConfigurationProperty {
1555 /**
1556 * The Amazon Resource Name (ARN) of the AWS Identity and Access Management (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* .
1557 *
1558 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration.html#cfn-s3-bucket-replicationconfiguration-role
1559 */
1560 readonly role: string;
1561 /**
1562 * 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.
1563 *
1564 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration.html#cfn-s3-bucket-replicationconfiguration-rules
1565 */
1566 readonly rules: Array<CfnBucket.ReplicationRuleProperty | cdk.IResolvable> | cdk.IResolvable;
1567 }
1568}
1569export declare namespace CfnBucket {
1570 /**
1571 * A container for information about the replication destination and its configurations including enabling the S3 Replication Time Control (S3 RTC).
1572 *
1573 * @struct
1574 * @stability external
1575 *
1576 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html
1577 */
1578 interface ReplicationDestinationProperty {
1579 /**
1580 * 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.
1581 *
1582 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationdestination-accesscontroltranslation
1583 */
1584 readonly accessControlTranslation?: CfnBucket.AccessControlTranslationProperty | cdk.IResolvable;
1585 /**
1586 * 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* .
1587 *
1588 * If you specify the `AccessControlTranslation` property, the `Account` property is required.
1589 *
1590 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationdestination-account
1591 */
1592 readonly account?: string;
1593 /**
1594 * The Amazon Resource Name (ARN) of the bucket where you want Amazon S3 to store the results.
1595 *
1596 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationconfiguration-rules-destination-bucket
1597 */
1598 readonly bucket: string;
1599 /**
1600 * Specifies encryption-related information.
1601 *
1602 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationdestination-encryptionconfiguration
1603 */
1604 readonly encryptionConfiguration?: CfnBucket.EncryptionConfigurationProperty | cdk.IResolvable;
1605 /**
1606 * A container specifying replication metrics-related settings enabling replication metrics and events.
1607 *
1608 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationdestination-metrics
1609 */
1610 readonly metrics?: CfnBucket.MetricsProperty | cdk.IResolvable;
1611 /**
1612 * 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.
1613 *
1614 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationdestination-replicationtime
1615 */
1616 readonly replicationTime?: CfnBucket.ReplicationTimeProperty | cdk.IResolvable;
1617 /**
1618 * 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.
1619 *
1620 * 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* .
1621 *
1622 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules-destination.html#cfn-s3-bucket-replicationconfiguration-rules-destination-storageclass
1623 */
1624 readonly storageClass?: string;
1625 }
1626}
1627export declare namespace CfnBucket {
1628 /**
1629 * Specifies which Amazon S3 objects to replicate and where to store the replicas.
1630 *
1631 * @struct
1632 * @stability external
1633 *
1634 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html
1635 */
1636 interface ReplicationRuleProperty {
1637 /**
1638 * 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) .
1639 *
1640 * For more information about delete marker replication, see [Basic Rule Configuration](https://docs.aws.amazon.com/AmazonS3/latest/dev/delete-marker-replication.html) .
1641 *
1642 * > 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) .
1643 *
1644 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationrule-deletemarkerreplication
1645 */
1646 readonly deleteMarkerReplication?: CfnBucket.DeleteMarkerReplicationProperty | cdk.IResolvable;
1647 /**
1648 * A container for information about the replication destination and its configurations including enabling the S3 Replication Time Control (S3 RTC).
1649 *
1650 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationconfiguration-rules-destination
1651 */
1652 readonly destination: CfnBucket.ReplicationDestinationProperty | cdk.IResolvable;
1653 /**
1654 * 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.
1655 *
1656 * > 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.
1657 *
1658 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationrule-filter
1659 */
1660 readonly filter?: CfnBucket.ReplicationRuleFilterProperty | cdk.IResolvable;
1661 /**
1662 * 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".
1663 *
1664 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationconfiguration-rules-id
1665 */
1666 readonly id?: string;
1667 /**
1668 * 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.
1669 *
1670 * > 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) .
1671 *
1672 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationconfiguration-rules-prefix
1673 */
1674 readonly prefix?: string;
1675 /**
1676 * 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.
1677 *
1678 * For more information, see [Replication](https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html) in the *Amazon S3 User Guide* .
1679 *
1680 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationrule-priority
1681 */
1682 readonly priority?: number;
1683 /**
1684 * 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.
1685 *
1686 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationrule-sourceselectioncriteria
1687 */
1688 readonly sourceSelectionCriteria?: CfnBucket.SourceSelectionCriteriaProperty | cdk.IResolvable;
1689 /**
1690 * Specifies whether the rule is enabled.
1691 *
1692 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationconfiguration-rules.html#cfn-s3-bucket-replicationconfiguration-rules-status
1693 */
1694 readonly status: string;
1695 }
1696}
1697export declare namespace CfnBucket {
1698 /**
1699 * 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.
1700 *
1701 * For example:
1702 *
1703 * - If you specify both a `Prefix` and a `TagFilter` , wrap these filters in an `And` tag.
1704 * - If you specify a filter based on multiple tags, wrap the `TagFilter` elements in an `And` tag
1705 *
1706 * @struct
1707 * @stability external
1708 *
1709 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationruleandoperator.html
1710 */
1711 interface ReplicationRuleAndOperatorProperty {
1712 /**
1713 * An object key name prefix that identifies the subset of objects to which the rule applies.
1714 *
1715 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationruleandoperator.html#cfn-s3-bucket-replicationruleandoperator-prefix
1716 */
1717 readonly prefix?: string;
1718 /**
1719 * An array of tags containing key and value pairs.
1720 *
1721 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationruleandoperator.html#cfn-s3-bucket-replicationruleandoperator-tagfilters
1722 */
1723 readonly tagFilters?: Array<CfnBucket.TagFilterProperty | cdk.IResolvable> | cdk.IResolvable;
1724 }
1725}
1726export declare namespace CfnBucket {
1727 /**
1728 * 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.
1729 *
1730 * @struct
1731 * @stability external
1732 *
1733 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrulefilter.html
1734 */
1735 interface ReplicationRuleFilterProperty {
1736 /**
1737 * 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:
1738 *
1739 * - If you specify both a `Prefix` and a `TagFilter` , wrap these filters in an `And` tag.
1740 * - If you specify a filter based on multiple tags, wrap the `TagFilter` elements in an `And` tag.
1741 *
1742 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrulefilter.html#cfn-s3-bucket-replicationrulefilter-and
1743 */
1744 readonly and?: CfnBucket.ReplicationRuleAndOperatorProperty | cdk.IResolvable;
1745 /**
1746 * An object key name prefix that identifies the subset of objects to which the rule applies.
1747 *
1748 * > 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) .
1749 *
1750 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrulefilter.html#cfn-s3-bucket-replicationrulefilter-prefix
1751 */
1752 readonly prefix?: string;
1753 /**
1754 * A container for specifying a tag key and value.
1755 *
1756 * The rule applies only to objects that have the tag in their tag set.
1757 *
1758 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationrulefilter.html#cfn-s3-bucket-replicationrulefilter-tagfilter
1759 */
1760 readonly tagFilter?: CfnBucket.TagFilterProperty | cdk.IResolvable;
1761 }
1762}
1763export declare namespace CfnBucket {
1764 /**
1765 * 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.
1766 *
1767 * @struct
1768 * @stability external
1769 *
1770 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtime.html
1771 */
1772 interface ReplicationTimeProperty {
1773 /**
1774 * Specifies whether the replication time is enabled.
1775 *
1776 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtime.html#cfn-s3-bucket-replicationtime-status
1777 */
1778 readonly status: string;
1779 /**
1780 * A container specifying the time by which replication should be complete for all objects and operations on objects.
1781 *
1782 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtime.html#cfn-s3-bucket-replicationtime-time
1783 */
1784 readonly time: CfnBucket.ReplicationTimeValueProperty | cdk.IResolvable;
1785 }
1786}
1787export declare namespace CfnBucket {
1788 /**
1789 * A container specifying the time value for S3 Replication Time Control (S3 RTC) and replication metrics `EventThreshold` .
1790 *
1791 * @struct
1792 * @stability external
1793 *
1794 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtimevalue.html
1795 */
1796 interface ReplicationTimeValueProperty {
1797 /**
1798 * Contains an integer specifying time in minutes.
1799 *
1800 * Valid value: 15
1801 *
1802 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-replicationtimevalue.html#cfn-s3-bucket-replicationtimevalue-minutes
1803 */
1804 readonly minutes: number;
1805 }
1806}
1807export declare namespace CfnBucket {
1808 /**
1809 * 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* .
1810 *
1811 * @struct
1812 * @stability external
1813 *
1814 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules.html
1815 */
1816 interface RoutingRuleProperty {
1817 /**
1818 * Container for redirect information. You can redirect requests to another host, to another page, or with another protocol. In the event of an error, you can specify a different error code to return.
1819 *
1820 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules.html#cfn-s3-websiteconfiguration-routingrules-redirectrule
1821 */
1822 readonly redirectRule: CfnBucket.RedirectRuleProperty | cdk.IResolvable;
1823 /**
1824 * 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.
1825 *
1826 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules.html#cfn-s3-websiteconfiguration-routingrules-routingrulecondition
1827 */
1828 readonly routingRuleCondition?: CfnBucket.RoutingRuleConditionProperty | cdk.IResolvable;
1829 }
1830}
1831export declare namespace CfnBucket {
1832 /**
1833 * 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.
1834 *
1835 * @struct
1836 * @stability external
1837 *
1838 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-routingrulecondition.html
1839 */
1840 interface RoutingRuleConditionProperty {
1841 /**
1842 * 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.
1843 *
1844 * 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.
1845 *
1846 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-routingrulecondition.html#cfn-s3-websiteconfiguration-routingrules-routingrulecondition-httperrorcodereturnedequals
1847 */
1848 readonly httpErrorCodeReturnedEquals?: string;
1849 /**
1850 * 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.
1851 *
1852 * 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.
1853 *
1854 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration-routingrules-routingrulecondition.html#cfn-s3-websiteconfiguration-routingrules-routingrulecondition-keyprefixequals
1855 */
1856 readonly keyPrefixEquals?: string;
1857 }
1858}
1859export declare namespace CfnBucket {
1860 /**
1861 * 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* .
1862 *
1863 * You must specify at least one of the following properties: `AbortIncompleteMultipartUpload` , `ExpirationDate` , `ExpirationInDays` , `NoncurrentVersionExpirationInDays` , `NoncurrentVersionTransition` , `NoncurrentVersionTransitions` , `Transition` , or `Transitions` .
1864 *
1865 * @struct
1866 * @stability external
1867 *
1868 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html
1869 */
1870 interface RuleProperty {
1871 /**
1872 * Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3 bucket.
1873 *
1874 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-rule-abortincompletemultipartupload
1875 */
1876 readonly abortIncompleteMultipartUpload?: CfnBucket.AbortIncompleteMultipartUploadProperty | cdk.IResolvable;
1877 /**
1878 * 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.
1879 *
1880 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-expirationdate
1881 */
1882 readonly expirationDate?: Date | cdk.IResolvable;
1883 /**
1884 * 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.
1885 *
1886 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-expirationindays
1887 */
1888 readonly expirationInDays?: number;
1889 /**
1890 * 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` .
1891 *
1892 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-rule-expiredobjectdeletemarker
1893 */
1894 readonly expiredObjectDeleteMarker?: boolean | cdk.IResolvable;
1895 /**
1896 * Unique identifier for the rule. The value can't be longer than 255 characters.
1897 *
1898 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-id
1899 */
1900 readonly id?: string;
1901 /**
1902 * Specifies when noncurrent object versions expire. Upon expiration, Amazon 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 Amazon S3 delete noncurrent object versions at a specific period in the object's lifetime.
1903 *
1904 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversionexpiration
1905 */
1906 readonly noncurrentVersionExpiration?: CfnBucket.NoncurrentVersionExpirationProperty | cdk.IResolvable;
1907 /**
1908 * (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.
1909 *
1910 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversionexpirationindays
1911 */
1912 readonly noncurrentVersionExpirationInDays?: number;
1913 /**
1914 * (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.
1915 *
1916 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversiontransition
1917 */
1918 readonly noncurrentVersionTransition?: CfnBucket.NoncurrentVersionTransitionProperty | cdk.IResolvable;
1919 /**
1920 * 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.
1921 *
1922 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-noncurrentversiontransitions
1923 */
1924 readonly noncurrentVersionTransitions?: Array<CfnBucket.NoncurrentVersionTransitionProperty | cdk.IResolvable> | cdk.IResolvable;
1925 /**
1926 * 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* .
1927 *
1928 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-objectsizegreaterthan
1929 */
1930 readonly objectSizeGreaterThan?: number;
1931 /**
1932 * 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* .
1933 *
1934 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-objectsizelessthan
1935 */
1936 readonly objectSizeLessThan?: number;
1937 /**
1938 * Object key prefix that identifies one or more objects to which this rule applies.
1939 *
1940 * > 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) .
1941 *
1942 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-prefix
1943 */
1944 readonly prefix?: string;
1945 /**
1946 * If `Enabled` , the rule is currently being applied. If `Disabled` , the rule is not currently being applied.
1947 *
1948 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-status
1949 */
1950 readonly status: string;
1951 /**
1952 * Tags to use to identify a subset of objects to which the lifecycle rule applies.
1953 *
1954 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-rule-tagfilters
1955 */
1956 readonly tagFilters?: Array<CfnBucket.TagFilterProperty | cdk.IResolvable> | cdk.IResolvable;
1957 /**
1958 * (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.
1959 *
1960 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-transition
1961 */
1962 readonly transition?: CfnBucket.TransitionProperty | cdk.IResolvable;
1963 /**
1964 * 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.
1965 *
1966 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule.html#cfn-s3-bucket-lifecycleconfig-rule-transitions
1967 */
1968 readonly transitions?: Array<CfnBucket.TransitionProperty | cdk.IResolvable> | cdk.IResolvable;
1969 }
1970}
1971export declare namespace CfnBucket {
1972 /**
1973 * 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* .
1974 *
1975 * > The same type of filter rule cannot be used more than once. For example, you cannot specify two prefix rules.
1976 *
1977 * @struct
1978 * @stability external
1979 *
1980 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter-s3key.html
1981 */
1982 interface S3KeyFilterProperty {
1983 /**
1984 * A list of containers for the key-value pair that defines the criteria for the filter rule.
1985 *
1986 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfiguration-config-filter-s3key.html#cfn-s3-bucket-notificationconfiguraiton-config-filter-s3key-rules
1987 */
1988 readonly rules: Array<CfnBucket.FilterRuleProperty | cdk.IResolvable> | cdk.IResolvable;
1989 }
1990}
1991export declare namespace CfnBucket {
1992 /**
1993 * 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* .
1994 *
1995 * @struct
1996 * @stability external
1997 *
1998 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionbydefault.html
1999 */
2000 interface ServerSideEncryptionByDefaultProperty {
2001 /**
2002 * KMS key ID to use for the default encryption. This parameter is allowed if SSEAlgorithm is aws:kms.
2003 *
2004 * You can specify the key ID or the Amazon Resource Name (ARN) of the CMK. However, if you are using encryption with cross-account operations, you must use a fully qualified CMK 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) .
2005 *
2006 * For example:
2007 *
2008 * - Key ID: `1234abcd-12ab-34cd-56ef-1234567890ab`
2009 * - Key ARN: `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
2010 *
2011 * > Amazon S3 only supports symmetric KMS keys and not asymmetric KMS keys. For more information, see [Using Symmetric and Asymmetric Keys](https://docs.aws.amazon.com//kms/latest/developerguide/symmetric-asymmetric.html) in the *AWS Key Management Service Developer Guide* .
2012 *
2013 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionbydefault.html#cfn-s3-bucket-serversideencryptionbydefault-kmsmasterkeyid
2014 */
2015 readonly kmsMasterKeyId?: string;
2016 /**
2017 * Server-side encryption algorithm to use for the default encryption.
2018 *
2019 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionbydefault.html#cfn-s3-bucket-serversideencryptionbydefault-ssealgorithm
2020 */
2021 readonly sseAlgorithm: string;
2022 }
2023}
2024export declare namespace CfnBucket {
2025 /**
2026 * Specifies the default server-side encryption configuration.
2027 *
2028 * @struct
2029 * @stability external
2030 *
2031 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionrule.html
2032 */
2033 interface ServerSideEncryptionRuleProperty {
2034 /**
2035 * 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.
2036 *
2037 * 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* .
2038 *
2039 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionrule.html#cfn-s3-bucket-serversideencryptionrule-bucketkeyenabled
2040 */
2041 readonly bucketKeyEnabled?: boolean | cdk.IResolvable;
2042 /**
2043 * 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.
2044 *
2045 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-serversideencryptionrule.html#cfn-s3-bucket-serversideencryptionrule-serversideencryptionbydefault
2046 */
2047 readonly serverSideEncryptionByDefault?: CfnBucket.ServerSideEncryptionByDefaultProperty | cdk.IResolvable;
2048 }
2049}
2050export declare namespace CfnBucket {
2051 /**
2052 * 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.
2053 *
2054 * @struct
2055 * @stability external
2056 *
2057 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-sourceselectioncriteria.html
2058 */
2059 interface SourceSelectionCriteriaProperty {
2060 /**
2061 * A filter that you can specify for selection for modifications on replicas.
2062 *
2063 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-sourceselectioncriteria.html#cfn-s3-bucket-sourceselectioncriteria-replicamodifications
2064 */
2065 readonly replicaModifications?: CfnBucket.ReplicaModificationsProperty | cdk.IResolvable;
2066 /**
2067 * A container for filter information for the selection of Amazon S3 objects encrypted with AWS KMS.
2068 *
2069 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-sourceselectioncriteria.html#cfn-s3-bucket-sourceselectioncriteria-ssekmsencryptedobjects
2070 */
2071 readonly sseKmsEncryptedObjects?: CfnBucket.SseKmsEncryptedObjectsProperty | cdk.IResolvable;
2072 }
2073}
2074export declare namespace CfnBucket {
2075 /**
2076 * A container for filter information for the selection of S3 objects encrypted with AWS KMS.
2077 *
2078 * @struct
2079 * @stability external
2080 *
2081 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ssekmsencryptedobjects.html
2082 */
2083 interface SseKmsEncryptedObjectsProperty {
2084 /**
2085 * Specifies whether Amazon S3 replicates objects created with server-side encryption using an AWS KMS key stored in AWS Key Management Service.
2086 *
2087 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-ssekmsencryptedobjects.html#cfn-s3-bucket-ssekmsencryptedobjects-status
2088 */
2089 readonly status: string;
2090 }
2091}
2092export declare namespace CfnBucket {
2093 /**
2094 * 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.
2095 *
2096 * @struct
2097 * @stability external
2098 *
2099 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-storageclassanalysis.html
2100 */
2101 interface StorageClassAnalysisProperty {
2102 /**
2103 * Specifies how data related to the storage class analysis for an Amazon S3 bucket should be exported.
2104 *
2105 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-storageclassanalysis.html#cfn-s3-bucket-storageclassanalysis-dataexport
2106 */
2107 readonly dataExport?: CfnBucket.DataExportProperty | cdk.IResolvable;
2108 }
2109}
2110export declare namespace CfnBucket {
2111 /**
2112 * Specifies tags to use to identify a subset of objects for an Amazon S3 bucket.
2113 *
2114 * @struct
2115 * @stability external
2116 *
2117 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tagfilter.html
2118 */
2119 interface TagFilterProperty {
2120 /**
2121 * The tag key.
2122 *
2123 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tagfilter.html#cfn-s3-bucket-tagfilter-key
2124 */
2125 readonly key: string;
2126 /**
2127 * The tag value.
2128 *
2129 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tagfilter.html#cfn-s3-bucket-tagfilter-value
2130 */
2131 readonly value: string;
2132 }
2133}
2134export declare namespace CfnBucket {
2135 /**
2136 * 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.
2137 *
2138 * @struct
2139 * @stability external
2140 *
2141 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tiering.html
2142 */
2143 interface TieringProperty {
2144 /**
2145 * 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.
2146 *
2147 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tiering.html#cfn-s3-bucket-tiering-accesstier
2148 */
2149 readonly accessTier: string;
2150 /**
2151 * The number of consecutive days of no access after which an object will be eligible to be transitioned to the corresponding tier. The minimum number of days specified for Archive Access tier must be at least 90 days and Deep Archive Access tier must be at least 180 days. The maximum can be up to 2 years (730 days).
2152 *
2153 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-tiering.html#cfn-s3-bucket-tiering-days
2154 */
2155 readonly days: number;
2156 }
2157}
2158export declare namespace CfnBucket {
2159 /**
2160 * 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.
2161 *
2162 * @struct
2163 * @stability external
2164 *
2165 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-topicconfig.html
2166 */
2167 interface TopicConfigurationProperty {
2168 /**
2169 * 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* .
2170 *
2171 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-topicconfig.html#cfn-s3-bucket-notificationconfig-topicconfig-event
2172 */
2173 readonly event: string;
2174 /**
2175 * 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.
2176 *
2177 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-topicconfig.html#cfn-s3-bucket-notificationconfig-topicconfig-filter
2178 */
2179 readonly filter?: CfnBucket.NotificationFilterProperty | cdk.IResolvable;
2180 /**
2181 * The Amazon Resource Name (ARN) of the Amazon SNS topic to which Amazon S3 publishes a message when it detects events of the specified type.
2182 *
2183 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-notificationconfig-topicconfig.html#cfn-s3-bucket-notificationconfig-topicconfig-topic
2184 */
2185 readonly topic: string;
2186 }
2187}
2188export declare namespace CfnBucket {
2189 /**
2190 * 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* .
2191 *
2192 * @struct
2193 * @stability external
2194 *
2195 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-transition.html
2196 */
2197 interface TransitionProperty {
2198 /**
2199 * The storage class to which you want the object to transition.
2200 *
2201 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-transition.html#cfn-s3-bucket-lifecycleconfig-rule-transition-storageclass
2202 */
2203 readonly storageClass: string;
2204 /**
2205 * 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.
2206 *
2207 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-transition.html#cfn-s3-bucket-lifecycleconfig-rule-transition-transitiondate
2208 */
2209 readonly transitionDate?: Date | cdk.IResolvable;
2210 /**
2211 * Indicates the number of days after creation when objects are transitioned to the specified storage class. The value must be a positive integer.
2212 *
2213 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-lifecycleconfig-rule-transition.html#cfn-s3-bucket-lifecycleconfig-rule-transition-transitionindays
2214 */
2215 readonly transitionInDays?: number;
2216 }
2217}
2218export declare namespace CfnBucket {
2219 /**
2220 * 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* .
2221 *
2222 * @struct
2223 * @stability external
2224 *
2225 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-versioningconfig.html
2226 */
2227 interface VersioningConfigurationProperty {
2228 /**
2229 * The versioning state of the bucket.
2230 *
2231 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-bucket-versioningconfig.html#cfn-s3-bucket-versioningconfig-status
2232 */
2233 readonly status: string;
2234 }
2235}
2236export declare namespace CfnBucket {
2237 /**
2238 * Specifies website configuration parameters for an Amazon S3 bucket.
2239 *
2240 * @struct
2241 * @stability external
2242 *
2243 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html
2244 */
2245 interface WebsiteConfigurationProperty {
2246 /**
2247 * The name of the error document for the website.
2248 *
2249 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html#cfn-s3-websiteconfiguration-errordocument
2250 */
2251 readonly errorDocument?: string;
2252 /**
2253 * The name of the index document for the website.
2254 *
2255 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html#cfn-s3-websiteconfiguration-indexdocument
2256 */
2257 readonly indexDocument?: string;
2258 /**
2259 * The redirect behavior for every request to this bucket's website endpoint.
2260 *
2261 * > If you specify this property, you can't specify any other property.
2262 *
2263 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html#cfn-s3-websiteconfiguration-redirectallrequeststo
2264 */
2265 readonly redirectAllRequestsTo?: CfnBucket.RedirectAllRequestsToProperty | cdk.IResolvable;
2266 /**
2267 * Rules that define when a redirect is applied and the redirect behavior.
2268 *
2269 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-websiteconfiguration.html#cfn-s3-websiteconfiguration-routingrules
2270 */
2271 readonly routingRules?: Array<CfnBucket.RoutingRuleProperty | cdk.IResolvable> | cdk.IResolvable;
2272 }
2273}
2274/**
2275 * Properties for defining a `CfnBucketPolicy`
2276 *
2277 * @struct
2278 * @stability external
2279 *
2280 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html
2281 */
2282export interface CfnBucketPolicyProps {
2283 /**
2284 * The name of the Amazon S3 bucket to which the policy applies.
2285 *
2286 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html#aws-properties-s3-policy-bucket
2287 */
2288 readonly bucket: string;
2289 /**
2290 * A policy document containing permissions to add to the specified bucket. In IAM, you must provide policy documents in JSON format. However, in CloudFormation you can provide the policy in JSON or YAML format because CloudFormation converts YAML to JSON before submitting it to IAM. For more information, see the AWS::IAM::Policy [PolicyDocument](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html#cfn-iam-policy-policydocument) resource description in this guide and [Access Policy Language Overview](https://docs.aws.amazon.com/AmazonS3/latest/dev/access-policy-language-overview.html) in the *Amazon S3 User Guide* .
2291 *
2292 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html#aws-properties-s3-policy-policydocument
2293 */
2294 readonly policyDocument: any | cdk.IResolvable;
2295}
2296/**
2297 * A CloudFormation `AWS::S3::BucketPolicy`
2298 *
2299 * Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are using an identity other than the root user of the AWS account that owns the bucket, the calling identity must have the `PutBucketPolicy` permissions on the specified bucket and belong to the bucket owner's account in order to use this operation.
2300 *
2301 * If you don't have `PutBucketPolicy` permissions, Amazon S3 returns a `403 Access Denied` error. If you have the correct permissions, but you're not using an identity that belongs to the bucket owner's account, Amazon S3 returns a `405 Method Not Allowed` error.
2302 *
2303 * > As a security precaution, the root user of the AWS account that owns a bucket can always use this operation, even if the policy explicitly denies the root user the ability to perform this action.
2304 *
2305 * For more information, see [Bucket policy examples](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html) .
2306 *
2307 * The following operations are related to `PutBucketPolicy` :
2308 *
2309 * - [CreateBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)
2310 * - [DeleteBucket](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html)
2311 *
2312 * @cloudformationResource AWS::S3::BucketPolicy
2313 * @stability external
2314 *
2315 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html
2316 */
2317export declare class CfnBucketPolicy extends cdk.CfnResource implements cdk.IInspectable {
2318 /**
2319 * The CloudFormation resource type name for this resource class.
2320 */
2321 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::BucketPolicy";
2322 /**
2323 * A factory method that creates a new instance of this class from an object
2324 * containing the CloudFormation properties of this resource.
2325 * Used in the @aws-cdk/cloudformation-include module.
2326 *
2327 * @internal
2328 */
2329 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnBucketPolicy;
2330 /**
2331 * The name of the Amazon S3 bucket to which the policy applies.
2332 *
2333 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html#aws-properties-s3-policy-bucket
2334 */
2335 bucket: string;
2336 /**
2337 * A policy document containing permissions to add to the specified bucket. In IAM, you must provide policy documents in JSON format. However, in CloudFormation you can provide the policy in JSON or YAML format because CloudFormation converts YAML to JSON before submitting it to IAM. For more information, see the AWS::IAM::Policy [PolicyDocument](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-policy.html#cfn-iam-policy-policydocument) resource description in this guide and [Access Policy Language Overview](https://docs.aws.amazon.com/AmazonS3/latest/dev/access-policy-language-overview.html) in the *Amazon S3 User Guide* .
2338 *
2339 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-policy.html#aws-properties-s3-policy-policydocument
2340 */
2341 policyDocument: any | cdk.IResolvable;
2342 /**
2343 * Create a new `AWS::S3::BucketPolicy`.
2344 *
2345 * @param scope - scope in which this resource is defined
2346 * @param id - scoped id of the resource
2347 * @param props - resource properties
2348 */
2349 constructor(scope: cdk.Construct, id: string, props: CfnBucketPolicyProps);
2350 /**
2351 * Examines the CloudFormation resource and discloses attributes.
2352 *
2353 * @param inspector - tree inspector to collect and process attributes
2354 *
2355 */
2356 inspect(inspector: cdk.TreeInspector): void;
2357 protected get cfnProperties(): {
2358 [key: string]: any;
2359 };
2360 protected renderProperties(props: {
2361 [key: string]: any;
2362 }): {
2363 [key: string]: any;
2364 };
2365}
2366/**
2367 * Properties for defining a `CfnMultiRegionAccessPoint`
2368 *
2369 * @struct
2370 * @stability external
2371 *
2372 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html
2373 */
2374export interface CfnMultiRegionAccessPointProps {
2375 /**
2376 * A collection of the Regions and buckets associated with the Multi-Region Access Point.
2377 *
2378 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-regions
2379 */
2380 readonly regions: Array<CfnMultiRegionAccessPoint.RegionProperty | cdk.IResolvable> | cdk.IResolvable;
2381 /**
2382 * The name of the Multi-Region Access Point.
2383 *
2384 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-name
2385 */
2386 readonly name?: string;
2387 /**
2388 * The PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. For more information about when Amazon S3 considers an 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* .
2389 *
2390 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration
2391 */
2392 readonly publicAccessBlockConfiguration?: CfnMultiRegionAccessPoint.PublicAccessBlockConfigurationProperty | cdk.IResolvable;
2393}
2394/**
2395 * A CloudFormation `AWS::S3::MultiRegionAccessPoint`
2396 *
2397 * The `AWS::S3::MultiRegionAccessPoint` resource creates an Amazon S3 Multi-Region Access Point. To learn more about Multi-Region Access Points, see [Multi-Region Access Points in Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPoints.html) in the in the *Amazon S3 User Guide* .
2398 *
2399 * @cloudformationResource AWS::S3::MultiRegionAccessPoint
2400 * @stability external
2401 *
2402 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html
2403 */
2404export declare class CfnMultiRegionAccessPoint extends cdk.CfnResource implements cdk.IInspectable {
2405 /**
2406 * The CloudFormation resource type name for this resource class.
2407 */
2408 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::MultiRegionAccessPoint";
2409 /**
2410 * A factory method that creates a new instance of this class from an object
2411 * containing the CloudFormation properties of this resource.
2412 * Used in the @aws-cdk/cloudformation-include module.
2413 *
2414 * @internal
2415 */
2416 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnMultiRegionAccessPoint;
2417 /**
2418 * The alias for the Multi-Region Access Point. For more information about the distinction between the name and the alias of an Multi-Region Access Point, see [Managing Multi-Region Access Points](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html#multi-region-access-point-naming) in the *Amazon S3 User Guide* .
2419 * @cloudformationAttribute Alias
2420 */
2421 readonly attrAlias: string;
2422 /**
2423 * The timestamp of when the Multi-Region Access Point is created.
2424 * @cloudformationAttribute CreatedAt
2425 */
2426 readonly attrCreatedAt: string;
2427 /**
2428 * A collection of the Regions and buckets associated with the Multi-Region Access Point.
2429 *
2430 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-regions
2431 */
2432 regions: Array<CfnMultiRegionAccessPoint.RegionProperty | cdk.IResolvable> | cdk.IResolvable;
2433 /**
2434 * The name of the Multi-Region Access Point.
2435 *
2436 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-name
2437 */
2438 name: string | undefined;
2439 /**
2440 * The PublicAccessBlock configuration that you want to apply to this Multi-Region Access Point. You can enable the configuration options in any combination. For more information about when Amazon S3 considers an 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* .
2441 *
2442 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspoint.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration
2443 */
2444 publicAccessBlockConfiguration: CfnMultiRegionAccessPoint.PublicAccessBlockConfigurationProperty | cdk.IResolvable | undefined;
2445 /**
2446 * Create a new `AWS::S3::MultiRegionAccessPoint`.
2447 *
2448 * @param scope - scope in which this resource is defined
2449 * @param id - scoped id of the resource
2450 * @param props - resource properties
2451 */
2452 constructor(scope: cdk.Construct, id: string, props: CfnMultiRegionAccessPointProps);
2453 /**
2454 * Examines the CloudFormation resource and discloses attributes.
2455 *
2456 * @param inspector - tree inspector to collect and process attributes
2457 *
2458 */
2459 inspect(inspector: cdk.TreeInspector): void;
2460 protected get cfnProperties(): {
2461 [key: string]: any;
2462 };
2463 protected renderProperties(props: {
2464 [key: string]: any;
2465 }): {
2466 [key: string]: any;
2467 };
2468}
2469export declare namespace CfnMultiRegionAccessPoint {
2470 /**
2471 * The PublicAccessBlock configuration that you want to apply to this Amazon S3 Multi-Region Access Point. You can enable the configuration options in any combination. For more information about when Amazon S3 considers an 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* .
2472 *
2473 * @struct
2474 * @stability external
2475 *
2476 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-publicaccessblockconfiguration.html
2477 */
2478 interface PublicAccessBlockConfigurationProperty {
2479 /**
2480 * 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:
2481 *
2482 * - PUT Bucket ACL and PUT Object ACL calls fail if the specified ACL is public.
2483 * - PUT Object calls fail if the request includes a public ACL.
2484 * - PUT Bucket calls fail if the request includes a public ACL.
2485 *
2486 * Enabling this setting doesn't affect existing policies or ACLs.
2487 *
2488 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-publicaccessblockconfiguration.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration-blockpublicacls
2489 */
2490 readonly blockPublicAcls?: boolean | cdk.IResolvable;
2491 /**
2492 * 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.
2493 *
2494 * Enabling this setting doesn't affect existing bucket policies.
2495 *
2496 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-publicaccessblockconfiguration.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration-blockpublicpolicy
2497 */
2498 readonly blockPublicPolicy?: boolean | cdk.IResolvable;
2499 /**
2500 * 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.
2501 *
2502 * Enabling this setting doesn't affect the persistence of any existing ACLs and doesn't prevent new public ACLs from being set.
2503 *
2504 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-publicaccessblockconfiguration.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration-ignorepublicacls
2505 */
2506 readonly ignorePublicAcls?: boolean | cdk.IResolvable;
2507 /**
2508 * 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.
2509 *
2510 * 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.
2511 *
2512 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-publicaccessblockconfiguration.html#cfn-s3-multiregionaccesspoint-publicaccessblockconfiguration-restrictpublicbuckets
2513 */
2514 readonly restrictPublicBuckets?: boolean | cdk.IResolvable;
2515 }
2516}
2517export declare namespace CfnMultiRegionAccessPoint {
2518 /**
2519 * A bucket associated with a specific Region when creating Multi-Region Access Points.
2520 *
2521 * @struct
2522 * @stability external
2523 *
2524 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-region.html
2525 */
2526 interface RegionProperty {
2527 /**
2528 * The name of the associated bucket for the Region.
2529 *
2530 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-region.html#cfn-s3-multiregionaccesspoint-region-bucket
2531 */
2532 readonly bucket: string;
2533 /**
2534 * `CfnMultiRegionAccessPoint.RegionProperty.BucketAccountId`
2535 *
2536 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspoint-region.html#cfn-s3-multiregionaccesspoint-region-bucketaccountid
2537 */
2538 readonly bucketAccountId?: string;
2539 }
2540}
2541/**
2542 * Properties for defining a `CfnMultiRegionAccessPointPolicy`
2543 *
2544 * @struct
2545 * @stability external
2546 *
2547 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html
2548 */
2549export interface CfnMultiRegionAccessPointPolicyProps {
2550 /**
2551 * The name of the Multi-Region Access Point.
2552 *
2553 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html#cfn-s3-multiregionaccesspointpolicy-mrapname
2554 */
2555 readonly mrapName: string;
2556 /**
2557 * The access policy associated with the Multi-Region Access Point.
2558 *
2559 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html#cfn-s3-multiregionaccesspointpolicy-policy
2560 */
2561 readonly policy: any | cdk.IResolvable;
2562}
2563/**
2564 * A CloudFormation `AWS::S3::MultiRegionAccessPointPolicy`
2565 *
2566 * Applies an Amazon S3 access policy to an Amazon S3 Multi-Region Access Point.
2567 *
2568 * It is not possible to delete an access policy for a Multi-Region Access Point from the CloudFormation template. When you attempt to delete the policy, CloudFormation updates the policy using `DeletionPolicy:Retain` and `UpdateReplacePolicy:Retain` . CloudFormation updates the policy to only allow access to the account that created the bucket.
2569 *
2570 * @cloudformationResource AWS::S3::MultiRegionAccessPointPolicy
2571 * @stability external
2572 *
2573 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html
2574 */
2575export declare class CfnMultiRegionAccessPointPolicy extends cdk.CfnResource implements cdk.IInspectable {
2576 /**
2577 * The CloudFormation resource type name for this resource class.
2578 */
2579 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::MultiRegionAccessPointPolicy";
2580 /**
2581 * A factory method that creates a new instance of this class from an object
2582 * containing the CloudFormation properties of this resource.
2583 * Used in the @aws-cdk/cloudformation-include module.
2584 *
2585 * @internal
2586 */
2587 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnMultiRegionAccessPointPolicy;
2588 /**
2589 *
2590 * @cloudformationAttribute PolicyStatus.IsPublic
2591 */
2592 readonly attrPolicyStatusIsPublic: string;
2593 /**
2594 * The name of the Multi-Region Access Point.
2595 *
2596 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html#cfn-s3-multiregionaccesspointpolicy-mrapname
2597 */
2598 mrapName: string;
2599 /**
2600 * The access policy associated with the Multi-Region Access Point.
2601 *
2602 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-multiregionaccesspointpolicy.html#cfn-s3-multiregionaccesspointpolicy-policy
2603 */
2604 policy: any | cdk.IResolvable;
2605 /**
2606 * Create a new `AWS::S3::MultiRegionAccessPointPolicy`.
2607 *
2608 * @param scope - scope in which this resource is defined
2609 * @param id - scoped id of the resource
2610 * @param props - resource properties
2611 */
2612 constructor(scope: cdk.Construct, id: string, props: CfnMultiRegionAccessPointPolicyProps);
2613 /**
2614 * Examines the CloudFormation resource and discloses attributes.
2615 *
2616 * @param inspector - tree inspector to collect and process attributes
2617 *
2618 */
2619 inspect(inspector: cdk.TreeInspector): void;
2620 protected get cfnProperties(): {
2621 [key: string]: any;
2622 };
2623 protected renderProperties(props: {
2624 [key: string]: any;
2625 }): {
2626 [key: string]: any;
2627 };
2628}
2629export declare namespace CfnMultiRegionAccessPointPolicy {
2630 /**
2631 * The container element for a bucket's policy status.
2632 *
2633 * @struct
2634 * @stability external
2635 *
2636 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspointpolicy-policystatus.html
2637 */
2638 interface PolicyStatusProperty {
2639 /**
2640 * The policy status for this bucket. `TRUE` indicates that this bucket is public. `FALSE` indicates that the bucket is not public.
2641 *
2642 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-multiregionaccesspointpolicy-policystatus.html#cfn-s3-multiregionaccesspointpolicy-policystatus-ispublic
2643 */
2644 readonly isPublic: string;
2645 }
2646}
2647/**
2648 * Properties for defining a `CfnStorageLens`
2649 *
2650 * @struct
2651 * @stability external
2652 *
2653 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html
2654 */
2655export interface CfnStorageLensProps {
2656 /**
2657 * This resource contains the details Amazon S3 Storage Lens configuration.
2658 *
2659 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html#cfn-s3-storagelens-storagelensconfiguration
2660 */
2661 readonly storageLensConfiguration: CfnStorageLens.StorageLensConfigurationProperty | cdk.IResolvable;
2662 /**
2663 * A set of tags (key–value pairs) to associate with the Storage Lens configuration.
2664 *
2665 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html#cfn-s3-storagelens-tags
2666 */
2667 readonly tags?: cdk.CfnTag[];
2668}
2669/**
2670 * A CloudFormation `AWS::S3::StorageLens`
2671 *
2672 * The AWS::S3::StorageLens resource creates an Amazon S3 Storage Lens configuration.
2673 *
2674 * @cloudformationResource AWS::S3::StorageLens
2675 * @stability external
2676 *
2677 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html
2678 */
2679export declare class CfnStorageLens extends cdk.CfnResource implements cdk.IInspectable {
2680 /**
2681 * The CloudFormation resource type name for this resource class.
2682 */
2683 static readonly CFN_RESOURCE_TYPE_NAME = "AWS::S3::StorageLens";
2684 /**
2685 * A factory method that creates a new instance of this class from an object
2686 * containing the CloudFormation properties of this resource.
2687 * Used in the @aws-cdk/cloudformation-include module.
2688 *
2689 * @internal
2690 */
2691 static _fromCloudFormation(scope: cdk.Construct, id: string, resourceAttributes: any, options: cfn_parse.FromCloudFormationOptions): CfnStorageLens;
2692 /**
2693 * This property contains the details of the ARN of the S3 Storage Lens configuration. This property is read-only.
2694 * @cloudformationAttribute StorageLensConfiguration.StorageLensArn
2695 */
2696 readonly attrStorageLensConfigurationStorageLensArn: string;
2697 /**
2698 * This resource contains the details Amazon S3 Storage Lens configuration.
2699 *
2700 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html#cfn-s3-storagelens-storagelensconfiguration
2701 */
2702 storageLensConfiguration: CfnStorageLens.StorageLensConfigurationProperty | cdk.IResolvable;
2703 /**
2704 * A set of tags (key–value pairs) to associate with the Storage Lens configuration.
2705 *
2706 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3-storagelens.html#cfn-s3-storagelens-tags
2707 */
2708 readonly tags: cdk.TagManager;
2709 /**
2710 * Create a new `AWS::S3::StorageLens`.
2711 *
2712 * @param scope - scope in which this resource is defined
2713 * @param id - scoped id of the resource
2714 * @param props - resource properties
2715 */
2716 constructor(scope: cdk.Construct, id: string, props: CfnStorageLensProps);
2717 /**
2718 * Examines the CloudFormation resource and discloses attributes.
2719 *
2720 * @param inspector - tree inspector to collect and process attributes
2721 *
2722 */
2723 inspect(inspector: cdk.TreeInspector): void;
2724 protected get cfnProperties(): {
2725 [key: string]: any;
2726 };
2727 protected renderProperties(props: {
2728 [key: string]: any;
2729 }): {
2730 [key: string]: any;
2731 };
2732}
2733export declare namespace CfnStorageLens {
2734 /**
2735 * This resource contains the details of the account-level metrics for Amazon S3 Storage Lens.
2736 *
2737 * @struct
2738 * @stability external
2739 *
2740 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html
2741 */
2742 interface AccountLevelProperty {
2743 /**
2744 * This property contains the details of account-level activity metrics for S3 Storage Lens.
2745 *
2746 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html#cfn-s3-storagelens-accountlevel-activitymetrics
2747 */
2748 readonly activityMetrics?: CfnStorageLens.ActivityMetricsProperty | cdk.IResolvable;
2749 /**
2750 * This property contains the details of account-level advanced cost optimization metrics for S3 Storage Lens.
2751 *
2752 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html#cfn-s3-storagelens-accountlevel-advancedcostoptimizationmetrics
2753 */
2754 readonly advancedCostOptimizationMetrics?: CfnStorageLens.AdvancedCostOptimizationMetricsProperty | cdk.IResolvable;
2755 /**
2756 * This property contains the details of account-level advanced data protection metrics for S3 Storage Lens.
2757 *
2758 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html#cfn-s3-storagelens-accountlevel-advanceddataprotectionmetrics
2759 */
2760 readonly advancedDataProtectionMetrics?: CfnStorageLens.AdvancedDataProtectionMetricsProperty | cdk.IResolvable;
2761 /**
2762 * This property contains the details of the account-level bucket-level configurations for Amazon S3 Storage Lens.
2763 *
2764 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html#cfn-s3-storagelens-accountlevel-bucketlevel
2765 */
2766 readonly bucketLevel: CfnStorageLens.BucketLevelProperty | cdk.IResolvable;
2767 /**
2768 * This property contains the details of account-level detailed status code metrics for S3 Storage Lens.
2769 *
2770 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-accountlevel.html#cfn-s3-storagelens-accountlevel-detailedstatuscodesmetrics
2771 */
2772 readonly detailedStatusCodesMetrics?: CfnStorageLens.DetailedStatusCodesMetricsProperty | cdk.IResolvable;
2773 }
2774}
2775export declare namespace CfnStorageLens {
2776 /**
2777 * This resource enables Amazon S3 Storage Lens activity metrics. Activity metrics show details about how your storage is requested, such as requests (for example, All requests, Get requests, Put requests), bytes uploaded or downloaded, and errors.
2778 *
2779 * For more information, see [Assessing your storage activity and usage with S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html) in the *Amazon S3 User Guide* . For a complete list of metrics, see [S3 Storage Lens metrics glossary](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html) in the *Amazon S3 User Guide* .
2780 *
2781 * @struct
2782 * @stability external
2783 *
2784 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-activitymetrics.html
2785 */
2786 interface ActivityMetricsProperty {
2787 /**
2788 * A property that indicates whether the activity metrics is enabled.
2789 *
2790 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-activitymetrics.html#cfn-s3-storagelens-activitymetrics-isenabled
2791 */
2792 readonly isEnabled?: boolean | cdk.IResolvable;
2793 }
2794}
2795export declare namespace CfnStorageLens {
2796 /**
2797 * This resource enables Amazon S3 Storage Lens advanced cost optimization metrics. Advanced cost optimization metrics provide insights that you can use to manage and optimize your storage costs, for example, lifecycle rule counts for transitions, expirations, and incomplete multipart uploads.
2798 *
2799 * For more information, see [Assessing your storage activity and usage with S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html) in the *Amazon S3 User Guide* . For a complete list of metrics, see [S3 Storage Lens metrics glossary](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html) in the *Amazon S3 User Guide* .
2800 *
2801 * @struct
2802 * @stability external
2803 *
2804 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-advancedcostoptimizationmetrics.html
2805 */
2806 interface AdvancedCostOptimizationMetricsProperty {
2807 /**
2808 * Indicates whether advanced cost optimization metrics are enabled.
2809 *
2810 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-advancedcostoptimizationmetrics.html#cfn-s3-storagelens-advancedcostoptimizationmetrics-isenabled
2811 */
2812 readonly isEnabled?: boolean | cdk.IResolvable;
2813 }
2814}
2815export declare namespace CfnStorageLens {
2816 /**
2817 * This resource enables Amazon S3 Storage Lens advanced data protection metrics. Advanced data protection metrics provide insights that you can use to perform audits and protect your data, for example replication rule counts within and across Regions.
2818 *
2819 * For more information, see [Assessing your storage activity and usage with S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html) in the *Amazon S3 User Guide* . For a complete list of metrics, see [S3 Storage Lens metrics glossary](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html) in the *Amazon S3 User Guide* .
2820 *
2821 * @struct
2822 * @stability external
2823 *
2824 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-advanceddataprotectionmetrics.html
2825 */
2826 interface AdvancedDataProtectionMetricsProperty {
2827 /**
2828 * Indicates whether advanced data protection metrics are enabled.
2829 *
2830 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-advanceddataprotectionmetrics.html#cfn-s3-storagelens-advanceddataprotectionmetrics-isenabled
2831 */
2832 readonly isEnabled?: boolean | cdk.IResolvable;
2833 }
2834}
2835export declare namespace CfnStorageLens {
2836 /**
2837 * This resource contains the details of the AWS Organization for Amazon S3 Storage Lens.
2838 *
2839 * @struct
2840 * @stability external
2841 *
2842 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-awsorg.html
2843 */
2844 interface AwsOrgProperty {
2845 /**
2846 * This resource contains the ARN of the AWS Organization.
2847 *
2848 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-awsorg.html#cfn-s3-storagelens-awsorg-arn
2849 */
2850 readonly arn: string;
2851 }
2852}
2853export declare namespace CfnStorageLens {
2854 /**
2855 * A property for the bucket-level storage metrics for Amazon S3 Storage Lens.
2856 *
2857 * @struct
2858 * @stability external
2859 *
2860 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html
2861 */
2862 interface BucketLevelProperty {
2863 /**
2864 * A property for bucket-level activity metrics for S3 Storage Lens.
2865 *
2866 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html#cfn-s3-storagelens-bucketlevel-activitymetrics
2867 */
2868 readonly activityMetrics?: CfnStorageLens.ActivityMetricsProperty | cdk.IResolvable;
2869 /**
2870 * A property for bucket-level advanced cost optimization metrics for S3 Storage Lens.
2871 *
2872 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html#cfn-s3-storagelens-bucketlevel-advancedcostoptimizationmetrics
2873 */
2874 readonly advancedCostOptimizationMetrics?: CfnStorageLens.AdvancedCostOptimizationMetricsProperty | cdk.IResolvable;
2875 /**
2876 * A property for bucket-level advanced data protection metrics for S3 Storage Lens.
2877 *
2878 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html#cfn-s3-storagelens-bucketlevel-advanceddataprotectionmetrics
2879 */
2880 readonly advancedDataProtectionMetrics?: CfnStorageLens.AdvancedDataProtectionMetricsProperty | cdk.IResolvable;
2881 /**
2882 * A property for bucket-level detailed status code metrics for S3 Storage Lens.
2883 *
2884 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html#cfn-s3-storagelens-bucketlevel-detailedstatuscodesmetrics
2885 */
2886 readonly detailedStatusCodesMetrics?: CfnStorageLens.DetailedStatusCodesMetricsProperty | cdk.IResolvable;
2887 /**
2888 * A property for bucket-level prefix-level storage metrics for S3 Storage Lens.
2889 *
2890 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketlevel.html#cfn-s3-storagelens-bucketlevel-prefixlevel
2891 */
2892 readonly prefixLevel?: CfnStorageLens.PrefixLevelProperty | cdk.IResolvable;
2893 }
2894}
2895export declare namespace CfnStorageLens {
2896 /**
2897 * This resource contains the details of the buckets and Regions for the Amazon S3 Storage Lens configuration.
2898 *
2899 * @struct
2900 * @stability external
2901 *
2902 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketsandregions.html
2903 */
2904 interface BucketsAndRegionsProperty {
2905 /**
2906 * This property contains the details of the buckets for the Amazon S3 Storage Lens configuration. This should be the bucket Amazon Resource Name(ARN). For valid values, see [Buckets ARN format here](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_Include.html#API_control_Include_Contents) in the *Amazon S3 API Reference* .
2907 *
2908 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketsandregions.html#cfn-s3-storagelens-bucketsandregions-buckets
2909 */
2910 readonly buckets?: string[];
2911 /**
2912 * This property contains the details of the Regions for the S3 Storage Lens configuration.
2913 *
2914 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-bucketsandregions.html#cfn-s3-storagelens-bucketsandregions-regions
2915 */
2916 readonly regions?: string[];
2917 }
2918}
2919export declare namespace CfnStorageLens {
2920 /**
2921 * This resource enables the Amazon CloudWatch publishing option for Amazon S3 Storage Lens metrics.
2922 *
2923 * For more information, see [Monitor S3 Storage Lens metrics in CloudWatch](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_view_metrics_cloudwatch.html) in the *Amazon S3 User Guide* .
2924 *
2925 * @struct
2926 * @stability external
2927 *
2928 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-cloudwatchmetrics.html
2929 */
2930 interface CloudWatchMetricsProperty {
2931 /**
2932 * This property identifies whether the CloudWatch publishing option for S3 Storage Lens is enabled.
2933 *
2934 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-cloudwatchmetrics.html#cfn-s3-storagelens-cloudwatchmetrics-isenabled
2935 */
2936 readonly isEnabled: boolean | cdk.IResolvable;
2937 }
2938}
2939export declare namespace CfnStorageLens {
2940 /**
2941 * This resource contains the details of the Amazon S3 Storage Lens metrics export.
2942 *
2943 * @struct
2944 * @stability external
2945 *
2946 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-dataexport.html
2947 */
2948 interface DataExportProperty {
2949 /**
2950 * This property enables the Amazon CloudWatch publishing option for S3 Storage Lens metrics.
2951 *
2952 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-dataexport.html#cfn-s3-storagelens-dataexport-cloudwatchmetrics
2953 */
2954 readonly cloudWatchMetrics?: CfnStorageLens.CloudWatchMetricsProperty | cdk.IResolvable;
2955 /**
2956 * This property contains the details of the bucket where the S3 Storage Lens metrics export will be placed.
2957 *
2958 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-dataexport.html#cfn-s3-storagelens-dataexport-s3bucketdestination
2959 */
2960 readonly s3BucketDestination?: CfnStorageLens.S3BucketDestinationProperty | cdk.IResolvable;
2961 }
2962}
2963export declare namespace CfnStorageLens {
2964 /**
2965 * This resource enables Amazon S3 Storage Lens detailed status code metrics. Detailed status code metrics generate metrics for HTTP status codes, such as `200 OK` , `403 Forbidden` , `503 Service Unavailable` and others.
2966 *
2967 * For more information, see [Assessing your storage activity and usage with S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens.html) in the *Amazon S3 User Guide* . For a complete list of metrics, see [S3 Storage Lens metrics glossary](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_metrics_glossary.html) in the *Amazon S3 User Guide* .
2968 *
2969 * @struct
2970 * @stability external
2971 *
2972 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-detailedstatuscodesmetrics.html
2973 */
2974 interface DetailedStatusCodesMetricsProperty {
2975 /**
2976 * Indicates whether detailed status code metrics are enabled.
2977 *
2978 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-detailedstatuscodesmetrics.html#cfn-s3-storagelens-detailedstatuscodesmetrics-isenabled
2979 */
2980 readonly isEnabled?: boolean | cdk.IResolvable;
2981 }
2982}
2983export declare namespace CfnStorageLens {
2984 /**
2985 * This resource contains the type of server-side encryption used to encrypt an Amazon S3 Storage Lens metrics export. For valid values, see the [StorageLensDataExportEncryption](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_StorageLensDataExportEncryption.html) in the *Amazon S3 API Reference* .
2986 *
2987 * @struct
2988 * @stability external
2989 *
2990 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-encryption.html
2991 */
2992 interface EncryptionProperty {
2993 /**
2994 * Specifies the use of AWS Key Management Service keys (SSE-KMS) to encrypt the S3 Storage Lens metrics export file.
2995 *
2996 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-encryption.html#cfn-s3-storagelens-encryption-ssekms
2997 */
2998 readonly ssekms?: CfnStorageLens.SSEKMSProperty | cdk.IResolvable;
2999 /**
3000 * Specifies the use of an Amazon S3-managed key (SSE-S3) to encrypt the S3 Storage Lens metrics export file.
3001 *
3002 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-encryption.html#cfn-s3-storagelens-encryption-sses3
3003 */
3004 readonly sses3?: any | cdk.IResolvable;
3005 }
3006}
3007export declare namespace CfnStorageLens {
3008 /**
3009 * This resource contains the details of the prefix-level of the Amazon S3 Storage Lens.
3010 *
3011 * @struct
3012 * @stability external
3013 *
3014 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-prefixlevel.html
3015 */
3016 interface PrefixLevelProperty {
3017 /**
3018 * A property for the prefix-level storage metrics for Amazon S3 Storage Lens.
3019 *
3020 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-prefixlevel.html#cfn-s3-storagelens-prefixlevel-storagemetrics
3021 */
3022 readonly storageMetrics: CfnStorageLens.PrefixLevelStorageMetricsProperty | cdk.IResolvable;
3023 }
3024}
3025export declare namespace CfnStorageLens {
3026 /**
3027 * This resource contains the details of the prefix-level storage metrics for Amazon S3 Storage Lens.
3028 *
3029 * @struct
3030 * @stability external
3031 *
3032 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-prefixlevelstoragemetrics.html
3033 */
3034 interface PrefixLevelStorageMetricsProperty {
3035 /**
3036 * This property identifies whether the details of the prefix-level storage metrics for S3 Storage Lens are enabled.
3037 *
3038 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-prefixlevelstoragemetrics.html#cfn-s3-storagelens-prefixlevelstoragemetrics-isenabled
3039 */
3040 readonly isEnabled?: boolean | cdk.IResolvable;
3041 /**
3042 * This property identifies whether the details of the prefix-level storage metrics for S3 Storage Lens are enabled.
3043 *
3044 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-prefixlevelstoragemetrics.html#cfn-s3-storagelens-prefixlevelstoragemetrics-selectioncriteria
3045 */
3046 readonly selectionCriteria?: CfnStorageLens.SelectionCriteriaProperty | cdk.IResolvable;
3047 }
3048}
3049export declare namespace CfnStorageLens {
3050 /**
3051 * This resource contains the details of the bucket where the Amazon S3 Storage Lens metrics export will be placed.
3052 *
3053 * @struct
3054 * @stability external
3055 *
3056 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html
3057 */
3058 interface S3BucketDestinationProperty {
3059 /**
3060 * This property contains the details of the AWS account ID of the S3 Storage Lens export bucket destination.
3061 *
3062 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-accountid
3063 */
3064 readonly accountId: string;
3065 /**
3066 * This property contains the details of the ARN of the bucket destination of the S3 Storage Lens export.
3067 *
3068 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-arn
3069 */
3070 readonly arn: string;
3071 /**
3072 * This property contains the details of the encryption of the bucket destination of the Amazon S3 Storage Lens metrics export.
3073 *
3074 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-encryption
3075 */
3076 readonly encryption?: CfnStorageLens.EncryptionProperty | cdk.IResolvable;
3077 /**
3078 * This property contains the details of the format of the S3 Storage Lens export bucket destination.
3079 *
3080 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-format
3081 */
3082 readonly format: string;
3083 /**
3084 * This property contains the details of the output schema version of the S3 Storage Lens export bucket destination.
3085 *
3086 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-outputschemaversion
3087 */
3088 readonly outputSchemaVersion: string;
3089 /**
3090 * This property contains the details of the prefix of the bucket destination of the S3 Storage Lens export .
3091 *
3092 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-s3bucketdestination.html#cfn-s3-storagelens-s3bucketdestination-prefix
3093 */
3094 readonly prefix?: string;
3095 }
3096}
3097export declare namespace CfnStorageLens {
3098 /**
3099 * Specifies the use of server-side encryption using an AWS Key Management Service key (SSE-KMS) to encrypt the delivered S3 Storage Lens metrics export file.
3100 *
3101 * @struct
3102 * @stability external
3103 *
3104 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-ssekms.html
3105 */
3106 interface SSEKMSProperty {
3107 /**
3108 * Specifies the Amazon Resource Name (ARN) of the customer managed AWS KMS key to use for encrypting the S3 Storage Lens metrics export file. Amazon S3 only supports symmetric encryption keys. For more information, see [Special-purpose keys](https://docs.aws.amazon.com/kms/latest/developerguide/key-types.html) in the *AWS Key Management Service Developer Guide* .
3109 *
3110 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-ssekms.html#cfn-s3-storagelens-ssekms-keyid
3111 */
3112 readonly keyId: string;
3113 }
3114}
3115export declare namespace CfnStorageLens {
3116 /**
3117 * This resource contains the details of the Amazon S3 Storage Lens selection criteria.
3118 *
3119 * @struct
3120 * @stability external
3121 *
3122 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-selectioncriteria.html
3123 */
3124 interface SelectionCriteriaProperty {
3125 /**
3126 * This property contains the details of the S3 Storage Lens delimiter being used.
3127 *
3128 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-selectioncriteria.html#cfn-s3-storagelens-selectioncriteria-delimiter
3129 */
3130 readonly delimiter?: string;
3131 /**
3132 * This property contains the details of the max depth that S3 Storage Lens will collect metrics up to.
3133 *
3134 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-selectioncriteria.html#cfn-s3-storagelens-selectioncriteria-maxdepth
3135 */
3136 readonly maxDepth?: number;
3137 /**
3138 * This property contains the details of the minimum storage bytes percentage threshold that S3 Storage Lens will collect metrics up to.
3139 *
3140 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-selectioncriteria.html#cfn-s3-storagelens-selectioncriteria-minstoragebytespercentage
3141 */
3142 readonly minStorageBytesPercentage?: number;
3143 }
3144}
3145export declare namespace CfnStorageLens {
3146 /**
3147 * This is the property of the Amazon S3 Storage Lens configuration.
3148 *
3149 * @struct
3150 * @stability external
3151 *
3152 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html
3153 */
3154 interface StorageLensConfigurationProperty {
3155 /**
3156 * This property contains the details of the account-level metrics for Amazon S3 Storage Lens configuration.
3157 *
3158 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-accountlevel
3159 */
3160 readonly accountLevel: CfnStorageLens.AccountLevelProperty | cdk.IResolvable;
3161 /**
3162 * This property contains the details of the AWS Organization for the S3 Storage Lens configuration.
3163 *
3164 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-awsorg
3165 */
3166 readonly awsOrg?: CfnStorageLens.AwsOrgProperty | cdk.IResolvable;
3167 /**
3168 * This property contains the details of this S3 Storage Lens configuration's metrics export.
3169 *
3170 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-dataexport
3171 */
3172 readonly dataExport?: CfnStorageLens.DataExportProperty | cdk.IResolvable;
3173 /**
3174 * This property contains the details of the bucket and or Regions excluded for Amazon S3 Storage Lens configuration.
3175 *
3176 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-exclude
3177 */
3178 readonly exclude?: CfnStorageLens.BucketsAndRegionsProperty | cdk.IResolvable;
3179 /**
3180 * This property contains the details of the ID of the S3 Storage Lens configuration.
3181 *
3182 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-id
3183 */
3184 readonly id: string;
3185 /**
3186 * This property contains the details of the bucket and or Regions included for Amazon S3 Storage Lens configuration.
3187 *
3188 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-include
3189 */
3190 readonly include?: CfnStorageLens.BucketsAndRegionsProperty | cdk.IResolvable;
3191 /**
3192 * This property contains the details of whether the Amazon S3 Storage Lens configuration is enabled.
3193 *
3194 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-isenabled
3195 */
3196 readonly isEnabled: boolean | cdk.IResolvable;
3197 /**
3198 * This property contains the details of the ARN of the S3 Storage Lens configuration. This property is read-only.
3199 *
3200 * @link http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-s3-storagelens-storagelensconfiguration.html#cfn-s3-storagelens-storagelensconfiguration-storagelensarn
3201 */
3202 readonly storageLensArn?: string;
3203 }
3204}