aws-sdk-s3 1.178.0 → 1.180.0

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.
Files changed (27) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +10 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +12 -15
  5. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  6. data/lib/aws-sdk-s3/bucket_cors.rb +1 -1
  7. data/lib/aws-sdk-s3/bucket_lifecycle.rb +1 -1
  8. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +1 -1
  9. data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
  10. data/lib/aws-sdk-s3/bucket_policy.rb +1 -1
  11. data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
  12. data/lib/aws-sdk-s3/bucket_tagging.rb +1 -1
  13. data/lib/aws-sdk-s3/bucket_versioning.rb +3 -3
  14. data/lib/aws-sdk-s3/bucket_website.rb +1 -1
  15. data/lib/aws-sdk-s3/client.rb +449 -431
  16. data/lib/aws-sdk-s3/endpoint_provider.rb +260 -277
  17. data/lib/aws-sdk-s3/object.rb +34 -52
  18. data/lib/aws-sdk-s3/object_summary.rb +34 -52
  19. data/lib/aws-sdk-s3/object_version.rb +1 -10
  20. data/lib/aws-sdk-s3/resource.rb +1 -1
  21. data/lib/aws-sdk-s3/types.rb +290 -264
  22. data/lib/aws-sdk-s3.rb +1 -1
  23. data/sig/bucket.rbs +1 -1
  24. data/sig/client.rbs +2 -2
  25. data/sig/resource.rbs +1 -1
  26. data/sig/types.rbs +2 -2
  27. metadata +2 -2
data/lib/aws-sdk-s3/types.rb CHANGED
@@ -59,7 +59,7 @@ module Aws::S3
59
59
  # requests are not supported. Directory bucket names must be unique in
60
60
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
61
61
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
62
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
62
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
63
63
  # naming restrictions, see [Directory bucket naming rules][1] in the
64
64
  # *Amazon S3 User Guide*.
65
65
  #
@@ -79,14 +79,14 @@ module Aws::S3
79
79
  #
80
80
  # </note>
81
81
  #
82
- # **S3 on Outposts** - When you use this action with Amazon S3 on
83
- # Outposts, you must direct requests to the S3 on Outposts hostname.
84
- # The S3 on Outposts hostname takes the form `
82
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
83
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
84
+ # Outposts hostname takes the form `
85
85
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
86
- # When you use this action with S3 on Outposts through the Amazon Web
87
- # Services SDKs, you provide the Outposts access point ARN in place of
88
- # the bucket name. For more information about S3 on Outposts ARNs, see
89
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
86
+ # When you use this action with S3 on Outposts, the destination bucket
87
+ # must be the Outposts access point ARN or the access point alias. For
88
+ # more information about S3 on Outposts, see [What is S3 on
89
+ # Outposts?][3] in the *Amazon S3 User Guide*.
90
90
  #
91
91
  #
92
92
  #
@@ -1001,7 +1001,7 @@ module Aws::S3
1001
1001
  # requests are not supported. Directory bucket names must be unique in
1002
1002
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1003
1003
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1004
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1004
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1005
1005
  # naming restrictions, see [Directory bucket naming rules][1] in the
1006
1006
  # *Amazon S3 User Guide*.
1007
1007
  #
@@ -1021,14 +1021,14 @@ module Aws::S3
1021
1021
  #
1022
1022
  # </note>
1023
1023
  #
1024
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1025
- # Outposts, you must direct requests to the S3 on Outposts hostname.
1026
- # The S3 on Outposts hostname takes the form `
1024
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1025
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
1026
+ # Outposts hostname takes the form `
1027
1027
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1028
- # When you use this action with S3 on Outposts through the Amazon Web
1029
- # Services SDKs, you provide the Outposts access point ARN in place of
1030
- # the bucket name. For more information about S3 on Outposts ARNs, see
1031
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1028
+ # When you use this action with S3 on Outposts, the destination bucket
1029
+ # must be the Outposts access point ARN or the access point alias. For
1030
+ # more information about S3 on Outposts, see [What is S3 on
1031
+ # Outposts?][3] in the *Amazon S3 User Guide*.
1032
1032
  #
1033
1033
  #
1034
1034
  #
@@ -1577,7 +1577,7 @@ module Aws::S3
1577
1577
  # requests are not supported. Directory bucket names must be unique in
1578
1578
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1579
1579
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1580
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1580
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1581
1581
  # naming restrictions, see [Directory bucket naming rules][1] in the
1582
1582
  # *Amazon S3 User Guide*.
1583
1583
  #
@@ -1605,14 +1605,19 @@ module Aws::S3
1605
1605
  #
1606
1606
  # </note>
1607
1607
  #
1608
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1609
- # Outposts, you must direct requests to the S3 on Outposts hostname.
1610
- # The S3 on Outposts hostname takes the form `
1608
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1609
+ # you must use the Outpost bucket access point ARN or the access point
1610
+ # alias for the destination bucket. You can only copy objects within
1611
+ # the same Outpost bucket. It's not supported to copy objects across
1612
+ # different Amazon Web Services Outposts, between buckets on the same
1613
+ # Outposts, or between Outposts buckets and any other bucket types.
1614
+ # For more information about S3 on Outposts, see [What is S3 on
1615
+ # Outposts?][3] in the *S3 on Outposts guide*. When you use this
1616
+ # action with S3 on Outposts through the REST API, you must direct
1617
+ # requests to the S3 on Outposts hostname, in the format `
1611
1618
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1612
- # When you use this action with S3 on Outposts through the Amazon Web
1613
- # Services SDKs, you provide the Outposts access point ARN in place of
1614
- # the bucket name. For more information about S3 on Outposts ARNs, see
1615
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1619
+ # The hostname isn't required when you use the Amazon Web Services
1620
+ # CLI or SDKs.
1616
1621
  #
1617
1622
  #
1618
1623
  #
@@ -2129,21 +2134,17 @@ module Aws::S3
2129
2134
  # Signature Version in Request Authentication][1] in the *Amazon S3
2130
2135
  # User Guide*.
2131
2136
  #
