aws-sdk-s3 1.88.0 → 1.91.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 (37) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +729 -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/bucket.rb +4 -4
  7. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  8. data/lib/aws-sdk-s3/bucket_cors.rb +3 -2
  9. data/lib/aws-sdk-s3/bucket_lifecycle.rb +1 -1
  10. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +1 -1
  11. data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
  12. data/lib/aws-sdk-s3/bucket_notification.rb +1 -1
  13. data/lib/aws-sdk-s3/bucket_policy.rb +1 -1
  14. data/lib/aws-sdk-s3/bucket_request_payment.rb +4 -5
  15. data/lib/aws-sdk-s3/bucket_tagging.rb +1 -1
  16. data/lib/aws-sdk-s3/bucket_versioning.rb +1 -1
  17. data/lib/aws-sdk-s3/bucket_website.rb +1 -1
  18. data/lib/aws-sdk-s3/client.rb +599 -531
  19. data/lib/aws-sdk-s3/client_api.rb +4 -1
  20. data/lib/aws-sdk-s3/customizations/bucket.rb +8 -3
  21. data/lib/aws-sdk-s3/customizations/object.rb +9 -3
  22. data/lib/aws-sdk-s3/errors.rb +1 -1
  23. data/lib/aws-sdk-s3/event_streams.rb +1 -1
  24. data/lib/aws-sdk-s3/multipart_upload.rb +1 -1
  25. data/lib/aws-sdk-s3/multipart_upload_part.rb +1 -1
  26. data/lib/aws-sdk-s3/object.rb +13 -13
  27. data/lib/aws-sdk-s3/object_acl.rb +1 -1
  28. data/lib/aws-sdk-s3/object_summary.rb +13 -13
  29. data/lib/aws-sdk-s3/object_version.rb +6 -6
  30. data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +2 -1
  31. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +3 -2
  32. data/lib/aws-sdk-s3/plugins/md5s.rb +1 -1
  33. data/lib/aws-sdk-s3/presigner.rb +1 -2
  34. data/lib/aws-sdk-s3/resource.rb +1 -1
  35. data/lib/aws-sdk-s3/types.rb +364 -226
  36. data/lib/aws-sdk-s3/waiters.rb +1 -1
  37. metadata +6 -3
