aws-sdk-s3 1.88.1 → 1.92.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 (41) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +736 -0
  3. data/LICENSE.txt +202 -0
  4. data/VERSION +1 -0
  5. data/lib/aws-sdk-s3.rb +2 -2
  6. data/lib/aws-sdk-s3/arn/access_point_arn.rb +2 -2
  7. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +66 -0
  8. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +3 -3
  9. data/lib/aws-sdk-s3/bucket.rb +10 -10
  10. data/lib/aws-sdk-s3/bucket_acl.rb +2 -2
  11. data/lib/aws-sdk-s3/bucket_cors.rb +5 -5
  12. data/lib/aws-sdk-s3/bucket_lifecycle.rb +3 -3
  13. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
  14. data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
  15. data/lib/aws-sdk-s3/bucket_notification.rb +2 -2
  16. data/lib/aws-sdk-s3/bucket_policy.rb +3 -3
  17. data/lib/aws-sdk-s3/bucket_request_payment.rb +5 -6
  18. data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
  19. data/lib/aws-sdk-s3/bucket_versioning.rb +4 -4
  20. data/lib/aws-sdk-s3/bucket_website.rb +3 -3
  21. data/lib/aws-sdk-s3/client.rb +1091 -773
  22. data/lib/aws-sdk-s3/client_api.rb +62 -1
  23. data/lib/aws-sdk-s3/customizations/bucket.rb +8 -3
  24. data/lib/aws-sdk-s3/customizations/object.rb +9 -3
  25. data/lib/aws-sdk-s3/errors.rb +1 -1
  26. data/lib/aws-sdk-s3/event_streams.rb +1 -1
  27. data/lib/aws-sdk-s3/multipart_upload.rb +4 -4
  28. data/lib/aws-sdk-s3/multipart_upload_part.rb +5 -5
  29. data/lib/aws-sdk-s3/object.rb +22 -22
  30. data/lib/aws-sdk-s3/object_acl.rb +2 -2
  31. data/lib/aws-sdk-s3/object_summary.rb +22 -22
  32. data/lib/aws-sdk-s3/object_version.rb +10 -10
  33. data/lib/aws-sdk-s3/plugins/arn.rb +20 -13
  34. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +11 -10
  35. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  36. data/lib/aws-sdk-s3/plugins/s3_signer.rb +6 -0
  37. data/lib/aws-sdk-s3/presigner.rb +1 -2
  38. data/lib/aws-sdk-s3/resource.rb +1 -1
  39. data/lib/aws-sdk-s3/types.rb +822 -377
  40. data/lib/aws-sdk-s3/waiters.rb +1 -1
  41. metadata +8 -3
@@ -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]
@@ -232,7 +232,7 @@ module Aws::S3
232
232
  # SDKs, this field is calculated automatically.
233
233
  # @option options [Types::LifecycleConfiguration] :lifecycle_configuration
234
234
  # @option options [String] :expected_bucket_owner
235
- # The account id of the expected bucket owner. If the bucket is owned by
235
+ # The account ID of the expected bucket owner. If the bucket is owned by
236
236
  # a different account, the request will fail with an HTTP `403 (Access
237
237
  # Denied)` error.
238
238
  # @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]
@@ -249,7 +249,7 @@ module Aws::S3
249
249
  # @option options [Types::BucketLifecycleConfiguration] :lifecycle_configuration
250
250
  # Container for lifecycle rules. You can add as many as 1,000 rules.
251
251
  # @option options [String] :expected_bucket_owner
252
- # The account id of the expected bucket owner. If the bucket is owned by
252
+ # The account ID of the expected bucket owner. If the bucket is owned by
253
253
  # a different account, the request will fail with an HTTP `403 (Access
254
254
  # Denied)` error.
255
255
  # @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
 
@@ -214,7 +214,7 @@ module Aws::S3
214
214
  # For requests made using the AWS Command Line Interface (CLI) or AWS
215
215
  # SDKs, this field is calculated automatically.
216
216
  # @option options [String] :expected_bucket_owner
217
- # The account id of the expected bucket owner. If the bucket is owned by
217
+ # The account ID of the expected bucket owner. If the bucket is owned by
218
218
  # a different account, the request will fail with an HTTP `403 (Access
219
219
  # Denied)` error.
220
220
  # @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
 
@@ -253,7 +253,7 @@ module Aws::S3
253
253
  # bucket. If this element is empty, notifications are turned off for the
254
254
  # bucket.
255
255
  # @option options [String] :expected_bucket_owner
256
- # The account id of the expected bucket owner. If the bucket is owned by
256
+ # The account ID of the expected bucket owner. If the bucket is owned by
257
257
  # a different account, the request will fail with an HTTP `403 (Access
258
258
  # Denied)` error.
259
259
  # @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]
@@ -211,7 +211,7 @@ module Aws::S3
211
211
  # @option options [required, String] :policy
212
212
  # The bucket policy as a JSON document.
213
213
  # @option options [String] :expected_bucket_owner
214
- # The account id of the expected bucket owner. If the bucket is owned by
214
+ # The account ID of the expected bucket owner. If the bucket is owned by
215
215
  # a different account, the request will fail with an HTTP `403 (Access
216
216
  # Denied)` error.
217
217
  # @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
 
@@ -185,10 +185,9 @@ module Aws::S3
185
185
  # })
186
186
  # @param [Hash] options ({})
187
187
  # @option options [String] :content_md5
188
- # >The base64-encoded 128-bit MD5 digest of the data. You must use
189
- # this header as a message integrity check to verify that the request
190
- # body was not corrupted in transit. For more information, see [RFC
191
- # 1864][1].
188
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
189
+ # header as a message integrity check to verify that the request body
190
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
192
191
  #
193
192
  # For requests made using the AWS Command Line Interface (CLI) or AWS
194
193
  # SDKs, this field is calculated automatically.
@@ -199,7 +198,7 @@ module Aws::S3
199
198
  # @option options [required, Types::RequestPaymentConfiguration] :request_payment_configuration
200
199
  # Container for Payer.
201
200
  # @option options [String] :expected_bucket_owner
202
- # 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
203
202
  # a different account, the request will fail with an HTTP `403 (Access
204
203
  # Denied)` error.
205
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
@@ -408,7 +410,7 @@ module Aws::S3
408
410
 
409
411
  # @!group API Operations
410
412
 
411
- # This operation aborts a multipart upload. After a multipart upload is
413
+ # This action aborts a multipart upload. After a multipart upload is
412
414
  # aborted, no additional parts can be uploaded using that upload ID. The
413
415
  # storage consumed by any previously uploaded parts will be freed.
414
416
  # However, if any part uploads are currently in progress, those part
@@ -417,11 +419,11 @@ module Aws::S3
417
419
  # completely free all storage consumed by all parts.
418
420
  #
419
421
  # To verify that all parts have been removed, so you don't get charged
420
- # for the part storage, you should call the [ListParts][1] operation and
422
+ # for the part storage, you should call the [ListParts][1] action and
421
423
  # ensure that the parts list is empty.
422
424
  #
423
- # For information about permissions required to use the multipart upload
424
- # API, see [Multipart Upload API and Permissions][2].
425
+ # For information about permissions required to use the multipart
426
+ # upload, see [Multipart Upload and Permissions][2].
425
427
  #
426
428
  # The following operations are related to `AbortMultipartUpload`\:
427
429
  #
@@ -447,27 +449,27 @@ module Aws::S3
447
449
  # @option params [required, String] :bucket
448
450
  # The bucket name to which the upload was taking place.
449
451
  #
450
- # When using this API with an access point, you must direct requests to
451
- # the access point hostname. The access point hostname takes the form
452
+ # When using this action with an access point, you must direct requests
453
+ # to the access point hostname. The access point hostname takes the form
452
454
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
453
- # When using this operation with an access point through the AWS SDKs,
454
- # you provide the access point ARN in place of the bucket name. For more
455
+ # When using this action with an access point through the AWS SDKs, you
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
458
  # the *Amazon Simple Storage Service Developer Guide*.
457
459
  #
458
- # When using this API with Amazon S3 on Outposts, you must direct
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
460
462
  # takes the form
461
463
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
462
- # When using this operation using S3 on Outposts through the AWS SDKs,
463
- # you provide the Outposts bucket ARN in place of the bucket name. For
464
- # more information about S3 on Outposts ARNs, see [Using S3 on
465
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
464
+ # When using this action using S3 on Outposts through the AWS SDKs, you
465
+ # provide the Outposts bucket ARN in place of the bucket name. For more
466
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
467
+ # in the *Amazon Simple Storage Service Developer 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
  #
@@ -537,11 +539,11 @@ module Aws::S3
537
539
  #
538
540
  # You first initiate the multipart upload and then upload all parts
539
541
  # using the [UploadPart][1] operation. After successfully uploading all
540
- # relevant parts of an upload, you call this operation to complete the
542
+ # relevant parts of an upload, you call this action to complete the
541
543
  # upload. Upon receiving this request, Amazon S3 concatenates all the
542
544
  # parts in ascending order by part number to create a new object. In the
543
545
  # Complete Multipart Upload request, you must provide the parts list.
544
- # You must ensure that the parts list is complete. This operation
546
+ # You must ensure that the parts list is complete. This action
545
547
  # concatenates the parts that you provide in the list. For each part in
546
548
  # the list, you must provide the part number and the `ETag` value,
547
549
  # returned after that part was uploaded.
@@ -563,7 +565,7 @@ module Aws::S3
563
565
  # Using Multipart Upload][3].
564
566
  #
565
567
  # For information about permissions required to use the multipart upload
566
- # API, see [Multipart Upload API and Permissions][4].
568
+ # API, see [Multipart Upload and Permissions][4].
567
569
  #
568
570
  # `CompleteMultipartUpload` has the following special errors:
569
571
  #
@@ -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
  #
@@ -737,8 +739,8 @@ module Aws::S3
737
739
  #
738
740
  # <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
739
741
  # create a copy of your object up to 5 GB in size in a single atomic
740
- # operation using this API. However, to copy an object greater than 5
741
- # GB, you must use the multipart upload Upload Part - Copy API. For more
742
+ # action using this API. However, to copy an object greater than 5 GB,
743
+ # you must use the multipart upload Upload Part - Copy API. For more
742
744
  # information, see [Copy Object Using the REST Multipart Upload API][1].
743
745
  #
744
746
  # </note>
@@ -752,12 +754,11 @@ module Aws::S3
752
754
  #
753
755
  # A copy request might return an error when Amazon S3 receives the copy
754
756
  # request or while Amazon S3 is copying the files. If the error occurs
755
- # before the copy operation starts, you receive a standard Amazon S3
756
- # error. If the error occurs during the copy operation, the error
757
- # response is embedded in the `200 OK` response. This means that a `200
758
- # OK` response can contain either a success or an error. Design your
759
- # application to parse the contents of the response and handle it
760
- # appropriately.
757
+ # before the copy action starts, you receive a standard Amazon S3 error.
758
+ # If the error occurs during the copy operation, the error response is
759
+ # embedded in the `200 OK` response. This means that a `200 OK` response
760
+ # can contain either a success or an error. Design your application to
761
+ # parse the contents of the response and handle it appropriately.
761
762
  #
762
763
  # If the copy is successful, you receive a response with information
763
764
  # about the copied object.
@@ -845,7 +846,7 @@ module Aws::S3
845
846
  #
846
847
  # If a target object uses SSE-KMS, you can enable an S3 Bucket Key for
847
848
  # the object. For more information, see [Amazon S3 Bucket Keys][9] in
848
- # the *Amazon Simple Storage Service Developer Guide*.
849
+ # the *Amazon S3 User Guide*.
849
850
  #
850
851
  # **Access Control List (ACL)-Specific Request Headers**
851
852
  #
@@ -859,8 +860,8 @@ module Aws::S3
859
860
  #
860
861
  # **Storage Class Options**
861
862
  #
862
- # You can use the `CopyObject` operation to change the storage class of
863
- # an object that is already stored in Amazon S3 using the `StorageClass`
863
+ # You can use the `CopyObject` action to change the storage class of an
864
+ # object that is already stored in Amazon S3 using the `StorageClass`
864
865
  # parameter. For more information, see [Storage Classes][12] in the
865
866
  # *Amazon S3 Service Developer Guide*.
866
867
  #
@@ -896,7 +897,7 @@ module Aws::S3
896
897
  #
897
898
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
898
899
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
899
- # [3]: https://aws.amazon.com/s3/pricing/
900
+ # [3]: http://aws.amazon.com/s3/pricing/
900
901
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
901
902
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
902
903
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html
@@ -919,27 +920,27 @@ module Aws::S3
919
920
  # @option params [required, String] :bucket
920
921
  # The name of the destination bucket.
921
922
  #
922
- # When using this API with an access point, you must direct requests to
923
- # the access point hostname. The access point hostname takes the form
923
+ # When using this action with an access point, you must direct requests
924
+ # to the access point hostname. The access point hostname takes the form
924
925
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
925
- # When using this operation with an access point through the AWS SDKs,
926
- # you provide the access point ARN in place of the bucket name. For more
926
+ # When using this action with an access point through the AWS SDKs, you
927
+ # provide the access point ARN in place of the bucket name. For more
927
928
  # information about access point ARNs, see [Using Access Points][1] in
928
929
  # the *Amazon Simple Storage Service Developer Guide*.
929
930
  #
930
- # When using this API with Amazon S3 on Outposts, you must direct
931
+ # When using this action with Amazon S3 on Outposts, you must direct
931
932
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
932
933
  # takes the form
933
934
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
934
- # When using this operation using S3 on Outposts through the AWS SDKs,
935
- # you provide the Outposts bucket ARN in place of the bucket name. For
936
- # more information about S3 on Outposts ARNs, see [Using S3 on
937
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
935
+ # When using this action using S3 on Outposts through the AWS SDKs, you
936
+ # provide the Outposts bucket ARN in place of the bucket name. For more
937
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
938
+ # in the *Amazon Simple Storage Service Developer Guide*.
938
939
  #
939
940
  #
940
941
  #
941
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
942
- # [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
943
944
  #
944
945
  # @option params [String] :cache_control
945
946
  # Specifies caching behavior along the request/reply chain.
@@ -1002,7 +1003,7 @@ module Aws::S3
1002
1003
  #
1003
1004
  #
1004
1005
  #
1005
- # [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
1006
1007
  #
1007
1008
  # @option params [String] :copy_source_if_match
1008
1009
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -1116,8 +1117,8 @@ module Aws::S3
1116
1117
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
1117
1118
  # for object encryption with SSE-KMS.
1118
1119
  #
1119
- # Specifying this header with a COPY operation doesn’t affect
1120
- # bucket-level settings for S3 Bucket Key.
1120
+ # Specifying this header with a COPY action doesn’t affect bucket-level
1121
+ # settings for S3 Bucket Key.
1121
1122
  #
1122
1123
  # @option params [String] :copy_source_sse_customer_algorithm
1123
1124
  # Specifies the algorithm to use when decrypting the source object (for
@@ -1160,12 +1161,12 @@ module Aws::S3
1160
1161
  # Specifies whether you want to apply a Legal Hold to the copied object.
1161
1162
  #
1162
1163
  # @option params [String] :expected_bucket_owner
1163
- # The account id of the expected destination bucket owner. If the
1164
+ # The account ID of the expected destination bucket owner. If the
1164
1165
  # destination bucket is owned by a different account, the request will
1165
1166
  # fail with an HTTP `403 (Access Denied)` error.
1166
1167
  #
1167
1168
  # @option params [String] :expected_source_bucket_owner
1168
- # 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
1169
1170
  # bucket is owned by a different account, the request will fail with an
1170
1171
  # HTTP `403 (Access Denied)` error.
1171
1172
  #
@@ -1476,7 +1477,7 @@ module Aws::S3
1476
1477
  req.send_request(options)
1477
1478
  end
1478
1479
 
1479
- # This operation initiates a multipart upload and returns an upload ID.
1480
+ # This action initiates a multipart upload and returns an upload ID.
1480
1481
  # This upload ID is used to associate all of the parts in the specific
1481
1482
  # multipart upload. You specify this upload ID in each of your
1482
1483
  # subsequent upload part requests (see [UploadPart][1]). You also
@@ -1489,12 +1490,12 @@ module Aws::S3
1489
1490
  # If you have configured a lifecycle rule to abort incomplete multipart
1490
1491
  # uploads, the upload must complete within the number of days specified
1491
1492
  # in the bucket lifecycle configuration. Otherwise, the incomplete
1492
- # multipart upload becomes eligible for an abort operation and Amazon S3
1493
+ # multipart upload becomes eligible for an abort action and Amazon S3
1493
1494
  # aborts the multipart upload. For more information, see [Aborting
1494
1495
  # Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][3].
1495
1496
  #
1496
1497
  # For information about the permissions required to use the multipart
1497
- # upload API, see [Multipart Upload API and Permissions][4].
1498
+ # upload API, see [Multipart Upload and Permissions][4].
1498
1499
  #
1499
1500
  # For request signing, multipart upload is just a series of regular
1500
1501
  # requests. You initiate a multipart upload, send one or more requests
@@ -1517,9 +1518,9 @@ module Aws::S3
1517
1518
  # your own encryption key, or use AWS Key Management Service (AWS KMS)
1518
1519
  # customer master keys (CMKs) or Amazon S3-managed encryption keys. If
1519
1520
  # you choose to provide your own encryption key, the request headers you
1520
- # provide in [UploadPart](AmazonS3/latest/API/API_UploadPart.html) and
1521
- # [UploadPartCopy][6] requests must match the headers you used in the
1522
- # request to initiate the upload by using `CreateMultipartUpload`.
1521
+ # provide in [UploadPart][1] and [UploadPartCopy][6] requests must match
1522
+ # the headers you used in the request to initiate the upload by using
1523
+ # `CreateMultipartUpload`.
1523
1524
  #
1524
1525
  # To perform a multipart upload with encryption using an AWS KMS CMK,
1525
1526
  # the requester must have permission to the `kms:Encrypt`,
@@ -1717,27 +1718,27 @@ module Aws::S3
1717
1718
  # @option params [required, String] :bucket
1718
1719
  # The name of the bucket to which to initiate the upload
1719
1720
  #
1720
- # When using this API with an access point, you must direct requests to
1721
- # the access point hostname. The access point hostname takes the form
1721
+ # When using this action with an access point, you must direct requests
1722
+ # to the access point hostname. The access point hostname takes the form
1722
1723
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1723
- # When using this operation with an access point through the AWS SDKs,
1724
- # you provide the access point ARN in place of the bucket name. For more
1724
+ # When using this action with an access point through the AWS SDKs, you
1725
+ # provide the access point ARN in place of the bucket name. For more
1725
1726
  # information about access point ARNs, see [Using Access Points][1] in
1726
1727
  # the *Amazon Simple Storage Service Developer Guide*.
1727
1728
  #
1728
- # When using this API with Amazon S3 on Outposts, you must direct
1729
+ # When using this action with Amazon S3 on Outposts, you must direct
1729
1730
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1730
1731
  # takes the form
1731
1732
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
1732
- # When using this operation using S3 on Outposts through the AWS SDKs,
1733
- # you provide the Outposts bucket ARN in place of the bucket name. For
1734
- # more information about S3 on Outposts ARNs, see [Using S3 on
1735
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
1733
+ # When using this action using S3 on Outposts through the AWS SDKs, you
1734
+ # provide the Outposts bucket ARN in place of the bucket name. For more
1735
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
1736
+ # in the *Amazon Simple Storage Service Developer Guide*.
1736
1737
  #
1737
1738
  #
1738
1739
  #
1739
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
1740
- # [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
1741
1742
  #
1742
1743
  # @option params [String] :cache_control
1743
1744
  # Specifies caching behavior along the request/reply chain.
@@ -1833,7 +1834,7 @@ module Aws::S3
1833
1834
  #
1834
1835
  #
1835
1836
  #
1836
- # [1]: https://docs.aws.amazon.com/http:/docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
1837
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
1837
1838
  #
1838
1839
  # @option params [String] :ssekms_encryption_context
1839
1840
  # Specifies the AWS KMS Encryption Context to use for object encryption.
@@ -1846,7 +1847,7 @@ module Aws::S3
1846
1847
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
1847
1848
  # for object encryption with SSE-KMS.
1848
1849
  #
1849
- # Specifying this header with an object operation doesn’t affect
1850
+ # Specifying this header with an object action doesn’t affect
1850
1851
  # bucket-level settings for S3 Bucket Key.
1851
1852
  #
1852
1853
  # @option params [String] :request_payer
@@ -1876,7 +1877,7 @@ module Aws::S3
1876
1877
  # object.
1877
1878
  #
1878
1879
  # @option params [String] :expected_bucket_owner
1879
- # 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
1880
1881
  # a different account, the request will fail with an HTTP `403 (Access
1881
1882
  # Denied)` error.
1882
1883
  #
@@ -1991,7 +1992,7 @@ module Aws::S3
1991
1992
  # Specifies the bucket being deleted.
1992
1993
  #
1993
1994
  # @option params [String] :expected_bucket_owner
1994
- # 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
1995
1996
  # a different account, the request will fail with an HTTP `403 (Access
1996
1997
  # Denied)` error.
1997
1998
  #
@@ -2046,8 +2047,8 @@ module Aws::S3
2046
2047
  #
2047
2048
  #
2048
2049
  #
2049
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2050
- # [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
2051
2052
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
2052
2053
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
2053
2054
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -2061,7 +2062,7 @@ module Aws::S3
2061
2062
  # The ID that identifies the analytics configuration.
2062
2063
  #
2063
2064
  # @option params [String] :expected_bucket_owner
2064
- # 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
2065
2066
  # a different account, the request will fail with an HTTP `403 (Access
2066
2067
  # Denied)` error.
2067
2068
  #
@@ -2091,7 +2092,7 @@ module Aws::S3
2091
2092
  # default and can grant this permission to others.
2092
2093
  #
2093
2094
  # For information about `cors`, see [Enabling Cross-Origin Resource
2094
- # Sharing][1] in the *Amazon Simple Storage Service Developer Guide*.
2095
+ # Sharing][1] in the *Amazon S3 User Guide*.
2095
2096
  #
2096
2097
  # **Related Resources:**
2097
2098
  #
@@ -2109,7 +2110,7 @@ module Aws::S3
2109
2110
  # Specifies the bucket whose `cors` configuration is being deleted.
2110
2111
  #
2111
2112
  # @option params [String] :expected_bucket_owner
2112
- # 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
2113
2114
  # a different account, the request will fail with an HTTP `403 (Access
2114
2115
  # Denied)` error.
2115
2116
  #
@@ -2140,18 +2141,18 @@ module Aws::S3
2140
2141
  req.send_request(options)
2141
2142
  end
2142
2143
 
2143
- # This implementation of the DELETE operation removes default encryption
2144
+ # This implementation of the DELETE action removes default encryption
2144
2145
  # from the bucket. For information about the Amazon S3 default
2145
2146
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
2146
- # the *Amazon Simple Storage Service Developer Guide*.
2147
+ # the *Amazon S3 User Guide*.
2147
2148
  #
2148
2149
  # To use this operation, you must have permissions to perform the
2149
2150
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
2150
2151
  # permission by default. The bucket owner can grant this permission to
2151
2152
  # others. For more information about permissions, see [Permissions
2152
2153
  # Related to Bucket Subresource Operations][2] and [Managing Access
2153
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
2154
- # Storage Service Developer Guide*.
2154
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
2155
+ # Guide*.
2155
2156
  #
2156
2157
  # **Related Resources**
2157
2158
  #
@@ -2162,8 +2163,8 @@ module Aws::S3
2162
2163
  #
2163
2164
  #
2164
2165
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
2165
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2166
- # [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
2167
2168
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
2168
2169
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
2169
2170
  #
@@ -2172,7 +2173,7 @@ module Aws::S3
2172
2173
  # configuration to delete.
2173
2174
  #
2174
2175
  # @option params [String] :expected_bucket_owner
