aws-sdk-s3 1.88.0 → 1.91.0

Sign up to get free protection for your applications and to get access to all the features.
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