2132
- # **Directory buckets** - If you specify
2133
- # `x-amz-server-side-encryption` with `aws:kms`, the `
2134
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
2135
- # assigned the ID of the KMS symmetric encryption customer managed key
2136
- # that's configured for your directory bucket's default encryption
2137
- # setting. If you want to specify the `
2138
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
2139
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
2140
- # customer managed key that's configured for your directory bucket's
2141
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
2142
- # Request` error. Only use the key ID or key ARN. The key alias format
2143
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
2144
- # support 1 [customer managed key][2] per directory bucket for the
2145
- # lifetime of the bucket. The [Amazon Web Services managed key][3]
2146
- # (`aws/s3`) isn't supported.
2137
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
2138
+ # recommended to specify the `x-amz-server-side-encryption` header to
2139
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
2140
+ # header implicitly uses the bucket's default KMS customer managed
2141
+ # key ID. If you want to explicitly set the `
2142
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
2143
+ # the bucket's default customer managed key (using key ID or ARN, not
2144
+ # alias). Your SSE-KMS configuration can only support 1 [customer
2145
+ # managed key][2] per directory bucket's lifetime. The [Amazon Web
2146
+ # Services managed key][3] (`aws/s3`) isn't supported. Incorrect key
2147
+ # specification results in an HTTP `400 Bad Request` error.
2147
2148
  #
2148
2149
  #
2149
2150
  #
@@ -2590,11 +2591,14 @@ module Aws::S3
2590
2591
  # choose a Region to optimize latency, minimize costs, or address
2591
2592
  # regulatory requirements. For example, if you reside in Europe, you
2592
2593
  # will probably find it advantageous to create buckets in the Europe
2593
- # (Ireland) Region. For more information, see [Accessing a bucket][1]
2594
- # in the *Amazon S3 User Guide*.
2594
+ # (Ireland) Region.
2595
2595
  #
2596
2596
  # If you don't specify a Region, the bucket is created in the US East
2597
- # (N. Virginia) Region (us-east-1) by default.
2597
+ # (N. Virginia) Region (us-east-1) by default. Configurations using
2598
+ # the value `EU` will create a bucket in `eu-west-1`.
2599
+ #
2600
+ # For a list of the valid values for all of the Amazon Web Services
2601
+ # Regions, see [Regions and Endpoints][1].
2598
2602
  #
2599
2603
  # <note markdown="1"> This functionality is not supported for directory buckets.
2600
2604
  #
@@ -2602,17 +2606,17 @@ module Aws::S3
2602
2606
  #
2603
2607
  #
2604
2608
  #
2605
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
2609
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2606
2610
  # @return [String]
2607
2611
  #
2608
2612
  # @!attribute [rw] location
2609
2613
  # Specifies the location where the bucket will be created.
2610
2614
  #
2611
2615
  # <b>Directory buckets </b> - The location type is Availability Zone
2612
- # or Local Zone. When the location type is Local Zone, your Local Zone
2613
- # must be in opt-in status. Otherwise, you get an HTTP `400 Bad
2614
- # Request` error with the error code `Access denied`. To learn more
2615
- # about opt-in Local Zones, see [Opt-in Dedicated Local Zones][1]in
2616
+ # or Local Zone. To use the Local Zone location type, your account
2617
+ # must be enabled for Dedicated Local Zones. Otherwise, you get an
2618
+ # HTTP `403 Forbidden` error with the error code `AccessDenied`. To
2619
+ # learn more, see [Enable accounts for Dedicated Local Zones][1] in
2616
2620
  # the *Amazon S3 User Guide*.
2617
2621
  #
2618
2622
  # <note markdown="1"> This functionality is only supported by directory buckets.
@@ -3006,7 +3010,7 @@ module Aws::S3
3006
3010
  # requests are not supported. Directory bucket names must be unique in
3007
3011
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
3008
3012
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
3009
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3013
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
3010
3014
  # naming restrictions, see [Directory bucket naming rules][1] in the
3011
3015
  # *Amazon S3 User Guide*.
3012
3016
  #
@@ -3026,14 +3030,14 @@ module Aws::S3
3026
3030
  #
3027
3031
  # </note>
3028
3032
  #
3029
- # **S3 on Outposts** - When you use this action with Amazon S3 on
3030
- # Outposts, you must direct requests to the S3 on Outposts hostname.
3031
- # The S3 on Outposts hostname takes the form `
3033
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
3034
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
3035
+ # Outposts hostname takes the form `
3032
3036
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
3033
- # When you use this action with S3 on Outposts through the Amazon Web
3034
- # Services SDKs, you provide the Outposts access point ARN in place of
3035
- # the bucket name. For more information about S3 on Outposts ARNs, see
3036
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
3037
+ # When you use this action with S3 on Outposts, the destination bucket
3038
+ # must be the Outposts access point ARN or the access point alias. For
3039
+ # more information about S3 on Outposts, see [What is S3 on
3040
+ # Outposts?][3] in the *Amazon S3 User Guide*.
3037
3041
  #
3038
3042
  #
3039
3043
  #
@@ -3471,21 +3475,17 @@ module Aws::S3
3471
3475
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
3472
3476
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
3473
3477
  #
3474
- # **Directory buckets** - If you specify
3475
- # `x-amz-server-side-encryption` with `aws:kms`, the `
3476
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
3477
- # assigned the ID of the KMS symmetric encryption customer managed key
3478
- # that's configured for your directory bucket's default encryption
3479
- # setting. If you want to specify the `
3480
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
3481
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
3482
- # customer managed key that's configured for your directory bucket's
3483
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
3484
- # Request` error. Only use the key ID or key ARN. The key alias format
3485
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
3486
- # support 1 [customer managed key][1] per directory bucket for the
3487
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
3488
- # (`aws/s3`) isn't supported.
3478
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
3479
+ # recommended to specify the `x-amz-server-side-encryption` header to
3480
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
3481
+ # header implicitly uses the bucket's default KMS customer managed
3482
+ # key ID. If you want to explicitly set the `
3483
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
3484
+ # the bucket's default customer managed key (using key ID or ARN, not
3485
+ # alias). Your SSE-KMS configuration can only support 1 [customer
3486
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
3487
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
3488
+ # specification results in an HTTP `400 Bad Request` error.
3489
3489
  #
3490
3490
  #
3491
3491
  #
@@ -3720,7 +3720,7 @@ module Aws::S3
3720
3720
  #
3721
3721
  #
3722
3722
  #
3723
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3723
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
3724
3724
  # @return [String]
3725
3725
  #