2175
- # 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
2176
2177
  # a different account, the request will fail with an HTTP `403 (Access
2177
2178
  # Denied)` error.
2178
2179
  #
@@ -2279,8 +2280,8 @@ module Aws::S3
2279
2280
  #
2280
2281
  #
2281
2282
  #
2282
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2283
- # [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
2284
2285
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
2285
2286
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
2286
2287
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
@@ -2294,7 +2295,7 @@ module Aws::S3
2294
2295
  # The ID used to identify the inventory configuration.
2295
2296
  #
2296
2297
  # @option params [String] :expected_bucket_owner
2297
- # 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
2298
2299
  # a different account, the request will fail with an HTTP `403 (Access
2299
2300
  # Denied)` error.
2300
2301
  #
@@ -2350,7 +2351,7 @@ module Aws::S3
2350
2351
  # The bucket name of the lifecycle to delete.
2351
2352
  #
2352
2353
  # @option params [String] :expected_bucket_owner
2353
- # 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
2354
2355
  # a different account, the request will fail with an HTTP `403 (Access
2355
2356
  # Denied)` error.
2356
2357
  #
@@ -2408,8 +2409,8 @@ module Aws::S3
2408
2409
  #
2409
2410
  #
2410
2411
  #
2411
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2412
- # [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
2413
2414
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
2414
2415
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
2415
2416
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -2422,7 +2423,7 @@ module Aws::S3
2422
2423
  # The ID used to identify the metrics configuration.
2423
2424
  #
2424
2425
  # @option params [String] :expected_bucket_owner
2425
- # 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
2426
2427
  # a different account, the request will fail with an HTTP `403 (Access
2427
2428
  # Denied)` error.
2428
2429
  #
@@ -2469,7 +2470,7 @@ module Aws::S3
2469
2470
  # The Amazon S3 bucket whose `OwnershipControls` you want to delete.
2470
2471
  #
2471
2472
  # @option params [String] :expected_bucket_owner
2472
- # 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
2473
2474
  # a different account, the request will fail with an HTTP `403 (Access
2474
2475
  # Denied)` error.
2475
2476
  #
@@ -2491,12 +2492,12 @@ module Aws::S3
2491
2492
  req.send_request(options)
2492
2493
  end
2493
2494
 
2494
- # This implementation of the DELETE operation uses the policy
2495
- # subresource to delete the policy of a specified bucket. If you are
2496
- # using an identity other than the root user of the AWS account that
2497
- # owns the bucket, the calling identity must have the
2498
- # `DeleteBucketPolicy` permissions on the specified bucket and belong to
2499
- # the bucket owner's account to use this operation.
2495
+ # This implementation of the DELETE action uses the policy subresource
2496
+ # to delete the policy of a specified bucket. If you are using an
2497
+ # identity other than the root user of the AWS account that owns the
2498
+ # bucket, the calling identity must have the `DeleteBucketPolicy`
2499
+ # permissions on the specified bucket and belong to the bucket owner's
2500
+ # account to use this operation.
2500
2501
  #
2501
2502
  # If you don't have `DeleteBucketPolicy` permissions, Amazon S3 returns
2502
2503
  # a `403 Access Denied` error. If you have the correct permissions, but
@@ -2508,25 +2509,25 @@ module Aws::S3
2508
2509
  # denies the root user the ability to perform this action.
2509
2510
  #
2510
2511
  # For more information about bucket policies, see [Using Bucket Policies
2511
- # and UserPolicies](
2512
- # https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html).
2512
+ # and UserPolicies][1].
2513
2513
  #
2514
2514
  # The following operations are related to `DeleteBucketPolicy`
2515
2515
  #
2516
- # * [CreateBucket][1]
2516
+ # * [CreateBucket][2]
2517
2517
  #
2518
- # * [DeleteObject][2]
2518
+ # * [DeleteObject][3]
2519
2519
  #
2520
2520
  #
2521
2521
  #
2522
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
2523
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
2522
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
2523
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
2524
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
2524
2525
  #
2525
2526
  # @option params [required, String] :bucket
2526
2527
  # The bucket name.
2527
2528
  #
2528
2529
  # @option params [String] :expected_bucket_owner
2529
- # 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
2530
2531
  # a different account, the request will fail with an HTTP `403 (Access
2531
2532
  # Denied)` error.
2532
2533
  #
@@ -2571,28 +2572,28 @@ module Aws::S3
2571
2572
  #
2572
2573
  # </note>
2573
2574
  #
2574
- # For information about replication configuration, see [Replication](
2575
- # https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html) in
2576
- # the *Amazon S3 Developer Guide*.
2575
+ # For information about replication configuration, see [Replication][3]
2576
+ # in the *Amazon S3 Developer Guide*.
2577
2577
  #
2578
2578
  # The following operations are related to `DeleteBucketReplication`\:
2579
2579
  #
2580
- # * [PutBucketReplication][3]
2580
+ # * [PutBucketReplication][4]
2581
2581
  #
2582
- # * [GetBucketReplication][4]
2582
+ # * [GetBucketReplication][5]
2583
2583
  #
2584
2584
  #
2585
2585
  #
2586
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2587
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2588
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
2589
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.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
2588
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
2589
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
2590
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
2590
2591
  #
2591
2592
  # @option params [required, String] :bucket
2592
2593
  # The bucket name.
2593
2594
  #
2594
2595
  # @option params [String] :expected_bucket_owner
2595
- # 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
2596
2597
  # a different account, the request will fail with an HTTP `403 (Access
2597
2598
  # Denied)` error.
2598
2599
  #
@@ -2644,7 +2645,7 @@ module Aws::S3
2644
2645
  # The bucket that has the tag set to be removed.
2645
2646
  #
2646
2647
  # @option params [String] :expected_bucket_owner
2647
- # 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
2648
2649
  # a different account, the request will fail with an HTTP `403 (Access
2649
2650
  # Denied)` error.
2650
2651
  #
@@ -2675,18 +2676,18 @@ module Aws::S3
2675
2676
  req.send_request(options)
2676
2677
  end
2677
2678
 
2678
- # This operation removes the website configuration for a bucket. Amazon
2679
- # S3 returns a `200 OK` response upon successfully deleting a website
2679
+ # This action removes the website configuration for a bucket. Amazon S3
2680
+ # returns a `200 OK` response upon successfully deleting a website
2680
2681
  # configuration on the specified bucket. You will get a `200 OK`
2681
2682
  # response if the website configuration you are trying to delete does
2682
2683
  # not exist on the bucket. Amazon S3 returns a `404` response if the
2683
2684
  # bucket specified in the request does not exist.
2684
2685
  #
2685
- # This DELETE operation requires the `S3:DeleteBucketWebsite`
2686
- # permission. By default, only the bucket owner can delete the website
2687
- # configuration attached to a bucket. However, bucket owners can grant
2688
- # other users permission to delete the website configuration by writing
2689
- # a bucket policy granting them the `S3:DeleteBucketWebsite` permission.
2686
+ # This DELETE action requires the `S3:DeleteBucketWebsite` permission.
2687
+ # By default, only the bucket owner can delete the website configuration
2688
+ # attached to a bucket. However, bucket owners can grant other users
2689
+ # permission to delete the website configuration by writing a bucket
2690
+ # policy granting them the `S3:DeleteBucketWebsite` permission.
2690
2691
  #
2691
2692
  # For more information about hosting websites, see [Hosting Websites on
2692
2693
  # Amazon S3][1].
@@ -2708,7 +2709,7 @@ module Aws::S3
2708
2709
  # configuration.
2709
2710
  #
2710
2711
  # @option params [String] :expected_bucket_owner
2711
- # 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
2712
2713
  # a different account, the request will fail with an HTTP `403 (Access
2713
2714
  # Denied)` error.
2714
2715
  #
@@ -2757,14 +2758,14 @@ module Aws::S3
2757
2758
  # For more information about MFA Delete, see [Using MFA Delete][1]. To
2758
2759
  # see sample requests that use versioning, see [Sample Request][2].
2759
2760
  #
2760
- # You can delete objects by explicitly calling the DELETE Object API or
2761
+ # You can delete objects by explicitly calling DELETE Object or
2761
2762
  # configure its lifecycle ([PutBucketLifecycle][3]) to enable Amazon S3
2762
2763
  # to remove them for you. If you want to block users or accounts from
2763
2764
  # removing or deleting objects from your bucket, you must deny them the
2764
2765
  # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
2765
2766
  # `s3:PutLifeCycleConfiguration` actions.
2766
2767
  #
2767
- # The following operation is related to `DeleteObject`\:
2768
+ # The following action is related to `DeleteObject`\:
2768
2769
  #
2769
2770
  # * [PutObject][4]
2770
2771
  #
@@ -2780,27 +2781,27 @@ module Aws::S3
2780
2781
  # @option params [required, String] :bucket
2781
2782
  # The bucket name of the bucket containing the object.
2782
2783
  #
2783
- # When using this API with an access point, you must direct requests to
2784
- # the access point hostname. The access point hostname takes the form
2784
+ # When using this action with an access point, you must direct requests
2785
+ # to the access point hostname. The access point hostname takes the form
2785
2786
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2786
- # When using this operation with an access point through the AWS SDKs,
2787
- # you provide the access point ARN in place of the bucket name. For more
2787
+ # When using this action with an access point through the AWS SDKs, you
2788
+ # provide the access point ARN in place of the bucket name. For more
2788
2789
  # information about access point ARNs, see [Using Access Points][1] in
2789
2790
  # the *Amazon Simple Storage Service Developer Guide*.
2790
2791
  #
2791
- # When using this API with Amazon S3 on Outposts, you must direct
2792
+ # When using this action with Amazon S3 on Outposts, you must direct
2792
2793
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2793
2794
  # takes the form
2794
2795
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
2795
- # When using this operation using S3 on Outposts through the AWS SDKs,
2796
- # you provide the Outposts bucket ARN in place of the bucket name. For
2797
- # more information about S3 on Outposts ARNs, see [Using S3 on
2798
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2796
+ # When using this action using S3 on Outposts through the AWS SDKs, you
2797
+ # provide the Outposts bucket ARN in place of the bucket name. For more
2798
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2799
+ # in the *Amazon Simple Storage Service Developer Guide*.
2799
2800
  #
2800
2801
  #
2801
2802
  #
2802
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2803
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2803
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2804
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2804
2805
  #
2805
2806
  # @option params [required, String] :key
2806
2807
  # Key name of the object to delete.
@@ -2830,7 +2831,7 @@ module Aws::S3
2830
2831
  # restrictions to process this operation.
2831
2832
  #
2832
2833
  # @option params [String] :expected_bucket_owner
2833
- # The account id of the expected bucket owner. If the bucket is owned by
2834
+ # The account ID of the expected bucket owner. If the bucket is owned by
2834
2835
  # a different account, the request will fail with an HTTP `403 (Access
2835
2836
  # Denied)` error.
2836
2837
  #
@@ -2916,36 +2917,37 @@ module Aws::S3
2916
2917
  # @option params [required, String] :bucket
2917
2918
  # The bucket name containing the objects from which to remove the tags.
2918
2919
  #
2919
- # When using this API with an access point, you must direct requests to
2920
- # the access point hostname. The access point hostname takes the form
2920
+ # When using this action with an access point, you must direct requests
2921
+ # to the access point hostname. The access point hostname takes the form
2921
2922
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2922
- # When using this operation with an access point through the AWS SDKs,
2923
- # you provide the access point ARN in place of the bucket name. For more
2923
+ # When using this action with an access point through the AWS SDKs, you
2924
+ # provide the access point ARN in place of the bucket name. For more
2924
2925
  # information about access point ARNs, see [Using Access Points][1] in
2925
2926
  # the *Amazon Simple Storage Service Developer Guide*.
2926
2927
  #
2927
- # When using this API with Amazon S3 on Outposts, you must direct
2928
+ # When using this action with Amazon S3 on Outposts, you must direct
2928
2929
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2929
2930
  # takes the form
2930
2931
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
2931
- # When using this operation using S3 on Outposts through the AWS SDKs,
2932
- # you provide the Outposts bucket ARN in place of the bucket name. For
2933
- # more information about S3 on Outposts ARNs, see [Using S3 on
2934
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2932
+ # When using this action using S3 on Outposts through the AWS SDKs, you
2933
+ # provide the Outposts bucket ARN in place of the bucket name. For more
2934
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2935
+ # in the *Amazon Simple Storage Service Developer Guide*.
2935
2936
  #
2936
2937
  #
2937
2938
  #
2938
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2939
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2939
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2940
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2940
2941
  #
2941
2942
  # @option params [required, String] :key
2942
- # Name of the object key.
2943
+ # The key that identifies the object in the bucket from which to remove
2944
+ # all tags.
2943
2945
  #
2944
2946
  # @option params [String] :version_id
2945
2947
  # The versionId of the object that the tag-set will be removed from.
2946
2948
  #
2947
2949
  # @option params [String] :expected_bucket_owner
2948
- # The account id of the expected bucket owner. If the bucket is owned by
2950
+ # The account ID of the expected bucket owner. If the bucket is owned by
2949
2951
  # a different account, the request will fail with an HTTP `403 (Access
2950
2952
  # Denied)` error.
2951
2953
  #
@@ -2954,35 +2956,35 @@ module Aws::S3
2954
2956
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
2955
2957
  #
2956
2958
  #
2957
- # @example Example: To remove tag set from an object version
2959
+ # @example Example: To remove tag set from an object
2958
2960
  #
2959
- # # The following example removes tag set associated with the specified object version. The request specifies both the
2960
- # # object key and object version.
2961
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2962
+ # # operation removes tag set from the latest object version.
2961
2963
  #
2962
2964
  # resp = client.delete_object_tagging({
2963
2965
  # bucket: "examplebucket",
2964
2966
  # key: "HappyFace.jpg",
2965
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2966
2967
  # })
2967
2968
  #
2968
2969
  # resp.to_h outputs the following:
2969
2970
  # {
2970
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2971
+ # version_id: "null",
2971
2972
  # }
2972
2973
  #
2973
- # @example Example: To remove tag set from an object
2974
+ # @example Example: To remove tag set from an object version
2974
2975
  #
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.
2976
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
2977
+ # # object key and object version.
2977
2978
  #
2978
2979
  # resp = client.delete_object_tagging({
2979
2980
  # bucket: "examplebucket",
2980
2981
  # key: "HappyFace.jpg",
2982
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2981
2983
  # })
2982
2984
  #
2983
2985
  # resp.to_h outputs the following:
2984
2986
  # {
2985
- # version_id: "null",
2987
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2986
2988
  # }
2987
2989
  #
2988
2990
  # @example Request syntax with placeholder values
@@ -3007,27 +3009,27 @@ module Aws::S3
3007
3009
  req.send_request(options)
3008
3010
  end
3009
3011
 
3010
- # This operation enables you to delete multiple objects from a bucket
3011
- # using a single HTTP request. If you know the object keys that you want
3012
- # to delete, then this operation provides a suitable alternative to
3013
- # sending individual delete requests, reducing per-request overhead.
3012
+ # This action enables you to delete multiple objects from a bucket using
3013
+ # a single HTTP request. If you know the object keys that you want to
3014
+ # delete, then this action provides a suitable alternative to sending
3015
+ # individual delete requests, reducing per-request overhead.
3014
3016
  #
3015
3017
  # The request contains a list of up to 1000 keys that you want to
3016
3018
  # delete. In the XML, you provide the object key names, and optionally,
3017
3019
  # version IDs if you want to delete a specific version of the object
3018
3020
  # from a versioning-enabled bucket. For each key, Amazon S3 performs a
3019
- # delete operation and returns the result of that delete, success, or
3021
+ # delete action and returns the result of that delete, success, or
3020
3022
  # failure, in the response. Note that if the object specified in the
3021
3023
  # request is not found, Amazon S3 returns the result as deleted.
3022
3024
  #
3023
- # The operation supports two modes for the response: verbose and quiet.
3024
- # By default, the operation uses verbose mode in which the response
3025
- # includes the result of deletion of each key in your request. In quiet
3026
- # mode the response includes only keys where the delete operation
3027
- # encountered an error. For a successful deletion, the operation does
3028
- # not return any information about the delete in the response body.
3025
+ # The action supports two modes for the response: verbose and quiet. By
3026
+ # default, the action uses verbose mode in which the response includes
3027
+ # the result of deletion of each key in your request. In quiet mode the
3028
+ # response includes only keys where the delete action encountered an
3029
+ # error. For a successful deletion, the action does not return any
3030
+ # information about the delete in the response body.
3029
3031
  #
3030
- # When performing this operation on an MFA Delete enabled bucket, that
3032
+ # When performing this action on an MFA Delete enabled bucket, that
3031
3033
  # attempts to delete any versioned objects, you must include an MFA
3032
3034
  # token. If you do not provide one, the entire request will fail, even
3033
3035
  # if there are non-versioned objects you are trying to delete. If you
@@ -3063,27 +3065,27 @@ module Aws::S3
3063
3065
  # @option params [required, String] :bucket
3064
3066
  # The bucket name containing the objects to delete.
3065
3067
  #
3066
- # When using this API with an access point, you must direct requests to
3067
- # the access point hostname. The access point hostname takes the form
3068
+ # When using this action with an access point, you must direct requests
3069
+ # to the access point hostname. The access point hostname takes the form
3068
3070
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
3069
- # When using this operation with an access point through the AWS SDKs,
3070
- # you provide the access point ARN in place of the bucket name. For more
3071
+ # When using this action with an access point through the AWS SDKs, you
3072
+ # provide the access point ARN in place of the bucket name. For more
3071
3073
  # information about access point ARNs, see [Using Access Points][1] in
3072
3074
  # the *Amazon Simple Storage Service Developer Guide*.
3073
3075
  #
3074
- # When using this API with Amazon S3 on Outposts, you must direct
3076
+ # When using this action with Amazon S3 on Outposts, you must direct
3075
3077
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
3076
3078
  # takes the form
3077
3079
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
3078
- # When using this operation using S3 on Outposts through the AWS SDKs,
3079
- # you provide the Outposts bucket ARN in place of the bucket name. For
3080
- # more information about S3 on Outposts ARNs, see [Using S3 on
3081
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
3080
+ # When using this action using S3 on Outposts through the AWS SDKs, you
3081
+ # provide the Outposts bucket ARN in place of the bucket name. For more
3082
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
3083
+ # in the *Amazon Simple Storage Service Developer Guide*.
3082
3084
  #
3083
3085
  #
3084
3086
  #
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
3087
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
3088
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
3087
3089
  #
3088
3090
  # @option params [required, Types::Delete] :delete
3089
3091
  # Container for the request.
@@ -3111,7 +3113,7 @@ module Aws::S3
3111
3113
  # permissions to perform this operation.
3112
3114
  #
3113
3115
  # @option params [String] :expected_bucket_owner
3114
- # The account id of the expected bucket owner. If the bucket is owned by
3116
+ # The account ID of the expected bucket owner. If the bucket is owned by
3115
3117
  # a different account, the request will fail with an HTTP `403 (Access
3116
3118
  # Denied)` error.
3117
3119
  #
@@ -3255,8 +3257,8 @@ module Aws::S3
3255
3257
  #
3256
3258
  #
3257
3259
  #
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
3260
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3261
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3260
3262
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
3261
3263
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
3262
3264
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
@@ -3267,7 +3269,7 @@ module Aws::S3
3267
3269
  # to delete.
3268
3270
  #
3269
3271
  # @option params [String] :expected_bucket_owner
3270
- # The account id of the expected bucket owner. If the bucket is owned by
3272
+ # The account ID of the expected bucket owner. If the bucket is owned by
3271
3273
  # a different account, the request will fail with an HTTP `403 (Access
3272
3274
  # Denied)` error.
3273
3275
  #
@@ -3289,7 +3291,7 @@ module Aws::S3
3289
3291
  req.send_request(options)
3290
3292
  end
3291
3293
 
3292
- # This implementation of the GET operation uses the `accelerate`
3294
+ # This implementation of the GET action uses the `accelerate`
3293
3295
  # subresource to return the Transfer Acceleration state of a bucket,
3294
3296
  # which is either `Enabled` or `Suspended`. Amazon S3 Transfer
3295
3297
  # Acceleration is a bucket-level feature that enables you to perform
@@ -3300,8 +3302,8 @@ module Aws::S3
3300
3302
  # permission by default. The bucket owner can grant this permission to
3301
3303
  # others. For more information about permissions, see [Permissions
3302
3304
  # Related to Bucket Subresource Operations][1] and [Managing Access
3303
- # Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
3304
- # Storage Service Developer Guide*.
3305
+ # Permissions to your Amazon S3 Resources][2] in the *Amazon S3 User
3306
+ # Guide*.
3305
3307
  #
3306
3308
  # You set the Transfer Acceleration state of an existing bucket to
3307
3309
  # `Enabled` or `Suspended` by using the
@@ -3312,7 +3314,7 @@ module Aws::S3
3312
3314
  # Acceleration state if a state has never been set on the bucket.
3313
3315
  #
3314
3316
  # For more information about transfer acceleration, see [Transfer
3315
- # Acceleration][4] in the Amazon Simple Storage Service Developer Guide.
3317
+ # Acceleration][4] in the Amazon S3 User Guide.
3316
3318
  #
3317
3319
  # **Related Resources**
3318
3320
  #
@@ -3322,8 +3324,8 @@ module Aws::S3
3322
3324
  #
3323
3325
  #
3324
3326
  #
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
3327
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3328
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3327
3329
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html
3328
3330
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
3329
3331
  #
@@ -3332,7 +3334,7 @@ module Aws::S3
3332
3334
  # retrieved.
3333
3335
  #
3334
3336
  # @option params [String] :expected_bucket_owner
3335
- # The account id of the expected bucket owner. If the bucket is owned by
3337
+ # The account ID of the expected bucket owner. If the bucket is owned by
3336
3338
  # a different account, the request will fail with an HTTP `403 (Access
3337
3339
  # Denied)` error.
3338
3340
  #
@@ -3360,8 +3362,8 @@ module Aws::S3
3360
3362
  req.send_request(options)
3361
3363
  end
3362
3364
 
3363
- # This implementation of the `GET` operation uses the `acl` subresource
3364
- # to return the access control list (ACL) of a bucket. To use `GET` to
3365
+ # This implementation of the `GET` action uses the `acl` subresource to
3366
+ # return the access control list (ACL) of a bucket. To use `GET` to
3365
3367
  # return the ACL of the bucket, you must have `READ_ACP` access to the
3366
3368
  # bucket. If `READ_ACP` permission is granted to the anonymous user, you
3367
3369
  # can return the ACL of the bucket without using an authorization
@@ -3381,7 +3383,7 @@ module Aws::S3
3381
3383
  # Specifies the S3 bucket whose ACL is being requested.
3382
3384
  #
3383
3385
  # @option params [String] :expected_bucket_owner
3384
- # The account id of the expected bucket owner. If the bucket is owned by
3386
+ # The account ID of the expected bucket owner. If the bucket is owned by
3385
3387
  # a different account, the request will fail with an HTTP `403 (Access
3386
3388
  # Denied)` error.
3387
3389
  #
@@ -3418,7 +3420,7 @@ module Aws::S3
3418
3420
  req.send_request(options)
3419
3421
  end
3420
3422
 
3421
- # This implementation of the GET operation returns an analytics
3423
+ # This implementation of the GET action returns an analytics
3422
3424
  # configuration (identified by the analytics configuration ID) from the
3423
3425
  # bucket.
3424
3426
  #
@@ -3427,12 +3429,11 @@ module Aws::S3
3427
3429
  # permission by default. The bucket owner can grant this permission to
3428
3430
  # others. For more information about permissions, see [ Permissions
3429
3431
  # Related to Bucket Subresource Operations][1] and [Managing Access
3430
- # Permissions to Your Amazon S3 Resources][2] in the *Amazon Simple
3431
- # Storage Service Developer Guide*.
3432
+ # Permissions to Your Amazon S3 Resources][2] in the *Amazon S3 User
3433
+ # Guide*.
3432
3434
  #
