aws-sdk-s3 1.90.0 → 1.94.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 (39) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +29 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3.rb +2 -2
  5. data/lib/aws-sdk-s3/arn/access_point_arn.rb +4 -6
  6. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +64 -0
  7. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +4 -6
  8. data/lib/aws-sdk-s3/bucket.rb +7 -7
  9. data/lib/aws-sdk-s3/bucket_acl.rb +2 -2
  10. data/lib/aws-sdk-s3/bucket_cors.rb +5 -5
  11. data/lib/aws-sdk-s3/bucket_lifecycle.rb +3 -3
  12. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
  13. data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
  14. data/lib/aws-sdk-s3/bucket_notification.rb +2 -2
  15. data/lib/aws-sdk-s3/bucket_policy.rb +3 -3
  16. data/lib/aws-sdk-s3/bucket_request_payment.rb +2 -2
  17. data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
  18. data/lib/aws-sdk-s3/bucket_versioning.rb +4 -4
  19. data/lib/aws-sdk-s3/bucket_website.rb +3 -3
  20. data/lib/aws-sdk-s3/client.rb +699 -421
  21. data/lib/aws-sdk-s3/client_api.rb +60 -1
  22. data/lib/aws-sdk-s3/customizations/object.rb +30 -11
  23. data/lib/aws-sdk-s3/errors.rb +1 -1
  24. data/lib/aws-sdk-s3/event_streams.rb +1 -1
  25. data/lib/aws-sdk-s3/file_uploader.rb +2 -2
  26. data/lib/aws-sdk-s3/multipart_upload.rb +4 -4
  27. data/lib/aws-sdk-s3/multipart_upload_part.rb +5 -5
  28. data/lib/aws-sdk-s3/object.rb +97 -11
  29. data/lib/aws-sdk-s3/object_acl.rb +2 -2
  30. data/lib/aws-sdk-s3/object_summary.rb +10 -10
  31. data/lib/aws-sdk-s3/object_version.rb +5 -5
  32. data/lib/aws-sdk-s3/plugins/arn.rb +57 -34
  33. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +9 -9
  34. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  35. data/lib/aws-sdk-s3/plugins/s3_signer.rb +6 -0
  36. data/lib/aws-sdk-s3/resource.rb +1 -1
  37. data/lib/aws-sdk-s3/types.rb +577 -244
  38. data/lib/aws-sdk-s3/waiters.rb +1 -1
  39. metadata +7 -6
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -198,7 +198,7 @@ module Aws::S3
198
198
  # @option options [required, Types::RequestPaymentConfiguration] :request_payment_configuration
199
199
  # Container for Payer.
200
200
  # @option options [String] :expected_bucket_owner
201
- # The account id of the expected bucket owner. If the bucket is owned by
201
+ # The account ID of the expected bucket owner. If the bucket is owned by
202
202
  # a different account, the request will fail with an HTTP `403 (Access
203
203
  # Denied)` error.
204
204
  # @return [EmptyStructure]
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -181,7 +181,7 @@ module Aws::S3
181
181
  # })
182
182
  # @param [Hash] options ({})
183
183
  # @option options [String] :expected_bucket_owner
184
- # The account id of the expected bucket owner. If the bucket is owned by
184
+ # The account ID of the expected bucket owner. If the bucket is owned by
185
185
  # a different account, the request will fail with an HTTP `403 (Access
186
186
  # Denied)` error.
187
187
  # @return [EmptyStructure]
@@ -220,7 +220,7 @@ module Aws::S3
220
220
  # @option options [required, Types::Tagging] :tagging
221
221
  # Container for the `TagSet` and `Tag` elements.
222
222
  # @option options [String] :expected_bucket_owner
223
- # The account id of the expected bucket owner. If the bucket is owned by
223
+ # The account ID of the expected bucket owner. If the bucket is owned by
224
224
  # a different account, the request will fail with an HTTP `403 (Access
225
225
  # Denied)` error.
226
226
  # @return [EmptyStructure]
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -207,7 +207,7 @@ module Aws::S3
207
207
  # The concatenation of the authentication device's serial number, a
208
208
  # space, and the value that is displayed on your authentication device.
209
209
  # @option options [String] :expected_bucket_owner
210
- # The account id of the expected bucket owner. If the bucket is owned by
210
+ # The account ID of the expected bucket owner. If the bucket is owned by
211
211
  # a different account, the request will fail with an HTTP `403 (Access
212
212
  # Denied)` error.
213
213
  # @return [EmptyStructure]
@@ -252,7 +252,7 @@ module Aws::S3
252
252
  # @option options [required, Types::VersioningConfiguration] :versioning_configuration
253
253
  # Container for setting the versioning state.
254
254
  # @option options [String] :expected_bucket_owner
255
- # The account id of the expected bucket owner. If the bucket is owned by
255
+ # The account ID of the expected bucket owner. If the bucket is owned by
256
256
  # a different account, the request will fail with an HTTP `403 (Access
257
257
  # Denied)` error.
258
258
  # @return [EmptyStructure]
@@ -286,7 +286,7 @@ module Aws::S3
286
286
  # The concatenation of the authentication device's serial number, a
287
287
  # space, and the value that is displayed on your authentication device.
288
288
  # @option options [String] :expected_bucket_owner
289
- # The account id of the expected bucket owner. If the bucket is owned by
289
+ # The account ID of the expected bucket owner. If the bucket is owned by
290
290
  # a different account, the request will fail with an HTTP `403 (Access
291
291
  # Denied)` error.
292
292
  # @return [EmptyStructure]
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -203,7 +203,7 @@ module Aws::S3
203
203
  # })
204
204
  # @param [Hash] options ({})
205
205
  # @option options [String] :expected_bucket_owner
206
- # The account id of the expected bucket owner. If the bucket is owned by
206
+ # The account ID of the expected bucket owner. If the bucket is owned by
207
207
  # a different account, the request will fail with an HTTP `403 (Access
208
208
  # Denied)` error.
209
209
  # @return [EmptyStructure]
@@ -261,7 +261,7 @@ module Aws::S3
261
261
  # @option options [required, Types::WebsiteConfiguration] :website_configuration
262
262
  # Container for the request.
263
263
  # @option options [String] :expected_bucket_owner
264
- # The account id of the expected bucket owner. If the bucket is owned by
264
+ # The account ID of the expected bucket owner. If the bucket is owned by
265
265
  # a different account, the request will fail with an HTTP `403 (Access
266
266
  # Denied)` error.
267
267
  # @return [EmptyStructure]
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -39,6 +39,7 @@ require 'aws-sdk-s3/plugins/http_200_errors.rb'
39
39
  require 'aws-sdk-s3/plugins/iad_regional_endpoint.rb'
40
40
  require 'aws-sdk-s3/plugins/location_constraint.rb'
41
41
  require 'aws-sdk-s3/plugins/md5s.rb'
42
+ require 'aws-sdk-s3/plugins/object_lambda_endpoint.rb'
42
43
  require 'aws-sdk-s3/plugins/redirects.rb'
43
44
  require 'aws-sdk-s3/plugins/s3_host_id.rb'
44
45
  require 'aws-sdk-s3/plugins/s3_signer.rb'
@@ -102,6 +103,7 @@ module Aws::S3
102
103
  add_plugin(Aws::S3::Plugins::IADRegionalEndpoint)
103
104
  add_plugin(Aws::S3::Plugins::LocationConstraint)
104
105
  add_plugin(Aws::S3::Plugins::Md5s)
106
+ add_plugin(Aws::S3::Plugins::ObjectLambdaEndpoint)
105
107
  add_plugin(Aws::S3::Plugins::Redirects)
106
108
  add_plugin(Aws::S3::Plugins::S3HostId)
107
109
  add_plugin(Aws::S3::Plugins::S3Signer)
@@ -326,8 +328,8 @@ module Aws::S3
326
328
  #
327
329
  #
328
330
  # @option options [String] :s3_us_east_1_regional_endpoint ("legacy")
329
- # Passing in `regional` to enable regional endpoint for S3's `us-east-1`
330
- # region. Defaults to `legacy` mode using global endpoint.
331
+ # Pass in `regional` to enable the `us-east-1` regional endpoint.
332
+ # Defaults to `legacy` mode which uses the global endpoint.
331
333
  #
332
334
  # @option options [Boolean] :s3_use_arn_region (true)
333
335
  # For S3 ARNs passed into the `:bucket` parameter, this option will
@@ -453,7 +455,7 @@ module Aws::S3
453
455
  # When using this action with an access point through the AWS SDKs, you
454
456
  # provide the access point ARN in place of the bucket name. For more
455
457
  # information about access point ARNs, see [Using Access Points][1] in
456
- # the *Amazon Simple Storage Service Developer Guide*.
458
+ # the *Amazon S3 User Guide*.
457
459
  #
458
460
  # When using this action with Amazon S3 on Outposts, you must direct
459
461
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -462,12 +464,12 @@ module Aws::S3
462
464
  # When using this action using S3 on Outposts through the AWS SDKs, you
463
465
  # provide the Outposts bucket ARN in place of the bucket name. For more
464
466
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
465
- # in the *Amazon Simple Storage Service Developer Guide*.
467
+ # in the *Amazon S3 User Guide*.
466
468
  #
467
469
  #
468
470
  #
469
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
470
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
471
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
472
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
471
473
  #
472
474
  # @option params [required, String] :key
473
475
  # Key of the object for which the multipart upload was initiated.
@@ -487,7 +489,7 @@ module Aws::S3
487
489
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
488
490
  #
489
491
  # @option params [String] :expected_bucket_owner
490
- # The account id of the expected bucket owner. If the bucket is owned by
492
+ # The account ID of the expected bucket owner. If the bucket is owned by
491
493
  # a different account, the request will fail with an HTTP `403 (Access
492
494
  # Denied)` error.
493
495
  #
@@ -645,7 +647,7 @@ module Aws::S3
645
647
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
646
648
  #
647
649
  # @option params [String] :expected_bucket_owner
648
- # The account id of the expected bucket owner. If the bucket is owned by
650
+ # The account ID of the expected bucket owner. If the bucket is owned by
649
651
  # a different account, the request will fail with an HTTP `403 (Access
650
652
  # Denied)` error.
651
653
  #
@@ -844,7 +846,7 @@ module Aws::S3
844
846
  #
845
847
  # If a target object uses SSE-KMS, you can enable an S3 Bucket Key for
846
848
  # the object. For more information, see [Amazon S3 Bucket Keys][9] in
847
- # the *Amazon Simple Storage Service User Guide*.
849
+ # the *Amazon S3 User Guide*.
848
850
  #
849
851
  # **Access Control List (ACL)-Specific Request Headers**
850
852
  #
@@ -924,7 +926,7 @@ module Aws::S3
924
926
  # When using this action with an access point through the AWS SDKs, you
925
927
  # provide the access point ARN in place of the bucket name. For more
926
928
  # information about access point ARNs, see [Using Access Points][1] in
927
- # the *Amazon Simple Storage Service Developer Guide*.
929
+ # the *Amazon S3 User Guide*.
928
930
  #
929
931
  # When using this action with Amazon S3 on Outposts, you must direct
930
932
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -933,12 +935,12 @@ module Aws::S3
933
935
  # When using this action using S3 on Outposts through the AWS SDKs, you
934
936
  # provide the Outposts bucket ARN in place of the bucket name. For more
935
937
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
936
- # in the *Amazon Simple Storage Service Developer Guide*.
938
+ # in the *Amazon S3 User Guide*.
937
939
  #
938
940
  #
939
941
  #
940
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
941
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
942
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
943
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
942
944
  #
943
945
  # @option params [String] :cache_control
944
946
  # Specifies caching behavior along the request/reply chain.
@@ -1001,7 +1003,7 @@ module Aws::S3
1001
1003
  #
1002
1004
  #
1003
1005
  #
1004
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
1006
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
1005
1007
  #
1006
1008
  # @option params [String] :copy_source_if_match
1007
1009
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -1159,12 +1161,12 @@ module Aws::S3
1159
1161
  # Specifies whether you want to apply a Legal Hold to the copied object.
1160
1162
  #
1161
1163
  # @option params [String] :expected_bucket_owner
1162
- # The account id of the expected destination bucket owner. If the
1164
+ # The account ID of the expected destination bucket owner. If the
1163
1165
  # destination bucket is owned by a different account, the request will
1164
1166
  # fail with an HTTP `403 (Access Denied)` error.
1165
1167
  #
1166
1168
  # @option params [String] :expected_source_bucket_owner
1167
- # The account id of the expected source bucket owner. If the source
1169
+ # The account ID of the expected source bucket owner. If the source
1168
1170
  # bucket is owned by a different account, the request will fail with an
1169
1171
  # HTTP `403 (Access Denied)` error.
1170
1172
  #
@@ -1417,33 +1419,33 @@ module Aws::S3
1417
1419
  # * {Types::CreateBucketOutput#location #location} => String
1418
1420
  #
1419
1421
  #
1420
- # @example Example: To create a bucket
1422
+ # @example Example: To create a bucket in a specific region
1421
1423
  #
1422
- # # The following example creates a bucket.
1424
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1423
1425
  #
1424
1426
  # resp = client.create_bucket({
1425
1427
  # bucket: "examplebucket",
1428
+ # create_bucket_configuration: {
1429
+ # location_constraint: "eu-west-1",
1430
+ # },
1426
1431
  # })
1427
1432
  #
1428
1433
  # resp.to_h outputs the following:
1429
1434
  # {
1430
- # location: "/examplebucket",
1435
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1431
1436
  # }
1432
1437
  #
1433
- # @example Example: To create a bucket in a specific region
1438
+ # @example Example: To create a bucket
1434
1439
  #
1435
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1440
+ # # The following example creates a bucket.
1436
1441
  #
1437
1442
  # resp = client.create_bucket({
1438
1443
  # bucket: "examplebucket",
1439
- # create_bucket_configuration: {
1440
- # location_constraint: "eu-west-1",
1441
- # },
1442
1444
  # })
1443
1445
  #
1444
1446
  # resp.to_h outputs the following:
1445
1447
  # {
1446
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1448
+ # location: "/examplebucket",
1447
1449
  # }
1448
1450
  #
1449
1451
  # @example Request syntax with placeholder values
@@ -1722,7 +1724,7 @@ module Aws::S3
1722
1724
  # When using this action with an access point through the AWS SDKs, you
1723
1725
  # provide the access point ARN in place of the bucket name. For more
1724
1726
  # information about access point ARNs, see [Using Access Points][1] in
1725
- # the *Amazon Simple Storage Service Developer Guide*.
1727
+ # the *Amazon S3 User Guide*.
1726
1728
  #
1727
1729
  # When using this action with Amazon S3 on Outposts, you must direct
1728
1730
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1731,12 +1733,12 @@ module Aws::S3
1731
1733
  # When using this action using S3 on Outposts through the AWS SDKs, you
1732
1734
  # provide the Outposts bucket ARN in place of the bucket name. For more
1733
1735
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
1734
- # in the *Amazon Simple Storage Service Developer Guide*.
1736
+ # in the *Amazon S3 User Guide*.
1735
1737
  #
1736
1738
  #
1737
1739
  #
1738
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
1739
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
1740
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
1741
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
1740
1742
  #
1741
1743
  # @option params [String] :cache_control
1742
1744
  # Specifies caching behavior along the request/reply chain.
@@ -1875,7 +1877,7 @@ module Aws::S3
1875
1877
  # object.
1876
1878
  #
1877
1879
  # @option params [String] :expected_bucket_owner
1878
- # The account id of the expected bucket owner. If the bucket is owned by
1880
+ # The account ID of the expected bucket owner. If the bucket is owned by
1879
1881
  # a different account, the request will fail with an HTTP `403 (Access
1880
1882
  # Denied)` error.
1881
1883
  #
@@ -1990,7 +1992,7 @@ module Aws::S3
1990
1992
  # Specifies the bucket being deleted.
1991
1993
  #
1992
1994
  # @option params [String] :expected_bucket_owner
1993
- # The account id of the expected bucket owner. If the bucket is owned by
1995
+ # The account ID of the expected bucket owner. If the bucket is owned by
1994
1996
  # a different account, the request will fail with an HTTP `403 (Access
1995
1997
  # Denied)` error.
1996
1998
  #
@@ -2045,8 +2047,8 @@ module Aws::S3
2045
2047
  #
2046
2048
  #
2047
2049
  #
2048
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2049
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2050
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2051
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2050
2052
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
2051
2053
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
2052
2054
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -2060,7 +2062,7 @@ module Aws::S3
2060
2062
  # The ID that identifies the analytics configuration.
2061
2063
  #
2062
2064
  # @option params [String] :expected_bucket_owner
2063
- # The account id of the expected bucket owner. If the bucket is owned by
2065
+ # The account ID of the expected bucket owner. If the bucket is owned by
2064
2066
  # a different account, the request will fail with an HTTP `403 (Access
