@pulumi/aws 6.56.0 → 6.56.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/s3/bucket.d.ts CHANGED
@@ -6,20 +6,22 @@ import { PolicyDocument } from "../iam";
6
6
  /**
7
7
  * Provides a S3 bucket resource.
8
8
  *
9
- * > This resource provides functionality for managing S3 general purpose buckets in an AWS Partition. To manage Amazon S3 Express directory buckets, use the `awsDirectoryBucket` resource. To manage [S3 on Outposts](https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html), use the `aws.s3control.Bucket` resource.
10
- *
11
- * > Object Lock can be enabled by using the `objectLockEnable` attribute or by using the `aws.s3.BucketObjectLockConfigurationV2` resource. Please note, that by using the resource, Object Lock can be enabled/disabled without destroying and recreating the bucket.
9
+ * > **NOTE:** Please use [aws.s3.BucketV2](https://www.pulumi.com/registry/packages/aws/api-docs/s3/bucketv2) instead.
10
+ * This resource is maintained for backwards compatibility only. Please see [BucketV2 Migration
11
+ * Guide](https://www.pulumi.com/registry/packages/aws/how-to-guides/bucketv2-migration/) for instructions on migrating
12
+ * existing Bucket resources to BucketV2.
12
13
  *
13
14
  * ## Example Usage
14
15
  *
15
- * ### Private Bucket With Tags
16
+ * ### Private Bucket w/ Tags
16
17
  *
17
18
  * ```typescript
18
19
  * import * as pulumi from "@pulumi/pulumi";
19
20
  * import * as aws from "@pulumi/aws";
20
21
  *
21
- * const example = new aws.s3.BucketV2("example", {
22
+ * const b = new aws.s3.Bucket("b", {
22
23
  * bucket: "my-tf-test-bucket",
24
+ * acl: aws.s3.CannedAcl.Private,
23
25
  * tags: {
24
26
  * Name: "My bucket",
25
27
  * Environment: "Dev",
@@ -27,13 +29,323 @@ import { PolicyDocument } from "../iam";
27
29
  * });
28
30
  * ```
29
31
  *
32
+ * ### Static Website Hosting
33
+ *
34
+ * ```typescript
35
+ * import * as pulumi from "@pulumi/pulumi";
36
+ * import * as aws from "@pulumi/aws";
37
+ * import * as std from "@pulumi/std";
38
+ *
39
+ * const b = new aws.s3.Bucket("b", {
40
+ * bucket: "s3-website-test.mydomain.com",
41
+ * acl: aws.s3.CannedAcl.PublicRead,
42
+ * policy: std.file({
43
+ * input: "policy.json",
44
+ * }).then(invoke => invoke.result),
45
+ * website: {
46
+ * indexDocument: "index.html",
47
+ * errorDocument: "error.html",
48
+ * routingRules: `[{
49
+ * "Condition": {
50
+ * "KeyPrefixEquals": "docs/"
51
+ * },
52
+ * "Redirect": {
53
+ * "ReplaceKeyPrefixWith": "documents/"
54
+ * }
55
+ * }]
56
+ * `,
57
+ * },
58
+ * });
59
+ * ```
60
+ *
61
+ * ### Using CORS
62
+ *
63
+ * ```typescript
64
+ * import * as pulumi from "@pulumi/pulumi";
65
+ * import * as aws from "@pulumi/aws";
66
+ *
67
+ * const b = new aws.s3.Bucket("b", {
68
+ * bucket: "s3-website-test.mydomain.com",
69
+ * acl: aws.s3.CannedAcl.PublicRead,
70
+ * corsRules: [{
71
+ * allowedHeaders: ["*"],
72
+ * allowedMethods: [
73
+ * "PUT",
74
+ * "POST",
75
+ * ],
76
+ * allowedOrigins: ["https://s3-website-test.mydomain.com"],
77
+ * exposeHeaders: ["ETag"],
78
+ * maxAgeSeconds: 3000,
79
+ * }],
80
+ * });
81
+ * ```
82
+ *
83
+ * ### Using versioning
84
+ *
85
+ * ```typescript
86
+ * import * as pulumi from "@pulumi/pulumi";
87
+ * import * as aws from "@pulumi/aws";
88
+ *
89
+ * const b = new aws.s3.Bucket("b", {
90
+ * bucket: "my-tf-test-bucket",
91
+ * acl: aws.s3.CannedAcl.Private,
92
+ * versioning: {
93
+ * enabled: true,
94
+ * },
95
+ * });
96
+ * ```
97
+ *
98
+ * ### Enable Logging
99
+ *
100
+ * ```typescript
101
+ * import * as pulumi from "@pulumi/pulumi";
102
+ * import * as aws from "@pulumi/aws";
103
+ *
104
+ * const logBucket = new aws.s3.Bucket("log_bucket", {
105
+ * bucket: "my-tf-log-bucket",
106
+ * acl: aws.s3.CannedAcl.LogDeliveryWrite,
107
+ * });
108
+ * const b = new aws.s3.Bucket("b", {
109
+ * bucket: "my-tf-test-bucket",
110
+ * acl: aws.s3.CannedAcl.Private,
111
+ * loggings: [{
112
+ * targetBucket: logBucket.id,
113
+ * targetPrefix: "log/",
114
+ * }],
115
+ * });
116
+ * ```
117
+ *
118
+ * ### Using object lifecycle
119
+ *
120
+ * ```typescript
121
+ * import * as pulumi from "@pulumi/pulumi";
122
+ * import * as aws from "@pulumi/aws";
123
+ *
124
+ * const bucket = new aws.s3.Bucket("bucket", {
125
+ * bucket: "my-bucket",
126
+ * acl: aws.s3.CannedAcl.Private,
127
+ * lifecycleRules: [
128
+ * {
129
+ * id: "log",
130
+ * enabled: true,
131
+ * prefix: "log/",
132
+ * tags: {
133
+ * rule: "log",
134
+ * autoclean: "true",
135
+ * },
136
+ * transitions: [
137
+ * {
138
+ * days: 30,
139
+ * storageClass: "STANDARD_IA",
140
+ * },
141
+ * {
142
+ * days: 60,
143
+ * storageClass: "GLACIER",
144
+ * },
145
+ * ],
146
+ * expiration: {
147
+ * days: 90,
148
+ * },
149
+ * },
150
+ * {
151
+ * id: "tmp",
152
+ * prefix: "tmp/",
153
+ * enabled: true,
154
+ * expiration: {
155
+ * date: "2016-01-12",
156
+ * },
157
+ * },
158
+ * ],
159
+ * });
160
+ * const versioningBucket = new aws.s3.Bucket("versioning_bucket", {
161
+ * bucket: "my-versioning-bucket",
162
+ * acl: aws.s3.CannedAcl.Private,
163
+ * versioning: {
164
+ * enabled: true,
165
+ * },
166
+ * lifecycleRules: [{
167
+ * prefix: "config/",
168
+ * enabled: true,
169
+ * noncurrentVersionTransitions: [
170
+ * {
171
+ * days: 30,
172
+ * storageClass: "STANDARD_IA",
173
+ * },
174
+ * {
175
+ * days: 60,
176
+ * storageClass: "GLACIER",
177
+ * },
178
+ * ],
179
+ * noncurrentVersionExpiration: {
180
+ * days: 90,
181
+ * },
182
+ * }],
183
+ * });
184
+ * ```
185
+ *
186
+ * ### Using replication configuration
187
+ *
188
+ * > **NOTE:** See the `aws.s3.BucketReplicationConfig` resource to support bi-directional replication configuration and additional features.
189
+ *
190
+ * ```typescript
191
+ * import * as pulumi from "@pulumi/pulumi";
192
+ * import * as aws from "@pulumi/aws";
193
+ *
194
+ * const replication = new aws.iam.Role("replication", {
195
+ * name: "tf-iam-role-replication-12345",
196
+ * assumeRolePolicy: `{
197
+ * "Version": "2012-10-17",
198
+ * "Statement": [
199
+ * {
200
+ * "Action": "sts:AssumeRole",
201
+ * "Principal": {
202
+ * "Service": "s3.amazonaws.com"
203
+ * },
204
+ * "Effect": "Allow",
205
+ * "Sid": ""
206
+ * }
207
+ * ]
208
+ * }
209
+ * `,
210
+ * });
211
+ * const destination = new aws.s3.Bucket("destination", {
212
+ * bucket: "tf-test-bucket-destination-12345",
213
+ * versioning: {
214
+ * enabled: true,
215
+ * },
216
+ * });
217
+ * const source = new aws.s3.Bucket("source", {
218
+ * bucket: "tf-test-bucket-source-12345",
219
+ * acl: aws.s3.CannedAcl.Private,
220
+ * versioning: {
221
+ * enabled: true,
222
+ * },
223
+ * replicationConfiguration: {
224
+ * role: replication.arn,
225
+ * rules: [{
226
+ * id: "foobar",
227
+ * status: "Enabled",
228
+ * filter: {
229
+ * tags: {},
230
+ * },
231
+ * destination: {
232
+ * bucket: destination.arn,
233
+ * storageClass: "STANDARD",
234
+ * replicationTime: {
235
+ * status: "Enabled",
236
+ * minutes: 15,
237
+ * },
238
+ * metrics: {
239
+ * status: "Enabled",
240
+ * minutes: 15,
241
+ * },
242
+ * },
243
+ * }],
244
+ * },
245
+ * });
246
+ * const replicationPolicy = new aws.iam.Policy("replication", {
247
+ * name: "tf-iam-role-policy-replication-12345",
248
+ * policy: pulumi.interpolate`{
249
+ * "Version": "2012-10-17",
250
+ * "Statement": [
251
+ * {
252
+ * "Action": [
253
+ * "s3:GetReplicationConfiguration",
254
+ * "s3:ListBucket"
255
+ * ],
256
+ * "Effect": "Allow",
257
+ * "Resource": [
258
+ * "${source.arn}"
259
+ * ]
260
+ * },
261
+ * {
262
+ * "Action": [
263
+ * "s3:GetObjectVersionForReplication",
264
+ * "s3:GetObjectVersionAcl",
265
+ * "s3:GetObjectVersionTagging"
266
+ * ],
267
+ * "Effect": "Allow",
268
+ * "Resource": [
269
+ * "${source.arn}/*"
270
+ * ]
271
+ * },
272
+ * {
273
+ * "Action": [
274
+ * "s3:ReplicateObject",
275
+ * "s3:ReplicateDelete",
276
+ * "s3:ReplicateTags"
277
+ * ],
278
+ * "Effect": "Allow",
279
+ * "Resource": "${destination.arn}/*"
280
+ * }
281
+ * ]
282
+ * }
283
+ * `,
284
+ * });
285
+ * const replicationRolePolicyAttachment = new aws.iam.RolePolicyAttachment("replication", {
286
+ * role: replication.name,
287
+ * policyArn: replicationPolicy.arn,
288
+ * });
289
+ * ```
290
+ *
291
+ * ### Enable Default Server Side Encryption
292
+ *
293
+ * ```typescript
294
+ * import * as pulumi from "@pulumi/pulumi";
295
+ * import * as aws from "@pulumi/aws";
296
+ *
297
+ * const mykey = new aws.kms.Key("mykey", {
298
+ * description: "This key is used to encrypt bucket objects",
299
+ * deletionWindowInDays: 10,
300
+ * });
301
+ * const mybucket = new aws.s3.Bucket("mybucket", {
302
+ * bucket: "mybucket",
303
+ * serverSideEncryptionConfiguration: {
304
+ * rule: {
305
+ * applyServerSideEncryptionByDefault: {
306
+ * kmsMasterKeyId: mykey.arn,
307
+ * sseAlgorithm: "aws:kms",
308
+ * },
309
+ * },
310
+ * },
311
+ * });
312
+ * ```
313
+ *
314
+ * ### Using ACL policy grants
315
+ *
316
+ * ```typescript
317
+ * import * as pulumi from "@pulumi/pulumi";
318
+ * import * as aws from "@pulumi/aws";
319
+ *
320
+ * const currentUser = aws.s3.getCanonicalUserId({});
321
+ * const bucket = new aws.s3.Bucket("bucket", {
322
+ * bucket: "mybucket",
323
+ * grants: [
324
+ * {
325
+ * id: currentUser.then(currentUser => currentUser.id),
326
+ * type: "CanonicalUser",
327
+ * permissions: ["FULL_CONTROL"],
328
+ * },
329
+ * {
330
+ * type: "Group",
331
+ * permissions: [
332
+ * "READ_ACP",
333
+ * "WRITE",
334
+ * ],
335
+ * uri: "http://acs.amazonaws.com/groups/s3/LogDelivery",
336
+ * },
337
+ * ],
338
+ * });
339
+ * ```
340
+ *
30
341
  * ## Import
31
342
  *
32
- * Using `pulumi import`, import S3 bucket using the `bucket`. For example:
343
+ * S3 bucket can be imported using the `bucket`, e.g.,
33
344
  *
34
345
  * ```sh
35
346
  * $ pulumi import aws:s3/bucket:Bucket bucket bucket-name
36
347
  * ```
348
+ * The `policy` argument is not imported and will be deprecated in a future version of the provider. Use the `aws_s3_bucket_policy` resource to manage the S3 Bucket Policy instead.
37
349
  */
