aws-sdk-s3 1.119.1 → 1.132.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +97 -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 +1740 -1441
- 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 +27 -0
- data/lib/aws-sdk-s3/customizations/object.rb +49 -18
- 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 +4 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +103 -327
- data/lib/aws-sdk-s3/endpoints.rb +1 -0
- data/lib/aws-sdk-s3/file_downloader.rb +61 -25
- 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 +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 +33 -17
- data/lib/aws-sdk-s3/object_summary.rb +103 -64
- data/lib/aws-sdk-s3/object_version.rb +35 -9
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +13 -11
- 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 +711 -405
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +8 -6
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3e9c124873324a9bbaa9f9486830a64940d0b0eef231e64a411ff9b324c740be
|
4
|
+
data.tar.gz: cf26234ca89937e9aa39e44be5ad26b85902ad2eca5f1dbfa9fccf32a93e917e
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 534772057f8571cdb4ce8e6ba47350b672723cc37f654cd5befa1e426c59eb12b7ddb51620ed20dc513c7e4b16dfab54507c261ad8124ca1abe841a1573e1b9f
|
7
|
+
data.tar.gz: ab4ebcde9d217b7e14c7f94696793ece9a2c5c74921e5e087f156585ffd76d9536776054a1a76e9b5965576d41bd9a1d0efc20fddda1aa472272f15d71e48322
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,103 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.132.1 (2023-08-09)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Issue - Add support for disabling checksum validation in `Object#download_file` (#2893).
|
8
|
+
|
9
|
+
1.132.0 (2023-07-24)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
* Feature - Add support for verifying checksums in FileDownloader.
|
15
|
+
|
16
|
+
1.131.0 (2023-07-20)
|
17
|
+
------------------
|
18
|
+
|
19
|
+
* Feature - Improve performance of S3 clients by simplifying and optimizing endpoint resolution.
|
20
|
+
|
21
|
+
1.130.0 (2023-07-13)
|
22
|
+
------------------
|
23
|
+
|
24
|
+
* Feature - S3 Inventory now supports Object Access Control List and Object Owner as available object metadata fields in inventory reports.
|
25
|
+
|
26
|
+
* Feature - Allow Object multipart copy API to work when requiring a checksum algorithm.
|
27
|
+
* 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`.
|
28
|
+
|
29
|
+
1.129.0 (2023-07-11)
|
30
|
+
------------------
|
31
|
+
|
32
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
33
|
+
|
34
|
+
1.128.0 (2023-07-06)
|
35
|
+
------------------
|
36
|
+
|
37
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
38
|
+
|
39
|
+
1.127.0 (2023-06-28)
|
40
|
+
------------------
|
41
|
+
|
42
|
+
* 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.
|
43
|
+
|
44
|
+
* Feature - Select minimum expiration time for presigned urls between the expiration time option and the credential expiration time.
|
45
|
+
|
46
|
+
1.126.0 (2023-06-16)
|
47
|
+
------------------
|
48
|
+
|
49
|
+
* 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.
|
50
|
+
|
51
|
+
1.125.0 (2023-06-15)
|
52
|
+
------------------
|
53
|
+
|
54
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
55
|
+
|
56
|
+
1.124.0 (2023-06-13)
|
57
|
+
------------------
|
58
|
+
|
59
|
+
* Feature - Integrate double encryption feature to SDKs.
|
60
|
+
|
61
|
+
1.123.2 (2023-06-12)
|
62
|
+
------------------
|
63
|
+
|
64
|
+
* Issue - Fix issue when decrypting noncurrent versions of objects when using client side encryption (#2866).
|
65
|
+
|
66
|
+
1.123.1 (2023-06-02)
|
67
|
+
------------------
|
68
|
+
|
69
|
+
* Issue - Fix multipart `download_file` so that it does not download bytes out of range (#2859).
|
70
|
+
|
71
|
+
1.123.0 (2023-05-31)
|
72
|
+
------------------
|
73
|
+
|
74
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
75
|
+
|
76
|
+
1.122.0 (2023-05-04)
|
77
|
+
------------------
|
78
|
+
|
79
|
+
* Feature - Documentation updates for Amazon S3
|
80
|
+
|
81
|
+
1.121.0 (2023-04-19)
|
82
|
+
------------------
|
83
|
+
|
84
|
+
* Feature - Provides support for "Snow" Storage class.
|
85
|
+
|
86
|
+
1.120.1 (2023-04-05)
|
87
|
+
------------------
|
88
|
+
|
89
|
+
* Issue - Skip `#check_for_cached_region` if custom endpoint provided
|
90
|
+
|
91
|
+
1.120.0 (2023-03-31)
|
92
|
+
------------------
|
93
|
+
|
94
|
+
* Feature - Documentation updates for Amazon S3
|
95
|
+
|
96
|
+
1.119.2 (2023-03-22)
|
97
|
+
------------------
|
98
|
+
|
99
|
+
* Issue - Provide `endpoint` and `bucket` attributes on `Aws::S3::Errors::PermanentRedirect` error objects.
|
100
|
+
|
4
101
|
1.119.1 (2023-02-13)
|
5
102
|
------------------
|
6
103
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.132.1
|
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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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_configuration(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
|
|
@@ -277,7 +283,9 @@ module Aws::S3
|
|
277
283
|
# @return [EmptyStructure]
|
278
284
|
def put(options = {})
|
279
285
|
options = options.merge(bucket: @bucket_name)
|
280
|
-
resp =
|
286
|
+
resp = Aws::Plugins::UserAgent.feature('resource') do
|
287
|
+
@client.put_bucket_lifecycle_configuration(options)
|
288
|
+
end
|
281
289
|
resp.data
|
282
290
|
end
|
283
291
|
|