3433
3435
  # For information about Amazon S3 analytics feature, see [Amazon S3
3434
- # Analytics – Storage Class Analysis][3] in the *Amazon Simple Storage
3435
- # Service Developer Guide*.
3436
+ # Analytics – Storage Class Analysis][3] in the *Amazon S3 User Guide*.
3436
3437
  #
3437
3438
  # **Related Resources**
3438
3439
  #
@@ -3444,8 +3445,8 @@ module Aws::S3
3444
3445
  #
3445
3446
  #
3446
3447
  #
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
3448
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3449
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3449
3450
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
3450
3451
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
3451
3452
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -3459,7 +3460,7 @@ module Aws::S3
3459
3460
  # The ID that identifies the analytics configuration.
3460
3461
  #
3461
3462
  # @option params [String] :expected_bucket_owner
3462
- # The account id of the expected bucket owner. If the bucket is owned by
3463
+ # The account ID of the expected bucket owner. If the bucket is owned by
3463
3464
  # a different account, the request will fail with an HTTP `403 (Access
3464
3465
  # Denied)` error.
3465
3466
  #
@@ -3525,7 +3526,7 @@ module Aws::S3
3525
3526
  # The bucket name for which to get the cors configuration.
3526
3527
  #
3527
3528
  # @option params [String] :expected_bucket_owner
3528
- # The account id of the expected bucket owner. If the bucket is owned by
3529
+ # The account ID of the expected bucket owner. If the bucket is owned by
3529
3530
  # a different account, the request will fail with an HTTP `403 (Access
3530
3531
  # Denied)` error.
3531
3532
  #
@@ -3570,6 +3571,7 @@ module Aws::S3
3570
3571
  # @example Response structure
3571
3572
  #
3572
3573
  # resp.cors_rules #=> Array
3574
+ # resp.cors_rules[0].id #=> String
3573
3575
  # resp.cors_rules[0].allowed_headers #=> Array
3574
3576
  # resp.cors_rules[0].allowed_headers[0] #=> String
3575
3577
  # resp.cors_rules[0].allowed_methods #=> Array
@@ -3590,6 +3592,10 @@ module Aws::S3
3590
3592
  end
3591
3593
 
3592
3594
  # Returns the default encryption configuration for an Amazon S3 bucket.
3595
+ # If the bucket does not have a default encryption configuration,
3596
+ # GetBucketEncryption returns
3597
+ # `ServerSideEncryptionConfigurationNotFoundError`.
3598
+ #
3593
3599
  # For information about the Amazon S3 default encryption feature, see
3594
3600
  # [Amazon S3 Default Bucket Encryption][1].
3595
3601
  #
@@ -3609,8 +3615,8 @@ module Aws::S3
3609
3615
  #
3610
3616
  #
3611
3617
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
3612
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3613
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3618
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3619
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3614
3620
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
3615
3621
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
3616
3622
  #
@@ -3619,7 +3625,7 @@ module Aws::S3
3619
3625
  # configuration is retrieved.
3620
3626
  #
3621
3627
  # @option params [String] :expected_bucket_owner
3622
- # The account id of the expected bucket owner. If the bucket is owned by
3628
+ # The account ID of the expected bucket owner. If the bucket is owned by
3623
3629
  # a different account, the request will fail with an HTTP `403 (Access
3624
3630
  # Denied)` error.
3625
3631
  #
@@ -3753,8 +3759,8 @@ module Aws::S3
3753
3759
  #
3754
3760
  #
3755
3761
  #
3756
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3757
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3762
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3763
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3758
3764
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
3759
3765
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
3760
3766
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -3768,7 +3774,7 @@ module Aws::S3
3768
3774
  # The ID used to identify the inventory configuration.
3769
3775
  #
3770
3776
  # @option params [String] :expected_bucket_owner
3771
- # The account id of the expected bucket owner. If the bucket is owned by
3777
+ # The account ID of the expected bucket owner. If the bucket is owned by
3772
3778
  # a different account, the request will fail with an HTTP `403 (Access
3773
3779
  # Denied)` error.
3774
3780
  #
@@ -3847,8 +3853,8 @@ module Aws::S3
3847
3853
  #
3848
3854
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
3849
3855
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3850
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3851
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3856
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3857
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3852
3858
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3853
3859
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3854
3860
  #
@@ -3856,7 +3862,7 @@ module Aws::S3
3856
3862
  # The name of the bucket for which to get the lifecycle information.
3857
3863
  #
3858
3864
  # @option params [String] :expected_bucket_owner
3859
- # The account id of the expected bucket owner. If the bucket is owned by
3865
+ # The account ID of the expected bucket owner. If the bucket is owned by
3860
3866
  # a different account, the request will fail with an HTTP `403 (Access
3861
3867
  # Denied)` error.
3862
3868
  #
@@ -3926,7 +3932,7 @@ module Aws::S3
3926
3932
  # API. The response describes the new filter element that you can use to
3927
3933
  # specify a filter to select a subset of objects to which the rule
3928
3934
  # applies. If you are using a previous version of the lifecycle
3929
- # configuration, it still works. For the earlier API description, see
3935
+ # configuration, it still works. For the earlier action, see
3930
3936
  # [GetBucketLifecycle][1].
3931
3937
  #
3932
3938
  # </note>
@@ -3965,8 +3971,8 @@ module Aws::S3
3965
3971
  #
3966
3972
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
3967
3973
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3968
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3969
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3974
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3975
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3970
3976
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3971
3977
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3972
3978
  #
@@ -3974,7 +3980,7 @@ module Aws::S3
3974
3980
  # The name of the bucket for which to get the lifecycle information.
3975
3981
  #
3976
3982
  # @option params [String] :expected_bucket_owner
3977
- # The account id of the expected bucket owner. If the bucket is owned by
3983
+ # The account ID of the expected bucket owner. If the bucket is owned by
3978
3984
  # a different account, the request will fail with an HTTP `403 (Access
3979
3985
  # Denied)` error.
3980
3986
  #
@@ -4072,7 +4078,7 @@ module Aws::S3
4072
4078
  # The name of the bucket for which to get the location.
4073
4079
  #
4074
4080
  # @option params [String] :expected_bucket_owner
4075
- # The account id of the expected bucket owner. If the bucket is owned by
4081
+ # The account ID of the expected bucket owner. If the bucket is owned by
4076
4082
  # a different account, the request will fail with an HTTP `403 (Access
4077
4083
  # Denied)` error.
4078
4084
  #
@@ -4133,7 +4139,7 @@ module Aws::S3
4133
4139
  # The bucket name for which to get the logging information.
4134
4140
  #
4135
4141
  # @option params [String] :expected_bucket_owner
4136
- # The account id of the expected bucket owner. If the bucket is owned by
4142
+ # The account ID of the expected bucket owner. If the bucket is owned by
4137
4143
  # a different account, the request will fail with an HTTP `403 (Access
4138
4144
  # Denied)` error.
4139
4145
  #
@@ -4196,8 +4202,8 @@ module Aws::S3
4196
4202
  #
4197
4203
  #
4198
4204
  #
4199
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4200
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
4205
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4206
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4201
4207
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
4202
4208
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
4203
4209
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
@@ -4211,7 +4217,7 @@ module Aws::S3
4211
4217
  # The ID used to identify the metrics configuration.
4212
4218
  #
4213
4219
  # @option params [String] :expected_bucket_owner
4214
- # The account id of the expected bucket owner. If the bucket is owned by
4220
+ # The account ID of the expected bucket owner. If the bucket is owned by
4215
4221
  # a different account, the request will fail with an HTTP `403 (Access
4216
4222
  # Denied)` error.
4217
4223
  #
@@ -4258,7 +4264,7 @@ module Aws::S3
4258
4264
  # configuration.
4259
4265
  #
4260
4266
  # @option params [String] :expected_bucket_owner
4261
- # The account id of the expected bucket owner. If the bucket is owned by
4267
+ # The account ID of the expected bucket owner. If the bucket is owned by
4262
4268
  # a different account, the request will fail with an HTTP `403 (Access
4263
4269
  # Denied)` error.
4264
4270
  #
@@ -4362,8 +4368,8 @@ module Aws::S3
4362
4368
 
4363
4369
  # Returns the notification configuration of a bucket.
4364
4370
  #
4365
- # If notifications are not enabled on the bucket, the operation returns
4366
- # an empty `NotificationConfiguration` element.
4371
+ # If notifications are not enabled on the bucket, the action returns an
4372
+ # empty `NotificationConfiguration` element.
4367
4373
  #
4368
4374
  # By default, you must be the bucket owner to read the notification
4369
4375
  # configuration of a bucket. However, the bucket owner can use a bucket
@@ -4375,7 +4381,7 @@ module Aws::S3
4375
4381
  # Events][1]. For more information about bucket policies, see [Using
4376
4382
  # Bucket Policies][2].
4377
4383
  #
4378
- # The following operation is related to `GetBucketNotification`\:
4384
+ # The following action is related to `GetBucketNotification`\:
4379
4385
  #
4380
4386
  # * [PutBucketNotification][3]
4381
4387
  #
@@ -4392,7 +4398,7 @@ module Aws::S3
4392
4398
  # configuration.
4393
4399
  #
4394
4400
  # @option params [String] :expected_bucket_owner
4395
- # The account id of the expected bucket owner. If the bucket is owned by
4401
+ # The account ID of the expected bucket owner. If the bucket is owned by
4396
4402
  # a different account, the request will fail with an HTTP `403 (Access
4397
4403
  # Denied)` error.
4398
4404
  #
@@ -4469,7 +4475,7 @@ module Aws::S3
4469
4475
  # retrieve.
4470
4476
  #
4471
4477
  # @option params [String] :expected_bucket_owner
4472
- # The account id of the expected bucket owner. If the bucket is owned by
4478
+ # The account ID of the expected bucket owner. If the bucket is owned by
4473
4479
  # a different account, the request will fail with an HTTP `403 (Access
4474
4480
  # Denied)` error.
4475
4481
  #
@@ -4516,7 +4522,7 @@ module Aws::S3
4516
4522
  # For more information about bucket policies, see [Using Bucket Policies
4517
4523
  # and User Policies][1].
4518
4524
  #
4519
- # The following operation is related to `GetBucketPolicy`\:
4525
+ # The following action is related to `GetBucketPolicy`\:
4520
4526
  #
4521
4527
  # * [GetObject][2]
4522
4528
  #
@@ -4531,7 +4537,7 @@ module Aws::S3
4531
4537
  # The bucket name for which to get the bucket policy.
4532
4538
  #
4533
4539
  # @option params [String] :expected_bucket_owner
4534
- # The account id of the expected bucket owner. If the bucket is owned by
4540
+ # The account ID of the expected bucket owner. If the bucket is owned by
4535
4541
  # a different account, the request will fail with an HTTP `403 (Access
4536
4542
  # Denied)` error.
4537
4543
  #
@@ -4606,7 +4612,7 @@ module Aws::S3
4606
4612
  # retrieve.
4607
4613
  #
4608
4614
  # @option params [String] :expected_bucket_owner
4609
- # The account id of the expected bucket owner. If the bucket is owned by
4615
+ # The account ID of the expected bucket owner. If the bucket is owned by
4610
4616
  # a different account, the request will fail with an HTTP `403 (Access
4611
4617
  # Denied)` error.
4612
4618
  #
@@ -4643,9 +4649,9 @@ module Aws::S3
4643
4649
  # </note>
4644
4650
  #
4645
4651
  # For information about replication configuration, see [Replication][1]
4646
- # in the *Amazon Simple Storage Service Developer Guide*.
4652
+ # in the *Amazon S3 User Guide*.
4647
4653
  #
4648
- # This operation requires permissions for the
4654
+ # This action requires permissions for the
4649
4655
  # `s3:GetReplicationConfiguration` action. For more information about
4650
4656
  # permissions, see [Using Bucket Policies and User Policies][2].
4651
4657
  #
@@ -4674,7 +4680,7 @@ module Aws::S3
4674
4680
  # The bucket name for which to get the replication information.
4675
4681
  #
4676
4682
  # @option params [String] :expected_bucket_owner
4677
- # The account id of the expected bucket owner. If the bucket is owned by
4683
+ # The account ID of the expected bucket owner. If the bucket is owned by
4678
4684
  # a different account, the request will fail with an HTTP `403 (Access
4679
4685
  # Denied)` error.
4680
4686
  #
@@ -4773,7 +4779,7 @@ module Aws::S3
4773
4779
  # configuration
4774
4780
  #
4775
4781
  # @option params [String] :expected_bucket_owner
4776
- # The account id of the expected bucket owner. If the bucket is owned by
4782
+ # The account ID of the expected bucket owner. If the bucket is owned by
4777
4783
  # a different account, the request will fail with an HTTP `403 (Access
4778
4784
  # Denied)` error.
4779
4785
  #
@@ -4844,7 +4850,7 @@ module Aws::S3
4844
4850
  # The name of the bucket for which to get the tagging information.
4845
4851
  #
4846
4852
  # @option params [String] :expected_bucket_owner
4847
- # The account id of the expected bucket owner. If the bucket is owned by
4853
+ # The account ID of the expected bucket owner. If the bucket is owned by
4848
4854
  # a different account, the request will fail with an HTTP `403 (Access
4849
4855
  # Denied)` error.
4850
4856
  #
@@ -4925,7 +4931,7 @@ module Aws::S3
4925
4931
  # The name of the bucket for which to get the versioning information.
4926
4932
  #
4927
4933
  # @option params [String] :expected_bucket_owner
4928
- # The account id of the expected bucket owner. If the bucket is owned by
4934
+ # The account ID of the expected bucket owner. If the bucket is owned by
4929
4935
  # a different account, the request will fail with an HTTP `403 (Access
4930
4936
  # Denied)` error.
4931
4937
  #
@@ -4975,7 +4981,7 @@ module Aws::S3
4975
4981
  # configuration. For more information about hosting websites, see
4976
4982
  # [Hosting Websites on Amazon S3][1].
4977
4983
  #
4978
- # This GET operation requires the `S3:GetBucketWebsite` permission. By
4984
+ # This GET action requires the `S3:GetBucketWebsite` permission. By
4979
4985
  # default, only the bucket owner can read the bucket website
4980
4986
  # configuration. However, bucket owners can allow other users to read
4981
4987
  # the website configuration by writing a bucket policy granting them the
@@ -4997,7 +5003,7 @@ module Aws::S3
4997
5003
  # The bucket name for which to get the website configuration.
4998
5004
  #
4999
5005
  # @option params [String] :expected_bucket_owner
5000
- # The account id of the expected bucket owner. If the bucket is owned by
5006
+ # The account ID of the expected bucket owner. If the bucket is owned by
5001
5007
  # a different account, the request will fail with an HTTP `403 (Access
5002
5008
  # Denied)` error.
5003
5009
  #
@@ -5087,9 +5093,9 @@ module Aws::S3
5087
5093
  # Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive
5088
5094
  # or S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve
5089
5095
  # the object you must first restore a copy using [RestoreObject][4].
5090
- # Otherwise, this operation returns an `InvalidObjectStateError` error.
5091
- # For information about restoring archived objects, see [Restoring
5092
- # Archived Objects][5].
5096
+ # Otherwise, this action returns an `InvalidObjectStateError` error. For
5097
+ # information about restoring archived objects, see [Restoring Archived
5098
+ # Objects][5].
5093
5099
  #
5094
5100
  # Encryption request headers, like `x-amz-server-side-encryption`,
5095
5101
  # should not be sent for GET requests if your object uses server-side
@@ -5133,9 +5139,8 @@ module Aws::S3
5133
5139
  #
5134
5140
  # **Versioning**
5135
5141
  #
5136
- # By default, the GET operation returns the current version of an
5137
- # object. To return a different version, use the `versionId`
5138
- # subresource.
5142
+ # By default, the GET action returns the current version of an object.
5143
+ # To return a different version, use the `versionId` subresource.
5139
5144
  #
5140
5145
  # <note markdown="1"> If the current version of the object is a delete marker, Amazon S3
5141
5146
  # behaves as if the object was deleted and includes
@@ -5220,27 +5225,27 @@ module Aws::S3
5220
5225
  # @option params [required, String] :bucket
5221
5226
  # The bucket name containing the object.
5222
5227
  #
5223
- # When using this API with an access point, you must direct requests to
5224
- # the access point hostname. The access point hostname takes the form
5228
+ # When using this action with an access point, you must direct requests
5229
+ # to the access point hostname. The access point hostname takes the form
5225
5230
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5226
- # When using this operation with an access point through the AWS SDKs,
5227
- # you provide the access point ARN in place of the bucket name. For more
5231
+ # When using this action with an access point through the AWS SDKs, you
5232
+ # provide the access point ARN in place of the bucket name. For more
5228
5233
  # information about access point ARNs, see [Using Access Points][1] in
5229
5234
  # the *Amazon Simple Storage Service Developer Guide*.
5230
5235
  #
5231
- # When using this API with Amazon S3 on Outposts, you must direct
5236
+ # When using this action with Amazon S3 on Outposts, you must direct
5232
5237
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5233
5238
  # takes the form
5234
5239
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
5235
- # When using this operation using S3 on Outposts through the AWS SDKs,
5236
- # you provide the Outposts bucket ARN in place of the bucket name. For
5237
- # more information about S3 on Outposts ARNs, see [Using S3 on
5238
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5240
+ # When using this action using S3 on Outposts through the AWS SDKs, you
5241
+ # provide the Outposts bucket ARN in place of the bucket name. For more
5242
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5243
+ # in the *Amazon Simple Storage Service Developer Guide*.
5239
5244
  #
5240
5245
  #
5241
5246
  #
5242
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5243
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5247
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5248
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5244
5249
  #
5245
5250
  # @option params [String] :if_match
5246
5251
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -5297,14 +5302,14 @@ module Aws::S3
5297
5302
  # VersionId used to reference a specific version of the object.
5298
5303
  #
5299
5304
  # @option params [String] :sse_customer_algorithm
5300
- # Specifies the algorithm to use to when encrypting the object (for
5305
+ # Specifies the algorithm to use to when decrypting the object (for
5301
5306
  # example, AES256).
5302
5307
  #
5303
5308
  # @option params [String] :sse_customer_key
5304
- # Specifies the customer-provided encryption key for Amazon S3 to use in
5305
- # encrypting data. This value is used to store the object and then it is
5306
- # discarded; Amazon S3 does not store the encryption key. The key must
5307
- # be appropriate for use with the algorithm specified in the
5309
+ # Specifies the customer-provided encryption key for Amazon S3 used to
5310
+ # encrypt the data. This value is used to decrypt the object when
5311
+ # recovering it and must match the one used when storing the data. The
5312
+ # key must be appropriate for use with the algorithm specified in the
5308
5313
  # `x-amz-server-side-encryption-customer-algorithm` header.
5309
5314
  #
5310
5315
  # @option params [String] :sse_customer_key_md5
@@ -5330,7 +5335,7 @@ module Aws::S3
5330
5335
  # object.
5331
5336
  #
5332
5337
  # @option params [String] :expected_bucket_owner
5333
- # The account id of the expected bucket owner. If the bucket is owned by
5338
+ # The account ID of the expected bucket owner. If the bucket is owned by
5334
5339
  # a different account, the request will fail with an HTTP `403 (Access
5335
5340
  # Denied)` error.
5336
5341
  #
@@ -5371,49 +5376,49 @@ module Aws::S3
5371
5376
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
5372
5377
  #
5373
5378
  #
5374
- # @example Example: To retrieve a byte range of an object
5379
+ # @example Example: To retrieve an object
5375
5380
  #
5376
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
5377
- # # specific byte range.
5381
+ # # The following example retrieves an object for an S3 bucket.
5378
5382
  #
5379
5383
  # resp = client.get_object({
5380
5384
  # bucket: "examplebucket",
5381
- # key: "SampleFile.txt",
5382
- # range: "bytes=0-9",
5385
+ # key: "HappyFace.jpg",
5383
5386
  # })
5384
5387
  #
5385
5388
  # resp.to_h outputs the following:
5386
5389
  # {
5387
5390
  # accept_ranges: "bytes",
5388
- # content_length: 10,
5389
- # content_range: "bytes 0-9/43",
5390
- # content_type: "text/plain",
5391
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
5392
- # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
5391
+ # content_length: 3191,
5392
+ # content_type: "image/jpeg",
5393
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
5394
+ # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
5393
5395
  # metadata: {
5394
5396
  # },
5397
+ # tag_count: 2,
5395
5398
  # version_id: "null",
5396
5399
  # }
5397
5400
  #
5398
- # @example Example: To retrieve an object
5401
+ # @example Example: To retrieve a byte range of an object
5399
5402
  #
5400
- # # The following example retrieves an object for an S3 bucket.
5403
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
5404
+ # # specific byte range.
5401
5405
  #
5402
5406
  # resp = client.get_object({
5403
5407
  # bucket: "examplebucket",
5404
- # key: "HappyFace.jpg",
5408
+ # key: "SampleFile.txt",
5409
+ # range: "bytes=0-9",
5405
5410
  # })
5406
5411
  #
5407
5412
  # resp.to_h outputs the following:
5408
5413
  # {
5409
5414
  # accept_ranges: "bytes",
5410
- # content_length: 3191,
5411
- # content_type: "image/jpeg",
5412
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
5413
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
5415
+ # content_length: 10,
5416
+ # content_range: "bytes 0-9/43",
5417
+ # content_type: "text/plain",
5418
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
5419
+ # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
5414
5420
  # metadata: {
5415
5421
  # },
5416
- # tag_count: 2,
5417
5422
  # version_id: "null",
5418
5423
  # }
5419
5424
  #
@@ -5546,17 +5551,17 @@ module Aws::S3
5546
5551
  # The bucket name that contains the object for which to get the ACL
5547
5552
  # information.
5548
5553
  #
5549
- # When using this API with an access point, you must direct requests to
5550
- # the access point hostname. The access point hostname takes the form
5554
+ # When using this action with an access point, you must direct requests
5555
+ # to the access point hostname. The access point hostname takes the form
5551
5556
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5552
- # When using this operation with an access point through the AWS SDKs,
5553
- # you provide the access point ARN in place of the bucket name. For more
5557
+ # When using this action with an access point through the AWS SDKs, you
5558
+ # provide the access point ARN in place of the bucket name. For more
5554
5559
  # information about access point ARNs, see [Using Access Points][1] in
5555
5560
  # the *Amazon Simple Storage Service Developer Guide*.
5556
5561
  #
5557
5562
  #
5558
5563
  #
5559
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5564
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5560
5565
  #
5561
5566
  # @option params [required, String] :key
5562
5567
  # The key of the object for which to get the ACL information.
@@ -5576,7 +5581,7 @@ module Aws::S3
5576
5581
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5577
5582
  #
5578
5583
  # @option params [String] :expected_bucket_owner
5579
- # The account id of the expected bucket owner. If the bucket is owned by
5584
+ # The account ID of the expected bucket owner. If the bucket is owned by
5580
5585
  # a different account, the request will fail with an HTTP `403 (Access
5581
5586
  # Denied)` error.
5582
5587
  #
@@ -5683,17 +5688,17 @@ module Aws::S3
5683
5688
  # The bucket name containing the object whose Legal Hold status you want
5684
5689
  # to retrieve.
5685
5690
  #
5686
- # When using this API with an access point, you must direct requests to
5687
- # the access point hostname. The access point hostname takes the form
5691
+ # When using this action with an access point, you must direct requests
5692
+ # to the access point hostname. The access point hostname takes the form
5688
5693
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5689
- # When using this operation with an access point through the AWS SDKs,
5690
- # you provide the access point ARN in place of the bucket name. For more
5694
+ # When using this action with an access point through the AWS SDKs, you
5695
+ # provide the access point ARN in place of the bucket name. For more
5691
5696
  # information about access point ARNs, see [Using Access Points][1] in
5692
5697
  # the *Amazon Simple Storage Service Developer Guide*.
5693
5698
  #
5694
5699
  #