data/LICENSE.txt ADDED
@@ -0,0 +1,202 @@
1
+
2
+ Apache License
3
+ Version 2.0, January 2004
4
+ http://www.apache.org/licenses/
5
+
6
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7
+
8
+ 1. Definitions.
9
+
10
+ "License" shall mean the terms and conditions for use, reproduction,
11
+ and distribution as defined by Sections 1 through 9 of this document.
12
+
13
+ "Licensor" shall mean the copyright owner or entity authorized by
14
+ the copyright owner that is granting the License.
15
+
16
+ "Legal Entity" shall mean the union of the acting entity and all
17
+ other entities that control, are controlled by, or are under common
18
+ control with that entity. For the purposes of this definition,
19
+ "control" means (i) the power, direct or indirect, to cause the
20
+ direction or management of such entity, whether by contract or
21
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
22
+ outstanding shares, or (iii) beneficial ownership of such entity.
23
+
24
+ "You" (or "Your") shall mean an individual or Legal Entity
25
+ exercising permissions granted by this License.
26
+
27
+ "Source" form shall mean the preferred form for making modifications,
28
+ including but not limited to software source code, documentation
29
+ source, and configuration files.
30
+
31
+ "Object" form shall mean any form resulting from mechanical
32
+ transformation or translation of a Source form, including but
33
+ not limited to compiled object code, generated documentation,
34
+ and conversions to other media types.
35
+
36
+ "Work" shall mean the work of authorship, whether in Source or
37
+ Object form, made available under the License, as indicated by a
38
+ copyright notice that is included in or attached to the work
39
+ (an example is provided in the Appendix below).
40
+
41
+ "Derivative Works" shall mean any work, whether in Source or Object
42
+ form, that is based on (or derived from) the Work and for which the
43
+ editorial revisions, annotations, elaborations, or other modifications
44
+ represent, as a whole, an original work of authorship. For the purposes
45
+ of this License, Derivative Works shall not include works that remain
46
+ separable from, or merely link (or bind by name) to the interfaces of,
47
+ the Work and Derivative Works thereof.
48
+
49
+ "Contribution" shall mean any work of authorship, including
50
+ the original version of the Work and any modifications or additions
51
+ to that Work or Derivative Works thereof, that is intentionally
52
+ submitted to Licensor for inclusion in the Work by the copyright owner
53
+ or by an individual or Legal Entity authorized to submit on behalf of
54
+ the copyright owner. For the purposes of this definition, "submitted"
55
+ means any form of electronic, verbal, or written communication sent
56
+ to the Licensor or its representatives, including but not limited to
57
+ communication on electronic mailing lists, source code control systems,
58
+ and issue tracking systems that are managed by, or on behalf of, the
59
+ Licensor for the purpose of discussing and improving the Work, but
60
+ excluding communication that is conspicuously marked or otherwise
61
+ designated in writing by the copyright owner as "Not a Contribution."
62
+
63
+ "Contributor" shall mean Licensor and any individual or Legal Entity
64
+ on behalf of whom a Contribution has been received by Licensor and
65
+ subsequently incorporated within the Work.
66
+
67
+ 2. Grant of Copyright License. Subject to the terms and conditions of
68
+ this License, each Contributor hereby grants to You a perpetual,
69
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70
+ copyright license to reproduce, prepare Derivative Works of,
71
+ publicly display, publicly perform, sublicense, and distribute the
72
+ Work and such Derivative Works in Source or Object form.
73
+
74
+ 3. Grant of Patent License. Subject to the terms and conditions of
75
+ this License, each Contributor hereby grants to You a perpetual,
76
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77
+ (except as stated in this section) patent license to make, have made,
78
+ use, offer to sell, sell, import, and otherwise transfer the Work,
79
+ where such license applies only to those patent claims licensable
80
+ by such Contributor that are necessarily infringed by their
81
+ Contribution(s) alone or by combination of their Contribution(s)
82
+ with the Work to which such Contribution(s) was submitted. If You
83
+ institute patent litigation against any entity (including a
84
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
85
+ or a Contribution incorporated within the Work constitutes direct
86
+ or contributory patent infringement, then any patent licenses
87
+ granted to You under this License for that Work shall terminate
88
+ as of the date such litigation is filed.
89
+
90
+ 4. Redistribution. You may reproduce and distribute copies of the
91
+ Work or Derivative Works thereof in any medium, with or without
92
+ modifications, and in Source or Object form, provided that You
93
+ meet the following conditions:
94
+
95
+ (a) You must give any other recipients of the Work or
96
+ Derivative Works a copy of this License; and
97
+
98
+ (b) You must cause any modified files to carry prominent notices
99
+ stating that You changed the files; and
100
+
101
+ (c) You must retain, in the Source form of any Derivative Works
102
+ that You distribute, all copyright, patent, trademark, and
103
+ attribution notices from the Source form of the Work,
104
+ excluding those notices that do not pertain to any part of
105
+ the Derivative Works; and
106
+
107
+ (d) If the Work includes a "NOTICE" text file as part of its
108
+ distribution, then any Derivative Works that You distribute must
109
+ include a readable copy of the attribution notices contained
110
+ within such NOTICE file, excluding those notices that do not
111
+ pertain to any part of the Derivative Works, in at least one
112
+ of the following places: within a NOTICE text file distributed
113
+ as part of the Derivative Works; within the Source form or
114
+ documentation, if provided along with the Derivative Works; or,
115
+ within a display generated by the Derivative Works, if and
116
+ wherever such third-party notices normally appear. The contents
117
+ of the NOTICE file are for informational purposes only and
118
+ do not modify the License. You may add Your own attribution
119
+ notices within Derivative Works that You distribute, alongside
120
+ or as an addendum to the NOTICE text from the Work, provided
121
+ that such additional attribution notices cannot be construed
122
+ as modifying the License.
123
+
124
+ You may add Your own copyright statement to Your modifications and
125
+ may provide additional or different license terms and conditions
126
+ for use, reproduction, or distribution of Your modifications, or
127
+ for any such Derivative Works as a whole, provided Your use,
128
+ reproduction, and distribution of the Work otherwise complies with
129
+ the conditions stated in this License.
130
+
131
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
132
+ any Contribution intentionally submitted for inclusion in the Work
133
+ by You to the Licensor shall be under the terms and conditions of
134
+ this License, without any additional terms or conditions.
135
+ Notwithstanding the above, nothing herein shall supersede or modify
136
+ the terms of any separate license agreement you may have executed
137
+ with Licensor regarding such Contributions.
138
+
139
+ 6. Trademarks. This License does not grant permission to use the trade
140
+ names, trademarks, service marks, or product names of the Licensor,
141
+ except as required for reasonable and customary use in describing the
142
+ origin of the Work and reproducing the content of the NOTICE file.
143
+
144
+ 7. Disclaimer of Warranty. Unless required by applicable law or
145
+ agreed to in writing, Licensor provides the Work (and each
146
+ Contributor provides its Contributions) on an "AS IS" BASIS,
147
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148
+ implied, including, without limitation, any warranties or conditions
149
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150
+ PARTICULAR PURPOSE. You are solely responsible for determining the
151
+ appropriateness of using or redistributing the Work and assume any
152
+ risks associated with Your exercise of permissions under this License.
153
+
154
+ 8. Limitation of Liability. In no event and under no legal theory,
155
+ whether in tort (including negligence), contract, or otherwise,
156
+ unless required by applicable law (such as deliberate and grossly
157
+ negligent acts) or agreed to in writing, shall any Contributor be
158
+ liable to You for damages, including any direct, indirect, special,
159
+ incidental, or consequential damages of any character arising as a
160
+ result of this License or out of the use or inability to use the
161
+ Work (including but not limited to damages for loss of goodwill,
162
+ work stoppage, computer failure or malfunction, or any and all
163
+ other commercial damages or losses), even if such Contributor
164
+ has been advised of the possibility of such damages.
165
+
166
+ 9. Accepting Warranty or Additional Liability. While redistributing
167
+ the Work or Derivative Works thereof, You may choose to offer,
168
+ and charge a fee for, acceptance of support, warranty, indemnity,
169
+ or other liability obligations and/or rights consistent with this
170
+ License. However, in accepting such obligations, You may act only
171
+ on Your own behalf and on Your sole responsibility, not on behalf
172
+ of any other Contributor, and only if You agree to indemnify,
173
+ defend, and hold each Contributor harmless for any liability
174
+ incurred by, or claims asserted against, such Contributor by reason
175
+ of your accepting any such warranty or additional liability.
176
+
177
+ END OF TERMS AND CONDITIONS
178
+
179
+ APPENDIX: How to apply the Apache License to your work.
180
+
181
+ To apply the Apache License to your work, attach the following
182
+ boilerplate notice, with the fields enclosed by brackets "[]"
183
+ replaced with your own identifying information. (Don't include
184
+ the brackets!) The text should be enclosed in the appropriate
185
+ comment syntax for the file format. We also recommend that a
186
+ file or class name and description of purpose be included on the
187
+ same "printed page" as the copyright notice for easier
188
+ identification within third-party archives.
189
+
190
+ Copyright [yyyy] [name of copyright owner]
191
+
192
+ Licensed under the Apache License, Version 2.0 (the "License");
193
+ you may not use this file except in compliance with the License.
194
+ You may obtain a copy of the License at
195
+
196
+ http://www.apache.org/licenses/LICENSE-2.0
197
+
198
+ Unless required by applicable law or agreed to in writing, software
199
+ distributed under the License is distributed on an "AS IS" BASIS,
200
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201
+ See the License for the specific language governing permissions and
202
+ limitations under the License.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.91.0
data/lib/aws-sdk-s3.rb CHANGED
@@ -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
 
@@ -69,6 +69,6 @@ require_relative 'aws-sdk-s3/event_streams'
69
69
  # @!group service
70
70
  module Aws::S3
71
71
 
72
- GEM_VERSION = '1.88.0'
72
+ GEM_VERSION = '1.91.0'
73
73
 
74
74
  end
data/lib/aws-sdk-s3/bucket.rb CHANGED
@@ -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
 
@@ -456,7 +456,7 @@ module Aws::S3
456
456
  #
457
457
  # This action is not supported by Amazon S3 on Outposts.
458
458
  # @option options [required, String] :key
459
- # Object key for which the PUT operation was initiated.
459
+ # Object key for which the PUT action was initiated.
460
460
  # @option options [Hash<String,String>] :metadata
461
461
  # A map of metadata to store with the object in S3.
462
462
  # @option options [String] :server_side_encryption
@@ -533,8 +533,8 @@ module Aws::S3
533
533
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
534
534
  # for object encryption with SSE-KMS.
535
535
  #
536
- # Specifying this header with a PUT operation doesn’t affect
537
- # bucket-level settings for S3 Bucket Key.
536
+ # Specifying this header with a PUT action doesn’t affect bucket-level
537
+ # settings for S3 Bucket Key.
538
538
  # @option options [String] :request_payer
539
539
  # Confirms that the requester knows that they will be charged for the
540
540
  # request. Bucket owners need not specify this parameter in their
data/lib/aws-sdk-s3/bucket_acl.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_cors.rb CHANGED
@@ -3,7 +3,7 @@
3
3
  # WARNING ABOUT GENERATED CODE
4
4
  #
5
5
  # This file is generated. See the contributing guide for more information:
6
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
@@ -198,6 +198,7 @@ module Aws::S3
198
198
  # cors_configuration: { # required
199
199
  # cors_rules: [ # required
200
200
  # {
201
+ # id: "ID",
201
202
  # allowed_headers: ["AllowedHeader"],
202
203
  # allowed_methods: ["AllowedMethod"], # required
203
204
  # allowed_origins: ["AllowedOrigin"], # required
@@ -213,7 +214,7 @@ module Aws::S3
213
214
  # @option options [required, Types::CORSConfiguration] :cors_configuration
214
215
  # Describes the cross-origin access configuration for objects in an
215
216
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
216
- # Resource Sharing][1] in the *Amazon Simple Storage Service Developer
217
+ # Resource Sharing][1] in the *Amazon Simple Storage Service User
217
218
  # Guide*.
218
219
  #
219
220
  #
data/lib/aws-sdk-s3/bucket_lifecycle.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_logging.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_notification.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_policy.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_request_payment.rb CHANGED
@@ -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
- # &gt;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.
data/lib/aws-sdk-s3/bucket_tagging.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_versioning.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/bucket_website.rb CHANGED
@@ -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
 
data/lib/aws-sdk-s3/client.rb CHANGED
@@ -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
 
@@ -408,7 +408,7 @@ module Aws::S3
408
408
 
409
409
  # @!group API Operations
410
410
 
411
- # This operation aborts a multipart upload. After a multipart upload is
411
+ # This action aborts a multipart upload. After a multipart upload is
412
412
  # aborted, no additional parts can be uploaded using that upload ID. The
413
413
  # storage consumed by any previously uploaded parts will be freed.
414
414
  # However, if any part uploads are currently in progress, those part
@@ -417,11 +417,11 @@ module Aws::S3
417
417
  # completely free all storage consumed by all parts.
418
418
  #
419
419
  # 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
420
+ # for the part storage, you should call the [ListParts][1] action and
421
421
  # ensure that the parts list is empty.
422
422
  #
423
- # For information about permissions required to use the multipart upload
424
- # API, see [Multipart Upload API and Permissions][2].
423
+ # For information about permissions required to use the multipart
424
+ # upload, see [Multipart Upload and Permissions][2].
425
425
  #
426
426
  # The following operations are related to `AbortMultipartUpload`\:
427
427
  #
@@ -447,22 +447,22 @@ module Aws::S3
447
447
  # @option params [required, String] :bucket
448
448
  # The bucket name to which the upload was taking place.
449
449
  #
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
450
+ # When using this action with an access point, you must direct requests
451
+ # to the access point hostname. The access point hostname takes the form
452
452
  # *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
453
+ # When using this action with an access point through the AWS SDKs, you
454
+ # provide the access point ARN in place of the bucket name. For more
455
455
  # information about access point ARNs, see [Using Access Points][1] in
456
456
  # the *Amazon Simple Storage Service Developer Guide*.
457
457
  #
458
- # When using this API with Amazon S3 on Outposts, you must direct
458
+ # When using this action with Amazon S3 on Outposts, you must direct
459
459
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
460
460
  # takes the form
461
461
  # *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*.
462
+ # When using this action using S3 on Outposts through the AWS SDKs, you
463
+ # provide the Outposts bucket ARN in place of the bucket name. For more
464
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
465
+ # in the *Amazon Simple Storage Service Developer Guide*.
466
466
  #
467
467
  #
468
468
  #
@@ -537,11 +537,11 @@ module Aws::S3
537
537
  #
538
538
  # You first initiate the multipart upload and then upload all parts
539
539
  # using the [UploadPart][1] operation. After successfully uploading all
540
- # relevant parts of an upload, you call this operation to complete the
540
+ # relevant parts of an upload, you call this action to complete the
541
541
  # upload. Upon receiving this request, Amazon S3 concatenates all the
542
542
  # parts in ascending order by part number to create a new object. In the
543
543
  # Complete Multipart Upload request, you must provide the parts list.
544
- # You must ensure that the parts list is complete. This operation
544
+ # You must ensure that the parts list is complete. This action
545
545
  # concatenates the parts that you provide in the list. For each part in
546
546
  # the list, you must provide the part number and the `ETag` value,
547
547
  # returned after that part was uploaded.
@@ -563,7 +563,7 @@ module Aws::S3
563
563
  # Using Multipart Upload][3].
564
564
  #
565
565
  # For information about permissions required to use the multipart upload
566
- # API, see [Multipart Upload API and Permissions][4].
566
+ # API, see [Multipart Upload and Permissions][4].
567
567
  #
568
568
  # `CompleteMultipartUpload` has the following special errors:
569
569
  #
@@ -737,8 +737,8 @@ module Aws::S3
737
737
  #
738
738
  # <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
739
739
  # 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
740
+ # action using this API. However, to copy an object greater than 5 GB,
741
+ # you must use the multipart upload Upload Part - Copy API. For more
742
742
  # information, see [Copy Object Using the REST Multipart Upload API][1].
743
743
  #
744
744
  # </note>
@@ -752,12 +752,11 @@ module Aws::S3
752
752
  #
753
753
  # A copy request might return an error when Amazon S3 receives the copy
754
754
  # 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.
755
+ # before the copy action starts, you receive a standard Amazon S3 error.
756
+ # If the error occurs during the copy operation, the error response is
757
+ # embedded in the `200 OK` response. This means that a `200 OK` response
758
+ # can contain either a success or an error. Design your application to
759
+ # parse the contents of the response and handle it appropriately.
761
760
  #
762
761
  # If the copy is successful, you receive a response with information
763
762
  # about the copied object.
@@ -845,7 +844,7 @@ module Aws::S3
845
844
  #
846
845
  # If a target object uses SSE-KMS, you can enable an S3 Bucket Key for
847
846
  # the object. For more information, see [Amazon S3 Bucket Keys][9] in
848
- # the *Amazon Simple Storage Service Developer Guide*.
847
+ # the *Amazon Simple Storage Service User Guide*.
849
848
  #
850
849
  # **Access Control List (ACL)-Specific Request Headers**
851
850
  #
@@ -859,8 +858,8 @@ module Aws::S3
859
858
  #
860
859
  # **Storage Class Options**
861
860
  #
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`
861
+ # You can use the `CopyObject` action to change the storage class of an
862
+ # object that is already stored in Amazon S3 using the `StorageClass`
864
863
  # parameter. For more information, see [Storage Classes][12] in the
865
864
  # *Amazon S3 Service Developer Guide*.
866
865
  #
@@ -896,7 +895,7 @@ module Aws::S3
896
895
  #
897
896
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
898
897
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
899
- # [3]: https://aws.amazon.com/s3/pricing/
898
+ # [3]: http://aws.amazon.com/s3/pricing/
900
899
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
901
900
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
902
901
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html
@@ -919,22 +918,22 @@ module Aws::S3
919
918
  # @option params [required, String] :bucket
920
919
  # The name of the destination bucket.
921
920
  #
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
921
+ # When using this action with an access point, you must direct requests
922
+ # to the access point hostname. The access point hostname takes the form
924
923
  # *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
924
+ # When using this action with an access point through the AWS SDKs, you
925
+ # provide the access point ARN in place of the bucket name. For more
927
926
  # information about access point ARNs, see [Using Access Points][1] in
928
927
  # the *Amazon Simple Storage Service Developer Guide*.
929
928
  #
930
- # When using this API with Amazon S3 on Outposts, you must direct
929
+ # When using this action with Amazon S3 on Outposts, you must direct
931
930
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
932
931
  # takes the form
933
932
  # *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*.
933
+ # When using this action using S3 on Outposts through the AWS SDKs, you
934
+ # provide the Outposts bucket ARN in place of the bucket name. For more
935
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
936
+ # in the *Amazon Simple Storage Service Developer Guide*.
938
937
  #
939
938
  #
940
939
  #
@@ -1116,8 +1115,8 @@ module Aws::S3
1116
1115
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
1117
1116
  # for object encryption with SSE-KMS.
1118
1117
  #
1119
- # Specifying this header with a COPY operation doesn’t affect
1120
- # bucket-level settings for S3 Bucket Key.
1118
+ # Specifying this header with a COPY action doesn’t affect bucket-level
1119
+ # settings for S3 Bucket Key.
1121
1120
  #
1122
1121
  # @option params [String] :copy_source_sse_customer_algorithm
1123
1122
  # Specifies the algorithm to use when decrypting the source object (for
@@ -1476,7 +1475,7 @@ module Aws::S3
1476
1475
  req.send_request(options)
1477
1476
  end
1478
1477
 
1479
- # This operation initiates a multipart upload and returns an upload ID.
1478
+ # This action initiates a multipart upload and returns an upload ID.
1480
1479
  # This upload ID is used to associate all of the parts in the specific
1481
1480
  # multipart upload. You specify this upload ID in each of your
1482
1481
  # subsequent upload part requests (see [UploadPart][1]). You also
@@ -1489,12 +1488,12 @@ module Aws::S3
1489
1488
  # If you have configured a lifecycle rule to abort incomplete multipart
1490
1489
  # uploads, the upload must complete within the number of days specified
1491
1490
  # in the bucket lifecycle configuration. Otherwise, the incomplete
1492
- # multipart upload becomes eligible for an abort operation and Amazon S3
1491
+ # multipart upload becomes eligible for an abort action and Amazon S3
1493
1492
  # aborts the multipart upload. For more information, see [Aborting
1494
1493
  # Incomplete Multipart Uploads Using a Bucket Lifecycle Policy][3].
1495
1494
  #
1496
1495
  # For information about the permissions required to use the multipart
1497
- # upload API, see [Multipart Upload API and Permissions][4].
1496
+ # upload API, see [Multipart Upload and Permissions][4].
1498
1497
  #
1499
1498
  # For request signing, multipart upload is just a series of regular
1500
1499
  # requests. You initiate a multipart upload, send one or more requests
@@ -1517,9 +1516,9 @@ module Aws::S3
1517
1516
  # your own encryption key, or use AWS Key Management Service (AWS KMS)
1518
1517
  # customer master keys (CMKs) or Amazon S3-managed encryption keys. If
1519
1518
  # 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`.
1519
+ # provide in [UploadPart][1] and [UploadPartCopy][6] requests must match
1520
+ # the headers you used in the request to initiate the upload by using
1521
+ # `CreateMultipartUpload`.
1523
1522
  #
1524
1523
  # To perform a multipart upload with encryption using an AWS KMS CMK,
1525
1524
  # the requester must have permission to the `kms:Encrypt`,
@@ -1717,22 +1716,22 @@ module Aws::S3
1717
1716
  # @option params [required, String] :bucket
1718
1717
  # The name of the bucket to which to initiate the upload
1719
1718
  #
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
1719
+ # When using this action with an access point, you must direct requests
1720
+ # to the access point hostname. The access point hostname takes the form
1722
1721
  # *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
1722
+ # When using this action with an access point through the AWS SDKs, you
1723
+ # provide the access point ARN in place of the bucket name. For more
1725
1724
  # information about access point ARNs, see [Using Access Points][1] in
1726
1725
  # the *Amazon Simple Storage Service Developer Guide*.
1727
1726
  #
1728
- # When using this API with Amazon S3 on Outposts, you must direct
1727
+ # When using this action with Amazon S3 on Outposts, you must direct
1729
1728
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1730
1729
  # takes the form
1731
1730
  # *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*.
1731
+ # When using this action using S3 on Outposts through the AWS SDKs, you
1732
+ # provide the Outposts bucket ARN in place of the bucket name. For more
1733
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
1734
+ # in the *Amazon Simple Storage Service Developer Guide*.
1736
1735
  #
1737
1736
  #
1738
1737
  #
@@ -1833,7 +1832,7 @@ module Aws::S3
1833
1832
  #
1834
1833
  #
1835
1834
  #
1836
- # [1]: https://docs.aws.amazon.com/http:/docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
1835
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
1837
1836
  #
1838
1837
  # @option params [String] :ssekms_encryption_context
1839
1838
  # Specifies the AWS KMS Encryption Context to use for object encryption.
@@ -1846,7 +1845,7 @@ module Aws::S3
1846
1845
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
1847
1846
  # for object encryption with SSE-KMS.
1848
1847
  #
1849
- # Specifying this header with an object operation doesn’t affect
1848
+ # Specifying this header with an object action doesn’t affect
1850
1849
  # bucket-level settings for S3 Bucket Key.
1851
1850
  #
1852
1851
  # @option params [String] :request_payer
@@ -2091,7 +2090,7 @@ module Aws::S3
2091
2090
  # default and can grant this permission to others.
2092
2091
  #
2093
2092
  # For information about `cors`, see [Enabling Cross-Origin Resource
2094
- # Sharing][1] in the *Amazon Simple Storage Service Developer Guide*.
2093
+ # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
2095
2094
  #
2096
2095
  # **Related Resources:**
2097
2096
  #
@@ -2140,10 +2139,10 @@ module Aws::S3
2140
2139
  req.send_request(options)
2141
2140
  end
2142
2141
 
2143
- # This implementation of the DELETE operation removes default encryption
2142
+ # This implementation of the DELETE action removes default encryption
2144
2143
  # from the bucket. For information about the Amazon S3 default
2145
2144
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
2146
- # the *Amazon Simple Storage Service Developer Guide*.
2145
+ # the *Amazon Simple Storage Service User Guide*.
2147
2146
  #
2148
2147
  # To use this operation, you must have permissions to perform the
2149
2148
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
@@ -2151,7 +2150,7 @@ module Aws::S3
2151
2150
  # others. For more information about permissions, see [Permissions
2152
2151
  # Related to Bucket Subresource Operations][2] and [Managing Access
2153
2152
  # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
2154
- # Storage Service Developer Guide*.
2153
+ # Storage Service User Guide*.
2155
2154
  #
2156
2155
  # **Related Resources**
2157
2156
  #
@@ -2491,12 +2490,12 @@ module Aws::S3
2491
2490
  req.send_request(options)
2492
2491
  end
2493
2492
 
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.
2493
+ # This implementation of the DELETE action uses the policy subresource
2494
+ # to delete the policy of a specified bucket. If you are using an
2495
+ # identity other than the root user of the AWS account that owns the
2496
+ # bucket, the calling identity must have the `DeleteBucketPolicy`
2497
+ # permissions on the specified bucket and belong to the bucket owner's
2498
+ # account to use this operation.
2500
2499
  #
2501
2500
  # If you don't have `DeleteBucketPolicy` permissions, Amazon S3 returns
2502
2501
  # a `403 Access Denied` error. If you have the correct permissions, but
@@ -2508,19 +2507,19 @@ module Aws::S3
2508
2507
  # denies the root user the ability to perform this action.
2509
2508
  #
2510
2509
  # 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).
2510
+ # and UserPolicies][1].
2513
2511
  #
2514
2512
  # The following operations are related to `DeleteBucketPolicy`
2515
2513
  #
2516
- # * [CreateBucket][1]
2514
+ # * [CreateBucket][2]
2517
2515
  #
2518
- # * [DeleteObject][2]
2516
+ # * [DeleteObject][3]
2519
2517
  #
2520
2518
  #
2521
2519
  #
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
2520
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
2521
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
2522
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
2524
2523
  #
2525
2524
  # @option params [required, String] :bucket
2526
2525
  # The bucket name.
@@ -2571,22 +2570,22 @@ module Aws::S3
2571
2570
  #
2572
2571
  # </note>
2573
2572
  #
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*.
2573
+ # For information about replication configuration, see [Replication][3]
2574
+ # in the *Amazon S3 Developer Guide*.
2577
2575
  #
2578
2576
  # The following operations are related to `DeleteBucketReplication`\:
2579
2577
  #
2580
- # * [PutBucketReplication][3]
2578
+ # * [PutBucketReplication][4]
2581
2579
  #
2582
- # * [GetBucketReplication][4]
2580
+ # * [GetBucketReplication][5]
2583
2581
  #
2584
2582
  #
2585
2583
  #
2586
2584
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2587
2585
  # [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
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
2587
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
2588
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
2590
2589
  #
2591
2590
  # @option params [required, String] :bucket
2592
2591
  # The bucket name.
@@ -2675,18 +2674,18 @@ module Aws::S3
2675
2674
  req.send_request(options)
2676
2675
  end
2677
2676
 
2678
- # This operation removes the website configuration for a bucket. Amazon
2679
- # S3 returns a `200 OK` response upon successfully deleting a website
2677
+ # This action removes the website configuration for a bucket. Amazon S3
2678
+ # returns a `200 OK` response upon successfully deleting a website
2680
2679
  # configuration on the specified bucket. You will get a `200 OK`
2681
2680
  # response if the website configuration you are trying to delete does
2682
2681
  # not exist on the bucket. Amazon S3 returns a `404` response if the
2683
2682
  # bucket specified in the request does not exist.
2684
2683
  #
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.
2684
+ # This DELETE action requires the `S3:DeleteBucketWebsite` permission.
2685
+ # By default, only the bucket owner can delete the website configuration
2686
+ # attached to a bucket. However, bucket owners can grant other users
2687
+ # permission to delete the website configuration by writing a bucket
2688
+ # policy granting them the `S3:DeleteBucketWebsite` permission.
2690
2689
  #
2691
2690
  # For more information about hosting websites, see [Hosting Websites on
2692
2691
  # Amazon S3][1].
@@ -2757,14 +2756,14 @@ module Aws::S3
2757
2756
  # For more information about MFA Delete, see [Using MFA Delete][1]. To
2758
2757
  # see sample requests that use versioning, see [Sample Request][2].
2759
2758
  #
2760
- # You can delete objects by explicitly calling the DELETE Object API or
2759
+ # You can delete objects by explicitly calling DELETE Object or
2761
2760
  # configure its lifecycle ([PutBucketLifecycle][3]) to enable Amazon S3
2762
2761
  # to remove them for you. If you want to block users or accounts from
2763
2762
  # removing or deleting objects from your bucket, you must deny them the
2764
2763
  # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
2765
2764
  # `s3:PutLifeCycleConfiguration` actions.
2766
2765
  #
2767
- # The following operation is related to `DeleteObject`\:
2766
+ # The following action is related to `DeleteObject`\:
2768
2767
  #
2769
2768
  # * [PutObject][4]
2770
2769
  #
@@ -2780,22 +2779,22 @@ module Aws::S3
2780
2779
  # @option params [required, String] :bucket
2781
2780
  # The bucket name of the bucket containing the object.
2782
2781
  #
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
2782
+ # When using this action with an access point, you must direct requests
2783
+ # to the access point hostname. The access point hostname takes the form
2785
2784
  # *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
2785
+ # When using this action with an access point through the AWS SDKs, you
2786
+ # provide the access point ARN in place of the bucket name. For more
2788
2787
  # information about access point ARNs, see [Using Access Points][1] in
2789
2788
  # the *Amazon Simple Storage Service Developer Guide*.
2790
2789
  #
2791
- # When using this API with Amazon S3 on Outposts, you must direct
2790
+ # When using this action with Amazon S3 on Outposts, you must direct
2792
2791
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2793
2792
  # takes the form
2794
2793
  # *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*.
2794
+ # When using this action using S3 on Outposts through the AWS SDKs, you
2795
+ # provide the Outposts bucket ARN in place of the bucket name. For more
2796
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2797
+ # in the *Amazon Simple Storage Service Developer Guide*.
2799
2798
  #
2800
2799
  #
2801
2800
  #
@@ -2916,22 +2915,22 @@ module Aws::S3
2916
2915
  # @option params [required, String] :bucket
2917
2916
  # The bucket name containing the objects from which to remove the tags.
2918
2917
  #
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
2918
+ # When using this action with an access point, you must direct requests
2919
+ # to the access point hostname. The access point hostname takes the form
2921
2920
  # *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
2921
+ # When using this action with an access point through the AWS SDKs, you
2922
+ # provide the access point ARN in place of the bucket name. For more
2924
2923
  # information about access point ARNs, see [Using Access Points][1] in
2925
2924
  # the *Amazon Simple Storage Service Developer Guide*.
2926
2925
  #
2927
- # When using this API with Amazon S3 on Outposts, you must direct
2926
+ # When using this action with Amazon S3 on Outposts, you must direct
2928
2927
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2929
2928
  # takes the form
2930
2929
  # *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*.
2930
+ # When using this action using S3 on Outposts through the AWS SDKs, you
2931
+ # provide the Outposts bucket ARN in place of the bucket name. For more
2932
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2933
+ # in the *Amazon Simple Storage Service Developer Guide*.
2935
2934
  #
2936
2935
  #
2937
2936
  #
@@ -2939,7 +2938,8 @@ module Aws::S3
2939
2938
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2940
2939
  #
2941
2940
  # @option params [required, String] :key
2942
- # Name of the object key.
2941
+ # The key that identifies the object in the bucket from which to remove
2942
+ # all tags.
2943
2943
  #
2944
2944
  # @option params [String] :version_id
2945
2945
  # The versionId of the object that the tag-set will be removed from.
@@ -3007,27 +3007,27 @@ module Aws::S3
3007
3007
  req.send_request(options)
3008
3008
  end
3009
3009
 
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.
3010
+ # This action enables you to delete multiple objects from a bucket using
3011
+ # a single HTTP request. If you know the object keys that you want to
3012
+ # delete, then this action provides a suitable alternative to sending
3013
+ # individual delete requests, reducing per-request overhead.
3014
3014
  #
3015
3015
  # The request contains a list of up to 1000 keys that you want to
3016
3016
  # delete. In the XML, you provide the object key names, and optionally,
3017
3017
  # version IDs if you want to delete a specific version of the object
3018
3018
  # from a versioning-enabled bucket. For each key, Amazon S3 performs a
3019
- # delete operation and returns the result of that delete, success, or
3019
+ # delete action and returns the result of that delete, success, or
3020
3020
  # failure, in the response. Note that if the object specified in the
3021
3021
  # request is not found, Amazon S3 returns the result as deleted.
3022
3022
  #
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.
3023
+ # The action supports two modes for the response: verbose and quiet. By
3024
+ # default, the action uses verbose mode in which the response includes
3025
+ # the result of deletion of each key in your request. In quiet mode the
3026
+ # response includes only keys where the delete action encountered an
3027
+ # error. For a successful deletion, the action does not return any
3028
+ # information about the delete in the response body.
3029
3029
  #
3030
- # When performing this operation on an MFA Delete enabled bucket, that
3030
+ # When performing this action on an MFA Delete enabled bucket, that
3031
3031
  # attempts to delete any versioned objects, you must include an MFA
3032
3032
  # token. If you do not provide one, the entire request will fail, even
3033
3033
  # if there are non-versioned objects you are trying to delete. If you
@@ -3063,22 +3063,22 @@ module Aws::S3
3063
3063
  # @option params [required, String] :bucket
3064
3064
  # The bucket name containing the objects to delete.
3065
3065
  #
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
3066
+ # When using this action with an access point, you must direct requests
3067
+ # to the access point hostname. The access point hostname takes the form
3068
3068
  # *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
3069
+ # When using this action with an access point through the AWS SDKs, you
3070
+ # provide the access point ARN in place of the bucket name. For more
3071
3071
  # information about access point ARNs, see [Using Access Points][1] in
3072
3072
  # the *Amazon Simple Storage Service Developer Guide*.
3073
3073
  #
3074
- # When using this API with Amazon S3 on Outposts, you must direct
3074
+ # When using this action with Amazon S3 on Outposts, you must direct
3075
3075
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
3076
3076
  # takes the form
3077
3077
  # *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*.
3078
+ # When using this action using S3 on Outposts through the AWS SDKs, you
3079
+ # provide the Outposts bucket ARN in place of the bucket name. For more
3080
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
3081
+ # in the *Amazon Simple Storage Service Developer Guide*.
3082
3082
  #
3083
3083
  #
3084
3084
  #
@@ -3122,22 +3122,20 @@ module Aws::S3
3122
3122
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
3123
3123
  #
3124
3124
  #
3125
- # @example Example: To delete multiple object versions from a versioned bucket
3125
+ # @example Example: To delete multiple objects from a versioned bucket
3126
3126
  #
3127
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3128
- # # versions and returns the key and versions of deleted objects in the response.
3127
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3128
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3129
3129
  #
3130
3130
  # resp = client.delete_objects({
3131
3131
  # bucket: "examplebucket",
3132
3132
  # delete: {
3133
3133
  # objects: [
3134
3134
  # {
3135
- # key: "HappyFace.jpg",
3136
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3135
+ # key: "objectkey1",
3137
3136
  # },
3138
3137
  # {
3139
- # key: "HappyFace.jpg",
3140
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3138
+ # key: "objectkey2",
3141
3139
  # },
3142
3140
  # ],
3143
3141
  # quiet: false,
@@ -3148,30 +3146,34 @@ module Aws::S3
3148
3146
  # {
3149
3147
  # deleted: [
3150
3148
  # {
3151
- # key: "HappyFace.jpg",
3152
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3149
+ # delete_marker: true,
3150
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3151
+ # key: "objectkey1",
3153
3152
  # },
3154
3153
  # {
3155
- # key: "HappyFace.jpg",
3156
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3154
+ # delete_marker: true,
3155
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3156
+ # key: "objectkey2",
3157
3157
  # },
3158
3158
  # ],
3159
3159
  # }
3160
3160
  #
3161
- # @example Example: To delete multiple objects from a versioned bucket
3161
+ # @example Example: To delete multiple object versions from a versioned bucket
3162
3162
  #
3163
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3164
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3163
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3164
+ # # versions and returns the key and versions of deleted objects in the response.
3165
3165
  #
3166
3166
  # resp = client.delete_objects({
3167
3167
  # bucket: "examplebucket",
3168
3168
  # delete: {
3169
3169
  # objects: [
3170
3170
  # {
3171
- # key: "objectkey1",
3171
+ # key: "HappyFace.jpg",
3172
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3172
3173
  # },
3173
3174
  # {
3174
- # key: "objectkey2",
3175
+ # key: "HappyFace.jpg",
3176
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3175
3177
  # },
3176
3178
  # ],
3177
3179
  # quiet: false,
@@ -3182,14 +3184,12 @@ module Aws::S3
3182
3184
  # {
3183
3185
  # deleted: [
3184
3186
  # {
3185
- # delete_marker: true,
3186
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3187
- # key: "objectkey1",
3187
+ # key: "HappyFace.jpg",
3188
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3188
3189
  # },
3189
3190
  # {
3190
- # delete_marker: true,
3191
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3192
- # key: "objectkey2",
3191
+ # key: "HappyFace.jpg",
3192
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3193
3193
  # },
3194
3194
  # ],
3195
3195
  # }
@@ -3289,7 +3289,7 @@ module Aws::S3
3289
3289
  req.send_request(options)
3290
3290
  end
3291
3291
 
3292
- # This implementation of the GET operation uses the `accelerate`
3292
+ # This implementation of the GET action uses the `accelerate`
3293
3293
  # subresource to return the Transfer Acceleration state of a bucket,
3294
3294
  # which is either `Enabled` or `Suspended`. Amazon S3 Transfer
3295
3295
  # Acceleration is a bucket-level feature that enables you to perform
@@ -3301,7 +3301,7 @@ module Aws::S3
3301
3301
  # others. For more information about permissions, see [Permissions
3302
3302
  # Related to Bucket Subresource Operations][1] and [Managing Access
3303
3303
  # Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
3304
- # Storage Service Developer Guide*.
3304
+ # Storage Service User Guide*.
3305
3305
  #
3306
3306
  # You set the Transfer Acceleration state of an existing bucket to
3307
3307
  # `Enabled` or `Suspended` by using the
@@ -3312,7 +3312,7 @@ module Aws::S3
3312
3312
  # Acceleration state if a state has never been set on the bucket.
3313
3313
  #
3314
3314
  # For more information about transfer acceleration, see [Transfer
3315
- # Acceleration][4] in the Amazon Simple Storage Service Developer Guide.
3315
+ # Acceleration][4] in the Amazon Simple Storage Service User Guide.
3316
3316
  #
3317
3317
  # **Related Resources**
3318
3318
  #
@@ -3360,8 +3360,8 @@ module Aws::S3
3360
3360
  req.send_request(options)
3361
3361
  end
3362
3362
 
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
3363
+ # This implementation of the `GET` action uses the `acl` subresource to
3364
+ # return the access control list (ACL) of a bucket. To use `GET` to
3365
3365
  # return the ACL of the bucket, you must have `READ_ACP` access to the
3366
3366
  # bucket. If `READ_ACP` permission is granted to the anonymous user, you
3367
3367
  # can return the ACL of the bucket without using an authorization
@@ -3418,7 +3418,7 @@ module Aws::S3
3418
3418
  req.send_request(options)
3419
3419
  end
3420
3420
 
3421
- # This implementation of the GET operation returns an analytics
3421
+ # This implementation of the GET action returns an analytics
3422
3422
  # configuration (identified by the analytics configuration ID) from the
3423
3423
  # bucket.
3424
3424
  #
@@ -3428,11 +3428,11 @@ module Aws::S3
3428
3428
  # others. For more information about permissions, see [ Permissions
3429
3429
  # Related to Bucket Subresource Operations][1] and [Managing Access
3430
3430
  # Permissions to Your Amazon S3 Resources][2] in the *Amazon Simple
3431
- # Storage Service Developer Guide*.
3431
+ # Storage Service User Guide*.
3432
3432
  #
3433
3433
  # For information about Amazon S3 analytics feature, see [Amazon S3
3434
3434
  # Analytics – Storage Class Analysis][3] in the *Amazon Simple Storage
3435
- # Service Developer Guide*.
3435
+ # Service User Guide*.
3436
3436
  #
3437
3437
  # **Related Resources**
3438
3438
  #
@@ -3570,6 +3570,7 @@ module Aws::S3
3570
3570
  # @example Response structure
3571
3571
  #
3572
3572
  # resp.cors_rules #=> Array
3573
+ # resp.cors_rules[0].id #=> String
3573
3574
  # resp.cors_rules[0].allowed_headers #=> Array
3574
3575
  # resp.cors_rules[0].allowed_headers[0] #=> String
3575
3576
  # resp.cors_rules[0].allowed_methods #=> Array
@@ -3590,6 +3591,10 @@ module Aws::S3
3590
3591
  end
3591
3592
 
3592
3593
  # Returns the default encryption configuration for an Amazon S3 bucket.
3594
+ # If the bucket does not have a default encryption configuration,
3595
+ # GetBucketEncryption returns
3596
+ # `ServerSideEncryptionConfigurationNotFoundError`.
3597
+ #
3593
3598
  # For information about the Amazon S3 default encryption feature, see
3594
3599
  # [Amazon S3 Default Bucket Encryption][1].
3595
3600
  #
@@ -3926,7 +3931,7 @@ module Aws::S3
3926
3931
  # API. The response describes the new filter element that you can use to
3927
3932
  # specify a filter to select a subset of objects to which the rule
3928
3933
  # applies. If you are using a previous version of the lifecycle
3929
- # configuration, it still works. For the earlier API description, see
3934
+ # configuration, it still works. For the earlier action, see
3930
3935
  # [GetBucketLifecycle][1].
3931
3936
  #
3932
3937
  # </note>
@@ -4362,8 +4367,8 @@ module Aws::S3
4362
4367
 
4363
4368
  # Returns the notification configuration of a bucket.
4364
4369
  #
4365
- # If notifications are not enabled on the bucket, the operation returns
4366
- # an empty `NotificationConfiguration` element.
4370
+ # If notifications are not enabled on the bucket, the action returns an
4371
+ # empty `NotificationConfiguration` element.
4367
4372
  #
4368
4373
  # By default, you must be the bucket owner to read the notification
4369
4374
  # configuration of a bucket. However, the bucket owner can use a bucket
@@ -4375,7 +4380,7 @@ module Aws::S3
4375
4380
  # Events][1]. For more information about bucket policies, see [Using
4376
4381
  # Bucket Policies][2].
4377
4382
  #
4378
- # The following operation is related to `GetBucketNotification`\:
4383
+ # The following action is related to `GetBucketNotification`\:
4379
4384
  #
4380
4385
  # * [PutBucketNotification][3]
4381
4386
  #
@@ -4516,7 +4521,7 @@ module Aws::S3
4516
4521
  # For more information about bucket policies, see [Using Bucket Policies
4517
4522
  # and User Policies][1].
4518
4523
  #
4519
- # The following operation is related to `GetBucketPolicy`\:
4524
+ # The following action is related to `GetBucketPolicy`\:
4520
4525
  #
4521
4526
  # * [GetObject][2]
4522
4527
  #
@@ -4643,9 +4648,9 @@ module Aws::S3
4643
4648
  # </note>
4644
4649
  #
4645
4650
  # For information about replication configuration, see [Replication][1]
4646
- # in the *Amazon Simple Storage Service Developer Guide*.
4651
+ # in the *Amazon Simple Storage Service User Guide*.
4647
4652
  #
4648
- # This operation requires permissions for the
4653
+ # This action requires permissions for the
4649
4654
  # `s3:GetReplicationConfiguration` action. For more information about
4650
4655
  # permissions, see [Using Bucket Policies and User Policies][2].
4651
4656
  #
@@ -4975,7 +4980,7 @@ module Aws::S3
4975
4980
  # configuration. For more information about hosting websites, see
4976
4981
  # [Hosting Websites on Amazon S3][1].
4977
4982
  #
4978
- # This GET operation requires the `S3:GetBucketWebsite` permission. By
4983
+ # This GET action requires the `S3:GetBucketWebsite` permission. By
4979
4984
  # default, only the bucket owner can read the bucket website
4980
4985
  # configuration. However, bucket owners can allow other users to read
4981
4986
  # the website configuration by writing a bucket policy granting them the
@@ -5087,9 +5092,9 @@ module Aws::S3
5087
5092
  # Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive
5088
5093
  # or S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve
5089
5094
  # 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].
5095
+ # Otherwise, this action returns an `InvalidObjectStateError` error. For
5096
+ # information about restoring archived objects, see [Restoring Archived
5097
+ # Objects][5].
5093
5098
  #
5094
5099
  # Encryption request headers, like `x-amz-server-side-encryption`,
5095
5100
  # should not be sent for GET requests if your object uses server-side
@@ -5133,9 +5138,8 @@ module Aws::S3
5133
5138
  #
5134
5139
  # **Versioning**
5135
5140
  #
5136
- # By default, the GET operation returns the current version of an
5137
- # object. To return a different version, use the `versionId`
5138
- # subresource.
5141
+ # By default, the GET action returns the current version of an object.
5142
+ # To return a different version, use the `versionId` subresource.
5139
5143
  #
5140
5144
  # <note markdown="1"> If the current version of the object is a delete marker, Amazon S3
5141
5145
  # behaves as if the object was deleted and includes
@@ -5220,22 +5224,22 @@ module Aws::S3
5220
5224
  # @option params [required, String] :bucket
5221
5225
  # The bucket name containing the object.
5222
5226
  #
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
5227
+ # When using this action with an access point, you must direct requests
5228
+ # to the access point hostname. The access point hostname takes the form
5225
5229
  # *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
5230
+ # When using this action with an access point through the AWS SDKs, you
5231
+ # provide the access point ARN in place of the bucket name. For more
5228
5232
  # information about access point ARNs, see [Using Access Points][1] in
5229
5233
  # the *Amazon Simple Storage Service Developer Guide*.
5230
5234
  #
5231
- # When using this API with Amazon S3 on Outposts, you must direct
5235
+ # When using this action with Amazon S3 on Outposts, you must direct
5232
5236
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5233
5237
  # takes the form
5234
5238
  # *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*.
5239
+ # When using this action using S3 on Outposts through the AWS SDKs, you
5240
+ # provide the Outposts bucket ARN in place of the bucket name. For more
5241
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5242
+ # in the *Amazon Simple Storage Service Developer Guide*.
5239
5243
  #
5240
5244
  #
5241
5245
  #
@@ -5297,14 +5301,14 @@ module Aws::S3
5297
5301
  # VersionId used to reference a specific version of the object.
5298
5302
  #
5299
5303
  # @option params [String] :sse_customer_algorithm
5300
- # Specifies the algorithm to use to when encrypting the object (for
5304
+ # Specifies the algorithm to use to when decrypting the object (for
5301
5305
  # example, AES256).
5302
5306
  #
5303
5307
  # @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
5308
+ # Specifies the customer-provided encryption key for Amazon S3 used to
5309
+ # encrypt the data. This value is used to decrypt the object when
5310
+ # recovering it and must match the one used when storing the data. The
5311
+ # key must be appropriate for use with the algorithm specified in the
5308
5312
  # `x-amz-server-side-encryption-customer-algorithm` header.
5309
5313
  #
5310
5314
  # @option params [String] :sse_customer_key_md5
@@ -5546,11 +5550,11 @@ module Aws::S3
5546
5550
  # The bucket name that contains the object for which to get the ACL
5547
5551
  # information.
5548
5552
  #
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
5553
+ # When using this action with an access point, you must direct requests
5554
+ # to the access point hostname. The access point hostname takes the form
5551
5555
  # *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
5556
+ # When using this action with an access point through the AWS SDKs, you
5557
+ # provide the access point ARN in place of the bucket name. For more
5554
5558
  # information about access point ARNs, see [Using Access Points][1] in
5555
5559
  # the *Amazon Simple Storage Service Developer Guide*.
5556
5560
  #
@@ -5683,11 +5687,11 @@ module Aws::S3
5683
5687
  # The bucket name containing the object whose Legal Hold status you want
5684
5688
  # to retrieve.
5685
5689
  #
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
5690
+ # When using this action with an access point, you must direct requests
5691
+ # to the access point hostname. The access point hostname takes the form
5688
5692
  # *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
5693
+ # When using this action with an access point through the AWS SDKs, you
5694
+ # provide the access point ARN in place of the bucket name. For more
5691
5695
  # information about access point ARNs, see [Using Access Points][1] in
5692
5696
  # the *Amazon Simple Storage Service Developer Guide*.
5693
5697
  #
@@ -5758,11 +5762,11 @@ module Aws::S3
5758
5762
  # @option params [required, String] :bucket
5759
5763
  # The bucket whose Object Lock configuration you want to retrieve.
5760
5764
  #
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
5765
+ # When using this action with an access point, you must direct requests
5766
+ # to the access point hostname. The access point hostname takes the form
5763
5767
  # *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
5768
+ # When using this action with an access point through the AWS SDKs, you
5769
+ # provide the access point ARN in place of the bucket name. For more
5766
5770
  # information about access point ARNs, see [Using Access Points][1] in
5767
5771
  # the *Amazon Simple Storage Service Developer Guide*.
5768
5772
  #
@@ -5815,11 +5819,11 @@ module Aws::S3
5815
5819
  # The bucket name containing the object whose retention settings you
5816
5820
  # want to retrieve.
5817
5821
  #
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
5822
+ # When using this action with an access point, you must direct requests
5823
+ # to the access point hostname. The access point hostname takes the form
5820
5824
  # *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
5825
+ # When using this action with an access point through the AWS SDKs, you
5826
+ # provide the access point ARN in place of the bucket name. For more
5823
5827
  # information about access point ARNs, see [Using Access Points][1] in
5824
5828
  # the *Amazon Simple Storage Service Developer Guide*.
5825
5829
  #
@@ -5883,7 +5887,7 @@ module Aws::S3
5883
5887
  # tagging subresource associated with the object.
5884
5888
  #
5885
5889
  # To use this operation, you must have permission to perform the
5886
- # `s3:GetObjectTagging` action. By default, the GET operation returns
5890
+ # `s3:GetObjectTagging` action. By default, the GET action returns
5887
5891
  # information about current version of an object. For a versioned
5888
5892
  # bucket, you can have multiple versions of an object in your bucket. To
5889
5893
  # retrieve tags of any other version, use the versionId query parameter.
@@ -5895,37 +5899,38 @@ module Aws::S3
5895
5899
  # For information about the Amazon S3 object tagging feature, see
5896
5900
  # [Object Tagging][1].
5897
5901
  #
5898
- # The following operation is related to `GetObjectTagging`\:
5902
+ # The following action is related to `GetObjectTagging`\:
5899
5903
  #
5900
5904
  # * [PutObjectTagging][2]
5901
5905
  #
5902
- # ^
5906
+ # * [DeleteObjectTagging][3]
5903
5907
  #
5904
5908
  #
5905
5909
  #
5906
5910
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
5907
5911
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html
5912
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html
5908
5913
  #
5909
5914
  # @option params [required, String] :bucket
5910
5915
  # The bucket name containing the object for which to get the tagging
5911
5916
  # information.
5912
5917
  #
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
5918
+ # When using this action with an access point, you must direct requests
5919
+ # to the access point hostname. The access point hostname takes the form
5915
5920
  # *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
5921
+ # When using this action with an access point through the AWS SDKs, you
5922
+ # provide the access point ARN in place of the bucket name. For more
5918
5923
  # information about access point ARNs, see [Using Access Points][1] in
5919
5924
  # the *Amazon Simple Storage Service Developer Guide*.
5920
5925
  #
5921
- # When using this API with Amazon S3 on Outposts, you must direct
5926
+ # When using this action with Amazon S3 on Outposts, you must direct
5922
5927
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5923
5928
  # takes the form
5924
5929
  # *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*.
5930
+ # When using this action using S3 on Outposts through the AWS SDKs, you
5931
+ # provide the Outposts bucket ARN in place of the bucket name. For more
5932
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5933
+ # in the *Amazon Simple Storage Service Developer Guide*.
5929
5934
  #
5930
5935
  #
5931
5936
  #
@@ -5943,6 +5948,17 @@ module Aws::S3
5943
5948
  # a different account, the request will fail with an HTTP `403 (Access
5944
5949
  # Denied)` error.
5945
5950
  #
5951
+ # @option params [String] :request_payer
5952
+ # Confirms that the requester knows that they will be charged for the
5953
+ # request. Bucket owners need not specify this parameter in their
5954
+ # requests. For information about downloading objects from requester
5955
+ # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5956
+ # in the *Amazon S3 Developer Guide*.
5957
+ #
5958
+ #
5959
+ #
5960
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5961
+ #
5946
5962
  # @return [Types::GetObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5947
5963
  #
5948
5964
  # * {Types::GetObjectTaggingOutput#version_id #version_id} => String
@@ -6001,6 +6017,7 @@ module Aws::S3
6001
6017
  # key: "ObjectKey", # required
6002
6018
  # version_id: "ObjectVersionId",
6003
6019
  # expected_bucket_owner: "AccountId",
6020
+ # request_payer: "requester", # accepts requester
6004
6021
  # })
6005
6022
  #
6006
6023
  # @example Response structure
@@ -6033,7 +6050,7 @@ module Aws::S3
6033
6050
  #
6034
6051
  # This action is not supported by Amazon S3 on Outposts.
6035
6052
  #
6036
- # The following operation is related to `GetObjectTorrent`\:
6053
+ # The following action is related to `GetObjectTorrent`\:
6037
6054
  #
6038
6055
  # * [GetObject][2]
6039
6056
  #
@@ -6183,11 +6200,14 @@ module Aws::S3
6183
6200
  req.send_request(options)
6184
6201
  end
6185
6202
 
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`.
6203
+ # This action is useful to determine if a bucket exists and you have
6204
+ # permission to access it. The action returns a `200 OK` if the bucket
6205
+ # exists and you have permission to access it.
6206
+ #
6207
+ # If the bucket does not exist or you do not have permission to access
6208
+ # it, the `HEAD` request returns a generic `404 Not Found` or `403
6209
+ # Forbidden` code. A message body is not included, so you cannot
6210
+ # determine the exception beyond these error codes.
6191
6211
  #
6192
6212
  # To use this operation, you must have permissions to perform the
6193
6213
  # `s3:ListBucket` action. The bucket owner has this permission by
@@ -6204,22 +6224,22 @@ module Aws::S3
6204
6224
  # @option params [required, String] :bucket
6205
6225
  # The bucket name.
6206
6226
  #
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
6227
+ # When using this action with an access point, you must direct requests
6228
+ # to the access point hostname. The access point hostname takes the form
6209
6229
  # *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
6230
+ # When using this action with an access point through the AWS SDKs, you
6231
+ # provide the access point ARN in place of the bucket name. For more
6212
6232
  # information about access point ARNs, see [Using Access Points][1] in
6213
6233
  # the *Amazon Simple Storage Service Developer Guide*.
6214
6234
  #
6215
- # When using this API with Amazon S3 on Outposts, you must direct
6235
+ # When using this action with Amazon S3 on Outposts, you must direct
6216
6236
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6217
6237
  # takes the form
6218
6238
  # *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*.
6239
+ # When using this action using S3 on Outposts through the AWS SDKs, you
6240
+ # provide the Outposts bucket ARN in place of the bucket name. For more
6241
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6242
+ # in the *Amazon Simple Storage Service Developer Guide*.
6223
6243
  #
6224
6244
  #
6225
6245
  #
@@ -6264,14 +6284,17 @@ module Aws::S3
6264
6284
  req.send_request(options)
6265
6285
  end
6266
6286
 
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.
6287
+ # The HEAD action retrieves metadata from an object without returning
6288
+ # the object itself. This action is useful if you're only interested in
6289
+ # an object's metadata. To use HEAD, you must have READ access to the
6290
+ # object.
6291
+ #
6292
+ # A `HEAD` request has the same options as a `GET` action on an object.
6293
+ # The response is identical to the `GET` response except that there is
6294
+ # no response body. Because of this, if the `HEAD` request generates an
6295
+ # error, it returns a generic `404 Not Found` or `403 Forbidden` code.
6296
+ # It is not possible to retrieve the exact exception beyond these error
6297
+ # codes.
6275
6298
  #
6276
6299
  # If you encrypt an object by using server-side encryption with
6277
6300
  # customer-provided encryption keys (SSE-C) when you store the object in
@@ -6287,12 +6310,15 @@ module Aws::S3
6287
6310
  # For more information about SSE-C, see [Server-Side Encryption (Using
6288
6311
  # Customer-Provided Encryption Keys)][1].
6289
6312
  #
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.
6313
+ # <note markdown="1"> * Encryption request headers, like `x-amz-server-side-encryption`,
6314
+ # should not be sent for GET requests if your object uses server-side
6315
+ # encryption with CMKs stored in AWS KMS (SSE-KMS) or server-side
6316
+ # encryption with Amazon S3–managed encryption keys (SSE-S3). If your
6317
+ # object does use these types of keys, you’ll get an HTTP 400
6318
+ # BadRequest error.
6319
+ #
6320
+ # * The last modified property in this case is the creation date of the
6321
+ # object.
6296
6322
  #
6297
6323
  # </note>
6298
6324
  #
@@ -6334,7 +6360,7 @@ module Aws::S3
6334
6360
  # * If you don’t have the `s3:ListBucket` permission, Amazon S3 returns
6335
6361
  # an HTTP status code 403 ("access denied") error.
6336
6362
  #
6337
- # The following operation is related to `HeadObject`\:
6363
+ # The following action is related to `HeadObject`\:
6338
6364
  #
6339
6365
  # * [GetObject][5]
6340
6366
  #
@@ -6351,22 +6377,22 @@ module Aws::S3
6351
6377
  # @option params [required, String] :bucket
6352
6378
  # The name of the bucket containing the object.
6353
6379
  #
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
6380
+ # When using this action with an access point, you must direct requests
6381
+ # to the access point hostname. The access point hostname takes the form
6356
6382
  # *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
6383
+ # When using this action with an access point through the AWS SDKs, you
6384
+ # provide the access point ARN in place of the bucket name. For more
6359
6385
  # information about access point ARNs, see [Using Access Points][1] in
6360
6386
  # the *Amazon Simple Storage Service Developer Guide*.
6361
6387
  #
6362
- # When using this API with Amazon S3 on Outposts, you must direct
6388
+ # When using this action with Amazon S3 on Outposts, you must direct
6363
6389
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6364
6390
  # takes the form
6365
6391
  # *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*.
6392
+ # When using this action using S3 on Outposts through the AWS SDKs, you
6393
+ # provide the Outposts bucket ARN in place of the bucket name. For more
6394
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6395
+ # in the *Amazon Simple Storage Service Developer Guide*.
6370
6396
  #
6371
6397
  #
6372
6398
  #
@@ -6575,15 +6601,14 @@ module Aws::S3
6575
6601
  # Lists the analytics configurations for the bucket. You can have up to
6576
6602
  # 1,000 analytics configurations per bucket.
6577
6603
  #
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.
6604
+ # This action supports list pagination and does not return more than 100
6605
+ # configurations at a time. You should always check the `IsTruncated`
6606
+ # element in the response. If there are no more configurations to list,
6607
+ # `IsTruncated` is set to false. If there are more configurations to
6608
+ # list, `IsTruncated` is set to true, and there will be a value in
6609
+ # `NextContinuationToken`. You use the `NextContinuationToken` value to
6610
+ # continue the pagination of the list by passing the value in
6611
+ # continuation-token in the request to `GET` the next page.
6587
6612
  #
6588
6613
  # To use this operation, you must have permissions to perform the
6589
6614
  # `s3:GetAnalyticsConfiguration` action. The bucket owner has this
@@ -6760,9 +6785,9 @@ module Aws::S3
6760
6785
  # Returns a list of inventory configurations for the bucket. You can
6761
6786
  # have up to 1,000 analytics configurations per bucket.
6762
6787
  #
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,
6788
+ # This action supports list pagination and does not return more than 100
6789
+ # configurations at a time. Always check the `IsTruncated` element in
6790
+ # the response. If there are no more configurations to list,
6766
6791
  # `IsTruncated` is set to false. If there are more configurations to
6767
6792
  # list, `IsTruncated` is set to true, and there is a value in
6768
6793
  # `NextContinuationToken`. You use the `NextContinuationToken` value to
@@ -6860,9 +6885,9 @@ module Aws::S3
6860
6885
  # not provide information on daily storage metrics. You can have up to
6861
6886
  # 1,000 configurations per bucket.
6862
6887
  #
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,
6888
+ # This action supports list pagination and does not return more than 100
6889
+ # configurations at a time. Always check the `IsTruncated` element in
6890
+ # the response. If there are no more configurations to list,
6866
6891
  # `IsTruncated` is set to false. If there are more configurations to
6867
6892
  # list, `IsTruncated` is set to true, and there is a value in
6868
6893
  # `NextContinuationToken`. You use the `NextContinuationToken` value to
@@ -7008,20 +7033,19 @@ module Aws::S3
7008
7033
  req.send_request(options)
7009
7034
  end
7010
7035
 
7011
- # This operation lists in-progress multipart uploads. An in-progress
7036
+ # This action lists in-progress multipart uploads. An in-progress
7012
7037
  # multipart upload is a multipart upload that has been initiated using
7013
7038
  # the Initiate Multipart Upload request, but has not yet been completed
7014
7039
  # or aborted.
7015
7040
  #
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.
7041
+ # This action returns at most 1,000 multipart uploads in the response.
7042
+ # 1,000 multipart uploads is the maximum number of uploads a response
7043
+ # can include, which is also the default value. You can further limit
7044
+ # the number of uploads in a response by specifying the `max-uploads`
7045
+ # parameter in the response. If additional multipart uploads satisfy the
7046
+ # list criteria, the response will contain an `IsTruncated` element with
7047
+ # the value true. To list the additional multipart uploads, use the
7048
+ # `key-marker` and `upload-id-marker` request parameters.
7025
7049
  #
7026
7050
  # In the response, the uploads are sorted by key. If your application
7027
7051
  # has initiated more than one multipart upload using the same object
@@ -7033,7 +7057,7 @@ module Aws::S3
7033
7057
  # Using Multipart Upload][1].
7034
7058
  #
7035
7059
  # For information on permissions required to use the multipart upload
7036
- # API, see [Multipart Upload API and Permissions][2].
7060
+ # API, see [Multipart Upload and Permissions][2].
7037
7061
  #
7038
7062
  # The following operations are related to `ListMultipartUploads`\:
7039
7063
  #
@@ -7060,22 +7084,22 @@ module Aws::S3
7060
7084
  # @option params [required, String] :bucket
7061
7085
  # The name of the bucket to which the multipart upload was initiated.
7062
7086
  #
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
7087
+ # When using this action with an access point, you must direct requests
7088
+ # to the access point hostname. The access point hostname takes the form
7065
7089
  # *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
7090
+ # When using this action with an access point through the AWS SDKs, you
7091
+ # provide the access point ARN in place of the bucket name. For more
7068
7092
  # information about access point ARNs, see [Using Access Points][1] in
7069
7093
  # the *Amazon Simple Storage Service Developer Guide*.
7070
7094
  #
7071
- # When using this API with Amazon S3 on Outposts, you must direct
7095
+ # When using this action with Amazon S3 on Outposts, you must direct
7072
7096
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7073
7097
  # takes the form
7074
7098
  # *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*.
7099
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7100
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7101
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7102
+ # in the *Amazon Simple Storage Service Developer Guide*.
7079
7103
  #
7080
7104
  #
7081
7105
  #
@@ -7351,7 +7375,7 @@ module Aws::S3
7351
7375
  #
7352
7376
  # @option params [Integer] :max_keys
7353
7377
  # 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
7378
+ # the action returns up to 1,000 key names. The response might contain
7355
7379
  # fewer keys but will never contain more. If additional keys satisfy the
7356
7380
  # search criteria, but were not returned because max-keys was exceeded,
7357
7381
  # the response contains &lt;isTruncated&gt;true&lt;/isTruncated&gt;. To
@@ -7495,7 +7519,7 @@ module Aws::S3
7495
7519
  # invalid XML. Be sure to design your application to parse the contents
7496
7520
  # of the response and handle it appropriately.
7497
7521
  #
7498
- # This API has been revised. We recommend that you use the newer
7522
+ # This action has been revised. We recommend that you use the newer
7499
7523
  # version, [ListObjectsV2][1], when developing applications. For
7500
7524
  # backward compatibility, Amazon S3 continues to support `ListObjects`.
7501
7525
  #
@@ -7522,22 +7546,22 @@ module Aws::S3
7522
7546
  # @option params [required, String] :bucket
7523
7547
  # The name of the bucket containing the objects.
7524
7548
  #
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
7549
+ # When using this action with an access point, you must direct requests
7550
+ # to the access point hostname. The access point hostname takes the form
7527
7551
  # *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
7552
+ # When using this action with an access point through the AWS SDKs, you
7553
+ # provide the access point ARN in place of the bucket name. For more
7530
7554
  # information about access point ARNs, see [Using Access Points][1] in
7531
7555
  # the *Amazon Simple Storage Service Developer Guide*.
7532
7556
  #
7533
- # When using this API with Amazon S3 on Outposts, you must direct
7557
+ # When using this action with Amazon S3 on Outposts, you must direct
7534
7558
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7535
7559
  # takes the form
7536
7560
  # *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*.
7561
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7562
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7563
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7564
+ # in the *Amazon Simple Storage Service Developer Guide*.
7541
7565
  #
7542
7566
  #
7543
7567
  #
@@ -7560,7 +7584,7 @@ module Aws::S3
7560
7584
  #
7561
7585
  # @option params [Integer] :max_keys
7562
7586
  # 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
7587
+ # the action returns up to 1,000 key names. The response might contain
7564
7588
  # fewer keys but will never contain more.
7565
7589
  #
7566
7590
  # @option params [String] :prefix
@@ -7677,20 +7701,22 @@ module Aws::S3
7677
7701
  # use the request parameters as selection criteria to return a subset of
7678
7702
  # the objects in a bucket. A `200 OK` response can contain valid or
7679
7703
  # invalid XML. Make sure to design your application to parse the
7680
- # contents of the response and handle it appropriately.
7704
+ # contents of the response and handle it appropriately. Objects are
7705
+ # returned sorted in an ascending order of the respective key names in
7706
+ # the list.
7681
7707
  #
7682
7708
  # To use this operation, you must have READ access to the bucket.
7683
7709
  #
7684
- # To use this operation in an AWS Identity and Access Management (IAM)
7710
+ # To use this action in an AWS Identity and Access Management (IAM)
7685
7711
  # policy, you must have permissions to perform the `s3:ListBucket`
7686
7712
  # action. The bucket owner has this permission by default and can grant
7687
7713
  # this permission to others. For more information about permissions, see
7688
7714
  # [Permissions Related to Bucket Subresource Operations][1] and
7689
7715
  # [Managing Access Permissions to Your Amazon S3 Resources][2].
7690
7716
  #
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
7717
+ # This section describes the latest revision of this action. We
7718
+ # recommend that you use this revised API for application development.
7719
+ # For backward compatibility, Amazon S3 continues to support the prior
7694
7720
  # version of this API, [ListObjects][3].
7695
7721
  #
7696
7722
  # To get a list of your buckets, see [ListBuckets][4].
@@ -7716,22 +7742,22 @@ module Aws::S3
7716
7742
  # @option params [required, String] :bucket
7717
7743
  # Bucket name to list.
7718
7744
  #
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
7745
+ # When using this action with an access point, you must direct requests
7746
+ # to the access point hostname. The access point hostname takes the form
7721
7747
  # *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
7748
+ # When using this action with an access point through the AWS SDKs, you
7749
+ # provide the access point ARN in place of the bucket name. For more
7724
7750
  # information about access point ARNs, see [Using Access Points][1] in
7725
7751
  # the *Amazon Simple Storage Service Developer Guide*.
7726
7752
  #
7727
- # When using this API with Amazon S3 on Outposts, you must direct
7753
+ # When using this action with Amazon S3 on Outposts, you must direct
7728
7754
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7729
7755
  # takes the form
7730
7756
  # *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*.
7757
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7758
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7759
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7760
+ # in the *Amazon Simple Storage Service Developer Guide*.
7735
7761
  #
7736
7762
  #
7737
7763
  #
@@ -7746,7 +7772,7 @@ module Aws::S3
7746
7772
  #
7747
7773
  # @option params [Integer] :max_keys
7748
7774
  # 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
7775
+ # the action returns up to 1,000 key names. The response might contain
7750
7776
  # fewer keys but will never contain more.
7751
7777
  #
7752
7778
  # @option params [String] :prefix
@@ -7895,7 +7921,7 @@ module Aws::S3
7895
7921
  # Using Multipart Upload][2].
7896
7922
  #
7897
7923
  # For information on permissions required to use the multipart upload
7898
- # API, see [Multipart Upload API and Permissions][3].
7924
+ # API, see [Multipart Upload and Permissions][3].
7899
7925
  #
7900
7926
  # The following operations are related to `ListParts`\:
7901
7927
  #
@@ -7922,22 +7948,22 @@ module Aws::S3
7922
7948
  # @option params [required, String] :bucket
7923
7949
  # The name of the bucket to which the parts are being uploaded.
7924
7950
  #
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
7951
+ # When using this action with an access point, you must direct requests
7952
+ # to the access point hostname. The access point hostname takes the form
7927
7953
  # *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
7954
+ # When using this action with an access point through the AWS SDKs, you
7955
+ # provide the access point ARN in place of the bucket name. For more
7930
7956
  # information about access point ARNs, see [Using Access Points][1] in
7931
7957
  # the *Amazon Simple Storage Service Developer Guide*.
7932
7958
  #
7933
- # When using this API with Amazon S3 on Outposts, you must direct
7959
+ # When using this action with Amazon S3 on Outposts, you must direct
7934
7960
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7935
7961
  # takes the form
7936
7962
  # *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*.
7963
+ # When using this action using S3 on Outposts through the AWS SDKs, you
7964
+ # provide the Outposts bucket ARN in place of the bucket name. For more
7965
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7966
+ # in the *Amazon Simple Storage Service Developer Guide*.
7941
7967
  #
7942
7968
  #
7943
7969
  #
@@ -8093,8 +8119,8 @@ module Aws::S3
8093
8119
  #
8094
8120
  # * Suspended – Disables accelerated data transfers to the bucket.
8095
8121
  #
8096
- # The [GetBucketAccelerateConfiguration][3] operation returns the
8097
- # transfer acceleration state of a bucket.
8122
+ # The [GetBucketAccelerateConfiguration][3] action returns the transfer
8123
+ # acceleration state of a bucket.
8098
8124
  #
8099
8125
  # After setting the Transfer Acceleration state of a bucket to Enabled,
8100
8126
  # it might take up to thirty minutes before the data transfer rates to
@@ -8579,7 +8605,7 @@ module Aws::S3
8579
8605
  # element.
8580
8606
  #
8581
8607
  # For more information about CORS, go to [Enabling Cross-Origin Resource
8582
- # Sharing][1] in the *Amazon Simple Storage Service Developer Guide*.
8608
+ # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
8583
8609
  #
8584
8610
  # **Related Resources**
8585
8611
  #
@@ -8602,7 +8628,7 @@ module Aws::S3
8602
8628
  # @option params [required, Types::CORSConfiguration] :cors_configuration
8603
8629
  # Describes the cross-origin access configuration for objects in an
8604
8630
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
8605
- # Resource Sharing][1] in the *Amazon Simple Storage Service Developer
8631
+ # Resource Sharing][1] in the *Amazon Simple Storage Service User
8606
8632
  # Guide*.
8607
8633
  #
8608
8634
  #
@@ -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,36 @@ 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 Simple Storage Service User Guide*. For more information about
8739
+ # S3 Bucket Keys, see [Amazon S3 Bucket Keys][2] in the *Amazon Simple
8740
+ # Storage Service User Guide*.
8714
8741
  #
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).
8742
+ # This action requires AWS Signature Version 4. For more information,
8743
+ # see [ Authenticating Requests (AWS Signature Version 4)][3].
8718
8744
  #