3726
3726
  # @!attribute [rw] ssekms_key_id
@@ -3734,8 +3734,8 @@ module Aws::S3
3734
3734
  # must use the full Key ARN not the Key ID.
3735
3735
  #
3736
3736
  # Your SSE-KMS configuration can only support 1 [customer managed
3737
- # key][1] per directory bucket for the lifetime of the bucket. The
3738
- # [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
3737
+ # key][1] per directory bucket's lifetime. The [Amazon Web Services
3738
+ # managed key][2] (`aws/s3`) isn't supported.
3739
3739
  #
3740
3740
  #
3741
3741
  #
@@ -4238,7 +4238,7 @@ module Aws::S3
4238
4238
  # Information about the delete marker.
4239
4239
  #
4240
4240
  # @!attribute [rw] owner
4241
- # The account that created the delete marker.&gt;
4241
+ # The account that created the delete marker.
4242
4242
  # @return [Types::Owner]
4243
4243
  #
4244
4244
  # @!attribute [rw] key
@@ -4314,10 +4314,16 @@ module Aws::S3
4314
4314
  # deleted was (true) or was not (false) a delete marker before
4315
4315
  # deletion. In a simple DELETE, this header indicates whether (true)
4316
4316
  # or not (false) the current version of the object is a delete marker.
4317
+ # To learn more about delete markers, see [Working with delete
4318
+ # markers][1].
4317
4319
  #
4318
4320
  # <note markdown="1"> This functionality is not supported for directory buckets.
4319
4321
  #
4320
4322
  # </note>
4323
+ #
4324
+ #
4325
+ #
4326
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4321
4327
  # @return [Boolean]
4322
4328
  #
4323
4329
  # @!attribute [rw] version_id
@@ -4357,7 +4363,7 @@ module Aws::S3
4357
4363
  # requests are not supported. Directory bucket names must be unique in
4358
4364
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4359
4365
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4360
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4366
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4361
4367
  # naming restrictions, see [Directory bucket naming rules][1] in the
4362
4368
  # *Amazon S3 User Guide*.
4363
4369
  #
@@ -4377,14 +4383,14 @@ module Aws::S3
4377
4383
  #
4378
4384
  # </note>
4379
4385
  #
4380
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4381
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4382
- # The S3 on Outposts hostname takes the form `
4386
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4387
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4388
+ # Outposts hostname takes the form `
4383
4389
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4384
- # When you use this action with S3 on Outposts through the Amazon Web
4385
- # Services SDKs, you provide the Outposts access point ARN in place of
4386
- # the bucket name. For more information about S3 on Outposts ARNs, see
4387
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4390
+ # When you use this action with S3 on Outposts, the destination bucket
4391
+ # must be the Outposts access point ARN or the access point alias. For
4392
+ # more information about S3 on Outposts, see [What is S3 on
4393
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4388
4394
  #
4389
4395
  #
4390
4396
  #
@@ -4467,7 +4473,7 @@ module Aws::S3
4467
4473
  #
4468
4474
  #
4469
4475
  #
4470
- # [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
4476
+ # [1]: https://tools.ietf.org/html/rfc7232
4471
4477
  # @return [String]
4472
4478
  #
4473
4479
  # @!attribute [rw] if_match_last_modified_time
@@ -4542,14 +4548,14 @@ module Aws::S3
4542
4548
  # bucket name. For more information about access point ARNs, see
4543
4549
  # [Using access points][1] in the *Amazon S3 User Guide*.
4544
4550
  #
4545
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4546
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4547
- # The S3 on Outposts hostname takes the form `
4551
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4552
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4553
+ # Outposts hostname takes the form `
4548
4554
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4549
- # When you use this action with S3 on Outposts through the Amazon Web
4550
- # Services SDKs, you provide the Outposts access point ARN in place of
4551
- # the bucket name. For more information about S3 on Outposts ARNs, see
4552
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
4555
+ # When you use this action with S3 on Outposts, the destination bucket
4556
+ # must be the Outposts access point ARN or the access point alias. For
4557
+ # more information about S3 on Outposts, see [What is S3 on
4558
+ # Outposts?][2] in the *Amazon S3 User Guide*.
4553
4559
  #
4554
4560
  #
4555
4561
  #
@@ -4622,7 +4628,7 @@ module Aws::S3
4622
4628
  # requests are not supported. Directory bucket names must be unique in
4623
4629
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4624
4630
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4625
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4631
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4626
4632
  # naming restrictions, see [Directory bucket naming rules][1] in the
4627
4633
  # *Amazon S3 User Guide*.
4628
4634
  #
@@ -4642,14 +4648,14 @@ module Aws::S3
4642
4648
  #
4643
4649
  # </note>
4644
4650
  #
4645
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4646
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4647
- # The S3 on Outposts hostname takes the form `
4651
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4652
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4653
+ # Outposts hostname takes the form `
4648
4654
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4649
- # When you use this action with S3 on Outposts through the Amazon Web
4650
- # Services SDKs, you provide the Outposts access point ARN in place of
4651
- # the bucket name. For more information about S3 on Outposts ARNs, see
4652
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4655
+ # When you use this action with S3 on Outposts, the destination bucket
4656
+ # must be the Outposts access point ARN or the access point alias. For
4657
+ # more information about S3 on Outposts, see [What is S3 on
4658
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4653
4659
  #
4654
4660
  #
4655
4661
  #
@@ -4813,10 +4819,16 @@ module Aws::S3
4813
4819
  # deleted was (true) or was not (false) a delete marker before
4814
4820
  # deletion. In a simple DELETE, this header indicates whether (true)
4815
4821
  # or not (false) the current version of the object is a delete marker.
4822
+ # To learn more about delete markers, see [Working with delete
4823
+ # markers][1].
4816
4824
  #
4817
4825
  # <note markdown="1"> This functionality is not supported for directory buckets.
4818
4826
  #
4819
4827
  # </note>
4828
+ #
4829
+ #
4830
+ #
4831
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4820
4832
  # @return [Boolean]
4821
4833
  #
4822
4834
  # @!attribute [rw] delete_marker_version_id
@@ -6363,8 +6375,10 @@ module Aws::S3
6363
6375
  # @!attribute [rw] location_constraint
6364
6376
  # Specifies the Region where the bucket resides. For a list of all the