5695
5700
  #
5696
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5701
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5697
5702
  #
5698
5703
  # @option params [required, String] :key
5699
5704
  # The key name for the object whose Legal Hold status you want to
@@ -5715,7 +5720,7 @@ module Aws::S3
5715
5720
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5716
5721
  #
5717
5722
  # @option params [String] :expected_bucket_owner
5718
- # The account id of the expected bucket owner. If the bucket is owned by
5723
+ # The account ID of the expected bucket owner. If the bucket is owned by
5719
5724
  # a different account, the request will fail with an HTTP `403 (Access
5720
5725
  # Denied)` error.
5721
5726
  #
@@ -5758,20 +5763,20 @@ module Aws::S3
5758
5763
  # @option params [required, String] :bucket
5759
5764
  # The bucket whose Object Lock configuration you want to retrieve.
5760
5765
  #
5761
- # When using this API with an access point, you must direct requests to
5762
- # the access point hostname. The access point hostname takes the form
5766
+ # When using this action with an access point, you must direct requests
5767
+ # to the access point hostname. The access point hostname takes the form
5763
5768
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5764
- # When using this operation with an access point through the AWS SDKs,
5765
- # you provide the access point ARN in place of the bucket name. For more
5769
+ # When using this action with an access point through the AWS SDKs, you
5770
+ # provide the access point ARN in place of the bucket name. For more
5766
5771
  # information about access point ARNs, see [Using Access Points][1] in
5767
5772
  # the *Amazon Simple Storage Service Developer Guide*.
5768
5773
  #
5769
5774
  #
5770
5775
  #
5771
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5776
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5772
5777
  #
5773
5778
  # @option params [String] :expected_bucket_owner
5774
- # The account id of the expected bucket owner. If the bucket is owned by
5779
+ # The account ID of the expected bucket owner. If the bucket is owned by
5775
5780
  # a different account, the request will fail with an HTTP `403 (Access
5776
5781
  # Denied)` error.
5777
5782
  #
@@ -5815,17 +5820,17 @@ module Aws::S3
5815
5820
  # The bucket name containing the object whose retention settings you
5816
5821
  # want to retrieve.
5817
5822
  #
5818
- # When using this API with an access point, you must direct requests to
5819
- # the access point hostname. The access point hostname takes the form
5823
+ # When using this action with an access point, you must direct requests
5824
+ # to the access point hostname. The access point hostname takes the form
5820
5825
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5821
- # When using this operation with an access point through the AWS SDKs,
5822
- # you provide the access point ARN in place of the bucket name. For more
5826
+ # When using this action with an access point through the AWS SDKs, you
5827
+ # provide the access point ARN in place of the bucket name. For more
5823
5828
  # information about access point ARNs, see [Using Access Points][1] in
5824
5829
  # the *Amazon Simple Storage Service Developer Guide*.
5825
5830
  #
5826
5831
  #
5827
5832
  #
5828
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5833
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5829
5834
  #
5830
5835
  # @option params [required, String] :key
5831
5836
  # The key name for the object whose retention settings you want to
@@ -5847,7 +5852,7 @@ module Aws::S3
5847
5852
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5848
5853
  #
5849
5854
  # @option params [String] :expected_bucket_owner
5850
- # The account id of the expected bucket owner. If the bucket is owned by
5855
+ # The account ID of the expected bucket owner. If the bucket is owned by
5851
5856
  # a different account, the request will fail with an HTTP `403 (Access
5852
5857
  # Denied)` error.
5853
5858
  #
@@ -5883,7 +5888,7 @@ module Aws::S3
5883
5888
  # tagging subresource associated with the object.
5884
5889
  #
5885
5890
  # To use this operation, you must have permission to perform the
5886
- # `s3:GetObjectTagging` action. By default, the GET operation returns
5891
+ # `s3:GetObjectTagging` action. By default, the GET action returns
5887
5892
  # information about current version of an object. For a versioned
5888
5893
  # bucket, you can have multiple versions of an object in your bucket. To
5889
5894
  # retrieve tags of any other version, use the versionId query parameter.
@@ -5895,42 +5900,43 @@ module Aws::S3
5895
5900
  # For information about the Amazon S3 object tagging feature, see
5896
5901
  # [Object Tagging][1].
5897
5902
  #
5898
- # The following operation is related to `GetObjectTagging`\:
5903
+ # The following action is related to `GetObjectTagging`\:
5899
5904
  #
5900
5905
  # * [PutObjectTagging][2]
5901
5906
  #
5902
- # ^
5907
+ # * [DeleteObjectTagging][3]
5903
5908
  #
5904
5909
  #
5905
5910
  #
5906
5911
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
5907
5912
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html
5913
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html
5908
5914
  #
5909
5915
  # @option params [required, String] :bucket
5910
5916
  # The bucket name containing the object for which to get the tagging
5911
5917
  # information.
5912
5918
  #
5913
- # When using this API with an access point, you must direct requests to
5914
- # the access point hostname. The access point hostname takes the form
5919
+ # When using this action with an access point, you must direct requests
5920
+ # to the access point hostname. The access point hostname takes the form
5915
5921
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5916
- # When using this operation with an access point through the AWS SDKs,
5917
- # you provide the access point ARN in place of the bucket name. For more
5922
+ # When using this action with an access point through the AWS SDKs, you
5923
+ # provide the access point ARN in place of the bucket name. For more
5918
5924
  # information about access point ARNs, see [Using Access Points][1] in
5919
5925
  # the *Amazon Simple Storage Service Developer Guide*.
5920
5926
  #
5921
- # When using this API with Amazon S3 on Outposts, you must direct
5927
+ # When using this action with Amazon S3 on Outposts, you must direct
5922
5928
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5923
5929
  # takes the form
5924
5930
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
5925
- # When using this operation using S3 on Outposts through the AWS SDKs,
5926
- # you provide the Outposts bucket ARN in place of the bucket name. For
5927
- # more information about S3 on Outposts ARNs, see [Using S3 on
5928
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5931
+ # When using this action using S3 on Outposts through the AWS SDKs, you
5932
+ # provide the Outposts bucket ARN in place of the bucket name. For more
5933
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5934
+ # in the *Amazon Simple Storage Service Developer Guide*.
5929
5935
  #
5930
5936
  #
5931
5937
  #
5932
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5933
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5938
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5939
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5934
5940
  #
5935
5941
  # @option params [required, String] :key
5936
5942
  # Object key for which to get the tagging information.
@@ -5939,59 +5945,70 @@ module Aws::S3
5939
5945
  # The versionId of the object for which to get the tagging information.
5940
5946
  #
5941
5947
  # @option params [String] :expected_bucket_owner
5942
- # The account id of the expected bucket owner. If the bucket is owned by
5948
+ # The account ID of the expected bucket owner. If the bucket is owned by
5943
5949
  # a different account, the request will fail with an HTTP `403 (Access
5944
5950
  # Denied)` error.
5945
5951
  #
5952
+ # @option params [String] :request_payer
5953
+ # Confirms that the requester knows that they will be charged for the
5954
+ # request. Bucket owners need not specify this parameter in their
5955
+ # requests. For information about downloading objects from requester
5956
+ # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5957
+ # in the *Amazon S3 Developer Guide*.
5958
+ #
5959
+ #
5960
+ #
5961
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5962
+ #
5946
5963
  # @return [Types::GetObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5947
5964
  #
5948
5965
  # * {Types::GetObjectTaggingOutput#version_id #version_id} => String
5949
5966
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
5950
5967
  #
5951
5968
  #
5952
- # @example Example: To retrieve tag set of an object
5969
+ # @example Example: To retrieve tag set of a specific object version
5953
5970
  #
5954
- # # The following example retrieves tag set of an object.
5971
+ # # The following example retrieves tag set of an object. The request specifies object version.
5955
5972
  #
5956
5973
  # resp = client.get_object_tagging({
5957
5974
  # bucket: "examplebucket",
5958
- # key: "HappyFace.jpg",
5975
+ # key: "exampleobject",
5976
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5959
5977
  # })
5960
5978
  #
5961
5979
  # resp.to_h outputs the following:
5962
5980
  # {
5963
5981
  # tag_set: [
5964
5982
  # {
5965
- # key: "Key4",
5966
- # value: "Value4",
5967
- # },
5968
- # {
5969
- # key: "Key3",
5970
- # value: "Value3",
5983
+ # key: "Key1",
5984
+ # value: "Value1",
5971
5985
  # },
5972
5986
  # ],
5973
- # version_id: "null",
5987
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5974
5988
  # }
5975
5989
  #
5976
- # @example Example: To retrieve tag set of a specific object version
5990
+ # @example Example: To retrieve tag set of an object
5977
5991
  #
5978
- # # The following example retrieves tag set of an object. The request specifies object version.
5992
+ # # The following example retrieves tag set of an object.
5979
5993
  #
5980
5994
  # resp = client.get_object_tagging({
5981
5995
  # bucket: "examplebucket",
5982
- # key: "exampleobject",
5983
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5996
+ # key: "HappyFace.jpg",
5984
5997
  # })
5985
5998
  #
5986
5999
  # resp.to_h outputs the following:
5987
6000
  # {
5988
6001
  # tag_set: [
5989
6002
  # {
5990
- # key: "Key1",
5991
- # value: "Value1",
6003
+ # key: "Key4",
6004
+ # value: "Value4",
6005
+ # },
6006
+ # {
6007
+ # key: "Key3",
6008
+ # value: "Value3",
5992
6009
  # },
5993
6010
  # ],
5994
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6011
+ # version_id: "null",
5995
6012
  # }
5996
6013
  #
5997
6014
  # @example Request syntax with placeholder values
@@ -6001,6 +6018,7 @@ module Aws::S3
6001
6018
  # key: "ObjectKey", # required
6002
6019
  # version_id: "ObjectVersionId",
6003
6020
  # expected_bucket_owner: "AccountId",
6021
+ # request_payer: "requester", # accepts requester
6004
6022
  # })
6005
6023
  #
6006
6024
  # @example Response structure
@@ -6033,7 +6051,7 @@ module Aws::S3
6033
6051
  #
6034
6052
  # This action is not supported by Amazon S3 on Outposts.
6035
6053
  #
6036
- # The following operation is related to `GetObjectTorrent`\:
6054
+ # The following action is related to `GetObjectTorrent`\:
6037
6055
  #
6038
6056
  # * [GetObject][2]
6039
6057
  #
@@ -6066,7 +6084,7 @@ module Aws::S3
6066
6084
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
6067
6085
  #
6068
6086
  # @option params [String] :expected_bucket_owner
6069
- # The account id of the expected bucket owner. If the bucket is owned by
6087
+ # The account ID of the expected bucket owner. If the bucket is owned by
6070
6088
  # a different account, the request will fail with an HTTP `403 (Access
6071
6089
  # Denied)` error.
6072
6090
  #
@@ -6152,7 +6170,7 @@ module Aws::S3
6152
6170
  # configuration you want to retrieve.
6153
6171
  #
6154
6172
  # @option params [String] :expected_bucket_owner
6155
- # The account id of the expected bucket owner. If the bucket is owned by
6173
+ # The account ID of the expected bucket owner. If the bucket is owned by
6156
6174
  # a different account, the request will fail with an HTTP `403 (Access
6157
6175
  # Denied)` error.
6158
6176
  #
@@ -6183,11 +6201,14 @@ module Aws::S3
6183
6201
  req.send_request(options)
6184
6202
  end
6185
6203
 
6186
- # This operation is useful to determine if a bucket exists and you have
6187
- # permission to access it. The operation returns a `200 OK` if the
6188
- # bucket exists and you have permission to access it. Otherwise, the
6189
- # operation might return responses such as `404 Not Found` and `403
6190
- # Forbidden`.
6204
+ # This action is useful to determine if a bucket exists and you have
6205
+ # permission to access it. The action returns a `200 OK` if the bucket
6206
+ # exists and you have permission to access it.
6207
+ #
6208
+ # If the bucket does not exist or you do not have permission to access
6209
+ # it, the `HEAD` request returns a generic `404 Not Found` or `403
6210
+ # Forbidden` code. A message body is not included, so you cannot
6211
+ # determine the exception beyond these error codes.
6191
6212
  #
6192
6213
  # To use this operation, you must have permissions to perform the
6193
6214
  # `s3:ListBucket` action. The bucket owner has this permission by
@@ -6198,36 +6219,36 @@ module Aws::S3
6198
6219
  #
6199
6220
  #
6200
6221
  #
6201
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6202
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6222
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6223
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6203
6224
  #
6204
6225
  # @option params [required, String] :bucket
6205
6226
  # The bucket name.
6206
6227
  #
6207
- # When using this API with an access point, you must direct requests to
6208
- # the access point hostname. The access point hostname takes the form
6228
+ # When using this action with an access point, you must direct requests
6229
+ # to the access point hostname. The access point hostname takes the form
6209
6230
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6210
- # When using this operation with an access point through the AWS SDKs,
6211
- # you provide the access point ARN in place of the bucket name. For more
6231
+ # When using this action with an access point through the AWS SDKs, you
6232
+ # provide the access point ARN in place of the bucket name. For more
6212
6233
  # information about access point ARNs, see [Using Access Points][1] in
6213
6234
  # the *Amazon Simple Storage Service Developer Guide*.
6214
6235
  #
6215
- # When using this API with Amazon S3 on Outposts, you must direct
6236
+ # When using this action with Amazon S3 on Outposts, you must direct
6216
6237
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6217
6238
  # takes the form
6218
6239
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
6219
- # When using this operation using S3 on Outposts through the AWS SDKs,
6220
- # you provide the Outposts bucket ARN in place of the bucket name. For
6221
- # more information about S3 on Outposts ARNs, see [Using S3 on
6222
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6240
+ # When using this action using S3 on Outposts through the AWS SDKs, you
6241
+ # provide the Outposts bucket ARN in place of the bucket name. For more
6242
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6243
+ # in the *Amazon Simple Storage Service Developer Guide*.
6223
6244
  #
6224
6245
  #
6225
6246
  #
6226
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6227
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6247
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6248
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6228
6249
  #
6229
6250
  # @option params [String] :expected_bucket_owner
6230
- # The account id of the expected bucket owner. If the bucket is owned by
6251
+ # The account ID of the expected bucket owner. If the bucket is owned by
6231
6252
  # a different account, the request will fail with an HTTP `403 (Access
6232
6253
  # Denied)` error.
6233
6254
  #
@@ -6264,14 +6285,17 @@ module Aws::S3
6264
6285
  req.send_request(options)
6265
6286
  end
6266
6287
 
6267
- # The HEAD operation retrieves metadata from an object without returning
6268
- # the object itself. This operation is useful if you're only interested
6269
- # in an object's metadata. To use HEAD, you must have READ access to
6270
- # the object.
6271
- #
6272
- # A `HEAD` request has the same options as a `GET` operation on an
6273
- # object. The response is identical to the `GET` response except that
6274
- # there is no response body.
6288
+ # The HEAD action retrieves metadata from an object without returning
6289
+ # the object itself. This action is useful if you're only interested in
6290
+ # an object's metadata. To use HEAD, you must have READ access to the
6291
+ # object.
6292
+ #
6293
+ # A `HEAD` request has the same options as a `GET` action on an object.
6294
+ # The response is identical to the `GET` response except that there is
6295
+ # no response body. Because of this, if the `HEAD` request generates an
6296
+ # error, it returns a generic `404 Not Found` or `403 Forbidden` code.
6297
+ # It is not possible to retrieve the exact exception beyond these error
6298
+ # codes.
6275
6299
  #
6276
6300
  # If you encrypt an object by using server-side encryption with
6277
6301
  # customer-provided encryption keys (SSE-C) when you store the object in
@@ -6287,12 +6311,15 @@ module Aws::S3
6287
6311
  # For more information about SSE-C, see [Server-Side Encryption (Using
6288
6312
  # Customer-Provided Encryption Keys)][1].
6289
6313
  #
6290
- # <note markdown="1"> Encryption request headers, like `x-amz-server-side-encryption`,
6291
- # should not be sent for GET requests if your object uses server-side
6292
- # encryption with CMKs stored in AWS KMS (SSE-KMS) or server-side
6293
- # encryption with Amazon S3–managed encryption keys (SSE-S3). If your
6294
- # object does use these types of keys, you’ll get an HTTP 400 BadRequest
6295
- # error.
6314
+ # <note markdown="1"> * Encryption request headers, like `x-amz-server-side-encryption`,
6315
+ # should not be sent for GET requests if your object uses server-side
6316
+ # encryption with CMKs stored in AWS KMS (SSE-KMS) or server-side
6317
+ # encryption with Amazon S3–managed encryption keys (SSE-S3). If your
6318
+ # object does use these types of keys, you’ll get an HTTP 400
6319
+ # BadRequest error.
6320
+ #
6321
+ # * The last modified property in this case is the creation date of the
6322
+ # object.
6296
6323
  #
6297
6324
  # </note>
6298
6325
  #
@@ -6334,7 +6361,7 @@ module Aws::S3
6334
6361
  # * If you don’t have the `s3:ListBucket` permission, Amazon S3 returns
6335
6362
  # an HTTP status code 403 ("access denied") error.
6336
6363
  #
6337
- # The following operation is related to `HeadObject`\:
6364
+ # The following action is related to `HeadObject`\:
6338
6365
  #
6339
6366
  # * [GetObject][5]
6340
6367
  #
@@ -6351,27 +6378,27 @@ module Aws::S3
6351
6378
  # @option params [required, String] :bucket
6352
6379
  # The name of the bucket containing the object.
6353
6380
  #
6354
- # When using this API with an access point, you must direct requests to
6355
- # the access point hostname. The access point hostname takes the form
6381
+ # When using this action with an access point, you must direct requests
6382
+ # to the access point hostname. The access point hostname takes the form
6356
6383
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6357
- # When using this operation with an access point through the AWS SDKs,
6358
- # you provide the access point ARN in place of the bucket name. For more
6384
+ # When using this action with an access point through the AWS SDKs, you
6385
+ # provide the access point ARN in place of the bucket name. For more
6359
6386
  # information about access point ARNs, see [Using Access Points][1] in
6360
6387
  # the *Amazon Simple Storage Service Developer Guide*.
6361
6388
  #
6362
- # When using this API with Amazon S3 on Outposts, you must direct
6389
+ # When using this action with Amazon S3 on Outposts, you must direct
6363
6390
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6364
6391
  # takes the form
6365
6392
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
6366
- # When using this operation using S3 on Outposts through the AWS SDKs,
6367
- # you provide the Outposts bucket ARN in place of the bucket name. For
6368
- # more information about S3 on Outposts ARNs, see [Using S3 on
6369
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6393
+ # When using this action using S3 on Outposts through the AWS SDKs, you
6394
+ # provide the Outposts bucket ARN in place of the bucket name. For more
6395
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6396
+ # in the *Amazon Simple Storage Service Developer Guide*.
6370
6397
  #
6371
6398
  #
6372
6399
  #
6373
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6374
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6400
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6401
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6375
6402
  #
6376
6403
  # @option params [String] :if_match
6377
6404
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -6443,7 +6470,7 @@ module Aws::S3
6443
6470
  # the number of parts in this object.
6444
6471
  #
6445
6472
  # @option params [String] :expected_bucket_owner
6446
- # The account id of the expected bucket owner. If the bucket is owned by
6473
+ # The account ID of the expected bucket owner. If the bucket is owned by
6447
6474
  # a different account, the request will fail with an HTTP `403 (Access
6448
6475
  # Denied)` error.
6449
6476
  #
@@ -6575,15 +6602,14 @@ module Aws::S3
6575
6602
  # Lists the analytics configurations for the bucket. You can have up to
6576
6603
  # 1,000 analytics configurations per bucket.
6577
6604
  #
6578
- # This operation supports list pagination and does not return more than
6579
- # 100 configurations at a time. You should always check the
6580
- # `IsTruncated` element in the response. If there are no more
6581
- # configurations to list, `IsTruncated` is set to false. If there are
6582
- # more configurations to list, `IsTruncated` is set to true, and there
6583
- # will be a value in `NextContinuationToken`. You use the
6584
- # `NextContinuationToken` value to continue the pagination of the list
6585
- # by passing the value in continuation-token in the request to `GET` the
6586
- # next page.
6605
+ # This action supports list pagination and does not return more than 100
6606
+ # configurations at a time. You should always check the `IsTruncated`
6607
+ # element in the response. If there are no more configurations to list,
6608
+ # `IsTruncated` is set to false. If there are more configurations to
6609
+ # list, `IsTruncated` is set to true, and there will be a value in
6610
+ # `NextContinuationToken`. You use the `NextContinuationToken` value to
6611
+ # continue the pagination of the list by passing the value in
6612
+ # continuation-token in the request to `GET` the next page.
6587
6613
  #
6588
6614
  # To use this operation, you must have permissions to perform the
6589
6615
  # `s3:GetAnalyticsConfiguration` action. The bucket owner has this
@@ -6606,8 +6632,8 @@ module Aws::S3
6606
6632
  #
6607
6633
  #
6608
6634
  #
6609
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6610
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6635
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6636
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6611
6637
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
6612
6638
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
6613
6639
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
@@ -6622,7 +6648,7 @@ module Aws::S3
6622
6648
  # request should begin.
6623
6649
  #
6624
6650
  # @option params [String] :expected_bucket_owner
6625
- # The account id of the expected bucket owner. If the bucket is owned by
6651
+ # The account ID of the expected bucket owner. If the bucket is owned by
6626
6652
  # a different account, the request will fail with an HTTP `403 (Access
6627
6653
  # Denied)` error.
6628
6654
  #
@@ -6760,9 +6786,9 @@ module Aws::S3
6760
6786
  # Returns a list of inventory configurations for the bucket. You can
6761
6787
  # have up to 1,000 analytics configurations per bucket.
6762
6788
  #
6763
- # This operation supports list pagination and does not return more than
6764
- # 100 configurations at a time. Always check the `IsTruncated` element
6765
- # in the response. If there are no more configurations to list,
6789
+ # This action supports list pagination and does not return more than 100
6790
+ # configurations at a time. Always check the `IsTruncated` element in
6791
+ # the response. If there are no more configurations to list,
6766
6792
  # `IsTruncated` is set to false. If there are more configurations to
6767
6793
  # list, `IsTruncated` is set to true, and there is a value in
6768
6794
  # `NextContinuationToken`. You use the `NextContinuationToken` value to
@@ -6790,8 +6816,8 @@ module Aws::S3
6790
6816
  #
6791
6817
  #
6792
6818
  #
6793
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6794
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6819
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6820
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6795
6821
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
6796
6822
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
6797
6823
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
@@ -6808,7 +6834,7 @@ module Aws::S3
6808
6834
  # token is an opaque value that Amazon S3 understands.
6809
6835
  #
6810
6836
  # @option params [String] :expected_bucket_owner
6811
- # The account id of the expected bucket owner. If the bucket is owned by
6837
+ # The account ID of the expected bucket owner. If the bucket is owned by
6812
6838
  # a different account, the request will fail with an HTTP `403 (Access
6813
6839
  # Denied)` error.
6814
6840
  #
@@ -6860,9 +6886,9 @@ module Aws::S3
6860
6886
  # not provide information on daily storage metrics. You can have up to
6861
6887
  # 1,000 configurations per bucket.
6862
6888
  #
6863
- # This operation supports list pagination and does not return more than
6864
- # 100 configurations at a time. Always check the `IsTruncated` element
6865
- # in the response. If there are no more configurations to list,
6889
+ # This action supports list pagination and does not return more than 100
6890
+ # configurations at a time. Always check the `IsTruncated` element in
6891
+ # the response. If there are no more configurations to list,
6866
6892
  # `IsTruncated` is set to false. If there are more configurations to
6867
6893
  # list, `IsTruncated` is set to true, and there is a value in
6868
6894
  # `NextContinuationToken`. You use the `NextContinuationToken` value to
@@ -6890,8 +6916,8 @@ module Aws::S3
6890
6916
  #
6891
6917
  #
6892
6918
  #