8719
8745
  # To use this operation, you must have permissions to perform the
8720
8746
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
8721
8747
  # permission by default. The bucket owner can grant this permission to
8722
8748
  # 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.
8749
+ # Related to Bucket Subresource Operations][4] and [Managing Access
8750
+ # Permissions to Your Amazon S3 Resources][5] in the Amazon Simple
8751
+ # Storage Service User Guide.
8726
8752
  #
8727
8753
  # **Related Resources**
8728
8754
  #
8729
- # * [GetBucketEncryption][5]
8755
+ # * [GetBucketEncryption][6]
8730
8756
  #
8731
- # * [DeleteBucketEncryption][6]
8757
+ # * [DeleteBucketEncryption][7]
8732
8758
  #
8733
8759
  #
8734
8760
  #
8735
8761
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
8736
8762
  # [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
8763
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
8764
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8765
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8766
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
8767
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
8741
8768
  #
8742
8769
  # @option params [required, String] :bucket
8743
8770
  # Specifies default encryption for a bucket using server-side encryption
@@ -8796,6 +8823,8 @@ module Aws::S3
8796
8823
  end
8797
8824
 
8798
8825
  # Puts a S3 Intelligent-Tiering configuration to the specified bucket.
8826
+ # You can have up to 1,000 S3 Intelligent-Tiering configurations per
8827
+ # bucket.
8799
8828
  #