6365
6377
  # Amazon S3 supported location constraints by Region, see [Regions and
6366
- # Endpoints][1]. Buckets in Region `us-east-1` have a
6367
- # LocationConstraint of `null`.
6378
+ # Endpoints][1].
6379
+ #
6380
+ # Buckets in Region `us-east-1` have a LocationConstraint of `null`.
6381
+ # Buckets with a LocationConstraint of `EU` reside in `eu-west-1`.
6368
6382
  #
6369
6383
  #
6370
6384
  #
@@ -7018,11 +7032,16 @@ module Aws::S3
7018
7032
  # @!attribute [rw] delete_marker
7019
7033
  # Specifies whether the object retrieved was (`true`) or was not
7020
7034
  # (`false`) a delete marker. If `false`, this response header does not
7021
- # appear in the response.
7035
+ # appear in the response. To learn more about delete markers, see
7036
+ # [Working with delete markers][1].
7022
7037
  #
7023
7038
  # <note markdown="1"> This functionality is not supported for directory buckets.
7024
7039
  #
7025
7040
  # </note>
7041
+ #
7042
+ #
7043
+ #
7044
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
7026
7045
  # @return [Boolean]
7027
7046
  #
7028
7047
  # @!attribute [rw] last_modified
@@ -7162,7 +7181,7 @@ module Aws::S3
7162
7181
  # requests are not supported. Directory bucket names must be unique in
7163
7182
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7164
7183
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7165
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7184
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7166
7185
  # naming restrictions, see [Directory bucket naming rules][1] in the
7167
7186
  # *Amazon S3 User Guide*.
7168
7187
  #
@@ -7182,14 +7201,14 @@ module Aws::S3
7182
7201
  #
7183
7202
  # </note>
7184
7203
  #
7185
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7186
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7187
- # The S3 on Outposts hostname takes the form `
7204
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7205
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7206
+ # Outposts hostname takes the form `
7188
7207
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7189
- # When you use this action with S3 on Outposts through the Amazon Web
7190
- # Services SDKs, you provide the Outposts access point ARN in place of
7191
- # the bucket name. For more information about S3 on Outposts ARNs, see
7192
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7208
+ # When you use this action with S3 on Outposts, the destination bucket
7209
+ # must be the Outposts access point ARN or the access point alias. For
7210
+ # more information about S3 on Outposts, see [What is S3 on
7211
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7193
7212
  #
7194
7213
  #
7195
7214
  #
@@ -7801,7 +7820,7 @@ module Aws::S3
7801
7820
  # requests are not supported. Directory bucket names must be unique in
7802
7821
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7803
7822
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7804
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7823
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7805
7824
  # naming restrictions, see [Directory bucket naming rules][1] in the
7806
7825
  # *Amazon S3 User Guide*.
7807
7826
  #
@@ -7827,14 +7846,14 @@ module Aws::S3
7827
7846
  #
7828
7847
  # </note>
7829
7848
  #
7830
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7831
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7832
- # The S3 on Outposts hostname takes the form `
7849
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7850
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7851
+ # Outposts hostname takes the form `
7833
7852
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7834
- # When you use this action with S3 on Outposts through the Amazon Web
7835
- # Services SDKs, you provide the Outposts access point ARN in place of
7836
- # the bucket name. For more information about S3 on Outposts ARNs, see
7837
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7853
+ # When you use this action with S3 on Outposts, the destination bucket
7854
+ # must be the Outposts access point ARN or the access point alias. For
7855
+ # more information about S3 on Outposts, see [What is S3 on
7856
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7838
7857
  #
7839
7858
  #
7840
7859
  #
@@ -8108,15 +8127,6 @@ module Aws::S3
8108
8127
  #
8109
8128
  # @!attribute [rw] checksum_mode
8110
8129
  # To retrieve the checksum, this mode must be enabled.
8111
- #
8112
- # **General purpose buckets** - In addition, if you enable checksum
8113
- # mode and the object is uploaded with a [checksum][1] and encrypted
8114
- # with an Key Management Service (KMS) key, you must have permission
8115
- # to use the `kms:Decrypt` action to retrieve the checksum.
8116
- #
8117
- #
8118
- #
8119
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
8120
8130
  # @return [String]
8121
8131
  #
8122
8132
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRequest AWS API Documentation
@@ -8259,14 +8269,14 @@ module Aws::S3
8259
8269
  # bucket name. For more information about access point ARNs, see
8260
8270
  # [Using access points][1] in the *Amazon S3 User Guide*.
8261
8271
  #
8262
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8263
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8264
- # The S3 on Outposts hostname takes the form `
8272
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8273
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8274
+ # Outposts hostname takes the form `
8265
8275
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8266
- # When you use this action with S3 on Outposts through the Amazon Web
8267
- # Services SDKs, you provide the Outposts access point ARN in place of
8268
- # the bucket name. For more information about S3 on Outposts ARNs, see
8269
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8276
+ # When you use this action with S3 on Outposts, the destination bucket
8277
+ # must be the Outposts access point ARN or the access point alias. For
8278
+ # more information about S3 on Outposts, see [What is S3 on
8279
+ # Outposts?][2] in the *Amazon S3 User Guide*.
8270
8280
  #
8271
8281
  #
8272
8282
  #
@@ -8570,7 +8580,7 @@ module Aws::S3
8570
8580
  # requests are not supported. Directory bucket names must be unique in
8571
8581
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8572
8582
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8573
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8583
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
8574
8584
  # naming restrictions, see [Directory bucket naming rules][1] in the
8575
8585
  # *Amazon S3 User Guide*.
8576
8586
  #
@@ -8597,14 +8607,14 @@ module Aws::S3
8597
8607
  #
8598
8608
  # </note>
8599
8609
  #
8600
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8601
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8602
- # The S3 on Outposts hostname takes the form `
8610
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8611
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8612
+ # Outposts hostname takes the form `
8603
8613
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8604
- # When you use this action with S3 on Outposts through the Amazon Web
8605
- # Services SDKs, you provide the Outposts access point ARN in place of
8606
- # the bucket name. For more information about S3 on Outposts ARNs, see
8607
- # [What is S3 on Outposts?][4] in the *Amazon S3 User Guide*.
8614
+ # When you use this action with S3 on Outposts, the destination bucket
8615
+ # must be the Outposts access point ARN or the access point alias. For
8616
+ # more information about S3 on Outposts, see [What is S3 on
8617
+ # Outposts?][4] in the *Amazon S3 User Guide*.
8608
8618
  #