2065
2067
  # Denied)` error.
2066
2068
  #
@@ -2090,7 +2092,7 @@ module Aws::S3
2090
2092
  # default and can grant this permission to others.
2091
2093
  #
2092
2094
  # For information about `cors`, see [Enabling Cross-Origin Resource
2093
- # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
2095
+ # Sharing][1] in the *Amazon S3 User Guide*.
2094
2096
  #
2095
2097
  # **Related Resources:**
2096
2098
  #
@@ -2108,7 +2110,7 @@ module Aws::S3
2108
2110
  # Specifies the bucket whose `cors` configuration is being deleted.
2109
2111
  #
2110
2112
  # @option params [String] :expected_bucket_owner
2111
- # The account id of the expected bucket owner. If the bucket is owned by
2113
+ # The account ID of the expected bucket owner. If the bucket is owned by
2112
2114
  # a different account, the request will fail with an HTTP `403 (Access
2113
2115
  # Denied)` error.
2114
2116
  #
@@ -2142,15 +2144,15 @@ module Aws::S3
2142
2144
  # This implementation of the DELETE action removes default encryption
2143
2145
  # from the bucket. For information about the Amazon S3 default
2144
2146
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
2145
- # the *Amazon Simple Storage Service User Guide*.
2147
+ # the *Amazon S3 User Guide*.
2146
2148
  #
2147
2149
  # To use this operation, you must have permissions to perform the
2148
2150
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
2149
2151
  # permission by default. The bucket owner can grant this permission to
2150
2152
  # others. For more information about permissions, see [Permissions
2151
2153
  # Related to Bucket Subresource Operations][2] and [Managing Access
2152
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
2153
- # Storage Service User Guide*.
2154
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
2155
+ # Guide*.
2154
2156
  #
2155
2157
  # **Related Resources**
2156
2158
  #
@@ -2161,8 +2163,8 @@ module Aws::S3
2161
2163
  #
2162
2164
  #
2163
2165
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
2164
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2165
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2166
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2167
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2166
2168
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
2167
2169
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
2168
2170
  #
@@ -2171,7 +2173,7 @@ module Aws::S3
2171
2173
  # configuration to delete.
2172
2174
  #
2173
2175
  # @option params [String] :expected_bucket_owner
2174
- # The account id of the expected bucket owner. If the bucket is owned by
2176
+ # The account ID of the expected bucket owner. If the bucket is owned by
2175
2177
  # a different account, the request will fail with an HTTP `403 (Access
2176
2178
  # Denied)` error.
2177
2179
  #
@@ -2278,8 +2280,8 @@ module Aws::S3
2278
2280
  #
2279
2281
  #
2280
2282
  #
2281
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2282
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2283
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2284
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2283
2285
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
2284
2286
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
2285
2287
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
@@ -2293,7 +2295,7 @@ module Aws::S3
2293
2295
  # The ID used to identify the inventory configuration.
2294
2296
  #
2295
2297
  # @option params [String] :expected_bucket_owner
2296
- # The account id of the expected bucket owner. If the bucket is owned by
2298
+ # The account ID of the expected bucket owner. If the bucket is owned by
2297
2299
  # a different account, the request will fail with an HTTP `403 (Access
2298
2300
  # Denied)` error.
2299
2301
  #
@@ -2349,7 +2351,7 @@ module Aws::S3
2349
2351
  # The bucket name of the lifecycle to delete.
2350
2352
  #
2351
2353
  # @option params [String] :expected_bucket_owner
2352
- # The account id of the expected bucket owner. If the bucket is owned by
2354
+ # The account ID of the expected bucket owner. If the bucket is owned by
2353
2355
  # a different account, the request will fail with an HTTP `403 (Access
2354
2356
  # Denied)` error.
2355
2357
  #
@@ -2407,8 +2409,8 @@ module Aws::S3
2407
2409
  #
2408
2410
  #
2409
2411
  #
2410
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2411
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2412
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2413
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2412
2414
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
2413
2415
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
2414
2416
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -2421,7 +2423,7 @@ module Aws::S3
2421
2423
  # The ID used to identify the metrics configuration.
2422
2424
  #
2423
2425
  # @option params [String] :expected_bucket_owner
2424
- # The account id of the expected bucket owner. If the bucket is owned by
2426
+ # The account ID of the expected bucket owner. If the bucket is owned by
2425
2427
  # a different account, the request will fail with an HTTP `403 (Access
2426
2428
  # Denied)` error.
2427
2429
  #
@@ -2468,7 +2470,7 @@ module Aws::S3
2468
2470
  # The Amazon S3 bucket whose `OwnershipControls` you want to delete.
2469
2471
  #
2470
2472
  # @option params [String] :expected_bucket_owner
2471
- # The account id of the expected bucket owner. If the bucket is owned by
2473
+ # The account ID of the expected bucket owner. If the bucket is owned by
2472
2474
  # a different account, the request will fail with an HTTP `403 (Access
2473
2475
  # Denied)` error.
2474
2476
  #
@@ -2525,7 +2527,7 @@ module Aws::S3
2525
2527
  # The bucket name.
2526
2528
  #
2527
2529
  # @option params [String] :expected_bucket_owner
2528
- # The account id of the expected bucket owner. If the bucket is owned by
2530
+ # The account ID of the expected bucket owner. If the bucket is owned by
2529
2531
  # a different account, the request will fail with an HTTP `403 (Access
2530
2532
  # Denied)` error.
2531
2533
  #
@@ -2581,8 +2583,8 @@ module Aws::S3
2581
2583
  #
2582
2584
  #
2583
2585
  #
2584
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2585
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2586
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2587
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2586
2588
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
2587
2589
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
2588
2590
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
@@ -2591,7 +2593,7 @@ module Aws::S3
2591
2593
  # The bucket name.
2592
2594
  #
2593
2595
  # @option params [String] :expected_bucket_owner
2594
- # The account id of the expected bucket owner. If the bucket is owned by
2596
+ # The account ID of the expected bucket owner. If the bucket is owned by
2595
2597
  # a different account, the request will fail with an HTTP `403 (Access
2596
2598
  # Denied)` error.
2597
2599
  #
@@ -2643,7 +2645,7 @@ module Aws::S3
2643
2645
  # The bucket that has the tag set to be removed.
2644
2646
  #
2645
2647
  # @option params [String] :expected_bucket_owner
2646
- # The account id of the expected bucket owner. If the bucket is owned by
2648
+ # The account ID of the expected bucket owner. If the bucket is owned by
2647
2649
  # a different account, the request will fail with an HTTP `403 (Access
2648
2650
  # Denied)` error.
2649
2651
  #
@@ -2707,7 +2709,7 @@ module Aws::S3
2707
2709
  # configuration.
2708
2710
  #
2709
2711
  # @option params [String] :expected_bucket_owner
2710
- # The account id of the expected bucket owner. If the bucket is owned by
2712
+ # The account ID of the expected bucket owner. If the bucket is owned by
2711
2713
  # a different account, the request will fail with an HTTP `403 (Access
2712
2714
  # Denied)` error.
2713
2715
  #
@@ -2740,7 +2742,8 @@ module Aws::S3
2740
2742
 
2741
2743
  # Removes the null version (if there is one) of an object and inserts a
2742
2744
  # delete marker, which becomes the latest version of the object. If
2743
- # there isn't a null version, Amazon S3 does not remove any objects.
2745
+ # there isn't a null version, Amazon S3 does not remove any objects but
2746
+ # will still respond that the command was successful.
2744
2747
  #
2745
2748
  # To remove a specific version, you must be the bucket owner and you
2746
2749
  # must use the version Id subresource. Using this subresource
@@ -2785,7 +2788,7 @@ module Aws::S3
2785
2788
  # When using this action with an access point through the AWS SDKs, you
2786
2789
  # provide the access point ARN in place of the bucket name. For more
2787
2790
  # information about access point ARNs, see [Using Access Points][1] in
2788
- # the *Amazon Simple Storage Service Developer Guide*.
2791
+ # the *Amazon S3 User Guide*.
2789
2792
  #
2790
2793
  # When using this action with Amazon S3 on Outposts, you must direct
2791
2794
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2794,12 +2797,12 @@ module Aws::S3
2794
2797
  # When using this action using S3 on Outposts through the AWS SDKs, you
2795
2798
  # provide the Outposts bucket ARN in place of the bucket name. For more
2796
2799
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2797
- # in the *Amazon Simple Storage Service Developer Guide*.
2800
+ # in the *Amazon S3 User Guide*.
2798
2801
  #
2799
2802
  #
2800
2803
  #
2801
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2802
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2804
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2805
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2803
2806
  #
2804
2807
  # @option params [required, String] :key
2805
2808
  # Key name of the object to delete.
@@ -2829,7 +2832,7 @@ module Aws::S3
2829
2832
  # restrictions to process this operation.
2830
2833
  #
2831
2834
  # @option params [String] :expected_bucket_owner
2832
- # The account id of the expected bucket owner. If the bucket is owned by
2835
+ # The account ID of the expected bucket owner. If the bucket is owned by
2833
2836
  # a different account, the request will fail with an HTTP `403 (Access
2834
2837
  # Denied)` error.
2835
2838
  #
@@ -2921,7 +2924,7 @@ module Aws::S3
2921
2924
  # When using this action with an access point through the AWS SDKs, you
2922
2925
  # provide the access point ARN in place of the bucket name. For more
2923
2926
  # information about access point ARNs, see [Using Access Points][1] in
2924
- # the *Amazon Simple Storage Service Developer Guide*.
2927
+ # the *Amazon S3 User Guide*.
2925
2928
  #
2926
2929
  # When using this action with Amazon S3 on Outposts, you must direct
2927
2930
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2930,12 +2933,12 @@ module Aws::S3
2930
2933
  # When using this action using S3 on Outposts through the AWS SDKs, you
2931
2934
  # provide the Outposts bucket ARN in place of the bucket name. For more
2932
2935
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2933
- # in the *Amazon Simple Storage Service Developer Guide*.
2936
+ # in the *Amazon S3 User Guide*.
2934
2937
  #
2935
2938
  #
2936
2939
  #
2937
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2938
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2940
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2941
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2939
2942
  #
2940
2943
  # @option params [required, String] :key
2941
2944
  # The key that identifies the object in the bucket from which to remove
@@ -2945,7 +2948,7 @@ module Aws::S3
2945
2948
  # The versionId of the object that the tag-set will be removed from.
2946
2949
  #
2947
2950
  # @option params [String] :expected_bucket_owner
2948
- # The account id of the expected bucket owner. If the bucket is owned by
2951
+ # The account ID of the expected bucket owner. If the bucket is owned by
2949
2952
  # a different account, the request will fail with an HTTP `403 (Access
2950
2953
  # Denied)` error.
2951
2954
  #
@@ -2954,35 +2957,35 @@ module Aws::S3
2954
2957
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
2955
2958
  #
2956
2959
  #
2957
- # @example Example: To remove tag set from an object version
2960
+ # @example Example: To remove tag set from an object
2958
2961
  #
2959
- # # The following example removes tag set associated with the specified object version. The request specifies both the
2960
- # # object key and object version.
2962
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2963
+ # # operation removes tag set from the latest object version.
2961
2964
  #
2962
2965
  # resp = client.delete_object_tagging({
2963
2966
  # bucket: "examplebucket",
2964
2967
  # key: "HappyFace.jpg",
2965
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2966
2968
  # })
2967
2969
  #
2968
2970
  # resp.to_h outputs the following:
2969
2971
  # {
2970
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2972
+ # version_id: "null",
2971
2973
  # }
2972
2974
  #
2973
- # @example Example: To remove tag set from an object
2975
+ # @example Example: To remove tag set from an object version
2974
2976
  #
2975
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2976
- # # operation removes tag set from the latest object version.
2977
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
2978
+ # # object key and object version.
2977
2979
  #
2978
2980
  # resp = client.delete_object_tagging({
2979
2981
  # bucket: "examplebucket",
2980
2982
  # key: "HappyFace.jpg",
2983
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2981
2984
  # })
2982
2985
  #
2983
2986
  # resp.to_h outputs the following:
2984
2987
  # {
2985
- # version_id: "null",
2988
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2986
2989
  # }
2987
2990
  #
2988
2991
  # @example Request syntax with placeholder values
@@ -3069,7 +3072,7 @@ module Aws::S3
3069
3072
  # When using this action with an access point through the AWS SDKs, you
3070
3073
  # provide the access point ARN in place of the bucket name. For more
3071
3074
  # information about access point ARNs, see [Using Access Points][1] in
3072
- # the *Amazon Simple Storage Service Developer Guide*.
3075
+ # the *Amazon S3 User Guide*.
3073
3076
  #
3074
3077
  # When using this action with Amazon S3 on Outposts, you must direct
3075
3078
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -3078,12 +3081,12 @@ module Aws::S3
3078
3081
  # When using this action using S3 on Outposts through the AWS SDKs, you
3079
3082
  # provide the Outposts bucket ARN in place of the bucket name. For more
3080
3083
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
3081
- # in the *Amazon Simple Storage Service Developer Guide*.
3084
+ # in the *Amazon S3 User Guide*.
3082
3085
  #
3083
3086
  #
3084
3087
  #
3085
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
3086
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
3088
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
3089
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
3087
3090
  #
3088
3091
  # @option params [required, Types::Delete] :delete
3089
3092
  # Container for the request.
@@ -3111,7 +3114,7 @@ module Aws::S3
3111
3114
  # permissions to perform this operation.
3112
3115
  #
3113
3116
  # @option params [String] :expected_bucket_owner
3114
- # The account id of the expected bucket owner. If the bucket is owned by
3117
+ # The account ID of the expected bucket owner. If the bucket is owned by
3115
3118
  # a different account, the request will fail with an HTTP `403 (Access
3116
3119
  # Denied)` error.
3117
3120
  #
@@ -3255,8 +3258,8 @@ module Aws::S3
3255
3258
  #
3256
3259
  #
3257
3260
  #
3258
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3259
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3261
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3262
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3260
3263
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
3261
3264
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
3262
3265
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
@@ -3267,7 +3270,7 @@ module Aws::S3
3267
3270
  # to delete.
3268
3271
  #
3269
3272
  # @option params [String] :expected_bucket_owner
3270
- # The account id of the expected bucket owner. If the bucket is owned by
3273
+ # The account ID of the expected bucket owner. If the bucket is owned by
3271
3274
  # a different account, the request will fail with an HTTP `403 (Access
3272
3275
  # Denied)` error.
3273
3276
  #
@@ -3300,8 +3303,8 @@ module Aws::S3
3300
3303
  # permission by default. The bucket owner can grant this permission to
3301
3304
  # others. For more information about permissions, see [Permissions
3302
3305
  # Related to Bucket Subresource Operations][1] and [Managing Access
3303
- # Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
3304
- # Storage Service User Guide*.
3306
+ # Permissions to your Amazon S3 Resources][2] in the *Amazon S3 User
3307
+ # Guide*.
3305
3308
  #
3306
3309
  # You set the Transfer Acceleration state of an existing bucket to
3307
3310
  # `Enabled` or `Suspended` by using the
@@ -3312,7 +3315,7 @@ module Aws::S3
3312
3315
  # Acceleration state if a state has never been set on the bucket.
3313
3316
  #
3314
3317
  # For more information about transfer acceleration, see [Transfer
3315
- # Acceleration][4] in the Amazon Simple Storage Service User Guide.
3318
+ # Acceleration][4] in the Amazon S3 User Guide.
3316
3319
  #
3317
3320
  # **Related Resources**
3318
3321
  #
@@ -3322,8 +3325,8 @@ module Aws::S3
3322
3325
  #
3323
3326
  #
3324
3327
  #
3325
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3326
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3328
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3329
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3327
3330
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html
3328
3331
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
3329
3332
  #
@@ -3332,7 +3335,7 @@ module Aws::S3
3332
3335
  # retrieved.
3333
3336
  #
3334
3337
  # @option params [String] :expected_bucket_owner
3335
- # The account id of the expected bucket owner. If the bucket is owned by
3338
+ # The account ID of the expected bucket owner. If the bucket is owned by
3336
3339
  # a different account, the request will fail with an HTTP `403 (Access
3337
3340
  # Denied)` error.
3338
3341
  #
@@ -3381,7 +3384,7 @@ module Aws::S3
3381
3384
  # Specifies the S3 bucket whose ACL is being requested.
3382
3385
  #
3383
3386
  # @option params [String] :expected_bucket_owner
3384
- # The account id of the expected bucket owner. If the bucket is owned by
3387
+ # The account ID of the expected bucket owner. If the bucket is owned by
3385
3388
  # a different account, the request will fail with an HTTP `403 (Access
3386
3389
  # Denied)` error.
3387
3390
  #
@@ -3427,12 +3430,11 @@ module Aws::S3
3427
3430
  # permission by default. The bucket owner can grant this permission to
