aws-sdk-s3 1.188.0 → 1.205.0

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.
Files changed (40) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +119 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +43 -4
  5. data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
  6. data/lib/aws-sdk-s3/client.rb +1943 -252
  7. data/lib/aws-sdk-s3/client_api.rb +289 -0
  8. data/lib/aws-sdk-s3/customizations/object.rb +76 -86
  9. data/lib/aws-sdk-s3/customizations.rb +3 -1
  10. data/lib/aws-sdk-s3/default_executor.rb +103 -0
  11. data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
  12. data/lib/aws-sdk-s3/endpoint_provider.rb +220 -50
  13. data/lib/aws-sdk-s3/endpoints.rb +110 -0
  14. data/lib/aws-sdk-s3/errors.rb +11 -0
  15. data/lib/aws-sdk-s3/file_downloader.rb +197 -134
  16. data/lib/aws-sdk-s3/file_uploader.rb +9 -13
  17. data/lib/aws-sdk-s3/legacy_signer.rb +2 -1
  18. data/lib/aws-sdk-s3/multipart_download_error.rb +8 -0
  19. data/lib/aws-sdk-s3/multipart_file_uploader.rb +92 -107
  20. data/lib/aws-sdk-s3/multipart_stream_uploader.rb +96 -107
  21. data/lib/aws-sdk-s3/multipart_upload_error.rb +3 -4
  22. data/lib/aws-sdk-s3/object.rb +110 -35
  23. data/lib/aws-sdk-s3/object_multipart_copier.rb +2 -1
  24. data/lib/aws-sdk-s3/object_summary.rb +72 -20
  25. data/lib/aws-sdk-s3/object_version.rb +7 -9
  26. data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
  27. data/lib/aws-sdk-s3/plugins/url_encoded_keys.rb +2 -1
  28. data/lib/aws-sdk-s3/resource.rb +6 -0
  29. data/lib/aws-sdk-s3/transfer_manager.rb +303 -0
  30. data/lib/aws-sdk-s3/types.rb +1490 -189
  31. data/lib/aws-sdk-s3.rb +1 -1
  32. data/sig/bucket.rbs +12 -3
  33. data/sig/client.rbs +170 -31
  34. data/sig/errors.rbs +2 -0
  35. data/sig/multipart_upload.rbs +1 -1
  36. data/sig/object.rbs +15 -10
  37. data/sig/object_summary.rbs +11 -9
  38. data/sig/resource.rbs +8 -1
  39. data/sig/types.rbs +215 -29
  40. metadata +7 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 310470bdb24160f824d153efac697cd69471c516d2714a2b4129160fff6bf74e
4
- data.tar.gz: 1d8aa63b1f3b817352dbb57e66da5e41b27ba6948cbe2cc53ee6ba4866861d98
3
+ metadata.gz: 4317d141110c16240cfc5412df21c614152e959a9943dfc4525550646f02a0dc
4
+ data.tar.gz: 060fd3c2735d93bb4376f7519f84e07c984f4052a9fd0f6c6456402494810bd6
5
5
  SHA512:
6
- metadata.gz: 9896f94797c2d66c75c3e874db351bd6e48293724e792f60a070a42594849de4b302db4b97c04dd0165986dfec2a808063bdd8d63499ea2f8a84b42ea0f8ef03
7
- data.tar.gz: c82ec444b9a7a940cb433908bdab83c05597d1b83899ba93d2c6341366ec8596df39e10dd982674fdc08fa4857aca3d9066781356df1b7b480af2868087b8a9c
6
+ metadata.gz: 5e86d07d938a24f86c26dfa0b189c38e2ecc5c20a4ab884848f680474b784bf09acc9d52310c57b7b0d176c61b284fa5387bc762d7532f0bba0ca9183ed37e93
7
+ data.tar.gz: 18d6252cfe3a9d7284789a4703db29490b2c84d62d00d8abc1c4643ef0351082e6686aa84670690ffb3b253cf43c798a367af9689858eccca7db349719cab0e7
data/CHANGELOG.md CHANGED
@@ -1,6 +1,125 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.205.0 (2025-11-20)
5
+ ------------------
6
+
7
+ * Feature - Enable / Disable ABAC on a general purpose bucket.
8
+
9
+ 1.204.0 (2025-11-19)
10
+ ------------------
11
+
12
+ * Feature - Adds support for blocking SSE-C writes to general purpose buckets.
13
+
14
+ 1.203.1 (2025-11-10)
15
+ ------------------
16
+
17
+ * Issue - Deprecated `:checksum_mode` parameter in `FileDownloader#download`. When set to "DISABLED", a deprecation warning is issued and the parameter is ignored. Use `:response_checksum_validation` on the S3 client instead to control checksum validation behavior.
18
+
19
+ 1.203.0 (2025-11-05)
20
+ ------------------
21
+
22
+ * Feature - Launch IPv6 dual-stack support for S3 Express
23
+
24
+ 1.202.0 (2025-10-28)
25
+ ------------------
26
+
27
+ * Feature - Amazon Simple Storage Service / Features: Add conditional writes in CopyObject on destination key to prevent unintended object modifications.
28
+
29
+ 1.201.0 (2025-10-21)
30
+ ------------------
31
+
32
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
33
+
34
+ * Issue - Fix multipart upload to respect `request_checksum_calculation` `when_required` mode.
35
+
36
+ 1.200.0 (2025-10-15)
37
+ ------------------
38
+
39
+ * Feature - Add lightweight thread pool executor for multipart `download_file`, `upload_file` and `upload_stream`.
40
+
41
+ * Feature - Add custom executor support for `Aws::S3::TransferManager`.
42
+
43
+ 1.199.1 (2025-09-25)
44
+ ------------------
45
+
46
+ * Issue - Update `TransferManager#download_file` and `Object#download_file` documentation regarding temporary file usage and failure handling for different destination types.
47
+
48
+ 1.199.0 (2025-09-08)
49
+ ------------------
50
+
51
+ * Feature - This release includes backward compatibility work on the "Expires" parameter.
52
+
53
+ 1.198.0 (2025-08-26)
54
+ ------------------
55
+
56
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
57
+
58
+ * Issue - Fix multipart `download_file` to support `Pathname`, `File` and `Tempfile` objects as download destinations.
59
+
60
+ 1.197.0 (2025-08-19)
61
+ ------------------
62
+
63
+ * Issue - When multipart stream uploader fails to complete multipart upload, it calls abort multipart upload.
64
+
65
+ * Issue - For `Aws::S3::Object` class, the following methods have been deprecated: `download_file`, `upload_file` and `upload_stream`. Use `Aws::S3::TransferManager` instead.
66
+
67
+ * Feature - Add `Aws::S3::TransferManager`, a S3 transfer utility that provides upload/download capabilities with automatic multipart handling, progress tracking, and handling of large files.
68
+
69
+ 1.196.1 (2025-08-05)
70
+ ------------------
71
+
72
+ * Issue - Add range validation to multipart download to ensure all parts are successfully processed.
73
+
74
+ * Issue - When multipart uploader fails to complete multipart upload, it calls abort multipart upload.
75
+
76
+ * Issue - Clean up partially downloaded file on multipart `download_file` failure while preserving existing file.
77
+
78
+ 1.196.0 (2025-08-04)
79
+ ------------------
80
+
81
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
82
+
83
+ 1.195.0 (2025-07-31)
84
+ ------------------
85
+
86
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
87
+
88
+ 1.194.0 (2025-07-21)
89
+ ------------------
90
+
91
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
92
+
93
+ 1.193.0 (2025-07-15)
94
+ ------------------
95
+
96
+ * Feature - Amazon S3 Metadata live inventory tables provide a queryable inventory of all the objects in your general purpose bucket so that you can determine the latest state of your data. To help minimize your storage costs, use journal table record expiration to set a retention period for your records.
97
+
98
+ 1.192.0 (2025-07-02)
99
+ ------------------
100
+
101
+ * Feature - Added support for directory bucket creation with tags and bucket ARN retrieval in CreateBucket, ListDirectoryBuckets, and HeadBucket operations
102
+
103
+ 1.191.0 (2025-06-25)
104
+ ------------------
105
+
106
+ * Feature - Adds support for additional server-side encryption mode and storage class values for accessing Amazon FSx data from Amazon S3 using S3 Access Points
107
+
108
+ 1.190.0 (2025-06-18)
109
+ ------------------
110
+
111
+ * Feature - Added support for renaming objects within the same bucket using the new RenameObject API.
112
+
113
+ 1.189.1 (2025-06-10)
114
+ ------------------
115
+
116
+ * Issue - Only load required `cgi` modules for Ruby 3.5.
117
+
118
+ 1.189.0 (2025-06-02)
119
+ ------------------
120
+
121
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
122
+
4
123
  1.188.0 (2025-05-29)
