aws-sdk-s3 1.123.1 → 1.132.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 +57 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +63 -33
- data/lib/aws-sdk-s3/client.rb +517 -465
- data/lib/aws-sdk-s3/client_api.rb +24 -0
- data/lib/aws-sdk-s3/customizations/errors.rb +1 -1
- data/lib/aws-sdk-s3/customizations/object.rb +20 -0
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +1 -0
- 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 +27 -1
- data/lib/aws-sdk-s3/object.rb +40 -41
- data/lib/aws-sdk-s3/object_multipart_copier.rb +33 -17
- data/lib/aws-sdk-s3/object_summary.rb +49 -36
- data/lib/aws-sdk-s3/object_version.rb +14 -0
- 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 +1 -1
- data/lib/aws-sdk-s3/types.rb +371 -204
- 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: adbed389cd50d435107ac0380117b7e1a316f18dc19cc9a140b223320980fb27
|
4
|
+
data.tar.gz: feea3f5c604991ae327c7e3a7c1811ea0de5ab4474154e3bc69162d8262def72
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3f9adfd588e576e5dd17a9abac897b5d3e113b3fefd03de458fc0c8556c9a43336f84af4a3faf4f8516995cfff58cb9085af209f1f2ef8991204e11f7b7e9164
|
7
|
+
data.tar.gz: 5eb78921bec0f584949cec19adc7d6f38c65daabab5f9ed01c7298d7bfb14501512a1ea99abc6449591867bf548bab50ec0fd3fe54c21dd5ddfddafa370aaae6
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,63 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.132.0 (2023-07-24)
|
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 verifying checksums in FileDownloader.
|
10
|
+
|
11
|
+
1.131.0 (2023-07-20)
|
12
|
+
------------------
|
13
|
+
|
14
|
+
* Feature - Improve performance of S3 clients by simplifying and optimizing endpoint resolution.
|
15
|
+
|
16
|
+
1.130.0 (2023-07-13)
|
17
|
+
------------------
|
18
|
+
|
19
|
+
* Feature - S3 Inventory now supports Object Access Control List and Object Owner as available object metadata fields in inventory reports.
|
20
|
+
|
21
|
+
* Feature - Allow Object multipart copy API to work when requiring a checksum algorithm.
|
22
|
+
* 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`.
|
23
|
+
|
24
|
+
1.129.0 (2023-07-11)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
28
|
+
|
29
|
+
1.128.0 (2023-07-06)
|
30
|
+
------------------
|
31
|
+
|
32
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
33
|
+
|
34
|
+
1.127.0 (2023-06-28)
|
35
|
+
------------------
|
36
|
+
|
37
|
+
* 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.
|
38
|
+
|
39
|
+
* Feature - Select minimum expiration time for presigned urls between the expiration time option and the credential expiration time.
|
40
|
+
|
41
|
+
1.126.0 (2023-06-16)
|
42
|
+
------------------
|
43
|
+
|
44
|
+
* 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.
|
45
|
+
|
46
|
+
1.125.0 (2023-06-15)
|
47
|
+
------------------
|
48
|
+
|
49
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
50
|
+
|
51
|
+
1.124.0 (2023-06-13)
|
52
|
+
------------------
|
53
|
+
|
54
|
+
* Feature - Integrate double encryption feature to SDKs.
|
55
|
+
|
56
|
+
1.123.2 (2023-06-12)
|
57
|
+
------------------
|
58
|
+
|
59
|
+
* Issue - Fix issue when decrypting noncurrent versions of objects when using client side encryption (#2866).
|
60
|
+
|
4
61
|
1.123.1 (2023-06-02)
|
5
62
|
------------------
|
6
63
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.132.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -229,7 +229,7 @@ module Aws::S3
|
|
229
229
|
# bucket.create({
|
230
230
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
231
231
|
# create_bucket_configuration: {
|
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
|
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
|
233
233
|
# },
|
234
234
|
# grant_full_control: "GrantFullControl",
|
235
235
|
# grant_read: "GrantRead",
|
@@ -403,7 +403,7 @@ module Aws::S3
|
|
403
403
|
# metadata: {
|
404
404
|
# "MetadataKey" => "MetadataValue",
|
405
405
|
# },
|
406
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
406
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
407
407
|
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW
|
408
408
|
# website_redirect_location: "WebsiteRedirectLocation",
|
409
409
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
@@ -572,7 +572,7 @@ module Aws::S3
|
|
572
572
|
# A map of metadata to store with the object in S3.
|
573
573
|
# @option options [String] :server_side_encryption
|
574
574
|
# The server-side encryption algorithm used when storing this object in
|
575
|
-
# Amazon S3 (for example, AES256
|
575
|
+
# Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
|
576
576
|
# @option options [String] :storage_class
|
577
577
|
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
578
578
|
# created objects. The STANDARD storage class provides high durability
|
@@ -623,15 +623,15 @@ module Aws::S3
|
|
623
623
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
624
624
|
# ensure that the encryption key was transmitted without error.
|
625
625
|
# @option options [String] :ssekms_key_id
|
626
|
-
# If `x-amz-server-side-encryption` has a valid value of `aws:kms
|
627
|
-
# header specifies the ID of the
|
628
|
-
# Service (
|
629
|
-
#
|
630
|
-
# `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`
|
631
631
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
632
|
-
# Amazon Web Services managed key to protect the data. If the
|
633
|
-
# does not exist in the same account issuing the
|
634
|
-
# 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.
|
635
635
|
# @option options [String] :ssekms_encryption_context
|
636
636
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
637
637
|
# object encryption. The value of this header is a base64-encoded UTF-8
|
@@ -641,9 +641,9 @@ module Aws::S3
|
|
641
641
|
# operations on this object.
|
642
642
|
# @option options [Boolean] :bucket_key_enabled
|
643
643
|
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
644
|
-
# encryption with server-side encryption using
|
645
|
-
# Setting this header to `true` causes Amazon S3
|
646
|
-
# 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.
|
647
647
|
#
|
648
648
|
# Specifying this header with a PUT action doesn’t affect bucket-level
|
649
649
|
# settings for S3 Bucket Key.
|
@@ -740,6 +740,7 @@ module Aws::S3
|
|
740
740
|
# prefix: "Prefix",
|
741
741
|
# upload_id_marker: "UploadIdMarker",
|
742
742
|
# expected_bucket_owner: "AccountId",
|
743
|
+
# request_payer: "requester", # accepts requester
|
743
744
|
# })
|
744
745
|
# @param [Hash] options ({})
|
745
746
|
# @option options [String] :delimiter
|
@@ -753,14 +754,14 @@ module Aws::S3
|
|
753
754
|
# result element are not returned elsewhere in the response.
|
754
755
|
# @option options [String] :encoding_type
|
755
756
|
# Requests Amazon S3 to encode the object keys in the response and
|
756
|
-
# specifies the encoding method to use. An object key
|
757
|
-
# 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
|
758
759
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
759
760
|
# characters that are not supported in XML 1.0, you can add this
|
760
761
|
# parameter to request that Amazon S3 encode the keys in the response.
|
761
762
|
# @option options [String] :key_marker
|
762
|
-
# Together with upload-id-marker
|
763
|
-
# upload after which listing should begin.
|
763
|
+
# Together with `upload-id-marker`, this parameter specifies the
|
764
|
+
# multipart upload after which listing should begin.
|
764
765
|
#
|
765
766
|
# If `upload-id-marker` is not specified, only the keys
|
766
767
|
# lexicographically greater than the specified `key-marker` will be
|
@@ -773,8 +774,8 @@ module Aws::S3
|
|
773
774
|
# @option options [String] :prefix
|
774
775
|
# Lists in-progress uploads only for those keys that begin with the
|
775
776
|
# specified prefix. You can use prefixes to separate a bucket into
|
776
|
-
# different grouping of keys. (You can think of using prefix to make
|
777
|
-
# 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.)
|
778
779
|
# @option options [String] :upload_id_marker
|
779
780
|
# Together with key-marker, specifies the multipart upload after which
|
780
781
|
# listing should begin. If key-marker is not specified, the
|
@@ -786,6 +787,16 @@ module Aws::S3
|
|
786
787
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
787
788
|
# a different account, the request fails with the HTTP status code `403
|
788
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
|
789
800
|
# @return [MultipartUpload::Collection]
|
790
801
|
def multipart_uploads(options = {})
|
791
802
|
batches = Enumerator.new do |y|
|
@@ -837,19 +848,21 @@ module Aws::S3
|
|
837
848
|
# prefix: "Prefix",
|
838
849
|
# version_id_marker: "VersionIdMarker",
|
839
850
|
# expected_bucket_owner: "AccountId",
|
851
|
+
# request_payer: "requester", # accepts requester
|
852
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
840
853
|
# })
|
841
854
|
# @param [Hash] options ({})
|
842
855
|
# @option options [String] :delimiter
|
843
856
|
# A delimiter is a character that you specify to group keys. All keys
|
844
857
|
# that contain the same string between the `prefix` and the first
|
845
858
|
# occurrence of the delimiter are grouped under a single result element
|
846
|
-
# in CommonPrefixes
|
847
|
-
# max-keys limitation. These keys are not returned elsewhere in
|
848
|
-
# 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.
|
849
862
|
# @option options [String] :encoding_type
|
850
863
|
# Requests Amazon S3 to encode the object keys in the response and
|
851
|
-
# specifies the encoding method to use. An object key
|
852
|
-
# 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
|
853
866
|
# characters, such as characters with an ASCII value from 0 to 10. For
|
854
867
|
# characters that are not supported in XML 1.0, you can add this
|
855
868
|
# parameter to request that Amazon S3 encode the keys in the response.
|
@@ -858,16 +871,29 @@ module Aws::S3
|
|
858
871
|
# @option options [String] :prefix
|
859
872
|
# Use this parameter to select only those keys that begin with the
|
860
873
|
# specified prefix. You can use prefixes to separate a bucket into
|
861
|
-
# different groupings of keys. (You can think of using prefix to make
|
862
|
-
# groups in the same way you'd use a folder in a file system.) You
|
863
|
-
# use prefix with delimiter to roll up numerous objects into a
|
864
|
-
# 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`.
|
865
878
|
# @option options [String] :version_id_marker
|
866
879
|
# Specifies the object version you want to start listing from.
|
867
880
|
# @option options [String] :expected_bucket_owner
|
868
881
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
869
882
|
# a different account, the request fails with the HTTP status code `403
|
870
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.
|
871
897
|
# @return [ObjectVersion::Collection]
|
872
898
|
def object_versions(options = {})
|
873
899
|
batches = Enumerator.new do |y|
|
@@ -902,18 +928,19 @@ module Aws::S3
|
|
902
928
|
# start_after: "StartAfter",
|
903
929
|
# request_payer: "requester", # accepts requester
|
904
930
|
# expected_bucket_owner: "AccountId",
|
931
|
+
# optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
|
905
932
|
# })
|
906
933
|
# @param [Hash] options ({})
|
907
934
|
# @option options [String] :delimiter
|
908
|
-
# A delimiter is a character you use to group keys.
|
935
|
+
# A delimiter is a character that you use to group keys.
|
909
936
|
# @option options [String] :encoding_type
|
910
937
|
# Encoding type used by Amazon S3 to encode object keys in the response.
|
911
938
|
# @option options [String] :prefix
|
912
939
|
# Limits the response to keys that begin with the specified prefix.
|
913
940
|
# @option options [Boolean] :fetch_owner
|
914
|
-
# The owner field is not present in
|
915
|
-
# return owner field with each key in the result then set
|
916
|
-
#
|
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`.
|
917
944
|
# @option options [String] :start_after
|
918
945
|
# StartAfter is where you want Amazon S3 to start listing from. Amazon
|
919
946
|
# S3 starts listing after this specified key. StartAfter can be any key
|
@@ -926,6 +953,9 @@ module Aws::S3
|
|
926
953
|
# The account ID of the expected bucket owner. If the bucket is owned by
|
927
954
|
# a different account, the request fails with the HTTP status code `403
|
928
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.
|
929
959
|
# @return [ObjectSummary::Collection]
|
930
960
|
def objects(options = {})
|
931
961
|
batches = Enumerator.new do |y|
|