3428
3431
  # others. For more information about permissions, see [ Permissions
3429
3432
  # Related to Bucket Subresource Operations][1] and [Managing Access
3430
- # Permissions to Your Amazon S3 Resources][2] in the *Amazon Simple
3431
- # Storage Service User Guide*.
3433
+ # Permissions to Your Amazon S3 Resources][2] in the *Amazon S3 User
3434
+ # Guide*.
3432
3435
  #
3433
3436
  # For information about Amazon S3 analytics feature, see [Amazon S3
3434
- # Analytics – Storage Class Analysis][3] in the *Amazon Simple Storage
3435
- # Service User Guide*.
3437
+ # Analytics – Storage Class Analysis][3] in the *Amazon S3 User Guide*.
3436
3438
  #
3437
3439
  # **Related Resources**
3438
3440
  #
@@ -3444,8 +3446,8 @@ module Aws::S3
3444
3446
  #
3445
3447
  #
3446
3448
  #
3447
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3448
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3449
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3450
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3449
3451
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
3450
3452
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
3451
3453
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -3459,7 +3461,7 @@ module Aws::S3
3459
3461
  # The ID that identifies the analytics configuration.
3460
3462
  #
3461
3463
  # @option params [String] :expected_bucket_owner
3462
- # The account id of the expected bucket owner. If the bucket is owned by
3464
+ # The account ID of the expected bucket owner. If the bucket is owned by
3463
3465
  # a different account, the request will fail with an HTTP `403 (Access
3464
3466
  # Denied)` error.
3465
3467
  #
@@ -3525,7 +3527,7 @@ module Aws::S3
3525
3527
  # The bucket name for which to get the cors configuration.
3526
3528
  #
3527
3529
  # @option params [String] :expected_bucket_owner
3528
- # The account id of the expected bucket owner. If the bucket is owned by
3530
+ # The account ID of the expected bucket owner. If the bucket is owned by
3529
3531
  # a different account, the request will fail with an HTTP `403 (Access
3530
3532
  # Denied)` error.
3531
3533
  #
@@ -3570,6 +3572,7 @@ module Aws::S3
3570
3572
  # @example Response structure
3571
3573
  #
3572
3574
  # resp.cors_rules #=> Array
3575
+ # resp.cors_rules[0].id #=> String
3573
3576
  # resp.cors_rules[0].allowed_headers #=> Array
3574
3577
  # resp.cors_rules[0].allowed_headers[0] #=> String
3575
3578
  # resp.cors_rules[0].allowed_methods #=> Array
@@ -3613,8 +3616,8 @@ module Aws::S3
3613
3616
  #
3614
3617
  #
3615
3618
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
3616
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3617
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3619
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3620
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3618
3621
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
3619
3622
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
3620
3623
  #
@@ -3623,7 +3626,7 @@ module Aws::S3
3623
3626
  # configuration is retrieved.
3624
3627
  #
3625
3628
  # @option params [String] :expected_bucket_owner
3626
- # The account id of the expected bucket owner. If the bucket is owned by
3629
+ # The account ID of the expected bucket owner. If the bucket is owned by
3627
3630
  # a different account, the request will fail with an HTTP `403 (Access
3628
3631
  # Denied)` error.
3629
3632
  #
@@ -3757,8 +3760,8 @@ module Aws::S3
3757
3760
  #
3758
3761
  #
3759
3762
  #
3760
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3761
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3763
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3764
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3762
3765
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
3763
3766
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
3764
3767
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -3772,7 +3775,7 @@ module Aws::S3
3772
3775
  # The ID used to identify the inventory configuration.
3773
3776
  #
3774
3777
  # @option params [String] :expected_bucket_owner
3775
- # The account id of the expected bucket owner. If the bucket is owned by
3778
+ # The account ID of the expected bucket owner. If the bucket is owned by
3776
3779
  # a different account, the request will fail with an HTTP `403 (Access
3777
3780
  # Denied)` error.
3778
3781
  #
@@ -3851,8 +3854,8 @@ module Aws::S3
3851
3854
  #
3852
3855
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
3853
3856
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3854
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3855
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3857
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3858
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3856
3859
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3857
3860
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3858
3861
  #
@@ -3860,7 +3863,7 @@ module Aws::S3
3860
3863
  # The name of the bucket for which to get the lifecycle information.
3861
3864
  #
3862
3865
  # @option params [String] :expected_bucket_owner
3863
- # The account id of the expected bucket owner. If the bucket is owned by
3866
+ # The account ID of the expected bucket owner. If the bucket is owned by
3864
3867
  # a different account, the request will fail with an HTTP `403 (Access
3865
3868
  # Denied)` error.
3866
3869
  #
@@ -3969,8 +3972,8 @@ module Aws::S3
3969
3972
  #
3970
3973
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
3971
3974
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3972
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3973
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3975
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3976
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3974
3977
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3975
3978
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3976
3979
  #
@@ -3978,7 +3981,7 @@ module Aws::S3
3978
3981
  # The name of the bucket for which to get the lifecycle information.
3979
3982
  #
3980
3983
  # @option params [String] :expected_bucket_owner
3981
- # The account id of the expected bucket owner. If the bucket is owned by
3984
+ # The account ID of the expected bucket owner. If the bucket is owned by
3982
3985
  # a different account, the request will fail with an HTTP `403 (Access
3983
3986
  # Denied)` error.
3984
3987
  #
@@ -4076,7 +4079,7 @@ module Aws::S3
4076
4079
  # The name of the bucket for which to get the location.
4077
4080
  #
4078
4081
  # @option params [String] :expected_bucket_owner
4079
- # The account id of the expected bucket owner. If the bucket is owned by
4082
+ # The account ID of the expected bucket owner. If the bucket is owned by
4080
4083
  # a different account, the request will fail with an HTTP `403 (Access
4081
4084
  # Denied)` error.
4082
4085
  #
@@ -4137,7 +4140,7 @@ module Aws::S3
4137
4140
  # The bucket name for which to get the logging information.
4138
4141
  #
4139
4142
  # @option params [String] :expected_bucket_owner
4140
- # The account id of the expected bucket owner. If the bucket is owned by
4143
+ # The account ID of the expected bucket owner. If the bucket is owned by
4141
4144
  # a different account, the request will fail with an HTTP `403 (Access
4142
4145
  # Denied)` error.
4143
4146
  #
@@ -4200,8 +4203,8 @@ module Aws::S3
4200
4203
  #
4201
4204
  #
4202
4205
  #
4203
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4204
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
4206
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4207
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4205
4208
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
4206
4209
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
4207
4210
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
@@ -4215,7 +4218,7 @@ module Aws::S3
4215
4218
  # The ID used to identify the metrics configuration.
4216
4219
  #
4217
4220
  # @option params [String] :expected_bucket_owner
4218
- # The account id of the expected bucket owner. If the bucket is owned by
4221
+ # The account ID of the expected bucket owner. If the bucket is owned by
4219
4222
  # a different account, the request will fail with an HTTP `403 (Access
4220
4223
  # Denied)` error.
4221
4224
  #
@@ -4262,7 +4265,7 @@ module Aws::S3
4262
4265
  # configuration.
4263
4266
  #
4264
4267
  # @option params [String] :expected_bucket_owner
4265
- # The account id of the expected bucket owner. If the bucket is owned by
4268
+ # The account ID of the expected bucket owner. If the bucket is owned by
4266
4269
  # a different account, the request will fail with an HTTP `403 (Access
4267
4270
  # Denied)` error.
4268
4271
  #
@@ -4396,7 +4399,7 @@ module Aws::S3
4396
4399
  # configuration.
4397
4400
  #
4398
4401
  # @option params [String] :expected_bucket_owner
4399
- # The account id of the expected bucket owner. If the bucket is owned by
4402
+ # The account ID of the expected bucket owner. If the bucket is owned by
4400
4403
  # a different account, the request will fail with an HTTP `403 (Access
4401
4404
  # Denied)` error.
4402
4405
  #
@@ -4473,7 +4476,7 @@ module Aws::S3
4473
4476
  # retrieve.
4474
4477
  #
4475
4478
  # @option params [String] :expected_bucket_owner
4476
- # The account id of the expected bucket owner. If the bucket is owned by
4479
+ # The account ID of the expected bucket owner. If the bucket is owned by
4477
4480
  # a different account, the request will fail with an HTTP `403 (Access
4478
4481
  # Denied)` error.
4479
4482
  #
@@ -4535,7 +4538,7 @@ module Aws::S3
4535
4538
  # The bucket name for which to get the bucket policy.
4536
4539
  #
4537
4540
  # @option params [String] :expected_bucket_owner
4538
- # The account id of the expected bucket owner. If the bucket is owned by
4541
+ # The account ID of the expected bucket owner. If the bucket is owned by
4539
4542
  # a different account, the request will fail with an HTTP `403 (Access
4540
4543
  # Denied)` error.
4541
4544
  #
@@ -4610,7 +4613,7 @@ module Aws::S3
4610
4613
  # retrieve.
4611
4614
  #
4612
4615
  # @option params [String] :expected_bucket_owner
4613
- # The account id of the expected bucket owner. If the bucket is owned by
4616
+ # The account ID of the expected bucket owner. If the bucket is owned by
4614
4617
  # a different account, the request will fail with an HTTP `403 (Access
4615
4618
  # Denied)` error.
4616
4619
  #
@@ -4647,7 +4650,7 @@ module Aws::S3
4647
4650
  # </note>
4648
4651
  #
4649
4652
  # For information about replication configuration, see [Replication][1]
4650
- # in the *Amazon Simple Storage Service User Guide*.
4653
+ # in the *Amazon S3 User Guide*.
4651
4654
  #
4652
4655
  # This action requires permissions for the
4653
4656
  # `s3:GetReplicationConfiguration` action. For more information about
@@ -4678,7 +4681,7 @@ module Aws::S3
4678
4681
  # The bucket name for which to get the replication information.
4679
4682
  #
4680
4683
  # @option params [String] :expected_bucket_owner
4681
- # The account id of the expected bucket owner. If the bucket is owned by
4684
+ # The account ID of the expected bucket owner. If the bucket is owned by
4682
4685
  # a different account, the request will fail with an HTTP `403 (Access
4683
4686
  # Denied)` error.
4684
4687
  #
@@ -4777,7 +4780,7 @@ module Aws::S3
4777
4780
  # configuration
4778
4781
  #
4779
4782
  # @option params [String] :expected_bucket_owner
4780
- # The account id of the expected bucket owner. If the bucket is owned by
4783
+ # The account ID of the expected bucket owner. If the bucket is owned by
4781
4784
  # a different account, the request will fail with an HTTP `403 (Access
4782
4785
  # Denied)` error.
4783
4786
  #
@@ -4848,7 +4851,7 @@ module Aws::S3
4848
4851
  # The name of the bucket for which to get the tagging information.
4849
4852
  #
4850
4853
  # @option params [String] :expected_bucket_owner
4851
- # The account id of the expected bucket owner. If the bucket is owned by
4854
+ # The account ID of the expected bucket owner. If the bucket is owned by
4852
4855
  # a different account, the request will fail with an HTTP `403 (Access
4853
4856
  # Denied)` error.
4854
4857
  #
@@ -4929,7 +4932,7 @@ module Aws::S3
4929
4932
  # The name of the bucket for which to get the versioning information.
4930
4933
  #
4931
4934
  # @option params [String] :expected_bucket_owner
4932
- # The account id of the expected bucket owner. If the bucket is owned by
4935
+ # The account ID of the expected bucket owner. If the bucket is owned by
4933
4936
  # a different account, the request will fail with an HTTP `403 (Access
4934
4937
  # Denied)` error.
4935
4938
  #
@@ -5001,7 +5004,7 @@ module Aws::S3
5001
5004
  # The bucket name for which to get the website configuration.
5002
5005
  #
5003
5006
  # @option params [String] :expected_bucket_owner
5004
- # The account id of the expected bucket owner. If the bucket is owned by
5007
+ # The account ID of the expected bucket owner. If the bucket is owned by
5005
5008
  # a different account, the request will fail with an HTTP `403 (Access
5006
5009
  # Denied)` error.
5007
5010
  #
@@ -5229,7 +5232,7 @@ module Aws::S3
5229
5232
  # When using this action with an access point through the AWS SDKs, you
5230
5233
  # provide the access point ARN in place of the bucket name. For more
5231
5234
  # information about access point ARNs, see [Using Access Points][1] in
5232
- # the *Amazon Simple Storage Service Developer Guide*.
5235
+ # the *Amazon S3 User Guide*.
5233
5236
  #
5234
5237
  # When using this action with Amazon S3 on Outposts, you must direct
5235
5238
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5238,12 +5241,12 @@ module Aws::S3
5238
5241
  # When using this action using S3 on Outposts through the AWS SDKs, you
5239
5242
  # provide the Outposts bucket ARN in place of the bucket name. For more
5240
5243
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5241
- # in the *Amazon Simple Storage Service Developer Guide*.
5244
+ # in the *Amazon S3 User Guide*.
5242
5245
  #
5243
5246
  #
5244
5247
  #
5245
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5246
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5248
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5249
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5247
5250
  #
5248
5251
  # @option params [String] :if_match
5249
5252
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -5333,7 +5336,7 @@ module Aws::S3
5333
5336
  # object.
5334
5337
  #
5335
5338
  # @option params [String] :expected_bucket_owner
5336
- # The account id of the expected bucket owner. If the bucket is owned by
5339
+ # The account ID of the expected bucket owner. If the bucket is owned by
5337
5340
  # a different account, the request will fail with an HTTP `403 (Access
5338
5341
  # Denied)` error.
5339
5342
  #
@@ -5555,11 +5558,11 @@ module Aws::S3
5555
5558
  # When using this action with an access point through the AWS SDKs, you
5556
5559
  # provide the access point ARN in place of the bucket name. For more
5557
5560
  # information about access point ARNs, see [Using Access Points][1] in
5558
- # the *Amazon Simple Storage Service Developer Guide*.
5561
+ # the *Amazon S3 User Guide*.
5559
5562
  #
5560
5563
  #
5561
5564
  #
5562
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5565
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5563
5566
  #
5564
5567
  # @option params [required, String] :key
5565
5568
  # The key of the object for which to get the ACL information.
@@ -5579,7 +5582,7 @@ module Aws::S3
5579
5582
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5580
5583
  #
5581
5584
  # @option params [String] :expected_bucket_owner
5582
- # The account id of the expected bucket owner. If the bucket is owned by
5585
+ # The account ID of the expected bucket owner. If the bucket is owned by
5583
5586
  # a different account, the request will fail with an HTTP `403 (Access
5584
5587
  # Denied)` error.
5585
5588
  #
@@ -5692,11 +5695,11 @@ module Aws::S3
5692
5695
  # When using this action with an access point through the AWS SDKs, you
5693
5696
  # provide the access point ARN in place of the bucket name. For more
5694
5697
  # information about access point ARNs, see [Using Access Points][1] in
5695
- # the *Amazon Simple Storage Service Developer Guide*.
5698
+ # the *Amazon S3 User Guide*.
5696
5699
  #
5697
5700
  #
5698
5701
  #
5699
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5702
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5700
5703
  #
5701
5704
  # @option params [required, String] :key
5702
5705
  # The key name for the object whose Legal Hold status you want to
@@ -5718,7 +5721,7 @@ module Aws::S3
5718
5721
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5719
5722
  #
5720
5723
  # @option params [String] :expected_bucket_owner
5721
- # The account id of the expected bucket owner. If the bucket is owned by
5724
+ # The account ID of the expected bucket owner. If the bucket is owned by
5722
5725
  # a different account, the request will fail with an HTTP `403 (Access
5723
5726
  # Denied)` error.
5724
5727
  #
@@ -5767,14 +5770,14 @@ module Aws::S3
5767
5770
  # When using this action with an access point through the AWS SDKs, you
5768
5771
  # provide the access point ARN in place of the bucket name. For more
5769
5772
  # information about access point ARNs, see [Using Access Points][1] in
5770
- # the *Amazon Simple Storage Service Developer Guide*.
5773
+ # the *Amazon S3 User Guide*.
5771
5774
  #
5772
5775
  #
5773
5776
  #
5774
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5777
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5775
5778
  #
5776
5779
  # @option params [String] :expected_bucket_owner
5777
- # The account id of the expected bucket owner. If the bucket is owned by
5780
+ # The account ID of the expected bucket owner. If the bucket is owned by
5778
5781
  # a different account, the request will fail with an HTTP `403 (Access
5779
5782
  # Denied)` error.
5780
5783
  #
@@ -5824,11 +5827,11 @@ module Aws::S3
5824
5827
  # When using this action with an access point through the AWS SDKs, you
5825
5828
  # provide the access point ARN in place of the bucket name. For more
5826
5829
  # information about access point ARNs, see [Using Access Points][1] in
5827
- # the *Amazon Simple Storage Service Developer Guide*.
5830
+ # the *Amazon S3 User Guide*.
5828
5831
  #