6893
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6894
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6919
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6920
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6895
6921
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
6896
6922
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
6897
6923
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
@@ -6908,7 +6934,7 @@ module Aws::S3
6908
6934
  # continuation token is an opaque value that Amazon S3 understands.
6909
6935
  #
6910
6936
  # @option params [String] :expected_bucket_owner
6911
- # The account id of the expected bucket owner. If the bucket is owned by
6937
+ # The account ID of the expected bucket owner. If the bucket is owned by
6912
6938
  # a different account, the request will fail with an HTTP `403 (Access
6913
6939
  # Denied)` error.
6914
6940
  #
@@ -7008,20 +7034,19 @@ module Aws::S3
7008
7034
  req.send_request(options)
7009
7035
  end
7010
7036
 
7011
- # This operation lists in-progress multipart uploads. An in-progress
7037
+ # This action lists in-progress multipart uploads. An in-progress
7012
7038
  # multipart upload is a multipart upload that has been initiated using
7013
7039
  # the Initiate Multipart Upload request, but has not yet been completed
7014
7040
  # or aborted.
7015
7041
  #
7016
- # This operation returns at most 1,000 multipart uploads in the
7017
- # response. 1,000 multipart uploads is the maximum number of uploads a
7018
- # response can include, which is also the default value. You can further
7019
- # limit the number of uploads in a response by specifying the
7020
- # `max-uploads` parameter in the response. If additional multipart
7021
- # uploads satisfy the list criteria, the response will contain an
7022
- # `IsTruncated` element with the value true. To list the additional
7023
- # multipart uploads, use the `key-marker` and `upload-id-marker` request
7024
- # parameters.
7042
+ # This action returns at most 1,000 multipart uploads in the response.
7043
+ # 1,000 multipart uploads is the maximum number of uploads a response
7044
+ # can include, which is also the default value. You can further limit
7045
+ # the number of uploads in a response by specifying the `max-uploads`
7046
+ # parameter in the response. If additional multipart uploads satisfy the
7047
+ # list criteria, the response will contain an `IsTruncated` element with
7048
+ # the value true. To list the additional multipart uploads, use the
7049
+ # `key-marker` and `upload-id-marker` request parameters.
7025
7050
  #
7026
7051
  # In the response, the uploads are sorted by key. If your application
7027
7052
  # has initiated more than one multipart upload using the same object
@@ -7033,7 +7058,7 @@ module Aws::S3
7033
7058
  # Using Multipart Upload][1].
7034
7059
  #
7035
7060
  # For information on permissions required to use the multipart upload
7036
- # API, see [Multipart Upload API and Permissions][2].
7061
+ # API, see [Multipart Upload and Permissions][2].
7037
7062
  #
7038
7063
  # The following operations are related to `ListMultipartUploads`\:
7039
7064
  #
@@ -7060,27 +7085,27 @@ module Aws::S3
7060
7085
  # @option params [required, String] :bucket
7061
7086
  # The name of the bucket to which the multipart upload was initiated.
7062
7087
  #
7063
- # When using this API with an access point, you must direct requests to
7064
- # the access point hostname. The access point hostname takes the form
7088
+ # When using this action with an access point, you must direct requests
7089
+ # to the access point hostname. The access point hostname takes the form
7065
7090
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7066
- # When using this operation with an access point through the AWS SDKs,
7067
- # you provide the access point ARN in place of the bucket name. For more
7091
+ # When using this action with an access point through the AWS SDKs, you
7092
+ # provide the access point ARN in place of the bucket name. For more
7068
7093
  # information about access point ARNs, see [Using Access Points][1] in
7069
7094
  # the *Amazon Simple Storage Service Developer Guide*.
7070
7095
  #
7071
- # When using this API with Amazon S3 on Outposts, you must direct
7096
+ # When using this action with Amazon S3 on Outposts, you must direct
7072
7097
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7073
7098
  # takes the form
7074
7099
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
7075
- # When using this operation using S3 on Outposts through the AWS SDKs,
7076
- # you provide the Outposts bucket ARN in place of the bucket name. For
7077
- # more information about S3 on Outposts ARNs, see [Using S3 on
7078
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7100
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7101
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7102
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7103
+ # in the *Amazon Simple Storage Service Developer Guide*.
7079
7104
  #
7080
7105
  #
7081
7106
  #
7082
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7083
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7107
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7108
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7084
7109
  #
7085
7110
  # @option params [String] :delimiter
7086
7111
  # Character you use to group keys.
@@ -7133,7 +7158,7 @@ module Aws::S3
7133
7158
  # specified `upload-id-marker`.
7134
7159
  #
7135
7160
  # @option params [String] :expected_bucket_owner
7136
- # The account id of the expected bucket owner. If the bucket is owned by
7161
+ # The account ID of the expected bucket owner. If the bucket is owned by
7137
7162
  # a different account, the request will fail with an HTTP `403 (Access
7138
7163
  # Denied)` error.
7139
7164
  #
@@ -7155,97 +7180,97 @@ module Aws::S3
7155
7180
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7156
7181
  #
7157
7182
  #
7158
- # @example Example: List next set of multipart uploads when previous result is truncated
7183
+ # @example Example: To list in-progress multipart uploads on a bucket
7159
7184
  #
7160
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7161
- # # setup of multipart uploads.
7185
+ # # The following example lists in-progress multipart uploads on a specific bucket.
7162
7186
  #
7163
7187
  # resp = client.list_multipart_uploads({
7164
7188
  # bucket: "examplebucket",
7165
- # key_marker: "nextkeyfrompreviousresponse",
7166
- # max_uploads: 2,
7167
- # upload_id_marker: "valuefrompreviousresponse",
7168
7189
  # })
7169
7190
  #
7170
7191
  # resp.to_h outputs the following:
7171
7192
  # {
7172
- # bucket: "acl1",
7173
- # is_truncated: true,
7174
- # key_marker: "",
7175
- # max_uploads: 2,
7176
- # next_key_marker: "someobjectkey",
7177
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7178
- # upload_id_marker: "",
7179
7193
  # uploads: [
7180
7194
  # {
7181
7195
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7182
7196
  # initiator: {
7183
- # display_name: "ownder-display-name",
7197
+ # display_name: "display-name",
7184
7198
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7185
7199
  # },
7186
7200
  # key: "JavaFile",
7187
7201
  # owner: {
7188
- # display_name: "mohanataws",
7189
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7202
+ # display_name: "display-name",
7203
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7190
7204
  # },
7191
7205
  # storage_class: "STANDARD",
7192
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7206
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7193
7207
  # },
7194
7208
  # {
7195
7209
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7196
7210
  # initiator: {
7197
- # display_name: "ownder-display-name",
7211
+ # display_name: "display-name",
7198
7212
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7199
7213
  # },
7200
7214
  # key: "JavaFile",
7201
7215
  # owner: {
7202
- # display_name: "ownder-display-name",
7216
+ # display_name: "display-name",
7203
7217
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7204
7218
  # },
7205
7219
  # storage_class: "STANDARD",
7206
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7220
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7207
7221
  # },
7208
7222
  # ],
7209
7223
  # }
7210
7224
  #
7211
- # @example Example: To list in-progress multipart uploads on a bucket
7225
+ # @example Example: List next set of multipart uploads when previous result is truncated
7212
7226
  #
7213
- # # The following example lists in-progress multipart uploads on a specific bucket.
7227
+ # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7228
+ # # setup of multipart uploads.
7214
7229
  #
7215
7230
  # resp = client.list_multipart_uploads({
7216
7231
  # bucket: "examplebucket",
7232
+ # key_marker: "nextkeyfrompreviousresponse",
7233
+ # max_uploads: 2,
7234
+ # upload_id_marker: "valuefrompreviousresponse",
7217
7235
  # })
7218
7236
  #
7219
7237
  # resp.to_h outputs the following:
7220
7238
  # {
7239
+ # bucket: "acl1",
7240
+ # is_truncated: true,
7241
+ # key_marker: "",
7242
+ # max_uploads: 2,
7243
+ # next_key_marker: "someobjectkey",
7244
+ # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7245
+ # upload_id_marker: "",
7221
7246
  # uploads: [
7222
7247
  # {
7223
7248
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7224
7249
  # initiator: {
7225
- # display_name: "display-name",
7250
+ # display_name: "ownder-display-name",
7226
7251
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7227
7252
  # },
7228
7253
  # key: "JavaFile",
7229
7254
  # owner: {
7230
- # display_name: "display-name",
7231
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7255
+ # display_name: "mohanataws",
7256
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7232
7257
  # },
7233
7258
  # storage_class: "STANDARD",
7234
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7259
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7235
7260
  # },
7236
7261
  # {
7237
7262
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7238
7263
  # initiator: {
7239
- # display_name: "display-name",
7264
+ # display_name: "ownder-display-name",
7240
7265
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7241
7266
  # },
7242
7267
  # key: "JavaFile",
7243
7268
  # owner: {
7244
- # display_name: "display-name",
7269
+ # display_name: "ownder-display-name",
7245
7270
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7246
7271
  # },
7247
7272
  # storage_class: "STANDARD",
7248
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7273
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7249
7274
  # },
7250
7275
  # ],
7251
7276
  # }
@@ -7351,7 +7376,7 @@ module Aws::S3
7351
7376
  #
7352
7377
  # @option params [Integer] :max_keys
7353
7378
  # Sets the maximum number of keys returned in the response. By default
7354
- # the API returns up to 1,000 key names. The response might contain
7379
+ # the action returns up to 1,000 key names. The response might contain
7355
7380
  # fewer keys but will never contain more. If additional keys satisfy the
7356
7381
  # search criteria, but were not returned because max-keys was exceeded,
7357
7382
  # the response contains &lt;isTruncated&gt;true&lt;/isTruncated&gt;. To
@@ -7369,7 +7394,7 @@ module Aws::S3
7369
7394
  # Specifies the object version you want to start listing from.
7370
7395
  #
7371
7396
  # @option params [String] :expected_bucket_owner
7372
- # The account id of the expected bucket owner. If the bucket is owned by
7397
+ # The account ID of the expected bucket owner. If the bucket is owned by
7373
7398
  # a different account, the request will fail with an HTTP `403 (Access
7374
7399
  # Denied)` error.
7375
7400
  #
@@ -7495,7 +7520,7 @@ module Aws::S3
7495
7520
  # invalid XML. Be sure to design your application to parse the contents
7496
7521
  # of the response and handle it appropriately.
7497
7522
  #
7498
- # This API has been revised. We recommend that you use the newer
7523
+ # This action has been revised. We recommend that you use the newer
7499
7524
  # version, [ListObjectsV2][1], when developing applications. For
7500
7525
  # backward compatibility, Amazon S3 continues to support `ListObjects`.
7501
7526
  #
@@ -7522,27 +7547,27 @@ module Aws::S3
7522
7547
  # @option params [required, String] :bucket
7523
7548
  # The name of the bucket containing the objects.
7524
7549
  #
7525
- # When using this API with an access point, you must direct requests to
7526
- # the access point hostname. The access point hostname takes the form
7550
+ # When using this action with an access point, you must direct requests
7551
+ # to the access point hostname. The access point hostname takes the form
7527
7552
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7528
- # When using this operation with an access point through the AWS SDKs,
7529
- # you provide the access point ARN in place of the bucket name. For more
7553
+ # When using this action with an access point through the AWS SDKs, you
7554
+ # provide the access point ARN in place of the bucket name. For more
7530
7555
  # information about access point ARNs, see [Using Access Points][1] in
7531
7556
  # the *Amazon Simple Storage Service Developer Guide*.
7532
7557
  #
7533
- # When using this API with Amazon S3 on Outposts, you must direct
7558
+ # When using this action with Amazon S3 on Outposts, you must direct
7534
7559
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7535
7560
  # takes the form
7536
7561
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
7537
- # When using this operation using S3 on Outposts through the AWS SDKs,
7538
- # you provide the Outposts bucket ARN in place of the bucket name. For
7539
- # more information about S3 on Outposts ARNs, see [Using S3 on
7540
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7562
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7563
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7564
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7565
+ # in the *Amazon Simple Storage Service Developer Guide*.
7541
7566
  #
7542
7567
  #
7543
7568
  #
7544
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7545
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7569
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7570
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7546
7571
  #
7547
7572
  # @option params [String] :delimiter
7548
7573
  # A delimiter is a character you use to group keys.
@@ -7560,7 +7585,7 @@ module Aws::S3
7560
7585
  #
7561
7586
  # @option params [Integer] :max_keys
7562
7587
  # Sets the maximum number of keys returned in the response. By default
7563
- # the API returns up to 1,000 key names. The response might contain
7588
+ # the action returns up to 1,000 key names. The response might contain
7564
7589
  # fewer keys but will never contain more.
7565
7590
  #
7566
7591
  # @option params [String] :prefix
@@ -7572,7 +7597,7 @@ module Aws::S3
7572
7597
  # parameter in their requests.
7573
7598
  #
7574
7599
  # @option params [String] :expected_bucket_owner
7575
- # The account id of the expected bucket owner. If the bucket is owned by
7600
+ # The account ID of the expected bucket owner. If the bucket is owned by
7576
7601
  # a different account, the request will fail with an HTTP `403 (Access
7577
7602
  # Denied)` error.
7578
7603
  #
@@ -7677,20 +7702,22 @@ module Aws::S3
7677
7702
  # use the request parameters as selection criteria to return a subset of
7678
7703
  # the objects in a bucket. A `200 OK` response can contain valid or
7679
7704
  # invalid XML. Make sure to design your application to parse the
7680
- # contents of the response and handle it appropriately.
7705
+ # contents of the response and handle it appropriately. Objects are
7706
+ # returned sorted in an ascending order of the respective key names in
7707
+ # the list.
7681
7708
  #
7682
7709
  # To use this operation, you must have READ access to the bucket.
7683
7710
  #
7684
- # To use this operation in an AWS Identity and Access Management (IAM)
7711
+ # To use this action in an AWS Identity and Access Management (IAM)
7685
7712
  # policy, you must have permissions to perform the `s3:ListBucket`
7686
7713
  # action. The bucket owner has this permission by default and can grant
7687
7714
  # this permission to others. For more information about permissions, see
7688
7715
  # [Permissions Related to Bucket Subresource Operations][1] and
7689
7716
  # [Managing Access Permissions to Your Amazon S3 Resources][2].
7690
7717
  #
7691
- # This section describes the latest revision of the API. We recommend
7692
- # that you use this revised API for application development. For
7693
- # backward compatibility, Amazon S3 continues to support the prior
7718
+ # This section describes the latest revision of this action. We
7719
+ # recommend that you use this revised API for application development.
7720
+ # For backward compatibility, Amazon S3 continues to support the prior
7694
7721
  # version of this API, [ListObjects][3].
7695
7722
  #
7696
7723
  # To get a list of your buckets, see [ListBuckets][4].
@@ -7705,8 +7732,8 @@ module Aws::S3
7705
7732
  #
7706
7733
  #
7707
7734
  #
7708
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7709
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
7735
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7736
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
7710
7737
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
7711
7738
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7712
7739
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
@@ -7716,27 +7743,27 @@ module Aws::S3
7716
7743
  # @option params [required, String] :bucket
7717
7744
  # Bucket name to list.
7718
7745
  #
7719
- # When using this API with an access point, you must direct requests to
7720
- # the access point hostname. The access point hostname takes the form
7746
+ # When using this action with an access point, you must direct requests
7747
+ # to the access point hostname. The access point hostname takes the form
7721
7748
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7722
- # When using this operation with an access point through the AWS SDKs,
7723
- # you provide the access point ARN in place of the bucket name. For more
7749
+ # When using this action with an access point through the AWS SDKs, you
7750
+ # provide the access point ARN in place of the bucket name. For more
7724
7751
  # information about access point ARNs, see [Using Access Points][1] in
7725
7752
  # the *Amazon Simple Storage Service Developer Guide*.
7726
7753
  #
7727
- # When using this API with Amazon S3 on Outposts, you must direct
7754
+ # When using this action with Amazon S3 on Outposts, you must direct
7728
7755
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7729
7756
  # takes the form
7730
7757
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
7731
- # When using this operation using S3 on Outposts through the AWS SDKs,
7732
- # you provide the Outposts bucket ARN in place of the bucket name. For
7733
- # more information about S3 on Outposts ARNs, see [Using S3 on
7734
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7758
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7759
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7760
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7761
+ # in the *Amazon Simple Storage Service Developer Guide*.
7735
7762
  #
7736
7763
  #
7737
7764
  #
7738
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7739
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7765
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7766
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7740
7767
  #
7741
7768
  # @option params [String] :delimiter
7742
7769
  # A delimiter is a character you use to group keys.
@@ -7746,7 +7773,7 @@ module Aws::S3
7746
7773
  #
7747
7774
  # @option params [Integer] :max_keys
7748
7775
  # Sets the maximum number of keys returned in the response. By default
7749
- # the API returns up to 1,000 key names. The response might contain
7776
+ # the action returns up to 1,000 key names. The response might contain
7750
7777
  # fewer keys but will never contain more.
7751
7778
  #
7752
7779
  # @option params [String] :prefix
@@ -7773,7 +7800,7 @@ module Aws::S3
7773
7800
  # this parameter in their requests.
7774
7801
  #
7775
7802
  # @option params [String] :expected_bucket_owner
7776
- # The account id of the expected bucket owner. If the bucket is owned by
7803
+ # The account ID of the expected bucket owner. If the bucket is owned by
7777
7804
  # a different account, the request will fail with an HTTP `403 (Access
7778
7805
  # Denied)` error.
7779
7806
  #
@@ -7895,7 +7922,7 @@ module Aws::S3
7895
7922
  # Using Multipart Upload][2].
7896
7923
  #
7897
7924
  # For information on permissions required to use the multipart upload
7898
- # API, see [Multipart Upload API and Permissions][3].
7925
+ # API, see [Multipart Upload and Permissions][3].
7899
7926
  #
7900
7927
  # The following operations are related to `ListParts`\:
7901
7928
  #
@@ -7922,27 +7949,27 @@ module Aws::S3
7922
7949
  # @option params [required, String] :bucket
7923
7950
  # The name of the bucket to which the parts are being uploaded.
7924
7951
  #
7925
- # When using this API with an access point, you must direct requests to
7926
- # the access point hostname. The access point hostname takes the form
7952
+ # When using this action with an access point, you must direct requests
7953
+ # to the access point hostname. The access point hostname takes the form
7927
7954
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7928
- # When using this operation with an access point through the AWS SDKs,
7929
- # you provide the access point ARN in place of the bucket name. For more
7955
+ # When using this action with an access point through the AWS SDKs, you
7956
+ # provide the access point ARN in place of the bucket name. For more
7930
7957
  # information about access point ARNs, see [Using Access Points][1] in
7931
7958
  # the *Amazon Simple Storage Service Developer Guide*.
7932
7959
  #
7933
- # When using this API with Amazon S3 on Outposts, you must direct
7960
+ # When using this action with Amazon S3 on Outposts, you must direct
7934
7961
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7935
7962
  # takes the form
7936
7963
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
7937
- # When using this operation using S3 on Outposts through the AWS SDKs,
7938
- # you provide the Outposts bucket ARN in place of the bucket name. For
7939
- # more information about S3 on Outposts ARNs, see [Using S3 on
7940
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7964
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7965
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7966
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7967
+ # in the *Amazon Simple Storage Service Developer Guide*.
7941
7968
  #
7942
7969
  #
7943
7970
  #
7944
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7945
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7971
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7972
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7946
7973
  #
7947
7974
  # @option params [required, String] :key
7948
7975
  # Object key for which the multipart upload was initiated.
@@ -7970,7 +7997,7 @@ module Aws::S3
7970
7997
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
7971
7998
  #
7972
7999
  # @option params [String] :expected_bucket_owner
7973
- # The account id of the expected bucket owner. If the bucket is owned by
8000
+ # The account ID of the expected bucket owner. If the bucket is owned by
7974
8001
  # a different account, the request will fail with an HTTP `403 (Access
7975
8002
  # Denied)` error.
7976
8003
  #
@@ -8093,8 +8120,8 @@ module Aws::S3
8093
8120
  #
8094
8121
  # * Suspended – Disables accelerated data transfers to the bucket.
8095
8122
  #
8096
- # The [GetBucketAccelerateConfiguration][3] operation returns the
8097
- # transfer acceleration state of a bucket.
8123
+ # The [GetBucketAccelerateConfiguration][3] action returns the transfer
8124
+ # acceleration state of a bucket.
8098
8125
  #
8099
8126
  # After setting the Transfer Acceleration state of a bucket to Enabled,
8100
8127
  # it might take up to thirty minutes before the data transfer rates to
@@ -8115,8 +8142,8 @@ module Aws::S3
8115
8142
  #
8116
8143
  #
8117
8144
  #
8118
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8119
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8145
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8146
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8120
8147
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html
8121
8148
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
8122
8149
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
@@ -8128,7 +8155,7 @@ module Aws::S3
8128
8155
  # Container for setting the transfer acceleration state.
8129
8156
  #
8130
8157
  # @option params [String] :expected_bucket_owner
8131
- # The account id of the expected bucket owner. If the bucket is owned by
8158
+ # The account ID of the expected bucket owner. If the bucket is owned by
8132
8159
  # a different account, the request will fail with an HTTP `403 (Access
8133
8160
  # Denied)` error.
8134
8161
  #
@@ -8350,7 +8377,7 @@ module Aws::S3
8350
8377
  # Allows grantee to write the ACL for the applicable bucket.
8351
8378
  #
8352
8379
  # @option params [String] :expected_bucket_owner
8353
- # The account id of the expected bucket owner. If the bucket is owned by
8380
+ # The account ID of the expected bucket owner. If the bucket is owned by
8354
8381
  # a different account, the request will fail with an HTTP `403 (Access
8355
8382
  # Denied)` error.
8356
8383
  #
@@ -8472,8 +8499,8 @@ module Aws::S3
8472
8499
  #
8473
8500
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
8474
8501
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
8475
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8476
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8502
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8503
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8477
8504
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
8478
8505
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
8479
8506
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -8488,7 +8515,7 @@ module Aws::S3
8488
8515
  # The configuration and any analyses for the analytics filter.
8489
8516
  #
8490
8517
  # @option params [String] :expected_bucket_owner
8491
- # The account id of the expected bucket owner. If the bucket is owned by
8518
+ # The account ID of the expected bucket owner. If the bucket is owned by
8492
8519
  # a different account, the request will fail with an HTTP `403 (Access
8493
8520
  # Denied)` error.
8494
8521
  #
@@ -8579,7 +8606,7 @@ module Aws::S3
8579
8606
  # element.
8580
8607
  #
8581
8608
  # For more information about CORS, go to [Enabling Cross-Origin Resource
8582
- # Sharing][1] in the *Amazon Simple Storage Service Developer Guide*.
8609
+ # Sharing][1] in the *Amazon S3 User Guide*.
8583
8610
  #
8584
8611
  # **Related Resources**
8585
8612
  #
@@ -8602,8 +8629,7 @@ module Aws::S3
8602
8629
  # @option params [required, Types::CORSConfiguration] :cors_configuration
8603
8630
  # Describes the cross-origin access configuration for objects in an
8604
8631
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
8605
- # Resource Sharing][1] in the *Amazon Simple Storage Service Developer
8606
- # Guide*.
8632
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
8607
8633
  #
8608
8634
  #
8609
8635
  #
@@ -8622,7 +8648,7 @@ module Aws::S3
8622
8648
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
8623
8649
  #
8624
8650
  # @option params [String] :expected_bucket_owner
8625
- # The account id of the expected bucket owner. If the bucket is owned by
8651
+ # The account ID of the expected bucket owner. If the bucket is owned by
8626
8652
  # a different account, the request will fail with an HTTP `403 (Access
8627
8653
  # Denied)` error.
8628
8654
  #
@@ -8679,6 +8705,7 @@ module Aws::S3
8679
8705
  # cors_configuration: { # required
8680
8706
  # cors_rules: [ # required