8800
8829
  # The S3 Intelligent-Tiering storage class is designed to optimize
8801
8830
  # storage costs by automatically moving data to the most cost-effective
@@ -8824,6 +8853,35 @@ module Aws::S3
8824
8853
  #
8825
8854
  # * [ListBucketIntelligentTieringConfigurations][4]
8826
8855
  #
8856
+ # <note markdown="1"> You only need S3 Intelligent-Tiering enabled on a bucket if you want
8857
+ # to automatically move objects stored in the S3 Intelligent-Tiering
8858
+ # storage class to the Archive Access or Deep Archive Access tier.
8859
+ #
8860
+ # </note>
8861
+ #
8862
+ # **Special Errors**
8863
+ #
8864
+ # * **HTTP 400 Bad Request Error**
8865
+ #
8866
+ # * *Code:* InvalidArgument
8867
+ #
8868
+ # * *Cause:* Invalid Argument
8869
+ #
8870
+ # * **HTTP 400 Bad Request Error**
8871
+ #
8872
+ # * *Code:* TooManyConfigurations
8873
+ #
8874
+ # * *Cause:* You are attempting to create a new configuration but have
8875
+ # already reached the 1,000-configuration limit.
8876
+ #
8877
+ # * **HTTP 403 Forbidden Error**
8878
+ #
8879
+ # * *Code:* AccessDenied
8880
+ #
8881
+ # * *Cause:* You are not the owner of the specified bucket, or you do
8882
+ # not have the `s3:PutIntelligentTieringConfiguration` bucket
8883
+ # permission to set the configuration on the bucket.
8884
+ #
8827
8885
  #