5829
5832
  #
5830
5833
  #
5831
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5834
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5832
5835
  #
5833
5836
  # @option params [required, String] :key
5834
5837
  # The key name for the object whose retention settings you want to
@@ -5850,7 +5853,7 @@ module Aws::S3
5850
5853
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5851
5854
  #
5852
5855
  # @option params [String] :expected_bucket_owner
5853
- # The account id of the expected bucket owner. If the bucket is owned by
5856
+ # The account ID of the expected bucket owner. If the bucket is owned by
5854
5857
  # a different account, the request will fail with an HTTP `403 (Access
5855
5858
  # Denied)` error.
5856
5859
  #
@@ -5920,7 +5923,7 @@ module Aws::S3
5920
5923
  # When using this action with an access point through the AWS SDKs, you
5921
5924
  # provide the access point ARN in place of the bucket name. For more
5922
5925
  # information about access point ARNs, see [Using Access Points][1] in
5923
- # the *Amazon Simple Storage Service Developer Guide*.
5926
+ # the *Amazon S3 User Guide*.
5924
5927
  #
5925
5928
  # When using this action with Amazon S3 on Outposts, you must direct
5926
5929
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5929,12 +5932,12 @@ module Aws::S3
5929
5932
  # When using this action using S3 on Outposts through the AWS SDKs, you
5930
5933
  # provide the Outposts bucket ARN in place of the bucket name. For more
5931
5934
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5932
- # in the *Amazon Simple Storage Service Developer Guide*.
5935
+ # in the *Amazon S3 User Guide*.
5933
5936
  #
5934
5937
  #
5935
5938
  #
5936
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5937
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5939
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5940
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5938
5941
  #
5939
5942
  # @option params [required, String] :key
5940
5943
  # Object key for which to get the tagging information.
@@ -5943,7 +5946,7 @@ module Aws::S3
5943
5946
  # The versionId of the object for which to get the tagging information.
5944
5947
  #
5945
5948
  # @option params [String] :expected_bucket_owner
5946
- # The account id of the expected bucket owner. If the bucket is owned by
5949
+ # The account ID of the expected bucket owner. If the bucket is owned by
5947
5950
  # a different account, the request will fail with an HTTP `403 (Access
5948
5951
  # Denied)` error.
5949
5952
  #
@@ -5964,49 +5967,49 @@ module Aws::S3
5964
5967
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
5965
5968
  #
5966
5969
  #
5967
- # @example Example: To retrieve tag set of an object
5970
+ # @example Example: To retrieve tag set of a specific object version
5968
5971
  #
5969
- # # The following example retrieves tag set of an object.
5972
+ # # The following example retrieves tag set of an object. The request specifies object version.
5970
5973
  #
5971
5974
  # resp = client.get_object_tagging({
5972
5975
  # bucket: "examplebucket",
5973
- # key: "HappyFace.jpg",
5976
+ # key: "exampleobject",
5977
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5974
5978
  # })
5975
5979
  #
5976
5980
  # resp.to_h outputs the following:
5977
5981
  # {
5978
5982
  # tag_set: [
5979
5983
  # {
5980
- # key: "Key4",
5981
- # value: "Value4",
5982
- # },
5983
- # {
5984
- # key: "Key3",
5985
- # value: "Value3",
5984
+ # key: "Key1",
5985
+ # value: "Value1",
5986
5986
  # },
5987
5987
  # ],
5988
- # version_id: "null",
5988
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5989
5989
  # }
5990
5990
  #
5991
- # @example Example: To retrieve tag set of a specific object version
5991
+ # @example Example: To retrieve tag set of an object
5992
5992
  #
5993
- # # The following example retrieves tag set of an object. The request specifies object version.
5993
+ # # The following example retrieves tag set of an object.
5994
5994
  #
5995
5995
  # resp = client.get_object_tagging({
5996
5996
  # bucket: "examplebucket",
5997
- # key: "exampleobject",
5998
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5997
+ # key: "HappyFace.jpg",
5999
5998
  # })
6000
5999
  #
6001
6000
  # resp.to_h outputs the following:
6002
6001
  # {
6003
6002
  # tag_set: [
6004
6003
  # {
6005
- # key: "Key1",
6006
- # value: "Value1",
6004
+ # key: "Key4",
6005
+ # value: "Value4",
6006
+ # },
6007
+ # {
6008
+ # key: "Key3",
6009
+ # value: "Value3",
6007
6010
  # },
6008
6011
  # ],
6009
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6012
+ # version_id: "null",
6010
6013
  # }
6011
6014
  #
6012
6015
  # @example Request syntax with placeholder values
@@ -6082,7 +6085,7 @@ module Aws::S3
6082
6085
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
6083
6086
  #
6084
6087
  # @option params [String] :expected_bucket_owner
6085
- # The account id of the expected bucket owner. If the bucket is owned by
6088
+ # The account ID of the expected bucket owner. If the bucket is owned by
6086
6089
  # a different account, the request will fail with an HTTP `403 (Access
6087
6090
  # Denied)` error.
6088
6091
  #
@@ -6168,7 +6171,7 @@ module Aws::S3
6168
6171
  # configuration you want to retrieve.
6169
6172
  #
6170
6173
  # @option params [String] :expected_bucket_owner
6171
- # The account id of the expected bucket owner. If the bucket is owned by
6174
+ # The account ID of the expected bucket owner. If the bucket is owned by
6172
6175
  # a different account, the request will fail with an HTTP `403 (Access
6173
6176
  # Denied)` error.
6174
6177
  #
@@ -6217,8 +6220,8 @@ module Aws::S3
6217
6220
  #
6218
6221
  #
6219
6222
  #
6220
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6221
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6223
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6224
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6222
6225
  #
6223
6226
  # @option params [required, String] :bucket
6224
6227
  # The bucket name.
@@ -6229,7 +6232,7 @@ module Aws::S3
6229
6232
  # When using this action with an access point through the AWS SDKs, you
6230
6233
  # provide the access point ARN in place of the bucket name. For more
6231
6234
  # information about access point ARNs, see [Using Access Points][1] in
6232
- # the *Amazon Simple Storage Service Developer Guide*.
6235
+ # the *Amazon S3 User Guide*.
6233
6236
  #
6234
6237
  # When using this action with Amazon S3 on Outposts, you must direct
6235
6238
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6238,15 +6241,15 @@ module Aws::S3
6238
6241
  # When using this action using S3 on Outposts through the AWS SDKs, you
6239
6242
  # provide the Outposts bucket ARN in place of the bucket name. For more
6240
6243
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6241
- # in the *Amazon Simple Storage Service Developer Guide*.
6244
+ # in the *Amazon S3 User Guide*.
6242
6245
  #
6243
6246
  #
6244
6247
  #
6245
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6246
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6248
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6249
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6247
6250
  #
6248
6251
  # @option params [String] :expected_bucket_owner
6249
- # The account id of the expected bucket owner. If the bucket is owned by
6252
+ # The account ID of the expected bucket owner. If the bucket is owned by
6250
6253
  # a different account, the request will fail with an HTTP `403 (Access
6251
6254
  # Denied)` error.
6252
6255
  #
@@ -6382,7 +6385,7 @@ module Aws::S3
6382
6385
  # When using this action with an access point through the AWS SDKs, you
6383
6386
  # provide the access point ARN in place of the bucket name. For more
6384
6387
  # information about access point ARNs, see [Using Access Points][1] in
6385
- # the *Amazon Simple Storage Service Developer Guide*.
6388
+ # the *Amazon S3 User Guide*.
6386
6389
  #
6387
6390
  # When using this action with Amazon S3 on Outposts, you must direct
6388
6391
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6391,12 +6394,12 @@ module Aws::S3
6391
6394
  # When using this action using S3 on Outposts through the AWS SDKs, you
6392
6395
  # provide the Outposts bucket ARN in place of the bucket name. For more
6393
6396
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6394
- # in the *Amazon Simple Storage Service Developer Guide*.
6397
+ # in the *Amazon S3 User Guide*.
6395
6398
  #
6396
6399
  #
6397
6400
  #
6398
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6399
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6401
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6402
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6400
6403
  #
6401
6404
  # @option params [String] :if_match
6402
6405
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -6468,7 +6471,7 @@ module Aws::S3
6468
6471
  # the number of parts in this object.
6469
6472
  #
6470
6473
  # @option params [String] :expected_bucket_owner
6471
- # The account id of the expected bucket owner. If the bucket is owned by
6474
+ # The account ID of the expected bucket owner. If the bucket is owned by
6472
6475
  # a different account, the request will fail with an HTTP `403 (Access
6473
6476
  # Denied)` error.
6474
6477
  #
@@ -6630,8 +6633,8 @@ module Aws::S3
6630
6633
  #
6631
6634
  #
6632
6635
  #
6633
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6634
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6636
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6637
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6635
6638
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
6636
6639
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
6637
6640
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
@@ -6646,7 +6649,7 @@ module Aws::S3
6646
6649
  # request should begin.
6647
6650
  #
6648
6651
  # @option params [String] :expected_bucket_owner
6649
- # The account id of the expected bucket owner. If the bucket is owned by
6652
+ # The account ID of the expected bucket owner. If the bucket is owned by
6650
6653
  # a different account, the request will fail with an HTTP `403 (Access
6651
6654
  # Denied)` error.
6652
6655
  #
@@ -6814,8 +6817,8 @@ module Aws::S3
6814
6817
  #
6815
6818
  #
6816
6819
  #
6817
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6818
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6820
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6821
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6819
6822
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
6820
6823
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
6821
6824
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
@@ -6832,7 +6835,7 @@ module Aws::S3
6832
6835
  # token is an opaque value that Amazon S3 understands.
6833
6836
  #
6834
6837
  # @option params [String] :expected_bucket_owner
6835
- # The account id of the expected bucket owner. If the bucket is owned by
6838
+ # The account ID of the expected bucket owner. If the bucket is owned by
6836
6839
  # a different account, the request will fail with an HTTP `403 (Access
6837
6840
  # Denied)` error.
6838
6841
  #
@@ -6914,8 +6917,8 @@ module Aws::S3
6914
6917
  #
6915
6918
  #
6916
6919
  #
6917
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6918
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6920
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6921
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6919
6922
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
6920
6923
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
6921
6924
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
@@ -6932,7 +6935,7 @@ module Aws::S3
6932
6935
  # continuation token is an opaque value that Amazon S3 understands.
6933
6936
  #
6934
6937
  # @option params [String] :expected_bucket_owner
6935
- # The account id of the expected bucket owner. If the bucket is owned by
6938
+ # The account ID of the expected bucket owner. If the bucket is owned by
6936
6939
  # a different account, the request will fail with an HTTP `403 (Access
6937
6940
  # Denied)` error.
6938
6941
  #
@@ -7089,7 +7092,7 @@ module Aws::S3
7089
7092
  # When using this action with an access point through the AWS SDKs, you
7090
7093
  # provide the access point ARN in place of the bucket name. For more
7091
7094
  # information about access point ARNs, see [Using Access Points][1] in
7092
- # the *Amazon Simple Storage Service Developer Guide*.
7095
+ # the *Amazon S3 User Guide*.
7093
7096
  #
7094
7097
  # When using this action with Amazon S3 on Outposts, you must direct
7095
7098
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7098,12 +7101,12 @@ module Aws::S3
7098
7101
  # When using this action using S3 on Outposts through the AWS SDKs, you
7099
7102
  # provide the Outposts bucket ARN in place of the bucket name. For more
7100
7103
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7101
- # in the *Amazon Simple Storage Service Developer Guide*.
7104
+ # in the *Amazon S3 User Guide*.
7102
7105
  #
7103
7106
  #
7104
7107
  #
7105
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7106
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7108
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7109
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7107
7110
  #
7108
7111
  # @option params [String] :delimiter
7109
7112
  # Character you use to group keys.
@@ -7156,7 +7159,7 @@ module Aws::S3
7156
7159
  # specified `upload-id-marker`.
7157
7160
  #
7158
7161
  # @option params [String] :expected_bucket_owner
7159
- # The account id of the expected bucket owner. If the bucket is owned by
7162
+ # The account ID of the expected bucket owner. If the bucket is owned by
7160
7163
  # a different account, the request will fail with an HTTP `403 (Access
7161
7164
  # Denied)` error.
7162
7165
  #
@@ -7323,6 +7326,9 @@ module Aws::S3
7323
7326
  # can also use request parameters as selection criteria to return
7324
7327
  # metadata about a subset of all the object versions.
7325
7328
  #
7329
+ # To use this operation, you must have permissions to perform the
7330
+ # `s3:ListBucketVersions` action. Be aware of the name difference.
7331
+ #
7326
7332
  # <note markdown="1"> A 200 OK response can contain valid or invalid XML. Make sure to
7327
7333
  # design your application to parse the contents of the response and
7328
7334
  # handle it appropriately.
@@ -7392,7 +7398,7 @@ module Aws::S3
7392
7398
  # Specifies the object version you want to start listing from.
7393
7399
  #
7394
7400
  # @option params [String] :expected_bucket_owner
7395
- # The account id of the expected bucket owner. If the bucket is owned by
7401
+ # The account ID of the expected bucket owner. If the bucket is owned by
7396
7402
  # a different account, the request will fail with an HTTP `403 (Access
7397
7403
  # Denied)` error.
7398
7404
  #
@@ -7551,7 +7557,7 @@ module Aws::S3
7551
7557
  # When using this action with an access point through the AWS SDKs, you
7552
7558
  # provide the access point ARN in place of the bucket name. For more
7553
7559
  # information about access point ARNs, see [Using Access Points][1] in
7554
- # the *Amazon Simple Storage Service Developer Guide*.
7560
+ # the *Amazon S3 User Guide*.
7555
7561
  #
7556
7562
  # When using this action with Amazon S3 on Outposts, you must direct
7557
7563
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7560,12 +7566,12 @@ module Aws::S3
7560
7566
  # When using this action using S3 on Outposts through the AWS SDKs, you
7561
7567
  # provide the Outposts bucket ARN in place of the bucket name. For more
7562
7568
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7563
- # in the *Amazon Simple Storage Service Developer Guide*.
7569
+ # in the *Amazon S3 User Guide*.
7564
7570
  #
7565
7571
  #
7566
7572
  #
7567
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7568
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7573
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7574
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7569
7575
  #
7570
7576
  # @option params [String] :delimiter
7571
7577
  # A delimiter is a character you use to group keys.
@@ -7595,7 +7601,7 @@ module Aws::S3
7595
7601
  # parameter in their requests.
7596
7602
  #
7597
7603
  # @option params [String] :expected_bucket_owner
7598
- # The account id of the expected bucket owner. If the bucket is owned by
7604
+ # The account ID of the expected bucket owner. If the bucket is owned by
7599
7605
  # a different account, the request will fail with an HTTP `403 (Access
7600
7606
  # Denied)` error.
7601
7607
  #
@@ -7730,8 +7736,8 @@ module Aws::S3
7730
7736
  #
7731
7737
  #
7732
7738
  #
7733
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7734
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
7739
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7740
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
7735
7741
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
7736
7742
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7737
7743
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
@@ -7747,7 +7753,7 @@ module Aws::S3
7747
7753
  # When using this action with an access point through the AWS SDKs, you
7748
7754
  # provide the access point ARN in place of the bucket name. For more
7749
7755
  # information about access point ARNs, see [Using Access Points][1] in
7750
- # the *Amazon Simple Storage Service Developer Guide*.
7756
+ # the *Amazon S3 User Guide*.
7751
7757
  #
7752
7758
  # When using this action with Amazon S3 on Outposts, you must direct
7753
7759
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7756,12 +7762,12 @@ module Aws::S3
7756
7762
  # When using this action using S3 on Outposts through the AWS SDKs, you
7757
7763
  # provide the Outposts bucket ARN in place of the bucket name. For more
7758
7764
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7759
- # in the *Amazon Simple Storage Service Developer Guide*.
7765
+ # in the *Amazon S3 User Guide*.
7760
7766
  #
7761
7767
  #
7762
7768
  #
7763
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7764
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7769
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7770
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7765
7771
  #
7766
7772
  # @option params [String] :delimiter
7767
7773
  # A delimiter is a character you use to group keys.
@@ -7798,7 +7804,7 @@ module Aws::S3
7798
7804
  # this parameter in their requests.
7799
7805
  #
7800
7806
  # @option params [String] :expected_bucket_owner
7801
- # The account id of the expected bucket owner. If the bucket is owned by
7807
+ # The account ID of the expected bucket owner. If the bucket is owned by
7802
7808
  # a different account, the request will fail with an HTTP `403 (Access
7803
7809
  # Denied)` error.
7804
7810
  #
@@ -7953,7 +7959,7 @@ module Aws::S3
7953
7959
  # When using this action with an access point through the AWS SDKs, you
