aws-sdk-s3 1.164.0 → 1.182.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +102 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +112 -43
- data/lib/aws-sdk-s3/bucket_acl.rb +6 -5
- data/lib/aws-sdk-s3/bucket_cors.rb +6 -5
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +7 -2
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +60 -3
- data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
- data/lib/aws-sdk-s3/bucket_policy.rb +10 -9
- data/lib/aws-sdk-s3/bucket_request_payment.rb +3 -3
- data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
- data/lib/aws-sdk-s3/bucket_versioning.rb +9 -9
- data/lib/aws-sdk-s3/bucket_website.rb +3 -3
- data/lib/aws-sdk-s3/client.rb +2144 -1325
- data/lib/aws-sdk-s3/client_api.rb +175 -3
- data/lib/aws-sdk-s3/customizations/object.rb +6 -0
- data/lib/aws-sdk-s3/customizations/object_summary.rb +5 -0
- data/lib/aws-sdk-s3/customizations/object_version.rb +13 -0
- data/lib/aws-sdk-s3/customizations.rb +24 -38
- data/lib/aws-sdk-s3/endpoint_parameters.rb +13 -18
- data/lib/aws-sdk-s3/endpoint_provider.rb +272 -253
- data/lib/aws-sdk-s3/endpoints.rb +445 -1403
- data/lib/aws-sdk-s3/errors.rb +47 -0
- data/lib/aws-sdk-s3/file_downloader.rb +4 -21
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +31 -13
- data/lib/aws-sdk-s3/multipart_upload.rb +84 -6
- data/lib/aws-sdk-s3/multipart_upload_part.rb +52 -36
- data/lib/aws-sdk-s3/object.rb +254 -113
- data/lib/aws-sdk-s3/object_acl.rb +4 -4
- data/lib/aws-sdk-s3/object_summary.rb +199 -82
- data/lib/aws-sdk-s3/object_version.rb +67 -17
- data/lib/aws-sdk-s3/plugins/checksum_algorithm.rb +31 -0
- data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -204
- data/lib/aws-sdk-s3/plugins/express_session_auth.rb +11 -20
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +3 -3
- data/lib/aws-sdk-s3/plugins/md5s.rb +10 -71
- data/lib/aws-sdk-s3/presigner.rb +5 -5
- data/lib/aws-sdk-s3/resource.rb +35 -10
- data/lib/aws-sdk-s3/types.rb +1921 -856
- data/lib/aws-sdk-s3.rb +35 -31
- data/sig/bucket.rbs +15 -6
- data/sig/bucket_acl.rbs +1 -1
- data/sig/bucket_cors.rbs +1 -1
- data/sig/bucket_lifecycle.rbs +1 -1
- data/sig/bucket_lifecycle_configuration.rbs +8 -4
- data/sig/bucket_logging.rbs +1 -1
- data/sig/bucket_policy.rbs +1 -1
- data/sig/bucket_request_payment.rbs +1 -1
- data/sig/bucket_tagging.rbs +1 -1
- data/sig/bucket_versioning.rbs +3 -3
- data/sig/bucket_website.rbs +1 -1
- data/sig/client.rbs +115 -40
- data/sig/errors.rbs +8 -0
- data/sig/multipart_upload.rbs +11 -2
- data/sig/multipart_upload_part.rbs +5 -1
- data/sig/object.rbs +22 -6
- data/sig/object_acl.rbs +1 -1
- data/sig/object_summary.rbs +17 -7
- data/sig/object_version.rbs +9 -3
- data/sig/resource.rbs +7 -3
- data/sig/types.rbs +163 -36
- metadata +6 -5
- data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +0 -31
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3266d24c11f6499b7372ca6e5ebcb22f444c292ab9c9b35e22d05b80f56c0e43
|
4
|
+
data.tar.gz: 06ddf6610aa82ac9953076588e609cffe852a34c9325950e90a36b1e19a72a1c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 25a1a9cfd1f6e022587c487eed3bdd434adb3f0fba1d1279988d607e9fdf397764d33b7c7d3785355a70b800d417d057b2026c4f5590188c6da06f476af16450
|
7
|
+
data.tar.gz: 4c49d1153ab59ad2f15818588be71547ed7ba37d31798966ea1130ca6ff5d234139954738b9210003f94c29bd07926fdebcaa7192db466b743924a7f1581801f
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,108 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.182.0 (2025-02-18)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
8
|
+
|
9
|
+
1.181.0 (2025-02-14)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Added support for Content-Range header in HeadObject response.
|
13
|
+
|
14
|
+
1.180.0 (2025-02-06)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Updated list of the valid AWS Region values for the LocationConstraint parameter for general purpose buckets.
|
18
|
+
|
19
|
+
1.179.0 (2025-01-29)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Change the type of MpuObjectSize in CompleteMultipartUploadRequest from int to long.
|
23
|
+
|
24
|
+
1.178.0 (2025-01-15)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - This change enhances integrity protections for new SDK requests to S3. S3 SDKs now support the CRC64NVME checksum algorithm, full object checksums for multipart S3 objects, and new default integrity protections for S3 requests.
|
28
|
+
|
29
|
+
* Feature - Default to using `CRC32` checksum validation for S3 uploads and downloads.
|
30
|
+
|
31
|
+
1.177.0 (2025-01-03)
|
32
|
+
------------------
|
33
|
+
|
34
|
+
* Feature - This change is only for updating the model regexp of CopySource which is not for validation but only for documentation and user guide change.
|
35
|
+
|
36
|
+
1.176.1 (2024-12-12)
|
37
|
+
------------------
|
38
|
+
|
39
|
+
* Issue - Do not normalize object keys when calling `presigned_url` or `presigned_request`.
|
40
|
+
|
41
|
+
1.176.0 (2024-12-03)
|
42
|
+
------------------
|
43
|
+
|
44
|
+
* Feature - Amazon S3 Metadata stores object metadata in read-only, fully managed Apache Iceberg metadata tables that you can query. You can create metadata table configurations for S3 general purpose buckets.
|
45
|
+
|
46
|
+
1.175.0 (2024-12-02)
|
47
|
+
------------------
|
48
|
+
|
49
|
+
* Feature - Amazon S3 introduces support for AWS Dedicated Local Zones
|
50
|
+
|
51
|
+
1.174.0 (2024-11-25)
|
52
|
+
------------------
|
53
|
+
|
54
|
+
* Feature - Amazon Simple Storage Service / Features: Add support for ETag based conditional writes in PutObject and CompleteMultiPartUpload APIs to prevent unintended object modifications.
|
55
|
+
|
56
|
+
1.173.0 (2024-11-21)
|
57
|
+
------------------
|
58
|
+
|
59
|
+
* Feature - Add support for conditional deletes for the S3 DeleteObject and DeleteObjects APIs. Add support for write offset bytes option used to append to objects with the S3 PutObject API.
|
60
|
+
|
61
|
+
1.172.0 (2024-11-18)
|
62
|
+
------------------
|
63
|
+
|
64
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
65
|
+
|
66
|
+
1.171.0 (2024-11-14)
|
67
|
+
------------------
|
68
|
+
|
69
|
+
* Feature - This release updates the ListBuckets API Reference documentation in support of the new 10,000 general purpose bucket default quota on all AWS accounts. To increase your bucket quota from 10,000 to up to 1 million buckets, simply request a quota increase via Service Quotas.
|
70
|
+
|
71
|
+
1.170.1 (2024-11-11)
|
72
|
+
------------------
|
73
|
+
|
74
|
+
* Issue - Tighten regex used to check for S3 200 errors.
|
75
|
+
|
76
|
+
1.170.0 (2024-11-06)
|
77
|
+
------------------
|
78
|
+
|
79
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
80
|
+
|
81
|
+
1.169.0 (2024-10-18)
|
82
|
+
------------------
|
83
|
+
|
84
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
85
|
+
|
86
|
+
1.168.0 (2024-10-16)
|
87
|
+
------------------
|
88
|
+
|
89
|
+
* Feature - Add support for the new optional bucket-region and prefix query parameters in the ListBuckets API. For ListBuckets requests that express pagination, Amazon S3 will now return both the bucket names and associated AWS regions in the response.
|
90
|
+
|
91
|
+
1.167.0 (2024-10-02)
|
92
|
+
------------------
|
93
|
+
|
94
|
+
* Feature - This release introduces a header representing the minimum object size limit for Lifecycle transitions.
|
95
|
+
|
96
|
+
1.166.0 (2024-09-24)
|
97
|
+
------------------
|
98
|
+
|
99
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
100
|
+
|
101
|
+
1.165.0 (2024-09-23)
|
102
|
+
------------------
|
103
|
+
|
104
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
105
|
+
|
4
106
|
1.164.0 (2024-09-20)
|
5
107
|
------------------
|
6
108
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.182.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -41,6 +41,14 @@ module Aws::S3
|
|
41
41
|
data[:creation_date]
|
42
42
|
end
|
43
43
|
|
44
|
+
# `BucketRegion` indicates the Amazon Web Services region where the
|
45
|
+
# bucket is located. If the request contains at least one valid
|
46
|
+
# parameter, it is included in the response.
|
47
|
+
# @return [String]
|
48
|
+
def bucket_region
|
49
|
+
data[:bucket_region]
|
50
|
+
end
|
51
|
+
|
44
52
|
# @!endgroup
|
45
53
|
|
46
54
|
# @return [Client]
|
@@ -229,13 +237,13 @@ module Aws::S3
|
|
229
237
|
# bucket.create({
|
230
238
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
231
239
|
# 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-south-2, 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-south-2, 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
|
240
|
+
# 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-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-4, ap-southeast-5, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-central-2, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, il-central-1, me-central-1, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
233
241
|
# location: {
|
234
|
-
# type: "AvailabilityZone", # accepts AvailabilityZone
|
242
|
+
# type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
|
235
243
|
# name: "LocationNameAsString",
|
236
244
|
# },
|
237
245
|
# bucket: {
|
238
|
-
# data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
|
246
|
+
# data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
|
239
247
|
# type: "Directory", # accepts Directory
|
240
248
|
# },
|
241
249
|
# },
|
@@ -373,6 +381,9 @@ module Aws::S3
|
|
373
381
|
# {
|
374
382
|
# key: "ObjectKey", # required
|
375
383
|
# version_id: "ObjectVersionId",
|
384
|
+
# etag: "ETag",
|
385
|
+
# last_modified_time: Time.now,
|
386
|
+
# size: 1,
|
376
387
|
# },
|
377
388
|
# ],
|
378
389
|
# quiet: false,
|
@@ -381,7 +392,7 @@ module Aws::S3
|
|
381
392
|
# request_payer: "requester", # accepts requester
|
382
393
|
# bypass_governance_retention: false,
|
383
394
|
# expected_bucket_owner: "AccountId",
|
384
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
395
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
385
396
|
# })
|
386
397
|
# @param [Hash] options ({})
|
387
398
|
# @option options [required, Types::Delete] :delete
|
@@ -447,22 +458,23 @@ module Aws::S3
|
|
447
458
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
448
459
|
# the supported algorithm from the following list:
|
449
460
|
#
|
450
|
-
# * CRC32
|
461
|
+
# * `CRC32`
|
451
462
|
#
|
452
|
-
# * CRC32C
|
463
|
+
# * `CRC32C`
|
453
464
|
#
|
454
|
-
# *
|
465
|
+
# * `CRC64NVME`
|
455
466
|
#
|
456
|
-
# *
|
467
|
+
# * `SHA1`
|
468
|
+
#
|
469
|
+
# * `SHA256`
|
457
470
|
#
|
458
471
|
# For more information, see [Checking object integrity][1] in the
|
459
472
|
# *Amazon S3 User Guide*.
|
460
473
|
#
|
461
474
|
# If the individual checksum value you provide through
|
462
475
|
# `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
|
463
|
-
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3
|
464
|
-
#
|
465
|
-
# that matches the provided value in `x-amz-checksum-algorithm `.
|
476
|
+
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
|
477
|
+
# request with a `BadDigest` error.
|
466
478
|
#
|
467
479
|
# If you provide an individual checksum, Amazon S3 ignores any provided
|
468
480
|
# `ChecksumAlgorithm` parameter.
|
@@ -491,18 +503,21 @@ module Aws::S3
|
|
491
503
|
# content_length: 1,
|
492
504
|
# content_md5: "ContentMD5",
|
493
505
|
# content_type: "ContentType",
|
494
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
506
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
495
507
|
# checksum_crc32: "ChecksumCRC32",
|
496
508
|
# checksum_crc32c: "ChecksumCRC32C",
|
509
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
497
510
|
# checksum_sha1: "ChecksumSHA1",
|
498
511
|
# checksum_sha256: "ChecksumSHA256",
|
499
512
|
# expires: Time.now,
|
513
|
+
# if_match: "IfMatch",
|
500
514
|
# if_none_match: "IfNoneMatch",
|
501
515
|
# grant_full_control: "GrantFullControl",
|
502
516
|
# grant_read: "GrantRead",
|
503
517
|
# grant_read_acp: "GrantReadACP",
|
504
518
|
# grant_write_acp: "GrantWriteACP",
|
505
519
|
# key: "ObjectKey", # required
|
520
|
+
# write_offset_bytes: 1,
|
506
521
|
# metadata: {
|
507
522
|
# "MetadataKey" => "MetadataValue",
|
508
523
|
# },
|
@@ -598,7 +613,7 @@ module Aws::S3
|
|
598
613
|
#
|
599
614
|
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
|
600
615
|
# @option options [String] :content_md5
|
601
|
-
# The
|
616
|
+
# The Base64 encoded 128-bit `MD5` digest of the message (without the
|
602
617
|
# headers) according to RFC 1864. This header can be used as a message
|
603
618
|
# integrity check to verify that the data is the same data that was
|
604
619
|
# originally sent. Although it is optional, we recommend using the
|
@@ -606,10 +621,11 @@ module Aws::S3
|
|
606
621
|
# information about REST request authentication, see [REST
|
607
622
|
# Authentication][1].
|
608
623
|
#
|
609
|
-
# <note markdown="1"> The `Content-MD5` header is required
|
610
|
-
# object with a retention period configured
|
611
|
-
#
|
612
|
-
# Object Lock
|
624
|
+
# <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
|
625
|
+
# for any request to upload an object with a retention period configured
|
626
|
+
# using Amazon S3 Object Lock. For more information, see [Uploading
|
627
|
+
# objects to an Object Lock enabled bucket ][2] in the *Amazon S3 User
|
628
|
+
# Guide*.
|
613
629
|
#
|
614
630
|
# </note>
|
615
631
|
#
|
@@ -620,7 +636,7 @@ module Aws::S3
|
|
620
636
|
#
|
621
637
|
#
|
622
638
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
623
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
639
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
|
624
640
|
# @option options [String] :content_type
|
625
641
|
# A standard MIME type describing the format of the contents. For more
|
626
642
|
# information, see
|
@@ -640,37 +656,45 @@ module Aws::S3
|
|
640
656
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
641
657
|
# the supported algorithm from the following list:
|
642
658
|
#
|
643
|
-
# * CRC32
|
659
|
+
# * `CRC32`
|
660
|
+
#
|
661
|
+
# * `CRC32C`
|
644
662
|
#
|
645
|
-
# *
|
663
|
+
# * `CRC64NVME`
|
646
664
|
#
|
647
|
-
# * SHA1
|
665
|
+
# * `SHA1`
|
648
666
|
#
|
649
|
-
# * SHA256
|
667
|
+
# * `SHA256`
|
650
668
|
#
|
651
669
|
# For more information, see [Checking object integrity][1] in the
|
652
670
|
# *Amazon S3 User Guide*.
|
653
671
|
#
|
654
672
|
# If the individual checksum value you provide through
|
655
673
|
# `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
|
656
|
-
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3
|
657
|
-
#
|
658
|
-
# that matches the provided value in `x-amz-checksum-algorithm `.
|
674
|
+
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
|
675
|
+
# request with a `BadDigest` error.
|
659
676
|
#
|
660
|
-
# <note markdown="1">
|
661
|
-
#
|
677
|
+
# <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
|
678
|
+
# for any request to upload an object with a retention period configured
|
679
|
+
# using Amazon S3 Object Lock. For more information, see [Uploading
|
680
|
+
# objects to an Object Lock enabled bucket ][2] in the *Amazon S3 User
|
681
|
+
# Guide*.
|
662
682
|
#
|
663
683
|
# </note>
|
664
684
|
#
|
685
|
+
# For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
|
686
|
+
# is the default checksum algorithm that's used for performance.
|
687
|
+
#
|
665
688
|
#
|
666
689
|
#
|
667
690
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
691
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
|
668
692
|
# @option options [String] :checksum_crc32
|
669
693
|
# This header can be used as a data integrity check to verify that the
|
670
694
|
# data received is the same data that was originally sent. This header
|
671
|
-
# specifies the
|
672
|
-
# more information, see [Checking object integrity][1] in the
|
673
|
-
# User Guide*.
|
695
|
+
# specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
|
696
|
+
# For more information, see [Checking object integrity][1] in the
|
697
|
+
# *Amazon S3 User Guide*.
|
674
698
|
#
|
675
699
|
#
|
676
700
|
#
|
@@ -678,17 +702,28 @@ module Aws::S3
|
|
678
702
|
# @option options [String] :checksum_crc32c
|
679
703
|
# This header can be used as a data integrity check to verify that the
|
680
704
|
# data received is the same data that was originally sent. This header
|
681
|
-
# specifies the
|
705
|
+
# specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
|
682
706
|
# For more information, see [Checking object integrity][1] in the
|
683
707
|
# *Amazon S3 User Guide*.
|
684
708
|
#
|
685
709
|
#
|
686
710
|
#
|
687
711
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
712
|
+
# @option options [String] :checksum_crc64nvme
|
713
|
+
# This header can be used as a data integrity check to verify that the
|
714
|
+
# data received is the same data that was originally sent. This header
|
715
|
+
# specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
|
716
|
+
# object. The `CRC64NVME` checksum is always a full object checksum. For
|
717
|
+
# more information, see [Checking object integrity in the Amazon S3 User
|
718
|
+
# Guide][1].
|
719
|
+
#
|
720
|
+
#
|
721
|
+
#
|
722
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
688
723
|
# @option options [String] :checksum_sha1
|
689
724
|
# This header can be used as a data integrity check to verify that the
|
690
725
|
# data received is the same data that was originally sent. This header
|
691
|
-
# specifies the
|
726
|
+
# specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
|
692
727
|
# more information, see [Checking object integrity][1] in the *Amazon S3
|
693
728
|
# User Guide*.
|
694
729
|
#
|
@@ -698,7 +733,7 @@ module Aws::S3
|
|
698
733
|
# @option options [String] :checksum_sha256
|
699
734
|
# This header can be used as a data integrity check to verify that the
|
700
735
|
# data received is the same data that was originally sent. This header
|
701
|
-
# specifies the
|
736
|
+
# specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
|
702
737
|
# For more information, see [Checking object integrity][1] in the
|
703
738
|
# *Amazon S3 User Guide*.
|
704
739
|
#
|
@@ -713,6 +748,25 @@ module Aws::S3
|
|
713
748
|
#
|
714
749
|
#
|
715
750
|
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
751
|
+
# @option options [String] :if_match
|
752
|
+
# Uploads the object only if the ETag (entity tag) value provided during
|
753
|
+
# the WRITE operation matches the ETag of the object in S3. If the ETag
|
754
|
+
# values do not match, the operation returns a `412 Precondition Failed`
|
755
|
+
# error.
|
756
|
+
#
|
757
|
+
# If a conflicting operation occurs during the upload S3 returns a `409
|
758
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
759
|
+
# fetch the object's ETag and retry the upload.
|
760
|
+
#
|
761
|
+
# Expects the ETag value as a string.
|
762
|
+
#
|
763
|
+
# For more information about conditional requests, see [RFC 7232][1], or
|
764
|
+
# [Conditional requests][2] in the *Amazon S3 User Guide*.
|
765
|
+
#
|
766
|
+
#
|
767
|
+
#
|
768
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
769
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
716
770
|
# @option options [String] :if_none_match
|
717
771
|
# Uploads the object only if the object key name does not already exist
|
718
772
|
# in the bucket specified. Otherwise, Amazon S3 returns a `412
|
@@ -766,6 +820,16 @@ module Aws::S3
|
|
766
820
|
# </note>
|
767
821
|
# @option options [required, String] :key
|
768
822
|
# Object key for which the PUT action was initiated.
|
823
|
+
# @option options [Integer] :write_offset_bytes
|
824
|
+
# Specifies the offset for appending data to existing objects in bytes.
|
825
|
+
# The offset must be equal to the size of the existing object being
|
826
|
+
# appended to. If no object exists, setting this header to 0 will create
|
827
|
+
# a new object.
|
828
|
+
#
|
829
|
+
# <note markdown="1"> This functionality is only supported for objects in the Amazon S3
|
830
|
+
# Express One Zone storage class in directory buckets.
|
831
|
+
#
|
832
|
+
# </note>
|
769
833
|
# @option options [Hash<String,String>] :metadata
|
770
834
|
# A map of metadata to store with the object in S3.
|
771
835
|
# @option options [String] :server_side_encryption
|
@@ -918,15 +982,17 @@ module Aws::S3
|
|
918
982
|
# `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
919
983
|
# Amazon Web Services managed key (`aws/s3`) to protect the data.
|
920
984
|
#
|
921
|
-
# **Directory buckets** -
|
922
|
-
#
|
923
|
-
# x-amz-server-side-encryption-aws-kms-key-id`
|
924
|
-
#
|
925
|
-
#
|
926
|
-
# key
|
927
|
-
#
|
928
|
-
#
|
929
|
-
#
|
985
|
+
# **Directory buckets** - To encrypt data using SSE-KMS, it's
|
986
|
+
# recommended to specify the `x-amz-server-side-encryption` header to
|
987
|
+
# `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
|
988
|
+
# header implicitly uses the bucket's default KMS customer managed key
|
989
|
+
# ID. If you want to explicitly set the `
|
990
|
+
# x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
|
991
|
+
# bucket's default customer managed key (using key ID or ARN, not
|
992
|
+
# alias). Your SSE-KMS configuration can only support 1 [customer
|
993
|
+
# managed key][1] per directory bucket's lifetime. The [Amazon Web
|
994
|
+
# Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
|
995
|
+
# specification results in an HTTP `400 Bad Request` error.
|
930
996
|
#
|
931
997
|
#
|
932
998
|
#
|
@@ -935,7 +1001,7 @@ module Aws::S3
|
|
935
1001
|
# @option options [String] :ssekms_encryption_context
|
936
1002
|
# Specifies the Amazon Web Services KMS Encryption Context as an
|
937
1003
|
# additional encryption context to use for object encryption. The value
|
938
|
-
# of this header is a Base64
|
1004
|
+
# of this header is a Base64 encoded string of a UTF-8 encoded JSON,
|
939
1005
|
# which contains the encryption context as key-value pairs. This value
|
940
1006
|
# is stored as object metadata and automatically gets passed on to
|
941
1007
|
# Amazon Web Services KMS for future `GetObject` operations on this
|
@@ -1552,3 +1618,6 @@ module Aws::S3
|
|
1552
1618
|
class Collection < Aws::Resources::Collection; end
|
1553
1619
|
end
|
1554
1620
|
end
|
1621
|
+
|
1622
|
+
# Load customizations if they exist
|
1623
|
+
require 'aws-sdk-s3/customizations/bucket'
|
@@ -207,7 +207,7 @@ module Aws::S3
|
|
207
207
|
# },
|
208
208
|
# },
|
209
209
|
# content_md5: "ContentMD5",
|
210
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
210
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
211
211
|
# grant_full_control: "GrantFullControl",
|
212
212
|
# grant_read: "GrantRead",
|
213
213
|
# grant_read_acp: "GrantReadACP",
|
@@ -222,9 +222,10 @@ module Aws::S3
|
|
222
222
|
# Contains the elements that set the ACL permissions for an object per
|
223
223
|
# grantee.
|
224
224
|
# @option options [String] :content_md5
|
225
|
-
# The
|
226
|
-
# used as a message integrity check to verify that the request body
|
227
|
-
# not corrupted in transit. For more information, go to [RFC
|
225
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. This header must
|
226
|
+
# be used as a message integrity check to verify that the request body
|
227
|
+
# was not corrupted in transit. For more information, go to [RFC
|
228
|
+
# 1864.][1]
|
228
229
|
#
|
229
230
|
# For requests made using the Amazon Web Services Command Line Interface
|
230
231
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
@@ -234,7 +235,7 @@ module Aws::S3
|
|
234
235
|
#
|
235
236
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
236
237
|
# @option options [String] :checksum_algorithm
|
237
|
-
# Indicates the algorithm used to create the checksum for the
|
238
|
+
# Indicates the algorithm used to create the checksum for the request
|
238
239
|
# when you use the SDK. This header will not provide any additional
|
239
240
|
# functionality if you don't use the SDK. When you send this header,
|
240
241
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -214,7 +214,7 @@ module Aws::S3
|
|
214
214
|
# ],
|
215
215
|
# },
|
216
216
|
# content_md5: "ContentMD5",
|
217
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
217
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
218
218
|
# expected_bucket_owner: "AccountId",
|
219
219
|
# })
|
220
220
|
# @param [Hash] options ({})
|
@@ -227,9 +227,10 @@ module Aws::S3
|
|
227
227
|
#
|
228
228
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
229
229
|
# @option options [String] :content_md5
|
230
|
-
# The
|
231
|
-
# used as a message integrity check to verify that the request body
|
232
|
-
# not corrupted in transit. For more information, go to [RFC
|
230
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. This header must
|
231
|
+
# be used as a message integrity check to verify that the request body
|
232
|
+
# was not corrupted in transit. For more information, go to [RFC
|
233
|
+
# 1864.][1]
|
233
234
|
#
|
234
235
|
# For requests made using the Amazon Web Services Command Line Interface
|
235
236
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
@@ -239,7 +240,7 @@ module Aws::S3
|
|
239
240
|
#
|
240
241
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
241
242
|
# @option options [String] :checksum_algorithm
|
242
|
-
# Indicates the algorithm used to create the checksum for the
|
243
|
+
# Indicates the algorithm used to create the checksum for the request
|
243
244
|
# when you use the SDK. This header will not provide any additional
|
244
245
|
# functionality if you don't use the SDK. When you send this header,
|
245
246
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -188,6 +188,11 @@ module Aws::S3
|
|
188
188
|
# The account ID of the expected bucket owner. If the account ID that
|
189
189
|
# you provide does not match the actual owner of the bucket, the request
|
190
190
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
191
|
+
#
|
192
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
193
|
+
# supported for directory bucket lifecycle configurations.
|
194
|
+
#
|
195
|
+
# </note>
|
191
196
|
# @return [EmptyStructure]
|
192
197
|
def delete(options = {})
|
193
198
|
options = options.merge(bucket: @bucket_name)
|
@@ -201,7 +206,7 @@ module Aws::S3
|
|
201
206
|
#
|
202
207
|
# bucket_lifecycle.put({
|
203
208
|
# content_md5: "ContentMD5",
|
204
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
209
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
205
210
|
# lifecycle_configuration: {
|
206
211
|
# rules: [ # required
|
207
212
|
# {
|
@@ -241,7 +246,7 @@ module Aws::S3
|
|
241
246
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
242
247
|
# automatically.
|
243
248
|
# @option options [String] :checksum_algorithm
|
244
|
-
# Indicates the algorithm used to create the checksum for the
|
249
|
+
# Indicates the algorithm used to create the checksum for the request
|
245
250
|
# when you use the SDK. This header will not provide any additional
|
246
251
|
# functionality if you don't use the SDK. When you send this header,
|
247
252
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -40,6 +40,31 @@ module Aws::S3
|
|
40
40
|
data[:rules]
|
41
41
|
end
|
42
42
|
|
43
|
+
# Indicates which default minimum object size behavior is applied to the
|
44
|
+
# lifecycle configuration.
|
45
|
+
#
|
46
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It isn't
|
47
|
+
# supported for directory bucket lifecycle configurations.
|
48
|
+
#
|
49
|
+
# </note>
|
50
|
+
#
|
51
|
+
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
52
|
+
# transition to any storage class by default.
|
53
|
+
#
|
54
|
+
# * `varies_by_storage_class` - Objects smaller than 128 KB will
|
55
|
+
# transition to Glacier Flexible Retrieval or Glacier Deep Archive
|
56
|
+
# storage classes. By default, all other storage classes will prevent
|
57
|
+
# transitions smaller than 128 KB.
|
58
|
+
#
|
59
|
+
# To customize the minimum object size for any transition you can add a
|
60
|
+
# filter that specifies a custom `ObjectSizeGreaterThan` or
|
61
|
+
# `ObjectSizeLessThan` in the body of your transition rule. Custom
|
62
|
+
# filters always take precedence over the default transition behavior.
|
63
|
+
# @return [String]
|
64
|
+
def transition_default_minimum_object_size
|
65
|
+
data[:transition_default_minimum_object_size]
|
66
|
+
end
|
67
|
+
|
43
68
|
# @!endgroup
|
44
69
|
|
45
70
|
# @return [Client]
|
@@ -188,6 +213,11 @@ module Aws::S3
|
|
188
213
|
# The account ID of the expected bucket owner. If the account ID that
|
189
214
|
# you provide does not match the actual owner of the bucket, the request
|
190
215
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
216
|
+
#
|
217
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
218
|
+
# supported for directory bucket lifecycle configurations.
|
219
|
+
#
|
220
|
+
# </note>
|
191
221
|
# @return [EmptyStructure]
|
192
222
|
def delete(options = {})
|
193
223
|
options = options.merge(bucket: @bucket_name)
|
@@ -200,7 +230,7 @@ module Aws::S3
|
|
200
230
|
# @example Request syntax with placeholder values
|
201
231
|
#
|
202
232
|
# bucket_lifecycle_configuration.put({
|
203
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
233
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
204
234
|
# lifecycle_configuration: {
|
205
235
|
# rules: [ # required
|
206
236
|
# {
|
@@ -257,10 +287,11 @@ module Aws::S3
|
|
257
287
|
# ],
|
258
288
|
# },
|
259
289
|
# expected_bucket_owner: "AccountId",
|
290
|
+
# transition_default_minimum_object_size: "varies_by_storage_class", # accepts varies_by_storage_class, all_storage_classes_128K
|
260
291
|
# })
|
261
292
|
# @param [Hash] options ({})
|
262
293
|
# @option options [String] :checksum_algorithm
|
263
|
-
# Indicates the algorithm used to create the checksum for the
|
294
|
+
# Indicates the algorithm used to create the checksum for the request
|
264
295
|
# when you use the SDK. This header will not provide any additional
|
265
296
|
# functionality if you don't use the SDK. When you send this header,
|
266
297
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -280,7 +311,33 @@ module Aws::S3
|
|
280
311
|
# The account ID of the expected bucket owner. If the account ID that
|
281
312
|
# you provide does not match the actual owner of the bucket, the request
|
282
313
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
283
|
-
#
|
314
|
+
#
|
315
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
316
|
+
# supported for directory bucket lifecycle configurations.
|
317
|
+
#
|
318
|
+
# </note>
|
319
|
+
# @option options [String] :transition_default_minimum_object_size
|
320
|
+
# Indicates which default minimum object size behavior is applied to the
|
321
|
+
# lifecycle configuration.
|
322
|
+
#
|
323
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
324
|
+
# supported for directory bucket lifecycle configurations.
|
325
|
+
#
|
326
|
+
# </note>
|
327
|
+
#
|
328
|
+
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
329
|
+
# transition to any storage class by default.
|
330
|
+
#
|
331
|
+
# * `varies_by_storage_class` - Objects smaller than 128 KB will
|
332
|
+
# transition to Glacier Flexible Retrieval or Glacier Deep Archive
|
333
|
+
# storage classes. By default, all other storage classes will prevent
|
334
|
+
# transitions smaller than 128 KB.
|
335
|
+
#
|
336
|
+
# To customize the minimum object size for any transition you can add a
|
337
|
+
# filter that specifies a custom `ObjectSizeGreaterThan` or
|
338
|
+
# `ObjectSizeLessThan` in the body of your transition rule. Custom
|
339
|
+
# filters always take precedence over the default transition behavior.
|
340
|
+
# @return [Types::PutBucketLifecycleConfigurationOutput]
|
284
341
|
def put(options = {})
|
285
342
|
options = options.merge(bucket: @bucket_name)
|
286
343
|
resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
|
@@ -213,7 +213,7 @@ module Aws::S3
|
|
213
213
|
# },
|
214
214
|
# },
|
215
215
|
# content_md5: "ContentMD5",
|
216
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
216
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
217
217
|
# expected_bucket_owner: "AccountId",
|
218
218
|
# })
|
219
219
|
# @param [Hash] options ({})
|
@@ -226,7 +226,7 @@ module Aws::S3
|
|
226
226
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
227
227
|
# automatically.
|
228
228
|
# @option options [String] :checksum_algorithm
|
229
|
-
# Indicates the algorithm used to create the checksum for the
|
229
|
+
# Indicates the algorithm used to create the checksum for the request
|
230
230
|
# when you use the SDK. This header will not provide any additional
|
231
231
|
# functionality if you don't use the SDK. When you send this header,
|
232
232
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|