8609
8619
  #
8610
8620
  #
@@ -9071,7 +9081,7 @@ module Aws::S3
9071
9081
  # requests are not supported. Directory bucket names must be unique in
9072
9082
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
9073
9083
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9074
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9084
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
9075
9085
  # naming restrictions, see [Directory bucket naming rules][1] in the
9076
9086
  # *Amazon S3 User Guide*.
9077
9087
  #
@@ -9091,14 +9101,14 @@ module Aws::S3
9091
9101
  #
9092
9102
  # </note>
9093
9103
  #
9094
- # **S3 on Outposts** - When you use this action with Amazon S3 on
9095
- # Outposts, you must direct requests to the S3 on Outposts hostname.
9096
- # The S3 on Outposts hostname takes the form `
9104
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
9105
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
9106
+ # Outposts hostname takes the form `
9097
9107
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
9098
- # When you use this action with S3 on Outposts through the Amazon Web
9099
- # Services SDKs, you provide the Outposts access point ARN in place of
9100
- # the bucket name. For more information about S3 on Outposts ARNs, see
9101
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
9108
+ # When you use this action with S3 on Outposts, the destination bucket
9109
+ # must be the Outposts access point ARN or the access point alias. For
9110
+ # more information about S3 on Outposts, see [What is S3 on
9111
+ # Outposts?][3] in the *Amazon S3 User Guide*.
9102
9112
  #
9103
9113
  #
9104
9114
  #
@@ -10605,7 +10615,7 @@ module Aws::S3
10605
10615
  # requests are not supported. Directory bucket names must be unique in
10606
10616
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10607
10617
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10608
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10618
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10609
10619
  # naming restrictions, see [Directory bucket naming rules][1] in the
10610
10620
  # *Amazon S3 User Guide*.
10611
10621
  #
@@ -10625,14 +10635,14 @@ module Aws::S3
10625
10635
  #
10626
10636
  # </note>
10627
10637
  #
10628
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10629
- # Outposts, you must direct requests to the S3 on Outposts hostname.
10630
- # The S3 on Outposts hostname takes the form `
10638
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
10639
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
10640
+ # Outposts hostname takes the form `
10631
10641
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10632
- # When you use this action with S3 on Outposts through the Amazon Web
10633
- # Services SDKs, you provide the Outposts access point ARN in place of
10634
- # the bucket name. For more information about S3 on Outposts ARNs, see
10635
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
10642
+ # When you use this action with S3 on Outposts, the destination bucket
10643
+ # must be the Outposts access point ARN or the access point alias. For
10644
+ # more information about S3 on Outposts, see [What is S3 on
10645
+ # Outposts?][3] in the *Amazon S3 User Guide*.
10636
10646
  #
10637
10647
  #
10638
10648
  #
@@ -10818,7 +10828,12 @@ module Aws::S3
10818
10828
  # @return [Array<Types::ObjectVersion>]
10819
10829
  #
10820
10830
  # @!attribute [rw] delete_markers
10821
- # Container for an object that is a delete marker.
10831
+ # Container for an object that is a delete marker. To learn more about
10832
+ # delete markers, see [Working with delete markers][1].
10833
+ #
10834
+ #
10835
+ #
10836
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
10822
10837
  # @return [Array<Types::DeleteMarkerEntry>]
10823
10838
  #
10824
10839
  # @!attribute [rw] name
@@ -11127,7 +11142,7 @@ module Aws::S3
11127
11142
  # requests are not supported. Directory bucket names must be unique in
11128
11143
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11129
11144
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11130
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11145
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11131
11146
  # naming restrictions, see [Directory bucket naming rules][1] in the
11132
11147
  # *Amazon S3 User Guide*.
11133
11148
  #
@@ -11147,14 +11162,14 @@ module Aws::S3
11147
11162
  #
11148
11163
  # </note>
11149
11164
  #
11150
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11151
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11152
- # The S3 on Outposts hostname takes the form `
11165
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11166
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11167
+ # Outposts hostname takes the form `
11153
11168
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11154
- # When you use this action with S3 on Outposts through the Amazon Web
11155
- # Services SDKs, you provide the Outposts access point ARN in place of
11156
- # the bucket name. For more information about S3 on Outposts ARNs, see
11157
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11169
+ # When you use this action with S3 on Outposts, the destination bucket
11170
+ # must be the Outposts access point ARN or the access point alias. For
11171
+ # more information about S3 on Outposts, see [What is S3 on
11172
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11158
11173
  #
11159
11174
  #
11160
11175
  #
@@ -11398,7 +11413,7 @@ module Aws::S3
11398
11413
  # requests are not supported. Directory bucket names must be unique in
11399
11414
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11400
11415
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11401
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11416
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11402
11417
  # naming restrictions, see [Directory bucket naming rules][1] in the
11403
11418
  # *Amazon S3 User Guide*.
11404
11419
  #
@@ -11418,14 +11433,14 @@ module Aws::S3
11418
11433
  #
11419
11434
  # </note>
11420
11435
  #
11421
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11422
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11423
- # The S3 on Outposts hostname takes the form `
11436
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11437
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11438
+ # Outposts hostname takes the form `
11424
11439
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11425
- # When you use this action with S3 on Outposts through the Amazon Web
11426
- # Services SDKs, you provide the Outposts access point ARN in place of
11427
- # the bucket name. For more information about S3 on Outposts ARNs, see
11428
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11440
+ # When you use this action with S3 on Outposts, the destination bucket
11441
+ # must be the Outposts access point ARN or the access point alias. For
11442
+ # more information about S3 on Outposts, see [What is S3 on
11443
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11429
11444
  #
11430
11445
  #
11431
11446
  #
@@ -11723,7 +11738,7 @@ module Aws::S3
11723
11738
  # requests are not supported. Directory bucket names must be unique in
11724
11739
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11725
11740
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11726
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11741
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11727
11742
  # naming restrictions, see [Directory bucket naming rules][1] in the
11728
11743
  # *Amazon S3 User Guide*.
11729
11744
  #
@@ -11743,14 +11758,14 @@ module Aws::S3
11743
11758
  #
11744
11759
  # </note>