5
124
  ------------------
6
125
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.188.0
1
+ 1.205.0
@@ -49,6 +49,23 @@ module Aws::S3
49
49
  data[:bucket_region]
50
50
  end
51
51
 
52
+ # The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
53
+ # identify Amazon Web Services resources across all of Amazon Web
54
+ # Services.
55
+ #
56
+ # <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
57
+ # information, see [Using tags with directory buckets][1].
58
+ #
59
+ # </note>
60
+ #
61
+ #
62
+ #
63
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
64
+ # @return [String]
65
+ def bucket_arn
66
+ data[:bucket_arn]
67
+ end
68
+
52
69
  # @!endgroup
53
70
 
54
71
  # @return [Client]
@@ -246,6 +263,12 @@ module Aws::S3
246
263
  # data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
247
264
  # type: "Directory", # accepts Directory
248
265
  # },
266
+ # tags: [
267
+ # {
268
+ # key: "ObjectKey", # required
269
+ # value: "Value", # required
270
+ # },
271
+ # ],
249
272
  # },
250
273
  # grant_full_control: "GrantFullControl",
251
274
  # grant_read: "GrantRead",
@@ -521,8 +544,8 @@ module Aws::S3
521
544
  # metadata: {
522
545
  # "MetadataKey" => "MetadataValue",
523
546
  # },
524
- # server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
525
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
547
+ # server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
548
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
526
549
  # website_redirect_location: "WebsiteRedirectLocation",
527
550
  # sse_customer_algorithm: "SSECustomerAlgorithm",
528
551
  # sse_customer_key: "SSECustomerKey",
@@ -834,8 +857,7 @@ module Aws::S3
834
857
  # A map of metadata to store with the object in S3.
835
858
  # @option options [String] :server_side_encryption
836
859
  # The server-side encryption algorithm that was used when you store this
837
- # object in Amazon S3 (for example, `AES256`, `aws:kms`,
838
- # `aws:kms:dsse`).
860
+ # object in Amazon S3 or Amazon FSx.
839
861
  #
840
862
  # * <b>General purpose buckets </b> - You have four mutually exclusive
841
863
  # options to protect data using server-side encryption in Amazon S3,
@@ -889,6 +911,14 @@ module Aws::S3
889
911
  #
890
912
  # </note>
891
913
  #
914
+ # * <b>S3 access points for Amazon FSx </b> - When accessing data stored
915
+ # in Amazon FSx file systems using S3 access points, the only valid
916
+ # server side encryption option is `aws:fsx`. All Amazon FSx file
917
+ # systems have encryption configured by default and are encrypted at
918
+ # rest. Data is automatically encrypted before being written to the
919
+ # file system, and automatically decrypted as it is read. These
920
+ # processes are handled transparently by Amazon FSx.
921
+ #
892
922
  #
893
923
  #
894
924
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
@@ -1176,6 +1206,9 @@ module Aws::S3
1176
1206
  # beginning of the key. The keys that are grouped under `CommonPrefixes`
1177
1207
  # result element are not returned elsewhere in the response.
1178
1208
  #
