aws-sdk-s3 1.179.0 → 1.180.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (27) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +5 -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 +488 -470
  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