8828
8886
  #
8829
8887
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -8885,7 +8943,7 @@ module Aws::S3
8885
8943
  req.send_request(options)
8886
8944
  end
8887
8945
 
8888
- # This implementation of the `PUT` operation adds an inventory
8946
+ # This implementation of the `PUT` action adds an inventory
8889
8947
  # configuration (identified by the inventory ID) to the bucket. You can
8890
8948
  # have up to 1,000 inventory configurations per bucket.
8891
8949
  #
@@ -8901,8 +8959,8 @@ module Aws::S3
8901
8959
  # whether to generate the inventory daily or weekly. You can also
8902
8960
  # configure what object metadata to include and whether to inventory all
8903
8961
  # object versions or only current versions. For more information, see
8904
- # [Amazon S3 Inventory][1] in the Amazon Simple Storage Service
8905
- # Developer Guide.
8962
+ # [Amazon S3 Inventory][1] in the Amazon Simple Storage Service User
8963
+ # Guide.
8906
8964
  #
8907
8965
  # You must create a bucket policy on the *destination* bucket to grant
8908
8966
  # permissions to Amazon S3 to write objects to the bucket in the defined
@@ -8914,7 +8972,7 @@ module Aws::S3
8914
8972
  # permission by default and can grant this permission to others. For
8915
8973
  # more information about permissions, see [Permissions Related to Bucket