1209
+ # `CommonPrefixes` is filtered out from results if it is not
1210
+ # lexicographically greater than the key-marker.
1211
+ #
1179
1212
  # <note markdown="1"> **Directory buckets** - For directory buckets, `/` is the only
1180
1213
  # supported delimiter.
1181
1214
  #
@@ -1332,6 +1365,9 @@ module Aws::S3
1332
1365
  # in `CommonPrefixes`. These groups are counted as one result against
1333
1366
  # the `max-keys` limitation. These keys are not returned elsewhere in
1334
1367
  # the response.
1368
+ #
1369
+ # `CommonPrefixes` is filtered out from results if it is not
1370
+ # lexicographically greater than the key-marker.
1335
1371
  # @option options [String] :encoding_type
1336
1372
  # Encoding type used by Amazon S3 to encode the [object keys][1] in the
1337
1373
  # response. Responses are encoded only in UTF-8. An object key can
@@ -1427,6 +1463,9 @@ module Aws::S3
1427
1463
  # @option options [String] :delimiter
1428
1464
  # A delimiter is a character that you use to group keys.
1429
1465
  #
1466
+ # `CommonPrefixes` is filtered out from results if it is not
1467
+ # lexicographically greater than the `StartAfter` value.
1468
+ #
1430
1469
  # <note markdown="1"> * **Directory buckets** - For directory buckets, `/` is the only
1431
1470
  # supported delimiter.
1432
1471
  #
@@ -227,6 +227,17 @@ module Aws::S3
227
227
  # @option options [String] :mfa
228
228
  # The concatenation of the authentication device's serial number, a
229
229
  # space, and the value that is displayed on your authentication device.
230
+ # The serial number is the number that uniquely identifies the MFA
231
+ # device. For physical MFA devices, this is the unique serial number
232
+ # that's provided with the device. For virtual MFA devices, the serial
233
+ # number is the device ARN. For more information, see [Enabling
234
+ # versioning on buckets][1] and [Configuring MFA delete][2] in the
235
+ # *Amazon Simple Storage Service User Guide*.
236
+ #
237
+ #
238
+ #
239
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
240
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
230
241
  # @option options [String] :expected_bucket_owner
231
242
  # The account ID of the expected bucket owner. If the account ID that
232
243
  # you provide does not match the actual owner of the bucket, the request
@@ -289,6 +300,17 @@ module Aws::S3
289
300
  # @option options [String] :mfa
290
301
  # The concatenation of the authentication device's serial number, a
291
302
  # space, and the value that is displayed on your authentication device.
303
+ # The serial number is the number that uniquely identifies the MFA
304
+ # device. For physical MFA devices, this is the unique serial number
305
+ # that's provided with the device. For virtual MFA devices, the serial
306
+ # number is the device ARN. For more information, see [Enabling
307
+ # versioning on buckets][1] and [Configuring MFA delete][2] in the
308
+ # *Amazon Simple Storage Service User Guide*.
309
+ #
310
+ #
311
+ #
312
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
313
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
292
314
  # @option options [required, Types::VersioningConfiguration] :versioning_configuration
293
315
  # Container for setting the versioning state.
294
316
  # @option options [String] :expected_bucket_owner
@@ -344,6 +366,17 @@ module Aws::S3
344
366
  # @option options [String] :mfa
345
367
  # The concatenation of the authentication device's serial number, a
346
368
  # space, and the value that is displayed on your authentication device.
369
+ # The serial number is the number that uniquely identifies the MFA
370
+ # device. For physical MFA devices, this is the unique serial number
371
+ # that's provided with the device. For virtual MFA devices, the serial
372
+ # number is the device ARN. For more information, see [Enabling
373
+ # versioning on buckets][1] and [Configuring MFA delete][2] in the
374
+ # *Amazon Simple Storage Service User Guide*.
375
+ #
376
+ #
377
+ #
378
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
379
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
347
380
  # @option options [String] :expected_bucket_owner
348
381
  # The account ID of the expected bucket owner. If the account ID that
349
382
  # you provide does not match the actual owner of the bucket, the request