aws-sdk-s3 1.113.0 → 1.133.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +163 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +108 -55
- data/lib/aws-sdk-s3/bucket_acl.rb +9 -3
- data/lib/aws-sdk-s3/bucket_cors.rb +12 -4
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +12 -4
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +12 -4
- data/lib/aws-sdk-s3/bucket_logging.rb +9 -3
- data/lib/aws-sdk-s3/bucket_notification.rb +9 -3
- data/lib/aws-sdk-s3/bucket_policy.rb +12 -4
- data/lib/aws-sdk-s3/bucket_request_payment.rb +9 -3
- data/lib/aws-sdk-s3/bucket_tagging.rb +12 -4
- data/lib/aws-sdk-s3/bucket_versioning.rb +15 -5
- data/lib/aws-sdk-s3/bucket_website.rb +12 -4
- data/lib/aws-sdk-s3/client.rb +1894 -1573
- data/lib/aws-sdk-s3/client_api.rb +213 -189
- data/lib/aws-sdk-s3/customizations/bucket.rb +23 -47
- data/lib/aws-sdk-s3/customizations/errors.rb +27 -0
- data/lib/aws-sdk-s3/customizations/object.rb +95 -19
- data/lib/aws-sdk-s3/customizations/types/permanent_redirect.rb +26 -0
- data/lib/aws-sdk-s3/customizations.rb +2 -0
- data/lib/aws-sdk-s3/encryption/client.rb +6 -2
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +13 -9
- data/lib/aws-sdk-s3/encryptionV2/client.rb +6 -2
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +1 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +10 -6
- data/lib/aws-sdk-s3/endpoint_parameters.rb +146 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +509 -0
- data/lib/aws-sdk-s3/endpoints.rb +2150 -0
- data/lib/aws-sdk-s3/file_downloader.rb +170 -44
- data/lib/aws-sdk-s3/file_uploader.rb +8 -6
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +41 -13
- data/lib/aws-sdk-s3/multipart_upload.rb +12 -4
- data/lib/aws-sdk-s3/multipart_upload_part.rb +10 -4
- data/lib/aws-sdk-s3/object.rb +105 -77
- data/lib/aws-sdk-s3/object_acl.rb +9 -3
- data/lib/aws-sdk-s3/object_copier.rb +7 -5
- data/lib/aws-sdk-s3/object_multipart_copier.rb +41 -19
- data/lib/aws-sdk-s3/object_summary.rb +106 -65
- data/lib/aws-sdk-s3/object_version.rb +35 -9
- data/lib/aws-sdk-s3/plugins/accelerate.rb +3 -50
- data/lib/aws-sdk-s3/plugins/arn.rb +0 -184
- 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 +1 -49
- data/lib/aws-sdk-s3/plugins/endpoints.rb +262 -0
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +2 -1
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +0 -29
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +35 -124
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +23 -2
- data/lib/aws-sdk-s3/presigned_post.rb +61 -59
- data/lib/aws-sdk-s3/presigner.rb +24 -35
- data/lib/aws-sdk-s3/resource.rb +7 -3
- data/lib/aws-sdk-s3/types.rb +714 -4040
- data/lib/aws-sdk-s3.rb +5 -1
- metadata +12 -11
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +0 -69
- data/lib/aws-sdk-s3/arn/multi_region_access_point_arn.rb +0 -68
- data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +0 -69
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +0 -74
- data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +0 -25
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 04f11cfde483787571492064565bb589b16323f4bb7f33f5a7507b993f6cead3
|
4
|
+
data.tar.gz: 1dd900a34a20b97fb82c41407ca12c40d33397fb14e29678e0f7e3b0a1e5b77c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 745b68d37b0845463f3c2a1cfdb29e8833bd0d723e31a1071c1f3936f095e4c735c909573c8df49f077b3f56dfa13f9e45552c68d7e5a5c0718b67d3f08418e2
|
7
|
+
data.tar.gz: f995dde0e5628863ab664b36a4db27a23e8d68827aab268fecacfa217a104f1bb3cfd67e84bf6729e52544d9015fd3c64765a53fe0758647e5904c1f104235e1
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,169 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.133.0 (2023-08-22)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
8
|
+
|
9
|
+
* Feature - Add support for `progress_callback` in `Object#download_file` and improve multi-threaded performance #(2901).
|
10
|
+
|
11
|
+
1.132.1 (2023-08-09)
|
12
|
+
------------------
|
13
|
+
|
14
|
+
* Issue - Add support for disabling checksum validation in `Object#download_file` (#2893).
|
15
|
+
|
16
|
+
1.132.0 (2023-07-24)
|
17
|
+
------------------
|
18
|
+
|
19
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
20
|
+
|
21
|
+
* Feature - Add support for verifying checksums in FileDownloader.
|
22
|
+
|
23
|
+
1.131.0 (2023-07-20)
|
24
|
+
------------------
|
25
|
+
|
26
|
+
* Feature - Improve performance of S3 clients by simplifying and optimizing endpoint resolution.
|
27
|
+
|
28
|
+
1.130.0 (2023-07-13)
|
29
|
+
------------------
|
30
|
+
|
31
|
+
* Feature - S3 Inventory now supports Object Access Control List and Object Owner as available object metadata fields in inventory reports.
|
32
|
+
|
33
|
+
* Feature - Allow Object multipart copy API to work when requiring a checksum algorithm.
|
34
|
+
* Feature - Allow Object multipart copy API to optionally copy parts as they exist on the source object if it has parts, instead of generating new part ranges, when specifying `use_source_parts: true`.
|
35
|
+
|
36
|
+
1.129.0 (2023-07-11)
|
37
|
+
------------------
|
38
|
+
|
39
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
40
|
+
|
41
|
+
1.128.0 (2023-07-06)
|
42
|
+
------------------
|
43
|
+
|
44
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
45
|
+
|
46
|
+
1.127.0 (2023-06-28)
|
47
|
+
------------------
|
48
|
+
|
49
|
+
* Feature - The S3 LISTObjects, ListObjectsV2 and ListObjectVersions API now supports a new optional header x-amz-optional-object-attributes. If header contains RestoreStatus as the value, then S3 will include Glacier restore status i.e. isRestoreInProgress and RestoreExpiryDate in List response.
|
50
|
+
|
51
|
+
* Feature - Select minimum expiration time for presigned urls between the expiration time option and the credential expiration time.
|
52
|
+
|
53
|
+
1.126.0 (2023-06-16)
|
54
|
+
------------------
|
55
|
+
|
56
|
+
* Feature - This release adds SDK support for request-payer request header and request-charged response header in the "GetBucketAccelerateConfiguration", "ListMultipartUploads", "ListObjects", "ListObjectsV2" and "ListObjectVersions" S3 APIs.
|
57
|
+
|
58
|
+
1.125.0 (2023-06-15)
|
59
|
+
------------------
|
60
|
+
|
61
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
62
|
+
|
63
|
+
1.124.0 (2023-06-13)
|
64
|
+
------------------
|
65
|
+
|
66
|
+
* Feature - Integrate double encryption feature to SDKs.
|
67
|
+
|
68
|
+
1.123.2 (2023-06-12)
|
69
|
+
------------------
|
70
|
+
|
71
|
+
* Issue - Fix issue when decrypting noncurrent versions of objects when using client side encryption (#2866).
|
72
|
+
|
73
|
+
1.123.1 (2023-06-02)
|
74
|
+
------------------
|
75
|
+
|
76
|
+
* Issue - Fix multipart `download_file` so that it does not download bytes out of range (#2859).
|
77
|
+
|
78
|
+
1.123.0 (2023-05-31)
|
79
|
+
------------------
|
80
|
+
|
81
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
82
|
+
|
83
|
+
1.122.0 (2023-05-04)
|
84
|
+
------------------
|
85
|
+
|
86
|
+
* Feature - Documentation updates for Amazon S3
|
87
|
+
|
88
|
+
1.121.0 (2023-04-19)
|
89
|
+
------------------
|
90
|
+
|
91
|
+
* Feature - Provides support for "Snow" Storage class.
|
92
|
+
|
93
|
+
1.120.1 (2023-04-05)
|
94
|
+
------------------
|
95
|
+
|
96
|
+
* Issue - Skip `#check_for_cached_region` if custom endpoint provided
|
97
|
+
|
98
|
+
1.120.0 (2023-03-31)
|
99
|
+
------------------
|
100
|
+
|
101
|
+
* Feature - Documentation updates for Amazon S3
|
102
|
+
|
103
|
+
1.119.2 (2023-03-22)
|
104
|
+
------------------
|
105
|
+
|
106
|
+
* Issue - Provide `endpoint` and `bucket` attributes on `Aws::S3::Errors::PermanentRedirect` error objects.
|
107
|
+
|
108
|
+
1.119.1 (2023-02-13)
|
109
|
+
------------------
|
110
|
+
|
111
|
+
* Issue - Ensure object metadata is not lost on multipart copy (#2821).
|
112
|
+
|
113
|
+
1.119.0 (2023-01-26)
|
114
|
+
------------------
|
115
|
+
|
116
|
+
* Feature - Allow FIPS to be used with path-style URLs.
|
117
|
+
|
118
|
+
1.118.0 (2023-01-18)
|
119
|
+
------------------
|
120
|
+
|
121
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
122
|
+
|
123
|
+
* Issue - Replace runtime endpoint resolution approach with generated ruby code.
|
124
|
+
|
125
|
+
1.117.2 (2022-11-30)
|
126
|
+
------------------
|
127
|
+
|
128
|
+
* Issue - Return error messages from failures in threads in `MultipartStreamUploader` (#2793).
|
129
|
+
|
130
|
+
1.117.1 (2022-10-26)
|
131
|
+
------------------
|
132
|
+
|
133
|
+
* Issue - Fix custom endpoint and port regression with `presigned_url` (#2776).
|
134
|
+
|
135
|
+
1.117.0 (2022-10-25)
|
136
|
+
------------------
|
137
|
+
|
138
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
139
|
+
|
140
|
+
* Issue - Apply checksums to MultipartStreamUploader (#2769).
|
141
|
+
|
142
|
+
1.116.0 (2022-10-21)
|
143
|
+
------------------
|
144
|
+
|
145
|
+
* Feature - S3 on Outposts launches support for automatic bucket-style alias. You can use the automatic access point alias instead of an access point ARN for any object-level operation in an Outposts bucket.
|
146
|
+
|
147
|
+
1.115.0 (2022-10-19)
|
148
|
+
------------------
|
149
|
+
|
150
|
+
* Feature - Updates internal logic for constructing API endpoints. We have added rule-based endpoints and internal model parameters.
|
151
|
+
|
152
|
+
1.114.0 (2022-05-03)
|
153
|
+
------------------
|
154
|
+
|
155
|
+
* Feature - Documentation only update for doc bug fixes for the S3 API docs.
|
156
|
+
|
157
|
+
1.113.2 (2022-04-26)
|
158
|
+
------------------
|
159
|
+
|
160
|
+
* Issue - Fix an issue where `ExpiredToken` errors were retried as if the request was from another region.
|
161
|
+
|
162
|
+
1.113.1 (2022-04-25)
|
163
|
+
------------------
|
164
|
+
|
165
|
+
* Issue - Rewind the underlying file on a streaming retry that is not a truncated body (#2692).
|
166
|
+
|
4
167
|
1.113.0 (2022-02-24)
|
5
168
|
------------------
|
6
169
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.133.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -95,7 +95,9 @@ module Aws::S3
|
|
95
95
|
options, params = separate_params_and_options(options)
|
96
96
|
waiter = Waiters::BucketExists.new(options)
|
97
97
|
yield_waiter_and_warn(waiter, &block) if block_given?
|
98
|
-
|
98
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
99
|
+
waiter.wait(params.merge(bucket: @name))
|
100
|
+
end
|
99
101
|
Bucket.new({
|
100
102
|
name: @name,
|
101
103
|
client: @client
|
@@ -112,7 +114,9 @@ module Aws::S3
|
|
112
114
|
options, params = separate_params_and_options(options)
|
113
115
|
waiter = Waiters::BucketNotExists.new(options)
|
114
116
|
yield_waiter_and_warn(waiter, &block) if block_given?
|
115
|
-
|
117
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
118
|
+
waiter.wait(params.merge(bucket: @name))
|
119
|
+
end
|
116
120
|
Bucket.new({
|
117
121
|
name: @name,
|
118
122
|
client: @client
|
@@ -213,7 +217,9 @@ module Aws::S3
|
|
213
217
|
:retry
|
214
218
|
end
|
215
219
|
end
|
216
|
-
Aws::
|
220
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
221
|
+
Aws::Waiters::Waiter.new(options).wait({})
|
222
|
+
end
|
217
223
|
end
|
218
224
|
|
219
225
|
# @!group Actions
|
@@ -223,7 +229,7 @@ module Aws::S3
|
|
223
229
|
# bucket.create({
|
224
230
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
225
231
|
# create_bucket_configuration: {
|
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, 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
|
232
|
+
# 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, ap-south-2, eu-south-2
|
227
233
|
# },
|
228
234
|
# grant_full_control: "GrantFullControl",
|
229
235
|
# grant_read: "GrantRead",
|
@@ -275,7 +281,9 @@ module Aws::S3
|
|
275
281
|
# @return [Types::CreateBucketOutput]
|
276
282
|
def create(options = {})
|
277
283
|
options = options.merge(bucket: @name)
|
278
|
-
resp =
|
284
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
285
|
+
@client.create_bucket(options)
|
286
|
+
end
|
279
287
|
resp.data
|
280
288
|
end
|
281
289
|
|
@@ -292,7 +300,9 @@ module Aws::S3
|
|
292
300
|
# @return [EmptyStructure]
|
293
301
|
def delete(options = {})
|
294
302
|
options = options.merge(bucket: @name)
|
295
|
-
resp =
|
303
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
304
|
+
@client.delete_bucket(options)
|
305
|
+
end
|
296
306
|
resp.data
|
297
307
|
end
|
298
308
|
|
@@ -361,7 +371,9 @@ module Aws::S3
|
|
361
371
|
# @return [Types::DeleteObjectsOutput]
|
362
372
|
def delete_objects(options = {})
|
363
373
|
options = options.merge(bucket: @name)
|
364
|
-
resp =
|
374
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
375
|
+
@client.delete_objects(options)
|
376
|
+
end
|
365
377
|
resp.data
|
366
378
|
end
|
367
379
|
|
@@ -391,8 +403,8 @@ module Aws::S3
|
|
391
403
|
# metadata: {
|
392
404
|
# "MetadataKey" => "MetadataValue",
|
393
405
|
# },
|
394
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
395
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
406
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
407
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW
|
396
408
|
# website_redirect_location: "WebsiteRedirectLocation",
|
397
409
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
398
410
|
# sse_customer_key: "SSECustomerKey",
|
@@ -430,30 +442,30 @@ module Aws::S3
|
|
430
442
|
# @option options [String] :content_disposition
|
431
443
|
# Specifies presentational information for the object. For more
|
432
444
|
# information, see
|
433
|
-
# [
|
445
|
+
# [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
|
434
446
|
#
|
435
447
|
#
|
436
448
|
#
|
437
|
-
# [1]:
|
449
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
|
438
450
|
# @option options [String] :content_encoding
|
439
451
|
# Specifies what content encodings have been applied to the object and
|
440
452
|
# thus what decoding mechanisms must be applied to obtain the media-type
|
441
453
|
# referenced by the Content-Type header field. For more information, see
|
442
|
-
# [
|
454
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
|
443
455
|
#
|
444
456
|
#
|
445
457
|
#
|
446
|
-
# [1]:
|
458
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
|
447
459
|
# @option options [String] :content_language
|
448
460
|
# The language the content is in.
|
449
461
|
# @option options [Integer] :content_length
|
450
462
|
# Size of the body in bytes. This parameter is useful when the size of
|
451
463
|
# the body cannot be determined automatically. For more information, see
|
452
|
-
# [
|
464
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
|
453
465
|
#
|
454
466
|
#
|
455
467
|
#
|
456
|
-
# [1]:
|
468
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
|
457
469
|
# @option options [String] :content_md5
|
458
470
|
# The base64-encoded 128-bit MD5 digest of the message (without the
|
459
471
|
# headers) according to RFC 1864. This header can be used as a message
|
@@ -469,11 +481,11 @@ module Aws::S3
|
|
469
481
|
# @option options [String] :content_type
|
470
482
|
# A standard MIME type describing the format of the contents. For more
|
471
483
|
# information, see
|
472
|
-
# [
|
484
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
|
473
485
|
#
|
474
486
|
#
|
475
487
|
#
|
476
|
-
# [1]:
|
488
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
|
477
489
|
# @option options [String] :checksum_algorithm
|
478
490
|
# Indicates the algorithm used to create the checksum for the object
|
479
491
|
# when using the SDK. This header will not provide any additional
|
@@ -532,11 +544,11 @@ module Aws::S3
|
|
532
544
|
# @option options [Time,DateTime,Date,Integer,String] :expires
|
533
545
|
# The date and time at which the object is no longer cacheable. For more
|
534
546
|
# information, see
|
535
|
-
# [
|
547
|
+
# [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
|
536
548
|
#
|
537
549
|
#
|
538
550
|
#
|
539
|
-
# [1]:
|
551
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
540
552
|
# @option options [String] :grant_full_control
|
541
553
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
542
554
|
# object.
|
@@ -560,7 +572,7 @@ module Aws::S3
|
|
560
572
|
# A map of metadata to store with the object in S3.
|
561
573
|
# @option options [String] :server_side_encryption
|
562
574
|
# The server-side encryption algorithm used when storing this object in
|
563
|
-
# Amazon S3 (for example, AES256
|
575
|
+
# Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
|
564
576
|
# @option options [String] :storage_class
|
565
577
|
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
566
578
|
# created objects. The STANDARD storage class provides high durability
|
@@ -611,24 +623,27 @@ module Aws::S3
|
|
611
623
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
612
624
|
# ensure that the encryption key was transmitted without error.
|
613
625
|
# @option options [String] :ssekms_key_id
|
614
|
-
# If `x-amz-server-side-encryption`
|
615
|
-
# `aws:kms`, this header specifies the ID of the
|
616
|
-
#
|
617
|
-
#
|
618
|
-
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
626
|
+
# If `x-amz-server-side-encryption` has a valid value of `aws:kms` or
|
627
|
+
# `aws:kms:dsse`, this header specifies the ID of the Key Management
|
628
|
+
# Service (KMS) symmetric encryption customer managed key that was used
|
629
|
+
# for the object. If you specify `x-amz-server-side-encryption:aws:kms`
|
630
|
+
# or `x-amz-server-side-encryption:aws:kms:dsse`, but do not provide`
|
619
631
|
# 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
|
621
|
-
# does not exist in the same account issuing the
|
622
|
-
# the full ARN and not just the ID.
|
632
|
+
# Amazon Web Services managed key (`aws/s3`) to protect the data. If the
|
633
|
+
# KMS key does not exist in the same account that's issuing the
|
634
|
+
# command, you must use the full ARN and not just the ID.
|
623
635
|
# @option options [String] :ssekms_encryption_context
|
624
636
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
625
637
|
# object encryption. The value of this header is a base64-encoded UTF-8
|
626
|
-
# string holding JSON with the encryption context key-value pairs.
|
638
|
+
# string holding JSON with the encryption context key-value pairs. This
|
639
|
+
# value is stored as object metadata and automatically gets passed on to
|
640
|
+
# Amazon Web Services KMS for future `GetObject` or `CopyObject`
|
641
|
+
# operations on this object.
|
627
642
|
# @option options [Boolean] :bucket_key_enabled
|
628
643
|
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
629
|
-
# encryption with server-side encryption using
|
630
|
-
# Setting this header to `true` causes Amazon S3
|
631
|
-
# for object encryption with SSE-KMS.
|
644
|
+
# encryption with server-side encryption using Key Management Service
|
645
|
+
# (KMS) keys (SSE-KMS). Setting this header to `true` causes Amazon S3
|
646
|
+
# to use an S3 Bucket Key for object encryption with SSE-KMS.
|
632
647
|
#
|
633
648
|
# Specifying this header with a PUT action doesn’t affect bucket-level
|
634
649
|
# settings for S3 Bucket Key.
|
@@ -664,7 +679,9 @@ module Aws::S3
|
|
664
679
|
# @return [Object]
|
665
680
|
def put_object(options = {})
|
666
681
|
options = options.merge(bucket: @name)
|
667
|
-
|
682
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
683
|
+
@client.put_object(options)
|
684
|
+
end
|
668
685
|
Object.new(
|
669
686
|
bucket_name: @name,
|
670
687
|
key: options[:key],
|
@@ -723,6 +740,7 @@ module Aws::S3
|
|
723
740
|
# prefix: "Prefix",
|
724
741
|
# upload_id_marker: "UploadIdMarker",
|
725
742
|
# expected_bucket_owner: "AccountId",
|
743
|
+
# request_payer: "requester", # accepts requester
|
726
744
|
# })
|
727
745
|
# @param [Hash] options ({})
|
728
746
|
# @option options [String] :delimiter
|
@@ -736,14 +754,14 @@ module Aws::S3
|
|
736
754
|
# result element are not returned elsewhere in the response.
|
737
755
|
# @option options [String] :encoding_type
|
738
756
|
# Requests Amazon S3 to encode the object keys in the response and
|
739
|
-
# specifies the encoding method to use. An object key
|
740
|
-
# Unicode character; however, XML 1.0 parser cannot parse some
|
757
|
+
# specifies the encoding method to use. An object key can contain any
|
758
|
+
# Unicode character; however, the XML 1.0 parser cannot parse some
|
741
759
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
742
760
|
# characters that are not supported in XML 1.0, you can add this
|
743
761
|
# parameter to request that Amazon S3 encode the keys in the response.
|
744
762
|
# @option options [String] :key_marker
|
745
|
-
# Together with upload-id-marker
|
746
|
-
# upload after which listing should begin.
|
763
|
+
# Together with `upload-id-marker`, this parameter specifies the
|
764
|
+
# multipart upload after which listing should begin.
|
747
765
|
#
|
748
766
|
# If `upload-id-marker` is not specified, only the keys
|
749
767
|
# lexicographically greater than the specified `key-marker` will be
|
@@ -756,8 +774,8 @@ module Aws::S3
|
|
756
774
|
# @option options [String] :prefix
|
757
775
|
# Lists in-progress uploads only for those keys that begin with the
|
758
776
|
# specified prefix. You can use prefixes to separate a bucket into
|
759
|
-
# different grouping of keys. (You can think of using prefix to make
|
760
|
-
# groups in the same way you'd use a folder in a file system.)
|
777
|
+
# different grouping of keys. (You can think of using `prefix` to make
|
778
|
+
# groups in the same way that you'd use a folder in a file system.)
|
761
779
|
# @option options [String] :upload_id_marker
|
762
780
|
# Together with key-marker, specifies the multipart upload after which
|
763
781
|
# listing should begin. If key-marker is not specified, the
|
@@ -769,11 +787,23 @@ module Aws::S3
|
|
769
787
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
770
788
|
# a different account, the request fails with the HTTP status code `403
|
771
789
|
# Forbidden` (access denied).
|
790
|
+
# @option options [String] :request_payer
|
791
|
+
# Confirms that the requester knows that they will be charged for the
|
792
|
+
# request. Bucket owners need not specify this parameter in their
|
793
|
+
# requests. For information about downloading objects from Requester
|
794
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
795
|
+
# in the *Amazon S3 User Guide*.
|
796
|
+
#
|
797
|
+
#
|
798
|
+
#
|
799
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
772
800
|
# @return [MultipartUpload::Collection]
|
773
801
|
def multipart_uploads(options = {})
|
774
802
|
batches = Enumerator.new do |y|
|
775
803
|
options = options.merge(bucket: @name)
|
776
|
-
resp =
|
804
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
805
|
+
@client.list_multipart_uploads(options)
|
806
|
+
end
|
777
807
|
resp.each_page do |page|
|
778
808
|
batch = []
|
779
809
|
page.data.uploads.each do |u|
|
@@ -818,19 +848,21 @@ module Aws::S3
|
|
818
848
|
# prefix: "Prefix",
|
819
849
|
# version_id_marker: "VersionIdMarker",
|
820
850
|
# expected_bucket_owner: "AccountId",
|
851
|
+
# request_payer: "requester", # accepts requester
|
852
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
821
853
|
# })
|
822
854
|
# @param [Hash] options ({})
|
823
855
|
# @option options [String] :delimiter
|
824
856
|
# A delimiter is a character that you specify to group keys. All keys
|
825
857
|
# that contain the same string between the `prefix` and the first
|
826
858
|
# occurrence of the delimiter are grouped under a single result element
|
827
|
-
# in CommonPrefixes
|
828
|
-
# max-keys limitation. These keys are not returned elsewhere in
|
829
|
-
# response.
|
859
|
+
# in `CommonPrefixes`. These groups are counted as one result against
|
860
|
+
# the `max-keys` limitation. These keys are not returned elsewhere in
|
861
|
+
# the response.
|
830
862
|
# @option options [String] :encoding_type
|
831
863
|
# Requests Amazon S3 to encode the object keys in the response and
|
832
|
-
# specifies the encoding method to use. An object key
|
833
|
-
# Unicode character; however, XML 1.0 parser cannot parse some
|
864
|
+
# specifies the encoding method to use. An object key can contain any
|
865
|
+
# Unicode character; however, the XML 1.0 parser cannot parse some
|
834
866
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
835
867
|
# characters that are not supported in XML 1.0, you can add this
|
836
868
|
# parameter to request that Amazon S3 encode the keys in the response.
|
@@ -839,21 +871,36 @@ module Aws::S3
|
|
839
871
|
# @option options [String] :prefix
|
840
872
|
# Use this parameter to select only those keys that begin with the
|
841
873
|
# specified prefix. You can use prefixes to separate a bucket into
|
842
|
-
# different groupings of keys. (You can think of using prefix to make
|
843
|
-
# groups in the same way you'd use a folder in a file system.) You
|
844
|
-
# use prefix with delimiter to roll up numerous objects into a
|
845
|
-
# result under CommonPrefixes
|
874
|
+
# different groupings of keys. (You can think of using `prefix` to make
|
875
|
+
# groups in the same way that you'd use a folder in a file system.) You
|
876
|
+
# can use `prefix` with `delimiter` to roll up numerous objects into a
|
877
|
+
# single result under `CommonPrefixes`.
|
846
878
|
# @option options [String] :version_id_marker
|
847
879
|
# Specifies the object version you want to start listing from.
|
848
880
|
# @option options [String] :expected_bucket_owner
|
849
881
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
850
882
|
# a different account, the request fails with the HTTP status code `403
|
851
883
|
# Forbidden` (access denied).
|
884
|
+
# @option options [String] :request_payer
|
885
|
+
# Confirms that the requester knows that they will be charged for the
|
886
|
+
# request. Bucket owners need not specify this parameter in their
|
887
|
+
# requests. For information about downloading objects from Requester
|
888
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
889
|
+
# in the *Amazon S3 User Guide*.
|
890
|
+
#
|
891
|
+
#
|
892
|
+
#
|
893
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
894
|
+
# @option options [Array<String>] :optional_object_attributes
|
895
|
+
# Specifies the optional fields that you want returned in the response.
|
896
|
+
# Fields that you do not specify are not returned.
|
852
897
|
# @return [ObjectVersion::Collection]
|
853
898
|
def object_versions(options = {})
|
854
899
|
batches = Enumerator.new do |y|
|
855
900
|
options = options.merge(bucket: @name)
|
856
|
-
resp =
|
901
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
902
|
+
@client.list_object_versions(options)
|
903
|
+
end
|
857
904
|
resp.each_page do |page|
|
858
905
|
batch = []
|
859
906
|
page.data.versions_delete_markers.each do |v|
|
@@ -881,18 +928,19 @@ module Aws::S3
|
|
881
928
|
# start_after: "StartAfter",
|
882
929
|
# request_payer: "requester", # accepts requester
|
883
930
|
# expected_bucket_owner: "AccountId",
|
931
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
884
932
|
# })
|
885
933
|
# @param [Hash] options ({})
|
886
934
|
# @option options [String] :delimiter
|
887
|
-
# A delimiter is a character you use to group keys.
|
935
|
+
# A delimiter is a character that you use to group keys.
|
888
936
|
# @option options [String] :encoding_type
|
889
937
|
# Encoding type used by Amazon S3 to encode object keys in the response.
|
890
938
|
# @option options [String] :prefix
|
891
939
|
# Limits the response to keys that begin with the specified prefix.
|
892
940
|
# @option options [Boolean] :fetch_owner
|
893
|
-
# The owner field is not present in
|
894
|
-
# return owner field with each key in the result then set
|
895
|
-
#
|
941
|
+
# The owner field is not present in `ListObjectsV2` by default. If you
|
942
|
+
# want to return the owner field with each key in the result, then set
|
943
|
+
# the `FetchOwner` field to `true`.
|
896
944
|
# @option options [String] :start_after
|
897
945
|
# StartAfter is where you want Amazon S3 to start listing from. Amazon
|
898
946
|
# S3 starts listing after this specified key. StartAfter can be any key
|
@@ -905,11 +953,16 @@ module Aws::S3
|
|
905
953
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
906
954
|
# a different account, the request fails with the HTTP status code `403
|
907
955
|
# Forbidden` (access denied).
|
956
|
+
# @option options [Array<String>] :optional_object_attributes
|
957
|
+
# Specifies the optional fields that you want returned in the response.
|
958
|
+
# Fields that you do not specify are not returned.
|
908
959
|
# @return [ObjectSummary::Collection]
|
909
960
|
def objects(options = {})
|
910
961
|
batches = Enumerator.new do |y|
|
911
962
|
options = options.merge(bucket: @name)
|
912
|
-
resp =
|
963
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
964
|
+
@client.list_objects_v2(options)
|
965
|
+
end
|
913
966
|
resp.each_page do |page|
|
914
967
|
batch = []
|
915
968
|
page.data.contents.each do |c|
|
@@ -60,7 +60,9 @@ module Aws::S3
|
|
60
60
|
#
|
61
61
|
# @return [self]
|
62
62
|
def load
|
63
|
-
resp =
|
63
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
64
|
+
@client.get_bucket_acl(bucket: @bucket_name)
|
65
|
+
end
|
64
66
|
@data = resp.data
|
65
67
|
self
|
66
68
|
end
|
@@ -175,7 +177,9 @@ module Aws::S3
|
|
175
177
|
:retry
|
176
178
|
end
|
177
179
|
end
|
178
|
-
Aws::
|
180
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
181
|
+
Aws::Waiters::Waiter.new(options).wait({})
|
182
|
+
end
|
179
183
|
end
|
180
184
|
|
181
185
|
# @!group Actions
|
@@ -265,7 +269,9 @@ module Aws::S3
|
|
265
269
|
# @return [EmptyStructure]
|
266
270
|
def put(options = {})
|
267
271
|
options = options.merge(bucket: @bucket_name)
|
268
|
-
resp =
|
272
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
273
|
+
@client.put_bucket_acl(options)
|
274
|
+
end
|
269
275
|
resp.data
|
270
276
|
end
|
271
277
|
|
@@ -55,7 +55,9 @@ module Aws::S3
|
|
55
55
|
#
|
56
56
|
# @return [self]
|
57
57
|
def load
|
58
|
-
resp =
|
58
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
59
|
+
@client.get_bucket_cors(bucket: @bucket_name)
|
60
|
+
end
|
59
61
|
@data = resp.data
|
60
62
|
self
|
61
63
|
end
|
@@ -170,7 +172,9 @@ module Aws::S3
|
|
170
172
|
:retry
|
171
173
|
end
|
172
174
|
end
|
173
|
-
Aws::
|
175
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
176
|
+
Aws::Waiters::Waiter.new(options).wait({})
|
177
|
+
end
|
174
178
|
end
|
175
179
|
|
176
180
|
# @!group Actions
|
@@ -188,7 +192,9 @@ module Aws::S3
|
|
188
192
|
# @return [EmptyStructure]
|
189
193
|
def delete(options = {})
|
190
194
|
options = options.merge(bucket: @bucket_name)
|
191
|
-
resp =
|
195
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
196
|
+
@client.delete_bucket_cors(options)
|
197
|
+
end
|
192
198
|
resp.data
|
193
199
|
end
|
194
200
|
|
@@ -254,7 +260,9 @@ module Aws::S3
|
|
254
260
|
# @return [EmptyStructure]
|
255
261
|
def put(options = {})
|
256
262
|
options = options.merge(bucket: @bucket_name)
|
257
|
-
resp =
|
263
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
264
|
+
@client.put_bucket_cors(options)
|
265
|
+
end
|
258
266
|
resp.data
|
259
267
|
end
|
260
268
|
|