aws-sdk-s3 1.200.0 → 1.204.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 +27 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
- data/lib/aws-sdk-s3/client.rb +671 -162
- data/lib/aws-sdk-s3/client_api.rb +11 -0
- data/lib/aws-sdk-s3/customizations/object.rb +3 -4
- data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
- data/lib/aws-sdk-s3/endpoint_provider.rb +220 -50
- data/lib/aws-sdk-s3/file_downloader.rb +19 -2
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +22 -11
- data/lib/aws-sdk-s3/object.rb +52 -23
- data/lib/aws-sdk-s3/object_summary.rb +38 -9
- data/lib/aws-sdk-s3/object_version.rb +7 -9
- data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
- data/lib/aws-sdk-s3/transfer_manager.rb +3 -4
- data/lib/aws-sdk-s3/types.rb +278 -140
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/client.rbs +6 -1
- data/sig/object.rbs +2 -0
- data/sig/object_summary.rbs +2 -0
- data/sig/types.rbs +8 -0
- metadata +3 -3
data/lib/aws-sdk-s3/types.rb
CHANGED
|
@@ -355,6 +355,63 @@ module Aws::S3
|
|
|
355
355
|
include Aws::Structure
|
|
356
356
|
end
|
|
357
357
|
|
|
358
|
+
# A bucket-level setting for Amazon S3 general purpose buckets used to
|
|
359
|
+
# prevent the upload of new objects encrypted with the specified
|
|
360
|
+
# server-side encryption type. For example, blocking an encryption type
|
|
361
|
+
# will block `PutObject`, `CopyObject`, `PostObject`, multipart upload,
|
|
362
|
+
# and replication requests to the bucket for objects with the specified
|
|
363
|
+
# encryption type. However, you can continue to read and list any
|
|
364
|
+
# pre-existing objects already encrypted with the specified encryption
|
|
365
|
+
# type. For more information, see [Blocking an encryption type for a
|
|
366
|
+
# general purpose bucket][1].
|
|
367
|
+
#
|
|
368
|
+
# This data type is used with the following actions:
|
|
369
|
+
#
|
|
370
|
+
# * [PutBucketEncryption][2]
|
|
371
|
+
#
|
|
372
|
+
# * [GetBucketEncryption][3]
|
|
373
|
+
#
|
|
374
|
+
# * [DeleteBucketEncryption][4]
|
|
375
|
+
#
|
|
376
|
+
# Permissions
|
|
377
|
+
#
|
|
378
|
+
# : You must have the `s3:PutEncryptionConfiguration` permission to
|
|
379
|
+
# block or unblock an encryption type for a bucket.
|
|
380
|
+
#
|
|
381
|
+
# You must have the `s3:GetEncryptionConfiguration` permission to view
|
|
382
|
+
# a bucket's encryption type.
|
|
383
|
+
#
|
|
384
|
+
#
|
|
385
|
+
#
|
|
386
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/userguide/block-encryption-type.html
|
|
387
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
|
388
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
|
389
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
390
|
+
#
|
|
391
|
+
# @!attribute [rw] encryption_type
|
|
392
|
+
# The object encryption type that you want to block or unblock for an
|
|
393
|
+
# Amazon S3 general purpose bucket.
|
|
394
|
+
#
|
|
395
|
+
# <note markdown="1"> Currently, this parameter only supports blocking or unblocking
|
|
396
|
+
# server side encryption with customer-provided keys (SSE-C). For more
|
|
397
|
+
# information about SSE-C, see [Using server-side encryption with
|
|
398
|
+
# customer-provided keys (SSE-C)][1].
|
|
399
|
+
#
|
|
400
|
+
# </note>
|
|
401
|
+
#
|
|
402
|
+
#
|
|
403
|
+
#
|
|
404
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
|
405
|
+
# @return [Array<String>]
|
|
406
|
+
#
|
|
407
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/BlockedEncryptionTypes AWS API Documentation
|
|
408
|
+
#
|
|
409
|
+
class BlockedEncryptionTypes < Struct.new(
|
|
410
|
+
:encryption_type)
|
|
411
|
+
SENSITIVE = []
|
|
412
|
+
include Aws::Structure
|
|
413
|
+
end
|
|
414
|
+
|
|
358
415
|
# In terms of implementation, a Bucket is a resource.
|
|
359
416
|
#
|
|
360
417
|
# @!attribute [rw] name
|
|
@@ -680,7 +737,7 @@ module Aws::S3
|
|
|
680
737
|
#
|
|
681
738
|
# @!attribute [rw] checksum_crc32
|
|
682
739
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
683
|
-
# checksum is only
|
|
740
|
+
# checksum is only present if the checksum was uploaded with the
|
|
684
741
|
# object. When you use an API operation on an object that was uploaded
|
|
685
742
|
# using multipart uploads, this value may not be a direct checksum
|
|
686
743
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -722,14 +779,15 @@ module Aws::S3
|
|
|
722
779
|
# @return [String]
|
|
723
780
|
#
|
|
724
781
|
# @!attribute [rw] checksum_sha1
|
|
725
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
726
|
-
# only
|
|
727
|
-
# use the API operation on an object that was
|
|
728
|
-
# uploads, this value may not be a direct
|
|
729
|
-
# object. Instead, it's a calculation
|
|
730
|
-
# each individual part. For more
|
|
731
|
-
#
|
|
732
|
-
# integrity][1] in the *Amazon S3 User
|
|
782
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
783
|
+
# checksum is only present if the checksum was uploaded with the
|
|
784
|
+
# object. When you use the API operation on an object that was
|
|
785
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
786
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
787
|
+
# based on the checksum values of each individual part. For more
|
|
788
|
+
# information about how checksums are calculated with multipart
|
|
789
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
790
|
+
# Guide*.
|
|
733
791
|
#
|
|
734
792
|
#
|
|
735
793
|
#
|
|
@@ -737,14 +795,14 @@ module Aws::S3
|
|
|
737
795
|
# @return [String]
|
|
738
796
|
#
|
|
739
797
|
# @!attribute [rw] checksum_sha256
|
|
740
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
741
|
-
# only
|
|
742
|
-
# use an API operation on an object that was uploaded
|
|
743
|
-
# uploads, this value may not be a direct checksum
|
|
744
|
-
# object. Instead, it's a calculation based on the
|
|
745
|
-
# each individual part. For more information about
|
|
746
|
-
# calculated with multipart uploads, see [ Checking
|
|
747
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
798
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
799
|
+
# checksum is only present if the checksum was uploaded with the
|
|
800
|
+
# object. When you use an API operation on an object that was uploaded
|
|
801
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
802
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
803
|
+
# checksum values of each individual part. For more information about
|
|
804
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
805
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
748
806
|
#
|
|
749
807
|
#
|
|
750
808
|
#
|
|
@@ -874,7 +932,7 @@ module Aws::S3
|
|
|
874
932
|
#
|
|
875
933
|
# @!attribute [rw] checksum_crc32
|
|
876
934
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
877
|
-
# checksum is only
|
|
935
|
+
# checksum is only present if the checksum was uploaded with the
|
|
878
936
|
# object. When you use an API operation on an object that was uploaded
|
|
879
937
|
# using multipart uploads, this value may not be a direct checksum
|
|
880
938
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -916,14 +974,15 @@ module Aws::S3
|
|
|
916
974
|
# @return [String]
|
|
917
975
|
#
|
|
918
976
|
# @!attribute [rw] checksum_sha1
|
|
919
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
920
|
-
# only
|
|
921
|
-
# use the API operation on an object that was
|
|
922
|
-
# uploads, this value may not be a direct
|
|
923
|
-
# object. Instead, it's a calculation
|
|
924
|
-
# each individual part. For more
|
|
925
|
-
#
|
|
926
|
-
# integrity][1] in the *Amazon S3 User
|
|
977
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
978
|
+
# checksum is only present if the checksum was uploaded with the
|
|
979
|
+
# object. When you use the API operation on an object that was
|
|
980
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
981
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
982
|
+
# based on the checksum values of each individual part. For more
|
|
983
|
+
# information about how checksums are calculated with multipart
|
|
984
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
985
|
+
# Guide*.
|
|
927
986
|
#
|
|
928
987
|
#
|
|
929
988
|
#
|
|
@@ -931,14 +990,14 @@ module Aws::S3
|
|
|
931
990
|
# @return [String]
|
|
932
991
|
#
|
|
933
992
|
# @!attribute [rw] checksum_sha256
|
|
934
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
935
|
-
# only
|
|
936
|
-
# use an API operation on an object that was uploaded
|
|
937
|
-
# uploads, this value may not be a direct checksum
|
|
938
|
-
# object. Instead, it's a calculation based on the
|
|
939
|
-
# each individual part. For more information about
|
|
940
|
-
# calculated with multipart uploads, see [ Checking
|
|
941
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
993
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
994
|
+
# checksum is only present if the checksum was uploaded with the
|
|
995
|
+
# object. When you use an API operation on an object that was uploaded
|
|
996
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
997
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
998
|
+
# checksum values of each individual part. For more information about
|
|
999
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
1000
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
942
1001
|
#
|
|
943
1002
|
#
|
|
944
1003
|
#
|
|
@@ -1915,6 +1974,40 @@ module Aws::S3
|
|
|
1915
1974
|
# </note>
|
|
1916
1975
|
# @return [String]
|
|
1917
1976
|
#
|
|
1977
|
+
# @!attribute [rw] if_match
|
|
1978
|
+
# Copies the object if the entity tag (ETag) of the destination object
|
|
1979
|
+
# matches the specified tag. If the ETag values do not match, the
|
|
1980
|
+
# operation returns a `412 Precondition Failed` error. If a concurrent
|
|
1981
|
+
# operation occurs during the upload S3 returns a `409
|
|
1982
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
|
1983
|
+
# fetch the object's ETag and retry the upload.
|
|
1984
|
+
#
|
|
1985
|
+
# Expects the ETag value as a string.
|
|
1986
|
+
#
|
|
1987
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
1988
|
+
#
|
|
1989
|
+
#
|
|
1990
|
+
#
|
|
1991
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
1992
|
+
# @return [String]
|
|
1993
|
+
#
|
|
1994
|
+
# @!attribute [rw] if_none_match
|
|
1995
|
+
# Copies the object only if the object key name at the destination
|
|
1996
|
+
# does not already exist in the bucket specified. Otherwise, Amazon S3
|
|
1997
|
+
# returns a `412 Precondition Failed` error. If a concurrent operation
|
|
1998
|
+
# occurs during the upload S3 returns a `409
|
|
1999
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
|
2000
|
+
# retry the upload.
|
|
2001
|
+
#
|
|
2002
|
+
# Expects the '*' (asterisk) character.
|
|
2003
|
+
#
|
|
2004
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
2005
|
+
#
|
|
2006
|
+
#
|
|
2007
|
+
#
|
|
2008
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
2009
|
+
# @return [String]
|
|
2010
|
+
#
|
|
1918
2011
|
# @!attribute [rw] key
|
|
1919
2012
|
# The key of the destination object.
|
|
1920
2013
|
# @return [String]
|
|
@@ -2441,6 +2534,8 @@ module Aws::S3
|
|
|
2441
2534
|
:grant_read,
|
|
2442
2535
|
:grant_read_acp,
|
|
2443
2536
|
:grant_write_acp,
|
|
2537
|
+
:if_match,
|
|
2538
|
+
:if_none_match,
|
|
2444
2539
|
:key,
|
|
2445
2540
|
:metadata,
|
|
2446
2541
|
:metadata_directive,
|
|
@@ -2502,9 +2597,9 @@ module Aws::S3
|
|
|
2502
2597
|
#
|
|
2503
2598
|
# @!attribute [rw] checksum_crc32c
|
|
2504
2599
|
# The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
|
|
2505
|
-
#
|
|
2506
|
-
# more information, see [ Checking object integrity][1] in
|
|
2507
|
-
# S3 User Guide*.
|
|
2600
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2601
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2602
|
+
# the *Amazon S3 User Guide*.
|
|
2508
2603
|
#
|
|
2509
2604
|
#
|
|
2510
2605
|
#
|
|
@@ -2525,10 +2620,10 @@ module Aws::S3
|
|
|
2525
2620
|
# @return [String]
|
|
2526
2621
|
#
|
|
2527
2622
|
# @!attribute [rw] checksum_sha1
|
|
2528
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
2529
|
-
# only
|
|
2530
|
-
# information, see [ Checking object integrity][1] in
|
|
2531
|
-
# User Guide*.
|
|
2623
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
2624
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2625
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2626
|
+
# the *Amazon S3 User Guide*.
|
|
2532
2627
|
#
|
|
2533
2628
|
#
|
|
2534
2629
|
#
|
|
@@ -2536,10 +2631,10 @@ module Aws::S3
|
|
|
2536
2631
|
# @return [String]
|
|
2537
2632
|
#
|
|
2538
2633
|
# @!attribute [rw] checksum_sha256
|
|
2539
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
2540
|
-
# only
|
|
2541
|
-
# information, see [ Checking object integrity][1] in
|
|
2542
|
-
# User Guide*.
|
|
2634
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
2635
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2636
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2637
|
+
# the *Amazon S3 User Guide*.
|
|
2543
2638
|
#
|
|
2544
2639
|
#
|
|
2545
2640
|
#
|
|
@@ -2705,6 +2800,9 @@ module Aws::S3
|
|
|
2705
2800
|
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
|
2706
2801
|
# information, see [Using tags with directory buckets][1].
|
|
2707
2802
|
#
|
|
2803
|
+
# You must have the `s3express:TagResource` permission to create a
|
|
2804
|
+
# directory bucket with tags.
|
|
2805
|
+
#
|
|
2708
2806
|
# </note>
|
|
2709
2807
|
#
|
|
2710
2808
|
#
|
|
@@ -4659,17 +4757,16 @@ module Aws::S3
|
|
|
4659
4757
|
# @return [String]
|
|
4660
4758
|
#
|
|
4661
4759
|
# @!attribute [rw] if_match
|
|
4662
|
-
#
|
|
4663
|
-
#
|
|
4664
|
-
#
|
|
4665
|
-
#
|
|
4666
|
-
# Content) response`.
|
|
4760
|
+
# Deletes the object if the ETag (entity tag) value provided during
|
|
4761
|
+
# the delete operation matches the ETag of the object in S3. If the
|
|
4762
|
+
# ETag values do not match, the operation returns a `412 Precondition
|
|
4763
|
+
# Failed` error.
|
|
4667
4764
|
#
|
|
4668
|
-
#
|
|
4765
|
+
# Expects the ETag value as a string. `If-Match` does accept a string
|
|
4766
|
+
# value of an '*' (asterisk) character to denote a match of any
|
|
4767
|
+
# ETag.
|
|
4669
4768
|
#
|
|
4670
|
-
#
|
|
4671
|
-
#
|
|
4672
|
-
# </note>
|
|
4769
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
4673
4770
|
#
|
|
4674
4771
|
#
|
|
4675
4772
|
#
|
|
@@ -8003,9 +8100,9 @@ module Aws::S3
|
|
|
8003
8100
|
#
|
|
8004
8101
|
# @!attribute [rw] checksum_crc32c
|
|
8005
8102
|
# The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
|
|
8006
|
-
#
|
|
8007
|
-
# more information, see [ Checking object integrity][1] in
|
|
8008
|
-
# S3 User Guide*.
|
|
8103
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8104
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8105
|
+
# the *Amazon S3 User Guide*.
|
|
8009
8106
|
#
|
|
8010
8107
|
#
|
|
8011
8108
|
#
|
|
@@ -8023,10 +8120,10 @@ module Aws::S3
|
|
|
8023
8120
|
# @return [String]
|
|
8024
8121
|
#
|
|
8025
8122
|
# @!attribute [rw] checksum_sha1
|
|
8026
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
8027
|
-
# only
|
|
8028
|
-
# information, see [ Checking object integrity][1] in
|
|
8029
|
-
# User Guide*.
|
|
8123
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
8124
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8125
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8126
|
+
# the *Amazon S3 User Guide*.
|
|
8030
8127
|
#
|
|
8031
8128
|
#
|
|
8032
8129
|
#
|
|
@@ -8034,10 +8131,10 @@ module Aws::S3
|
|
|
8034
8131
|
# @return [String]
|
|
8035
8132
|
#
|
|
8036
8133
|
# @!attribute [rw] checksum_sha256
|
|
8037
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
8038
|
-
# only
|
|
8039
|
-
# information, see [ Checking object integrity][1] in
|
|
8040
|
-
# User Guide*.
|
|
8134
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
8135
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8136
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8137
|
+
# the *Amazon S3 User Guide*.
|
|
8041
8138
|
#
|
|
8042
8139
|
#
|
|
8043
8140
|
#
|
|
@@ -8965,6 +9062,19 @@ module Aws::S3
|
|
|
8965
9062
|
include Aws::Structure
|
|
8966
9063
|
end
|
|
8967
9064
|
|
|
9065
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
9066
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
9067
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
9068
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
9069
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
9070
|
+
#
|
|
9071
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
9072
|
+
# East
|
|
9073
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
9074
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
9075
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
9076
|
+
# America (São Paulo) Region.
|
|
9077
|
+
#
|
|
8968
9078
|
# Container for the person being granted permissions.
|
|
8969
9079
|
#
|
|
8970
9080
|
# @!attribute [rw] display_name
|
|
@@ -9240,7 +9350,7 @@ module Aws::S3
|
|
|
9240
9350
|
#
|
|
9241
9351
|
# @!attribute [rw] checksum_crc32
|
|
9242
9352
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
9243
|
-
# checksum is only
|
|
9353
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9244
9354
|
# object. When you use an API operation on an object that was uploaded
|
|
9245
9355
|
# using multipart uploads, this value may not be a direct checksum
|
|
9246
9356
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -9279,14 +9389,15 @@ module Aws::S3
|
|
|
9279
9389
|
# @return [String]
|
|
9280
9390
|
#
|
|
9281
9391
|
# @!attribute [rw] checksum_sha1
|
|
9282
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
9283
|
-
# only
|
|
9284
|
-
# use the API operation on an object that was
|
|
9285
|
-
# uploads, this value may not be a direct
|
|
9286
|
-
# object. Instead, it's a calculation
|
|
9287
|
-
# each individual part. For more
|
|
9288
|
-
#
|
|
9289
|
-
# integrity][1] in the *Amazon S3 User
|
|
9392
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
9393
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9394
|
+
# object. When you use the API operation on an object that was
|
|
9395
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
9396
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
9397
|
+
# based on the checksum values of each individual part. For more
|
|
9398
|
+
# information about how checksums are calculated with multipart
|
|
9399
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
9400
|
+
# Guide*.
|
|
9290
9401
|
#
|
|
9291
9402
|
#
|
|
9292
9403
|
#
|
|
@@ -9294,14 +9405,14 @@ module Aws::S3
|
|
|
9294
9405
|
# @return [String]
|
|
9295
9406
|
#
|
|
9296
9407
|
# @!attribute [rw] checksum_sha256
|
|
9297
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
9298
|
-
# only
|
|
9299
|
-
# use an API operation on an object that was uploaded
|
|
9300
|
-
# uploads, this value may not be a direct checksum
|
|
9301
|
-
# object. Instead, it's a calculation based on the
|
|
9302
|
-
# each individual part. For more information about
|
|
9303
|
-
# calculated with multipart uploads, see [ Checking
|
|
9304
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
9408
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
9409
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9410
|
+
# object. When you use an API operation on an object that was uploaded
|
|
9411
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
9412
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
9413
|
+
# checksum values of each individual part. For more information about
|
|
9414
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
9415
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
9305
9416
|
#
|
|
9306
9417
|
#
|
|
9307
9418
|
#
|
|
@@ -10700,8 +10811,10 @@ module Aws::S3
|
|
|
10700
10811
|
# @return [String]
|
|
10701
10812
|
#
|
|
10702
10813
|
# @!attribute [rw] prefix
|
|
10703
|
-
#
|
|
10704
|
-
#
|
|
10814
|
+
# The general purpose bucket prefix that identifies one or more
|
|
10815
|
+
# objects to which the rule applies. We recommend using `Filter`
|
|
10816
|
+
# instead of `Prefix` for new PUTs. Previous configurations where a
|
|
10817
|
+
# prefix is defined will continue to operate as before.
|
|
10705
10818
|
#
|
|
10706
10819
|
# Replacement must be made for object keys containing special
|
|
10707
10820
|
# characters (such as carriage returns) when using XML requests. For
|
|
@@ -13817,11 +13930,11 @@ module Aws::S3
|
|
|
13817
13930
|
include Aws::Structure
|
|
13818
13931
|
end
|
|
13819
13932
|
|
|
13820
|
-
# End of support notice: Beginning
|
|
13821
|
-
# returning `DisplayName`. Update your applications to use
|
|
13822
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
13823
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13824
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
13933
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
13934
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
13935
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
13936
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13937
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
13825
13938
|
#
|
|
13826
13939
|
# This change affects the following Amazon Web Services Regions: US
|
|
13827
13940
|
# East
|
|
@@ -15273,7 +15386,17 @@ module Aws::S3
|
|
|
15273
15386
|
# @!attribute [rw] mfa
|
|
15274
15387
|
# The concatenation of the authentication device's serial number, a
|
|
15275
15388
|
# space, and the value that is displayed on your authentication
|
|
15276
|
-
# device.
|
|
15389
|
+
# device. The serial number is the number that uniquely identifies the
|
|
15390
|
+
# MFA device. For physical MFA devices, this is the unique serial
|
|
15391
|
+
# number that's provided with the device. For virtual MFA devices,
|
|
15392
|
+
# the serial number is the device ARN. For more information, see
|
|
15393
|
+
# [Enabling versioning on buckets][1] and [Configuring MFA delete][2]
|
|
15394
|
+
# in the *Amazon Simple Storage Service User Guide*.
|
|
15395
|
+
#
|
|
15396
|
+
#
|
|
15397
|
+
#
|
|
15398
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
|
|
15399
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
|
|
15277
15400
|
# @return [String]
|
|
15278
15401
|
#
|
|
15279
15402
|
# @!attribute [rw] versioning_configuration
|
|
@@ -15809,7 +15932,7 @@ module Aws::S3
|
|
|
15809
15932
|
#
|
|
15810
15933
|
# @!attribute [rw] checksum_crc32
|
|
15811
15934
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
15812
|
-
# checksum is only
|
|
15935
|
+
# checksum is only present if the checksum was uploaded with the
|
|
15813
15936
|
# object. When you use an API operation on an object that was uploaded
|
|
15814
15937
|
# using multipart uploads, this value may not be a direct checksum
|
|
15815
15938
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -15852,14 +15975,15 @@ module Aws::S3
|
|
|
15852
15975
|
# @return [String]
|
|
15853
15976
|
#
|
|
15854
15977
|
# @!attribute [rw] checksum_sha1
|
|
15855
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
15856
|
-
# only
|
|
15857
|
-
# use the API operation on an object that was
|
|
15858
|
-
# uploads, this value may not be a direct
|
|
15859
|
-
# object. Instead, it's a calculation
|
|
15860
|
-
# each individual part. For more
|
|
15861
|
-
#
|
|
15862
|
-
# integrity][1] in the *Amazon S3 User
|
|
15978
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
15979
|
+
# checksum is only present if the checksum was uploaded with the
|
|
15980
|
+
# object. When you use the API operation on an object that was
|
|
15981
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
15982
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
15983
|
+
# based on the checksum values of each individual part. For more
|
|
15984
|
+
# information about how checksums are calculated with multipart
|
|
15985
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
15986
|
+
# Guide*.
|
|
15863
15987
|
#
|
|
15864
15988
|
#
|
|
15865
15989
|
#
|
|
@@ -15867,14 +15991,14 @@ module Aws::S3
|
|
|
15867
15991
|
# @return [String]
|
|
15868
15992
|
#
|
|
15869
15993
|
# @!attribute [rw] checksum_sha256
|
|
15870
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
15871
|
-
# only
|
|
15872
|
-
# use an API operation on an object that was uploaded
|
|
15873
|
-
# uploads, this value may not be a direct checksum
|
|
15874
|
-
# object. Instead, it's a calculation based on the
|
|
15875
|
-
# each individual part. For more information about
|
|
15876
|
-
# calculated with multipart uploads, see [ Checking
|
|
15877
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
15994
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
15995
|
+
# checksum is only present if the checksum was uploaded with the
|
|
15996
|
+
# object. When you use an API operation on an object that was uploaded
|
|
15997
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
15998
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
15999
|
+
# checksum values of each individual part. For more information about
|
|
16000
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
16001
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
15878
16002
|
#
|
|
15879
16003
|
#
|
|
15880
16004
|
#
|
|
@@ -16990,21 +17114,9 @@ module Aws::S3
|
|
|
16990
17114
|
# @return [String]
|
|
16991
17115
|
#
|
|
16992
17116
|
# @!attribute [rw] request_payer
|
|
16993
|
-
# Confirms that the requester knows that
|
|
16994
|
-
# request. Bucket owners need not specify this
|
|
16995
|
-
#
|
|
16996
|
-
# Requester Pays enabled, the requester will pay for corresponding
|
|
16997
|
-
# charges to copy the object. For information about downloading
|
|
16998
|
-
# objects from Requester Pays buckets, see [Downloading Objects in
|
|
16999
|
-
# Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
|
|
17000
|
-
#
|
|
17001
|
-
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
17002
|
-
#
|
|
17003
|
-
# </note>
|
|
17004
|
-
#
|
|
17005
|
-
#
|
|
17006
|
-
#
|
|
17007
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
|
17117
|
+
# Confirms that the requester knows that she or he will be charged for
|
|
17118
|
+
# the tagging object request. Bucket owners need not specify this
|
|
17119
|
+
# parameter in their requests.
|
|
17008
17120
|
# @return [String]
|
|
17009
17121
|
#
|
|
17010
17122
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTaggingRequest AWS API Documentation
|
|
@@ -18690,11 +18802,36 @@ module Aws::S3
|
|
|
18690
18802
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
|
18691
18803
|
# @return [Boolean]
|
|
18692
18804
|
#
|
|
18805
|
+
# @!attribute [rw] blocked_encryption_types
|
|
18806
|
+
# A bucket-level setting for Amazon S3 general purpose buckets used to
|
|
18807
|
+
# prevent the upload of new objects encrypted with the specified
|
|
18808
|
+
# server-side encryption type. For example, blocking an encryption
|
|
18809
|
+
# type will block `PutObject`, `CopyObject`, `PostObject`, multipart
|
|
18810
|
+
# upload, and replication requests to the bucket for objects with the
|
|
18811
|
+
# specified encryption type. However, you can continue to read and
|
|
18812
|
+
# list any pre-existing objects already encrypted with the specified
|
|
18813
|
+
# encryption type. For more information, see [Blocking an encryption
|
|
18814
|
+
# type for a general purpose bucket][1].
|
|
18815
|
+
#
|
|
18816
|
+
# <note markdown="1"> Currently, this parameter only supports blocking or unblocking
|
|
18817
|
+
# Server Side Encryption with Customer Provided Keys (SSE-C). For more
|
|
18818
|
+
# information about SSE-C, see [Using server-side encryption with
|
|
18819
|
+
# customer-provided keys (SSE-C)][2].
|
|
18820
|
+
#
|
|
18821
|
+
# </note>
|
|
18822
|
+
#
|
|
18823
|
+
#
|
|
18824
|
+
#
|
|
18825
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/userguide/block-encryption-type.html
|
|
18826
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
|
18827
|
+
# @return [Types::BlockedEncryptionTypes]
|
|
18828
|
+
#
|
|
18693
18829
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ServerSideEncryptionRule AWS API Documentation
|
|
18694
18830
|
#
|
|
18695
18831
|
class ServerSideEncryptionRule < Struct.new(
|
|
18696
18832
|
:apply_server_side_encryption_by_default,
|
|
18697
|
-
:bucket_key_enabled
|
|
18833
|
+
:bucket_key_enabled,
|
|
18834
|
+
:blocked_encryption_types)
|
|
18698
18835
|
SENSITIVE = []
|
|
18699
18836
|
include Aws::Structure
|
|
18700
18837
|
end
|
|
@@ -19648,7 +19785,7 @@ module Aws::S3
|
|
|
19648
19785
|
#
|
|
19649
19786
|
# @!attribute [rw] checksum_crc32
|
|
19650
19787
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
19651
|
-
# checksum is only
|
|
19788
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19652
19789
|
# object. When you use an API operation on an object that was uploaded
|
|
19653
19790
|
# using multipart uploads, this value may not be a direct checksum
|
|
19654
19791
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -19689,14 +19826,15 @@ module Aws::S3
|
|
|
19689
19826
|
# @return [String]
|
|
19690
19827
|
#
|
|
19691
19828
|
# @!attribute [rw] checksum_sha1
|
|
19692
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
19693
|
-
# only
|
|
19694
|
-
# use the API operation on an object that was
|
|
19695
|
-
# uploads, this value may not be a direct
|
|
19696
|
-
# object. Instead, it's a calculation
|
|
19697
|
-
# each individual part. For more
|
|
19698
|
-
#
|
|
19699
|
-
# integrity][1] in the *Amazon S3 User
|
|
19829
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
19830
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19831
|
+
# object. When you use the API operation on an object that was
|
|
19832
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
19833
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
19834
|
+
# based on the checksum values of each individual part. For more
|
|
19835
|
+
# information about how checksums are calculated with multipart
|
|
19836
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
19837
|
+
# Guide*.
|
|
19700
19838
|
#
|
|
19701
19839
|
#
|
|
19702
19840
|
#
|
|
@@ -19704,14 +19842,14 @@ module Aws::S3
|
|
|
19704
19842
|
# @return [String]
|
|
19705
19843
|
#
|
|
19706
19844
|
# @!attribute [rw] checksum_sha256
|
|
19707
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
19708
|
-
# only
|
|
19709
|
-
# use an API operation on an object that was uploaded
|
|
19710
|
-
# uploads, this value may not be a direct checksum
|
|
19711
|
-
# object. Instead, it's a calculation based on the
|
|
19712
|
-
# each individual part. For more information about
|
|
19713
|
-
# calculated with multipart uploads, see [ Checking
|
|
19714
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
19845
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
19846
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19847
|
+
# object. When you use an API operation on an object that was uploaded
|
|
19848
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
19849
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
19850
|
+
# checksum values of each individual part. For more information about
|
|
19851
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
19852
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
19715
19853
|
#
|
|
19716
19854
|
#
|
|
19717
19855
|
#
|