8681
8707
  # {
8708
+ # id: "ID",
8682
8709
  # allowed_headers: ["AllowedHeader"],
8683
8710
  # allowed_methods: ["AllowedMethod"], # required
8684
8711
  # allowed_origins: ["AllowedOrigin"], # required
@@ -8700,7 +8727,7 @@ module Aws::S3
8700
8727
  req.send_request(options)
8701
8728
  end
8702
8729
 
8703
- # This operation uses the `encryption` subresource to configure default
8730
+ # This action uses the `encryption` subresource to configure default
8704
8731
  # encryption and Amazon S3 Bucket Key for an existing bucket.
8705
8732
  #
8706
8733
  # Default encryption for a bucket can use server-side encryption with
@@ -8708,36 +8735,35 @@ module Aws::S3
8708
8735
  # (SSE-KMS). If you specify default encryption using SSE-KMS, you can
8709
8736
  # also configure Amazon S3 Bucket Key. For information about default
8710
8737
  # encryption, see [Amazon S3 default bucket encryption][1] in the
8711
- # *Amazon Simple Storage Service Developer Guide*. For more information
8712
- # about S3 Bucket Keys, see [Amazon S3 Bucket Keys][2] in the *Amazon
8713
- # Simple Storage Service Developer Guide*.
8738
+ # *Amazon S3 User Guide*. For more information about S3 Bucket Keys, see
8739
+ # [Amazon S3 Bucket Keys][2] in the *Amazon S3 User Guide*.
8714
8740
  #
8715
- # This operation requires AWS Signature Version 4. For more information,
8716
- # see [ Authenticating Requests (AWS Signature Version
8717
- # 4)](sig-v4-authenticating-requests.html).
8741
+ # This action requires AWS Signature Version 4. For more information,
8742
+ # see [ Authenticating Requests (AWS Signature Version 4)][3].
8718
8743
  #
8719
8744
  # To use this operation, you must have permissions to perform the
8720
8745
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
8721
8746
  # permission by default. The bucket owner can grant this permission to
8722
8747
  # others. For more information about permissions, see [Permissions
8723
- # Related to Bucket Subresource Operations][3] and [Managing Access
8724
- # Permissions to Your Amazon S3 Resources][4] in the Amazon Simple
8725
- # Storage Service Developer Guide.
8748
+ # Related to Bucket Subresource Operations][4] and [Managing Access
8749
+ # Permissions to Your Amazon S3 Resources][5] in the Amazon S3 User
8750
+ # Guide.
8726
8751
  #
8727
8752
  # **Related Resources**
8728
8753
  #
8729
- # * [GetBucketEncryption][5]
8754
+ # * [GetBucketEncryption][6]
8730
8755
  #
8731
- # * [DeleteBucketEncryption][6]
8756
+ # * [DeleteBucketEncryption][7]
8732
8757
  #
8733
8758
  #
8734
8759
  #
8735
8760
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
8736
8761
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
8737
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8738
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8739
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
8740
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
8762
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
8763
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8764
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8765
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
8766
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
8741
8767
  #
8742
8768
  # @option params [required, String] :bucket
8743
8769
  # Specifies default encryption for a bucket using server-side encryption
@@ -8761,7 +8787,7 @@ module Aws::S3
8761
8787
  # Specifies the default server-side-encryption configuration.
8762
8788
  #
8763
8789
  # @option params [String] :expected_bucket_owner
8764
- # The account id of the expected bucket owner. If the bucket is owned by
8790
+ # The account ID of the expected bucket owner. If the bucket is owned by
8765
8791
  # a different account, the request will fail with an HTTP `403 (Access
8766
8792
  # Denied)` error.
8767
8793
  #
@@ -8796,6 +8822,8 @@ module Aws::S3
8796
8822
  end
8797
8823
 
8798
8824
  # Puts a S3 Intelligent-Tiering configuration to the specified bucket.
8825
+ # You can have up to 1,000 S3 Intelligent-Tiering configurations per
8826
+ # bucket.
8799
8827
  #
8800
8828
  # The S3 Intelligent-Tiering storage class is designed to optimize
8801
8829
  # storage costs by automatically moving data to the most cost-effective
@@ -8824,6 +8852,35 @@ module Aws::S3
8824
8852
  #
8825
8853
  # * [ListBucketIntelligentTieringConfigurations][4]
8826
8854
  #
8855
+ # <note markdown="1"> You only need S3 Intelligent-Tiering enabled on a bucket if you want
8856
+ # to automatically move objects stored in the S3 Intelligent-Tiering
8857
+ # storage class to the Archive Access or Deep Archive Access tier.
8858
+ #
8859
+ # </note>
8860
+ #
8861
+ # **Special Errors**
8862
+ #
8863
+ # * **HTTP 400 Bad Request Error**
8864
+ #
8865
+ # * *Code:* InvalidArgument
8866
+ #
8867
+ # * *Cause:* Invalid Argument
8868
+ #
8869
+ # * **HTTP 400 Bad Request Error**
8870
+ #
8871
+ # * *Code:* TooManyConfigurations
8872
+ #
8873
+ # * *Cause:* You are attempting to create a new configuration but have
8874
+ # already reached the 1,000-configuration limit.
8875
+ #
8876
+ # * **HTTP 403 Forbidden Error**
8877
+ #
8878
+ # * *Code:* AccessDenied
8879
+ #
8880
+ # * *Cause:* You are not the owner of the specified bucket, or you do
8881
+ # not have the `s3:PutIntelligentTieringConfiguration` bucket
8882
+ # permission to set the configuration on the bucket.
8883
+ #
8827
8884
  #
8828
8885
  #
8829
8886
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -8885,7 +8942,7 @@ module Aws::S3
8885
8942
  req.send_request(options)
8886
8943
  end
8887
8944
 
8888
- # This implementation of the `PUT` operation adds an inventory
8945
+ # This implementation of the `PUT` action adds an inventory
8889
8946
  # configuration (identified by the inventory ID) to the bucket. You can
8890
8947
  # have up to 1,000 inventory configurations per bucket.
8891
8948
  #
@@ -8901,8 +8958,7 @@ module Aws::S3
8901
8958
  # whether to generate the inventory daily or weekly. You can also
8902
8959
  # configure what object metadata to include and whether to inventory all
8903
8960
  # object versions or only current versions. For more information, see
8904
- # [Amazon S3 Inventory][1] in the Amazon Simple Storage Service
8905
- # Developer Guide.
8961
+ # [Amazon S3 Inventory][1] in the Amazon S3 User Guide.
8906
8962
  #
8907
8963
  # You must create a bucket policy on the *destination* bucket to grant
8908
8964
  # permissions to Amazon S3 to write objects to the bucket in the defined
@@ -8914,8 +8970,7 @@ module Aws::S3
8914
8970
  # permission by default and can grant this permission to others. For
8915
8971
  # more information about permissions, see [Permissions Related to Bucket
8916
8972
  # Subresource Operations][3] and [Managing Access Permissions to Your
8917
- # Amazon S3 Resources][4] in the Amazon Simple Storage Service Developer
8918
- # Guide.
8973
+ # Amazon S3 Resources][4] in the Amazon S3 User Guide.
8919
8974
  #
8920
8975
  # **Special Errors**
8921
8976
  #
@@ -8952,8 +9007,8 @@ module Aws::S3
8952
9007
  #
8953
9008
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
8954
9009
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
8955
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8956
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9010
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9011
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8957
9012
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
8958
9013
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
8959
9014
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -8969,7 +9024,7 @@ module Aws::S3
8969
9024
  # Specifies the inventory configuration.
8970
9025
  #
8971
9026
  # @option params [String] :expected_bucket_owner
8972
- # The account id of the expected bucket owner. If the bucket is owned by
9027
+ # The account ID of the expected bucket owner. If the bucket is owned by
8973
9028
  # a different account, the request will fail with an HTTP `403 (Access
8974
9029
  # Denied)` error.
8975
9030
  #
@@ -9026,8 +9081,8 @@ module Aws::S3
9026
9081
  #
9027
9082
  # Creates a new lifecycle configuration for the bucket or replaces an
9028
9083
  # existing lifecycle configuration. For information about lifecycle
9029
- # configuration, see [Object Lifecycle Management][2] in the *Amazon
9030
- # Simple Storage Service Developer Guide*.
9084
+ # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
9085
+ # User Guide*.
9031
9086
  #
9032
9087
  # By default, all Amazon S3 resources, including buckets, objects, and
9033
9088
  # related subresources (for example, lifecycle configuration and website
@@ -9049,8 +9104,8 @@ module Aws::S3
9049
9104
  # * `s3:PutLifecycleConfiguration`
9050
9105
  #
9051
9106
  # For more information about permissions, see [Managing Access
9052
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
9053
- # Storage Service Developer Guide*.
9107
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
9108
+ # Guide*.
9054
9109
  #
9055
9110
  # For more examples of transitioning objects to storage classes such as
9056
9111
  # STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
@@ -9068,7 +9123,7 @@ module Aws::S3
9068
9123
  # the AWS account that created the bucket—can perform any of the
9069
9124
  # operations. A resource owner can also grant others permission to
9070
9125
  # perform the operation. For more information, see the following
9071
- # topics in the Amazon Simple Storage Service Developer Guide:
9126
+ # topics in the Amazon S3 User Guide:
9072
9127
  #
9073
9128
  # * [Specifying Permissions in a Policy][8]
9074
9129
  #
@@ -9078,7 +9133,7 @@ module Aws::S3
9078
9133
  #
9079
9134
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
9080
9135
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9081
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9136
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9082
9137
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
9083
9138
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
9084
9139
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
@@ -9094,7 +9149,7 @@ module Aws::S3
9094
9149
  # @option params [Types::LifecycleConfiguration] :lifecycle_configuration
9095
9150
  #
9096
9151
  # @option params [String] :expected_bucket_owner
9097
- # The account id of the expected bucket owner. If the bucket is owned by
9152
+ # The account ID of the expected bucket owner. If the bucket is owned by
9098
9153
  # a different account, the request will fail with an HTTP `403 (Access
9099
9154
  # Denied)` error.
9100
9155
  #
@@ -9218,7 +9273,7 @@ module Aws::S3
9218
9273
  #
9219
9274
  #
9220
9275
  #
9221
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9276
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9222
9277
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
9223
9278
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9224
9279
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
@@ -9233,7 +9288,7 @@ module Aws::S3
9233
9288
  # Container for lifecycle rules. You can add as many as 1,000 rules.
9234
9289
  #
9235
9290
  # @option params [String] :expected_bucket_owner
9236
- # The account id of the expected bucket owner. If the bucket is owned by
9291
+ # The account ID of the expected bucket owner. If the bucket is owned by
9237
9292
  # a different account, the request will fail with an HTTP `403 (Access
9238
9293
  # Denied)` error.
9239
9294
  #
@@ -9414,7 +9469,7 @@ module Aws::S3
9414
9469
  # SDKs, this field is calculated automatically.
9415
9470
  #
9416
9471
  # @option params [String] :expected_bucket_owner
9417
- # The account id of the expected bucket owner. If the bucket is owned by
9472
+ # The account ID of the expected bucket owner. If the bucket is owned by
9418
9473
  # a different account, the request will fail with an HTTP `403 (Access
9419
9474
  # Denied)` error.
9420
9475
  #
@@ -9517,8 +9572,8 @@ module Aws::S3
9517
9572
  #
9518
9573
  #
9519
9574
  #
9520
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9521
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9575
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9576
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9522
9577
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
9523
9578
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
9524
9579
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -9534,7 +9589,7 @@ module Aws::S3
9534
9589
  # Specifies the metrics configuration.
9535
9590
  #
9536
9591
  # @option params [String] :expected_bucket_owner
9537
- # The account id of the expected bucket owner. If the bucket is owned by
9592
+ # The account ID of the expected bucket owner. If the bucket is owned by
9538
9593
  # a different account, the request will fail with an HTTP `403 (Access
9539
9594
  # Denied)` error.
9540
9595
  #
@@ -9596,7 +9651,7 @@ module Aws::S3
9596
9651
  # The container for the configuration.
9597
9652
  #
9598
9653
  # @option params [String] :expected_bucket_owner
9599
- # The account id of the expected bucket owner. If the bucket is owned by
9654
+ # The account ID of the expected bucket owner. If the bucket is owned by
9600
9655
  # a different account, the request will fail with an HTTP `403 (Access
9601
9656
  # Denied)` error.
9602
9657
  #
@@ -9658,8 +9713,8 @@ module Aws::S3
9658
9713
  #
9659
9714
  # `</NotificationConfiguration>`
9660
9715
  #
9661
- # This operation replaces the existing notification configuration with
9662
- # the configuration you include in the request body.
9716
+ # This action replaces the existing notification configuration with the
9717
+ # configuration you include in the request body.
9663
9718
  #
9664
9719
  # After Amazon S3 receives this request, it first verifies that any
9665
9720
  # Amazon Simple Notification Service (Amazon SNS) or Amazon Simple Queue
@@ -9682,8 +9737,8 @@ module Aws::S3
9682
9737
  # notification configuration includes SNS topic, SQS queue, and Lambda
9683
9738
  # function configurations. When you send a PUT request with this
9684
9739
  # configuration, Amazon S3 sends test messages to your SNS topic. If the
9685
- # message fails, the entire PUT operation will fail, and Amazon S3 will
9686
- # not add the configuration to your bucket.
9740
+ # message fails, the entire PUT action will fail, and Amazon S3 will not
9741
+ # add the configuration to your bucket.
9687
9742
  #
9688
9743
  # </note>
9689
9744
  #
@@ -9695,7 +9750,7 @@ module Aws::S3
9695
9750
  # include the `x-amz-sns-test-message-id` header containing the message
9696
9751
  # ID of the test notification sent to the topic.
9697
9752
  #
9698
- # The following operation is related to
9753
+ # The following action is related to
9699
9754
  # `PutBucketNotificationConfiguration`\:
9700
9755
  #
9701
9756
  # * [GetBucketNotificationConfiguration][2]
@@ -9716,7 +9771,7 @@ module Aws::S3
9716
9771
  # bucket.
9717
9772
  #
9718
9773
  # @option params [String] :expected_bucket_owner
9719
- # The account id of the expected bucket owner. If the bucket is owned by
9774
+ # The account ID of the expected bucket owner. If the bucket is owned by
9720
9775
  # a different account, the request will fail with an HTTP `403 (Access
9721
9776
  # Denied)` error.
9722
9777
  #
@@ -9840,7 +9895,7 @@ module Aws::S3
9840
9895
  # SDKs, this field is calculated automatically.
9841
9896
  #
9842
9897
  # @option params [String] :expected_bucket_owner
9843
- # The account id of the expected bucket owner. If the bucket is owned by
9898
+ # The account ID of the expected bucket owner. If the bucket is owned by
9844
9899
  # a different account, the request will fail with an HTTP `403 (Access
9845
9900
  # Denied)` error.
9846
9901
  #
@@ -9921,7 +9976,7 @@ module Aws::S3
9921
9976
  # The bucket policy as a JSON document.
9922
9977
  #
9923
9978
  # @option params [String] :expected_bucket_owner
9924
- # The account id of the expected bucket owner. If the bucket is owned by
9979
+ # The account ID of the expected bucket owner. If the bucket is owned by
9925
9980
  # a different account, the request will fail with an HTTP `403 (Access
9926
9981
  # Denied)` error.
9927
9982
  #
@@ -9960,8 +10015,8 @@ module Aws::S3
9960
10015
  # more information, see [Replication][1] in the *Amazon S3 Developer
9961
10016
  # Guide*.
9962
10017
  #
9963
- # <note markdown="1"> To perform this operation, the user or role performing the operation
9964
- # must have the [iam:PassRole][2] permission.
10018
+ # <note markdown="1"> To perform this operation, the user or role performing the action must
10019
+ # have the [iam:PassRole][2] permission.
9965
10020
  #
9966
10021
  # </note>
9967
10022
  #
@@ -10026,7 +10081,7 @@ module Aws::S3
10026
10081
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
10027
10082
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html
10028
10083
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
10029
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10084
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10030
10085
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
10031
10086
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
10032
10087
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
@@ -10055,7 +10110,7 @@ module Aws::S3
10055
10110
  # A token to allow Object Lock to be enabled for an existing bucket.
10056
10111
  #
10057
10112
  # @option params [String] :expected_bucket_owner
10058
- # The account id of the expected bucket owner. If the bucket is owned by
10113
+ # The account ID of the expected bucket owner. If the bucket is owned by
10059
10114
  # a different account, the request will fail with an HTTP `403 (Access
10060
10115
  # Denied)` error.
10061
10116
  #
@@ -10187,10 +10242,9 @@ module Aws::S3
10187
10242
  # The bucket name.
10188
10243
  #
10189
10244
  # @option params [String] :content_md5
10190
- # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
10191
- # this header as a message integrity check to verify that the request
10192
- # body was not corrupted in transit. For more information, see [RFC
10193
- # 1864][1].
10245
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
10246
+ # header as a message integrity check to verify that the request body
10247
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
10194
10248
  #
10195
10249
  # For requests made using the AWS Command Line Interface (CLI) or AWS
10196
10250
  # SDKs, this field is calculated automatically.
@@ -10203,7 +10257,7 @@ module Aws::S3
10203
10257
  # Container for Payer.
10204
10258
  #
10205
10259
  # @option params [String] :expected_bucket_owner
10206
- # The account id of the expected bucket owner. If the bucket is owned by
10260
+ # The account ID of the expected bucket owner. If the bucket is owned by
10207
10261
  # a different account, the request will fail with an HTTP `403 (Access
10208
10262
  # Denied)` error.
10209
10263
  #
@@ -10284,7 +10338,7 @@ module Aws::S3
10284
10338
  #
10285
10339
  # * Error code: `OperationAbortedError `
10286
10340
  #
10287
- # * Description: A conflicting conditional operation is currently in
10341
+ # * Description: A conflicting conditional action is currently in
10288
10342
  # progress against this resource. Please try again.
10289
10343
  #
10290
10344
  # ^
@@ -10306,8 +10360,8 @@ module Aws::S3
10306
10360
  #
10307
10361
  # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
10308
10362
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html
10309
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10310
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10363
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10364
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10311
10365
  # [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
10312
10366
  # [6]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html
10313
10367
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
@@ -10332,7 +10386,7 @@ module Aws::S3
10332
10386
  # Container for the `TagSet` and `Tag` elements.
10333
10387
  #
10334
10388
  # @option params [String] :expected_bucket_owner
10335
- # The account id of the expected bucket owner. If the bucket is owned by
10389
+ # The account ID of the expected bucket owner. If the bucket is owned by
10336
10390
  # a different account, the request will fail with an HTTP `403 (Access
10337
10391
  # Denied)` error.
10338
10392
  #
@@ -10452,7 +10506,7 @@ module Aws::S3
10452
10506
  # Container for setting the versioning state.
10453
10507
  #
10454
10508
  # @option params [String] :expected_bucket_owner
10455
- # The account id of the expected bucket owner. If the bucket is owned by
10509
+ # The account ID of the expected bucket owner. If the bucket is owned by
10456
10510
  # a different account, the request will fail with an HTTP `403 (Access
10457
10511
  # Denied)` error.
10458
10512
  #
@@ -10499,7 +10553,7 @@ module Aws::S3
10499
10553
  # such as the file name of the index document and any redirect rules.
10500
10554
  # For more information, see [Hosting Websites on Amazon S3][1].
10501
10555
  #
10502
- # This PUT operation requires the `S3:PutBucketWebsite` permission. By
10556
+ # This PUT action requires the `S3:PutBucketWebsite` permission. By
10503
10557
  # default, only the bucket owner can configure the website attached to a
10504
10558
  # bucket; however, bucket owners can allow other users to set the
10505
10559
  # website configuration by writing a bucket policy that grants them the
@@ -10559,7 +10613,7 @@ module Aws::S3
10559
10613
  # Amazon S3 has a limitation of 50 routing rules per website
10560
10614
  # configuration. If you require more than 50 routing rules, you can use
10561
10615
  # object redirect. For more information, see [Configuring an Object
10562
- # Redirect][2] in the *Amazon Simple Storage Service Developer Guide*.
10616
+ # Redirect][2] in the *Amazon S3 User Guide*.
10563
10617
  #
10564
10618
  #
10565
10619
  #
@@ -10585,7 +10639,7 @@ module Aws::S3
10585
10639
  # Container for the request.
10586
10640
  #
10587
10641
  # @option params [String] :expected_bucket_owner
10588
- # The account id of the expected bucket owner. If the bucket is owned by
10642
+ # The account ID of the expected bucket owner. If the bucket is owned by
10589
10643
  # a different account, the request will fail with an HTTP `403 (Access
10590
10644
  # Denied)` error.
10591
10645
  #
@@ -10691,8 +10745,8 @@ module Aws::S3
10691
10745
  #
10692
10746
  # If you request server-side encryption using AWS Key Management Service
10693
10747
  # (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
10694
- # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon Simple
10695
- # Storage Service Developer Guide*.
10748
+ # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon S3
10749
+ # User Guide*.
10696
10750
  #
10697
10751
  # **Access Control List (ACL)-Specific Request Headers**
10698
10752
  #
@@ -10758,29 +10812,29 @@ module Aws::S3
10758
10812
  # Object data.
10759
10813
  #
10760
10814
  # @option params [required, String] :bucket
10761
- # The bucket name to which the PUT operation was initiated.
10815
+ # The bucket name to which the PUT action was initiated.
10762
10816
  #
10763
- # When using this API with an access point, you must direct requests to
10764
- # the access point hostname. The access point hostname takes the form
10817
+ # When using this action with an access point, you must direct requests
10818
+ # to the access point hostname. The access point hostname takes the form
10765
10819
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
10766
- # When using this operation with an access point through the AWS SDKs,
10767
- # you provide the access point ARN in place of the bucket name. For more
10820
+ # When using this action with an access point through the AWS SDKs, you
10821
+ # provide the access point ARN in place of the bucket name. For more
10768
10822
  # information about access point ARNs, see [Using Access Points][1] in
10769
10823
  # the *Amazon Simple Storage Service Developer Guide*.
10770
10824
  #
10771
- # When using this API with Amazon S3 on Outposts, you must direct
10825
+ # When using this action with Amazon S3 on Outposts, you must direct
10772
10826
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10773
10827
  # takes the form
10774
10828
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
10775
- # When using this operation using S3 on Outposts through the AWS SDKs,
10776
- # you provide the Outposts bucket ARN in place of the bucket name. For
10777
- # more information about S3 on Outposts ARNs, see [Using S3 on
10778
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
10829
+ # When using this action using S3 on Outposts through the AWS SDKs, you
10830
+ # provide the Outposts bucket ARN in place of the bucket name. For more
10831
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
10832
+ # in the *Amazon Simple Storage Service Developer Guide*.
10779
10833
  #
10780
10834
  #
10781
10835
  #
10782
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
10783
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
10836
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
10837
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
10784
10838
  #
10785
10839
  # @option params [String] :cache_control
10786
10840
  # Can be used to specify caching behavior along the request/reply chain.
@@ -10875,7 +10929,7 @@ module Aws::S3
10875
10929
  # This action is not supported by Amazon S3 on Outposts.
10876
10930
  #
10877
10931
  # @option params [required, String] :key
10878
- # Object key for which the PUT operation was initiated.
10932
+ # Object key for which the PUT action was initiated.
10879
10933
  #
10880
10934
  # @option params [Hash<String,String>] :metadata
10881
10935
  # A map of metadata to store with the object in S3.
@@ -10962,8 +11016,8 @@ module Aws::S3
10962
11016
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
10963
11017
  # for object encryption with SSE-KMS.
10964
11018
  #
10965
- # Specifying this header with a PUT operation doesn’t affect
10966
- # bucket-level settings for S3 Bucket Key.
11019
+ # Specifying this header with a PUT action doesn’t affect bucket-level
11020
+ # settings for S3 Bucket Key.
10967
11021
  #
