aws-sdk-s3 1.121.0 → 1.136.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 +99 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +122 -60
- 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 +2017 -1674
- data/lib/aws-sdk-s3/client_api.rb +24 -0
- data/lib/aws-sdk-s3/customizations/bucket.rb +3 -1
- data/lib/aws-sdk-s3/customizations/errors.rb +1 -1
- data/lib/aws-sdk-s3/customizations/object.rb +91 -18
- 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 +4 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +22 -246
- data/lib/aws-sdk-s3/endpoints.rb +1 -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 +5 -3
- data/lib/aws-sdk-s3/multipart_upload.rb +27 -13
- data/lib/aws-sdk-s3/multipart_upload_part.rb +19 -9
- data/lib/aws-sdk-s3/object.rb +151 -105
- data/lib/aws-sdk-s3/object_acl.rb +14 -6
- data/lib/aws-sdk-s3/object_copier.rb +7 -5
- data/lib/aws-sdk-s3/object_multipart_copier.rb +33 -17
- data/lib/aws-sdk-s3/object_summary.rb +144 -89
- data/lib/aws-sdk-s3/object_version.rb +55 -21
- data/lib/aws-sdk-s3/presigned_post.rb +52 -43
- data/lib/aws-sdk-s3/presigner.rb +4 -2
- data/lib/aws-sdk-s3/resource.rb +7 -3
- data/lib/aws-sdk-s3/types.rb +854 -484
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +6 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3a563e0602ed3c1393406bb2158324b9571f7c579924f3f349fe237333d218d1
|
4
|
+
data.tar.gz: 4559f4a20a3abd9dcddde15fd814012e3874813d2e5cc15cd0066125aea8348f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 03eda70ab440bdf32208be9a6f8bbe5435d77090ef6198129b9cb06b91d2aba9fb5bb3820d53380af6863f4538344d6833d507d5c46b3609d648f2c52a26561c
|
7
|
+
data.tar.gz: 43cd7b5022e8602f9590463478de5adf88de7cc31d1d13179551b9434a21fd6150c61009b98796eddc91a772c70e47698e58720f79733ad03ea638c27e052653
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,105 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.136.0 (2023-09-26)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - This release adds a new field COMPLETED to the ReplicationStatus Enum. You can now use this field to validate the replication status of S3 objects using the AWS SDK.
|
8
|
+
|
9
|
+
1.135.0 (2023-09-20)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Fix an issue where the SDK can fail to unmarshall response due to NumberFormatException
|
13
|
+
|
14
|
+
1.134.0 (2023-08-24)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Updates to endpoint ruleset tests to address Smithy validation issues.
|
18
|
+
|
19
|
+
1.133.0 (2023-08-22)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
23
|
+
|
24
|
+
* Feature - Add support for `progress_callback` in `Object#download_file` and improve multi-threaded performance #(2901).
|
25
|
+
|
26
|
+
1.132.1 (2023-08-09)
|
27
|
+
------------------
|
28
|
+
|
29
|
+
* Issue - Add support for disabling checksum validation in `Object#download_file` (#2893).
|
30
|
+
|
31
|
+
1.132.0 (2023-07-24)
|
32
|
+
------------------
|
33
|
+
|
34
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
35
|
+
|
36
|
+
* Feature - Add support for verifying checksums in FileDownloader.
|
37
|
+
|
38
|
+
1.131.0 (2023-07-20)
|
39
|
+
------------------
|
40
|
+
|
41
|
+
* Feature - Improve performance of S3 clients by simplifying and optimizing endpoint resolution.
|
42
|
+
|
43
|
+
1.130.0 (2023-07-13)
|
44
|
+
------------------
|
45
|
+
|
46
|
+
* Feature - S3 Inventory now supports Object Access Control List and Object Owner as available object metadata fields in inventory reports.
|
47
|
+
|
48
|
+
* Feature - Allow Object multipart copy API to work when requiring a checksum algorithm.
|
49
|
+
* 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`.
|
50
|
+
|
51
|
+
1.129.0 (2023-07-11)
|
52
|
+
------------------
|
53
|
+
|
54
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
55
|
+
|
56
|
+
1.128.0 (2023-07-06)
|
57
|
+
------------------
|
58
|
+
|
59
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
60
|
+
|
61
|
+
1.127.0 (2023-06-28)
|
62
|
+
------------------
|
63
|
+
|
64
|
+
* 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.
|
65
|
+
|
66
|
+
* Feature - Select minimum expiration time for presigned urls between the expiration time option and the credential expiration time.
|
67
|
+
|
68
|
+
1.126.0 (2023-06-16)
|
69
|
+
------------------
|
70
|
+
|
71
|
+
* 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.
|
72
|
+
|
73
|
+
1.125.0 (2023-06-15)
|
74
|
+
------------------
|
75
|
+
|
76
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
77
|
+
|
78
|
+
1.124.0 (2023-06-13)
|
79
|
+
------------------
|
80
|
+
|
81
|
+
* Feature - Integrate double encryption feature to SDKs.
|
82
|
+
|
83
|
+
1.123.2 (2023-06-12)
|
84
|
+
------------------
|
85
|
+
|
86
|
+
* Issue - Fix issue when decrypting noncurrent versions of objects when using client side encryption (#2866).
|
87
|
+
|
88
|
+
1.123.1 (2023-06-02)
|
89
|
+
------------------
|
90
|
+
|
91
|
+
* Issue - Fix multipart `download_file` so that it does not download bytes out of range (#2859).
|
92
|
+
|
93
|
+
1.123.0 (2023-05-31)
|
94
|
+
------------------
|
95
|
+
|
96
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
97
|
+
|
98
|
+
1.122.0 (2023-05-04)
|
99
|
+
------------------
|
100
|
+
|
101
|
+
* Feature - Documentation updates for Amazon S3
|
102
|
+
|
4
103
|
1.121.0 (2023-04-19)
|
5
104
|
------------------
|
6
105
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.136.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, 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
|
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
|
|
@@ -325,9 +335,11 @@ module Aws::S3
|
|
325
335
|
# @option options [String] :request_payer
|
326
336
|
# Confirms that the requester knows that they will be charged for the
|
327
337
|
# request. Bucket owners need not specify this parameter in their
|
328
|
-
# requests.
|
329
|
-
# Pays
|
330
|
-
#
|
338
|
+
# requests. If either the source or destination Amazon S3 bucket has
|
339
|
+
# Requester Pays enabled, the requester will pay for corresponding
|
340
|
+
# charges to copy the object. For information about downloading objects
|
341
|
+
# from Requester Pays buckets, see [Downloading Objects in Requester
|
342
|
+
# Pays Buckets][1] in the *Amazon S3 User Guide*.
|
331
343
|
#
|
332
344
|
#
|
333
345
|
#
|
@@ -361,7 +373,9 @@ module Aws::S3
|
|
361
373
|
# @return [Types::DeleteObjectsOutput]
|
362
374
|
def delete_objects(options = {})
|
363
375
|
options = options.merge(bucket: @name)
|
364
|
-
resp =
|
376
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
377
|
+
@client.delete_objects(options)
|
378
|
+
end
|
365
379
|
resp.data
|
366
380
|
end
|
367
381
|
|
@@ -391,7 +405,7 @@ module Aws::S3
|
|
391
405
|
# metadata: {
|
392
406
|
# "MetadataKey" => "MetadataValue",
|
393
407
|
# },
|
394
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
408
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
395
409
|
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW
|
396
410
|
# website_redirect_location: "WebsiteRedirectLocation",
|
397
411
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
@@ -430,30 +444,30 @@ module Aws::S3
|
|
430
444
|
# @option options [String] :content_disposition
|
431
445
|
# Specifies presentational information for the object. For more
|
432
446
|
# information, see
|
433
|
-
# [
|
447
|
+
# [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
|
434
448
|
#
|
435
449
|
#
|
436
450
|
#
|
437
|
-
# [1]:
|
451
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
|
438
452
|
# @option options [String] :content_encoding
|
439
453
|
# Specifies what content encodings have been applied to the object and
|
440
454
|
# thus what decoding mechanisms must be applied to obtain the media-type
|
441
455
|
# referenced by the Content-Type header field. For more information, see
|
442
|
-
# [
|
456
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
|
443
457
|
#
|
444
458
|
#
|
445
459
|
#
|
446
|
-
# [1]:
|
460
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
|
447
461
|
# @option options [String] :content_language
|
448
462
|
# The language the content is in.
|
449
463
|
# @option options [Integer] :content_length
|
450
464
|
# Size of the body in bytes. This parameter is useful when the size of
|
451
465
|
# the body cannot be determined automatically. For more information, see
|
452
|
-
# [
|
466
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
|
453
467
|
#
|
454
468
|
#
|
455
469
|
#
|
456
|
-
# [1]:
|
470
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
|
457
471
|
# @option options [String] :content_md5
|
458
472
|
# The base64-encoded 128-bit MD5 digest of the message (without the
|
459
473
|
# headers) according to RFC 1864. This header can be used as a message
|
@@ -469,11 +483,11 @@ module Aws::S3
|
|
469
483
|
# @option options [String] :content_type
|
470
484
|
# A standard MIME type describing the format of the contents. For more
|
471
485
|
# information, see
|
472
|
-
# [
|
486
|
+
# [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
|
473
487
|
#
|
474
488
|
#
|
475
489
|
#
|
476
|
-
# [1]:
|
490
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
|
477
491
|
# @option options [String] :checksum_algorithm
|
478
492
|
# Indicates the algorithm used to create the checksum for the object
|
479
493
|
# when using the SDK. This header will not provide any additional
|
@@ -532,11 +546,11 @@ module Aws::S3
|
|
532
546
|
# @option options [Time,DateTime,Date,Integer,String] :expires
|
533
547
|
# The date and time at which the object is no longer cacheable. For more
|
534
548
|
# information, see
|
535
|
-
# [
|
549
|
+
# [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
|
536
550
|
#
|
537
551
|
#
|
538
552
|
#
|
539
|
-
# [1]:
|
553
|
+
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
540
554
|
# @option options [String] :grant_full_control
|
541
555
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
542
556
|
# object.
|
@@ -560,7 +574,7 @@ module Aws::S3
|
|
560
574
|
# A map of metadata to store with the object in S3.
|
561
575
|
# @option options [String] :server_side_encryption
|
562
576
|
# The server-side encryption algorithm used when storing this object in
|
563
|
-
# Amazon S3 (for example, AES256
|
577
|
+
# Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
|
564
578
|
# @option options [String] :storage_class
|
565
579
|
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
566
580
|
# created objects. The STANDARD storage class provides high durability
|
@@ -611,33 +625,39 @@ module Aws::S3
|
|
611
625
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
612
626
|
# ensure that the encryption key was transmitted without error.
|
613
627
|
# @option options [String] :ssekms_key_id
|
614
|
-
# If `x-amz-server-side-encryption`
|
615
|
-
# `aws:kms`, this header specifies the ID
|
616
|
-
# Management Service (
|
617
|
-
# managed key that was used for the object. If you specify
|
618
|
-
# `x-amz-server-side-encryption:aws:kms
|
628
|
+
# If `x-amz-server-side-encryption` has a valid value of `aws:kms` or
|
629
|
+
# `aws:kms:dsse`, this header specifies the ID (Key ID, Key ARN, or Key
|
630
|
+
# Alias) of the Key Management Service (KMS) symmetric encryption
|
631
|
+
# customer managed key that was used for the object. If you specify
|
632
|
+
# `x-amz-server-side-encryption:aws:kms` or
|
633
|
+
# `x-amz-server-side-encryption:aws:kms:dsse`, but do not provide`
|
619
634
|
# 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.
|
635
|
+
# Amazon Web Services managed key (`aws/s3`) to protect the data. If the
|
636
|
+
# KMS key does not exist in the same account that's issuing the
|
637
|
+
# command, you must use the full ARN and not just the ID.
|
623
638
|
# @option options [String] :ssekms_encryption_context
|
624
639
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
625
640
|
# object encryption. The value of this header is a base64-encoded UTF-8
|
626
|
-
# string holding JSON with the encryption context key-value pairs.
|
641
|
+
# string holding JSON with the encryption context key-value pairs. This
|
642
|
+
# value is stored as object metadata and automatically gets passed on to
|
643
|
+
# Amazon Web Services KMS for future `GetObject` or `CopyObject`
|
644
|
+
# operations on this object.
|
627
645
|
# @option options [Boolean] :bucket_key_enabled
|
628
646
|
# 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.
|
647
|
+
# encryption with server-side encryption using Key Management Service
|
648
|
+
# (KMS) keys (SSE-KMS). Setting this header to `true` causes Amazon S3
|
649
|
+
# to use an S3 Bucket Key for object encryption with SSE-KMS.
|
632
650
|
#
|
633
651
|
# Specifying this header with a PUT action doesn’t affect bucket-level
|
634
652
|
# settings for S3 Bucket Key.
|
635
653
|
# @option options [String] :request_payer
|
636
654
|
# Confirms that the requester knows that they will be charged for the
|
637
655
|
# request. Bucket owners need not specify this parameter in their
|
638
|
-
# requests.
|
639
|
-
# Pays
|
640
|
-
#
|
656
|
+
# requests. If either the source or destination Amazon S3 bucket has
|
657
|
+
# Requester Pays enabled, the requester will pay for corresponding
|
658
|
+
# charges to copy the object. For information about downloading objects
|
659
|
+
# from Requester Pays buckets, see [Downloading Objects in Requester
|
660
|
+
# Pays Buckets][1] in the *Amazon S3 User Guide*.
|
641
661
|
#
|
642
662
|
#
|
643
663
|
#
|
@@ -664,7 +684,9 @@ module Aws::S3
|
|
664
684
|
# @return [Object]
|
665
685
|
def put_object(options = {})
|
666
686
|
options = options.merge(bucket: @name)
|
667
|
-
|
687
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
688
|
+
@client.put_object(options)
|
689
|
+
end
|
668
690
|
Object.new(
|
669
691
|
bucket_name: @name,
|
670
692
|
key: options[:key],
|
@@ -723,6 +745,7 @@ module Aws::S3
|
|
723
745
|
# prefix: "Prefix",
|
724
746
|
# upload_id_marker: "UploadIdMarker",
|
725
747
|
# expected_bucket_owner: "AccountId",
|
748
|
+
# request_payer: "requester", # accepts requester
|
726
749
|
# })
|
727
750
|
# @param [Hash] options ({})
|
728
751
|
# @option options [String] :delimiter
|
@@ -736,14 +759,14 @@ module Aws::S3
|
|
736
759
|
# result element are not returned elsewhere in the response.
|
737
760
|
# @option options [String] :encoding_type
|
738
761
|
# 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
|
762
|
+
# specifies the encoding method to use. An object key can contain any
|
763
|
+
# Unicode character; however, the XML 1.0 parser cannot parse some
|
741
764
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
742
765
|
# characters that are not supported in XML 1.0, you can add this
|
743
766
|
# parameter to request that Amazon S3 encode the keys in the response.
|
744
767
|
# @option options [String] :key_marker
|
745
|
-
# Together with upload-id-marker
|
746
|
-
# upload after which listing should begin.
|
768
|
+
# Together with `upload-id-marker`, this parameter specifies the
|
769
|
+
# multipart upload after which listing should begin.
|
747
770
|
#
|
748
771
|
# If `upload-id-marker` is not specified, only the keys
|
749
772
|
# lexicographically greater than the specified `key-marker` will be
|
@@ -756,8 +779,8 @@ module Aws::S3
|
|
756
779
|
# @option options [String] :prefix
|
757
780
|
# Lists in-progress uploads only for those keys that begin with the
|
758
781
|
# 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.)
|
782
|
+
# different grouping of keys. (You can think of using `prefix` to make
|
783
|
+
# groups in the same way that you'd use a folder in a file system.)
|
761
784
|
# @option options [String] :upload_id_marker
|
762
785
|
# Together with key-marker, specifies the multipart upload after which
|
763
786
|
# listing should begin. If key-marker is not specified, the
|
@@ -769,11 +792,25 @@ module Aws::S3
|
|
769
792
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
770
793
|
# a different account, the request fails with the HTTP status code `403
|
771
794
|
# Forbidden` (access denied).
|
795
|
+
# @option options [String] :request_payer
|
796
|
+
# Confirms that the requester knows that they will be charged for the
|
797
|
+
# request. Bucket owners need not specify this parameter in their
|
798
|
+
# requests. If either the source or destination Amazon S3 bucket has
|
799
|
+
# Requester Pays enabled, the requester will pay for corresponding
|
800
|
+
# charges to copy the object. For information about downloading objects
|
801
|
+
# from Requester Pays buckets, see [Downloading Objects in Requester
|
802
|
+
# Pays Buckets][1] in the *Amazon S3 User Guide*.
|
803
|
+
#
|
804
|
+
#
|
805
|
+
#
|
806
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
772
807
|
# @return [MultipartUpload::Collection]
|
773
808
|
def multipart_uploads(options = {})
|
774
809
|
batches = Enumerator.new do |y|
|
775
810
|
options = options.merge(bucket: @name)
|
776
|
-
resp =
|
811
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
812
|
+
@client.list_multipart_uploads(options)
|
813
|
+
end
|
777
814
|
resp.each_page do |page|
|
778
815
|
batch = []
|
779
816
|
page.data.uploads.each do |u|
|
@@ -818,19 +855,21 @@ module Aws::S3
|
|
818
855
|
# prefix: "Prefix",
|
819
856
|
# version_id_marker: "VersionIdMarker",
|
820
857
|
# expected_bucket_owner: "AccountId",
|
858
|
+
# request_payer: "requester", # accepts requester
|
859
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
821
860
|
# })
|
822
861
|
# @param [Hash] options ({})
|
823
862
|
# @option options [String] :delimiter
|
824
863
|
# A delimiter is a character that you specify to group keys. All keys
|
825
864
|
# that contain the same string between the `prefix` and the first
|
826
865
|
# 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.
|
866
|
+
# in `CommonPrefixes`. These groups are counted as one result against
|
867
|
+
# the `max-keys` limitation. These keys are not returned elsewhere in
|
868
|
+
# the response.
|
830
869
|
# @option options [String] :encoding_type
|
831
870
|
# 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
|
871
|
+
# specifies the encoding method to use. An object key can contain any
|
872
|
+
# Unicode character; however, the XML 1.0 parser cannot parse some
|
834
873
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
835
874
|
# characters that are not supported in XML 1.0, you can add this
|
836
875
|
# parameter to request that Amazon S3 encode the keys in the response.
|
@@ -839,21 +878,38 @@ module Aws::S3
|
|
839
878
|
# @option options [String] :prefix
|
840
879
|
# Use this parameter to select only those keys that begin with the
|
841
880
|
# 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
|
881
|
+
# different groupings of keys. (You can think of using `prefix` to make
|
882
|
+
# groups in the same way that you'd use a folder in a file system.) You
|
883
|
+
# can use `prefix` with `delimiter` to roll up numerous objects into a
|
884
|
+
# single result under `CommonPrefixes`.
|
846
885
|
# @option options [String] :version_id_marker
|
847
886
|
# Specifies the object version you want to start listing from.
|
848
887
|
# @option options [String] :expected_bucket_owner
|
849
888
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
850
889
|
# a different account, the request fails with the HTTP status code `403
|
851
890
|
# Forbidden` (access denied).
|
891
|
+
# @option options [String] :request_payer
|
892
|
+
# Confirms that the requester knows that they will be charged for the
|
893
|
+
# request. Bucket owners need not specify this parameter in their
|
894
|
+
# requests. If either the source or destination Amazon S3 bucket has
|
895
|
+
# Requester Pays enabled, the requester will pay for corresponding
|
896
|
+
# charges to copy the object. For information about downloading objects
|
897
|
+
# from Requester Pays buckets, see [Downloading Objects in Requester
|
898
|
+
# Pays Buckets][1] in the *Amazon S3 User Guide*.
|
899
|
+
#
|
900
|
+
#
|
901
|
+
#
|
902
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
903
|
+
# @option options [Array<String>] :optional_object_attributes
|
904
|
+
# Specifies the optional fields that you want returned in the response.
|
905
|
+
# Fields that you do not specify are not returned.
|
852
906
|
# @return [ObjectVersion::Collection]
|
853
907
|
def object_versions(options = {})
|
854
908
|
batches = Enumerator.new do |y|
|
855
909
|
options = options.merge(bucket: @name)
|
856
|
-
resp =
|
910
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
911
|
+
@client.list_object_versions(options)
|
912
|
+
end
|
857
913
|
resp.each_page do |page|
|
858
914
|
batch = []
|
859
915
|
page.data.versions_delete_markers.each do |v|
|
@@ -881,18 +937,19 @@ module Aws::S3
|
|
881
937
|
# start_after: "StartAfter",
|
882
938
|
# request_payer: "requester", # accepts requester
|
883
939
|
# expected_bucket_owner: "AccountId",
|
940
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
884
941
|
# })
|
885
942
|
# @param [Hash] options ({})
|
886
943
|
# @option options [String] :delimiter
|
887
|
-
# A delimiter is a character you use to group keys.
|
944
|
+
# A delimiter is a character that you use to group keys.
|
888
945
|
# @option options [String] :encoding_type
|
889
946
|
# Encoding type used by Amazon S3 to encode object keys in the response.
|
890
947
|
# @option options [String] :prefix
|
891
948
|
# Limits the response to keys that begin with the specified prefix.
|
892
949
|
# @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
|
-
#
|
950
|
+
# The owner field is not present in `ListObjectsV2` by default. If you
|
951
|
+
# want to return the owner field with each key in the result, then set
|
952
|
+
# the `FetchOwner` field to `true`.
|
896
953
|
# @option options [String] :start_after
|
897
954
|
# StartAfter is where you want Amazon S3 to start listing from. Amazon
|
898
955
|
# S3 starts listing after this specified key. StartAfter can be any key
|
@@ -905,11 +962,16 @@ module Aws::S3
|
|
905
962
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
906
963
|
# a different account, the request fails with the HTTP status code `403
|
907
964
|
# Forbidden` (access denied).
|
965
|
+
# @option options [Array<String>] :optional_object_attributes
|
966
|
+
# Specifies the optional fields that you want returned in the response.
|
967
|
+
# Fields that you do not specify are not returned.
|
908
968
|
# @return [ObjectSummary::Collection]
|
909
969
|
def objects(options = {})
|
910
970
|
batches = Enumerator.new do |y|
|
911
971
|
options = options.merge(bucket: @name)
|
912
|
-
resp =
|
972
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
973
|
+
@client.list_objects_v2(options)
|
974
|
+
end
|
913
975
|
resp.each_page do |page|
|
914
976
|
batch = []
|
915
977
|
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
|
|
@@ -54,7 +54,9 @@ module Aws::S3
|
|
54
54
|
#
|
55
55
|
# @return [self]
|
56
56
|
def load
|
57
|
-
resp =
|
57
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
58
|
+
@client.get_bucket_lifecycle(bucket: @bucket_name)
|
59
|
+
end
|
58
60
|
@data = resp.data
|
59
61
|
self
|
60
62
|
end
|
@@ -169,7 +171,9 @@ module Aws::S3
|
|
169
171
|
:retry
|
170
172
|
end
|
171
173
|
end
|
172
|
-
Aws::
|
174
|
+
Aws::Plugins::UserAgent.feature('resource') do
|
175
|
+
Aws::Waiters::Waiter.new(options).wait({})
|
176
|
+
end
|
173
177
|
end
|
174
178
|
|
175
179
|
# @!group Actions
|
@@ -187,7 +191,9 @@ module Aws::S3
|
|
187
191
|
# @return [EmptyStructure]
|
188
192
|
def delete(options = {})
|
189
193
|
options = options.merge(bucket: @bucket_name)
|
190
|
-
resp =
|
194
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
195
|
+
@client.delete_bucket_lifecycle(options)
|
196
|
+
end
|
191
197
|
resp.data
|
192
198
|
end
|
193
199
|
|
@@ -257,7 +263,9 @@ module Aws::S3
|
|
257
263
|
# @return [EmptyStructure]
|
258
264
|
def put(options = {})
|
259
265
|
options = options.merge(bucket: @bucket_name)
|
260
|
-
resp =
|
266
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
267
|
+
@client.put_bucket_lifecycle(options)
|
268
|
+
end
|
261
269
|
resp.data
|
262
270
|
end
|
263
271
|
|