11745
11760
  #
11746
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11747
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11748
- # The S3 on Outposts hostname takes the form `
11761
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11762
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11763
+ # Outposts hostname takes the form `
11749
11764
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11750
- # When you use this action with S3 on Outposts through the Amazon Web
11751
- # Services SDKs, you provide the Outposts access point ARN in place of
11752
- # the bucket name. For more information about S3 on Outposts ARNs, see
11753
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11765
+ # When you use this action with S3 on Outposts, the destination bucket
11766
+ # must be the Outposts access point ARN or the access point alias. For
11767
+ # more information about S3 on Outposts, see [What is S3 on
11768
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11754
11769
  #
11755
11770
  #
11756
11771
  #
@@ -11867,8 +11882,8 @@ module Aws::S3
11867
11882
  # Specifies the location where the bucket will be created.
11868
11883
  #
11869
11884
  # For directory buckets, the location type is Availability Zone or Local
11870
- # Zone. For more information about directory buckets, see [Directory
11871
- # buckets][1] in the *Amazon S3 User Guide*.
11885
+ # Zone. For more information about directory buckets, see [Working with
11886
+ # directory buckets][1] in the *Amazon S3 User Guide*.
11872
11887
  #
11873
11888
  # <note markdown="1"> This functionality is only supported by directory buckets.
11874
11889
  #
@@ -13226,7 +13241,7 @@ module Aws::S3
13226
13241
  # @return [String]
13227
13242
  #
13228
13243
  # @!attribute [rw] checksum_algorithm
13229
- # Indicates the algorithm used to create the checksum for the object
13244
+ # Indicates the algorithm used to create the checksum for the request
13230
13245
  # when you use the SDK. This header will not provide any additional
13231
13246
  # functionality if you don't use the SDK. When you send this header,
13232
13247
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13282,7 +13297,7 @@ module Aws::S3
13282
13297
  # @return [String]
13283
13298
  #
13284
13299
  # @!attribute [rw] checksum_algorithm
13285
- # Indicates the algorithm used to create the checksum for the object
13300
+ # Indicates the algorithm used to create the checksum for the request
13286
13301
  # when you use the SDK. This header will not provide any additional
13287
13302
  # functionality if you don't use the SDK. When you send this header,
13288
13303
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13408,7 +13423,7 @@ module Aws::S3
13408
13423
  # @return [String]
13409
13424
  #
13410
13425
  # @!attribute [rw] checksum_algorithm
13411
- # Indicates the algorithm used to create the checksum for the object
13426
+ # Indicates the algorithm used to create the checksum for the request
13412
13427
  # when you use the SDK. This header will not provide any additional
13413
13428
  # functionality if you don't use the SDK. When you send this header,
13414
13429
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13477,7 +13492,7 @@ module Aws::S3
13477
13492
  # @return [String]
13478
13493
  #
13479
13494
  # @!attribute [rw] checksum_algorithm
13480
- # Indicates the algorithm used to create the checksum for the object
13495
+ # Indicates the algorithm used to create the checksum for the request
13481
13496
  # when you use the SDK. This header will not provide any additional
13482
13497
  # functionality if you don't use the SDK. When you send this header,
13483
13498
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13618,7 +13633,7 @@ module Aws::S3
13618
13633
  # @return [String]
13619
13634
  #
13620
13635
  # @!attribute [rw] checksum_algorithm
13621
- # Indicates the algorithm used to create the checksum for the object
13636
+ # Indicates the algorithm used to create the checksum for the request
13622
13637
  # when you use the SDK. This header will not provide any additional
13623
13638
  # functionality if you don't use the SDK. When you send this header,
13624
13639
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13695,7 +13710,7 @@ module Aws::S3
13695
13710
  # @return [String]
13696
13711
  #
13697
13712
  # @!attribute [rw] checksum_algorithm
13698
- # Indicates the algorithm used to create the checksum for the object
13713
+ # Indicates the algorithm used to create the checksum for the request
13699
13714
  # when you use the SDK. This header will not provide any additional
13700
13715
  # functionality if you don't use the SDK. When you send this header,
13701
13716
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13750,7 +13765,7 @@ module Aws::S3
13750
13765
  # @return [String]
13751
13766
  #
13752
13767
  # @!attribute [rw] checksum_algorithm
13753
- # Indicates the algorithm used to create the checksum for the object
13768
+ # Indicates the algorithm used to create the checksum for the request
13754
13769
  # when you use the SDK. This header will not provide any additional
13755
13770
  # functionality if you don't use the SDK. When you send this header,
13756
13771
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13863,7 +13878,7 @@ module Aws::S3
13863
13878
  # @return [String]
13864
13879
  #
13865
13880
  # @!attribute [rw] checksum_algorithm
13866
- # Indicates the algorithm used to create the checksum for the object
13881
+ # Indicates the algorithm used to create the checksum for the request
13867
13882
  # when you use the SDK. This header will not provide any additional
13868
13883
  # functionality if you don't use the SDK. When you send this header,
13869
13884
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13970,7 +13985,7 @@ module Aws::S3
13970
13985
  # @return [String]
13971
13986
  #
13972
13987
  # @!attribute [rw] checksum_algorithm
13973
- # Indicates the algorithm used to create the checksum for the object
13988
+ # Indicates the algorithm used to create the checksum for the request
13974
13989
  # when you use the SDK. This header will not provide any additional
13975
13990
  # functionality if you don't use the SDK. When you send this header,
13976
13991
  # there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -14071,7 +14086,7 @@ module Aws::S3
14071
14086
  # @return [String]
14072
14087
  #
14073
14088
  # @!attribute [rw] checksum_algorithm
14074
- # Indicates the algorithm used to create the checksum for the object
14089
+ # Indicates the algorithm used to create the checksum for the request
14075
14090
  # when you use the SDK. This header will not provide any additional
14076
14091
  # functionality if you don't use the SDK. When you send this header,
14077
14092
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14136,7 +14151,7 @@ module Aws::S3
14136
14151
  # @return [String]
14137
14152
  #
14138
14153
  # @!attribute [rw] checksum_algorithm
14139
- # Indicates the algorithm used to create the checksum for the object
14154
+ # Indicates the algorithm used to create the checksum for the request
14140
14155
  # when you use the SDK. This header will not provide any additional