8916
8974
  # Subresource Operations][3] and [Managing Access Permissions to Your
8917
- # Amazon S3 Resources][4] in the Amazon Simple Storage Service Developer
8975
+ # Amazon S3 Resources][4] in the Amazon Simple Storage Service User
8918
8976
  # Guide.
8919
8977
  #
8920
8978
  # **Special Errors**
@@ -9027,7 +9085,7 @@ module Aws::S3
9027
9085
  # Creates a new lifecycle configuration for the bucket or replaces an
9028
9086
  # existing lifecycle configuration. For information about lifecycle
9029
9087
  # configuration, see [Object Lifecycle Management][2] in the *Amazon
9030
- # Simple Storage Service Developer Guide*.
9088
+ # Simple Storage Service User Guide*.
9031
9089
  #
9032
9090
  # By default, all Amazon S3 resources, including buckets, objects, and
9033
9091
  # related subresources (for example, lifecycle configuration and website
@@ -9050,7 +9108,7 @@ module Aws::S3
9050
9108
  #
9051
9109
  # For more information about permissions, see [Managing Access
9052
9110
  # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
9053
- # Storage Service Developer Guide*.
9111
+ # Storage Service User Guide*.
9054
9112
  #
9055
9113
  # For more examples of transitioning objects to storage classes such as
9056
9114
  # STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
@@ -9068,7 +9126,7 @@ module Aws::S3
9068
9126
  # the AWS account that created the bucket—can perform any of the
9069
9127
  # operations. A resource owner can also grant others permission to
9070
9128
  # perform the operation. For more information, see the following
9071
- # topics in the Amazon Simple Storage Service Developer Guide:
9129
+ # topics in the Amazon Simple Storage Service User Guide:
9072
9130
  #
9073
9131
  # * [Specifying Permissions in a Policy][8]
9074
9132
  #
@@ -9658,8 +9716,8 @@ module Aws::S3
9658
9716
  #
9659
9717
  # `</NotificationConfiguration>`
9660
9718
  #
9661
- # This operation replaces the existing notification configuration with
9662
- # the configuration you include in the request body.
9719
+ # This action replaces the existing notification configuration with the
9720
+ # configuration you include in the request body.
9663
9721
  #
9664
9722
  # After Amazon S3 receives this request, it first verifies that any
9665
9723
  # Amazon Simple Notification Service (Amazon SNS) or Amazon Simple Queue
@@ -9682,8 +9740,8 @@ module Aws::S3
9682
9740
  # notification configuration includes SNS topic, SQS queue, and Lambda
9683
9741
  # function configurations. When you send a PUT request with this
9684
9742
  # 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.
9743
+ # message fails, the entire PUT action will fail, and Amazon S3 will not
9744
+ # add the configuration to your bucket.
9687
9745
  #
9688
9746
  # </note>
9689
9747
  #
@@ -9695,7 +9753,7 @@ module Aws::S3
9695
9753
  # include the `x-amz-sns-test-message-id` header containing the message
9696
9754
  # ID of the test notification sent to the topic.
9697
9755
  #
9698
- # The following operation is related to
9756
+ # The following action is related to
9699
9757
  # `PutBucketNotificationConfiguration`\:
9700
9758
  #
9701
9759
  # * [GetBucketNotificationConfiguration][2]
@@ -9960,8 +10018,8 @@ module Aws::S3
9960
10018
  # more information, see [Replication][1] in the *Amazon S3 Developer
9961
10019
  # Guide*.
9962
10020
  #
9963
- # <note markdown="1"> To perform this operation, the user or role performing the operation
9964
- # must have the [iam:PassRole][2] permission.
10021
+ # <note markdown="1"> To perform this operation, the user or role performing the action must
10022
+ # have the [iam:PassRole][2] permission.
9965
10023
  #
9966
10024
  # </note>
9967
10025
  #
@@ -10187,10 +10245,9 @@ module Aws::S3
10187
10245
  # The bucket name.
10188
10246
  #
10189
10247
  # @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].
10248
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
10249
+ # header as a message integrity check to verify that the request body
10250
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
10194
10251
  #
10195
10252
  # For requests made using the AWS Command Line Interface (CLI) or AWS
10196
10253
  # SDKs, this field is calculated automatically.
@@ -10284,7 +10341,7 @@ module Aws::S3
10284
10341
  #
10285
10342
  # * Error code: `OperationAbortedError `
10286
10343
  #
10287
- # * Description: A conflicting conditional operation is currently in
10344
+ # * Description: A conflicting conditional action is currently in
10288
10345
  # progress against this resource. Please try again.
10289
10346
  #
10290
10347
  # ^
@@ -10499,7 +10556,7 @@ module Aws::S3
10499
10556
  # such as the file name of the index document and any redirect rules.
10500
10557
  # For more information, see [Hosting Websites on Amazon S3][1].
10501
10558
  #
10502
- # This PUT operation requires the `S3:PutBucketWebsite` permission. By
10559
+ # This PUT action requires the `S3:PutBucketWebsite` permission. By
10503
10560
  # default, only the bucket owner can configure the website attached to a
10504
10561
  # bucket; however, bucket owners can allow other users to set the
10505
10562
  # website configuration by writing a bucket policy that grants them the
@@ -10559,7 +10616,7 @@ module Aws::S3
10559
10616
  # Amazon S3 has a limitation of 50 routing rules per website
10560
10617
  # configuration. If you require more than 50 routing rules, you can use
10561
10618
  # object redirect. For more information, see [Configuring an Object
10562
- # Redirect][2] in the *Amazon Simple Storage Service Developer Guide*.
10619
+ # Redirect][2] in the *Amazon Simple Storage Service User Guide*.
10563
10620
  #
10564
10621
  #
10565
10622
  #
@@ -10692,7 +10749,7 @@ module Aws::S3
10692
10749
  # If you request server-side encryption using AWS Key Management Service
10693
10750
  # (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
10694
10751
  # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon Simple
10695
- # Storage Service Developer Guide*.
10752
+ # Storage Service User Guide*.
10696
10753
  #
10697
10754
  # **Access Control List (ACL)-Specific Request Headers**
10698
10755
  #
@@ -10758,24 +10815,24 @@ module Aws::S3
10758
10815
  # Object data.
10759
10816
  #
10760
10817
  # @option params [required, String] :bucket
10761
- # The bucket name to which the PUT operation was initiated.
10818
+ # The bucket name to which the PUT action was initiated.
10762
10819
  #
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
10820
+ # When using this action with an access point, you must direct requests
10821
+ # to the access point hostname. The access point hostname takes the form
10765
10822
  # *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
10823
+ # When using this action with an access point through the AWS SDKs, you
10824
+ # provide the access point ARN in place of the bucket name. For more
10768
10825
  # information about access point ARNs, see [Using Access Points][1] in
10769
10826
  # the *Amazon Simple Storage Service Developer Guide*.
10770
10827
  #
10771
- # When using this API with Amazon S3 on Outposts, you must direct
10828
+ # When using this action with Amazon S3 on Outposts, you must direct
10772
10829
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10773
10830
  # takes the form
10774
10831
  # *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*.
10832
+ # When using this action using S3 on Outposts through the AWS SDKs, you
10833
+ # provide the Outposts bucket ARN in place of the bucket name. For more
10834
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
10835
+ # in the *Amazon Simple Storage Service Developer Guide*.
10779
10836
  #
10780
10837
  #
10781
10838
  #
@@ -10875,7 +10932,7 @@ module Aws::S3
10875
10932
  # This action is not supported by Amazon S3 on Outposts.
10876
10933
  #
10877
10934
  # @option params [required, String] :key
10878
- # Object key for which the PUT operation was initiated.
10935
+ # Object key for which the PUT action was initiated.
10879
10936
  #
10880
10937
  # @option params [Hash<String,String>] :metadata
10881
10938
  # A map of metadata to store with the object in S3.
@@ -10962,8 +11019,8 @@ module Aws::S3
10962
11019
  # Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
10963
11020
  # for object encryption with SSE-KMS.
10964
11021
  #
10965
- # Specifying this header with a PUT operation doesn’t affect
10966
- # bucket-level settings for S3 Bucket Key.
11022
+ # Specifying this header with a PUT action doesn’t affect bucket-level
11023
+ # settings for S3 Bucket Key.
10967
11024
  #
10968
11025
  # @option params [String] :request_payer
10969
11026
  # Confirms that the requester knows that they will be charged for the
@@ -11013,78 +11070,76 @@ module Aws::S3
11013
11070
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
11014
11071
  #
11015
11072
  #
11016
- # @example Example: To upload an object and specify server-side encryption and object tags
11073
+ # @example Example: To upload an object and specify optional tags
11017
11074
  #
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.
11075
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
11076
+ # # S3 returns version ID of the newly created object.
11020
11077
  #
11021
11078
  # resp = client.put_object({
11022
- # body: "filetoupload",
11079
+ # body: "c:\\HappyFace.jpg",
11023
11080
  # bucket: "examplebucket",