38
350
  export declare class Bucket extends pulumi.CustomResource {
39
351
  /**
@@ -52,24 +364,23 @@ export declare class Bucket extends pulumi.CustomResource {
52
364
  */
53
365
  static isInstance(obj: any): obj is Bucket;
54
366
  /**
55
- * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`. Cannot be used in `cn-north-1` or `us-gov-west-1`. This provider will only perform drift detection if a configuration value is provided.
56
- * Use the resource `aws.s3.BucketAccelerateConfigurationV2` instead.
367
+ * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`.
57
368
  */
58
369
  readonly accelerationStatus: pulumi.Output<string>;
59
370
  /**
60
- * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
371
+ * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`.
61
372
  */
62
373
  readonly acl: pulumi.Output<string | undefined>;
63
374
  /**
64
- * ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
375
+ * The ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
65
376
  */
66
377
  readonly arn: pulumi.Output<string>;
67
378
  /**
68
- * Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). The name must not be in the format `[bucketName]--[azid]--x-s3`. Use the `aws.s3.DirectoryBucket` resource to manage S3 Express buckets.
379
+ * The name of the bucket. If omitted, this provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
69
380
  */
70
381
  readonly bucket: pulumi.Output<string>;
71
382
  /**
72
- * Bucket domain name. Will be of format `bucketname.s3.amazonaws.com`.
383
+ * The bucket domain name. Will be of format `bucketname.s3.amazonaws.com`.
73
384
  */
74
385
  readonly bucketDomainName: pulumi.Output<string>;
75
386
  /**
@@ -77,80 +388,70 @@ export declare class Bucket extends pulumi.CustomResource {
77
388
  */
78
389
  readonly bucketPrefix: pulumi.Output<string | undefined>;
79
390
  /**
80
- * The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the [S3 endpoints reference](https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_region) for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the [Virtual Hosted-Style Requests for Other Regions](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#deprecated-global-endpoint) section in the AWS S3 User Guide.
391
+ * The bucket region-specific domain name. The bucket domain name including the region name, please refer [here](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) for format. Note: The AWS CloudFront allows specifying S3 region-specific endpoint when creating S3 origin, it will prevent [redirect issues](https://forums.aws.amazon.com/thread.jspa?threadID=216814) from CloudFront to S3 Origin URL.
81
392
  */
82
393
  readonly bucketRegionalDomainName: pulumi.Output<string>;
83
394
  /**
84
- * Rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html). See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketCorsConfigurationV2` instead.
395
+ * A rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) (documented below).
85
396
  */
86
397
  readonly corsRules: pulumi.Output<outputs.s3.BucketCorsRule[] | undefined>;
87
398
  /**
88
- * Boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket *when the bucket is destroyed* so that the bucket can be destroyed without error. These objects are *not* recoverable. This only deletes objects when the bucket is destroyed, *not* when setting this parameter to `true`. Once this parameter is set to `true`, there must be a successful `pulumi up` run before a destroy is required to update this value in the resource state. Without a successful `pulumi up` after this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successful `pulumi up` is required to set this value in state before it will take effect on a destroy operation.
399
+ * A boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket so that the bucket can be destroyed without error. These objects are *not* recoverable.
89
400
  */
90
401
  readonly forceDestroy: pulumi.Output<boolean | undefined>;
91
402
  /**
92
- * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl). See Grant below for details. Conflicts with `acl`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
403
+ * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl) (documented below). Conflicts with `acl`.
93
404
  */
94
405
  readonly grants: pulumi.Output<outputs.s3.BucketGrant[] | undefined>;
95
406
  /**
96
- * [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
407
+ * The [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
97
408
  */
98
409
  readonly hostedZoneId: pulumi.Output<string>;
99
410
  /**
100
- * Configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html). See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
101
- * Use the resource `aws.s3.BucketLifecycleConfigurationV2` instead.
411
+ * A configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html) (documented below).
102
412
  */
103
413
  readonly lifecycleRules: pulumi.Output<outputs.s3.BucketLifecycleRule[] | undefined>;
104
414
  /**
105
- * Configuration of [S3 bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
106
- * Use the resource `aws.s3.BucketLoggingV2` instead.
415
+ * A settings of [bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) (documented below).
107
416
  */
108
417
  readonly loggings: pulumi.Output<outputs.s3.BucketLogging[] | undefined>;
109
418
  /**
110
- * Configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html). See Object Lock Configuration below for details.
111
- * The provider wil only perform drift detection if a configuration value is provided.
112
- * Use the `objectLockEnabled` parameter and the resource `aws.s3.BucketObjectLockConfigurationV2` instead.
419
+ * A configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html) (documented below)
420
+ *
421
+ * > **NOTE:** You cannot use `accelerationStatus` in `cn-north-1` or `us-gov-west-1`
113
422
  */
114
423
  readonly objectLockConfiguration: pulumi.Output<outputs.s3.BucketObjectLockConfiguration | undefined>;
115
424
  /**
116
- * Valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
117
- * The provider will only perform drift detection if a configuration value is provided.
118
- * Use the resource `aws.s3.BucketPolicy` instead.
425
+ * A valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing in a `pulumi preview`. In this case, please make sure you use the verbose/specific version of the policy.
119
426
  */
120
427
  readonly policy: pulumi.Output<string | undefined>;
121
428
  /**
122
- * AWS region this bucket resides in.
429
+ * The AWS region this bucket resides in.
123
430
  */
124
431
  readonly region: pulumi.Output<string>;
125
432
  /**
126
- * Configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html). See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
127
- * Use the resource `aws.s3.BucketReplicationConfig` instead.
433
+ * A configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) (documented below).
128
434
  */
129
435
  readonly replicationConfiguration: pulumi.Output<outputs.s3.BucketReplicationConfiguration | undefined>;
130
436
  /**
131
437
  * Specifies who should bear the cost of Amazon S3 data transfer.
132
- * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur the costs of any data transfer.
133
- * See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html) developer guide for more information.
134
- * The provider will only perform drift detection if a configuration value is provided.
135
- * Use the resource `aws.s3.BucketRequestPaymentConfigurationV2` instead.
438
+ * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur
439
+ * the costs of any data transfer. See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html)
440
+ * developer guide for more information.
136
441
  */
137
442
  readonly requestPayer: pulumi.Output<string>;
138
443
  /**
139
- * Configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html). See Server Side Encryption Configuration below for details.
140
- * The provider will only perform drift detection if a configuration value is provided.
141
- * Use the resource `aws.s3.BucketServerSideEncryptionConfigurationV2` instead.
444
+ * A configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) (documented below)
142
445
  */
143
446
  readonly serverSideEncryptionConfiguration: pulumi.Output<outputs.s3.BucketServerSideEncryptionConfiguration>;
144
447
  /**
145
- * Map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
146
- *
147
- * The following arguments are deprecated, and will be removed in a future major version:
448
+ * A map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
148
449
  */
149
450
  readonly tags: pulumi.Output<{
150
451
  [key: string]: string;
151
452
  } | undefined>;
152
453
  /**
153
- * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
454
+ * A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
154
455
  *
155
456
  * @deprecated Please use `tags` instead.
156
457
  */
@@ -158,20 +459,19 @@ export declare class Bucket extends pulumi.CustomResource {
158
459
  [key: string]: string;
159
460
  }>;
160
461
  /**
161
- * Configuration of the [S3 bucket versioning state](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html). See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketVersioningV2` instead.
462
+ * A state of [versioning](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html) (documented below)
162
463
  */
163
464
  readonly versioning: pulumi.Output<outputs.s3.BucketVersioning>;
164
465
  /**
165
- * Configuration of the [S3 bucket website](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html). See Website below for details. The provider will only perform drift detection if a configuration value is provided.
166
- * Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
466
+ * A website object (documented below).
167
467
  */
168
468
  readonly website: pulumi.Output<outputs.s3.BucketWebsite | undefined>;
169
469
  /**
170
- * (**Deprecated**) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
470
+ * The domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records.
171
471
  */
172
472
  readonly websiteDomain: pulumi.Output<string>;
173
473
  /**
174
- * (**Deprecated**) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
474
+ * The website endpoint, if the bucket is configured with a website. If not, this will be an empty string.
175
475
  */
176
476
  readonly websiteEndpoint: pulumi.Output<string>;
177
477
  /**
@@ -188,24 +488,23 @@ export declare class Bucket extends pulumi.CustomResource {
188
488
  */
189
489
  export interface BucketState {
190
490
  /**
191
- * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`. Cannot be used in `cn-north-1` or `us-gov-west-1`. This provider will only perform drift detection if a configuration value is provided.
192
- * Use the resource `aws.s3.BucketAccelerateConfigurationV2` instead.
491
+ * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`.
193
492
  */
194
493
  accelerationStatus?: pulumi.Input<string>;
195
494
  /**
196
- * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
495
+ * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`.
197
496
  */
198
497
  acl?: pulumi.Input<string | enums.s3.CannedAcl>;
199
498
  /**
200
- * ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
499
+ * The ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
201
500
  */
202
501
  arn?: pulumi.Input<string>;
203
502
  /**
204
- * Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). The name must not be in the format `[bucketName]--[azid]--x-s3`. Use the `aws.s3.DirectoryBucket` resource to manage S3 Express buckets.
503
+ * The name of the bucket. If omitted, this provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
205
504
  */
206
505
  bucket?: pulumi.Input<string>;
207
506
  /**
208
- * Bucket domain name. Will be of format `bucketname.s3.amazonaws.com`.
507
+ * The bucket domain name. Will be of format `bucketname.s3.amazonaws.com`.
209
508
  */
210
509
  bucketDomainName?: pulumi.Input<string>;
211
510
  /**
@@ -213,80 +512,70 @@ export interface BucketState {
213
512
  */
214
513
  bucketPrefix?: pulumi.Input<string>;
215
514
  /**
216
- * The bucket region-specific domain name. The bucket domain name including the region name. Please refer to the [S3 endpoints reference](https://docs.aws.amazon.com/general/latest/gr/s3.html#s3_region) for format. Note: AWS CloudFront allows specifying an S3 region-specific endpoint when creating an S3 origin. This will prevent redirect issues from CloudFront to the S3 Origin URL. For more information, see the [Virtual Hosted-Style Requests for Other Regions](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#deprecated-global-endpoint) section in the AWS S3 User Guide.
515
+ * The bucket region-specific domain name. The bucket domain name including the region name, please refer [here](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region) for format. Note: The AWS CloudFront allows specifying S3 region-specific endpoint when creating S3 origin, it will prevent [redirect issues](https://forums.aws.amazon.com/thread.jspa?threadID=216814) from CloudFront to S3 Origin URL.
217
516
  */
218
517
  bucketRegionalDomainName?: pulumi.Input<string>;
219
518
  /**
220
- * Rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html). See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketCorsConfigurationV2` instead.
519
+ * A rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) (documented below).
221
520
  */
222
521
  corsRules?: pulumi.Input<pulumi.Input<inputs.s3.BucketCorsRule>[]>;
223
522
  /**
224
- * Boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket *when the bucket is destroyed* so that the bucket can be destroyed without error. These objects are *not* recoverable. This only deletes objects when the bucket is destroyed, *not* when setting this parameter to `true`. Once this parameter is set to `true`, there must be a successful `pulumi up` run before a destroy is required to update this value in the resource state. Without a successful `pulumi up` after this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successful `pulumi up` is required to set this value in state before it will take effect on a destroy operation.
523
+ * A boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket so that the bucket can be destroyed without error. These objects are *not* recoverable.
225
524
  */
226
525
  forceDestroy?: pulumi.Input<boolean>;
227
526
  /**
228
- * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl). See Grant below for details. Conflicts with `acl`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
527
+ * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl) (documented below). Conflicts with `acl`.
229
528
  */
230
529
  grants?: pulumi.Input<pulumi.Input<inputs.s3.BucketGrant>[]>;
231
530
  /**
232
- * [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
531
+ * The [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
233
532
  */
234
533
  hostedZoneId?: pulumi.Input<string>;
235
534
  /**
236
- * Configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html). See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
237
- * Use the resource `aws.s3.BucketLifecycleConfigurationV2` instead.
535
+ * A configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html) (documented below).
238
536
  */
239
537
  lifecycleRules?: pulumi.Input<pulumi.Input<inputs.s3.BucketLifecycleRule>[]>;
240
538
  /**
241
- * Configuration of [S3 bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
242
- * Use the resource `aws.s3.BucketLoggingV2` instead.
539
+ * A settings of [bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) (documented below).
243
540
  */
244
541
  loggings?: pulumi.Input<pulumi.Input<inputs.s3.BucketLogging>[]>;
245
542
  /**
246
- * Configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html). See Object Lock Configuration below for details.
247
- * The provider wil only perform drift detection if a configuration value is provided.
248
- * Use the `objectLockEnabled` parameter and the resource `aws.s3.BucketObjectLockConfigurationV2` instead.
543
+ * A configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html) (documented below)
544
+ *
545
+ * > **NOTE:** You cannot use `accelerationStatus` in `cn-north-1` or `us-gov-west-1`
249
546
  */
250
547
  objectLockConfiguration?: pulumi.Input<inputs.s3.BucketObjectLockConfiguration>;
251
548
  /**
252
- * Valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
253
- * The provider will only perform drift detection if a configuration value is provided.
254
- * Use the resource `aws.s3.BucketPolicy` instead.
549
+ * A valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing in a `pulumi preview`. In this case, please make sure you use the verbose/specific version of the policy.
255
550
  */
256
551
  policy?: pulumi.Input<string | PolicyDocument>;
257
552
  /**
258
- * AWS region this bucket resides in.
553
+ * The AWS region this bucket resides in.
259
554
  */
260
555
  region?: pulumi.Input<string>;
261
556
  /**
262
- * Configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html). See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
263
- * Use the resource `aws.s3.BucketReplicationConfig` instead.
557
+ * A configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) (documented below).
264
558
  */
265
559
  replicationConfiguration?: pulumi.Input<inputs.s3.BucketReplicationConfiguration>;
266
560
  /**
267
561
  * Specifies who should bear the cost of Amazon S3 data transfer.
268
- * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur the costs of any data transfer.
269
- * See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html) developer guide for more information.
270
- * The provider will only perform drift detection if a configuration value is provided.
271
- * Use the resource `aws.s3.BucketRequestPaymentConfigurationV2` instead.
562
+ * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur
563
+ * the costs of any data transfer. See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html)
564
+ * developer guide for more information.
272
565
  */
273
566
  requestPayer?: pulumi.Input<string>;
274
567
  /**
275
- * Configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html). See Server Side Encryption Configuration below for details.
276
- * The provider will only perform drift detection if a configuration value is provided.
277
- * Use the resource `aws.s3.BucketServerSideEncryptionConfigurationV2` instead.
568
+ * A configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) (documented below)
278
569
  */
279
570
  serverSideEncryptionConfiguration?: pulumi.Input<inputs.s3.BucketServerSideEncryptionConfiguration>;
280
571
  /**
281
- * Map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
282
- *
283
- * The following arguments are deprecated, and will be removed in a future major version:
572
+ * A map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
284
573
  */
285
574
  tags?: pulumi.Input<{
286
575
  [key: string]: pulumi.Input<string>;
287
576
  }>;
288
577
  /**
289
- * Map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
578
+ * A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
290
579
  *
291
580
  * @deprecated Please use `tags` instead.
292
581
  */
@@ -294,20 +583,19 @@ export interface BucketState {
294
583
  [key: string]: pulumi.Input<string>;
295
584
  }>;
296
585
  /**
297
- * Configuration of the [S3 bucket versioning state](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html). See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketVersioningV2` instead.
586
+ * A state of [versioning](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html) (documented below)
298
587
  */
299
588
  versioning?: pulumi.Input<inputs.s3.BucketVersioning>;
300
589
  /**
301
- * Configuration of the [S3 bucket website](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html). See Website below for details. The provider will only perform drift detection if a configuration value is provided.
302
- * Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
590
+ * A website object (documented below).
303
591
  */
304
592
  website?: pulumi.Input<inputs.s3.BucketWebsite>;
305
593
  /**
306
- * (**Deprecated**) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
594
+ * The domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records.
307
595
  */
308
596
  websiteDomain?: pulumi.Input<string>;
309
597
  /**
310
- * (**Deprecated**) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
598
+ * The website endpoint, if the bucket is configured with a website. If not, this will be an empty string.
311
599
  */
312
600
  websiteEndpoint?: pulumi.Input<string>;
313
601
  }
@@ -316,20 +604,19 @@ export interface BucketState {
316
604
  */
317
605
  export interface BucketArgs {
318
606
  /**
319
- * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`. Cannot be used in `cn-north-1` or `us-gov-west-1`. This provider will only perform drift detection if a configuration value is provided.
320
- * Use the resource `aws.s3.BucketAccelerateConfigurationV2` instead.
607
+ * Sets the accelerate configuration of an existing bucket. Can be `Enabled` or `Suspended`.
321
608
  */
322
609
  accelerationStatus?: pulumi.Input<string>;
323
610
  /**
324
- * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
611
+ * The [canned ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) to apply. Valid values are `private`, `public-read`, `public-read-write`, `aws-exec-read`, `authenticated-read`, and `log-delivery-write`. Defaults to `private`. Conflicts with `grant`.
325
612
  */
326
613
  acl?: pulumi.Input<string | enums.s3.CannedAcl>;
327
614
  /**
328
- * ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
615
+ * The ARN of the bucket. Will be of format `arn:aws:s3:::bucketname`.
329
616
  */
330
617
  arn?: pulumi.Input<string>;
331
618
  /**
332
- * Name of the bucket. If omitted, the provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html). The name must not be in the format `[bucketName]--[azid]--x-s3`. Use the `aws.s3.DirectoryBucket` resource to manage S3 Express buckets.
619
+ * The name of the bucket. If omitted, this provider will assign a random, unique name. Must be lowercase and less than or equal to 63 characters in length. A full list of bucket naming rules [may be found here](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html).
333
620
  */
334
621
  bucket?: pulumi.Input<string>;
335
622
  /**
@@ -337,85 +624,74 @@ export interface BucketArgs {
337
624
  */
338
625
  bucketPrefix?: pulumi.Input<string>;
339
626
  /**
340
- * Rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html). See CORS rule below for details. This provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketCorsConfigurationV2` instead.
627
+ * A rule of [Cross-Origin Resource Sharing](https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html) (documented below).
341
628
  */
342
629
  corsRules?: pulumi.Input<pulumi.Input<inputs.s3.BucketCorsRule>[]>;
343
630
  /**
344
- * Boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket *when the bucket is destroyed* so that the bucket can be destroyed without error. These objects are *not* recoverable. This only deletes objects when the bucket is destroyed, *not* when setting this parameter to `true`. Once this parameter is set to `true`, there must be a successful `pulumi up` run before a destroy is required to update this value in the resource state. Without a successful `pulumi up` after this parameter is set, this flag will have no effect. If setting this field in the same operation that would require replacing the bucket or destroying the bucket, this flag will not work. Additionally when importing a bucket, a successful `pulumi up` is required to set this value in state before it will take effect on a destroy operation.
631
+ * A boolean that indicates all objects (including any [locked objects](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html)) should be deleted from the bucket so that the bucket can be destroyed without error. These objects are *not* recoverable.
345
632
  */
346
633
  forceDestroy?: pulumi.Input<boolean>;
347
634
  /**
348
- * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl). See Grant below for details. Conflicts with `acl`. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketAclV2` instead.
635
+ * An [ACL policy grant](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#sample-acl) (documented below). Conflicts with `acl`.
349
636
  */
350
637
  grants?: pulumi.Input<pulumi.Input<inputs.s3.BucketGrant>[]>;
351
638
  /**
352
- * [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
639
+ * The [Route 53 Hosted Zone ID](https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_website_region_endpoints) for this bucket's region.
353
640
  */
354
641
  hostedZoneId?: pulumi.Input<string>;
355
642
  /**
356
- * Configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html). See Lifecycle Rule below for details. The provider will only perform drift detection if a configuration value is provided.
357
- * Use the resource `aws.s3.BucketLifecycleConfigurationV2` instead.
643
+ * A configuration of [object lifecycle management](http://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html) (documented below).
358
644
  */
359
645
  lifecycleRules?: pulumi.Input<pulumi.Input<inputs.s3.BucketLifecycleRule>[]>;
360
646
  /**
361
- * Configuration of [S3 bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) parameters. See Logging below for details. The provider will only perform drift detection if a configuration value is provided.
362
- * Use the resource `aws.s3.BucketLoggingV2` instead.
647
+ * A settings of [bucket logging](https://docs.aws.amazon.com/AmazonS3/latest/UG/ManagingBucketLogging.html) (documented below).
363
648
  */
364
649
  loggings?: pulumi.Input<pulumi.Input<inputs.s3.BucketLogging>[]>;
365
650
  /**
366
- * Configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html). See Object Lock Configuration below for details.
367
- * The provider wil only perform drift detection if a configuration value is provided.
368
- * Use the `objectLockEnabled` parameter and the resource `aws.s3.BucketObjectLockConfigurationV2` instead.
651
+ * A configuration of [S3 object locking](https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html) (documented below)
652
+ *
653
+ * > **NOTE:** You cannot use `accelerationStatus` in `cn-north-1` or `us-gov-west-1`
369
654
  */
370
655
  objectLockConfiguration?: pulumi.Input<inputs.s3.BucketObjectLockConfiguration>;
371
656
  /**
372
- * Valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing. In this case, please make sure you use the verbose/specific version of the policy. For more information about building AWS IAM policy documents with this provider, see the AWS IAM Policy Document Guide.
373
- * The provider will only perform drift detection if a configuration value is provided.
374
- * Use the resource `aws.s3.BucketPolicy` instead.
657
+ * A valid [bucket policy](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) JSON document. Note that if the policy document is not specific enough (but still valid), this provider may view the policy as constantly changing in a `pulumi preview`. In this case, please make sure you use the verbose/specific version of the policy.
375
658
  */
376
659
  policy?: pulumi.Input<string | PolicyDocument>;
377
660
  /**
378
- * Configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html). See Replication Configuration below for details. The provider will only perform drift detection if a configuration value is provided.
379
- * Use the resource `aws.s3.BucketReplicationConfig` instead.
661
+ * A configuration of [replication configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) (documented below).
380
662
  */
381
663
  replicationConfiguration?: pulumi.Input<inputs.s3.BucketReplicationConfiguration>;
382
664
  /**
383
665
  * Specifies who should bear the cost of Amazon S3 data transfer.
384
- * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur the costs of any data transfer.
385
- * See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html) developer guide for more information.
386
- * The provider will only perform drift detection if a configuration value is provided.
387
- * Use the resource `aws.s3.BucketRequestPaymentConfigurationV2` instead.
666
+ * Can be either `BucketOwner` or `Requester`. By default, the owner of the S3 bucket would incur
667
+ * the costs of any data transfer. See [Requester Pays Buckets](http://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html)
668
+ * developer guide for more information.
388
669
  */
389
670
  requestPayer?: pulumi.Input<string>;
390
671
  /**
391
- * Configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html). See Server Side Encryption Configuration below for details.
392
- * The provider will only perform drift detection if a configuration value is provided.
393
- * Use the resource `aws.s3.BucketServerSideEncryptionConfigurationV2` instead.
672
+ * A configuration of [server-side encryption configuration](http://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html) (documented below)
394
673
  */
395
674
  serverSideEncryptionConfiguration?: pulumi.Input<inputs.s3.BucketServerSideEncryptionConfiguration>;
396
675
  /**
397
- * Map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
398
- *
399
- * The following arguments are deprecated, and will be removed in a future major version:
676
+ * A map of tags to assign to the bucket. If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
400
677
  */
401
678
  tags?: pulumi.Input<{
402
679
  [key: string]: pulumi.Input<string>;
403
680
  }>;
404
681
  /**
405
- * Configuration of the [S3 bucket versioning state](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html). See Versioning below for details. The provider will only perform drift detection if a configuration value is provided. Use the resource `aws.s3.BucketVersioningV2` instead.
682
+ * A state of [versioning](https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html) (documented below)
406
683
  */
407
684
  versioning?: pulumi.Input<inputs.s3.BucketVersioning>;
408
685
  /**
409
- * Configuration of the [S3 bucket website](https://docs.aws.amazon.com/AmazonS3/latest/userguide/WebsiteHosting.html). See Website below for details. The provider will only perform drift detection if a configuration value is provided.
410
- * Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
686
+ * A website object (documented below).
411
687
  */
412
688
  website?: pulumi.Input<inputs.s3.BucketWebsite>;
413
689
  /**
414
- * (**Deprecated**) Domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
690
+ * The domain of the website endpoint, if the bucket is configured with a website. If not, this will be an empty string. This is used to create Route 53 alias records.
415
691
  */
416
692
  websiteDomain?: pulumi.Input<string>;
417
693
  /**
418
- * (**Deprecated**) Website endpoint, if the bucket is configured with a website. If not, this will be an empty string. Use the resource `aws.s3.BucketWebsiteConfigurationV2` instead.
694
+ * The website endpoint, if the bucket is configured with a website. If not, this will be an empty string.
419
695
  */
420
696
  websiteEndpoint?: pulumi.Input<string>;
421
697
  }