7954
7960
  # provide the access point ARN in place of the bucket name. For more
7955
7961
  # information about access point ARNs, see [Using Access Points][1] in
7956
- # the *Amazon Simple Storage Service Developer Guide*.
7962
+ # the *Amazon S3 User Guide*.
7957
7963
  #
7958
7964
  # When using this action with Amazon S3 on Outposts, you must direct
7959
7965
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7962,12 +7968,12 @@ module Aws::S3
7962
7968
  # When using this action using S3 on Outposts through the AWS SDKs, you
7963
7969
  # provide the Outposts bucket ARN in place of the bucket name. For more
7964
7970
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7965
- # in the *Amazon Simple Storage Service Developer Guide*.
7971
+ # in the *Amazon S3 User Guide*.
7966
7972
  #
7967
7973
  #
7968
7974
  #
7969
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7970
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7975
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7976
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7971
7977
  #
7972
7978
  # @option params [required, String] :key
7973
7979
  # Object key for which the multipart upload was initiated.
@@ -7995,7 +8001,7 @@ module Aws::S3
7995
8001
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
7996
8002
  #
7997
8003
  # @option params [String] :expected_bucket_owner
7998
- # The account id of the expected bucket owner. If the bucket is owned by
8004
+ # The account ID of the expected bucket owner. If the bucket is owned by
7999
8005
  # a different account, the request will fail with an HTTP `403 (Access
8000
8006
  # Denied)` error.
8001
8007
  #
@@ -8140,8 +8146,8 @@ module Aws::S3
8140
8146
  #
8141
8147
  #
8142
8148
  #
8143
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8144
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8149
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8150
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8145
8151
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html
8146
8152
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
8147
8153
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
@@ -8153,7 +8159,7 @@ module Aws::S3
8153
8159
  # Container for setting the transfer acceleration state.
8154
8160
  #
8155
8161
  # @option params [String] :expected_bucket_owner
8156
- # The account id of the expected bucket owner. If the bucket is owned by
8162
+ # The account ID of the expected bucket owner. If the bucket is owned by
8157
8163
  # a different account, the request will fail with an HTTP `403 (Access
8158
8164
  # Denied)` error.
8159
8165
  #
@@ -8375,7 +8381,7 @@ module Aws::S3
8375
8381
  # Allows grantee to write the ACL for the applicable bucket.
8376
8382
  #
8377
8383
  # @option params [String] :expected_bucket_owner
8378
- # The account id of the expected bucket owner. If the bucket is owned by
8384
+ # The account ID of the expected bucket owner. If the bucket is owned by
8379
8385
  # a different account, the request will fail with an HTTP `403 (Access
8380
8386
  # Denied)` error.
8381
8387
  #
@@ -8497,8 +8503,8 @@ module Aws::S3
8497
8503
  #
8498
8504
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
8499
8505
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
8500
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8501
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8506
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8507
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8502
8508
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
8503
8509
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
8504
8510
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -8513,7 +8519,7 @@ module Aws::S3
8513
8519
  # The configuration and any analyses for the analytics filter.
8514
8520
  #
8515
8521
  # @option params [String] :expected_bucket_owner
8516
- # The account id of the expected bucket owner. If the bucket is owned by
8522
+ # The account ID of the expected bucket owner. If the bucket is owned by
8517
8523
  # a different account, the request will fail with an HTTP `403 (Access
8518
8524
  # Denied)` error.
8519
8525
  #
@@ -8604,7 +8610,7 @@ module Aws::S3
8604
8610
  # element.
8605
8611
  #
8606
8612
  # For more information about CORS, go to [Enabling Cross-Origin Resource
8607
- # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
8613
+ # Sharing][1] in the *Amazon S3 User Guide*.
8608
8614
  #
8609
8615
  # **Related Resources**
8610
8616
  #
@@ -8627,8 +8633,7 @@ module Aws::S3
8627
8633
  # @option params [required, Types::CORSConfiguration] :cors_configuration
8628
8634
  # Describes the cross-origin access configuration for objects in an
8629
8635
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
8630
- # Resource Sharing][1] in the *Amazon Simple Storage Service User
8631
- # Guide*.
8636
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
8632
8637
  #
8633
8638
  #
8634
8639
  #
@@ -8647,7 +8652,7 @@ module Aws::S3
8647
8652
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
8648
8653
  #
8649
8654
  # @option params [String] :expected_bucket_owner
8650
- # The account id of the expected bucket owner. If the bucket is owned by
8655
+ # The account ID of the expected bucket owner. If the bucket is owned by
8651
8656
  # a different account, the request will fail with an HTTP `403 (Access
8652
8657
  # Denied)` error.
8653
8658
  #
@@ -8704,6 +8709,7 @@ module Aws::S3
8704
8709
  # cors_configuration: { # required
8705
8710
  # cors_rules: [ # required
8706
8711
  # {
8712
+ # id: "ID",
8707
8713
  # allowed_headers: ["AllowedHeader"],
8708
8714
  # allowed_methods: ["AllowedMethod"], # required
8709
8715
  # allowed_origins: ["AllowedOrigin"], # required
@@ -8733,9 +8739,8 @@ module Aws::S3
8733
8739
  # (SSE-KMS). If you specify default encryption using SSE-KMS, you can
8734
8740
  # also configure Amazon S3 Bucket Key. For information about default
8735
8741
  # encryption, see [Amazon S3 default bucket encryption][1] in the
8736
- # *Amazon Simple Storage Service User Guide*. For more information about
8737
- # S3 Bucket Keys, see [Amazon S3 Bucket Keys][2] in the *Amazon Simple
8738
- # Storage Service User Guide*.
8742
+ # *Amazon S3 User Guide*. For more information about S3 Bucket Keys, see
8743
+ # [Amazon S3 Bucket Keys][2] in the *Amazon S3 User Guide*.
8739
8744
  #
8740
8745
  # This action requires AWS Signature Version 4. For more information,
8741
8746
  # see [ Authenticating Requests (AWS Signature Version 4)][3].
@@ -8745,8 +8750,8 @@ module Aws::S3
8745
8750
  # permission by default. The bucket owner can grant this permission to
8746
8751
  # others. For more information about permissions, see [Permissions
8747
8752
  # Related to Bucket Subresource Operations][4] and [Managing Access
8748
- # Permissions to Your Amazon S3 Resources][5] in the Amazon Simple
8749
- # Storage Service User Guide.
8753
+ # Permissions to Your Amazon S3 Resources][5] in the Amazon S3 User
8754
+ # Guide.
8750
8755
  #
8751
8756
  # **Related Resources**
8752
8757
  #
@@ -8759,8 +8764,8 @@ module Aws::S3
8759
8764
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
8760
8765
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
8761
8766
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
8762
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8763
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8767
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8768
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8764
8769
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
8765
8770
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
8766
8771
  #
@@ -8769,7 +8774,7 @@ module Aws::S3
8769
8774
  # with Amazon S3-managed keys (SSE-S3) or customer master keys stored in
8770
8775
  # AWS KMS (SSE-KMS). For information about the Amazon S3 default
8771
8776
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
8772
- # the *Amazon Simple Storage Service Developer Guide*.
8777
+ # the *Amazon S3 User Guide*.
8773
8778
  #
8774
8779
  #
8775
8780
  #
@@ -8786,7 +8791,7 @@ module Aws::S3
8786
8791
  # Specifies the default server-side-encryption configuration.
8787
8792
  #
8788
8793
  # @option params [String] :expected_bucket_owner
8789
- # The account id of the expected bucket owner. If the bucket is owned by
8794
+ # The account ID of the expected bucket owner. If the bucket is owned by
8790
8795
  # a different account, the request will fail with an HTTP `403 (Access
8791
8796
  # Denied)` error.
8792
8797
  #
@@ -8957,8 +8962,7 @@ module Aws::S3
8957
8962
  # whether to generate the inventory daily or weekly. You can also
8958
8963
  # configure what object metadata to include and whether to inventory all
8959
8964
  # object versions or only current versions. For more information, see
8960
- # [Amazon S3 Inventory][1] in the Amazon Simple Storage Service User
8961
- # Guide.
8965
+ # [Amazon S3 Inventory][1] in the Amazon S3 User Guide.
8962
8966
  #
8963
8967
  # You must create a bucket policy on the *destination* bucket to grant
8964
8968
  # permissions to Amazon S3 to write objects to the bucket in the defined
@@ -8970,8 +8974,7 @@ module Aws::S3
8970
8974
  # permission by default and can grant this permission to others. For
8971
8975
  # more information about permissions, see [Permissions Related to Bucket
8972
8976
  # Subresource Operations][3] and [Managing Access Permissions to Your
8973
- # Amazon S3 Resources][4] in the Amazon Simple Storage Service User
8974
- # Guide.
8977
+ # Amazon S3 Resources][4] in the Amazon S3 User Guide.
8975
8978
  #
8976
8979
  # **Special Errors**
8977
8980
  #
@@ -9008,8 +9011,8 @@ module Aws::S3
9008
9011
  #
9009
9012
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
9010
9013
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
9011
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9012
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9014
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9015
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9013
9016
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
9014
9017
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
9015
9018
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -9025,7 +9028,7 @@ module Aws::S3
9025
9028
  # Specifies the inventory configuration.
9026
9029
  #
9027
9030
  # @option params [String] :expected_bucket_owner
9028
- # The account id of the expected bucket owner. If the bucket is owned by
9031
+ # The account ID of the expected bucket owner. If the bucket is owned by
9029
9032
  # a different account, the request will fail with an HTTP `403 (Access
9030
9033
  # Denied)` error.
9031
9034
  #
@@ -9082,8 +9085,8 @@ module Aws::S3
9082
9085
  #
9083
9086
  # Creates a new lifecycle configuration for the bucket or replaces an
9084
9087
  # existing lifecycle configuration. For information about lifecycle
9085
- # configuration, see [Object Lifecycle Management][2] in the *Amazon
9086
- # Simple Storage Service User Guide*.
9088
+ # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
9089
+ # User Guide*.
9087
9090
  #
9088
9091
  # By default, all Amazon S3 resources, including buckets, objects, and
9089
9092
  # related subresources (for example, lifecycle configuration and website
@@ -9105,8 +9108,8 @@ module Aws::S3
9105
9108
  # * `s3:PutLifecycleConfiguration`
9106
9109
  #
9107
9110
  # For more information about permissions, see [Managing Access
9108
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
9109
- # Storage Service User Guide*.
9111
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
9112
+ # Guide*.
9110
9113
  #
9111
9114
  # For more examples of transitioning objects to storage classes such as
9112
9115
  # STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
@@ -9124,7 +9127,7 @@ module Aws::S3
9124
9127
  # the AWS account that created the bucket—can perform any of the
9125
9128
  # operations. A resource owner can also grant others permission to
9126
9129
  # perform the operation. For more information, see the following
9127
- # topics in the Amazon Simple Storage Service User Guide:
9130
+ # topics in the Amazon S3 User Guide:
9128
9131
  #
9129
9132
  # * [Specifying Permissions in a Policy][8]
9130
9133
  #
@@ -9134,7 +9137,7 @@ module Aws::S3
9134
9137
  #
9135
9138
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
9136
9139
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9137
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9140
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9138
9141
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
9139
9142
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
9140
9143
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
@@ -9150,7 +9153,7 @@ module Aws::S3
9150
9153
  # @option params [Types::LifecycleConfiguration] :lifecycle_configuration
9151
9154
  #
9152
9155
  # @option params [String] :expected_bucket_owner
9153
- # The account id of the expected bucket owner. If the bucket is owned by
9156
+ # The account ID of the expected bucket owner. If the bucket is owned by
9154
9157
  # a different account, the request will fail with an HTTP `403 (Access
9155
9158
  # Denied)` error.
9156
9159
  #
@@ -9274,7 +9277,7 @@ module Aws::S3
9274
9277
  #
9275
9278
  #
9276
9279
  #
9277
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9280
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9278
9281
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
9279
9282
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9280
9283
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
@@ -9289,7 +9292,7 @@ module Aws::S3
9289
9292
  # Container for lifecycle rules. You can add as many as 1,000 rules.
9290
9293
  #
9291
9294
  # @option params [String] :expected_bucket_owner
9292
- # The account id of the expected bucket owner. If the bucket is owned by
9295
+ # The account ID of the expected bucket owner. If the bucket is owned by
9293
9296
  # a different account, the request will fail with an HTTP `403 (Access
9294
9297
  # Denied)` error.
9295
9298
  #
@@ -9470,7 +9473,7 @@ module Aws::S3
9470
9473
  # SDKs, this field is calculated automatically.
9471
9474
  #
9472
9475
  # @option params [String] :expected_bucket_owner
9473
- # The account id of the expected bucket owner. If the bucket is owned by
9476
+ # The account ID of the expected bucket owner. If the bucket is owned by
9474
9477
  # a different account, the request will fail with an HTTP `403 (Access
9475
9478
  # Denied)` error.
9476
9479
  #
@@ -9573,8 +9576,8 @@ module Aws::S3
9573
9576
  #
9574
9577
  #
9575
9578
  #
9576
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9577
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9579
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9580
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9578
9581
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
9579
9582
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
9580
9583
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -9590,7 +9593,7 @@ module Aws::S3
9590
9593
  # Specifies the metrics configuration.
9591
9594
  #
9592
9595
  # @option params [String] :expected_bucket_owner
9593
- # The account id of the expected bucket owner. If the bucket is owned by
9596
+ # The account ID of the expected bucket owner. If the bucket is owned by
9594
9597
  # a different account, the request will fail with an HTTP `403 (Access
9595
9598
  # Denied)` error.
9596
9599
  #
@@ -9652,7 +9655,7 @@ module Aws::S3
9652
9655
  # The container for the configuration.
9653
9656
  #
9654
9657
  # @option params [String] :expected_bucket_owner
9655
- # The account id of the expected bucket owner. If the bucket is owned by
9658
+ # The account ID of the expected bucket owner. If the bucket is owned by
9656
9659
  # a different account, the request will fail with an HTTP `403 (Access
9657
9660
  # Denied)` error.
9658
9661
  #
@@ -9772,7 +9775,7 @@ module Aws::S3
9772
9775
  # bucket.
9773
9776
  #
9774
9777
  # @option params [String] :expected_bucket_owner
9775
- # The account id of the expected bucket owner. If the bucket is owned by
9778
+ # The account ID of the expected bucket owner. If the bucket is owned by
9776
9779
  # a different account, the request will fail with an HTTP `403 (Access
9777
9780
  # Denied)` error.
9778
9781
  #
@@ -9896,7 +9899,7 @@ module Aws::S3
9896
9899
  # SDKs, this field is calculated automatically.
9897
9900
  #
9898
9901
  # @option params [String] :expected_bucket_owner
9899
- # The account id of the expected bucket owner. If the bucket is owned by
9902
+ # The account ID of the expected bucket owner. If the bucket is owned by
9900
9903
  # a different account, the request will fail with an HTTP `403 (Access
9901
9904
  # Denied)` error.
9902
9905
  #
@@ -9977,7 +9980,7 @@ module Aws::S3
9977
9980
  # The bucket policy as a JSON document.
9978
9981
  #
9979
9982
  # @option params [String] :expected_bucket_owner
9980
- # The account id of the expected bucket owner. If the bucket is owned by
9983
+ # The account ID of the expected bucket owner. If the bucket is owned by
9981
9984
  # a different account, the request will fail with an HTTP `403 (Access
9982
9985
  # Denied)` error.
9983
9986
  #
@@ -10082,7 +10085,7 @@ module Aws::S3
10082
10085
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
10083
10086
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html
10084
10087
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
10085
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10088
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10086
10089
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
10087
10090
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
10088
10091
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
@@ -10111,7 +10114,7 @@ module Aws::S3
10111
10114
  # A token to allow Object Lock to be enabled for an existing bucket.
10112
10115
  #
10113
10116
  # @option params [String] :expected_bucket_owner
10114
- # The account id of the expected bucket owner. If the bucket is owned by
10117
+ # The account ID of the expected bucket owner. If the bucket is owned by
10115
10118
  # a different account, the request will fail with an HTTP `403 (Access
10116
10119
  # Denied)` error.
10117
10120
  #
@@ -10258,7 +10261,7 @@ module Aws::S3
10258
10261
  # Container for Payer.
10259
10262
  #
10260
10263
  # @option params [String] :expected_bucket_owner
10261
- # The account id of the expected bucket owner. If the bucket is owned by
10264
+ # The account ID of the expected bucket owner. If the bucket is owned by
10262
10265
  # a different account, the request will fail with an HTTP `403 (Access
10263
10266
  # Denied)` error.
10264
10267
  #
@@ -10361,8 +10364,8 @@ module Aws::S3
10361
10364
  #
10362
10365
  # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
10363
10366
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html
10364
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10365
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10367
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10368
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10366
10369
  # [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
10367
10370
  # [6]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html