11024
- # key: "exampleobject",
11025
- # server_side_encryption: "AES256",
11081
+ # key: "HappyFace.jpg",
11026
11082
  # tagging: "key1=value1&key2=value2",
11027
11083
  # })
11028
11084
  #
11029
11085
  # resp.to_h outputs the following:
11030
11086
  # {
11031
11087
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11032
- # server_side_encryption: "AES256",
11033
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11088
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11034
11089
  # }
11035
11090
  #
11036
- # @example Example: To create an object.
11091
+ # @example Example: To upload an object and specify canned ACL.
11037
11092
  #
11038
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11093
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11094
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11039
11095
  #
11040
11096
  # resp = client.put_object({
11097
+ # acl: "authenticated-read",
11041
11098
  # body: "filetoupload",
11042
11099
  # bucket: "examplebucket",
11043
- # key: "objectkey",
11100
+ # key: "exampleobject",
11044
11101
  # })
11045
11102
  #
11046
11103
  # resp.to_h outputs the following:
11047
11104
  # {
11048
11105
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11049
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11106
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11050
11107
  # }
11051
11108
  #
11052
- # @example Example: To upload an object and specify optional tags
11109
+ # @example Example: To create an object.
11053
11110
  #
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.
11111
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11056
11112
  #
11057
11113
  # resp = client.put_object({
11058
- # body: "c:\\HappyFace.jpg",
11114
+ # body: "filetoupload",
11059
11115
  # bucket: "examplebucket",
11060
- # key: "HappyFace.jpg",
11061
- # tagging: "key1=value1&key2=value2",
11116
+ # key: "objectkey",
11062
11117
  # })
11063
11118
  #
11064
11119
  # resp.to_h outputs the following:
11065
11120
  # {
11066
11121
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11067
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11122
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11068
11123
  # }
11069
11124
  #
11070
- # @example Example: To upload an object (specify optional headers)
11125
+ # @example Example: To upload an object and specify server-side encryption and object tags
11071
11126
  #
11072
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11073
- # # storage class and use server-side encryption.
11127
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11128
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11074
11129
  #
11075
11130
  # resp = client.put_object({
11076
- # body: "HappyFace.jpg",
11131
+ # body: "filetoupload",
11077
11132
  # bucket: "examplebucket",
11078
- # key: "HappyFace.jpg",
11133
+ # key: "exampleobject",
11079
11134
  # server_side_encryption: "AES256",
11080
- # storage_class: "STANDARD_IA",
11135
+ # tagging: "key1=value1&key2=value2",
11081
11136
  # })
11082
11137
  #
11083
11138
  # resp.to_h outputs the following:
11084
11139
  # {
11085
11140
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11086
11141
  # server_side_encryption: "AES256",
11087
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11142
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11088
11143
  # }
11089
11144
  #
11090
11145
  # @example Example: To upload object and specify user-defined metadata
@@ -11108,39 +11163,41 @@ module Aws::S3
11108
11163
  # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11109
11164
  # }
11110
11165
  #
11111
- # @example Example: To upload an object and specify canned ACL.
11166
+ # @example Example: To upload an object
11112
11167
  #
11113
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11114
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11168
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11169
+ # # syntax. S3 returns VersionId of the newly created object.
11115
11170
  #
11116
11171
  # resp = client.put_object({
11117
- # acl: "authenticated-read",
11118
- # body: "filetoupload",
11172
+ # body: "HappyFace.jpg",
11119
11173
  # bucket: "examplebucket",
11120
- # key: "exampleobject",
11174
+ # key: "HappyFace.jpg",
11121
11175
  # })
11122
11176
  #
11123
11177
  # resp.to_h outputs the following:
11124
11178
  # {
11125
11179
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11126
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11180
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11127
11181
  # }
11128
11182
  #
11129
- # @example Example: To upload an object
11183
+ # @example Example: To upload an object (specify optional headers)
11130
11184
  #
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.
11185
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
11186
+ # # storage class and use server-side encryption.
11133
11187
  #
11134
11188
  # resp = client.put_object({
11135
11189
  # body: "HappyFace.jpg",
11136
11190
  # bucket: "examplebucket",
11137
11191
  # key: "HappyFace.jpg",
11192
+ # server_side_encryption: "AES256",
11193
+ # storage_class: "STANDARD_IA",
11138
11194
  # })
11139
11195
  #
11140
11196
  # resp.to_h outputs the following:
11141
11197
  # {
11142
11198
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11143
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11199
+ # server_side_encryption: "AES256",
11200
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
11144
11201
  # }
11145
11202
  #
11146
11203
  # @example Streaming a file from disk
@@ -11214,7 +11271,7 @@ module Aws::S3
11214
11271
  # permissions for a new or existing object in an S3 bucket. You must
11215
11272
  # have `WRITE_ACP` permission to set the ACL of an object. For more
11216
11273
  # information, see [What permissions can I grant?][1] in the *Amazon
11217
- # Simple Storage Service Developer Guide*.
11274
+ # Simple Storage Service User Guide*.
11218
11275
  #
11219
11276
  # This action is not supported by Amazon S3 on Outposts.
11220
11277
  #
@@ -11378,11 +11435,11 @@ module Aws::S3
11378
11435
  # The bucket name that contains the object to which you want to attach
11379
11436
  # the ACL.
11380
11437
  #
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
11438
+ # When using this action with an access point, you must direct requests
11439
+ # to the access point hostname. The access point hostname takes the form
11383
11440
  # *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
11441
+ # When using this action with an access point through the AWS SDKs, you
11442
+ # provide the access point ARN in place of the bucket name. For more
11386
11443
  # information about access point ARNs, see [Using Access Points][1] in
11387
11444
  # the *Amazon Simple Storage Service Developer Guide*.
11388
11445
  #
@@ -11429,24 +11486,24 @@ module Aws::S3
11429
11486
  # This action is not supported by Amazon S3 on Outposts.
11430
11487
  #
11431
11488
  # @option params [required, String] :key
11432
- # Key for which the PUT operation was initiated.
11489
+ # Key for which the PUT action was initiated.
11433
11490
  #
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
11491
+ # When using this action with an access point, you must direct requests
11492
+ # to the access point hostname. The access point hostname takes the form
11436
11493
  # *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
11494
+ # When using this action with an access point through the AWS SDKs, you
11495
+ # provide the access point ARN in place of the bucket name. For more
11439
11496
  # information about access point ARNs, see [Using Access Points][1] in
11440
11497
  # the *Amazon Simple Storage Service Developer Guide*.
11441
11498
  #
11442
- # When using this API with Amazon S3 on Outposts, you must direct
11499
+ # When using this action with Amazon S3 on Outposts, you must direct
11443
11500
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11444
11501
  # takes the form
11445
11502
  # *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*.
11503
+ # When using this action using S3 on Outposts through the AWS SDKs, you
11504
+ # provide the Outposts bucket ARN in place of the bucket name. For more
11505
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11506
+ # in the *Amazon Simple Storage Service Developer Guide*.
11450
11507
  #
11451
11508
  #
11452
11509
  #
@@ -11561,11 +11618,11 @@ module Aws::S3
11561
11618
  # The bucket name containing the object that you want to place a Legal
11562
11619
  # Hold on.
11563
11620
  #
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
11621
+ # When using this action with an access point, you must direct requests
11622
+ # to the access point hostname. The access point hostname takes the form
11566
11623
  # *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
11624
+ # When using this action with an access point through the AWS SDKs, you
11625
+ # provide the access point ARN in place of the bucket name. For more
11569
11626
  # information about access point ARNs, see [Using Access Points][1] in
11570
11627
  # the *Amazon Simple Storage Service Developer Guide*.
11571
11628
  #
@@ -11743,11 +11800,11 @@ module Aws::S3
11743
11800
  # The bucket name that contains the object you want to apply this Object
11744
11801
  # Retention configuration to.
11745
11802
  #
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
11803
+ # When using this action with an access point, you must direct requests
11804
+ # to the access point hostname. The access point hostname takes the form
11748
11805
  # *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
11806
+ # When using this action with an access point through the AWS SDKs, you
11807
+ # provide the access point ARN in place of the bucket name. For more
11751
11808
  # information about access point ARNs, see [Using Access Points][1] in
11752
11809
  # the *Amazon Simple Storage Service Developer Guide*.
11753
11810
  #
@@ -11778,7 +11835,7 @@ module Aws::S3
11778
11835
  # Retention configuration to.
11779
11836
  #
11780
11837
  # @option params [Boolean] :bypass_governance_retention
11781
- # Indicates whether this operation should bypass Governance-mode
11838
+ # Indicates whether this action should bypass Governance-mode
11782
11839
  # restrictions.
11783
11840
  #
11784
11841
  # @option params [String] :content_md5
@@ -11861,8 +11918,8 @@ module Aws::S3
11861
11918
  #
11862
11919
  # * * <i>Code: OperationAbortedError </i>
11863
11920
  #
11864
- # * *Cause: A conflicting conditional operation is currently in
11865
- # progress against this resource. Please try again.*
11921
+ # * *Cause: A conflicting conditional action is currently in progress
11922
+ # against this resource. Please try again.*
11866
11923
  #
11867
11924
  # * * *Code: InternalError*
11868
11925
  #
@@ -11873,33 +11930,34 @@ module Aws::S3
11873
11930
  #
11874
11931
  # * [GetObjectTagging][1]
11875
11932
  #
11876
- # ^
11933
+ # * [DeleteObjectTagging][4]
11877
11934
  #
11878
11935
  #
11879
11936
  #
11880
11937
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
11881
11938
  # [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
11882
11939
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
11940
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectTagging.html
11883
11941
  #
11884
11942
  # @option params [required, String] :bucket
11885
11943
  # The bucket name containing the object.
11886
11944
  #
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
11945
+ # When using this action with an access point, you must direct requests
11946
+ # to the access point hostname. The access point hostname takes the form
11889
11947
  # *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
11948
+ # When using this action with an access point through the AWS SDKs, you
11949
+ # provide the access point ARN in place of the bucket name. For more
11892
11950
  # information about access point ARNs, see [Using Access Points][1] in
11893
11951
  # the *Amazon Simple Storage Service Developer Guide*.
11894
11952
  #
11895
- # When using this API with Amazon S3 on Outposts, you must direct
11953
+ # When using this action with Amazon S3 on Outposts, you must direct
11896
11954
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11897
11955
  # takes the form
11898
11956
  # *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*.
11957
+ # When using this action using S3 on Outposts through the AWS SDKs, you
11958
+ # provide the Outposts bucket ARN in place of the bucket name. For more
11959
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11960
+ # in the *Amazon Simple Storage Service Developer Guide*.
11903
11961
  #
11904
11962
  #
11905
11963
  #
@@ -11926,6 +11984,17 @@ module Aws::S3
11926
11984
  # a different account, the request will fail with an HTTP `403 (Access
11927
11985
  # Denied)` error.
11928
11986
  #
11987
+ # @option params [String] :request_payer
11988
+ # Confirms that the requester knows that they will be charged for the
11989
+ # request. Bucket owners need not specify this parameter in their
11990
+ # requests. For information about downloading objects from requester
11991
+ # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
11992
+ # in the *Amazon S3 Developer Guide*.
11993
+ #
11994
+ #
11995
+ #
11996
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
11997
+ #
11929
11998
  # @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
11930
11999
  #
11931
12000
  # * {Types::PutObjectTaggingOutput#version_id #version_id} => String
@@ -11973,6 +12042,7 @@ module Aws::S3
11973
12042
  # ],
11974
12043
  # },
11975
12044
  # expected_bucket_owner: "AccountId",
12045
+ # request_payer: "requester", # accepts requester
11976
12046
  # })
11977
12047
  #
11978
12048
  # @example Response structure
@@ -12089,7 +12159,7 @@ module Aws::S3
12089
12159
  # default and can grant this permission to others. For more information
12090
12160
  # about permissions, see [Permissions Related to Bucket Subresource
12091
12161
  # Operations][1] and [Managing Access Permissions to Your Amazon S3
12092
- # Resources][2] in the *Amazon Simple Storage Service Developer Guide*.
12162
+ # Resources][2] in the *Amazon Simple Storage Service User Guide*.
12093
12163
  #
12094
12164
  # **Querying Archives with Select Requests**
12095
12165
  #
@@ -12099,7 +12169,7 @@ module Aws::S3
12099
12169
  # files. You can run queries and custom analytics on your archived data
12100
12170
  # without having to restore your data to a hotter Amazon S3 tier. For an
12101
12171
  # overview about select requests, see [Querying Archived Objects][3] in
12102
- # the *Amazon Simple Storage Service Developer Guide*.
12172
+ # the *Amazon Simple Storage Service User Guide*.
12103
12173
  #
12104
12174
  # When making a select request, do the following:
12105
12175
  #
@@ -12110,7 +12180,7 @@ module Aws::S3
12110
12180
  # bucket. You can specify the storage class and encryption for the
12111
12181
  # output objects stored in the bucket. For more information about
12112
12182
  # output, see [Querying Archived Objects][3] in the *Amazon Simple
12113
- # Storage Service Developer Guide*.
12183
+ # Storage Service User Guide*.
12114
12184
  #
12115
12185
  # For more information about the `S3` structure in the request body,
12116
12186
  # see the following:
@@ -12118,10 +12188,10 @@ module Aws::S3
12118
12188
  # * [PutObject][4]
12119
12189
  #
12120
12190
  # * [Managing Access with ACLs][5] in the *Amazon Simple Storage
12121
- # Service Developer Guide*
12191
+ # Service User Guide*
12122
12192
  #
12123
12193
  # * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
12124
- # Simple Storage Service Developer Guide*
12194
+ # Simple Storage Service User Guide*
12125
12195
  #
12126
12196
  # * Define the SQL expression for the `SELECT` type of restoration for
12127
12197
  # your query in the request body's `SelectParameters` structure. You
@@ -12147,7 +12217,7 @@ module Aws::S3
12147
12217
  #
12148
12218
  # For more information about using SQL with S3 Glacier Select restore,
12149
12219
  # see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
12150
- # the *Amazon Simple Storage Service Developer Guide*.
12220
+ # the *Amazon Simple Storage Service User Guide*.
12151
12221
  #
12152
12222
  # When making a select request, you can also do the following:
12153
12223
  #
@@ -12226,20 +12296,20 @@ module Aws::S3
12226
12296
  #
12227
12297
  # For more information about archive retrieval options and provisioned
12228
12298
  # capacity for `Expedited` data access, see [Restoring Archived
12229
- # Objects][8] in the *Amazon Simple Storage Service Developer Guide*.
12299
+ # Objects][8] in the *Amazon Simple Storage Service User Guide*.
12230
12300
  #
12231
12301
  # You can use Amazon S3 restore speed upgrade to change the restore
12232
12302
  # speed to a faster speed while it is in progress. For more information,
