aws-sdk-s3 1.84.1 → 1.117.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +930 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3/bucket.rb +154 -46
- data/lib/aws-sdk-s3/bucket_acl.rb +28 -6
- data/lib/aws-sdk-s3/bucket_cors.rb +29 -9
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +30 -9
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +31 -9
- data/lib/aws-sdk-s3/bucket_logging.rb +25 -6
- data/lib/aws-sdk-s3/bucket_notification.rb +21 -9
- data/lib/aws-sdk-s3/bucket_policy.rb +27 -7
- data/lib/aws-sdk-s3/bucket_request_payment.rb +27 -8
- data/lib/aws-sdk-s3/bucket_tagging.rb +27 -7
- data/lib/aws-sdk-s3/bucket_versioning.rb +70 -10
- data/lib/aws-sdk-s3/bucket_website.rb +27 -7
- data/lib/aws-sdk-s3/client.rb +3747 -1848
- data/lib/aws-sdk-s3/client_api.rb +677 -227
- data/lib/aws-sdk-s3/customizations/bucket.rb +28 -49
- data/lib/aws-sdk-s3/customizations/object.rb +116 -18
- data/lib/aws-sdk-s3/encryption/client.rb +1 -1
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/client.rb +1 -1
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +3 -3
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/endpoint_parameters.rb +142 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +2020 -0
- data/lib/aws-sdk-s3/endpoints.rb +2149 -0
- data/lib/aws-sdk-s3/errors.rb +1 -1
- data/lib/aws-sdk-s3/event_streams.rb +1 -1
- data/lib/aws-sdk-s3/file_downloader.rb +7 -2
- data/lib/aws-sdk-s3/file_uploader.rb +8 -3
- data/lib/aws-sdk-s3/legacy_signer.rb +15 -25
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +26 -7
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +36 -10
- data/lib/aws-sdk-s3/multipart_upload.rb +133 -19
- data/lib/aws-sdk-s3/multipart_upload_part.rb +141 -21
- data/lib/aws-sdk-s3/object.rb +430 -126
- data/lib/aws-sdk-s3/object_acl.rb +31 -9
- data/lib/aws-sdk-s3/object_summary.rb +265 -110
- data/lib/aws-sdk-s3/object_version.rb +80 -53
- data/lib/aws-sdk-s3/plugins/accelerate.rb +1 -39
- data/lib/aws-sdk-s3/plugins/arn.rb +25 -142
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +3 -39
- data/lib/aws-sdk-s3/plugins/bucket_name_restrictions.rb +1 -6
- data/lib/aws-sdk-s3/plugins/dualstack.rb +2 -49
- data/lib/aws-sdk-s3/plugins/endpoints.rb +262 -0
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +3 -1
- data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +1 -1
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +8 -31
- data/lib/aws-sdk-s3/plugins/md5s.rb +5 -3
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +33 -102
- data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +31 -0
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +23 -2
- data/lib/aws-sdk-s3/presigned_post.rb +47 -35
- data/lib/aws-sdk-s3/presigner.rb +39 -49
- data/lib/aws-sdk-s3/resource.rb +24 -4
- data/lib/aws-sdk-s3/types.rb +3785 -4735
- data/lib/aws-sdk-s3/waiters.rb +1 -1
- data/lib/aws-sdk-s3.rb +6 -2
- metadata +19 -14
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +0 -62
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +0 -71
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.117.2
|
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/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -34,7 +34,8 @@ module Aws::S3
|
|
34
34
|
@name
|
35
35
|
end
|
36
36
|
|
37
|
-
# Date the bucket was created.
|
37
|
+
# Date the bucket was created. This date can change when making changes
|
38
|
+
# to your bucket, such as editing its bucket policy.
|
38
39
|
# @return [Time]
|
39
40
|
def creation_date
|
40
41
|
data[:creation_date]
|
@@ -222,7 +223,7 @@ module Aws::S3
|
|
222
223
|
# bucket.create({
|
223
224
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
224
225
|
# create_bucket_configuration: {
|
225
|
-
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
226
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
226
227
|
# },
|
227
228
|
# grant_full_control: "GrantFullControl",
|
228
229
|
# grant_read: "GrantRead",
|
@@ -230,6 +231,7 @@ module Aws::S3
|
|
230
231
|
# grant_write: "GrantWrite",
|
231
232
|
# grant_write_acp: "GrantWriteACP",
|
232
233
|
# object_lock_enabled_for_bucket: false,
|
234
|
+
# object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
|
233
235
|
# })
|
234
236
|
# @param [Hash] options ({})
|
235
237
|
# @option options [String] :acl
|
@@ -244,13 +246,32 @@ module Aws::S3
|
|
244
246
|
# @option options [String] :grant_read_acp
|
245
247
|
# Allows grantee to read the bucket ACL.
|
246
248
|
# @option options [String] :grant_write
|
247
|
-
# Allows grantee to create
|
248
|
-
#
|
249
|
+
# Allows grantee to create new objects in the bucket.
|
250
|
+
#
|
251
|
+
# For the bucket and object owners of existing objects, also allows
|
252
|
+
# deletions and overwrites of those objects.
|
249
253
|
# @option options [String] :grant_write_acp
|
250
254
|
# Allows grantee to write the ACL for the applicable bucket.
|
251
255
|
# @option options [Boolean] :object_lock_enabled_for_bucket
|
252
256
|
# Specifies whether you want S3 Object Lock to be enabled for the new
|
253
257
|
# bucket.
|
258
|
+
# @option options [String] :object_ownership
|
259
|
+
# The container element for object ownership for a bucket's ownership
|
260
|
+
# controls.
|
261
|
+
#
|
262
|
+
# BucketOwnerPreferred - Objects uploaded to the bucket change ownership
|
263
|
+
# to the bucket owner if the objects are uploaded with the
|
264
|
+
# `bucket-owner-full-control` canned ACL.
|
265
|
+
#
|
266
|
+
# ObjectWriter - The uploading account will own the object if the object
|
267
|
+
# is uploaded with the `bucket-owner-full-control` canned ACL.
|
268
|
+
#
|
269
|
+
# BucketOwnerEnforced - Access control lists (ACLs) are disabled and no
|
270
|
+
# longer affect permissions. The bucket owner automatically owns and has
|
271
|
+
# full control over every object in the bucket. The bucket only accepts
|
272
|
+
# PUT requests that don't specify an ACL or bucket owner full control
|
273
|
+
# ACLs, such as the `bucket-owner-full-control` canned ACL or an
|
274
|
+
# equivalent form of this ACL expressed in the XML format.
|
254
275
|
# @return [Types::CreateBucketOutput]
|
255
276
|
def create(options = {})
|
256
277
|
options = options.merge(bucket: @name)
|
@@ -265,9 +286,9 @@ module Aws::S3
|
|
265
286
|
# })
|
266
287
|
# @param [Hash] options ({})
|
267
288
|
# @option options [String] :expected_bucket_owner
|
268
|
-
# The account
|
269
|
-
# a different account, the request
|
270
|
-
#
|
289
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
290
|
+
# a different account, the request fails with the HTTP status code `403
|
291
|
+
# Forbidden` (access denied).
|
271
292
|
# @return [EmptyStructure]
|
272
293
|
def delete(options = {})
|
273
294
|
options = options.merge(bucket: @name)
|
@@ -291,6 +312,7 @@ module Aws::S3
|
|
291
312
|
# request_payer: "requester", # accepts requester
|
292
313
|
# bypass_governance_retention: false,
|
293
314
|
# expected_bucket_owner: "AccountId",
|
315
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
294
316
|
# })
|
295
317
|
# @param [Hash] options ({})
|
296
318
|
# @option options [required, Types::Delete] :delete
|
@@ -303,21 +325,39 @@ module Aws::S3
|
|
303
325
|
# @option options [String] :request_payer
|
304
326
|
# Confirms that the requester knows that they will be charged for the
|
305
327
|
# request. Bucket owners need not specify this parameter in their
|
306
|
-
# requests. For information about downloading objects from
|
307
|
-
#
|
308
|
-
# in the *Amazon S3
|
328
|
+
# requests. For information about downloading objects from Requester
|
329
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
330
|
+
# in the *Amazon S3 User Guide*.
|
309
331
|
#
|
310
332
|
#
|
311
333
|
#
|
312
334
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
313
335
|
# @option options [Boolean] :bypass_governance_retention
|
314
336
|
# Specifies whether you want to delete this object even if it has a
|
315
|
-
# Governance-type Object Lock in place.
|
316
|
-
#
|
337
|
+
# Governance-type Object Lock in place. To use this header, you must
|
338
|
+
# have the `s3:BypassGovernanceRetention` permission.
|
317
339
|
# @option options [String] :expected_bucket_owner
|
318
|
-
# The account
|
319
|
-
# a different account, the request
|
320
|
-
#
|
340
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
341
|
+
# a different account, the request fails with the HTTP status code `403
|
342
|
+
# Forbidden` (access denied).
|
343
|
+
# @option options [String] :checksum_algorithm
|
344
|
+
# Indicates the algorithm used to create the checksum for the object
|
345
|
+
# when using the SDK. This header will not provide any additional
|
346
|
+
# functionality if not using the SDK. When sending this header, there
|
347
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
348
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
349
|
+
# `400 Bad Request`. For more information, see [Checking object
|
350
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
351
|
+
#
|
352
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
353
|
+
# `ChecksumAlgorithm` parameter.
|
354
|
+
#
|
355
|
+
# This checksum algorithm must be the same for all parts and it match
|
356
|
+
# the checksum value supplied in the `CreateMultipartUpload` request.
|
357
|
+
#
|
358
|
+
#
|
359
|
+
#
|
360
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
321
361
|
# @return [Types::DeleteObjectsOutput]
|
322
362
|
def delete_objects(options = {})
|
323
363
|
options = options.merge(bucket: @name)
|
@@ -337,6 +377,11 @@ module Aws::S3
|
|
337
377
|
# content_length: 1,
|
338
378
|
# content_md5: "ContentMD5",
|
339
379
|
# content_type: "ContentType",
|
380
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
381
|
+
# checksum_crc32: "ChecksumCRC32",
|
382
|
+
# checksum_crc32c: "ChecksumCRC32C",
|
383
|
+
# checksum_sha1: "ChecksumSHA1",
|
384
|
+
# checksum_sha256: "ChecksumSHA256",
|
340
385
|
# expires: Time.now,
|
341
386
|
# grant_full_control: "GrantFullControl",
|
342
387
|
# grant_read: "GrantRead",
|
@@ -347,13 +392,14 @@ module Aws::S3
|
|
347
392
|
# "MetadataKey" => "MetadataValue",
|
348
393
|
# },
|
349
394
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
350
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
395
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
351
396
|
# website_redirect_location: "WebsiteRedirectLocation",
|
352
397
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
353
398
|
# sse_customer_key: "SSECustomerKey",
|
354
399
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
355
400
|
# ssekms_key_id: "SSEKMSKeyId",
|
356
401
|
# ssekms_encryption_context: "SSEKMSEncryptionContext",
|
402
|
+
# bucket_key_enabled: false,
|
357
403
|
# request_payer: "requester", # accepts requester
|
358
404
|
# tagging: "TaggingHeader",
|
359
405
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
@@ -428,6 +474,61 @@ module Aws::S3
|
|
428
474
|
#
|
429
475
|
#
|
430
476
|
# [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
|
477
|
+
# @option options [String] :checksum_algorithm
|
478
|
+
# Indicates the algorithm used to create the checksum for the object
|
479
|
+
# when using the SDK. This header will not provide any additional
|
480
|
+
# functionality if not using the SDK. When sending this header, there
|
481
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
482
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
483
|
+
# `400 Bad Request`. For more information, see [Checking object
|
484
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
485
|
+
#
|
486
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
487
|
+
# `ChecksumAlgorithm` parameter.
|
488
|
+
#
|
489
|
+
#
|
490
|
+
#
|
491
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
492
|
+
# @option options [String] :checksum_crc32
|
493
|
+
# This header can be used as a data integrity check to verify that the
|
494
|
+
# data received is the same data that was originally sent. This header
|
495
|
+
# specifies the base64-encoded, 32-bit CRC32 checksum of the object. For
|
496
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
497
|
+
# User Guide*.
|
498
|
+
#
|
499
|
+
#
|
500
|
+
#
|
501
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
502
|
+
# @option options [String] :checksum_crc32c
|
503
|
+
# This header can be used as a data integrity check to verify that the
|
504
|
+
# data received is the same data that was originally sent. This header
|
505
|
+
# specifies the base64-encoded, 32-bit CRC32C checksum of the object.
|
506
|
+
# For more information, see [Checking object integrity][1] in the
|
507
|
+
# *Amazon S3 User Guide*.
|
508
|
+
#
|
509
|
+
#
|
510
|
+
#
|
511
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
512
|
+
# @option options [String] :checksum_sha1
|
513
|
+
# This header can be used as a data integrity check to verify that the
|
514
|
+
# data received is the same data that was originally sent. This header
|
515
|
+
# specifies the base64-encoded, 160-bit SHA-1 digest of the object. For
|
516
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
517
|
+
# User Guide*.
|
518
|
+
#
|
519
|
+
#
|
520
|
+
#
|
521
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
522
|
+
# @option options [String] :checksum_sha256
|
523
|
+
# This header can be used as a data integrity check to verify that the
|
524
|
+
# data received is the same data that was originally sent. This header
|
525
|
+
# specifies the base64-encoded, 256-bit SHA-256 digest of the object.
|
526
|
+
# For more information, see [Checking object integrity][1] in the
|
527
|
+
# *Amazon S3 User Guide*.
|
528
|
+
#
|
529
|
+
#
|
530
|
+
#
|
531
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
431
532
|
# @option options [Time,DateTime,Date,Integer,String] :expires
|
432
533
|
# The date and time at which the object is no longer cacheable. For more
|
433
534
|
# information, see
|
@@ -454,7 +555,7 @@ module Aws::S3
|
|
454
555
|
#
|
455
556
|
# This action is not supported by Amazon S3 on Outposts.
|
456
557
|
# @option options [required, String] :key
|
457
|
-
# Object key for which the PUT
|
558
|
+
# Object key for which the PUT action was initiated.
|
458
559
|
# @option options [Hash<String,String>] :metadata
|
459
560
|
# A map of metadata to store with the object in S3.
|
460
561
|
# @option options [String] :server_side_encryption
|
@@ -466,7 +567,7 @@ module Aws::S3
|
|
466
567
|
# and high availability. Depending on performance needs, you can specify
|
467
568
|
# a different Storage Class. Amazon S3 on Outposts only uses the
|
468
569
|
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
469
|
-
# in the *Amazon S3
|
570
|
+
# in the *Amazon S3 User Guide*.
|
470
571
|
#
|
471
572
|
#
|
472
573
|
#
|
@@ -511,26 +612,32 @@ module Aws::S3
|
|
511
612
|
# ensure that the encryption key was transmitted without error.
|
512
613
|
# @option options [String] :ssekms_key_id
|
513
614
|
# If `x-amz-server-side-encryption` is present and has the value of
|
514
|
-
# `aws:kms`, this header specifies the ID of the
|
515
|
-
# Service (
|
516
|
-
#
|
517
|
-
#
|
518
|
-
# If the value of `x-amz-server-side-encryption` is `aws:kms`, this
|
519
|
-
# header specifies the ID of the symmetric customer managed AWS KMS CMK
|
520
|
-
# that will be used for the object. If you specify
|
615
|
+
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
616
|
+
# Management Service (Amazon Web Services KMS) symmetrical customer
|
617
|
+
# managed key that was used for the object. If you specify
|
521
618
|
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
522
|
-
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
523
|
-
#
|
619
|
+
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
620
|
+
# Amazon Web Services managed key to protect the data. If the KMS key
|
621
|
+
# does not exist in the same account issuing the command, you must use
|
622
|
+
# the full ARN and not just the ID.
|
524
623
|
# @option options [String] :ssekms_encryption_context
|
525
|
-
# Specifies the
|
526
|
-
# The value of this header is a base64-encoded UTF-8
|
527
|
-
# with the encryption context key-value pairs.
|
624
|
+
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
625
|
+
# object encryption. The value of this header is a base64-encoded UTF-8
|
626
|
+
# string holding JSON with the encryption context key-value pairs.
|
627
|
+
# @option options [Boolean] :bucket_key_enabled
|
628
|
+
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
629
|
+
# encryption with server-side encryption using AWS KMS (SSE-KMS).
|
630
|
+
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
631
|
+
# for object encryption with SSE-KMS.
|
632
|
+
#
|
633
|
+
# Specifying this header with a PUT action doesn’t affect bucket-level
|
634
|
+
# settings for S3 Bucket Key.
|
528
635
|
# @option options [String] :request_payer
|
529
636
|
# Confirms that the requester knows that they will be charged for the
|
530
637
|
# request. Bucket owners need not specify this parameter in their
|
531
|
-
# requests. For information about downloading objects from
|
532
|
-
#
|
533
|
-
# in the *Amazon S3
|
638
|
+
# requests. For information about downloading objects from Requester
|
639
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
640
|
+
# in the *Amazon S3 User Guide*.
|
534
641
|
#
|
535
642
|
#
|
536
643
|
#
|
@@ -542,6 +649,7 @@ module Aws::S3
|
|
542
649
|
# The Object Lock mode that you want to apply to this object.
|
543
650
|
# @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
|
544
651
|
# The date and time when you want this object's Object Lock to expire.
|
652
|
+
# Must be formatted as a timestamp parameter.
|
545
653
|
# @option options [String] :object_lock_legal_hold_status
|
546
654
|
# Specifies whether a legal hold will be applied to this object. For
|
547
655
|
# more information about S3 Object Lock, see [Object Lock][1].
|
@@ -550,9 +658,9 @@ module Aws::S3
|
|
550
658
|
#
|
551
659
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
552
660
|
# @option options [String] :expected_bucket_owner
|
553
|
-
# The account
|
554
|
-
# a different account, the request
|
555
|
-
#
|
661
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
662
|
+
# a different account, the request fails with the HTTP status code `403
|
663
|
+
# Forbidden` (access denied).
|
556
664
|
# @return [Object]
|
557
665
|
def put_object(options = {})
|
558
666
|
options = options.merge(bucket: @name)
|
@@ -658,9 +766,9 @@ module Aws::S3
|
|
658
766
|
# list only if they have an upload ID lexicographically greater than the
|
659
767
|
# specified `upload-id-marker`.
|
660
768
|
# @option options [String] :expected_bucket_owner
|
661
|
-
# The account
|
662
|
-
# a different account, the request
|
663
|
-
#
|
769
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
770
|
+
# a different account, the request fails with the HTTP status code `403
|
771
|
+
# Forbidden` (access denied).
|
664
772
|
# @return [MultipartUpload::Collection]
|
665
773
|
def multipart_uploads(options = {})
|
666
774
|
batches = Enumerator.new do |y|
|
@@ -738,9 +846,9 @@ module Aws::S3
|
|
738
846
|
# @option options [String] :version_id_marker
|
739
847
|
# Specifies the object version you want to start listing from.
|
740
848
|
# @option options [String] :expected_bucket_owner
|
741
|
-
# The account
|
742
|
-
# a different account, the request
|
743
|
-
#
|
849
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
850
|
+
# a different account, the request fails with the HTTP status code `403
|
851
|
+
# Forbidden` (access denied).
|
744
852
|
# @return [ObjectVersion::Collection]
|
745
853
|
def object_versions(options = {})
|
746
854
|
batches = Enumerator.new do |y|
|
@@ -794,9 +902,9 @@ module Aws::S3
|
|
794
902
|
# the list objects request in V2 style. Bucket owners need not specify
|
795
903
|
# this parameter in their requests.
|
796
904
|
# @option options [String] :expected_bucket_owner
|
797
|
-
# The account
|
798
|
-
# a different account, the request
|
799
|
-
#
|
905
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
906
|
+
# a different account, the request fails with the HTTP status code `403
|
907
|
+
# Forbidden` (access denied).
|
800
908
|
# @return [ObjectSummary::Collection]
|
801
909
|
def objects(options = {})
|
802
910
|
batches = Enumerator.new do |y|
|
@@ -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/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -203,6 +203,7 @@ module Aws::S3
|
|
203
203
|
# },
|
204
204
|
# },
|
205
205
|
# content_md5: "ContentMD5",
|
206
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
206
207
|
# grant_full_control: "GrantFullControl",
|
207
208
|
# grant_read: "GrantRead",
|
208
209
|
# grant_read_acp: "GrantReadACP",
|
@@ -221,9 +222,28 @@ module Aws::S3
|
|
221
222
|
# used as a message integrity check to verify that the request body was
|
222
223
|
# not corrupted in transit. For more information, go to [RFC 1864.][1]
|
223
224
|
#
|
225
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
226
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
227
|
+
# automatically.
|
228
|
+
#
|
224
229
|
#
|
225
230
|
#
|
226
231
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
232
|
+
# @option options [String] :checksum_algorithm
|
233
|
+
# Indicates the algorithm used to create the checksum for the object
|
234
|
+
# when using the SDK. This header will not provide any additional
|
235
|
+
# functionality if not using the SDK. When sending this header, there
|
236
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
237
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
238
|
+
# `400 Bad Request`. For more information, see [Checking object
|
239
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
240
|
+
#
|
241
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
242
|
+
# `ChecksumAlgorithm` parameter.
|
243
|
+
#
|
244
|
+
#
|
245
|
+
#
|
246
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
227
247
|
# @option options [String] :grant_full_control
|
228
248
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
229
249
|
# the bucket.
|
@@ -232,14 +252,16 @@ module Aws::S3
|
|
232
252
|
# @option options [String] :grant_read_acp
|
233
253
|
# Allows grantee to read the bucket ACL.
|
234
254
|
# @option options [String] :grant_write
|
235
|
-
# Allows grantee to create
|
236
|
-
#
|
255
|
+
# Allows grantee to create new objects in the bucket.
|
256
|
+
#
|
257
|
+
# For the bucket and object owners of existing objects, also allows
|
258
|
+
# deletions and overwrites of those objects.
|
237
259
|
# @option options [String] :grant_write_acp
|
238
260
|
# Allows grantee to write the ACL for the applicable bucket.
|
239
261
|
# @option options [String] :expected_bucket_owner
|
240
|
-
# The account
|
241
|
-
# a different account, the request
|
242
|
-
#
|
262
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
263
|
+
# a different account, the request fails with the HTTP status code `403
|
264
|
+
# Forbidden` (access denied).
|
243
265
|
# @return [EmptyStructure]
|
244
266
|
def put(options = {})
|
245
267
|
options = options.merge(bucket: @bucket_name)
|