10368
10371
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
@@ -10387,7 +10390,7 @@ module Aws::S3
10387
10390
  # Container for the `TagSet` and `Tag` elements.
10388
10391
  #
10389
10392
  # @option params [String] :expected_bucket_owner
10390
- # The account id of the expected bucket owner. If the bucket is owned by
10393
+ # The account ID of the expected bucket owner. If the bucket is owned by
10391
10394
  # a different account, the request will fail with an HTTP `403 (Access
10392
10395
  # Denied)` error.
10393
10396
  #
@@ -10507,7 +10510,7 @@ module Aws::S3
10507
10510
  # Container for setting the versioning state.
10508
10511
  #
10509
10512
  # @option params [String] :expected_bucket_owner
10510
- # The account id of the expected bucket owner. If the bucket is owned by
10513
+ # The account ID of the expected bucket owner. If the bucket is owned by
10511
10514
  # a different account, the request will fail with an HTTP `403 (Access
10512
10515
  # Denied)` error.
10513
10516
  #
@@ -10614,7 +10617,7 @@ module Aws::S3
10614
10617
  # Amazon S3 has a limitation of 50 routing rules per website
10615
10618
  # configuration. If you require more than 50 routing rules, you can use
10616
10619
  # object redirect. For more information, see [Configuring an Object
10617
- # Redirect][2] in the *Amazon Simple Storage Service User Guide*.
10620
+ # Redirect][2] in the *Amazon S3 User Guide*.
10618
10621
  #
10619
10622
  #
10620
10623
  #
@@ -10640,7 +10643,7 @@ module Aws::S3
10640
10643
  # Container for the request.
10641
10644
  #
10642
10645
  # @option params [String] :expected_bucket_owner
10643
- # The account id of the expected bucket owner. If the bucket is owned by
10646
+ # The account ID of the expected bucket owner. If the bucket is owned by
10644
10647
  # a different account, the request will fail with an HTTP `403 (Access
10645
10648
  # Denied)` error.
10646
10649
  #
@@ -10730,8 +10733,7 @@ module Aws::S3
10730
10733
  # <note markdown="1"> The `Content-MD5` header is required for any request to upload an
10731
10734
  # object with a retention period configured using Amazon S3 Object Lock.
10732
10735
  # For more information about Amazon S3 Object Lock, see [Amazon S3
10733
- # Object Lock Overview][1] in the *Amazon Simple Storage Service
10734
- # Developer Guide*.
10736
+ # Object Lock Overview][1] in the *Amazon S3 User Guide*.
10735
10737
  #
10736
10738
  # </note>
10737
10739
  #
@@ -10746,8 +10748,8 @@ module Aws::S3
10746
10748
  #
10747
10749
  # If you request server-side encryption using AWS Key Management Service
10748
10750
  # (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
10749
- # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon Simple
10750
- # Storage Service User Guide*.
10751
+ # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon S3
10752
+ # User Guide*.
10751
10753
  #
10752
10754
  # **Access Control List (ACL)-Specific Request Headers**
10753
10755
  #
@@ -10821,7 +10823,7 @@ module Aws::S3
10821
10823
  # When using this action with an access point through the AWS SDKs, you
10822
10824
  # provide the access point ARN in place of the bucket name. For more
10823
10825
  # information about access point ARNs, see [Using Access Points][1] in
10824
- # the *Amazon Simple Storage Service Developer Guide*.
10826
+ # the *Amazon S3 User Guide*.
10825
10827
  #
10826
10828
  # When using this action with Amazon S3 on Outposts, you must direct
10827
10829
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -10830,12 +10832,12 @@ module Aws::S3
10830
10832
  # When using this action using S3 on Outposts through the AWS SDKs, you
10831
10833
  # provide the Outposts bucket ARN in place of the bucket name. For more
10832
10834
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
10833
- # in the *Amazon Simple Storage Service Developer Guide*.
10835
+ # in the *Amazon S3 User Guide*.
10834
10836
  #
10835
10837
  #
10836
10838
  #
10837
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
10838
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
10839
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
10840
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
10839
10841
  #
10840
10842
  # @option params [String] :cache_control
10841
10843
  # Can be used to specify caching behavior along the request/reply chain.
@@ -11050,7 +11052,7 @@ module Aws::S3
11050
11052
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
11051
11053
  #
11052
11054
  # @option params [String] :expected_bucket_owner
11053
- # The account id of the expected bucket owner. If the bucket is owned by
11055
+ # The account ID of the expected bucket owner. If the bucket is owned by
11054
11056
  # a different account, the request will fail with an HTTP `403 (Access
11055
11057
  # Denied)` error.
11056
11058
  #
@@ -11068,134 +11070,134 @@ module Aws::S3
11068
11070
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
11069
11071
  #
11070
11072
  #
11071
- # @example Example: To upload an object
11073
+ # @example Example: To upload an object and specify optional tags
11072
11074
  #
11073
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11074
- # # syntax. S3 returns VersionId of the newly created object.
11075
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
11076
+ # # S3 returns version ID of the newly created object.
11075
11077
  #
11076
11078
  # resp = client.put_object({
11077
- # body: "HappyFace.jpg",
11079
+ # body: "c:\\HappyFace.jpg",
11078
11080
  # bucket: "examplebucket",
11079
11081
  # key: "HappyFace.jpg",
11082
+ # tagging: "key1=value1&key2=value2",
11080
11083
  # })
11081
11084
  #
11082
11085
  # resp.to_h outputs the following:
11083
11086
  # {
11084
11087
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11085
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11088
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11086
11089
  # }
11087
11090
  #
11088
- # @example Example: To upload an object and specify server-side encryption and object tags
11091
+ # @example Example: To create an object.
11089
11092
  #
11090
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11091
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11093
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11092
11094
  #
11093
11095
  # resp = client.put_object({
11094
11096
  # body: "filetoupload",
11095
11097
  # bucket: "examplebucket",
11096
- # key: "exampleobject",
11097
- # server_side_encryption: "AES256",
11098
- # tagging: "key1=value1&key2=value2",
11098
+ # key: "objectkey",
11099
11099
  # })
11100
11100
  #
11101
11101
  # resp.to_h outputs the following:
11102
11102
  # {
11103
11103
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11104
- # server_side_encryption: "AES256",
11105
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11104
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11106
11105
  # }
11107
11106
  #
11108
- # @example Example: To upload an object (specify optional headers)
11107
+ # @example Example: To upload object and specify user-defined metadata
11109
11108
  #
11110
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11111
- # # storage class and use server-side encryption.
11109
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
11110
+ # # enabled, S3 returns version ID in response.
11112
11111
  #
11113
11112
  # resp = client.put_object({
11114
- # body: "HappyFace.jpg",
11113
+ # body: "filetoupload",
11115
11114
  # bucket: "examplebucket",
11116
- # key: "HappyFace.jpg",
11117
- # server_side_encryption: "AES256",
11118
- # storage_class: "STANDARD_IA",
11115
+ # key: "exampleobject",
11116
+ # metadata: {
11117
+ # "metadata1" => "value1",
11118
+ # "metadata2" => "value2",
11119
+ # },
11119
11120
  # })
11120
11121
  #
11121
11122
  # resp.to_h outputs the following:
11122
11123
  # {
11123
11124
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11124
- # server_side_encryption: "AES256",
11125
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11125
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11126
11126
  # }
11127
11127
  #
11128
- # @example Example: To create an object.
11128
+ # @example Example: To upload an object
11129
11129
  #
11130
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11130
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11131
+ # # syntax. S3 returns VersionId of the newly created object.
11131
11132
  #
11132
11133
  # resp = client.put_object({
11133
- # body: "filetoupload",
11134
+ # body: "HappyFace.jpg",
11134
11135
  # bucket: "examplebucket",
11135
- # key: "objectkey",
11136
+ # key: "HappyFace.jpg",
11136
11137
  # })
11137
11138
  #
11138
11139
  # resp.to_h outputs the following:
11139
11140
  # {
11140
11141
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11141
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11142
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11142
11143
  # }
11143
11144
  #
11144
- # @example Example: To upload an object and specify canned ACL.
11145
+ # @example Example: To upload an object and specify server-side encryption and object tags
11145
11146
  #
11146
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11147
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11147
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11148
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11148
11149
  #
11149
11150
  # resp = client.put_object({
11150
- # acl: "authenticated-read",
11151
11151
  # body: "filetoupload",
11152
11152
  # bucket: "examplebucket",
11153
11153
  # key: "exampleobject",
11154
+ # server_side_encryption: "AES256",
11155
+ # tagging: "key1=value1&key2=value2",
11154
11156
  # })
11155
11157
  #
11156
11158
  # resp.to_h outputs the following:
11157
11159
  # {
11158
11160
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11159
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11161
+ # server_side_encryption: "AES256",
11162
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11160
11163
  # }
11161
11164
  #
11162
- # @example Example: To upload an object and specify optional tags
11165
+ # @example Example: To upload an object and specify canned ACL.
11163
11166
  #
11164
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
11165
- # # S3 returns version ID of the newly created object.
11167
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11168
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11166
11169
  #
11167
11170
  # resp = client.put_object({
11168
- # body: "c:\\HappyFace.jpg",
11171
+ # acl: "authenticated-read",
11172
+ # body: "filetoupload",
11169
11173
  # bucket: "examplebucket",
11170
- # key: "HappyFace.jpg",
11171
- # tagging: "key1=value1&key2=value2",
11174
+ # key: "exampleobject",
11172
11175
  # })
11173
11176
  #
11174
11177
  # resp.to_h outputs the following:
11175
11178
  # {
11176
11179
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11177
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11180
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11178
11181
  # }
11179
11182
  #
11180
- # @example Example: To upload object and specify user-defined metadata
11183
+ # @example Example: To upload an object (specify optional headers)
11181
11184
  #
11182
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
11183
- # # enabled, S3 returns version ID in response.
11185
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11186
+ # # storage class and use server-side encryption.
11184
11187
  #
11185
11188
  # resp = client.put_object({
11186
- # body: "filetoupload",
11189
+ # body: "HappyFace.jpg",
11187
11190
  # bucket: "examplebucket",
11188
- # key: "exampleobject",
11189
- # metadata: {
11190
- # "metadata1" => "value1",
11191
- # "metadata2" => "value2",
11192
- # },
11191
+ # key: "HappyFace.jpg",
11192
+ # server_side_encryption: "AES256",
11193
+ # storage_class: "STANDARD_IA",
11193
11194
  # })
11194
11195
  #
11195
11196
  # resp.to_h outputs the following:
11196
11197
  # {
11197
11198
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11198
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11199
+ # server_side_encryption: "AES256",
11200
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11199
11201
  # }
11200
11202
  #
11201
11203
  # @example Streaming a file from disk
@@ -11268,8 +11270,8 @@ module Aws::S3
11268
11270
  # Uses the `acl` subresource to set the access control list (ACL)
11269
11271
  # permissions for a new or existing object in an S3 bucket. You must
11270
11272
  # have `WRITE_ACP` permission to set the ACL of an object. For more
11271
- # information, see [What permissions can I grant?][1] in the *Amazon
11272
- # Simple Storage Service User Guide*.
11273
+ # information, see [What permissions can I grant?][1] in the *Amazon S3
11274
+ # User Guide*.
11273
11275
  #
11274
11276
  # This action is not supported by Amazon S3 on Outposts.
11275
11277
  #
@@ -11439,11 +11441,11 @@ module Aws::S3
11439
11441
  # When using this action with an access point through the AWS SDKs, you
11440
11442
  # provide the access point ARN in place of the bucket name. For more
11441
11443
  # information about access point ARNs, see [Using Access Points][1] in
11442
- # the *Amazon Simple Storage Service Developer Guide*.
11444
+ # the *Amazon S3 User Guide*.
11443
11445
  #
11444
11446
  #
11445
11447
  #
11446
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11448
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11447
11449
  #
11448
11450
  # @option params [String] :content_md5
11449
11451
  # The base64-encoded 128-bit MD5 digest of the data. This header must be
@@ -11492,7 +11494,7 @@ module Aws::S3
11492
11494
  # When using this action with an access point through the AWS SDKs, you
11493
11495
  # provide the access point ARN in place of the bucket name. For more
11494
11496
  # information about access point ARNs, see [Using Access Points][1] in
11495
- # the *Amazon Simple Storage Service Developer Guide*.
11497
+ # the *Amazon S3 User Guide*.
11496
11498
  #
11497
11499
  # When using this action with Amazon S3 on Outposts, you must direct
11498
11500
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11501,12 +11503,12 @@ module Aws::S3
11501
11503
  # When using this action using S3 on Outposts through the AWS SDKs, you
11502
11504
  # provide the Outposts bucket ARN in place of the bucket name. For more
11503
11505
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11504
- # in the *Amazon Simple Storage Service Developer Guide*.
11506
+ # in the *Amazon S3 User Guide*.
11505
11507
  #
11506
11508
  #
11507
11509
  #
11508
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11509
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11510
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11511
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11510
11512
  #
11511
11513
  # @option params [String] :request_payer
11512
11514
  # Confirms that the requester knows that they will be charged for the
@@ -11523,7 +11525,7 @@ module Aws::S3
11523
11525
  # VersionId used to reference a specific version of the object.
11524
11526
  #
11525
11527
  # @option params [String] :expected_bucket_owner
11526
- # The account id of the expected bucket owner. If the bucket is owned by
11528
+ # The account ID of the expected bucket owner. If the bucket is owned by
11527
11529
  # a different account, the request will fail with an HTTP `403 (Access
11528
11530
  # Denied)` error.
11529
11531
  #
@@ -11598,16 +11600,11 @@ module Aws::S3
11598
11600
  req.send_request(options)
11599
11601
  end
11600
11602
 
11601
- # Applies a Legal Hold configuration to the specified object.
11603
+ # Applies a Legal Hold configuration to the specified object. For more
11604
+ # information, see [Locking Objects][1].
11602
11605
  #
11603
11606
  # This action is not supported by Amazon S3 on Outposts.
11604
11607
  #
11605
- # **Related Resources**
11606
- #
11607
- # * [Locking Objects][1]
11608
- #
11609
- # ^
11610
- #
11611
11608
  #
11612
11609
  #
11613
11610
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11622,11 +11619,11 @@ module Aws::S3
11622
11619
  # When using this action with an access point through the AWS SDKs, you
11623
11620
  # provide the access point ARN in place of the bucket name. For more
11624
11621
  # information about access point ARNs, see [Using Access Points][1] in
11625
- # the *Amazon Simple Storage Service Developer Guide*.
11622
+ # the *Amazon S3 User Guide*.
11626
11623
  #
11627
11624
  #
11628
11625
  #
11629
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11626
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11630
11627
  #
11631
11628
  # @option params [required, String] :key
11632
11629
  # The key name for the object that you want to place a Legal Hold on.
@@ -11656,7 +11653,7 @@ module Aws::S3
11656
11653
  # SDKs, this field is calculated automatically.
11657
11654
  #
11658
11655
  # @option params [String] :expected_bucket_owner
11659
- # The account id of the expected bucket owner. If the bucket is owned by
11656
+ # The account ID of the expected bucket owner. If the bucket is owned by
11660
11657
  # a different account, the request will fail with an HTTP `403 (Access
11661
11658
  # Denied)` error.
11662
11659
  #
@@ -11693,18 +11690,19 @@ module Aws::S3
11693
11690
 
11694
11691
  # Places an Object Lock configuration on the specified bucket. The rule
11695
11692
  # specified in the Object Lock configuration will be applied by default
11696
- # to every new object placed in the specified bucket.
11697
- #
11698
- # <note markdown="1"> `DefaultRetention` requires either Days or Years. You can't specify
11699
- # both at the same time.
11693
+ # to every new object placed in the specified bucket. For more
11694
+ # information, see [Locking Objects][1].
11700
11695
  #
11701
- # </note>
11696
+ # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
11702
11697
  #
11703
- # **Related Resources**
11698
+ # * The `DefaultRetention` period can be either `Days` or `Years` but
11699
+ # you must select one. You cannot specify `Days` and `Years` at the
11700
+ # same time.
11704
11701
  #
11705
- # * [Locking Objects][1]
11702
+ # * You can only enable Object Lock for new buckets. If you want to turn
11703
+ # on Object Lock for an existing bucket, contact AWS Support.
11706
11704
  #
11707
- # ^
11705
+ # </note>
11708
11706
  #
11709
11707
  #
11710
11708
  #
@@ -11739,7 +11737,7 @@ module Aws::S3
11739
11737
  # SDKs, this field is calculated automatically.
11740
11738
  #
11741
11739
  # @option params [String] :expected_bucket_owner
11742
- # The account id of the expected bucket owner. If the bucket is owned by
11740
+ # The account ID of the expected bucket owner. If the bucket is owned by
11743
11741
  # a different account, the request will fail with an HTTP `403 (Access
11744
11742
  # Denied)` error.
11745
11743
  #