14141
14156
  # functionality if you don't use the SDK. When you send this header,
14142
14157
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14195,7 +14210,7 @@ module Aws::S3
14195
14210
  # @return [String]
14196
14211
  #
14197
14212
  # @!attribute [rw] checksum_algorithm
14198
- # Indicates the algorithm used to create the checksum for the object
14213
+ # Indicates the algorithm used to create the checksum for the request
14199
14214
  # when you use the SDK. This header will not provide any additional
14200
14215
  # functionality if you don't use the SDK. When you send this header,
14201
14216
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14254,7 +14269,7 @@ module Aws::S3
14254
14269
  # @return [String]
14255
14270
  #
14256
14271
  # @!attribute [rw] checksum_algorithm
14257
- # Indicates the algorithm used to create the checksum for the object
14272
+ # Indicates the algorithm used to create the checksum for the request
14258
14273
  # when you use the SDK. This header will not provide any additional
14259
14274
  # functionality if you don't use the SDK. When you send this header,
14260
14275
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14320,7 +14335,7 @@ module Aws::S3
14320
14335
  # @return [String]
14321
14336
  #
14322
14337
  # @!attribute [rw] checksum_algorithm
14323
- # Indicates the algorithm used to create the checksum for the object
14338
+ # Indicates the algorithm used to create the checksum for the request
14324
14339
  # when you use the SDK. This header will not provide any additional
14325
14340
  # functionality if you don't use the SDK. When you send this header,
14326
14341
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14405,14 +14420,14 @@ module Aws::S3
14405
14420
  # bucket name. For more information about access point ARNs, see
14406
14421
  # [Using access points][1] in the *Amazon S3 User Guide*.
14407
14422
  #
14408
- # **S3 on Outposts** - When you use this action with Amazon S3 on
14409
- # Outposts, you must direct requests to the S3 on Outposts hostname.
14410
- # The S3 on Outposts hostname takes the form `
14423
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
14424
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
14425
+ # Outposts hostname takes the form `
14411
14426
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
14412
- # When you use this action with S3 on Outposts through the Amazon Web
14413
- # Services SDKs, you provide the Outposts access point ARN in place of
14414
- # the bucket name. For more information about S3 on Outposts ARNs, see
14415
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
14427
+ # When you use this action with S3 on Outposts, the destination bucket
14428
+ # must be the Outposts access point ARN or the access point alias. For
14429
+ # more information about S3 on Outposts, see [What is S3 on
14430
+ # Outposts?][2] in the *Amazon S3 User Guide*.
14416
14431
  #
14417
14432
  #
14418
14433
  #
@@ -15036,7 +15051,7 @@ module Aws::S3
15036
15051
  # requests are not supported. Directory bucket names must be unique in
15037
15052
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
15038
15053
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
15039
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15054
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
15040
15055
  # naming restrictions, see [Directory bucket naming rules][1] in the
15041
15056
  # *Amazon S3 User Guide*.
15042
15057
  #
@@ -15056,14 +15071,14 @@ module Aws::S3
15056
15071
  #
15057
15072
  # </note>
15058
15073
  #
15059
- # **S3 on Outposts** - When you use this action with Amazon S3 on
15060
- # Outposts, you must direct requests to the S3 on Outposts hostname.
15061
- # The S3 on Outposts hostname takes the form `
15074
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15075
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15076
+ # Outposts hostname takes the form `
15062
15077
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
15063
- # When you use this action with S3 on Outposts through the Amazon Web
15064
- # Services SDKs, you provide the Outposts access point ARN in place of
15065
- # the bucket name. For more information about S3 on Outposts ARNs, see
15066
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
15078
+ # When you use this action with S3 on Outposts, the destination bucket
15079
+ # must be the Outposts access point ARN or the access point alias. For
15080
+ # more information about S3 on Outposts, see [What is S3 on
15081
+ # Outposts?][3] in the *Amazon S3 User Guide*.
15067
15082
  #
15068
15083
  #
15069
15084
  #
@@ -15540,21 +15555,17 @@ module Aws::S3
15540
15555
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
15541
15556
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
15542
15557
  #
15543
- # **Directory buckets** - If you specify
15544
- # `x-amz-server-side-encryption` with `aws:kms`, the `
15545
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
15546
- # assigned the ID of the KMS symmetric encryption customer managed key
15547
- # that's configured for your directory bucket's default encryption
15548
- # setting. If you want to specify the `
15549
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
15550
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
15551
- # customer managed key that's configured for your directory bucket's
15552
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
15553
- # Request` error. Only use the key ID or key ARN. The key alias format
15554
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
15555
- # support 1 [customer managed key][1] per directory bucket for the
15556
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
15557
- # (`aws/s3`) isn't supported.
15558
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
15559
+ # recommended to specify the `x-amz-server-side-encryption` header to
15560
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
15561
+ # header implicitly uses the bucket's default KMS customer managed
15562
+ # key ID. If you want to explicitly set the `
15563
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
15564
+ # the bucket's default customer managed key (using key ID or ARN, not
15565
+ # alias). Your SSE-KMS configuration can only support 1 [customer
15566
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
15567
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
15568
+ # specification results in an HTTP `400 Bad Request` error.
15558
15569
  #
15559
15570
  #
15560
15571
  #
@@ -15875,14 +15886,14 @@ module Aws::S3
15875
15886
  # bucket name. For more information about access point ARNs, see
15876
15887
  # [Using access points][1] in the *Amazon S3 User Guide*.
15877
15888
  #
15878
- # **S3 on Outposts** - When you use this action with Amazon S3 on
15879
- # Outposts, you must direct requests to the S3 on Outposts hostname.
15880
- # The S3 on Outposts hostname takes the form `
15889
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15890
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15891
+ # Outposts hostname takes the form `
15881
15892
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
15882
- # When you use this action with S3 on Outposts through the Amazon Web
15883
- # Services SDKs, you provide the Outposts access point ARN in place of
15884
- # the bucket name. For more information about S3 on Outposts ARNs, see
15885
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
15893
+ # When you use this action with S3 on Outposts, the destination bucket
15894
+ # must be the Outposts access point ARN or the access point alias. For
15895
+ # more information about S3 on Outposts, see [What is S3 on
15896
+ # Outposts?][2] in the *Amazon S3 User Guide*.
15886
15897
  #
15887
15898
  #