10968
11022
  # @option params [String] :request_payer
10969
11023
  # Confirms that the requester knows that they will be charged for the
@@ -10995,7 +11049,7 @@ module Aws::S3
10995
11049
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
10996
11050
  #
10997
11051
  # @option params [String] :expected_bucket_owner
10998
- # The account id of the expected bucket owner. If the bucket is owned by
11052
+ # The account ID of the expected bucket owner. If the bucket is owned by
10999
11053
  # a different account, the request will fail with an HTTP `403 (Access
11000
11054
  # Denied)` error.
11001
11055
  #
@@ -11013,24 +11067,21 @@ module Aws::S3
11013
11067
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
11014
11068
  #
11015
11069
  #
11016
- # @example Example: To upload an object and specify server-side encryption and object tags
11070
+ # @example Example: To upload an object
11017
11071
  #
11018
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11019
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11072
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11073
+ # # syntax. S3 returns VersionId of the newly created object.
11020
11074
  #
11021
11075
  # resp = client.put_object({
11022
- # body: "filetoupload",
11076
+ # body: "HappyFace.jpg",
11023
11077
  # bucket: "examplebucket",
11024
- # key: "exampleobject",
11025
- # server_side_encryption: "AES256",
11026
- # tagging: "key1=value1&key2=value2",
11078
+ # key: "HappyFace.jpg",
11027
11079
  # })
11028
11080
  #
11029
11081
  # resp.to_h outputs the following:
11030
11082
  # {
11031
11083
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11032
- # server_side_encryption: "AES256",
11033
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11084
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11034
11085
  # }
11035
11086
  #
11036
11087
  # @example Example: To create an object.
@@ -11049,24 +11100,6 @@ module Aws::S3
11049
11100
  # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11050
11101
  # }
11051
11102
  #
11052
- # @example Example: To upload an object and specify optional tags
11053
- #
11054
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
11055
- # # S3 returns version ID of the newly created object.
11056
- #
11057
- # resp = client.put_object({
11058
- # body: "c:\\HappyFace.jpg",
11059
- # bucket: "examplebucket",
11060
- # key: "HappyFace.jpg",
11061
- # tagging: "key1=value1&key2=value2",
11062
- # })
11063
- #
11064
- # resp.to_h outputs the following:
11065
- # {
11066
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11067
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11068
- # }
11069
- #
11070
11103
  # @example Example: To upload an object (specify optional headers)
11071
11104
  #
11072
11105
  # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
@@ -11126,21 +11159,42 @@ module Aws::S3
11126
11159
  # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11127
11160
  # }
11128
11161
  #
11129
- # @example Example: To upload an object
11162
+ # @example Example: To upload an object and specify optional tags
11130
11163
  #
11131
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11132
- # # syntax. S3 returns VersionId of the newly created object.
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.
11133
11166
  #
11134
11167
  # resp = client.put_object({
11135
- # body: "HappyFace.jpg",
11168
+ # body: "c:\\HappyFace.jpg",
11136
11169
  # bucket: "examplebucket",
11137
11170
  # key: "HappyFace.jpg",
11171
+ # tagging: "key1=value1&key2=value2",
11138
11172
  # })
11139
11173
  #
11140
11174
  # resp.to_h outputs the following:
11141
11175
  # {
11142
11176
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11143
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11177
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11178
+ # }
11179
+ #
11180
+ # @example Example: To upload an object and specify server-side encryption and object tags
11181
+ #
11182
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11183
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11184
+ #
11185
+ # resp = client.put_object({
11186
+ # body: "filetoupload",
11187
+ # bucket: "examplebucket",
11188
+ # key: "exampleobject",
11189
+ # server_side_encryption: "AES256",
11190
+ # tagging: "key1=value1&key2=value2",
11191
+ # })
11192
+ #
11193
+ # resp.to_h outputs the following:
11194
+ # {
11195
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11196
+ # server_side_encryption: "AES256",
11197
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11144
11198
  # }
11145
11199
  #
11146
11200
  # @example Streaming a file from disk
@@ -11213,8 +11267,8 @@ module Aws::S3
11213
11267
  # Uses the `acl` subresource to set the access control list (ACL)
11214
11268
  # permissions for a new or existing object in an S3 bucket. You must
11215
11269
  # have `WRITE_ACP` permission to set the ACL of an object. For more
11216
- # information, see [What permissions can I grant?][1] in the *Amazon
11217
- # Simple Storage Service Developer Guide*.
11270
+ # information, see [What permissions can I grant?][1] in the *Amazon S3
11271
+ # User Guide*.
11218
11272
  #
11219
11273
  # This action is not supported by Amazon S3 on Outposts.
11220
11274
  #
@@ -11378,17 +11432,17 @@ module Aws::S3
11378
11432
  # The bucket name that contains the object to which you want to attach
11379
11433
  # the ACL.
11380
11434
  #
11381
- # When using this API with an access point, you must direct requests to
11382
- # the access point hostname. The access point hostname takes the form
11435
+ # When using this action with an access point, you must direct requests
11436
+ # to the access point hostname. The access point hostname takes the form
11383
11437
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11384
- # When using this operation with an access point through the AWS SDKs,
11385
- # you provide the access point ARN in place of the bucket name. For more
11438
+ # When using this action with an access point through the AWS SDKs, you
11439
+ # provide the access point ARN in place of the bucket name. For more
11386
11440
  # information about access point ARNs, see [Using Access Points][1] in
11387
11441
  # the *Amazon Simple Storage Service Developer Guide*.
11388
11442
  #
11389
11443
  #
11390
11444
  #
11391
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11445
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11392
11446
  #
11393
11447
  # @option params [String] :content_md5
11394
11448
  # The base64-encoded 128-bit MD5 digest of the data. This header must be
@@ -11429,29 +11483,29 @@ module Aws::S3
11429
11483
  # This action is not supported by Amazon S3 on Outposts.
11430
11484
  #
11431
11485
  # @option params [required, String] :key
11432
- # Key for which the PUT operation was initiated.
11486
+ # Key for which the PUT action was initiated.
11433
11487
  #
11434
- # When using this API with an access point, you must direct requests to
11435
- # the access point hostname. The access point hostname takes the form
11488
+ # When using this action with an access point, you must direct requests
11489
+ # to the access point hostname. The access point hostname takes the form
11436
11490
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11437
- # When using this operation with an access point through the AWS SDKs,
11438
- # you provide the access point ARN in place of the bucket name. For more
11491
+ # When using this action with an access point through the AWS SDKs, you
11492
+ # provide the access point ARN in place of the bucket name. For more
11439
11493
  # information about access point ARNs, see [Using Access Points][1] in
11440
11494
  # the *Amazon Simple Storage Service Developer Guide*.
11441
11495
  #
11442
- # When using this API with Amazon S3 on Outposts, you must direct
11496
+ # When using this action with Amazon S3 on Outposts, you must direct
11443
11497
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11444
11498
  # takes the form
11445
11499
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
11446
- # When using this operation using S3 on Outposts through the AWS SDKs,
11447
- # you provide the Outposts bucket ARN in place of the bucket name. For
11448
- # more information about S3 on Outposts ARNs, see [Using S3 on
11449
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11500
+ # When using this action using S3 on Outposts through the AWS SDKs, you
11501
+ # provide the Outposts bucket ARN in place of the bucket name. For more
11502
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11503
+ # in the *Amazon Simple Storage Service Developer Guide*.
11450
11504
  #
11451
11505
  #
11452
11506
  #
11453
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11454
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11507
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11508
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11455
11509
  #
11456
11510
  # @option params [String] :request_payer
11457
11511
  # Confirms that the requester knows that they will be charged for the
@@ -11468,7 +11522,7 @@ module Aws::S3
11468
11522
  # VersionId used to reference a specific version of the object.
11469
11523
  #
11470
11524
  # @option params [String] :expected_bucket_owner
11471
- # The account id of the expected bucket owner. If the bucket is owned by
11525
+ # The account ID of the expected bucket owner. If the bucket is owned by
11472
11526
  # a different account, the request will fail with an HTTP `403 (Access
11473
11527
  # Denied)` error.
11474
11528
  #
@@ -11561,17 +11615,17 @@ module Aws::S3
11561
11615
  # The bucket name containing the object that you want to place a Legal
11562
11616
  # Hold on.
11563
11617
  #
11564
- # When using this API with an access point, you must direct requests to
11565
- # the access point hostname. The access point hostname takes the form
11618
+ # When using this action with an access point, you must direct requests
11619
+ # to the access point hostname. The access point hostname takes the form
11566
11620
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11567
- # When using this operation with an access point through the AWS SDKs,
11568
- # you provide the access point ARN in place of the bucket name. For more
11621
+ # When using this action with an access point through the AWS SDKs, you
11622
+ # provide the access point ARN in place of the bucket name. For more
11569
11623
  # information about access point ARNs, see [Using Access Points][1] in
11570
11624
  # the *Amazon Simple Storage Service Developer Guide*.
11571
11625
  #
11572
11626
  #
11573
11627
  #
11574
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11628
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11575
11629
  #
11576
11630
  # @option params [required, String] :key
11577
11631
  # The key name for the object that you want to place a Legal Hold on.
@@ -11601,7 +11655,7 @@ module Aws::S3
11601
11655
  # SDKs, this field is calculated automatically.
11602
11656
  #
11603
11657
  # @option params [String] :expected_bucket_owner
11604
- # The account id of the expected bucket owner. If the bucket is owned by
11658
+ # The account ID of the expected bucket owner. If the bucket is owned by
11605
11659
  # a different account, the request will fail with an HTTP `403 (Access
11606
11660
  # Denied)` error.
11607
11661
  #
@@ -11684,7 +11738,7 @@ module Aws::S3
11684
11738
  # SDKs, this field is calculated automatically.
11685
11739
  #
11686
11740
  # @option params [String] :expected_bucket_owner
11687
- # The account id of the expected bucket owner. If the bucket is owned by
11741
+ # The account ID of the expected bucket owner. If the bucket is owned by
11688
11742
  # a different account, the request will fail with an HTTP `403 (Access
11689
11743
  # Denied)` error.
11690
11744
  #
@@ -11743,17 +11797,17 @@ module Aws::S3
11743
11797
  # The bucket name that contains the object you want to apply this Object
11744
11798
  # Retention configuration to.
11745
11799
  #
11746
- # When using this API with an access point, you must direct requests to
11747
- # the access point hostname. The access point hostname takes the form
11800
+ # When using this action with an access point, you must direct requests
11801
+ # to the access point hostname. The access point hostname takes the form
11748
11802
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11749
- # When using this operation with an access point through the AWS SDKs,
11750
- # you provide the access point ARN in place of the bucket name. For more
11803
+ # When using this action with an access point through the AWS SDKs, you
11804
+ # provide the access point ARN in place of the bucket name. For more
11751
11805
  # information about access point ARNs, see [Using Access Points][1] in
11752
11806
  # the *Amazon Simple Storage Service Developer Guide*.
11753
11807
  #
11754
11808
  #
11755
11809
  #
11756
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11810
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11757
11811
  #
11758
11812
  # @option params [required, String] :key
11759
11813
  # The key name for the object that you want to apply this Object
@@ -11778,7 +11832,7 @@ module Aws::S3
11778
11832
  # Retention configuration to.
11779
11833
  #
11780
11834
  # @option params [Boolean] :bypass_governance_retention
11781
- # Indicates whether this operation should bypass Governance-mode
11835
+ # Indicates whether this action should bypass Governance-mode
11782
11836
  # restrictions.
11783
11837
  #
11784
11838
  # @option params [String] :content_md5
@@ -11788,7 +11842,7 @@ module Aws::S3
11788
11842
  # SDKs, this field is calculated automatically.
11789
11843
  #
11790
11844
  # @option params [String] :expected_bucket_owner
11791
- # The account id of the expected bucket owner. If the bucket is owned by
11845
+ # The account ID of the expected bucket owner. If the bucket is owned by
11792
11846
  # a different account, the request will fail with an HTTP `403 (Access
11793
11847
  # Denied)` error.
11794
11848
  #
@@ -11861,8 +11915,8 @@ module Aws::S3
11861
11915
  #
11862
11916
  # * * <i>Code: OperationAbortedError </i>
11863
11917
  #
11864
- # * *Cause: A conflicting conditional operation is currently in
11865
- # progress against this resource. Please try again.*
11918
+ # * *Cause: A conflicting conditional action is currently in progress
11919
+ # against this resource. Please try again.*
11866
11920
  #
11867
11921
  # * * *Code: InternalError*
11868
11922
  #
@@ -11873,38 +11927,39 @@ module Aws::S3
11873
11927
  #
11874
11928
  # * [GetObjectTagging][1]
11875
11929
  #
11876
- # ^
11930
+ # * [DeleteObjectTagging][4]
11877
11931
  #
11878
11932
  #
11879
11933
  #
11880
11934
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
11881
11935
  # [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
11882
11936
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
11937
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html
11883
11938
  #
11884
11939
  # @option params [required, String] :bucket
11885
11940
  # The bucket name containing the object.
11886
11941
  #
11887
- # When using this API with an access point, you must direct requests to
11888
- # the access point hostname. The access point hostname takes the form
11942
+ # When using this action with an access point, you must direct requests
11943
+ # to the access point hostname. The access point hostname takes the form
11889
11944
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11890
- # When using this operation with an access point through the AWS SDKs,
11891
- # you provide the access point ARN in place of the bucket name. For more
11945
+ # When using this action with an access point through the AWS SDKs, you
11946
+ # provide the access point ARN in place of the bucket name. For more
11892
11947
  # information about access point ARNs, see [Using Access Points][1] in
11893
11948
  # the *Amazon Simple Storage Service Developer Guide*.
11894
11949
  #
11895
- # When using this API with Amazon S3 on Outposts, you must direct
11950
+ # When using this action with Amazon S3 on Outposts, you must direct
11896
11951
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11897
11952
  # takes the form
11898
11953
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
11899
- # When using this operation using S3 on Outposts through the AWS SDKs,
11900
- # you provide the Outposts bucket ARN in place of the bucket name. For
11901
- # more information about S3 on Outposts ARNs, see [Using S3 on
11902
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11954
+ # When using this action using S3 on Outposts through the AWS SDKs, you
11955
+ # provide the Outposts bucket ARN in place of the bucket name. For more
11956
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11957
+ # in the *Amazon Simple Storage Service Developer Guide*.
11903
11958
  #
11904
11959
  #
11905
11960
  #
11906
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11907
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11961
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11962
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11908
11963
  #
11909
11964
  # @option params [required, String] :key
11910
11965
  # Name of the object key.
@@ -11922,10 +11977,21 @@ module Aws::S3
11922
11977
  # Container for the `TagSet` and `Tag` elements
11923
11978
  #
11924
11979
  # @option params [String] :expected_bucket_owner
11925
- # The account id of the expected bucket owner. If the bucket is owned by
11980
+ # The account ID of the expected bucket owner. If the bucket is owned by
11926
11981
  # a different account, the request will fail with an HTTP `403 (Access
11927
11982
  # Denied)` error.
11928
11983
  #
11984
+ # @option params [String] :request_payer
11985
+ # Confirms that the requester knows that they will be charged for the
11986
+ # request. Bucket owners need not specify this parameter in their
11987
+ # requests. For information about downloading objects from requester
11988
+ # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
11989
+ # in the *Amazon S3 Developer Guide*.
11990
+ #
11991
+ #
11992
+ #
11993
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
11994
+ #
11929
11995
  # @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11930
11996
  #
11931
11997
  # * {Types::PutObjectTaggingOutput#version_id #version_id} => String
@@ -11973,6 +12039,7 @@ module Aws::S3
11973
12039
  # ],
11974
12040
  # },
11975
12041
  # expected_bucket_owner: "AccountId",
12042
+ # request_payer: "requester", # accepts requester
11976
12043
  # })
11977
12044
  #
11978
12045
  # @example Response structure
@@ -12045,7 +12112,7 @@ module Aws::S3
12045
12112
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
12046
12113
  #
12047
12114
  # @option params [String] :expected_bucket_owner
12048
- # The account id of the expected bucket owner. If the bucket is owned by
12115
+ # The account ID of the expected bucket owner. If the bucket is owned by
12049
12116
  # a different account, the request will fail with an HTTP `403 (Access
12050
12117
  # Denied)` error.
12051
12118
  #
@@ -12089,7 +12156,7 @@ module Aws::S3
12089
12156
  # default and can grant this permission to others. For more information
12090
12157
  # about permissions, see [Permissions Related to Bucket Subresource
12091
12158
  # Operations][1] and [Managing Access Permissions to Your Amazon S3
12092
- # Resources][2] in the *Amazon Simple Storage Service Developer Guide*.
12159
+ # Resources][2] in the *Amazon S3 User Guide*.
12093
12160
  #
12094
12161
  # **Querying Archives with Select Requests**
12095
12162
  #
@@ -12099,7 +12166,7 @@ module Aws::S3
12099
12166
  # files. You can run queries and custom analytics on your archived data
12100
12167
  # without having to restore your data to a hotter Amazon S3 tier. For an
12101
12168
  # overview about select requests, see [Querying Archived Objects][3] in
12102
- # the *Amazon Simple Storage Service Developer Guide*.
12169
+ # the *Amazon S3 User Guide*.
12103
12170
  #
12104
12171
  # When making a select request, do the following:
12105
12172
  #
@@ -12109,19 +12176,18 @@ module Aws::S3
12109
12176
  # that initiates the job must have permissions to write to the S3
12110
12177
  # bucket. You can specify the storage class and encryption for the
12111
12178
  # output objects stored in the bucket. For more information about
12112
- # output, see [Querying Archived Objects][3] in the *Amazon Simple
12113
- # Storage Service Developer Guide*.
12179
+ # output, see [Querying Archived Objects][3] in the *Amazon S3 User
12180
+ # Guide*.
12114
12181
  #
12115
12182
  # For more information about the `S3` structure in the request body,
12116
12183
  # see the following:
12117
12184
  #
12118
12185
  # * [PutObject][4]
12119
12186
  #
12120
- # * [Managing Access with ACLs][5] in the *Amazon Simple Storage
12121
- # Service Developer Guide*
12187
+ # * [Managing Access with ACLs][5] in the *Amazon S3 User Guide*
12122
12188
  #
12123
12189
  # * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
12124
- # Simple Storage Service Developer Guide*
12190
+ # S3 User Guide*
12125
12191
  #
12126
12192
  # * Define the SQL expression for the `SELECT` type of restoration for
12127
12193
  # your query in the request body's `SelectParameters` structure. You
@@ -12147,7 +12213,7 @@ module Aws::S3
12147
12213
  #
12148
12214
  # For more information about using SQL with S3 Glacier Select restore,
12149
12215
  # see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
12150
- # the *Amazon Simple Storage Service Developer Guide*.
12216
+ # the *Amazon S3 User Guide*.
12151
12217
  #
12152
12218
  # When making a select request, you can also do the following:
12153
12219
  #
@@ -12226,20 +12292,19 @@ module Aws::S3
12226
12292
  #
12227
12293
  # For more information about archive retrieval options and provisioned
12228
12294
  # capacity for `Expedited` data access, see [Restoring Archived
12229
- # Objects][8] in the *Amazon Simple Storage Service Developer Guide*.
12295
+ # Objects][8] in the *Amazon S3 User Guide*.
12230
12296
  #
12231
12297
  # You can use Amazon S3 restore speed upgrade to change the restore
12232
12298
  # speed to a faster speed while it is in progress. For more information,
12233
12299
  # see [ Upgrading the speed of an in-progress restore][9] in the *Amazon
12234
- # Simple Storage Service Developer Guide*.
12300
+ # S3 User Guide*.
12235
12301
  #
12236
12302
  # To get the status of object restoration, you can send a `HEAD`
12237
12303
  # request. Operations return the `x-amz-restore` header, which provides
12238
12304
  # information about the restoration status, in the response. You can use
12239
12305
  # Amazon S3 event notifications to notify you when a restore is
12240
12306
  # initiated or completed. For more information, see [Configuring Amazon
12241
- # S3 Event Notifications][10] in the *Amazon Simple Storage Service
12242
- # Developer Guide*.
12307
+ # S3 Event Notifications][10] in the *Amazon S3 User Guide*.
12243
12308
  #
12244
12309
  # After restoring an archived object, you can update the restoration
12245
12310
  # period by reissuing the request with a new period. Amazon S3 updates
@@ -12255,11 +12320,11 @@ module Aws::S3
12255
12320
  # days, Amazon S3 deletes the object in 3 days. For more information
12256
12321
  # about lifecycle configuration, see
12257
12322
  # [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
12258
- # Management][12] in *Amazon Simple Storage Service Developer Guide*.
12323
+ # Management][12] in *Amazon S3 User Guide*.
12259
12324
  #
12260
12325
  # **Responses**
12261
12326
  #
12262
- # A successful operation returns either the `200 OK` or `202 Accepted`
12327
+ # A successful action returns either the `200 OK` or `202 Accepted`
12263
12328
  # status code.
12264
12329
  #
12265
12330
  # * If the object is not previously restored, then Amazon S3 returns
@@ -12297,12 +12362,12 @@ module Aws::S3
12297
12362
  # * [GetBucketNotificationConfiguration][13]
12298
12363
  #
12299
12364
  # * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
12300
- # the *Amazon Simple Storage Service Developer Guide*
12365
+ # the *Amazon S3 User Guide*
12301
12366
  #
12302
12367
  #
12303
12368
  #
12304
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12305
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
12369
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12370
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
12306
12371
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
12307
12372
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
12308
12373
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
@@ -12318,30 +12383,30 @@ module Aws::S3
12318
12383
  # @option params [required, String] :bucket
12319
12384
  # The bucket name containing the object to restore.
12320
12385
  #
12321
- # When using this API with an access point, you must direct requests to
12322
- # the access point hostname. The access point hostname takes the form
12386
+ # When using this action with an access point, you must direct requests
12387
+ # to the access point hostname. The access point hostname takes the form
12323
12388
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
12324
- # When using this operation with an access point through the AWS SDKs,
12325
- # you provide the access point ARN in place of the bucket name. For more
12389
+ # When using this action with an access point through the AWS SDKs, you
12390
+ # provide the access point ARN in place of the bucket name. For more
12326
12391
  # information about access point ARNs, see [Using Access Points][1] in
12327
12392
  # the *Amazon Simple Storage Service Developer Guide*.
12328
12393
  #
12329
- # When using this API with Amazon S3 on Outposts, you must direct
12394
+ # When using this action with Amazon S3 on Outposts, you must direct
12330
12395
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
12331
12396
  # takes the form
12332
12397
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
12333
- # When using this operation using S3 on Outposts through the AWS SDKs,
12334
- # you provide the Outposts bucket ARN in place of the bucket name. For
12335
- # more information about S3 on Outposts ARNs, see [Using S3 on
12336
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
12398
+ # When using this action using S3 on Outposts through the AWS SDKs, you
12399
+ # provide the Outposts bucket ARN in place of the bucket name. For more
12400
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
12401
+ # in the *Amazon Simple Storage Service Developer Guide*.
12337
12402
  #
12338
12403
  #
12339
12404
  #
12340
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
12341
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
12405
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
12406
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
12342
12407
  #
12343
12408
  # @option params [required, String] :key
12344
- # Object key for which the operation was initiated.
12409
+ # Object key for which the action was initiated.
12345
12410
  #
12346
12411
  # @option params [String] :version_id
12347
12412
  # VersionId used to reference a specific version of the object.
@@ -12361,7 +12426,7 @@ module Aws::S3
12361
12426
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
12362
12427
  #
12363
12428
  # @option params [String] :expected_bucket_owner
12364
- # The account id of the expected bucket owner. If the bucket is owned by
12429
+ # The account ID of the expected bucket owner. If the bucket is owned by
12365
12430
  # a different account, the request will fail with an HTTP `403 (Access
12366
12431
  # Denied)` error.
12367
12432
  #
@@ -12495,7 +12560,7 @@ module Aws::S3
12495
12560
  req.send_request(options)