@@ -11780,16 +11778,11 @@ module Aws::S3
11780
11778
  req.send_request(options)
11781
11779
  end
11782
11780
 
11783
- # Places an Object Retention configuration on an object.
11781
+ # Places an Object Retention configuration on an object. For more
11782
+ # information, see [Locking Objects][1].
11784
11783
  #
11785
11784
  # This action is not supported by Amazon S3 on Outposts.
11786
11785
  #
11787
- # **Related Resources**
11788
- #
11789
- # * [Locking Objects][1]
11790
- #
11791
- # ^
11792
- #
11793
11786
  #
11794
11787
  #
11795
11788
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11804,11 +11797,11 @@ module Aws::S3
11804
11797
  # When using this action with an access point through the AWS SDKs, you
11805
11798
  # provide the access point ARN in place of the bucket name. For more
11806
11799
  # information about access point ARNs, see [Using Access Points][1] in
11807
- # the *Amazon Simple Storage Service Developer Guide*.
11800
+ # the *Amazon S3 User Guide*.
11808
11801
  #
11809
11802
  #
11810
11803
  #
11811
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11804
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11812
11805
  #
11813
11806
  # @option params [required, String] :key
11814
11807
  # The key name for the object that you want to apply this Object
@@ -11843,7 +11836,7 @@ module Aws::S3
11843
11836
  # SDKs, this field is calculated automatically.
11844
11837
  #
11845
11838
  # @option params [String] :expected_bucket_owner
11846
- # The account id of the expected bucket owner. If the bucket is owned by
11839
+ # The account ID of the expected bucket owner. If the bucket is owned by
11847
11840
  # a different account, the request will fail with an HTTP `403 (Access
11848
11841
  # Denied)` error.
11849
11842
  #
@@ -11946,7 +11939,7 @@ module Aws::S3
11946
11939
  # When using this action with an access point through the AWS SDKs, you
11947
11940
  # provide the access point ARN in place of the bucket name. For more
11948
11941
  # information about access point ARNs, see [Using Access Points][1] in
11949
- # the *Amazon Simple Storage Service Developer Guide*.
11942
+ # the *Amazon S3 User Guide*.
11950
11943
  #
11951
11944
  # When using this action with Amazon S3 on Outposts, you must direct
11952
11945
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11955,12 +11948,12 @@ module Aws::S3
11955
11948
  # When using this action using S3 on Outposts through the AWS SDKs, you
11956
11949
  # provide the Outposts bucket ARN in place of the bucket name. For more
11957
11950
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11958
- # in the *Amazon Simple Storage Service Developer Guide*.
11951
+ # in the *Amazon S3 User Guide*.
11959
11952
  #
11960
11953
  #
11961
11954
  #
11962
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11963
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11955
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11956
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11964
11957
  #
11965
11958
  # @option params [required, String] :key
11966
11959
  # Name of the object key.
@@ -11978,7 +11971,7 @@ module Aws::S3
11978
11971
  # Container for the `TagSet` and `Tag` elements
11979
11972
  #
11980
11973
  # @option params [String] :expected_bucket_owner
11981
- # The account id of the expected bucket owner. If the bucket is owned by
11974
+ # The account ID of the expected bucket owner. If the bucket is owned by
11982
11975
  # a different account, the request will fail with an HTTP `403 (Access
11983
11976
  # Denied)` error.
11984
11977
  #
@@ -12106,14 +12099,14 @@ module Aws::S3
12106
12099
  # Amazon S3 bucket. You can enable the configuration options in any
12107
12100
  # combination. For more information about when Amazon S3 considers a
12108
12101
  # bucket or object public, see [The Meaning of "Public"][1] in the
12109
- # *Amazon Simple Storage Service Developer Guide*.
12102
+ # *Amazon S3 User Guide*.
12110
12103
  #
12111
12104
  #
12112
12105
  #
12113
12106
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
12114
12107
  #
12115
12108
  # @option params [String] :expected_bucket_owner
12116
- # The account id of the expected bucket owner. If the bucket is owned by
12109
+ # The account ID of the expected bucket owner. If the bucket is owned by
12117
12110
  # a different account, the request will fail with an HTTP `403 (Access
12118
12111
  # Denied)` error.
12119
12112
  #
@@ -12157,7 +12150,7 @@ module Aws::S3
12157
12150
  # default and can grant this permission to others. For more information
12158
12151
  # about permissions, see [Permissions Related to Bucket Subresource
12159
12152
  # Operations][1] and [Managing Access Permissions to Your Amazon S3
12160
- # Resources][2] in the *Amazon Simple Storage Service User Guide*.
12153
+ # Resources][2] in the *Amazon S3 User Guide*.
12161
12154
  #
12162
12155
  # **Querying Archives with Select Requests**
12163
12156
  #
@@ -12167,7 +12160,7 @@ module Aws::S3
12167
12160
  # files. You can run queries and custom analytics on your archived data
12168
12161
  # without having to restore your data to a hotter Amazon S3 tier. For an
12169
12162
  # overview about select requests, see [Querying Archived Objects][3] in
12170
- # the *Amazon Simple Storage Service User Guide*.
12163
+ # the *Amazon S3 User Guide*.
12171
12164
  #
12172
12165
  # When making a select request, do the following:
12173
12166
  #
@@ -12177,19 +12170,18 @@ module Aws::S3
12177
12170
  # that initiates the job must have permissions to write to the S3
12178
12171
  # bucket. You can specify the storage class and encryption for the
12179
12172
  # output objects stored in the bucket. For more information about
12180
- # output, see [Querying Archived Objects][3] in the *Amazon Simple
12181
- # Storage Service User Guide*.
12173
+ # output, see [Querying Archived Objects][3] in the *Amazon S3 User
12174
+ # Guide*.
12182
12175
  #
12183
12176
  # For more information about the `S3` structure in the request body,
12184
12177
  # see the following:
12185
12178
  #
12186
12179
  # * [PutObject][4]
12187
12180
  #
12188
- # * [Managing Access with ACLs][5] in the *Amazon Simple Storage
12189
- # Service User Guide*
12181
+ # * [Managing Access with ACLs][5] in the *Amazon S3 User Guide*
12190
12182
  #
12191
12183
  # * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
12192
- # Simple Storage Service User Guide*
12184
+ # S3 User Guide*
12193
12185
  #
12194
12186
  # * Define the SQL expression for the `SELECT` type of restoration for
12195
12187
  # your query in the request body's `SelectParameters` structure. You
@@ -12215,7 +12207,7 @@ module Aws::S3
12215
12207
  #
12216
12208
  # For more information about using SQL with S3 Glacier Select restore,
12217
12209
  # see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
12218
- # the *Amazon Simple Storage Service User Guide*.
12210
+ # the *Amazon S3 User Guide*.
12219
12211
  #
12220
12212
  # When making a select request, you can also do the following:
12221
12213
  #
@@ -12294,20 +12286,19 @@ module Aws::S3
12294
12286
  #
12295
12287
  # For more information about archive retrieval options and provisioned
12296
12288
  # capacity for `Expedited` data access, see [Restoring Archived
12297
- # Objects][8] in the *Amazon Simple Storage Service User Guide*.
12289
+ # Objects][8] in the *Amazon S3 User Guide*.
12298
12290
  #
12299
12291
  # You can use Amazon S3 restore speed upgrade to change the restore
12300
12292
  # speed to a faster speed while it is in progress. For more information,
12301
12293
  # see [ Upgrading the speed of an in-progress restore][9] in the *Amazon
12302
- # Simple Storage Service User Guide*.
12294
+ # S3 User Guide*.
12303
12295
  #
12304
12296
  # To get the status of object restoration, you can send a `HEAD`
12305
12297
  # request. Operations return the `x-amz-restore` header, which provides
12306
12298
  # information about the restoration status, in the response. You can use
12307
12299
  # Amazon S3 event notifications to notify you when a restore is
12308
12300
  # initiated or completed. For more information, see [Configuring Amazon
12309
- # S3 Event Notifications][10] in the *Amazon Simple Storage Service User
12310
- # Guide*.
12301
+ # S3 Event Notifications][10] in the *Amazon S3 User Guide*.
12311
12302
  #
12312
12303
  # After restoring an archived object, you can update the restoration
12313
12304
  # period by reissuing the request with a new period. Amazon S3 updates
@@ -12323,7 +12314,7 @@ module Aws::S3
12323
12314
  # days, Amazon S3 deletes the object in 3 days. For more information
12324
12315
  # about lifecycle configuration, see
12325
12316
  # [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
12326
- # Management][12] in *Amazon Simple Storage Service User Guide*.
12317
+ # Management][12] in *Amazon S3 User Guide*.
12327
12318
  #
12328
12319
  # **Responses**
12329
12320
  #
@@ -12365,12 +12356,12 @@ module Aws::S3
12365
12356
  # * [GetBucketNotificationConfiguration][13]
12366
12357
  #
12367
12358
  # * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
12368
- # the *Amazon Simple Storage Service User Guide*
12359
+ # the *Amazon S3 User Guide*
12369
12360
  #
12370
12361
  #
12371
12362
  #
12372
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12373
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
12363
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12364
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
12374
12365
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
12375
12366
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
12376
12367
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
@@ -12392,7 +12383,7 @@ module Aws::S3
12392
12383
  # When using this action with an access point through the AWS SDKs, you
12393
12384
  # provide the access point ARN in place of the bucket name. For more
12394
12385
  # information about access point ARNs, see [Using Access Points][1] in
12395
- # the *Amazon Simple Storage Service Developer Guide*.
12386
+ # the *Amazon S3 User Guide*.
12396
12387
  #
12397
12388
  # When using this action with Amazon S3 on Outposts, you must direct
12398
12389
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -12401,12 +12392,12 @@ module Aws::S3
12401
12392
  # When using this action using S3 on Outposts through the AWS SDKs, you
12402
12393
  # provide the Outposts bucket ARN in place of the bucket name. For more
12403
12394
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
12404
- # in the *Amazon Simple Storage Service Developer Guide*.
12395
+ # in the *Amazon S3 User Guide*.
12405
12396
  #
12406
12397
  #
12407
12398
  #
12408
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
12409
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
12399
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
12400
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
12410
12401
  #
12411
12402
  # @option params [required, String] :key
12412
12403
  # Object key for which the action was initiated.
@@ -12429,7 +12420,7 @@ module Aws::S3
12429
12420
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
12430
12421
  #
12431
12422
  # @option params [String] :expected_bucket_owner
12432
- # The account id of the expected bucket owner. If the bucket is owned by
12423
+ # The account ID of the expected bucket owner. If the bucket is owned by
12433
12424
  # a different account, the request will fail with an HTTP `403 (Access
12434
12425
  # Denied)` error.
12435
12426
  #
@@ -12574,11 +12565,11 @@ module Aws::S3
12574
12565
  # This action is not supported by Amazon S3 on Outposts.
12575
12566
  #
12576
12567
  # For more information about Amazon S3 Select, see [Selecting Content
12577
- # from Objects][1] in the *Amazon Simple Storage Service User Guide*.
12568
+ # from Objects][1] in the *Amazon S3 User Guide*.
12578
12569
  #
12579
12570
  # For more information about using SQL with Amazon S3 Select, see [ SQL
12580
12571
  # Reference for Amazon S3 Select and S3 Glacier Select][2] in the
12581
- # *Amazon Simple Storage Service User Guide*.
12572
+ # *Amazon S3 User Guide*.
12582
12573
  #
12583
12574
  #
12584
12575
  #
@@ -12587,7 +12578,7 @@ module Aws::S3
12587
12578
  # You must have `s3:GetObject` permission for this operation. Amazon S3
12588
12579
  # Select does not support anonymous access. For more information about
12589
12580
  # permissions, see [Specifying Permissions in a Policy][3] in the
12590
- # *Amazon Simple Storage Service User Guide*.
12581
+ # *Amazon S3 User Guide*.
12591
12582
  #
12592
12583
  #
12593
12584
  #
@@ -12615,8 +12606,7 @@ module Aws::S3
12615
12606
  # keys (SSE-C), you must use HTTPS, and you must use the headers that
12616
12607
  # are documented in the [GetObject][4]. For more information about
12617
12608
  # SSE-C, see [Server-Side Encryption (Using Customer-Provided
12618
- # Encryption Keys)][5] in the *Amazon Simple Storage Service User
12619
- # Guide*.
12609
+ # Encryption Keys)][5] in the *Amazon S3 User Guide*.
12620
12610
  #
12621
12611
  # For objects that are encrypted with Amazon S3 managed encryption
12622
12612
  # keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
@@ -12624,7 +12614,7 @@ module Aws::S3
12624
12614
  # transparently, so you don't need to specify anything. For more
12625
12615
  # information about server-side encryption, including SSE-S3 and
12626
12616
  # SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
12627
- # the *Amazon Simple Storage Service User Guide*.
12617
+ # the *Amazon S3 User Guide*.
12628
12618
  #
12629
12619
  # **Working with the Response Body**
12630
12620
  #
@@ -12648,8 +12638,7 @@ module Aws::S3
12648
12638
  # * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
12649
12639
  # cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
12650
12640
  # storage classes. For more information, about storage classes see
12651
- # [Storage Classes][9] in the *Amazon Simple Storage Service User
12652
- # Guide*.
12641
+ # [Storage Classes][9] in the *Amazon S3 User Guide*.
12653
12642
  #
12654
12643
  #
12655
12644
  #
@@ -12748,7 +12737,7 @@ module Aws::S3
12748
12737
  # within the last 50 bytes of the file.
12749
12738
  #
12750
12739
  # @option params [String] :expected_bucket_owner
12751
- # The account id of the expected bucket owner. If the bucket is owned by
12740
+ # The account ID of the expected bucket owner. If the bucket is owned by
12752
12741
  # a different account, the request will fail with an HTTP `403 (Access
12753
12742
  # Denied)` error.
12754
12743
  #
@@ -13015,11 +13004,11 @@ module Aws::S3
13015
13004
  # parts storage and stops charging you for the parts storage.
13016
13005
  #
13017
13006
  # For more information on multipart uploads, go to [Multipart Upload
13018
- # Overview][4] in the <i>Amazon Simple Storage Service User Guide </i>.
13007
+ # Overview][4] in the <i>Amazon S3 User Guide </i>.
13019
13008
  #
13020
13009
  # For information on the permissions required to use the multipart
13021
13010
  # upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
13022
- # Simple Storage Service User Guide*.
13011
+ # S3 User Guide*.
13023
13012
  #
13024
13013
  # You can optionally request server-side encryption where Amazon S3
13025
13014
  # encrypts your data as it writes it to disks in its data centers and
@@ -13029,8 +13018,7 @@ module Aws::S3
13029
13018
  # request headers you provide in the request must match the headers you
13030
13019
  # used in the request to initiate the upload by using
13031
13020
  # [CreateMultipartUpload][2]. For more information, go to [Using
13032
- # Server-Side Encryption][6] in the *Amazon Simple Storage Service User
13033
- # Guide*.
13021
+ # Server-Side Encryption][6] in the *Amazon S3 User Guide*.
13034
13022
  #
13035
13023
  # Server-side encryption is supported by the S3 Multipart Upload
13036
13024
  # actions. Unless you are using a customer-provided encryption key, you
@@ -13099,7 +13087,7 @@ module Aws::S3
13099
13087
  # When using this action with an access point through the AWS SDKs, you
13100
13088
  # provide the access point ARN in place of the bucket name. For more
13101
13089
  # information about access point ARNs, see [Using Access Points][1] in
13102
- # the *Amazon Simple Storage Service Developer Guide*.
13090
+ # the *Amazon S3 User Guide*.
13103
13091
  #
13104
13092
  # When using this action with Amazon S3 on Outposts, you must direct
13105
13093
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13108,12 +13096,12 @@ module Aws::S3
13108
13096
  # When using this action using S3 on Outposts through the AWS SDKs, you
13109
13097
  # provide the Outposts bucket ARN in place of the bucket name. For more
13110
13098
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13111
- # in the *Amazon Simple Storage Service Developer Guide*.
13099
+ # in the *Amazon S3 User Guide*.
13112
13100
  #
13113
13101
  #
13114
13102
  #
13115
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13116
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13103
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13104
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13117
13105
  #
13118
13106
  # @option params [Integer] :content_length
13119
13107
  # Size of the body in bytes. This parameter is useful when the size of
@@ -13165,7 +13153,7 @@ module Aws::S3
13165
13153
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13166
13154
  #
13167
13155
  # @option params [String] :expected_bucket_owner
13168
- # The account id of the expected bucket owner. If the bucket is owned by
13156
+ # The account ID of the expected bucket owner. If the bucket is owned by
13169
13157
  # a different account, the request will fail with an HTTP `403 (Access
13170
13158
  # Denied)` error.
13171
13159
  #
@@ -13241,7 +13229,7 @@ module Aws::S3
13241
13229
  #