15888
15899
  #
@@ -16569,14 +16580,14 @@ module Aws::S3
16569
16580
  # bucket name. For more information about access point ARNs, see
16570
16581
  # [Using access points][1] in the *Amazon S3 User Guide*.
16571
16582
  #
16572
- # **S3 on Outposts** - When you use this action with Amazon S3 on
16573
- # Outposts, you must direct requests to the S3 on Outposts hostname.
16574
- # The S3 on Outposts hostname takes the form `
16583
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
16584
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
16585
+ # Outposts hostname takes the form `
16575
16586
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
16576
- # When you use this action with S3 on Outposts through the Amazon Web
16577
- # Services SDKs, you provide the Outposts access point ARN in place of
16578
- # the bucket name. For more information about S3 on Outposts ARNs, see
16579
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
16587
+ # When you use this action with S3 on Outposts, the destination bucket
16588
+ # must be the Outposts access point ARN or the access point alias. For
16589
+ # more information about S3 on Outposts, see [What is S3 on
16590
+ # Outposts?][2] in the *Amazon S3 User Guide*.
16580
16591
  #
16581
16592
  #
16582
16593
  #
@@ -17296,9 +17307,8 @@ module Aws::S3
17296
17307
  # to a bucket. By default, Amazon S3 uses this KMS key for SSE-KMS.
17297
17308
  #
17298
17309
  # * **Directory buckets** - Your SSE-KMS configuration can only support
17299
- # 1 [customer managed key][2] per directory bucket for the lifetime of
17300
- # the bucket. The [Amazon Web Services managed key][3] (`aws/s3`)
17301
- # isn't supported.
17310
+ # 1 [customer managed key][2] per directory bucket's lifetime. The
17311
+ # [Amazon Web Services managed key][3] (`aws/s3`) isn't supported.
17302
17312
  #
17303
17313
  # * **Directory buckets** - For directory buckets, there are only two
17304
17314
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
@@ -17876,8 +17886,19 @@ module Aws::S3
17876
17886
  #
17877
17887
  # @!attribute [rw] days
17878
17888
  # Indicates the number of days after creation when objects are
17879
- # transitioned to the specified storage class. The value must be a
17880
- # positive integer.
17889
+ # transitioned to the specified storage class. If the specified
17890
+ # storage class is `INTELLIGENT_TIERING`, `GLACIER_IR`, `GLACIER`, or
17891
+ # `DEEP_ARCHIVE`, valid values are `0` or positive integers. If the
17892
+ # specified storage class is `STANDARD_IA` or `ONEZONE_IA`, valid
17893
+ # values are positive integers greater than `30`. Be aware that some
17894
+ # storage classes have a minimum storage duration and that you're
17895
+ # charged for transitioning objects before their minimum storage
17896
+ # duration. For more information, see [ Constraints and considerations
17897
+ # for transitions][1] in the *Amazon S3 User Guide*.
17898
+ #
17899
+ #
17900
+ #
17901
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-transition-general-considerations.html#lifecycle-configuration-constraints
17881
17902
  # @return [Integer]
17882
17903
  #
17883
17904
  # @!attribute [rw] storage_class
@@ -17978,7 +17999,7 @@ module Aws::S3
17978
17999
  # requests are not supported. Directory bucket names must be unique in
17979
18000
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
17980
18001
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
17981
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18002
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
17982
18003
  # naming restrictions, see [Directory bucket naming rules][1] in the
17983
18004
  # *Amazon S3 User Guide*.
17984
18005
  #
@@ -18006,14 +18027,14 @@ module Aws::S3
18006
18027
  #
18007
18028
  # </note>
18008
18029
  #
18009
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18010
- # Outposts, you must direct requests to the S3 on Outposts hostname.
18011
- # The S3 on Outposts hostname takes the form `
18030
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18031
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18032
+ # Outposts hostname takes the form `
18012
18033
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18013
- # When you use this action with S3 on Outposts through the Amazon Web
18014
- # Services SDKs, you provide the Outposts access point ARN in place of
18015
- # the bucket name. For more information about S3 on Outposts ARNs, see
18016
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18034
+ # When you use this action with S3 on Outposts, the destination bucket
18035
+ # must be the Outposts access point ARN or the access point alias. For
18036
+ # more information about S3 on Outposts, see [What is S3 on
18037
+ # Outposts?][3] in the *Amazon S3 User Guide*.
18017
18038
  #
18018
18039
  #
18019
18040
  #
@@ -18452,7 +18473,7 @@ module Aws::S3
18452
18473
  # requests are not supported. Directory bucket names must be unique in
18453
18474
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
18454
18475
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
18455
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18476
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
18456
18477
  # naming restrictions, see [Directory bucket naming rules][1] in the
18457
18478
  # *Amazon S3 User Guide*.
18458
18479
  #
@@ -18472,14 +18493,14 @@ module Aws::S3
18472
18493
  #
18473
18494
  # </note>
18474
18495
  #
18475
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18476
- # Outposts, you must direct requests to the S3 on Outposts hostname.
18477
- # The S3 on Outposts hostname takes the form `
18496
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18497
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18498
+ # Outposts hostname takes the form `
18478
18499
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18479
- # When you use this action with S3 on Outposts through the Amazon Web
18480
- # Services SDKs, you provide the Outposts access point ARN in place of
18481
- # the bucket name. For more information about S3 on Outposts ARNs, see
18482
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18500
+ # When you use this action with S3 on Outposts, the destination bucket
18501
+ # must be the Outposts access point ARN or the access point alias. For
18502
+ # more information about S3 on Outposts, see [What is S3 on
18503
+ # Outposts?][3] in the *Amazon S3 User Guide*.
18483
18504
  #
18484
18505
  #
18485
18506
  #
@@ -18930,7 +18951,12 @@ module Aws::S3
18930
18951
  #
18931
18952
  # @!attribute [rw] delete_marker
18932
18953
  # Specifies whether an object stored in Amazon S3 is (`true`) or is
18933
- # not (`false`) a delete marker.
18954
+ # not (`false`) a delete marker. To learn more about delete markers,
18955
+ # see [Working with delete markers][1].
18956
+ #
18957
+ #
18958
+ #
18959
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
18934
18960
  # @return [Boolean]
18935
18961
  #
18936
18962
  # @!attribute [rw] etag