12496
12561
  end
12497
12562
 
12498
- # This operation filters the contents of an Amazon S3 object based on a
12563
+ # This action filters the contents of an Amazon S3 object based on a
12499
12564
  # simple structured query language (SQL) statement. In the request,
12500
12565
  # along with the SQL expression, you must also specify a data
12501
12566
  # serialization format (JSON, CSV, or Apache Parquet) of the object.
@@ -12506,12 +12571,11 @@ module Aws::S3
12506
12571
  # This action is not supported by Amazon S3 on Outposts.
12507
12572
  #
12508
12573
  # For more information about Amazon S3 Select, see [Selecting Content
12509
- # from Objects][1] in the *Amazon Simple Storage Service Developer
12510
- # Guide*.
12574
+ # from Objects][1] in the *Amazon S3 User Guide*.
12511
12575
  #
12512
12576
  # For more information about using SQL with Amazon S3 Select, see [ SQL
12513
12577
  # Reference for Amazon S3 Select and S3 Glacier Select][2] in the
12514
- # *Amazon Simple Storage Service Developer Guide*.
12578
+ # *Amazon S3 User Guide*.
12515
12579
  #
12516
12580
  #
12517
12581
  #
@@ -12520,7 +12584,7 @@ module Aws::S3
12520
12584
  # You must have `s3:GetObject` permission for this operation. Amazon S3
12521
12585
  # Select does not support anonymous access. For more information about
12522
12586
  # permissions, see [Specifying Permissions in a Policy][3] in the
12523
- # *Amazon Simple Storage Service Developer Guide*.
12587
+ # *Amazon S3 User Guide*.
12524
12588
  #
12525
12589
  #
12526
12590
  #
@@ -12548,8 +12612,7 @@ module Aws::S3
12548
12612
  # keys (SSE-C), you must use HTTPS, and you must use the headers that
12549
12613
  # are documented in the [GetObject][4]. For more information about
12550
12614
  # SSE-C, see [Server-Side Encryption (Using Customer-Provided
12551
- # Encryption Keys)][5] in the *Amazon Simple Storage Service Developer
12552
- # Guide*.
12615
+ # Encryption Keys)][5] in the *Amazon S3 User Guide*.
12553
12616
  #
12554
12617
  # For objects that are encrypted with Amazon S3 managed encryption
12555
12618
  # keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
@@ -12557,7 +12620,7 @@ module Aws::S3
12557
12620
  # transparently, so you don't need to specify anything. For more
12558
12621
  # information about server-side encryption, including SSE-S3 and
12559
12622
  # SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
12560
- # the *Amazon Simple Storage Service Developer Guide*.
12623
+ # the *Amazon S3 User Guide*.
12561
12624
  #
12562
12625
  # **Working with the Response Body**
12563
12626
  #
@@ -12570,7 +12633,7 @@ module Aws::S3
12570
12633
  #
12571
12634
  # **GetObject Support**
12572
12635
  #
12573
- # The `SelectObjectContent` operation does not support the following
12636
+ # The `SelectObjectContent` action does not support the following
12574
12637
  # `GetObject` functionality. For more information, see [GetObject][4].
12575
12638
  #
12576
12639
  # * `Range`\: Although you can specify a scan range for an Amazon S3
@@ -12581,8 +12644,7 @@ module Aws::S3
12581
12644
  # * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
12582
12645
  # cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
12583
12646
  # storage classes. For more information, about storage classes see
12584
- # [Storage Classes][9] in the *Amazon Simple Storage Service Developer
12585
- # Guide*.
12647
+ # [Storage Classes][9] in the *Amazon S3 User Guide*.
12586
12648
  #
12587
12649
  #
12588
12650
  #
@@ -12681,7 +12743,7 @@ module Aws::S3
12681
12743
  # within the last 50 bytes of the file.
12682
12744
  #
12683
12745
  # @option params [String] :expected_bucket_owner
12684
- # The account id of the expected bucket owner. If the bucket is owned by
12746
+ # The account ID of the expected bucket owner. If the bucket is owned by
12685
12747
  # a different account, the request will fail with an HTTP `403 (Access
12686
12748
  # Denied)` error.
12687
12749
  #
@@ -12948,12 +13010,11 @@ module Aws::S3
12948
13010
  # parts storage and stops charging you for the parts storage.
12949
13011
  #
12950
13012
  # For more information on multipart uploads, go to [Multipart Upload
12951
- # Overview][4] in the <i>Amazon Simple Storage Service Developer Guide
12952
- # </i>.
13013
+ # Overview][4] in the <i>Amazon S3 User Guide </i>.
12953
13014
  #
12954
13015
  # For information on the permissions required to use the multipart
12955
- # upload API, go to [Multipart Upload API and Permissions][5] in the
12956
- # *Amazon Simple Storage Service Developer Guide*.
13016
+ # upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
13017
+ # S3 User Guide*.
12957
13018
  #
12958
13019
  # You can optionally request server-side encryption where Amazon S3
12959
13020
  # encrypts your data as it writes it to disks in its data centers and
@@ -12963,8 +13024,7 @@ module Aws::S3
12963
13024
  # request headers you provide in the request must match the headers you
12964
13025
  # used in the request to initiate the upload by using
12965
13026
  # [CreateMultipartUpload][2]. For more information, go to [Using
12966
- # Server-Side Encryption][6] in the *Amazon Simple Storage Service
12967
- # Developer Guide*.
13027
+ # Server-Side Encryption][6] in the *Amazon S3 User Guide*.
12968
13028
  #
12969
13029
  # Server-side encryption is supported by the S3 Multipart Upload
12970
13030
  # actions. Unless you are using a customer-provided encryption key, you
@@ -13027,27 +13087,27 @@ module Aws::S3
13027
13087
  # @option params [required, String] :bucket
13028
13088
  # The name of the bucket to which the multipart upload was initiated.
13029
13089
  #
13030
- # When using this API with an access point, you must direct requests to
13031
- # the access point hostname. The access point hostname takes the form
13090
+ # When using this action with an access point, you must direct requests
13091
+ # to the access point hostname. The access point hostname takes the form
13032
13092
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
13033
- # When using this operation with an access point through the AWS SDKs,
13034
- # you provide the access point ARN in place of the bucket name. For more
13093
+ # When using this action with an access point through the AWS SDKs, you
13094
+ # provide the access point ARN in place of the bucket name. For more
13035
13095
  # information about access point ARNs, see [Using Access Points][1] in
13036
13096
  # the *Amazon Simple Storage Service Developer Guide*.
13037
13097
  #
13038
- # When using this API with Amazon S3 on Outposts, you must direct
13098
+ # When using this action with Amazon S3 on Outposts, you must direct
13039
13099
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13040
13100
  # takes the form
13041
13101
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
13042
- # When using this operation using S3 on Outposts through the AWS SDKs,
13043
- # you provide the Outposts bucket ARN in place of the bucket name. For
13044
- # more information about S3 on Outposts ARNs, see [Using S3 on
13045
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
13102
+ # When using this action using S3 on Outposts through the AWS SDKs, you
13103
+ # provide the Outposts bucket ARN in place of the bucket name. For more
13104
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13105
+ # in the *Amazon Simple Storage Service Developer Guide*.
13046
13106
  #
13047
13107
  #
13048
13108
  #
13049
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13050
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13109
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13110
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13051
13111
  #
13052
13112
  # @option params [Integer] :content_length
13053
13113
  # Size of the body in bytes. This parameter is useful when the size of
@@ -13099,7 +13159,7 @@ module Aws::S3
13099
13159
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13100
13160
  #
13101
13161
  # @option params [String] :expected_bucket_owner
13102
- # The account id of the expected bucket owner. If the bucket is owned by
13162
+ # The account ID of the expected bucket owner. If the bucket is owned by
13103
13163
  # a different account, the request will fail with an HTTP `403 (Access
13104
13164
  # Denied)` error.
13105
13165
  #
@@ -13175,10 +13235,10 @@ module Aws::S3
13175
13235
  #
13176
13236
  # The minimum allowable part size for a multipart upload is 5 MB. For
13177
13237
  # more information about multipart upload limits, go to [Quick Facts][1]
13178
- # in the *Amazon Simple Storage Service Developer Guide*.
13238
+ # in the *Amazon S3 User Guide*.
13179
13239
  #
13180
13240
  # <note markdown="1"> Instead of using an existing object as part data, you might use the
13181
- # [UploadPart][2] operation and provide data in your request.
13241
+ # [UploadPart][2] action and provide data in your request.
13182
13242
  #
13183
13243
  # </note>
13184
13244
  #
@@ -13191,16 +13251,15 @@ module Aws::S3
13191
13251
  # the following:
13192
13252
  #
13193
13253
  # * For conceptual information about multipart uploads, see [Uploading
13194
- # Objects Using Multipart Upload][3] in the *Amazon Simple Storage
13195
- # Service Developer Guide*.
13254
+ # Objects Using Multipart Upload][3] in the *Amazon S3 User Guide*.
13196
13255
  #
13197
13256
  # * For information about permissions required to use the multipart
13198
- # upload API, see [Multipart Upload API and Permissions][4] in the
13199
- # *Amazon Simple Storage Service Developer Guide*.
13257
+ # upload API, see [Multipart Upload and Permissions][4] in the *Amazon
13258
+ # S3 User Guide*.
13200
13259
  #
13201
- # * For information about copying objects using a single atomic
13202
- # operation vs. the multipart upload, see [Operations on Objects][5]
13203
- # in the *Amazon Simple Storage Service Developer Guide*.
13260
+ # * For information about copying objects using a single atomic action
13261
+ # vs. the multipart upload, see [Operations on Objects][5] in the
13262
+ # *Amazon S3 User Guide*.
13204
13263
  #
13205
13264
  # * For information about using server-side encryption with
13206
13265
  # customer-provided encryption keys with the UploadPartCopy operation,
@@ -13302,27 +13361,27 @@ module Aws::S3
13302
13361
  # @option params [required, String] :bucket
13303
13362
  # The bucket name.
13304
13363
  #
13305
- # When using this API with an access point, you must direct requests to
13306
- # the access point hostname. The access point hostname takes the form
13364
+ # When using this action with an access point, you must direct requests
13365
+ # to the access point hostname. The access point hostname takes the form
13307
13366
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
13308
- # When using this operation with an access point through the AWS SDKs,
13309
- # you provide the access point ARN in place of the bucket name. For more
13367
+ # When using this action with an access point through the AWS SDKs, you
13368
+ # provide the access point ARN in place of the bucket name. For more
13310
13369
  # information about access point ARNs, see [Using Access Points][1] in
13311
13370
  # the *Amazon Simple Storage Service Developer Guide*.
13312
13371
  #
13313
- # When using this API with Amazon S3 on Outposts, you must direct
13372
+ # When using this action with Amazon S3 on Outposts, you must direct
13314
13373
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13315
13374
  # takes the form
13316
13375
  # *AccessPointName*-*AccountId*.*outpostID*.s3-outposts.*Region*.amazonaws.com.
13317
- # When using this operation using S3 on Outposts through the AWS SDKs,
13318
- # you provide the Outposts bucket ARN in place of the bucket name. For
13319
- # more information about S3 on Outposts ARNs, see [Using S3 on
13320
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
13376
+ # When using this action using S3 on Outposts through the AWS SDKs, you
13377
+ # provide the Outposts bucket ARN in place of the bucket name. For more
13378
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13379
+ # in the *Amazon Simple Storage Service Developer Guide*.
13321
13380
  #
13322
13381
  #
13323
13382
  #
13324
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13325
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13383
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13384
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13326
13385
  #
13327
13386
  # @option params [required, String] :copy_source
13328
13387
  # Specifies the source object for the copy operation. You specify the
@@ -13368,7 +13427,7 @@ module Aws::S3
13368
13427
  #
13369
13428
  #
13370
13429
  #
13371
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
13430
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
13372
13431
  #
13373
13432
  # @option params [String] :copy_source_if_match
13374
13433
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -13445,12 +13504,12 @@ module Aws::S3
13445
13504
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13446
13505
  #
13447
13506
  # @option params [String] :expected_bucket_owner
13448
- # The account id of the expected destination bucket owner. If the
13507
+ # The account ID of the expected destination bucket owner. If the
13449
13508
  # destination bucket is owned by a different account, the request will
13450
13509
  # fail with an HTTP `403 (Access Denied)` error.
13451
13510
  #
13452
13511
  # @option params [String] :expected_source_bucket_owner
13453
- # The account id of the expected source bucket owner. If the source
13512
+ # The account ID of the expected source bucket owner. If the source
13454
13513
  # bucket is owned by a different account, the request will fail with an
13455
13514
  # HTTP `403 (Access Denied)` error.
13456
13515
  #
@@ -13553,6 +13612,265 @@ module Aws::S3
13553
13612
  req.send_request(options)
13554
13613
  end
13555
13614
 
13615
+ # Passes transformed objects to a `GetObject` operation when using
13616
+ # Object Lambda Access Points. For information about Object Lambda
13617
+ # Access Points, see [Transforming objects with Object Lambda Access
13618
+ # Points][1] in the *Amazon S3 User Guide*.
13619
+ #
13620
+ # This operation supports metadata that can be returned by
13621
+ # [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
13622
+ # `StatusCode`, `ErrorCode`, and `ErrorMessage`. The `GetObject`
13623
+ # response metadata is supported so that the `WriteGetObjectResponse`
13624
+ # caller, typically an AWS Lambda function, can provide the same
13625
+ # metadata when it internally invokes `GetObject`. When
13626
+ # `WriteGetObjectResponse` is called by a customer-owned Lambda
13627
+ # function, the metadata returned to the end user `GetObject` call might
13628
+ # differ from what Amazon S3 would normally return.
13629
+ #
13630
+ #
13631
+ #
13632
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
13633
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
13634
+ #
13635
+ # @option params [required, String] :request_route
13636
+ # Route prefix to the HTTP URL generated.
13637
+ #
13638
+ # @option params [required, String] :request_token
13639
+ # A single use encrypted token that maps `WriteGetObjectResponse` to the
13640
+ # end user `GetObject` request.
13641
+ #
13642
+ # @option params [String, IO] :body
13643
+ # The object data.
13644
+ #
13645
+ # @option params [Integer] :status_code
13646
+ # The integer status code for an HTTP response of a corresponding
13647
+ # `GetObject` request.
13648
+ #
13649
+ # **Status Codes**
13650
+ #
13651
+ # * *200 - OK*
13652
+ #
13653
+ # * *206 - Partial Content*
13654
+ #
13655
+ # * *304 - Not Modified*
13656
+ #
13657
+ # * *400 - Bad Request*
13658
+ #
13659
+ # * *401 - Unauthorized*
13660
+ #
13661
+ # * *403 - Forbidden*
13662
+ #
13663
+ # * *404 - Not Found*
13664
+ #
13665
+ # * *405 - Method Not Allowed*
13666
+ #
13667
+ # * *409 - Conflict*
13668
+ #
13669
+ # * *411 - Length Required*
13670
+ #
13671
+ # * *412 - Precondition Failed*
13672
+ #
13673
+ # * *416 - Range Not Satisfiable*
13674
+ #
13675
+ # * *500 - Internal Server Error*
13676
+ #
13677
+ # * *503 - Service Unavailable*
13678
+ #
13679
+ # @option params [String] :error_code
13680
+ # A string that uniquely identifies an error condition. Returned in the
13681
+ # &lt;Code&gt; tag of the error XML response for a corresponding
13682
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13683
+ # or when the transformed object is provided in the body.
13684
+ #
13685
+ # @option params [String] :error_message
13686
+ # Contains a generic description of the error condition. Returned in the
13687
+ # &lt;Message&gt; tag of the error XML response for a corresponding
13688
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13689
+ # or when the transformed object is provided in body.
13690
+ #
13691
+ # @option params [String] :accept_ranges
13692
+ # Indicates that a range of bytes was specified.
13693
+ #
13694
+ # @option params [String] :cache_control
13695
+ # Specifies caching behavior along the request/reply chain.
13696
+ #
13697
+ # @option params [String] :content_disposition
13698
+ # Specifies presentational information for the object.
13699
+ #
13700
+ # @option params [String] :content_encoding
13701
+ # Specifies what content encodings have been applied to the object and
13702
+ # thus what decoding mechanisms must be applied to obtain the media-type
13703
+ # referenced by the Content-Type header field.
13704
+ #
13705
+ # @option params [String] :content_language
13706
+ # The language the content is in.
13707
+ #
13708
+ # @option params [Integer] :content_length
13709
+ # The size of the content body in bytes.
13710
+ #
13711
+ # @option params [String] :content_range
13712
+ # The portion of the object returned in the response.
13713
+ #
13714
+ # @option params [String] :content_type
13715
+ # A standard MIME type describing the format of the object data.
13716
+ #
13717
+ # @option params [Boolean] :delete_marker
13718
+ # Specifies whether an object stored in Amazon S3 is (`true`) or is not
13719
+ # (`false`) a delete marker.
13720
+ #
13721
+ # @option params [String] :etag
13722
+ # An opaque identifier assigned by a web server to a specific version of
13723
+ # a resource found at a URL.
13724
+ #
13725
+ # @option params [Time,DateTime,Date,Integer,String] :expires
13726
+ # The date and time at which the object is no longer cacheable.
13727
+ #
13728
+ # @option params [String] :expiration
13729
+ # If object stored in Amazon S3 expiration is configured (see PUT Bucket
13730
+ # lifecycle) it includes expiry-date and rule-id key-value pairs
13731
+ # providing object expiration information. The value of the rule-id is
13732
+ # URL encoded.
13733
+ #
13734
+ # @option params [Time,DateTime,Date,Integer,String] :last_modified
13735
+ # The date and time that the object was last modified.
13736
+ #
13737
+ # @option params [Integer] :missing_meta
13738
+ # Set to the number of metadata entries not returned in `x-amz-meta`
13739
+ # headers. This can happen if you create metadata using an API like SOAP
13740
+ # that supports more flexible metadata than the REST API. For example,
13741
+ # using SOAP, you can create metadata whose values are not legal HTTP
13742
+ # headers.
13743
+ #
13744
+ # @option params [Hash<String,String>] :metadata
13745
+ # A map of metadata to store with the object in S3.
13746
+ #
13747
+ # @option params [String] :object_lock_mode
13748
+ # Indicates whether an object stored in Amazon S3 has Object Lock
13749
+ # enabled. For more information about S3 Object Lock, see [Object
13750
+ # Lock][1].
13751
+ #
13752
+ #
13753
+ #
13754
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
13755
+ #
13756
+ # @option params [String] :object_lock_legal_hold_status
13757
+ # Indicates whether an object stored in Amazon S3 has an active legal
13758
+ # hold.
13759
+ #
13760
+ # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
13761
+ # The date and time when Object Lock is configured to expire.
13762
+ #
13763
+ # @option params [Integer] :parts_count
13764
+ # The count of parts this object has.
13765
+ #
13766
+ # @option params [String] :replication_status
13767
+ # Indicates if request involves bucket that is either a source or
13768
+ # destination in a Replication rule. For more information about S3
13769
+ # Replication, see [Replication][1].
13770
+ #
13771
+ #
13772
+ #
13773
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html
13774
+ #
13775
+ # @option params [String] :request_charged
13776
+ # If present, indicates that the requester was successfully charged for
13777
+ # the request.
13778
+ #
13779
+ # @option params [String] :restore
13780
+ # Provides information about object restoration operation and expiration
13781
+ # time of the restored object copy.
13782
+ #
13783
+ # @option params [String] :server_side_encryption
13784
+ # The server-side encryption algorithm used when storing requested
13785
+ # object in Amazon S3 (for example, AES256, aws:kms).
13786
+ #
13787
+ # @option params [String] :sse_customer_algorithm
13788
+ # Encryption algorithm used if server-side encryption with a
13789
+ # customer-provided encryption key was specified for object stored in
13790
+ # Amazon S3.
13791
+ #
13792
+ # @option params [String] :ssekms_key_id
13793
+ # If present, specifies the ID of the AWS Key Management Service (AWS
13794
+ # KMS) symmetric customer managed customer master key (CMK) that was
13795
+ # used for stored in Amazon S3 object.
13796
+ #
13797
+ # @option params [String] :sse_customer_key_md5
13798
+ # 128-bit MD5 digest of customer-provided encryption key used in Amazon
13799
+ # S3 to encrypt data stored in S3. For more information, see [Protecting
13800
+ # data using server-side encryption with customer-provided encryption
13801
+ # keys (SSE-C)][1].
13802
+ #
13803
+ #
13804
+ #
13805
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
13806
+ #
13807
+ # @option params [String] :storage_class
13808
+ # The class of storage used to store object in Amazon S3.
13809
+ #
13810
+ # @option params [Integer] :tag_count
13811
+ # The number of tags, if any, on the object.
13812
+ #
13813
+ # @option params [String] :version_id
13814
+ # An ID used to reference a specific version of the object.
13815
+ #
13816
+ # @option params [Boolean] :bucket_key_enabled
13817
+ # Indicates whether the object stored in Amazon S3 uses an S3 bucket key
13818
+ # for server-side encryption with AWS KMS (SSE-KMS).
13819
+ #
13820
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
13821
+ #
13822
+ # @example Request syntax with placeholder values
13823
+ #
13824
+ # resp = client.write_get_object_response({
13825
+ # request_route: "RequestRoute", # required
13826
+ # request_token: "RequestToken", # required
13827
+ # body: source_file,
13828
+ # status_code: 1,
13829
+ # error_code: "ErrorCode",
13830
+ # error_message: "ErrorMessage",
13831
+ # accept_ranges: "AcceptRanges",
13832
+ # cache_control: "CacheControl",
13833
+ # content_disposition: "ContentDisposition",
13834
+ # content_encoding: "ContentEncoding",
13835
+ # content_language: "ContentLanguage",
13836
+ # content_length: 1,
13837
+ # content_range: "ContentRange",
13838
+ # content_type: "ContentType",
13839
+ # delete_marker: false,
13840
+ # etag: "ETag",
13841
+ # expires: Time.now,
13842
+ # expiration: "Expiration",
13843
+ # last_modified: Time.now,
13844
+ # missing_meta: 1,
13845
+ # metadata: {
13846
+ # "MetadataKey" => "MetadataValue",
13847
+ # },
13848
+ # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
13849
+ # object_lock_legal_hold_status: "ON", # accepts ON, OFF
13850
+ # object_lock_retain_until_date: Time.now,
13851
+ # parts_count: 1,
13852
+ # replication_status: "COMPLETE", # accepts COMPLETE, PENDING, FAILED, REPLICA
13853
+ # request_charged: "requester", # accepts requester
13854
+ # restore: "Restore",
13855
+ # server_side_encryption: "AES256", # accepts AES256, aws:kms
13856
+ # sse_customer_algorithm: "SSECustomerAlgorithm",
13857
+ # ssekms_key_id: "SSEKMSKeyId",
13858
+ # sse_customer_key_md5: "SSECustomerKeyMD5",
13859
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
13860
+ # tag_count: 1,
13861
+ # version_id: "ObjectVersionId",
13862
+ # bucket_key_enabled: false,
13863
+ # })
13864
+ #
13865
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponse AWS API Documentation
13866
+ #
13867
+ # @overload write_get_object_response(params = {})
13868
+ # @param [Hash] params ({})
13869
+ def write_get_object_response(params = {}, options = {})
13870
+ req = build_request(:write_get_object_response, params)
13871
+ req.send_request(options)
13872
+ end
13873
+
13556
13874
  # @!endgroup
13557
13875
 
13558
13876
  # @param params ({})
@@ -13566,7 +13884,7 @@ module Aws::S3
13566
13884
  params: params,
13567
13885
  config: config)
13568
13886
  context[:gem_name] = 'aws-sdk-s3'
13569
- context[:gem_version] = '1.88.1'
13887
+ context[:gem_version] = '1.92.0'
13570
13888
  Seahorse::Client::Request.new(handlers, context)
13571
13889
  end
13572
13890