13242
13230
  # The minimum allowable part size for a multipart upload is 5 MB. For
13243
13231
  # more information about multipart upload limits, go to [Quick Facts][1]
13244
- # in the *Amazon Simple Storage Service User Guide*.
13232
+ # in the *Amazon S3 User Guide*.
13245
13233
  #
13246
13234
  # <note markdown="1"> Instead of using an existing object as part data, you might use the
13247
13235
  # [UploadPart][2] action and provide data in your request.
@@ -13257,16 +13245,15 @@ module Aws::S3
13257
13245
  # the following:
13258
13246
  #
13259
13247
  # * For conceptual information about multipart uploads, see [Uploading
13260
- # Objects Using Multipart Upload][3] in the *Amazon Simple Storage
13261
- # Service User Guide*.
13248
+ # Objects Using Multipart Upload][3] in the *Amazon S3 User Guide*.
13262
13249
  #
13263
13250
  # * For information about permissions required to use the multipart
13264
13251
  # upload API, see [Multipart Upload and Permissions][4] in the *Amazon
13265
- # Simple Storage Service User Guide*.
13252
+ # S3 User Guide*.
13266
13253
  #
13267
13254
  # * For information about copying objects using a single atomic action
13268
13255
  # vs. the multipart upload, see [Operations on Objects][5] in the
13269
- # *Amazon Simple Storage Service User Guide*.
13256
+ # *Amazon S3 User Guide*.
13270
13257
  #
13271
13258
  # * For information about using server-side encryption with
13272
13259
  # customer-provided encryption keys with the UploadPartCopy operation,
@@ -13374,7 +13361,7 @@ module Aws::S3
13374
13361
  # When using this action with an access point through the AWS SDKs, you
13375
13362
  # provide the access point ARN in place of the bucket name. For more
13376
13363
  # information about access point ARNs, see [Using Access Points][1] in
13377
- # the *Amazon Simple Storage Service Developer Guide*.
13364
+ # the *Amazon S3 User Guide*.
13378
13365
  #
13379
13366
  # When using this action with Amazon S3 on Outposts, you must direct
13380
13367
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13383,12 +13370,12 @@ module Aws::S3
13383
13370
  # When using this action using S3 on Outposts through the AWS SDKs, you
13384
13371
  # provide the Outposts bucket ARN in place of the bucket name. For more
13385
13372
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13386
- # in the *Amazon Simple Storage Service Developer Guide*.
13373
+ # in the *Amazon S3 User Guide*.
13387
13374
  #
13388
13375
  #
13389
13376
  #
13390
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13391
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13377
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13378
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13392
13379
  #
13393
13380
  # @option params [required, String] :copy_source
13394
13381
  # Specifies the source object for the copy operation. You specify the
@@ -13434,7 +13421,7 @@ module Aws::S3
13434
13421
  #
13435
13422
  #
13436
13423
  #
13437
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
13424
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
13438
13425
  #
13439
13426
  # @option params [String] :copy_source_if_match
13440
13427
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -13511,12 +13498,12 @@ module Aws::S3
13511
13498
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13512
13499
  #
13513
13500
  # @option params [String] :expected_bucket_owner
13514
- # The account id of the expected destination bucket owner. If the
13501
+ # The account ID of the expected destination bucket owner. If the
13515
13502
  # destination bucket is owned by a different account, the request will
13516
13503
  # fail with an HTTP `403 (Access Denied)` error.
13517
13504
  #
13518
13505
  # @option params [String] :expected_source_bucket_owner
13519
- # The account id of the expected source bucket owner. If the source
13506
+ # The account ID of the expected source bucket owner. If the source
13520
13507
  # bucket is owned by a different account, the request will fail with an
13521
13508
  # HTTP `403 (Access Denied)` error.
13522
13509
  #
@@ -13619,6 +13606,297 @@ module Aws::S3
13619
13606
  req.send_request(options)
13620
13607
  end
13621
13608
 
13609
+ # Passes transformed objects to a `GetObject` operation when using
13610
+ # Object Lambda Access Points. For information about Object Lambda
13611
+ # Access Points, see [Transforming objects with Object Lambda Access
13612
+ # Points][1] in the *Amazon S3 User Guide*.
13613
+ #
13614
+ # This operation supports metadata that can be returned by
13615
+ # [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
13616
+ # `StatusCode`, `ErrorCode`, and `ErrorMessage`. The `GetObject`
13617
+ # response metadata is supported so that the `WriteGetObjectResponse`
13618
+ # caller, typically an AWS Lambda function, can provide the same
13619
+ # metadata when it internally invokes `GetObject`. When
13620
+ # `WriteGetObjectResponse` is called by a customer-owned Lambda
13621
+ # function, the metadata returned to the end user `GetObject` call might
13622
+ # differ from what Amazon S3 would normally return.
13623
+ #
13624
+ # AWS provides some prebuilt Lambda functions that you can use with S3
13625
+ # Object Lambda to detect and redact personally identifiable information
13626
+ # (PII) and decompress S3 objects. These Lambda functions are available
13627
+ # in the AWS Serverless Application Repository, and can be selected
13628
+ # through the AWS Management Console when you create your Object Lambda
13629
+ # Access Point.
13630
+ #
13631
+ # Example 1: PII Access Control - This Lambda function uses Amazon
13632
+ # Comprehend, a natural language processing (NLP) service using machine
13633
+ # learning to find insights and relationships in text. It automatically
13634
+ # detects personally identifiable information (PII) such as names,
13635
+ # addresses, dates, credit card numbers, and social security numbers
13636
+ # from documents in your Amazon S3 bucket.
13637
+ #
13638
+ # Example 2: PII Redaction - This Lambda function uses Amazon
13639
+ # Comprehend, a natural language processing (NLP) service using machine
13640
+ # learning to find insights and relationships in text. It automatically
13641
+ # redacts personally identifiable information (PII) such as names,
13642
+ # addresses, dates, credit card numbers, and social security numbers
13643
+ # from documents in your Amazon S3 bucket.
13644
+ #
13645
+ # Example 3: Decompression - The Lambda function
13646
+ # S3ObjectLambdaDecompression, is equipped to decompress objects stored
13647
+ # in S3 in one of six compressed file formats including bzip2, gzip,
13648
+ # snappy, zlib, zstandard and ZIP.
13649
+ #
13650
+ # For information on how to view and use these functions, see [Using AWS
13651
+ # built Lambda functions][3] in the *Amazon S3 User Guide*.
13652
+ #
13653
+ #
13654
+ #
13655
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
13656
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
13657
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html
13658
+ #
13659
+ # @option params [required, String] :request_route
13660
+ # Route prefix to the HTTP URL generated.
13661
+ #
13662
+ # @option params [required, String] :request_token
13663
+ # A single use encrypted token that maps `WriteGetObjectResponse` to the
13664
+ # end user `GetObject` request.
13665
+ #
13666
+ # @option params [String, IO] :body
13667
+ # The object data.
13668
+ #
13669
+ # @option params [Integer] :status_code
13670
+ # The integer status code for an HTTP response of a corresponding
13671
+ # `GetObject` request.
13672
+ #
13673
+ # **Status Codes**
13674
+ #
13675
+ # * *200 - OK*
13676
+ #
13677
+ # * *206 - Partial Content*
13678
+ #
13679
+ # * *304 - Not Modified*
13680
+ #
13681
+ # * *400 - Bad Request*
13682
+ #
13683
+ # * *401 - Unauthorized*
13684
+ #
13685
+ # * *403 - Forbidden*
13686
+ #
13687
+ # * *404 - Not Found*
13688
+ #
13689
+ # * *405 - Method Not Allowed*
13690
+ #
13691
+ # * *409 - Conflict*
13692
+ #
13693
+ # * *411 - Length Required*
13694
+ #
13695
+ # * *412 - Precondition Failed*
13696
+ #
13697
+ # * *416 - Range Not Satisfiable*
13698
+ #
13699
+ # * *500 - Internal Server Error*
13700
+ #
13701
+ # * *503 - Service Unavailable*
13702
+ #
13703
+ # @option params [String] :error_code
13704
+ # A string that uniquely identifies an error condition. Returned in the
13705
+ # &lt;Code&gt; tag of the error XML response for a corresponding
13706
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13707
+ # or when the transformed object is provided in the body. All error
13708
+ # codes from S3 are sentence-cased. Regex value is
13709
+ # "^\[A-Z\]\[a-zA-Z\]+$".
13710
+ #
13711
+ # @option params [String] :error_message
13712
+ # Contains a generic description of the error condition. Returned in the
13713
+ # &lt;Message&gt; tag of the error XML response for a corresponding
13714
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13715
+ # or when the transformed object is provided in body.
13716
+ #
13717
+ # @option params [String] :accept_ranges
13718
+ # Indicates that a range of bytes was specified.
13719
+ #
13720
+ # @option params [String] :cache_control
13721
+ # Specifies caching behavior along the request/reply chain.
13722
+ #
13723
+ # @option params [String] :content_disposition
13724
+ # Specifies presentational information for the object.
13725
+ #
13726
+ # @option params [String] :content_encoding
13727
+ # Specifies what content encodings have been applied to the object and
13728
+ # thus what decoding mechanisms must be applied to obtain the media-type
13729
+ # referenced by the Content-Type header field.
13730
+ #
13731
+ # @option params [String] :content_language
13732
+ # The language the content is in.
13733
+ #
13734
+ # @option params [Integer] :content_length
13735
+ # The size of the content body in bytes.
13736
+ #
13737
+ # @option params [String] :content_range
13738
+ # The portion of the object returned in the response.
13739
+ #
13740
+ # @option params [String] :content_type
13741
+ # A standard MIME type describing the format of the object data.
13742
+ #
13743
+ # @option params [Boolean] :delete_marker
13744
+ # Specifies whether an object stored in Amazon S3 is (`true`) or is not
13745
+ # (`false`) a delete marker.
13746
+ #
13747
+ # @option params [String] :etag
13748
+ # An opaque identifier assigned by a web server to a specific version of
13749
+ # a resource found at a URL.
13750
+ #
13751
+ # @option params [Time,DateTime,Date,Integer,String] :expires
13752
+ # The date and time at which the object is no longer cacheable.
13753
+ #
13754
+ # @option params [String] :expiration
13755
+ # If object stored in Amazon S3 expiration is configured (see PUT Bucket
13756
+ # lifecycle) it includes expiry-date and rule-id key-value pairs
13757
+ # providing object expiration information. The value of the rule-id is
13758
+ # URL encoded.
13759
+ #
13760
+ # @option params [Time,DateTime,Date,Integer,String] :last_modified
13761
+ # The date and time that the object was last modified.
13762
+ #
13763
+ # @option params [Integer] :missing_meta
13764
+ # Set to the number of metadata entries not returned in `x-amz-meta`
13765
+ # headers. This can happen if you create metadata using an API like SOAP
13766
+ # that supports more flexible metadata than the REST API. For example,
13767
+ # using SOAP, you can create metadata whose values are not legal HTTP
13768
+ # headers.
13769
+ #
13770
+ # @option params [Hash<String,String>] :metadata
13771
+ # A map of metadata to store with the object in S3.
13772
+ #
13773
+ # @option params [String] :object_lock_mode
13774
+ # Indicates whether an object stored in Amazon S3 has Object Lock
13775
+ # enabled. For more information about S3 Object Lock, see [Object
13776
+ # Lock][1].
13777
+ #
13778
+ #
13779
+ #
13780
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
13781
+ #
13782
+ # @option params [String] :object_lock_legal_hold_status
13783
+ # Indicates whether an object stored in Amazon S3 has an active legal
13784
+ # hold.
13785
+ #
13786
+ # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
13787
+ # The date and time when Object Lock is configured to expire.
13788
+ #
13789
+ # @option params [Integer] :parts_count
13790
+ # The count of parts this object has.
13791
+ #
13792
+ # @option params [String] :replication_status
13793
+ # Indicates if request involves bucket that is either a source or
13794
+ # destination in a Replication rule. For more information about S3
13795
+ # Replication, see [Replication][1].
13796
+ #
13797
+ #
13798
+ #
13799
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html
13800
+ #
13801
+ # @option params [String] :request_charged
13802
+ # If present, indicates that the requester was successfully charged for
13803
+ # the request.
13804
+ #
13805
+ # @option params [String] :restore
13806
+ # Provides information about object restoration operation and expiration
13807
+ # time of the restored object copy.
13808
+ #
13809
+ # @option params [String] :server_side_encryption
13810
+ # The server-side encryption algorithm used when storing requested
13811
+ # object in Amazon S3 (for example, AES256, aws:kms).
13812
+ #
13813
+ # @option params [String] :sse_customer_algorithm
13814
+ # Encryption algorithm used if server-side encryption with a
13815
+ # customer-provided encryption key was specified for object stored in
13816
+ # Amazon S3.
13817
+ #
13818
+ # @option params [String] :ssekms_key_id
13819
+ # If present, specifies the ID of the AWS Key Management Service (AWS
13820
+ # KMS) symmetric customer managed customer master key (CMK) that was
13821
+ # used for stored in Amazon S3 object.
13822
+ #
13823
+ # @option params [String] :sse_customer_key_md5
13824
+ # 128-bit MD5 digest of customer-provided encryption key used in Amazon
13825
+ # S3 to encrypt data stored in S3. For more information, see [Protecting
13826
+ # data using server-side encryption with customer-provided encryption
13827
+ # keys (SSE-C)][1].
13828
+ #
13829
+ #
13830
+ #
13831
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
13832
+ #
13833
+ # @option params [String] :storage_class
13834
+ # The class of storage used to store object in Amazon S3.
13835
+ #
13836
+ # @option params [Integer] :tag_count
13837
+ # The number of tags, if any, on the object.
13838
+ #
13839
+ # @option params [String] :version_id
13840
+ # An ID used to reference a specific version of the object.
13841
+ #
13842
+ # @option params [Boolean] :bucket_key_enabled
13843
+ # Indicates whether the object stored in Amazon S3 uses an S3 bucket key
13844
+ # for server-side encryption with AWS KMS (SSE-KMS).
13845
+ #
13846
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
13847
+ #
13848
+ # @example Request syntax with placeholder values
13849
+ #
13850
+ # resp = client.write_get_object_response({
13851
+ # request_route: "RequestRoute", # required
13852
+ # request_token: "RequestToken", # required
13853
+ # body: source_file,
13854
+ # status_code: 1,
13855
+ # error_code: "ErrorCode",
13856
+ # error_message: "ErrorMessage",
13857
+ # accept_ranges: "AcceptRanges",
13858
+ # cache_control: "CacheControl",
13859
+ # content_disposition: "ContentDisposition",
13860
+ # content_encoding: "ContentEncoding",
13861
+ # content_language: "ContentLanguage",
13862
+ # content_length: 1,
13863
+ # content_range: "ContentRange",
13864
+ # content_type: "ContentType",
13865
+ # delete_marker: false,
13866
+ # etag: "ETag",
13867
+ # expires: Time.now,
13868
+ # expiration: "Expiration",
13869
+ # last_modified: Time.now,
13870
+ # missing_meta: 1,
13871
+ # metadata: {
13872
+ # "MetadataKey" => "MetadataValue",
13873
+ # },
13874
+ # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
13875
+ # object_lock_legal_hold_status: "ON", # accepts ON, OFF
13876
+ # object_lock_retain_until_date: Time.now,
13877
+ # parts_count: 1,
13878
+ # replication_status: "COMPLETE", # accepts COMPLETE, PENDING, FAILED, REPLICA
13879
+ # request_charged: "requester", # accepts requester
13880
+ # restore: "Restore",
13881
+ # server_side_encryption: "AES256", # accepts AES256, aws:kms
13882
+ # sse_customer_algorithm: "SSECustomerAlgorithm",
13883
+ # ssekms_key_id: "SSEKMSKeyId",
13884
+ # sse_customer_key_md5: "SSECustomerKeyMD5",
13885
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
13886
+ # tag_count: 1,
13887
+ # version_id: "ObjectVersionId",
13888
+ # bucket_key_enabled: false,
13889
+ # })
13890
+ #
13891
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponse AWS API Documentation
13892
+ #
13893
+ # @overload write_get_object_response(params = {})
13894
+ # @param [Hash] params ({})
13895
+ def write_get_object_response(params = {}, options = {})
13896
+ req = build_request(:write_get_object_response, params)
13897
+ req.send_request(options)
13898
+ end
13899
+
13622
13900
  # @!endgroup
13623
13901
 
13624
13902
  # @param params ({})
@@ -13632,7 +13910,7 @@ module Aws::S3
13632
13910
  params: params,
13633
13911
  config: config)
13634
13912
  context[:gem_name] = 'aws-sdk-s3'
13635
- context[:gem_version] = '1.90.0'
13913
+ context[:gem_version] = '1.94.0'
13636
13914
  Seahorse::Client::Request.new(handlers, context)
13637
13915
  end
13638
13916