12233
12303
  # see [ Upgrading the speed of an in-progress restore][9] in the *Amazon
12234
- # Simple Storage Service Developer Guide*.
12304
+ # Simple Storage Service User Guide*.
12235
12305
  #
12236
12306
  # To get the status of object restoration, you can send a `HEAD`
12237
12307
  # request. Operations return the `x-amz-restore` header, which provides
12238
12308
  # information about the restoration status, in the response. You can use
12239
12309
  # Amazon S3 event notifications to notify you when a restore is
12240
12310
  # initiated or completed. For more information, see [Configuring Amazon
12241
- # S3 Event Notifications][10] in the *Amazon Simple Storage Service
12242
- # Developer Guide*.
12311
+ # S3 Event Notifications][10] in the *Amazon Simple Storage Service User
12312
+ # Guide*.
12243
12313
  #
12244
12314
  # After restoring an archived object, you can update the restoration
12245
12315
  # period by reissuing the request with a new period. Amazon S3 updates
@@ -12255,11 +12325,11 @@ module Aws::S3
12255
12325
  # days, Amazon S3 deletes the object in 3 days. For more information
12256
12326
  # about lifecycle configuration, see
12257
12327
  # [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
12258
- # Management][12] in *Amazon Simple Storage Service Developer Guide*.
12328
+ # Management][12] in *Amazon Simple Storage Service User Guide*.
12259
12329
  #
12260
12330
  # **Responses**
12261
12331
  #
12262
- # A successful operation returns either the `200 OK` or `202 Accepted`
12332
+ # A successful action returns either the `200 OK` or `202 Accepted`
12263
12333
  # status code.
12264
12334
  #
12265
12335
  # * If the object is not previously restored, then Amazon S3 returns
@@ -12297,7 +12367,7 @@ module Aws::S3
12297
12367
  # * [GetBucketNotificationConfiguration][13]
12298
12368
  #
12299
12369
  # * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
12300
- # the *Amazon Simple Storage Service Developer Guide*
12370
+ # the *Amazon Simple Storage Service User Guide*
12301
12371
  #
12302
12372
  #
12303
12373
  #
@@ -12318,22 +12388,22 @@ module Aws::S3
12318
12388
  # @option params [required, String] :bucket
12319
12389
  # The bucket name containing the object to restore.
12320
12390
  #
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
12391
+ # When using this action with an access point, you must direct requests
12392
+ # to the access point hostname. The access point hostname takes the form
12323
12393
  # *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
12394
+ # When using this action with an access point through the AWS SDKs, you
12395
+ # provide the access point ARN in place of the bucket name. For more
12326
12396
  # information about access point ARNs, see [Using Access Points][1] in
12327
12397
  # the *Amazon Simple Storage Service Developer Guide*.
12328
12398
  #
12329
- # When using this API with Amazon S3 on Outposts, you must direct
12399
+ # When using this action with Amazon S3 on Outposts, you must direct
12330
12400
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
12331
12401
  # takes the form
12332
12402
  # *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*.
12403
+ # When using this action using S3 on Outposts through the AWS SDKs, you
12404
+ # provide the Outposts bucket ARN in place of the bucket name. For more
12405
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
12406
+ # in the *Amazon Simple Storage Service Developer Guide*.
12337
12407
  #
12338
12408
  #
12339
12409
  #
@@ -12341,7 +12411,7 @@ module Aws::S3
12341
12411
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
12342
12412
  #
12343
12413
  # @option params [required, String] :key
12344
- # Object key for which the operation was initiated.
12414
+ # Object key for which the action was initiated.
12345
12415
  #
12346
12416
  # @option params [String] :version_id
12347
12417
  # VersionId used to reference a specific version of the object.
@@ -12495,7 +12565,7 @@ module Aws::S3
12495
12565
  req.send_request(options)
12496
12566
  end
12497
12567
 
12498
- # This operation filters the contents of an Amazon S3 object based on a
12568
+ # This action filters the contents of an Amazon S3 object based on a
12499
12569
  # simple structured query language (SQL) statement. In the request,
12500
12570
  # along with the SQL expression, you must also specify a data
12501
12571
  # serialization format (JSON, CSV, or Apache Parquet) of the object.
@@ -12506,12 +12576,11 @@ module Aws::S3
12506
12576
  # This action is not supported by Amazon S3 on Outposts.
12507
12577
  #
12508
12578
  # For more information about Amazon S3 Select, see [Selecting Content
12509
- # from Objects][1] in the *Amazon Simple Storage Service Developer
12510
- # Guide*.
12579
+ # from Objects][1] in the *Amazon Simple Storage Service User Guide*.
12511
12580
  #
12512
12581
  # For more information about using SQL with Amazon S3 Select, see [ SQL
12513
12582
  # Reference for Amazon S3 Select and S3 Glacier Select][2] in the
12514
- # *Amazon Simple Storage Service Developer Guide*.
12583
+ # *Amazon Simple Storage Service User Guide*.
12515
12584
  #
12516
12585
  #
12517
12586
  #
@@ -12520,7 +12589,7 @@ module Aws::S3
12520
12589
  # You must have `s3:GetObject` permission for this operation. Amazon S3
12521
12590
  # Select does not support anonymous access. For more information about
12522
12591
  # permissions, see [Specifying Permissions in a Policy][3] in the
12523
- # *Amazon Simple Storage Service Developer Guide*.
12592
+ # *Amazon Simple Storage Service User Guide*.
12524
12593
  #
12525
12594
  #
12526
12595
  #
@@ -12548,7 +12617,7 @@ module Aws::S3
12548
12617
  # keys (SSE-C), you must use HTTPS, and you must use the headers that
12549
12618
  # are documented in the [GetObject][4]. For more information about
12550
12619
  # SSE-C, see [Server-Side Encryption (Using Customer-Provided
12551
- # Encryption Keys)][5] in the *Amazon Simple Storage Service Developer
12620
+ # Encryption Keys)][5] in the *Amazon Simple Storage Service User
12552
12621
  # Guide*.
12553
12622
  #
12554
12623
  # For objects that are encrypted with Amazon S3 managed encryption
@@ -12557,7 +12626,7 @@ module Aws::S3
12557
12626
  # transparently, so you don't need to specify anything. For more
12558
12627
  # information about server-side encryption, including SSE-S3 and
12559
12628
  # SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
12560
- # the *Amazon Simple Storage Service Developer Guide*.
12629
+ # the *Amazon Simple Storage Service User Guide*.
12561
12630
  #
12562
12631
  # **Working with the Response Body**
12563
12632
  #
@@ -12570,7 +12639,7 @@ module Aws::S3
12570
12639
  #
12571
12640
  # **GetObject Support**
12572
12641
  #
12573
- # The `SelectObjectContent` operation does not support the following
12642
+ # The `SelectObjectContent` action does not support the following
12574
12643
  # `GetObject` functionality. For more information, see [GetObject][4].
12575
12644
  #
12576
12645
  # * `Range`\: Although you can specify a scan range for an Amazon S3
@@ -12581,7 +12650,7 @@ module Aws::S3
12581
12650
  # * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
12582
12651
  # cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
12583
12652
  # storage classes. For more information, about storage classes see
12584
- # [Storage Classes][9] in the *Amazon Simple Storage Service Developer
12653
+ # [Storage Classes][9] in the *Amazon Simple Storage Service User
12585
12654
  # Guide*.
12586
12655
  #
12587
12656
  #
@@ -12948,12 +13017,11 @@ module Aws::S3
12948
13017
  # parts storage and stops charging you for the parts storage.
12949
13018
  #
12950
13019
  # For more information on multipart uploads, go to [Multipart Upload
12951
- # Overview][4] in the <i>Amazon Simple Storage Service Developer Guide
12952
- # </i>.
13020
+ # Overview][4] in the <i>Amazon Simple Storage Service User Guide </i>.
12953
13021
  #
12954
13022
  # 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*.
13023
+ # upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
13024
+ # Simple Storage Service User Guide*.
12957
13025
  #
12958
13026
  # You can optionally request server-side encryption where Amazon S3
12959
13027
  # encrypts your data as it writes it to disks in its data centers and
@@ -12963,8 +13031,8 @@ module Aws::S3
12963
13031
  # request headers you provide in the request must match the headers you
12964
13032
  # used in the request to initiate the upload by using
12965
13033
  # [CreateMultipartUpload][2]. For more information, go to [Using
12966
- # Server-Side Encryption][6] in the *Amazon Simple Storage Service
12967
- # Developer Guide*.
13034
+ # Server-Side Encryption][6] in the *Amazon Simple Storage Service User
13035
+ # Guide*.
12968
13036
  #
12969
13037
  # Server-side encryption is supported by the S3 Multipart Upload
12970
13038
  # actions. Unless you are using a customer-provided encryption key, you
@@ -13027,22 +13095,22 @@ module Aws::S3
13027
13095
  # @option params [required, String] :bucket
13028
13096
  # The name of the bucket to which the multipart upload was initiated.
13029
13097
  #
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
13098
+ # When using this action with an access point, you must direct requests
13099
+ # to the access point hostname. The access point hostname takes the form
13032
13100
  # *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
13101
+ # When using this action with an access point through the AWS SDKs, you
13102
+ # provide the access point ARN in place of the bucket name. For more
13035
13103
  # information about access point ARNs, see [Using Access Points][1] in
13036
13104
  # the *Amazon Simple Storage Service Developer Guide*.
13037
13105
  #
13038
- # When using this API with Amazon S3 on Outposts, you must direct
13106
+ # When using this action with Amazon S3 on Outposts, you must direct
13039
13107
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13040
13108
  # takes the form
13041
13109
  # *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*.
13110
+ # When using this action using S3 on Outposts through the AWS SDKs, you
13111
+ # provide the Outposts bucket ARN in place of the bucket name. For more
13112
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13113
+ # in the *Amazon Simple Storage Service Developer Guide*.
13046
13114
  #
13047
13115
  #
13048
13116
  #
@@ -13175,10 +13243,10 @@ module Aws::S3
13175
13243
  #
13176
13244
  # The minimum allowable part size for a multipart upload is 5 MB. For
13177
13245
  # more information about multipart upload limits, go to [Quick Facts][1]
13178
- # in the *Amazon Simple Storage Service Developer Guide*.
13246
+ # in the *Amazon Simple Storage Service User Guide*.
13179
13247
  #
13180
13248
  # <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.
13249
+ # [UploadPart][2] action and provide data in your request.
13182
13250
  #
13183
13251
  # </note>
13184
13252
  #
@@ -13192,15 +13260,15 @@ module Aws::S3
13192
13260
  #
13193
13261
  # * For conceptual information about multipart uploads, see [Uploading
13194
13262
  # Objects Using Multipart Upload][3] in the *Amazon Simple Storage
13195
- # Service Developer Guide*.
13263
+ # Service User Guide*.
13196
13264
  #
13197
13265
  # * 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*.
13266
+ # upload API, see [Multipart Upload and Permissions][4] in the *Amazon
13267
+ # Simple Storage Service User Guide*.
13200
13268
  #
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*.
13269
+ # * For information about copying objects using a single atomic action
13270
+ # vs. the multipart upload, see [Operations on Objects][5] in the
13271
+ # *Amazon Simple Storage Service User Guide*.
13204
13272
  #
13205
13273
  # * For information about using server-side encryption with
13206
13274
  # customer-provided encryption keys with the UploadPartCopy operation,
@@ -13302,22 +13370,22 @@ module Aws::S3
13302
13370
  # @option params [required, String] :bucket
13303
13371
  # The bucket name.
13304
13372
  #
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
13373
+ # When using this action with an access point, you must direct requests
13374
+ # to the access point hostname. The access point hostname takes the form
13307
13375
  # *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
13376
+ # When using this action with an access point through the AWS SDKs, you
13377
+ # provide the access point ARN in place of the bucket name. For more
13310
13378
  # information about access point ARNs, see [Using Access Points][1] in
13311
13379
  # the *Amazon Simple Storage Service Developer Guide*.
13312
13380
  #
13313
- # When using this API with Amazon S3 on Outposts, you must direct
13381
+ # When using this action with Amazon S3 on Outposts, you must direct
13314
13382
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13315
13383
  # takes the form
13316
13384
  # *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*.
13385
+ # When using this action using S3 on Outposts through the AWS SDKs, you
13386
+ # provide the Outposts bucket ARN in place of the bucket name. For more
13387
+ # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13388
+ # in the *Amazon Simple Storage Service Developer Guide*.
13321
13389
  #
13322
13390
  #
13323
13391
  #
@@ -13466,45 +13534,45 @@ module Aws::S3
13466
13534
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
13467
13535
  #
13468
13536
  #
13469
- # @example Example: To upload a part by copying data from an existing object as data source
13537
+ # @example Example: To upload a part by copying byte range from an existing object as data source
13470
13538
  #
13471
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
13539
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
13540
+ # # data source.
13472
13541
  #
13473
13542
  # resp = client.upload_part_copy({
13474
13543
  # bucket: "examplebucket",
13475
13544
  # copy_source: "/bucketname/sourceobjectkey",
13545
+ # copy_source_range: "bytes=1-100000",
13476
13546
  # key: "examplelargeobject",
13477
- # part_number: 1,
13547
+ # part_number: 2,
13478
13548
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
13479
13549
  # })
13480
13550
  #
13481
13551
  # resp.to_h outputs the following:
13482
13552
  # {
13483
13553
  # copy_part_result: {
13484
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
13485
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
13554
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
13555
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
13486
13556
  # },
13487
13557
  # }
13488
13558
  #
13489
- # @example Example: To upload a part by copying byte range from an existing object as data source
13559
+ # @example Example: To upload a part by copying data from an existing object as data source
13490
13560
  #
13491
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
13492
- # # data source.
13561
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
13493
13562
  #
13494
13563
  # resp = client.upload_part_copy({
13495
13564
  # bucket: "examplebucket",
13496
13565
  # copy_source: "/bucketname/sourceobjectkey",
13497
- # copy_source_range: "bytes=1-100000",
13498
13566
  # key: "examplelargeobject",
13499
- # part_number: 2,
13567
+ # part_number: 1,
13500
13568
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
13501
13569
  # })
13502
13570
  #
13503
13571
  # resp.to_h outputs the following:
13504
13572
  # {
13505
13573
  # copy_part_result: {
13506
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
13507
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
13574
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
13575
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
13508
13576
  # },
13509
13577
  # }
13510
13578
  #
@@ -13566,7 +13634,7 @@ module Aws::S3
13566
13634
  params: params,
13567
13635
  config: config)
13568
13636
  context[:gem_name] = 'aws-sdk-s3'
13569
- context[:gem_version] = '1.88.0'
13637
+ context[:gem_version] = '1.91.0'
13570
13638
  Seahorse::Client::Request.new(handlers, context)
13571
13639
  end
13572
13640