aws-sdk-s3 1.176.1 → 1.183.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 (54) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +37 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +43 -31
  5. data/lib/aws-sdk-s3/bucket_acl.rb +6 -5
  6. data/lib/aws-sdk-s3/bucket_cors.rb +6 -5
  7. data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
  8. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
  9. data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
  10. data/lib/aws-sdk-s3/bucket_policy.rb +6 -5
  11. data/lib/aws-sdk-s3/bucket_request_payment.rb +3 -3
  12. data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
  13. data/lib/aws-sdk-s3/bucket_versioning.rb +9 -9
  14. data/lib/aws-sdk-s3/bucket_website.rb +3 -3
  15. data/lib/aws-sdk-s3/client.rb +1066 -862
  16. data/lib/aws-sdk-s3/client_api.rb +35 -2
  17. data/lib/aws-sdk-s3/endpoint_provider.rb +369 -281
  18. data/lib/aws-sdk-s3/file_downloader.rb +4 -21
  19. data/lib/aws-sdk-s3/multipart_file_uploader.rb +31 -13
  20. data/lib/aws-sdk-s3/multipart_upload.rb +50 -6
  21. data/lib/aws-sdk-s3/multipart_upload_part.rb +50 -34
  22. data/lib/aws-sdk-s3/object.rb +159 -113
  23. data/lib/aws-sdk-s3/object_acl.rb +4 -4
  24. data/lib/aws-sdk-s3/object_summary.rb +107 -83
  25. data/lib/aws-sdk-s3/object_version.rb +18 -14
  26. data/lib/aws-sdk-s3/plugins/checksum_algorithm.rb +31 -0
  27. data/lib/aws-sdk-s3/plugins/express_session_auth.rb +11 -20
  28. data/lib/aws-sdk-s3/plugins/md5s.rb +10 -71
  29. data/lib/aws-sdk-s3/presigner.rb +4 -5
  30. data/lib/aws-sdk-s3/resource.rb +1 -1
  31. data/lib/aws-sdk-s3/types.rb +1259 -820
  32. data/lib/aws-sdk-s3.rb +1 -1
  33. data/sig/bucket.rbs +4 -3
  34. data/sig/bucket_acl.rbs +1 -1
  35. data/sig/bucket_cors.rbs +1 -1
  36. data/sig/bucket_lifecycle.rbs +1 -1
  37. data/sig/bucket_lifecycle_configuration.rbs +1 -1
  38. data/sig/bucket_logging.rbs +1 -1
  39. data/sig/bucket_policy.rbs +1 -1
  40. data/sig/bucket_request_payment.rbs +1 -1
  41. data/sig/bucket_tagging.rbs +1 -1
  42. data/sig/bucket_versioning.rbs +3 -3
  43. data/sig/bucket_website.rbs +1 -1
  44. data/sig/client.rbs +53 -31
  45. data/sig/multipart_upload.rbs +8 -1
  46. data/sig/multipart_upload_part.rbs +5 -1
  47. data/sig/object.rbs +16 -5
  48. data/sig/object_acl.rbs +1 -1
  49. data/sig/object_summary.rbs +11 -6
  50. data/sig/object_version.rbs +5 -2
  51. data/sig/resource.rbs +3 -1
  52. data/sig/types.rbs +64 -34
  53. metadata +5 -5
  54. data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +0 -31
@@ -59,34 +59,36 @@ module Aws::S3
59
59
  # requests are not supported. Directory bucket names must be unique in
60
60
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
61
61
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
62
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
62
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
63
63
  # naming restrictions, see [Directory bucket naming rules][1] in the
64
64
  # *Amazon S3 User Guide*.
65
65
  #
66
- # **Access points** - When you use this action with an access point,
67
- # you must provide the alias of the access point in place of the
68
- # bucket name or specify the access point ARN. When using the access
69
- # point ARN, you must direct requests to the access point hostname.
70
- # The access point hostname takes the form
66
+ # **Access points** - When you use this action with an access point
67
+ # for general purpose buckets, you must provide the alias of the
68
+ # access point in place of the bucket name or specify the access point
69
+ # ARN. When you use this action with an access point for directory
70
+ # buckets, you must provide the access point name in place of the
71
+ # bucket name. When using the access point ARN, you must direct
72
+ # requests to the access point hostname. The access point hostname
73
+ # takes the form
71
74
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
72
75
  # When using this action with an access point through the Amazon Web
73
76
  # Services SDKs, you provide the access point ARN in place of the
74
77
  # bucket name. For more information about access point ARNs, see
75
78
  # [Using access points][2] in the *Amazon S3 User Guide*.
76
79
  #
77
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
78
- # directory buckets.
80
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
79
81
  #
80
82
  # </note>
81
83
  #
82
- # **S3 on Outposts** - When you use this action with Amazon S3 on
83
- # Outposts, you must direct requests to the S3 on Outposts hostname.
84
- # The S3 on Outposts hostname takes the form `
84
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
85
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
86
+ # Outposts hostname takes the form `
85
87
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
86
- # When you use this action with S3 on Outposts through the Amazon Web
87
- # Services SDKs, you provide the Outposts access point ARN in place of
88
- # the bucket name. For more information about S3 on Outposts ARNs, see
89
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
88
+ # When you use this action with S3 on Outposts, the destination bucket
89
+ # must be the Outposts access point ARN or the access point alias. For
90
+ # more information about S3 on Outposts, see [What is S3 on
91
+ # Outposts?][3] in the *Amazon S3 User Guide*.
90
92
  #
91
93
  #
92
94
  #
@@ -655,14 +657,14 @@ module Aws::S3
655
657
  # Contains all the possible checksum or digest values for an object.
656
658
  #
657
659
  # @!attribute [rw] checksum_crc32
658
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
659
- # only be present if it was uploaded with the object. When you use an
660
- # API operation on an object that was uploaded using multipart
661
- # uploads, this value may not be a direct checksum value of the full
662
- # object. Instead, it's a calculation based on the checksum values of
663
- # each individual part. For more information about how checksums are
664
- # calculated with multipart uploads, see [ Checking object
665
- # integrity][1] in the *Amazon S3 User Guide*.
660
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
661
+ # checksum is only be present if the checksum was uploaded with the
662
+ # object. When you use an API operation on an object that was uploaded
663
+ # using multipart uploads, this value may not be a direct checksum
664
+ # value of the full object. Instead, it's a calculation based on the
665
+ # checksum values of each individual part. For more information about
666
+ # how checksums are calculated with multipart uploads, see [ Checking
667
+ # object integrity][1] in the *Amazon S3 User Guide*.
666
668
  #
667
669
  #
668
670
  #
@@ -670,24 +672,37 @@ module Aws::S3
670
672
  # @return [String]
671
673
  #
672
674
  # @!attribute [rw] checksum_crc32c
673
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
674
- # only be present if it was uploaded with the object. When you use an
675
- # API operation on an object that was uploaded using multipart
676
- # uploads, this value may not be a direct checksum value of the full
677
- # object. Instead, it's a calculation based on the checksum values of
678
- # each individual part. For more information about how checksums are
679
- # calculated with multipart uploads, see [ Checking object
680
- # integrity][1] in the *Amazon S3 User Guide*.
675
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
676
+ # checksum is only present if the checksum was uploaded with the
677
+ # object. When you use an API operation on an object that was uploaded
678
+ # using multipart uploads, this value may not be a direct checksum
679
+ # value of the full object. Instead, it's a calculation based on the
680
+ # checksum values of each individual part. For more information about
681
+ # how checksums are calculated with multipart uploads, see [ Checking
682
+ # object integrity][1] in the *Amazon S3 User Guide*.
681
683
  #
682
684
  #
683
685
  #
684
686
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
685
687
  # @return [String]
686
688
  #
689
+ # @!attribute [rw] checksum_crc64nvme
690
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
691
+ # checksum is present if the object was uploaded with the `CRC64NVME`
692
+ # checksum algorithm, or if the object was uploaded without a checksum
693
+ # (and Amazon S3 added the default checksum, `CRC64NVME`, to the
694
+ # uploaded object). For more information, see [Checking object
695
+ # integrity][1] in the *Amazon S3 User Guide*.
696
+ #
697
+ #
698
+ #
699
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
700
+ # @return [String]
701
+ #
687
702
  # @!attribute [rw] checksum_sha1
688
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
689
- # only be present if it was uploaded with the object. When you use the
690
- # API operation on an object that was uploaded using multipart
703
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
704
+ # only be present if the object was uploaded with the object. When you
705
+ # use the API operation on an object that was uploaded using multipart
691
706
  # uploads, this value may not be a direct checksum value of the full
692
707
  # object. Instead, it's a calculation based on the checksum values of
693
708
  # each individual part. For more information about how checksums are
@@ -700,9 +715,9 @@ module Aws::S3
700
715
  # @return [String]
701
716
  #
702
717
  # @!attribute [rw] checksum_sha256
703
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
704
- # only be present if it was uploaded with the object. When you use an
705
- # API operation on an object that was uploaded using multipart
718
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
719
+ # only be present if the object was uploaded with the object. When you
720
+ # use an API operation on an object that was uploaded using multipart
706
721
  # uploads, this value may not be a direct checksum value of the full
707
722
  # object. Instead, it's a calculation based on the checksum values of
708
723
  # each individual part. For more information about how checksums are
@@ -714,13 +729,25 @@ module Aws::S3
714
729
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
715
730
  # @return [String]
716
731
  #
732
+ # @!attribute [rw] checksum_type
733
+ # The checksum type that is used to calculate the object’s checksum
734
+ # value. For more information, see [Checking object integrity][1] in
735
+ # the *Amazon S3 User Guide*.
736
+ #
737
+ #
738
+ #
739
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
740
+ # @return [String]
741
+ #
717
742
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Checksum AWS API Documentation
718
743
  #
719
744
  class Checksum < Struct.new(
720
745
  :checksum_crc32,
721
746
  :checksum_crc32c,
747
+ :checksum_crc64nvme,
722
748
  :checksum_sha1,
723
- :checksum_sha256)
749
+ :checksum_sha256,
750
+ :checksum_type)
724
751
  SENSITIVE = []
725
752
  include Aws::Structure
726
753
  end
@@ -824,14 +851,14 @@ module Aws::S3
824
851
  # @return [String]
825
852
  #
826
853
  # @!attribute [rw] checksum_crc32
827
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
828
- # only be present if it was uploaded with the object. When you use an
829
- # API operation on an object that was uploaded using multipart
830
- # uploads, this value may not be a direct checksum value of the full
831
- # object. Instead, it's a calculation based on the checksum values of
832
- # each individual part. For more information about how checksums are
833
- # calculated with multipart uploads, see [ Checking object
834
- # integrity][1] in the *Amazon S3 User Guide*.
854
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
855
+ # checksum is only be present if the checksum was uploaded with the
856
+ # object. When you use an API operation on an object that was uploaded
857
+ # using multipart uploads, this value may not be a direct checksum
858
+ # value of the full object. Instead, it's a calculation based on the
859
+ # checksum values of each individual part. For more information about
860
+ # how checksums are calculated with multipart uploads, see [ Checking
861
+ # object integrity][1] in the *Amazon S3 User Guide*.
835
862
  #
836
863
  #
837
864
  #
@@ -839,24 +866,37 @@ module Aws::S3
839
866
  # @return [String]
840
867
  #
841
868
  # @!attribute [rw] checksum_crc32c
842
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
843
- # only be present if it was uploaded with the object. When you use an
844
- # API operation on an object that was uploaded using multipart
845
- # uploads, this value may not be a direct checksum value of the full
846
- # object. Instead, it's a calculation based on the checksum values of
847
- # each individual part. For more information about how checksums are
848
- # calculated with multipart uploads, see [ Checking object
849
- # integrity][1] in the *Amazon S3 User Guide*.
869
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
870
+ # checksum is only present if the checksum was uploaded with the
871
+ # object. When you use an API operation on an object that was uploaded
872
+ # using multipart uploads, this value may not be a direct checksum
873
+ # value of the full object. Instead, it's a calculation based on the
874
+ # checksum values of each individual part. For more information about
875
+ # how checksums are calculated with multipart uploads, see [ Checking
876
+ # object integrity][1] in the *Amazon S3 User Guide*.
850
877
  #
851
878
  #
852
879
  #
853
880
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
854
881
  # @return [String]
855
882
  #
883
+ # @!attribute [rw] checksum_crc64nvme
884
+ # This header can be used as a data integrity check to verify that the
885
+ # data received is the same data that was originally sent. This header
886
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
887
+ # object. The `CRC64NVME` checksum is always a full object checksum.
888
+ # For more information, see [Checking object integrity in the Amazon
889
+ # S3 User Guide][1].
890
+ #
891
+ #
892
+ #
893
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
894
+ # @return [String]
895
+ #
856
896
  # @!attribute [rw] checksum_sha1
857
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
858
- # only be present if it was uploaded with the object. When you use the
859
- # API operation on an object that was uploaded using multipart
897
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
898
+ # only be present if the object was uploaded with the object. When you
899
+ # use the API operation on an object that was uploaded using multipart
860
900
  # uploads, this value may not be a direct checksum value of the full
861
901
  # object. Instead, it's a calculation based on the checksum values of
862
902
  # each individual part. For more information about how checksums are
@@ -869,9 +909,9 @@ module Aws::S3
869
909
  # @return [String]
870
910
  #
871
911
  # @!attribute [rw] checksum_sha256
872
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
873
- # only be present if it was uploaded with the object. When you use an
874
- # API operation on an object that was uploaded using multipart
912
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
913
+ # only be present if the object was uploaded with the object. When you
914
+ # use an API operation on an object that was uploaded using multipart
875
915
  # uploads, this value may not be a direct checksum value of the full
876
916
  # object. Instead, it's a calculation based on the checksum values of
877
917
  # each individual part. For more information about how checksums are
@@ -883,6 +923,20 @@ module Aws::S3
883
923
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
884
924
  # @return [String]
885
925
  #
926
+ # @!attribute [rw] checksum_type
927
+ # The checksum type, which determines how part-level checksums are
928
+ # combined to create an object-level checksum for multipart objects.
929
+ # You can use this header as a data integrity check to verify that the
930
+ # checksum type that is received is the same checksum type that was
931
+ # specified during the `CreateMultipartUpload` request. For more
932
+ # information, see [Checking object integrity in the Amazon S3 User
933
+ # Guide][1].
934
+ #
935
+ #
936
+ #
937
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
938
+ # @return [String]
939
+ #
886
940
  # @!attribute [rw] server_side_encryption
887
941
  # The server-side encryption algorithm used when storing this object
888
942
  # in Amazon S3 (for example, `AES256`, `aws:kms`).
@@ -927,8 +981,10 @@ module Aws::S3
927
981
  :etag,
928
982
  :checksum_crc32,
929
983
  :checksum_crc32c,
984
+ :checksum_crc64nvme,
930
985
  :checksum_sha1,
931
986
  :checksum_sha256,
987
+ :checksum_type,
932
988
  :server_side_encryption,
933
989
  :version_id,
934
990
  :ssekms_key_id,
@@ -947,34 +1003,36 @@ module Aws::S3
947
1003
  # requests are not supported. Directory bucket names must be unique in
948
1004
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
949
1005
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
950
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1006
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
951
1007
  # naming restrictions, see [Directory bucket naming rules][1] in the
952
1008
  # *Amazon S3 User Guide*.
953
1009
  #
954
- # **Access points** - When you use this action with an access point,
955
- # you must provide the alias of the access point in place of the
956
- # bucket name or specify the access point ARN. When using the access
957
- # point ARN, you must direct requests to the access point hostname.
958
- # The access point hostname takes the form
1010
+ # **Access points** - When you use this action with an access point
1011
+ # for general purpose buckets, you must provide the alias of the
1012
+ # access point in place of the bucket name or specify the access point
1013
+ # ARN. When you use this action with an access point for directory
1014
+ # buckets, you must provide the access point name in place of the
1015
+ # bucket name. When using the access point ARN, you must direct
1016
+ # requests to the access point hostname. The access point hostname
1017
+ # takes the form
959
1018
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
960
1019
  # When using this action with an access point through the Amazon Web
961
1020
  # Services SDKs, you provide the access point ARN in place of the
962
1021
  # bucket name. For more information about access point ARNs, see
963
1022
  # [Using access points][2] in the *Amazon S3 User Guide*.
964
1023
  #
965
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
966
- # directory buckets.
1024
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
967
1025
  #
968
1026
  # </note>
969
1027
  #
970
- # **S3 on Outposts** - When you use this action with Amazon S3 on
971
- # Outposts, you must direct requests to the S3 on Outposts hostname.
972
- # The S3 on Outposts hostname takes the form `
1028
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1029
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
1030
+ # Outposts hostname takes the form `
973
1031
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
974
- # When you use this action with S3 on Outposts through the Amazon Web
975
- # Services SDKs, you provide the Outposts access point ARN in place of
976
- # the bucket name. For more information about S3 on Outposts ARNs, see
977
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1032
+ # When you use this action with S3 on Outposts, the destination bucket
1033
+ # must be the Outposts access point ARN or the access point alias. For
1034
+ # more information about S3 on Outposts, see [What is S3 on
1035
+ # Outposts?][3] in the *Amazon S3 User Guide*.
978
1036
  #
979
1037
  #
980
1038
  #
@@ -998,7 +1056,7 @@ module Aws::S3
998
1056
  # @!attribute [rw] checksum_crc32
999
1057
  # This header can be used as a data integrity check to verify that the
1000
1058
  # data received is the same data that was originally sent. This header
1001
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
1059
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
1002
1060
  # For more information, see [Checking object integrity][1] in the
1003
1061
  # *Amazon S3 User Guide*.
1004
1062
  #
@@ -1010,9 +1068,22 @@ module Aws::S3
1010
1068
  # @!attribute [rw] checksum_crc32c
1011
1069
  # This header can be used as a data integrity check to verify that the
1012
1070
  # data received is the same data that was originally sent. This header
1013
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
1014
- # For more information, see [Checking object integrity][1] in the
1015
- # *Amazon S3 User Guide*.
1071
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
1072
+ # object. For more information, see [Checking object integrity][1] in
1073
+ # the *Amazon S3 User Guide*.
1074
+ #
1075
+ #
1076
+ #
1077
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1078
+ # @return [String]
1079
+ #
1080
+ # @!attribute [rw] checksum_crc64nvme
1081
+ # This header can be used as a data integrity check to verify that the
1082
+ # data received is the same data that was originally sent. This header
1083
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
1084
+ # object. The `CRC64NVME` checksum is always a full object checksum.
1085
+ # For more information, see [Checking object integrity in the Amazon
1086
+ # S3 User Guide][1].
1016
1087
  #
1017
1088
  #
1018
1089
  #
@@ -1022,7 +1093,7 @@ module Aws::S3
1022
1093
  # @!attribute [rw] checksum_sha1
1023
1094
  # This header can be used as a data integrity check to verify that the
1024
1095
  # data received is the same data that was originally sent. This header
1025
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object.
1096
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
1026
1097
  # For more information, see [Checking object integrity][1] in the
1027
1098
  # *Amazon S3 User Guide*.
1028
1099
  #
@@ -1034,7 +1105,7 @@ module Aws::S3
1034
1105
  # @!attribute [rw] checksum_sha256
1035
1106
  # This header can be used as a data integrity check to verify that the
1036
1107
  # data received is the same data that was originally sent. This header
1037
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
1108
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
1038
1109
  # For more information, see [Checking object integrity][1] in the
1039
1110
  # *Amazon S3 User Guide*.
1040
1111
  #
@@ -1043,6 +1114,25 @@ module Aws::S3
1043
1114
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1044
1115
  # @return [String]
1045
1116
  #
1117
+ # @!attribute [rw] checksum_type
1118
+ # This header specifies the checksum type of the object, which
1119
+ # determines how part-level checksums are combined to create an
1120
+ # object-level checksum for multipart objects. You can use this header
1121
+ # as a data integrity check to verify that the checksum type that is
1122
+ # received is the same checksum that was specified. If the checksum
1123
+ # type doesn’t match the checksum type that was specified for the
1124
+ # object during the `CreateMultipartUpload` request, it’ll result in a
1125
+ # `BadDigest` error. For more information, see Checking object
1126
+ # integrity in the Amazon S3 User Guide.
1127
+ # @return [String]
1128
+ #
1129
+ # @!attribute [rw] mpu_object_size
1130
+ # The expected total object size of the multipart upload request. If
1131
+ # there’s a mismatch between the specified object size value and the
1132
+ # actual object size value, it results in an `HTTP 400 InvalidRequest`
1133
+ # error.
1134
+ # @return [Integer]
1135
+ #
1046
1136
  # @!attribute [rw] request_payer
1047
1137
  # Confirms that the requester knows that they will be charged for the
1048
1138
  # request. Bucket owners need not specify this parameter in their
@@ -1166,8 +1256,11 @@ module Aws::S3
1166
1256
  :upload_id,
1167
1257
  :checksum_crc32,
1168
1258
  :checksum_crc32c,
1259
+ :checksum_crc64nvme,
1169
1260
  :checksum_sha1,
1170
1261
  :checksum_sha256,
1262
+ :checksum_type,
1263
+ :mpu_object_size,
1171
1264
  :request_payer,
1172
1265
  :expected_bucket_owner,
1173
1266
  :if_match,
@@ -1203,63 +1296,59 @@ module Aws::S3
1203
1296
  # @return [String]
1204
1297
  #
1205
1298
  # @!attribute [rw] checksum_crc32
1206
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
1207
- # only be present if it was uploaded with the object. When you use an
1208
- # API operation on an object that was uploaded using multipart
1209
- # uploads, this value may not be a direct checksum value of the full
1210
- # object. Instead, it's a calculation based on the checksum values of
1211
- # each individual part. For more information about how checksums are
1212
- # calculated with multipart uploads, see [ Checking object
1213
- # integrity][1] in the *Amazon S3 User Guide*.
1299
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
1300
+ # checksum is present if the multipart upload request was created with
1301
+ # the `CRC32` checksum algorithm. For more information, see [Checking
1302
+ # object integrity][1] in the *Amazon S3 User Guide*.
1214
1303
  #
1215
1304
  #
1216
1305
  #
1217
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
1306
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1218
1307
  # @return [String]
1219
1308
  #
1220
1309
  # @!attribute [rw] checksum_crc32c
1221
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
1222
- # only be present if it was uploaded with the object. When you use an
1223
- # API operation on an object that was uploaded using multipart
1224
- # uploads, this value may not be a direct checksum value of the full
1225
- # object. Instead, it's a calculation based on the checksum values of
1226
- # each individual part. For more information about how checksums are
1227
- # calculated with multipart uploads, see [ Checking object
1228
- # integrity][1] in the *Amazon S3 User Guide*.
1310
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
1311
+ # checksum is present if the multipart upload request was created with
1312
+ # the `CRC32C` checksum algorithm. For more information, see [Checking
1313
+ # object integrity][1] in the *Amazon S3 User Guide*.
1229
1314
  #
1230
1315
  #
1231
1316
  #
1232
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
1317
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1318
+ # @return [String]
1319
+ #
1320
+ # @!attribute [rw] checksum_crc64nvme
1321
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
1322
+ # checksum is present if the multipart upload request was created with
1323
+ # the `CRC64NVME` checksum algorithm to the uploaded object). For more
1324
+ # information, see [Checking object integrity][1] in the *Amazon S3
1325
+ # User Guide*.
1326
+ #
1327
+ #
1328
+ #
1329
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1233
1330
  # @return [String]
1234
1331
  #
1235
1332
  # @!attribute [rw] checksum_sha1
1236
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
1237
- # only be present if it was uploaded with the object. When you use the
1238
- # API operation on an object that was uploaded using multipart
1239
- # uploads, this value may not be a direct checksum value of the full
1240
- # object. Instead, it's a calculation based on the checksum values of
1241
- # each individual part. For more information about how checksums are
1242
- # calculated with multipart uploads, see [ Checking object
1243
- # integrity][1] in the *Amazon S3 User Guide*.
1333
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
1334
+ # checksum is present if the multipart upload request was created with
1335
+ # the `SHA1` checksum algorithm. For more information, see [Checking
1336
+ # object integrity][1] in the *Amazon S3 User Guide*.
1244
1337
  #
1245
1338
  #
1246
1339
  #
1247
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
1340
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1248
1341
  # @return [String]
1249
1342
  #
1250
1343
  # @!attribute [rw] checksum_sha256
1251
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
1252
- # only be present if it was uploaded with the object. When you use an
1253
- # API operation on an object that was uploaded using multipart
1254
- # uploads, this value may not be a direct checksum value of the full
1255
- # object. Instead, it's a calculation based on the checksum values of
1256
- # each individual part. For more information about how checksums are
1257
- # calculated with multipart uploads, see [ Checking object
1258
- # integrity][1] in the *Amazon S3 User Guide*.
1344
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
1345
+ # checksum is present if the multipart upload request was created with
1346
+ # the `SHA256` checksum algorithm. For more information, see [Checking
1347
+ # object integrity][1] in the *Amazon S3 User Guide*.
1259
1348
  #
1260
1349
  #
1261
1350
  #
1262
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
1351
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1263
1352
  # @return [String]
1264
1353
  #
1265
1354
  # @!attribute [rw] part_number
@@ -1287,6 +1376,7 @@ module Aws::S3
1287
1376
  :etag,
1288
1377
  :checksum_crc32,
1289
1378
  :checksum_crc32c,
1379
+ :checksum_crc64nvme,
1290
1380
  :checksum_sha1,
1291
1381
  :checksum_sha256,
1292
1382
  :part_number)
@@ -1410,8 +1500,8 @@ module Aws::S3
1410
1500
  #
1411
1501
  # @!attribute [rw] ssekms_encryption_context
1412
1502
  # If present, indicates the Amazon Web Services KMS Encryption Context
1413
- # to use for object encryption. The value of this header is a
1414
- # base64-encoded UTF-8 string holding JSON with the encryption context
1503
+ # to use for object encryption. The value of this header is a Base64
1504
+ # encoded UTF-8 string holding JSON with the encryption context
1415
1505
  # key-value pairs.
1416
1506
  # @return [String]
1417
1507
  #
@@ -1491,7 +1581,7 @@ module Aws::S3
1491
1581
  # requests are not supported. Directory bucket names must be unique in
1492
1582
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1493
1583
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1494
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1584
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1495
1585
  # naming restrictions, see [Directory bucket naming rules][1] in the
1496
1586
  # *Amazon S3 User Guide*.
1497
1587
  #
@@ -1503,30 +1593,37 @@ module Aws::S3
1503
1593
  #
1504
1594
  # </note>
1505
1595
  #
1506
- # **Access points** - When you use this action with an access point,
1507
- # you must provide the alias of the access point in place of the
1508
- # bucket name or specify the access point ARN. When using the access
1509
- # point ARN, you must direct requests to the access point hostname.
1510
- # The access point hostname takes the form
1596
+ # **Access points** - When you use this action with an access point
1597
+ # for general purpose buckets, you must provide the alias of the
1598
+ # access point in place of the bucket name or specify the access point
1599
+ # ARN. When you use this action with an access point for directory
1600
+ # buckets, you must provide the access point name in place of the
1601
+ # bucket name. When using the access point ARN, you must direct
1602
+ # requests to the access point hostname. The access point hostname
1603
+ # takes the form
1511
1604
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1512
1605
  # When using this action with an access point through the Amazon Web
1513
1606
  # Services SDKs, you provide the access point ARN in place of the
1514
1607
  # bucket name. For more information about access point ARNs, see
1515
1608
  # [Using access points][2] in the *Amazon S3 User Guide*.
1516
1609
  #
1517
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
1518
- # directory buckets.
1610
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
1519
1611
  #
1520
1612
  # </note>
1521
1613
  #
1522
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1523
- # Outposts, you must direct requests to the S3 on Outposts hostname.
1524
- # The S3 on Outposts hostname takes the form `
1614
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1615
+ # you must use the Outpost bucket access point ARN or the access point
1616
+ # alias for the destination bucket. You can only copy objects within
1617
+ # the same Outpost bucket. It's not supported to copy objects across
1618
+ # different Amazon Web Services Outposts, between buckets on the same
1619
+ # Outposts, or between Outposts buckets and any other bucket types.
1620
+ # For more information about S3 on Outposts, see [What is S3 on
1621
+ # Outposts?][3] in the *S3 on Outposts guide*. When you use this
1622
+ # action with S3 on Outposts through the REST API, you must direct
1623
+ # requests to the S3 on Outposts hostname, in the format `
1525
1624
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1526
- # When you use this action with S3 on Outposts through the Amazon Web
1527
- # Services SDKs, you provide the Outposts access point ARN in place of
1528
- # the bucket name. For more information about S3 on Outposts ARNs, see
1529
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1625
+ # The hostname isn't required when you use the Amazon Web Services
1626
+ # CLI or SDKs.
1530
1627
  #
1531
1628
  #
1532
1629
  #
@@ -1939,11 +2036,12 @@ module Aws::S3
1939
2036
  # availability. Depending on performance needs, you can specify a
1940
2037
  # different Storage Class.
1941
2038
  #
1942
- # <note markdown="1"> * <b>Directory buckets </b> - For directory buckets, only the S3
1943
- # Express One Zone storage class is supported to store newly created
1944
- # objects. Unsupported storage class values won't write a
1945
- # destination object and will respond with the HTTP status code `400
1946
- # Bad Request`.
2039
+ # <note markdown="1"> * <b>Directory buckets </b> - Directory buckets only support
2040
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
2041
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
2042
+ # Access storage class) in Dedicated Local Zones. Unsupported
2043
+ # storage class values won't write a destination object and will
2044
+ # respond with the HTTP status code `400 Bad Request`.
1947
2045
  #
1948
2046
  # * <b>Amazon S3 on Outposts </b> - S3 on Outposts only uses the
1949
2047
  # `OUTPOSTS` Storage Class.
@@ -2043,21 +2141,17 @@ module Aws::S3
2043
2141
  # Signature Version in Request Authentication][1] in the *Amazon S3
2044
2142
  # User Guide*.
2045
2143
  #
2046
- # **Directory buckets** - If you specify
2047
- # `x-amz-server-side-encryption` with `aws:kms`, the `
2048
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
2049
- # assigned the ID of the KMS symmetric encryption customer managed key
2050
- # that's configured for your directory bucket's default encryption
2051
- # setting. If you want to specify the `
2052
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
2053
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
2054
- # customer managed key that's configured for your directory bucket's
2055
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
2056
- # Request` error. Only use the key ID or key ARN. The key alias format
2057
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
2058
- # support 1 [customer managed key][2] per directory bucket for the
2059
- # lifetime of the bucket. The [Amazon Web Services managed key][3]
2060
- # (`aws/s3`) isn't supported.
2144
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
2145
+ # recommended to specify the `x-amz-server-side-encryption` header to
2146
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
2147
+ # header implicitly uses the bucket's default KMS customer managed
2148
+ # key ID. If you want to explicitly set the `
2149
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
2150
+ # the bucket's default customer managed key (using key ID or ARN, not
2151
+ # alias). Your SSE-KMS configuration can only support 1 [customer
2152
+ # managed key][2] per directory bucket's lifetime. The [Amazon Web
2153
+ # Services managed key][3] (`aws/s3`) isn't supported. Incorrect key
2154
+ # specification results in an HTTP `400 Bad Request` error.
2061
2155
  #
2062
2156
  #
2063
2157
  #
@@ -2331,11 +2425,21 @@ module Aws::S3
2331
2425
  # Creation date of the object.
2332
2426
  # @return [Time]
2333
2427
  #
2428
+ # @!attribute [rw] checksum_type
2429
+ # The checksum type that is used to calculate the object’s checksum
2430
+ # value. For more information, see [Checking object integrity][1] in
2431
+ # the *Amazon S3 User Guide*.
2432
+ #
2433
+ #
2434
+ #
2435
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2436
+ # @return [String]
2437
+ #
2334
2438
  # @!attribute [rw] checksum_crc32
2335
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
2336
- # only be present if it was uploaded with the object. For more
2337
- # information, see [ Checking object integrity][1] in the *Amazon S3
2338
- # User Guide*.
2439
+ # The Base64 encoded, 32-bit `CRC32` checksum of the object. This
2440
+ # checksum is only present if the object was uploaded with the object.
2441
+ # For more information, see [ Checking object integrity][1] in the
2442
+ # *Amazon S3 User Guide*.
2339
2443
  #
2340
2444
  #
2341
2445
  #
@@ -2343,10 +2447,23 @@ module Aws::S3
2343
2447
  # @return [String]
2344
2448
  #
2345
2449
  # @!attribute [rw] checksum_crc32c
2346
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
2347
- # only be present if it was uploaded with the object. For more
2348
- # information, see [ Checking object integrity][1] in the *Amazon S3
2349
- # User Guide*.
2450
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
2451
+ # will only be present if the object was uploaded with the object. For
2452
+ # more information, see [ Checking object integrity][1] in the *Amazon
2453
+ # S3 User Guide*.
2454
+ #
2455
+ #
2456
+ #
2457
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2458
+ # @return [String]
2459
+ #
2460
+ # @!attribute [rw] checksum_crc64nvme
2461
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
2462
+ # checksum is present if the object being copied was uploaded with the
2463
+ # `CRC64NVME` checksum algorithm, or if the object was uploaded
2464
+ # without a checksum (and Amazon S3 added the default checksum,
2465
+ # `CRC64NVME`, to the uploaded object). For more information, see
2466
+ # [Checking object integrity][1] in the *Amazon S3 User Guide*.
2350
2467
  #
2351
2468
  #
2352
2469
  #
@@ -2354,8 +2471,8 @@ module Aws::S3
2354
2471
  # @return [String]
2355
2472
  #
2356
2473
  # @!attribute [rw] checksum_sha1
2357
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
2358
- # only be present if it was uploaded with the object. For more
2474
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
2475
+ # only be present if the object was uploaded with the object. For more
2359
2476
  # information, see [ Checking object integrity][1] in the *Amazon S3
2360
2477
  # User Guide*.
2361
2478
  #
@@ -2365,8 +2482,8 @@ module Aws::S3
2365
2482
  # @return [String]
2366
2483
  #
2367
2484
  # @!attribute [rw] checksum_sha256
2368
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
2369
- # only be present if it was uploaded with the object. For more
2485
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
2486
+ # only be present if the object was uploaded with the object. For more
2370
2487
  # information, see [ Checking object integrity][1] in the *Amazon S3
2371
2488
  # User Guide*.
2372
2489
  #
@@ -2380,8 +2497,10 @@ module Aws::S3
2380
2497
  class CopyObjectResult < Struct.new(
2381
2498
  :etag,
2382
2499
  :last_modified,
2500
+ :checksum_type,
2383
2501
  :checksum_crc32,
2384
2502
  :checksum_crc32c,
2503
+ :checksum_crc64nvme,
2385
2504
  :checksum_sha1,
2386
2505
  :checksum_sha256)
2387
2506
  SENSITIVE = []
@@ -2399,63 +2518,63 @@ module Aws::S3
2399
2518
  # @return [Time]
2400
2519
  #
2401
2520
  # @!attribute [rw] checksum_crc32
2402
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
2403
- # only be present if it was uploaded with the object. When you use an
2404
- # API operation on an object that was uploaded using multipart
2405
- # uploads, this value may not be a direct checksum value of the full
2406
- # object. Instead, it's a calculation based on the checksum values of
2407
- # each individual part. For more information about how checksums are
2408
- # calculated with multipart uploads, see [ Checking object
2409
- # integrity][1] in the *Amazon S3 User Guide*.
2521
+ # This header can be used as a data integrity check to verify that the
2522
+ # data received is the same data that was originally sent. This header
2523
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the part.
2524
+ # For more information, see [Checking object integrity][1] in the
2525
+ # *Amazon S3 User Guide*.
2410
2526
  #
2411
2527
  #
2412
2528
  #
2413
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
2529
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2414
2530
  # @return [String]
2415
2531
  #
2416
2532
  # @!attribute [rw] checksum_crc32c
2417
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
2418
- # only be present if it was uploaded with the object. When you use an
2419
- # API operation on an object that was uploaded using multipart
2420
- # uploads, this value may not be a direct checksum value of the full
2421
- # object. Instead, it's a calculation based on the checksum values of
2422
- # each individual part. For more information about how checksums are
2423
- # calculated with multipart uploads, see [ Checking object
2424
- # integrity][1] in the *Amazon S3 User Guide*.
2533
+ # This header can be used as a data integrity check to verify that the
2534
+ # data received is the same data that was originally sent. This header
2535
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the part.
2536
+ # For more information, see [Checking object integrity][1] in the
2537
+ # *Amazon S3 User Guide*.
2425
2538
  #
2426
2539
  #
2427
2540
  #
2428
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
2541
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2542
+ # @return [String]
2543
+ #
2544
+ # @!attribute [rw] checksum_crc64nvme
2545
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
2546
+ # checksum is present if the multipart upload request was created with
2547
+ # the `CRC64NVME` checksum algorithm to the uploaded object). For more
2548
+ # information, see [Checking object integrity][1] in the *Amazon S3
2549
+ # User Guide*.
2550
+ #
2551
+ #
2552
+ #
2553
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2429
2554
  # @return [String]
2430
2555
  #
2431
2556
  # @!attribute [rw] checksum_sha1
2432
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
2433
- # only be present if it was uploaded with the object. When you use the
2434
- # API operation on an object that was uploaded using multipart
2435
- # uploads, this value may not be a direct checksum value of the full
2436
- # object. Instead, it's a calculation based on the checksum values of
2437
- # each individual part. For more information about how checksums are
2438
- # calculated with multipart uploads, see [ Checking object
2439
- # integrity][1] in the *Amazon S3 User Guide*.
2557
+ # This header can be used as a data integrity check to verify that the
2558
+ # data received is the same data that was originally sent. This header
2559
+ # specifies the Base64 encoded, 160-bit `SHA1` checksum of the part.
2560
+ # For more information, see [Checking object integrity][1] in the
2561
+ # *Amazon S3 User Guide*.
2440
2562
  #
2441
2563
  #
2442
2564
  #
2443
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
2565
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2444
2566
  # @return [String]
2445
2567
  #
2446
2568
  # @!attribute [rw] checksum_sha256
2447
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
2448
- # only be present if it was uploaded with the object. When you use an
2449
- # API operation on an object that was uploaded using multipart
2450
- # uploads, this value may not be a direct checksum value of the full
2451
- # object. Instead, it's a calculation based on the checksum values of
2452
- # each individual part. For more information about how checksums are
2453
- # calculated with multipart uploads, see [ Checking object
2454
- # integrity][1] in the *Amazon S3 User Guide*.
2569
+ # This header can be used as a data integrity check to verify that the
2570
+ # data received is the same data that was originally sent. This header
2571
+ # specifies the Base64 encoded, 256-bit `SHA256` checksum of the part.
2572
+ # For more information, see [Checking object integrity][1] in the
2573
+ # *Amazon S3 User Guide*.
2455
2574
  #
2456
2575
  #
2457
2576
  #
2458
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
2577
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2459
2578
  # @return [String]
2460
2579
  #
2461
2580
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyPartResult AWS API Documentation
@@ -2465,6 +2584,7 @@ module Aws::S3
2465
2584
  :last_modified,
2466
2585
  :checksum_crc32,
2467
2586
  :checksum_crc32c,
2587
+ :checksum_crc64nvme,
2468
2588
  :checksum_sha1,
2469
2589
  :checksum_sha256)
2470
2590
  SENSITIVE = []
@@ -2478,11 +2598,14 @@ module Aws::S3
2478
2598
  # choose a Region to optimize latency, minimize costs, or address
2479
2599
  # regulatory requirements. For example, if you reside in Europe, you
2480
2600
  # will probably find it advantageous to create buckets in the Europe
2481
- # (Ireland) Region. For more information, see [Accessing a bucket][1]
2482
- # in the *Amazon S3 User Guide*.
2601
+ # (Ireland) Region.
2483
2602
  #
2484
2603
  # If you don't specify a Region, the bucket is created in the US East
2485
- # (N. Virginia) Region (us-east-1) by default.
2604
+ # (N. Virginia) Region (us-east-1) by default. Configurations using
2605
+ # the value `EU` will create a bucket in `eu-west-1`.
2606
+ #
2607
+ # For a list of the valid values for all of the Amazon Web Services
2608
+ # Regions, see [Regions and Endpoints][1].
2486
2609
  #
2487
2610
  # <note markdown="1"> This functionality is not supported for directory buckets.
2488
2611
  #
@@ -2490,17 +2613,17 @@ module Aws::S3
2490
2613
  #
2491
2614
  #
2492
2615
  #
2493
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
2616
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2494
2617
  # @return [String]
2495
2618
  #
2496
2619
  # @!attribute [rw] location
2497
2620
  # Specifies the location where the bucket will be created.
2498
2621
  #
2499
2622
  # <b>Directory buckets </b> - The location type is Availability Zone
2500
- # or Local Zone. When the location type is Local Zone, your Local Zone
2501
- # must be in opt-in status. Otherwise, you get an HTTP `400 Bad
2502
- # Request` error with the error code `Access denied`. To learn more
2503
- # about opt-in Local Zones, see [Opt-in Dedicated Local Zones][1]in
2623
+ # or Local Zone. To use the Local Zone location type, your account
2624
+ # must be enabled for Dedicated Local Zones. Otherwise, you get an
2625
+ # HTTP `403 Forbidden` error with the error code `AccessDenied`. To
2626
+ # learn more, see [Enable accounts for Dedicated Local Zones][1] in
2504
2627
  # the *Amazon S3 User Guide*.
2505
2628
  #
2506
2629
  # <note markdown="1"> This functionality is only supported by directory buckets.
@@ -2802,8 +2925,8 @@ module Aws::S3
2802
2925
  #
2803
2926
  # @!attribute [rw] ssekms_encryption_context
2804
2927
  # If present, indicates the Amazon Web Services KMS Encryption Context
2805
- # to use for object encryption. The value of this header is a
2806
- # Base64-encoded string of a UTF-8 encoded JSON, which contains the
2928
+ # to use for object encryption. The value of this header is a Base64
2929
+ # encoded string of a UTF-8 encoded JSON, which contains the
2807
2930
  # encryption context as key-value pairs.
2808
2931
  # @return [String]
2809
2932
  #
@@ -2826,6 +2949,16 @@ module Aws::S3
2826
2949
  # The algorithm that was used to create a checksum of the object.
2827
2950
  # @return [String]
2828
2951
  #
2952
+ # @!attribute [rw] checksum_type
2953
+ # Indicates the checksum type that you want Amazon S3 to use to
2954
+ # calculate the object’s checksum value. For more information, see
2955
+ # [Checking object integrity in the Amazon S3 User Guide][1].
2956
+ #
2957
+ #
2958
+ #
2959
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
2960
+ # @return [String]
2961
+ #
2829
2962
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUploadOutput AWS API Documentation
2830
2963
  #
2831
2964
  class CreateMultipartUploadOutput < Struct.new(
@@ -2841,7 +2974,8 @@ module Aws::S3
2841
2974
  :ssekms_encryption_context,
2842
2975
  :bucket_key_enabled,
2843
2976
  :request_charged,
2844
- :checksum_algorithm)
2977
+ :checksum_algorithm,
2978
+ :checksum_type)
2845
2979
  SENSITIVE = [:ssekms_key_id, :ssekms_encryption_context]
2846
2980
  include Aws::Structure
2847
2981
  end
@@ -2883,34 +3017,36 @@ module Aws::S3
2883
3017
  # requests are not supported. Directory bucket names must be unique in
2884
3018
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
2885
3019
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
2886
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3020
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
2887
3021
  # naming restrictions, see [Directory bucket naming rules][1] in the
2888
3022
  # *Amazon S3 User Guide*.
2889
3023
  #
2890
- # **Access points** - When you use this action with an access point,
2891
- # you must provide the alias of the access point in place of the
2892
- # bucket name or specify the access point ARN. When using the access
2893
- # point ARN, you must direct requests to the access point hostname.
2894
- # The access point hostname takes the form
3024
+ # **Access points** - When you use this action with an access point
3025
+ # for general purpose buckets, you must provide the alias of the
3026
+ # access point in place of the bucket name or specify the access point
3027
+ # ARN. When you use this action with an access point for directory
3028
+ # buckets, you must provide the access point name in place of the
3029
+ # bucket name. When using the access point ARN, you must direct
3030
+ # requests to the access point hostname. The access point hostname
3031
+ # takes the form
2895
3032
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2896
3033
  # When using this action with an access point through the Amazon Web
2897
3034
  # Services SDKs, you provide the access point ARN in place of the
2898
3035
  # bucket name. For more information about access point ARNs, see
2899
3036
  # [Using access points][2] in the *Amazon S3 User Guide*.
2900
3037
  #
2901
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
2902
- # directory buckets.
3038
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
2903
3039
  #
2904
3040
  # </note>
2905
3041
  #
2906
- # **S3 on Outposts** - When you use this action with Amazon S3 on
2907
- # Outposts, you must direct requests to the S3 on Outposts hostname.
2908
- # The S3 on Outposts hostname takes the form `
3042
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
3043
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
3044
+ # Outposts hostname takes the form `
2909
3045
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2910
- # When you use this action with S3 on Outposts through the Amazon Web
2911
- # Services SDKs, you provide the Outposts access point ARN in place of
2912
- # the bucket name. For more information about S3 on Outposts ARNs, see
2913
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
3046
+ # When you use this action with S3 on Outposts, the destination bucket
3047
+ # must be the Outposts access point ARN or the access point alias. For
3048
+ # more information about S3 on Outposts, see [What is S3 on
3049
+ # Outposts?][3] in the *Amazon S3 User Guide*.
2914
3050
  #
2915
3051
  #
2916
3052
  #
@@ -3278,8 +3414,10 @@ module Aws::S3
3278
3414
  # specify a different Storage Class. For more information, see
3279
3415
  # [Storage Classes][1] in the *Amazon S3 User Guide*.
3280
3416
  #
3281
- # <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class
3282
- # is supported to store newly created objects.
3417
+ # <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express
3418
+ # One Zone storage class) in Availability Zones and `ONEZONE_IA`
3419
+ # (the S3 One Zone-Infrequent Access storage class) in Dedicated
3420
+ # Local Zones.
3283
3421
  #
3284
3422
  # * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
3285
3423
  #
@@ -3348,21 +3486,17 @@ module Aws::S3
3348
3486
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
3349
3487
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
3350
3488
  #
3351
- # **Directory buckets** - If you specify
3352
- # `x-amz-server-side-encryption` with `aws:kms`, the `
3353
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
3354
- # assigned the ID of the KMS symmetric encryption customer managed key
3355
- # that's configured for your directory bucket's default encryption
3356
- # setting. If you want to specify the `
3357
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
3358
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
3359
- # customer managed key that's configured for your directory bucket's
3360
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
3361
- # Request` error. Only use the key ID or key ARN. The key alias format
3362
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
3363
- # support 1 [customer managed key][1] per directory bucket for the
3364
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
3365
- # (`aws/s3`) isn't supported.
3489
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
3490
+ # recommended to specify the `x-amz-server-side-encryption` header to
3491
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
3492
+ # header implicitly uses the bucket's default KMS customer managed
3493
+ # key ID. If you want to explicitly set the `
3494
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
3495
+ # the bucket's default customer managed key (using key ID or ARN, not
3496
+ # alias). Your SSE-KMS configuration can only support 1 [customer
3497
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
3498
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
3499
+ # specification results in an HTTP `400 Bad Request` error.
3366
3500
  #
3367
3501
  #
3368
3502
  #
@@ -3372,7 +3506,7 @@ module Aws::S3
3372
3506
  #
3373
3507
  # @!attribute [rw] ssekms_encryption_context
3374
3508
  # Specifies the Amazon Web Services KMS Encryption Context to use for
3375
- # object encryption. The value of this header is a Base64-encoded
3509
+ # object encryption. The value of this header is a Base64 encoded
3376
3510
  # string of a UTF-8 encoded JSON, which contains the encryption
3377
3511
  # context as key-value pairs.
3378
3512
  #
@@ -3480,6 +3614,16 @@ module Aws::S3
3480
3614
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
3481
3615
  # @return [String]
3482
3616
  #
3617
+ # @!attribute [rw] checksum_type
3618
+ # Indicates the checksum type that you want Amazon S3 to use to
3619
+ # calculate the object’s checksum value. For more information, see
3620
+ # [Checking object integrity in the Amazon S3 User Guide][1].
3621
+ #
3622
+ #
3623
+ #
3624
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
3625
+ # @return [String]
3626
+ #
3483
3627
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUploadRequest AWS API Documentation
3484
3628
  #
3485
3629
  class CreateMultipartUploadRequest < Struct.new(
@@ -3512,7 +3656,8 @@ module Aws::S3
3512
3656
  :object_lock_retain_until_date,
3513
3657
  :object_lock_legal_hold_status,
3514
3658
  :expected_bucket_owner,
3515
- :checksum_algorithm)
3659
+ :checksum_algorithm,
3660
+ :checksum_type)
3516
3661
  SENSITIVE = [:sse_customer_key, :ssekms_key_id, :ssekms_encryption_context]
3517
3662
  include Aws::Structure
3518
3663
  end
@@ -3530,8 +3675,8 @@ module Aws::S3
3530
3675
  #
3531
3676
  # @!attribute [rw] ssekms_encryption_context
3532
3677
  # If present, indicates the Amazon Web Services KMS Encryption Context
3533
- # to use for object encryption. The value of this header is a
3534
- # Base64-encoded string of a UTF-8 encoded JSON, which contains the
3678
+ # to use for object encryption. The value of this header is a Base64
3679
+ # encoded string of a UTF-8 encoded JSON, which contains the
3535
3680
  # encryption context as key-value pairs. This value is stored as
3536
3681
  # object metadata and automatically gets passed on to Amazon Web
3537
3682
  # Services KMS for future `GetObject` operations on this object.
@@ -3586,7 +3731,7 @@ module Aws::S3
3586
3731
  #
3587
3732
  #
3588
3733
  #
3589
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3734
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
3590
3735
  # @return [String]
3591
3736
  #
3592
3737
  # @!attribute [rw] ssekms_key_id
@@ -3600,8 +3745,8 @@ module Aws::S3
3600
3745
  # must use the full Key ARN not the Key ID.
3601
3746
  #
3602
3747
  # Your SSE-KMS configuration can only support 1 [customer managed
3603
- # key][1] per directory bucket for the lifetime of the bucket. The
3604
- # [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
3748
+ # key][1] per directory bucket's lifetime. The [Amazon Web Services
3749
+ # managed key][2] (`aws/s3`) isn't supported.
3605
3750
  #
3606
3751
  #
3607
3752
  #
@@ -3612,7 +3757,7 @@ module Aws::S3
3612
3757
  # @!attribute [rw] ssekms_encryption_context
3613
3758
  # Specifies the Amazon Web Services KMS Encryption Context as an
3614
3759
  # additional encryption context to use for object encryption. The
3615
- # value of this header is a Base64-encoded string of a UTF-8 encoded
3760
+ # value of this header is a Base64 encoded string of a UTF-8 encoded
3616
3761
  # JSON, which contains the encryption context as key-value pairs. This
3617
3762
  # value is stored as object metadata and automatically gets passed on
3618
3763
  # to Amazon Web Services KMS for future `GetObject` operations on this
@@ -4104,7 +4249,7 @@ module Aws::S3
4104
4249
  # Information about the delete marker.
4105
4250
  #
4106
4251
  # @!attribute [rw] owner
4107
- # The account that created the delete marker.&gt;
4252
+ # The account that created the delete marker.
4108
4253
  # @return [Types::Owner]
4109
4254
  #
4110
4255
  # @!attribute [rw] key
@@ -4180,10 +4325,16 @@ module Aws::S3
4180
4325
  # deleted was (true) or was not (false) a delete marker before
4181
4326
  # deletion. In a simple DELETE, this header indicates whether (true)
4182
4327
  # or not (false) the current version of the object is a delete marker.
4328
+ # To learn more about delete markers, see [Working with delete
4329
+ # markers][1].
4183
4330
  #
4184
4331
  # <note markdown="1"> This functionality is not supported for directory buckets.
4185
4332
  #
4186
4333
  # </note>
4334
+ #
4335
+ #
4336
+ #
4337
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4187
4338
  # @return [Boolean]
4188
4339
  #
4189
4340
  # @!attribute [rw] version_id
@@ -4223,34 +4374,36 @@ module Aws::S3
4223
4374
  # requests are not supported. Directory bucket names must be unique in
4224
4375
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4225
4376
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4226
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4377
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4227
4378
  # naming restrictions, see [Directory bucket naming rules][1] in the
4228
4379
  # *Amazon S3 User Guide*.
4229
4380
  #
4230
- # **Access points** - When you use this action with an access point,
4231
- # you must provide the alias of the access point in place of the
4232
- # bucket name or specify the access point ARN. When using the access
4233
- # point ARN, you must direct requests to the access point hostname.
4234
- # The access point hostname takes the form
4381
+ # **Access points** - When you use this action with an access point
4382
+ # for general purpose buckets, you must provide the alias of the
4383
+ # access point in place of the bucket name or specify the access point
4384
+ # ARN. When you use this action with an access point for directory
4385
+ # buckets, you must provide the access point name in place of the
4386
+ # bucket name. When using the access point ARN, you must direct
4387
+ # requests to the access point hostname. The access point hostname
4388
+ # takes the form
4235
4389
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4236
4390
  # When using this action with an access point through the Amazon Web
4237
4391
  # Services SDKs, you provide the access point ARN in place of the
4238
4392
  # bucket name. For more information about access point ARNs, see
4239
4393
  # [Using access points][2] in the *Amazon S3 User Guide*.
4240
4394
  #
4241
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
4242
- # directory buckets.
4395
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
4243
4396
  #
4244
4397
  # </note>
4245
4398
  #
4246
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4247
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4248
- # The S3 on Outposts hostname takes the form `
4399
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4400
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4401
+ # Outposts hostname takes the form `
4249
4402
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4250
- # When you use this action with S3 on Outposts through the Amazon Web
4251
- # Services SDKs, you provide the Outposts access point ARN in place of
4252
- # the bucket name. For more information about S3 on Outposts ARNs, see
4253
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4403
+ # When you use this action with S3 on Outposts, the destination bucket
4404
+ # must be the Outposts access point ARN or the access point alias. For
4405
+ # more information about S3 on Outposts, see [What is S3 on
4406
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4254
4407
  #
4255
4408
  #
4256
4409
  #
@@ -4333,7 +4486,7 @@ module Aws::S3
4333
4486
  #
4334
4487
  #
4335
4488
  #
4336
- # [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
4489
+ # [1]: https://tools.ietf.org/html/rfc7232
4337
4490
  # @return [String]
4338
4491
  #
4339
4492
  # @!attribute [rw] if_match_last_modified_time
@@ -4397,25 +4550,28 @@ module Aws::S3
4397
4550
  # The bucket name containing the objects from which to remove the
4398
4551
  # tags.
4399
4552
  #
4400
- # **Access points** - When you use this action with an access point,
4401
- # you must provide the alias of the access point in place of the
4402
- # bucket name or specify the access point ARN. When using the access
4403
- # point ARN, you must direct requests to the access point hostname.
4404
- # The access point hostname takes the form
4553
+ # **Access points** - When you use this action with an access point
4554
+ # for general purpose buckets, you must provide the alias of the
4555
+ # access point in place of the bucket name or specify the access point
4556
+ # ARN. When you use this action with an access point for directory
4557
+ # buckets, you must provide the access point name in place of the
4558
+ # bucket name. When using the access point ARN, you must direct
4559
+ # requests to the access point hostname. The access point hostname
4560
+ # takes the form
4405
4561
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4406
4562
  # When using this action with an access point through the Amazon Web
4407
4563
  # Services SDKs, you provide the access point ARN in place of the
4408
4564
  # bucket name. For more information about access point ARNs, see
4409
4565
  # [Using access points][1] in the *Amazon S3 User Guide*.
4410
4566
  #
4411
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4412
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4413
- # The S3 on Outposts hostname takes the form `
4567
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4568
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4569
+ # Outposts hostname takes the form `
4414
4570
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4415
- # When you use this action with S3 on Outposts through the Amazon Web
4416
- # Services SDKs, you provide the Outposts access point ARN in place of
4417
- # the bucket name. For more information about S3 on Outposts ARNs, see
4418
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
4571
+ # When you use this action with S3 on Outposts, the destination bucket
4572
+ # must be the Outposts access point ARN or the access point alias. For
4573
+ # more information about S3 on Outposts, see [What is S3 on
4574
+ # Outposts?][2] in the *Amazon S3 User Guide*.
4419
4575
  #
4420
4576
  #
4421
4577
  #
@@ -4488,34 +4644,36 @@ module Aws::S3
4488
4644
  # requests are not supported. Directory bucket names must be unique in
4489
4645
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4490
4646
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4491
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4647
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4492
4648
  # naming restrictions, see [Directory bucket naming rules][1] in the
4493
4649
  # *Amazon S3 User Guide*.
4494
4650
  #
4495
- # **Access points** - When you use this action with an access point,
4496
- # you must provide the alias of the access point in place of the
4497
- # bucket name or specify the access point ARN. When using the access
4498
- # point ARN, you must direct requests to the access point hostname.
4499
- # The access point hostname takes the form
4651
+ # **Access points** - When you use this action with an access point
4652
+ # for general purpose buckets, you must provide the alias of the
4653
+ # access point in place of the bucket name or specify the access point
4654
+ # ARN. When you use this action with an access point for directory
4655
+ # buckets, you must provide the access point name in place of the
4656
+ # bucket name. When using the access point ARN, you must direct
4657
+ # requests to the access point hostname. The access point hostname
4658
+ # takes the form
4500
4659
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4501
4660
  # When using this action with an access point through the Amazon Web
4502
4661
  # Services SDKs, you provide the access point ARN in place of the
4503
4662
  # bucket name. For more information about access point ARNs, see
4504
4663
  # [Using access points][2] in the *Amazon S3 User Guide*.
4505
4664
  #
4506
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
4507
- # directory buckets.
4665
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
4508
4666
  #
4509
4667
  # </note>
4510
4668
  #
4511
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4512
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4513
- # The S3 on Outposts hostname takes the form `
4669
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4670
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4671
+ # Outposts hostname takes the form `
4514
4672
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4515
- # When you use this action with S3 on Outposts through the Amazon Web
4516
- # Services SDKs, you provide the Outposts access point ARN in place of
4517
- # the bucket name. For more information about S3 on Outposts ARNs, see
4518
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4673
+ # When you use this action with S3 on Outposts, the destination bucket
4674
+ # must be the Outposts access point ARN or the access point alias. For
4675
+ # more information about S3 on Outposts, see [What is S3 on
4676
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4519
4677
  #
4520
4678
  #
4521
4679
  #
@@ -4603,6 +4761,8 @@ module Aws::S3
4603
4761
  #
4604
4762
  # * `CRC32C`
4605
4763
  #
4764
+ # * `CRC64NVME`
4765
+ #
4606
4766
  # * `SHA1`
4607
4767
  #
4608
4768
  # * `SHA256`
@@ -4612,10 +4772,8 @@ module Aws::S3
4612
4772
  #
4613
4773
  # If the individual checksum value you provide through
4614
4774
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm
4615
- # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores
4616
- # any provided `ChecksumAlgorithm` parameter and uses the checksum
4617
- # algorithm that matches the provided value in
4618
- # `x-amz-checksum-algorithm `.
4775
+ # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
4776
+ # request with a `BadDigest` error.
4619
4777
  #
4620
4778
  # If you provide an individual checksum, Amazon S3 ignores any
4621
4779
  # provided `ChecksumAlgorithm` parameter.
@@ -4679,10 +4837,16 @@ module Aws::S3
4679
4837
  # deleted was (true) or was not (false) a delete marker before
4680
4838
  # deletion. In a simple DELETE, this header indicates whether (true)
4681
4839
  # or not (false) the current version of the object is a delete marker.
4840
+ # To learn more about delete markers, see [Working with delete
4841
+ # markers][1].
4682
4842
  #
4683
4843
  # <note markdown="1"> This functionality is not supported for directory buckets.
4684
4844
  #
4685
4845
  # </note>
4846
+ #
4847
+ #
4848
+ #
4849
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4686
4850
  # @return [Boolean]
4687
4851
  #
4688
4852
  # @!attribute [rw] delete_marker_version_id
@@ -6141,7 +6305,7 @@ module Aws::S3
6141
6305
  # Indicates which default minimum object size behavior is applied to
6142
6306
  # the lifecycle configuration.
6143
6307
  #
6144
- # <note markdown="1"> This parameter applies to general purpose buckets only. It is not
6308
+ # <note markdown="1"> This parameter applies to general purpose buckets only. It isn't
6145
6309
  # supported for directory bucket lifecycle configurations.
6146
6310
  #
6147
6311
  # </note>
@@ -6229,8 +6393,10 @@ module Aws::S3
6229
6393
  # @!attribute [rw] location_constraint
6230
6394
  # Specifies the Region where the bucket resides. For a list of all the
6231
6395
  # Amazon S3 supported location constraints by Region, see [Regions and
6232
- # Endpoints][1]. Buckets in Region `us-east-1` have a
6233
- # LocationConstraint of `null`.
6396
+ # Endpoints][1].
6397
+ #
6398
+ # Buckets in Region `us-east-1` have a LocationConstraint of `null`.
6399
+ # Buckets with a LocationConstraint of `EU` reside in `eu-west-1`.
6234
6400
  #
6235
6401
  #
6236
6402
  #
@@ -6530,8 +6696,7 @@ module Aws::S3
6530
6696
  # `InvalidAccessPointAliasError` is returned. For more information
6531
6697
  # about `InvalidAccessPointAliasError`, see [List of Error Codes][2].
6532
6698
  #
6533
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
6534
- # directory buckets.
6699
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
6535
6700
  #
6536
6701
  # </note>
6537
6702
  #
@@ -6816,11 +6981,14 @@ module Aws::S3
6816
6981
  # The bucket name that contains the object for which to get the ACL
6817
6982
  # information.
6818
6983
  #
6819
- # **Access points** - When you use this action with an access point,
6820
- # you must provide the alias of the access point in place of the
6821
- # bucket name or specify the access point ARN. When using the access
6822
- # point ARN, you must direct requests to the access point hostname.
6823
- # The access point hostname takes the form
6984
+ # **Access points** - When you use this action with an access point
6985
+ # for general purpose buckets, you must provide the alias of the
6986
+ # access point in place of the bucket name or specify the access point
6987
+ # ARN. When you use this action with an access point for directory
6988
+ # buckets, you must provide the access point name in place of the
6989
+ # bucket name. When using the access point ARN, you must direct
6990
+ # requests to the access point hostname. The access point hostname
6991
+ # takes the form
6824
6992
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6825
6993
  # When using this action with an access point through the Amazon Web
6826
6994
  # Services SDKs, you provide the access point ARN in place of the
@@ -6884,11 +7052,16 @@ module Aws::S3
6884
7052
  # @!attribute [rw] delete_marker
6885
7053
  # Specifies whether the object retrieved was (`true`) or was not
6886
7054
  # (`false`) a delete marker. If `false`, this response header does not
6887
- # appear in the response.
7055
+ # appear in the response. To learn more about delete markers, see
7056
+ # [Working with delete markers][1].
6888
7057
  #
6889
7058
  # <note markdown="1"> This functionality is not supported for directory buckets.
6890
7059
  #
6891
7060
  # </note>
7061
+ #
7062
+ #
7063
+ #
7064
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
6892
7065
  # @return [Boolean]
6893
7066
  #
6894
7067
  # @!attribute [rw] last_modified
@@ -6932,8 +7105,10 @@ module Aws::S3
6932
7105
  #
6933
7106
  # For more information, see [Storage Classes][1].
6934
7107
  #
6935
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
6936
- # is supported by directory buckets to store objects.
7108
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
7109
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
7110
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
7111
+ # Access storage class) in Dedicated Local Zones.
6937
7112
  #
6938
7113
  # </note>
6939
7114
  #
@@ -7028,34 +7203,36 @@ module Aws::S3
7028
7203
  # requests are not supported. Directory bucket names must be unique in
7029
7204
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7030
7205
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7031
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7206
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7032
7207
  # naming restrictions, see [Directory bucket naming rules][1] in the
7033
7208
  # *Amazon S3 User Guide*.
7034
7209
  #
7035
- # **Access points** - When you use this action with an access point,
7036
- # you must provide the alias of the access point in place of the
7037
- # bucket name or specify the access point ARN. When using the access
7038
- # point ARN, you must direct requests to the access point hostname.
7039
- # The access point hostname takes the form
7210
+ # **Access points** - When you use this action with an access point
7211
+ # for general purpose buckets, you must provide the alias of the
7212
+ # access point in place of the bucket name or specify the access point
7213
+ # ARN. When you use this action with an access point for directory
7214
+ # buckets, you must provide the access point name in place of the
7215
+ # bucket name. When using the access point ARN, you must direct
7216
+ # requests to the access point hostname. The access point hostname
7217
+ # takes the form
7040
7218
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7041
7219
  # When using this action with an access point through the Amazon Web
7042
7220
  # Services SDKs, you provide the access point ARN in place of the
7043
7221
  # bucket name. For more information about access point ARNs, see
7044
7222
  # [Using access points][2] in the *Amazon S3 User Guide*.
7045
7223
  #
7046
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
7047
- # directory buckets.
7224
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
7048
7225
  #
7049
7226
  # </note>
7050
7227
  #
7051
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7052
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7053
- # The S3 on Outposts hostname takes the form `
7228
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7229
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7230
+ # Outposts hostname takes the form `
7054
7231
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7055
- # When you use this action with S3 on Outposts through the Amazon Web
7056
- # Services SDKs, you provide the Outposts access point ARN in place of
7057
- # the bucket name. For more information about S3 on Outposts ARNs, see
7058
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7232
+ # When you use this action with S3 on Outposts, the destination bucket
7233
+ # must be the Outposts access point ARN or the access point alias. For
7234
+ # more information about S3 on Outposts, see [What is S3 on
7235
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7059
7236
  #
7060
7237
  #
7061
7238
  #
@@ -7183,11 +7360,14 @@ module Aws::S3
7183
7360
  # The bucket name containing the object whose legal hold status you
7184
7361
  # want to retrieve.
7185
7362
  #
7186
- # **Access points** - When you use this action with an access point,
7187
- # you must provide the alias of the access point in place of the
7188
- # bucket name or specify the access point ARN. When using the access
7189
- # point ARN, you must direct requests to the access point hostname.
7190
- # The access point hostname takes the form
7363
+ # **Access points** - When you use this action with an access point
7364
+ # for general purpose buckets, you must provide the alias of the
7365
+ # access point in place of the bucket name or specify the access point
7366
+ # ARN. When you use this action with an access point for directory
7367
+ # buckets, you must provide the access point name in place of the
7368
+ # bucket name. When using the access point ARN, you must direct
7369
+ # requests to the access point hostname. The access point hostname
7370
+ # takes the form
7191
7371
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7192
7372
  # When using this action with an access point through the Amazon Web
7193
7373
  # Services SDKs, you provide the access point ARN in place of the
@@ -7261,11 +7441,14 @@ module Aws::S3
7261
7441
  # @!attribute [rw] bucket
7262
7442
  # The bucket whose Object Lock configuration you want to retrieve.
7263
7443
  #
7264
- # **Access points** - When you use this action with an access point,
7265
- # you must provide the alias of the access point in place of the
7266
- # bucket name or specify the access point ARN. When using the access
7267
- # point ARN, you must direct requests to the access point hostname.
7268
- # The access point hostname takes the form
7444
+ # **Access points** - When you use this action with an access point
7445
+ # for general purpose buckets, you must provide the alias of the
7446
+ # access point in place of the bucket name or specify the access point
7447
+ # ARN. When you use this action with an access point for directory
7448
+ # buckets, you must provide the access point name in place of the
7449
+ # bucket name. When using the access point ARN, you must direct
7450
+ # requests to the access point hostname. The access point hostname
7451
+ # takes the form
7269
7452
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7270
7453
  # When using this action with an access point through the Amazon Web
7271
7454
  # Services SDKs, you provide the access point ARN in place of the
@@ -7339,9 +7522,10 @@ module Aws::S3
7339
7522
  # Provides information about object restoration action and expiration
7340
7523
  # time of the restored object copy.
7341
7524
  #
7342
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
7343
- # S3 Express One Zone storage class is supported by directory buckets
7344
- # to store objects.
7525
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
7526
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
7527
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
7528
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
7345
7529
  #
7346
7530
  # </note>
7347
7531
  # @return [String]
@@ -7365,10 +7549,10 @@ module Aws::S3
7365
7549
  # @return [String]
7366
7550
  #
7367
7551
  # @!attribute [rw] checksum_crc32
7368
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
7369
- # only be present if it was uploaded with the object. For more
7370
- # information, see [ Checking object integrity][1] in the *Amazon S3
7371
- # User Guide*.
7552
+ # The Base64 encoded, 32-bit `CRC32` checksum of the object. This
7553
+ # checksum is only present if the object was uploaded with the object.
7554
+ # For more information, see [ Checking object integrity][1] in the
7555
+ # *Amazon S3 User Guide*.
7372
7556
  #
7373
7557
  #
7374
7558
  #
@@ -7376,10 +7560,20 @@ module Aws::S3
7376
7560
  # @return [String]
7377
7561
  #
7378
7562
  # @!attribute [rw] checksum_crc32c
7379
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
7380
- # only be present if it was uploaded with the object. For more
7381
- # information, see [ Checking object integrity][1] in the *Amazon S3
7382
- # User Guide*.
7563
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
7564
+ # will only be present if the object was uploaded with the object. For
7565
+ # more information, see [ Checking object integrity][1] in the *Amazon
7566
+ # S3 User Guide*.
7567
+ #
7568
+ #
7569
+ #
7570
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
7571
+ # @return [String]
7572
+ #
7573
+ # @!attribute [rw] checksum_crc64nvme
7574
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. For
7575
+ # more information, see [Checking object integrity in the Amazon S3
7576
+ # User Guide][1].
7383
7577
  #
7384
7578
  #
7385
7579
  #
@@ -7387,8 +7581,8 @@ module Aws::S3
7387
7581
  # @return [String]
7388
7582
  #
7389
7583
  # @!attribute [rw] checksum_sha1
7390
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
7391
- # only be present if it was uploaded with the object. For more
7584
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
7585
+ # only be present if the object was uploaded with the object. For more
7392
7586
  # information, see [ Checking object integrity][1] in the *Amazon S3
7393
7587
  # User Guide*.
7394
7588
  #
@@ -7398,8 +7592,8 @@ module Aws::S3
7398
7592
  # @return [String]
7399
7593
  #
7400
7594
  # @!attribute [rw] checksum_sha256
7401
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
7402
- # only be present if it was uploaded with the object. For more
7595
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
7596
+ # only be present if the object was uploaded with the object. For more
7403
7597
  # information, see [ Checking object integrity][1] in the *Amazon S3
7404
7598
  # User Guide*.
7405
7599
  #
@@ -7408,6 +7602,19 @@ module Aws::S3
7408
7602
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
7409
7603
  # @return [String]
7410
7604
  #
7605
+ # @!attribute [rw] checksum_type
7606
+ # The checksum type, which determines how part-level checksums are
7607
+ # combined to create an object-level checksum for multipart objects.
7608
+ # You can use this header response to verify that the checksum type
7609
+ # that is received is the same checksum type that was specified in the
7610
+ # `CreateMultipartUpload` request. For more information, see [Checking
7611
+ # object integrity][1] in the *Amazon S3 User Guide*.
7612
+ #
7613
+ #
7614
+ #
7615
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
7616
+ # @return [String]
7617
+ #
7411
7618
  # @!attribute [rw] missing_meta
7412
7619
  # This is set to the number of metadata entries not returned in the
7413
7620
  # headers that are prefixed with `x-amz-meta-`. This can happen if you
@@ -7517,8 +7724,10 @@ module Aws::S3
7517
7724
  # this header for all objects except for S3 Standard storage class
7518
7725
  # objects.
7519
7726
  #
7520
- # <note markdown="1"> <b>Directory buckets </b> - Only the S3 Express One Zone storage
7521
- # class is supported by directory buckets to store objects.
7727
+ # <note markdown="1"> <b>Directory buckets </b> - Directory buckets only support
7728
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
7729
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
7730
+ # Access storage class) in Dedicated Local Zones.
7522
7731
  #
7523
7732
  # </note>
7524
7733
  # @return [String]
@@ -7602,8 +7811,10 @@ module Aws::S3
7602
7811
  :etag,
7603
7812
  :checksum_crc32,
7604
7813
  :checksum_crc32c,
7814
+ :checksum_crc64nvme,
7605
7815
  :checksum_sha1,
7606
7816
  :checksum_sha256,
7817
+ :checksum_type,
7607
7818
  :missing_meta,
7608
7819
  :version_id,
7609
7820
  :cache_control,
@@ -7642,15 +7853,18 @@ module Aws::S3
7642
7853
  # requests are not supported. Directory bucket names must be unique in
7643
7854
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7644
7855
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7645
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7856
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7646
7857
  # naming restrictions, see [Directory bucket naming rules][1] in the
7647
7858
  # *Amazon S3 User Guide*.
7648
7859
  #
7649
- # **Access points** - When you use this action with an access point,
7650
- # you must provide the alias of the access point in place of the
7651
- # bucket name or specify the access point ARN. When using the access
7652
- # point ARN, you must direct requests to the access point hostname.
7653
- # The access point hostname takes the form
7860
+ # **Access points** - When you use this action with an access point
7861
+ # for general purpose buckets, you must provide the alias of the
7862
+ # access point in place of the bucket name or specify the access point
7863
+ # ARN. When you use this action with an access point for directory
7864
+ # buckets, you must provide the access point name in place of the
7865
+ # bucket name. When using the access point ARN, you must direct
7866
+ # requests to the access point hostname. The access point hostname
7867
+ # takes the form
7654
7868
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7655
7869
  # When using this action with an access point through the Amazon Web
7656
7870
  # Services SDKs, you provide the access point ARN in place of the
@@ -7663,19 +7877,18 @@ module Aws::S3
7663
7877
  # hostname takes the form
7664
7878
  # *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
7665
7879
  #
7666
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
7667
- # directory buckets.
7880
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
7668
7881
  #
7669
7882
  # </note>
7670
7883
  #
7671
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7672
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7673
- # The S3 on Outposts hostname takes the form `
7884
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7885
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7886
+ # Outposts hostname takes the form `
7674
7887
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7675
- # When you use this action with S3 on Outposts through the Amazon Web
7676
- # Services SDKs, you provide the Outposts access point ARN in place of
7677
- # the bucket name. For more information about S3 on Outposts ARNs, see
7678
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7888
+ # When you use this action with S3 on Outposts, the destination bucket
7889
+ # must be the Outposts access point ARN or the access point alias. For
7890
+ # more information about S3 on Outposts, see [What is S3 on
7891
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7679
7892
  #
7680
7893
  #
7681
7894
  #
@@ -7949,15 +8162,6 @@ module Aws::S3
7949
8162
  #
7950
8163
  # @!attribute [rw] checksum_mode
7951
8164
  # To retrieve the checksum, this mode must be enabled.
7952
- #
7953
- # **General purpose buckets** - In addition, if you enable checksum
7954
- # mode and the object is uploaded with a [checksum][1] and encrypted
7955
- # with an Key Management Service (KMS) key, you must have permission
7956
- # to use the `kms:Decrypt` action to retrieve the checksum.
7957
- #
7958
- #
7959
- #
7960
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
7961
8165
  # @return [String]
7962
8166
  #
7963
8167
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRequest AWS API Documentation
@@ -8004,11 +8208,14 @@ module Aws::S3
8004
8208
  # The bucket name containing the object whose retention settings you
8005
8209
  # want to retrieve.
8006
8210
  #
8007
- # **Access points** - When you use this action with an access point,
8008
- # you must provide the alias of the access point in place of the
8009
- # bucket name or specify the access point ARN. When using the access
8010
- # point ARN, you must direct requests to the access point hostname.
8011
- # The access point hostname takes the form
8211
+ # **Access points** - When you use this action with an access point
8212
+ # for general purpose buckets, you must provide the alias of the
8213
+ # access point in place of the bucket name or specify the access point
8214
+ # ARN. When you use this action with an access point for directory
8215
+ # buckets, you must provide the access point name in place of the
8216
+ # bucket name. When using the access point ARN, you must direct
8217
+ # requests to the access point hostname. The access point hostname
8218
+ # takes the form
8012
8219
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8013
8220
  # When using this action with an access point through the Amazon Web
8014
8221
  # Services SDKs, you provide the access point ARN in place of the
@@ -8089,25 +8296,28 @@ module Aws::S3
8089
8296
  # The bucket name containing the object for which to get the tagging
8090
8297
  # information.
8091
8298
  #
8092
- # **Access points** - When you use this action with an access point,
8093
- # you must provide the alias of the access point in place of the
8094
- # bucket name or specify the access point ARN. When using the access
8095
- # point ARN, you must direct requests to the access point hostname.
8096
- # The access point hostname takes the form
8299
+ # **Access points** - When you use this action with an access point
8300
+ # for general purpose buckets, you must provide the alias of the
8301
+ # access point in place of the bucket name or specify the access point
8302
+ # ARN. When you use this action with an access point for directory
8303
+ # buckets, you must provide the access point name in place of the
8304
+ # bucket name. When using the access point ARN, you must direct
8305
+ # requests to the access point hostname. The access point hostname
8306
+ # takes the form
8097
8307
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8098
8308
  # When using this action with an access point through the Amazon Web
8099
8309
  # Services SDKs, you provide the access point ARN in place of the
8100
8310
  # bucket name. For more information about access point ARNs, see
8101
8311
  # [Using access points][1] in the *Amazon S3 User Guide*.
8102
8312
  #
8103
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8104
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8105
- # The S3 on Outposts hostname takes the form `
8313
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8314
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8315
+ # Outposts hostname takes the form `
8106
8316
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8107
- # When you use this action with S3 on Outposts through the Amazon Web
8108
- # Services SDKs, you provide the Outposts access point ARN in place of
8109
- # the bucket name. For more information about S3 on Outposts ARNs, see
8110
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8317
+ # When you use this action with S3 on Outposts, the destination bucket
8318
+ # must be the Outposts access point ARN or the access point alias. For
8319
+ # more information about S3 on Outposts, see [What is S3 on
8320
+ # Outposts?][2] in the *Amazon S3 User Guide*.
8111
8321
  #
8112
8322
  #
8113
8323
  #
@@ -8411,15 +8621,18 @@ module Aws::S3
8411
8621
  # requests are not supported. Directory bucket names must be unique in
8412
8622
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8413
8623
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8414
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8624
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
8415
8625
  # naming restrictions, see [Directory bucket naming rules][1] in the
8416
8626
  # *Amazon S3 User Guide*.
8417
8627
  #
8418
- # **Access points** - When you use this action with an access point,
8419
- # you must provide the alias of the access point in place of the
8420
- # bucket name or specify the access point ARN. When using the access
8421
- # point ARN, you must direct requests to the access point hostname.
8422
- # The access point hostname takes the form
8628
+ # **Access points** - When you use this action with an access point
8629
+ # for general purpose buckets, you must provide the alias of the
8630
+ # access point in place of the bucket name or specify the access point
8631
+ # ARN. When you use this action with an access point for directory
8632
+ # buckets, you must provide the access point name in place of the
8633
+ # bucket name. When using the access point ARN, you must direct
8634
+ # requests to the access point hostname. The access point hostname
8635
+ # takes the form
8423
8636
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8424
8637
  # When using this action with an access point through the Amazon Web
8425
8638
  # Services SDKs, you provide the access point ARN in place of the
@@ -8433,19 +8646,18 @@ module Aws::S3
8433
8646
  # `InvalidAccessPointAliasError` is returned. For more information
8434
8647
  # about `InvalidAccessPointAliasError`, see [List of Error Codes][3].
8435
8648
  #
8436
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
8437
- # directory buckets.
8649
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
8438
8650
  #
8439
8651
  # </note>
8440
8652
  #
8441
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8442
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8443
- # The S3 on Outposts hostname takes the form `
8653
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8654
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8655
+ # Outposts hostname takes the form `
8444
8656
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8445
- # When you use this action with S3 on Outposts through the Amazon Web
8446
- # Services SDKs, you provide the Outposts access point ARN in place of
8447
- # the bucket name. For more information about S3 on Outposts ARNs, see
8448
- # [What is S3 on Outposts?][4] in the *Amazon S3 User Guide*.
8657
+ # When you use this action with S3 on Outposts, the destination bucket
8658
+ # must be the Outposts access point ARN or the access point alias. For
8659
+ # more information about S3 on Outposts, see [What is S3 on
8660
+ # Outposts?][4] in the *Amazon S3 User Guide*.
8449
8661
  #
8450
8662
  #
8451
8663
  #
@@ -8521,9 +8733,10 @@ module Aws::S3
8521
8733
  # For more information about archiving objects, see [Transitioning
8522
8734
  # Objects: General Considerations][2].
8523
8735
  #
8524
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
8525
- # S3 Express One Zone storage class is supported by directory buckets
8526
- # to store objects.
8736
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
8737
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
8738
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
8739
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
8527
8740
  #
8528
8741
  # </note>
8529
8742
  #
@@ -8550,14 +8763,14 @@ module Aws::S3
8550
8763
  # @return [Integer]
8551
8764
  #
8552
8765
  # @!attribute [rw] checksum_crc32
8553
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
8554
- # only be present if it was uploaded with the object. When you use an
8555
- # API operation on an object that was uploaded using multipart
8556
- # uploads, this value may not be a direct checksum value of the full
8557
- # object. Instead, it's a calculation based on the checksum values of
8558
- # each individual part. For more information about how checksums are
8559
- # calculated with multipart uploads, see [ Checking object
8560
- # integrity][1] in the *Amazon S3 User Guide*.
8766
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
8767
+ # checksum is only be present if the checksum was uploaded with the
8768
+ # object. When you use an API operation on an object that was uploaded
8769
+ # using multipart uploads, this value may not be a direct checksum
8770
+ # value of the full object. Instead, it's a calculation based on the
8771
+ # checksum values of each individual part. For more information about
8772
+ # how checksums are calculated with multipart uploads, see [ Checking
8773
+ # object integrity][1] in the *Amazon S3 User Guide*.
8561
8774
  #
8562
8775
  #
8563
8776
  #
@@ -8565,24 +8778,34 @@ module Aws::S3
8565
8778
  # @return [String]
8566
8779
  #
8567
8780
  # @!attribute [rw] checksum_crc32c
8568
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
8569
- # only be present if it was uploaded with the object. When you use an
8570
- # API operation on an object that was uploaded using multipart
8571
- # uploads, this value may not be a direct checksum value of the full
8572
- # object. Instead, it's a calculation based on the checksum values of
8573
- # each individual part. For more information about how checksums are
8574
- # calculated with multipart uploads, see [ Checking object
8575
- # integrity][1] in the *Amazon S3 User Guide*.
8781
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
8782
+ # checksum is only present if the checksum was uploaded with the
8783
+ # object. When you use an API operation on an object that was uploaded
8784
+ # using multipart uploads, this value may not be a direct checksum
8785
+ # value of the full object. Instead, it's a calculation based on the
8786
+ # checksum values of each individual part. For more information about
8787
+ # how checksums are calculated with multipart uploads, see [ Checking
8788
+ # object integrity][1] in the *Amazon S3 User Guide*.
8576
8789
  #
8577
8790
  #
8578
8791
  #
8579
8792
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
8580
8793
  # @return [String]
8581
8794
  #
8795
+ # @!attribute [rw] checksum_crc64nvme
8796
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. For
8797
+ # more information, see [Checking object integrity in the Amazon S3
8798
+ # User Guide][1].
8799
+ #
8800
+ #
8801
+ #
8802
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
8803
+ # @return [String]
8804
+ #
8582
8805
  # @!attribute [rw] checksum_sha1
8583
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
8584
- # only be present if it was uploaded with the object. When you use the
8585
- # API operation on an object that was uploaded using multipart
8806
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
8807
+ # only be present if the object was uploaded with the object. When you
8808
+ # use the API operation on an object that was uploaded using multipart
8586
8809
  # uploads, this value may not be a direct checksum value of the full
8587
8810
  # object. Instead, it's a calculation based on the checksum values of
8588
8811
  # each individual part. For more information about how checksums are
@@ -8595,9 +8818,9 @@ module Aws::S3
8595
8818
  # @return [String]
8596
8819
  #
8597
8820
  # @!attribute [rw] checksum_sha256
8598
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
8599
- # only be present if it was uploaded with the object. When you use an
8600
- # API operation on an object that was uploaded using multipart
8821
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
8822
+ # only be present if the object was uploaded with the object. When you
8823
+ # use an API operation on an object that was uploaded using multipart
8601
8824
  # uploads, this value may not be a direct checksum value of the full
8602
8825
  # object. Instead, it's a calculation based on the checksum values of
8603
8826
  # each individual part. For more information about how checksums are
@@ -8609,6 +8832,19 @@ module Aws::S3
8609
8832
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
8610
8833
  # @return [String]
8611
8834
  #
8835
+ # @!attribute [rw] checksum_type
8836
+ # The checksum type, which determines how part-level checksums are
8837
+ # combined to create an object-level checksum for multipart objects.
8838
+ # You can use this header response to verify that the checksum type
8839
+ # that is received is the same checksum type that was specified in
8840
+ # `CreateMultipartUpload` request. For more information, see [Checking
8841
+ # object integrity in the Amazon S3 User Guide][1].
8842
+ #
8843
+ #
8844
+ #
8845
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
8846
+ # @return [String]
8847
+ #
8612
8848
  # @!attribute [rw] etag
8613
8849
  # An entity tag (ETag) is an opaque identifier assigned by a web
8614
8850
  # server to a specific version of a resource found at a URL.
@@ -8656,6 +8892,11 @@ module Aws::S3
8656
8892
  # A standard MIME type describing the format of the object data.
8657
8893
  # @return [String]
8658
8894
  #
8895
+ # @!attribute [rw] content_range
8896
+ # The portion of the object returned in the response for a `GET`
8897
+ # request.
8898
+ # @return [String]
8899
+ #
8659
8900
  # @!attribute [rw] expires
8660
8901
  # The date and time at which the object is no longer cacheable.
8661
8902
  # @return [Time]
@@ -8721,8 +8962,10 @@ module Aws::S3
8721
8962
  #
8722
8963
  # For more information, see [Storage Classes][1].
8723
8964
  #
8724
- # <note markdown="1"> <b>Directory buckets </b> - Only the S3 Express One Zone storage
8725
- # class is supported by directory buckets to store objects.
8965
+ # <note markdown="1"> <b>Directory buckets </b> - Directory buckets only support
8966
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
8967
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
8968
+ # Access storage class) in Dedicated Local Zones.
8726
8969
  #
8727
8970
  # </note>
8728
8971
  #
@@ -8848,8 +9091,10 @@ module Aws::S3
8848
9091
  :content_length,
8849
9092
  :checksum_crc32,
8850
9093
  :checksum_crc32c,
9094
+ :checksum_crc64nvme,
8851
9095
  :checksum_sha1,
8852
9096
  :checksum_sha256,
9097
+ :checksum_type,
8853
9098
  :etag,
8854
9099
  :missing_meta,
8855
9100
  :version_id,
@@ -8858,6 +9103,7 @@ module Aws::S3
8858
9103
  :content_encoding,
8859
9104
  :content_language,
8860
9105
  :content_type,
9106
+ :content_range,
8861
9107
  :expires,
8862
9108
  :expires_string,
8863
9109
  :website_redirect_location,
@@ -8887,34 +9133,36 @@ module Aws::S3
8887
9133
  # requests are not supported. Directory bucket names must be unique in
8888
9134
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8889
9135
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8890
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9136
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
8891
9137
  # naming restrictions, see [Directory bucket naming rules][1] in the
8892
9138
  # *Amazon S3 User Guide*.
8893
9139
  #
8894
- # **Access points** - When you use this action with an access point,
8895
- # you must provide the alias of the access point in place of the
8896
- # bucket name or specify the access point ARN. When using the access
8897
- # point ARN, you must direct requests to the access point hostname.
8898
- # The access point hostname takes the form
9140
+ # **Access points** - When you use this action with an access point
9141
+ # for general purpose buckets, you must provide the alias of the
9142
+ # access point in place of the bucket name or specify the access point
9143
+ # ARN. When you use this action with an access point for directory
9144
+ # buckets, you must provide the access point name in place of the
9145
+ # bucket name. When using the access point ARN, you must direct
9146
+ # requests to the access point hostname. The access point hostname
9147
+ # takes the form
8899
9148
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8900
9149
  # When using this action with an access point through the Amazon Web
8901
9150
  # Services SDKs, you provide the access point ARN in place of the
8902
9151
  # bucket name. For more information about access point ARNs, see
8903
9152
  # [Using access points][2] in the *Amazon S3 User Guide*.
8904
9153
  #
8905
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
8906
- # directory buckets.
9154
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
8907
9155
  #
8908
9156
  # </note>
8909
9157
  #
8910
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8911
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8912
- # The S3 on Outposts hostname takes the form `
9158
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
9159
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
9160
+ # Outposts hostname takes the form `
8913
9161
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8914
- # When you use this action with S3 on Outposts through the Amazon Web
8915
- # Services SDKs, you provide the Outposts access point ARN in place of
8916
- # the bucket name. For more information about S3 on Outposts ARNs, see
8917
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
9162
+ # When you use this action with S3 on Outposts, the destination bucket
9163
+ # must be the Outposts access point ARN or the access point alias. For
9164
+ # more information about S3 on Outposts, see [What is S3 on
9165
+ # Outposts?][3] in the *Amazon S3 User Guide*.
8918
9166
  #
8919
9167
  #
8920
9168
  #
@@ -10421,34 +10669,36 @@ module Aws::S3
10421
10669
  # requests are not supported. Directory bucket names must be unique in
10422
10670
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10423
10671
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10424
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10672
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10425
10673
  # naming restrictions, see [Directory bucket naming rules][1] in the
10426
10674
  # *Amazon S3 User Guide*.
10427
10675
  #
10428
- # **Access points** - When you use this action with an access point,
10429
- # you must provide the alias of the access point in place of the
10430
- # bucket name or specify the access point ARN. When using the access
10431
- # point ARN, you must direct requests to the access point hostname.
10432
- # The access point hostname takes the form
10676
+ # **Access points** - When you use this action with an access point
10677
+ # for general purpose buckets, you must provide the alias of the
10678
+ # access point in place of the bucket name or specify the access point
10679
+ # ARN. When you use this action with an access point for directory
10680
+ # buckets, you must provide the access point name in place of the
10681
+ # bucket name. When using the access point ARN, you must direct
10682
+ # requests to the access point hostname. The access point hostname
10683
+ # takes the form
10433
10684
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
10434
10685
  # When using this action with an access point through the Amazon Web
10435
10686
  # Services SDKs, you provide the access point ARN in place of the
10436
10687
  # bucket name. For more information about access point ARNs, see
10437
10688
  # [Using access points][2] in the *Amazon S3 User Guide*.
10438
10689
  #
10439
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
10440
- # directory buckets.
10690
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
10441
10691
  #
10442
10692
  # </note>
10443
10693
  #
10444
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10445
- # Outposts, you must direct requests to the S3 on Outposts hostname.
10446
- # The S3 on Outposts hostname takes the form `
10694
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
10695
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
10696
+ # Outposts hostname takes the form `
10447
10697
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10448
- # When you use this action with S3 on Outposts through the Amazon Web
10449
- # Services SDKs, you provide the Outposts access point ARN in place of
10450
- # the bucket name. For more information about S3 on Outposts ARNs, see
10451
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
10698
+ # When you use this action with S3 on Outposts, the destination bucket
10699
+ # must be the Outposts access point ARN or the access point alias. For
10700
+ # more information about S3 on Outposts, see [What is S3 on
10701
+ # Outposts?][3] in the *Amazon S3 User Guide*.
10452
10702
  #
10453
10703
  #
10454
10704
  #
@@ -10634,7 +10884,12 @@ module Aws::S3
10634
10884
  # @return [Array<Types::ObjectVersion>]
10635
10885
  #
10636
10886
  # @!attribute [rw] delete_markers
10637
- # Container for an object that is a delete marker.
10887
+ # Container for an object that is a delete marker. To learn more about
10888
+ # delete markers, see [Working with delete markers][1].
10889
+ #
10890
+ #
10891
+ #
10892
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
10638
10893
  # @return [Array<Types::DeleteMarkerEntry>]
10639
10894
  #
10640
10895
  # @!attribute [rw] name
@@ -10943,34 +11198,36 @@ module Aws::S3
10943
11198
  # requests are not supported. Directory bucket names must be unique in
10944
11199
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10945
11200
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10946
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11201
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10947
11202
  # naming restrictions, see [Directory bucket naming rules][1] in the
10948
11203
  # *Amazon S3 User Guide*.
10949
11204
  #
10950
- # **Access points** - When you use this action with an access point,
10951
- # you must provide the alias of the access point in place of the
10952
- # bucket name or specify the access point ARN. When using the access
10953
- # point ARN, you must direct requests to the access point hostname.
10954
- # The access point hostname takes the form
11205
+ # **Access points** - When you use this action with an access point
11206
+ # for general purpose buckets, you must provide the alias of the
11207
+ # access point in place of the bucket name or specify the access point
11208
+ # ARN. When you use this action with an access point for directory
11209
+ # buckets, you must provide the access point name in place of the
11210
+ # bucket name. When using the access point ARN, you must direct
11211
+ # requests to the access point hostname. The access point hostname
11212
+ # takes the form
10955
11213
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
10956
11214
  # When using this action with an access point through the Amazon Web
10957
11215
  # Services SDKs, you provide the access point ARN in place of the
10958
11216
  # bucket name. For more information about access point ARNs, see
10959
11217
  # [Using access points][2] in the *Amazon S3 User Guide*.
10960
11218
  #
10961
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
10962
- # directory buckets.
11219
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
10963
11220
  #
10964
11221
  # </note>
10965
11222
  #
10966
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10967
- # Outposts, you must direct requests to the S3 on Outposts hostname.
10968
- # The S3 on Outposts hostname takes the form `
11223
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11224
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11225
+ # Outposts hostname takes the form `
10969
11226
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10970
- # When you use this action with S3 on Outposts through the Amazon Web
10971
- # Services SDKs, you provide the Outposts access point ARN in place of
10972
- # the bucket name. For more information about S3 on Outposts ARNs, see
10973
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11227
+ # When you use this action with S3 on Outposts, the destination bucket
11228
+ # must be the Outposts access point ARN or the access point alias. For
11229
+ # more information about S3 on Outposts, see [What is S3 on
11230
+ # Outposts?][3] in the *Amazon S3 User Guide*.
10974
11231
  #
10975
11232
  #
10976
11233
  #
@@ -11214,34 +11471,36 @@ module Aws::S3
11214
11471
  # requests are not supported. Directory bucket names must be unique in
11215
11472
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11216
11473
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11217
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11474
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11218
11475
  # naming restrictions, see [Directory bucket naming rules][1] in the
11219
11476
  # *Amazon S3 User Guide*.
11220
11477
  #
11221
- # **Access points** - When you use this action with an access point,
11222
- # you must provide the alias of the access point in place of the
11223
- # bucket name or specify the access point ARN. When using the access
11224
- # point ARN, you must direct requests to the access point hostname.
11225
- # The access point hostname takes the form
11478
+ # **Access points** - When you use this action with an access point
11479
+ # for general purpose buckets, you must provide the alias of the
11480
+ # access point in place of the bucket name or specify the access point
11481
+ # ARN. When you use this action with an access point for directory
11482
+ # buckets, you must provide the access point name in place of the
11483
+ # bucket name. When using the access point ARN, you must direct
11484
+ # requests to the access point hostname. The access point hostname
11485
+ # takes the form
11226
11486
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11227
11487
  # When using this action with an access point through the Amazon Web
11228
11488
  # Services SDKs, you provide the access point ARN in place of the
11229
11489
  # bucket name. For more information about access point ARNs, see
11230
11490
  # [Using access points][2] in the *Amazon S3 User Guide*.
11231
11491
  #
11232
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
11233
- # directory buckets.
11492
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
11234
11493
  #
11235
11494
  # </note>
11236
11495
  #
11237
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11238
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11239
- # The S3 on Outposts hostname takes the form `
11496
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11497
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11498
+ # Outposts hostname takes the form `
11240
11499
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11241
- # When you use this action with S3 on Outposts through the Amazon Web
11242
- # Services SDKs, you provide the Outposts access point ARN in place of
11243
- # the bucket name. For more information about S3 on Outposts ARNs, see
11244
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11500
+ # When you use this action with S3 on Outposts, the destination bucket
11501
+ # must be the Outposts access point ARN or the access point alias. For
11502
+ # more information about S3 on Outposts, see [What is S3 on
11503
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11245
11504
  #
11246
11505
  #
11247
11506
  #
@@ -11475,8 +11734,10 @@ module Aws::S3
11475
11734
  # @!attribute [rw] storage_class
11476
11735
  # The class of storage used to store the uploaded object.
11477
11736
  #
11478
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
11479
- # is supported by directory buckets to store objects.
11737
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
11738
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
11739
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
11740
+ # Access storage class) in Dedicated Local Zones.
11480
11741
  #
11481
11742
  # </note>
11482
11743
  # @return [String]
@@ -11494,6 +11755,19 @@ module Aws::S3
11494
11755
  # The algorithm that was used to create a checksum of the object.
11495
11756
  # @return [String]
11496
11757
  #
11758
+ # @!attribute [rw] checksum_type
11759
+ # The checksum type, which determines how part-level checksums are
11760
+ # combined to create an object-level checksum for multipart objects.
11761
+ # You can use this header response to verify that the checksum type
11762
+ # that is received is the same checksum type that was specified in
11763
+ # `CreateMultipartUpload` request. For more information, see [Checking
11764
+ # object integrity in the Amazon S3 User Guide][1].
11765
+ #
11766
+ #
11767
+ #
11768
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
11769
+ # @return [String]
11770
+ #
11497
11771
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListPartsOutput AWS API Documentation
11498
11772
  #
11499
11773
  class ListPartsOutput < Struct.new(
@@ -11511,7 +11785,8 @@ module Aws::S3
11511
11785
  :owner,
11512
11786
  :storage_class,
11513
11787
  :request_charged,
11514
- :checksum_algorithm)
11788
+ :checksum_algorithm,
11789
+ :checksum_type)
11515
11790
  SENSITIVE = []
11516
11791
  include Aws::Structure
11517
11792
  end
@@ -11525,34 +11800,36 @@ module Aws::S3
11525
11800
  # requests are not supported. Directory bucket names must be unique in
11526
11801
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11527
11802
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11528
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11803
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11529
11804
  # naming restrictions, see [Directory bucket naming rules][1] in the
11530
11805
  # *Amazon S3 User Guide*.
11531
11806
  #
11532
- # **Access points** - When you use this action with an access point,
11533
- # you must provide the alias of the access point in place of the
11534
- # bucket name or specify the access point ARN. When using the access
11535
- # point ARN, you must direct requests to the access point hostname.
11536
- # The access point hostname takes the form
11807
+ # **Access points** - When you use this action with an access point
11808
+ # for general purpose buckets, you must provide the alias of the
11809
+ # access point in place of the bucket name or specify the access point
11810
+ # ARN. When you use this action with an access point for directory
11811
+ # buckets, you must provide the access point name in place of the
11812
+ # bucket name. When using the access point ARN, you must direct
11813
+ # requests to the access point hostname. The access point hostname
11814
+ # takes the form
11537
11815
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11538
11816
  # When using this action with an access point through the Amazon Web
11539
11817
  # Services SDKs, you provide the access point ARN in place of the
11540
11818
  # bucket name. For more information about access point ARNs, see
11541
11819
  # [Using access points][2] in the *Amazon S3 User Guide*.
11542
11820
  #
11543
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
11544
- # directory buckets.
11821
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
11545
11822
  #
11546
11823
  # </note>
11547
11824
  #
11548
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11549
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11550
- # The S3 on Outposts hostname takes the form `
11825
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11826
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11827
+ # Outposts hostname takes the form `
11551
11828
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11552
- # When you use this action with S3 on Outposts through the Amazon Web
11553
- # Services SDKs, you provide the Outposts access point ARN in place of
11554
- # the bucket name. For more information about S3 on Outposts ARNs, see
11555
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11829
+ # When you use this action with S3 on Outposts, the destination bucket
11830
+ # must be the Outposts access point ARN or the access point alias. For
11831
+ # more information about S3 on Outposts, see [What is S3 on
11832
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11556
11833
  #
11557
11834
  #
11558
11835
  #
@@ -11669,8 +11946,8 @@ module Aws::S3
11669
11946
  # Specifies the location where the bucket will be created.
11670
11947
  #
11671
11948
  # For directory buckets, the location type is Availability Zone or Local
11672
- # Zone. For more information about directory buckets, see [Directory
11673
- # buckets][1] in the *Amazon S3 User Guide*.
11949
+ # Zone. For more information about directory buckets, see [Working with
11950
+ # directory buckets][1] in the *Amazon S3 User Guide*.
11674
11951
  #
11675
11952
  # <note markdown="1"> This functionality is only supported by directory buckets.
11676
11953
  #
@@ -11950,8 +12227,10 @@ module Aws::S3
11950
12227
  # @!attribute [rw] storage_class
11951
12228
  # The class of storage used to store the object.
11952
12229
  #
11953
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
11954
- # is supported by directory buckets to store objects.
12230
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
12231
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
12232
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
12233
+ # Access storage class) in Dedicated Local Zones.
11955
12234
  #
11956
12235
  # </note>
11957
12236
  # @return [String]
@@ -11974,6 +12253,16 @@ module Aws::S3
11974
12253
  # The algorithm that was used to create a checksum of the object.
11975
12254
  # @return [String]
11976
12255
  #
12256
+ # @!attribute [rw] checksum_type
12257
+ # The checksum type that is used to calculate the object’s checksum
12258
+ # value. For more information, see [Checking object integrity][1] in
12259
+ # the *Amazon S3 User Guide*.
12260
+ #
12261
+ #
12262
+ #
12263
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12264
+ # @return [String]
12265
+ #
11977
12266
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MultipartUpload AWS API Documentation
11978
12267
  #
11979
12268
  class MultipartUpload < Struct.new(
@@ -11983,7 +12272,8 @@ module Aws::S3
11983
12272
  :storage_class,
11984
12273
  :owner,
11985
12274
  :initiator,
11986
- :checksum_algorithm)
12275
+ :checksum_algorithm,
12276
+ :checksum_type)
11987
12277
  SENSITIVE = []
11988
12278
  include Aws::Structure
11989
12279
  end
@@ -12234,6 +12524,16 @@ module Aws::S3
12234
12524
  # The algorithm that was used to create a checksum of the object.
12235
12525
  # @return [Array<String>]
12236
12526
  #
12527
+ # @!attribute [rw] checksum_type
12528
+ # The checksum type that is used to calculate the object’s checksum
12529
+ # value. For more information, see [Checking object integrity][1] in
12530
+ # the *Amazon S3 User Guide*.
12531
+ #
12532
+ #
12533
+ #
12534
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12535
+ # @return [String]
12536
+ #
12237
12537
  # @!attribute [rw] size
12238
12538
  # Size in bytes of the object
12239
12539
  # @return [Integer]
@@ -12241,8 +12541,10 @@ module Aws::S3
12241
12541
  # @!attribute [rw] storage_class
12242
12542
  # The class of storage used to store the object.
12243
12543
  #
12244
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
12245
- # is supported by directory buckets to store objects.
12544
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
12545
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
12546
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
12547
+ # Access storage class) in Dedicated Local Zones.
12246
12548
  #
12247
12549
  # </note>
12248
12550
  # @return [String]
@@ -12263,9 +12565,10 @@ module Aws::S3
12263
12565
  # archived objects, see [ Working with archived objects][1] in the
12264
12566
  # *Amazon S3 User Guide*.
12265
12567
  #
12266
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
12267
- # S3 Express One Zone storage class is supported by directory buckets
12268
- # to store objects.
12568
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
12569
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
12570
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
12571
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
12269
12572
  #
12270
12573
  # </note>
12271
12574
  #
@@ -12281,6 +12584,7 @@ module Aws::S3
12281
12584
  :last_modified,
12282
12585
  :etag,
12283
12586
  :checksum_algorithm,
12587
+ :checksum_type,
12284
12588
  :size,
12285
12589
  :storage_class,
12286
12590
  :owner,
@@ -12453,11 +12757,10 @@ module Aws::S3
12453
12757
  # @return [Integer]
12454
12758
  #
12455
12759
  # @!attribute [rw] checksum_crc32
12456
- # This header can be used as a data integrity check to verify that the
12457
- # data received is the same data that was originally sent. This header
12458
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
12459
- # For more information, see [Checking object integrity][1] in the
12460
- # *Amazon S3 User Guide*.
12760
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
12761
+ # checksum is present if the multipart upload request was created with
12762
+ # the `CRC32` checksum algorithm. For more information, see [Checking
12763
+ # object integrity][1] in the *Amazon S3 User Guide*.
12461
12764
  #
12462
12765
  #
12463
12766
  #
@@ -12465,48 +12768,49 @@ module Aws::S3
12465
12768
  # @return [String]
12466
12769
  #
12467
12770
  # @!attribute [rw] checksum_crc32c
12468
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
12469
- # only be present if it was uploaded with the object. When you use an
12470
- # API operation on an object that was uploaded using multipart
12471
- # uploads, this value may not be a direct checksum value of the full
12472
- # object. Instead, it's a calculation based on the checksum values of
12473
- # each individual part. For more information about how checksums are
12474
- # calculated with multipart uploads, see [ Checking object
12475
- # integrity][1] in the *Amazon S3 User Guide*.
12771
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
12772
+ # checksum is present if the multipart upload request was created with
12773
+ # the `CRC32C` checksum algorithm. For more information, see [Checking
12774
+ # object integrity][1] in the *Amazon S3 User Guide*.
12476
12775
  #
12477
12776
  #
12478
12777
  #
12479
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
12778
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12779
+ # @return [String]
12780
+ #
12781
+ # @!attribute [rw] checksum_crc64nvme
12782
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
12783
+ # checksum is present if the multipart upload request was created with
12784
+ # the `CRC64NVME` checksum algorithm, or if the object was uploaded
12785
+ # without a checksum (and Amazon S3 added the default checksum,
12786
+ # `CRC64NVME`, to the uploaded object). For more information, see
12787
+ # [Checking object integrity][1] in the *Amazon S3 User Guide*.
12788
+ #
12789
+ #
12790
+ #
12791
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12480
12792
  # @return [String]
12481
12793
  #
12482
12794
  # @!attribute [rw] checksum_sha1
12483
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
12484
- # only be present if it was uploaded with the object. When you use the
12485
- # API operation on an object that was uploaded using multipart
12486
- # uploads, this value may not be a direct checksum value of the full
12487
- # object. Instead, it's a calculation based on the checksum values of
12488
- # each individual part. For more information about how checksums are
12489
- # calculated with multipart uploads, see [ Checking object
12490
- # integrity][1] in the *Amazon S3 User Guide*.
12795
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
12796
+ # checksum is present if the multipart upload request was created with
12797
+ # the `SHA1` checksum algorithm. For more information, see [Checking
12798
+ # object integrity][1] in the *Amazon S3 User Guide*.
12491
12799
  #
12492
12800
  #
12493
12801
  #
12494
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
12802
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12495
12803
  # @return [String]
12496
12804
  #
12497
12805
  # @!attribute [rw] checksum_sha256
12498
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
12499
- # only be present if it was uploaded with the object. When you use an
12500
- # API operation on an object that was uploaded using multipart
12501
- # uploads, this value may not be a direct checksum value of the full
12502
- # object. Instead, it's a calculation based on the checksum values of
12503
- # each individual part. For more information about how checksums are
12504
- # calculated with multipart uploads, see [ Checking object
12505
- # integrity][1] in the *Amazon S3 User Guide*.
12806
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
12807
+ # checksum is present if the multipart upload request was created with
12808
+ # the `SHA256` checksum algorithm. For more information, see [Checking
12809
+ # object integrity][1] in the *Amazon S3 User Guide*.
12506
12810
  #
12507
12811
  #
12508
12812
  #
12509
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
12813
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12510
12814
  # @return [String]
12511
12815
  #
12512
12816
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectPart AWS API Documentation
@@ -12516,6 +12820,7 @@ module Aws::S3
12516
12820
  :size,
12517
12821
  :checksum_crc32,
12518
12822
  :checksum_crc32c,
12823
+ :checksum_crc64nvme,
12519
12824
  :checksum_sha1,
12520
12825
  :checksum_sha256)
12521
12826
  SENSITIVE = []
@@ -12532,6 +12837,16 @@ module Aws::S3
12532
12837
  # The algorithm that was used to create a checksum of the object.
12533
12838
  # @return [Array<String>]
12534
12839
  #
12840
+ # @!attribute [rw] checksum_type
12841
+ # The checksum type that is used to calculate the object’s checksum
12842
+ # value. For more information, see [Checking object integrity][1] in
12843
+ # the *Amazon S3 User Guide*.
12844
+ #
12845
+ #
12846
+ #
12847
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12848
+ # @return [String]
12849
+ #
12535
12850
  # @!attribute [rw] size
12536
12851
  # Size in bytes of the object.
12537
12852
  # @return [Integer]
@@ -12578,6 +12893,7 @@ module Aws::S3
12578
12893
  class ObjectVersion < Struct.new(
12579
12894
  :etag,
12580
12895
  :checksum_algorithm,
12896
+ :checksum_type,
12581
12897
  :size,
12582
12898
  :storage_class,
12583
12899
  :key,
@@ -12753,11 +13069,10 @@ module Aws::S3
12753
13069
  # @return [Integer]
12754
13070
  #
12755
13071
  # @!attribute [rw] checksum_crc32
12756
- # This header can be used as a data integrity check to verify that the
12757
- # data received is the same data that was originally sent. This header
12758
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
12759
- # For more information, see [Checking object integrity][1] in the
12760
- # *Amazon S3 User Guide*.
13072
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
13073
+ # checksum is present if the object was uploaded with the `CRC32`
13074
+ # checksum algorithm. For more information, see [Checking object
13075
+ # integrity][1] in the *Amazon S3 User Guide*.
12761
13076
  #
12762
13077
  #
12763
13078
  #
@@ -12765,41 +13080,45 @@ module Aws::S3
12765
13080
  # @return [String]
12766
13081
  #
12767
13082
  # @!attribute [rw] checksum_crc32c
12768
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
12769
- # only be present if it was uploaded with the object. When you use an
12770
- # API operation on an object that was uploaded using multipart
12771
- # uploads, this value may not be a direct checksum value of the full
12772
- # object. Instead, it's a calculation based on the checksum values of
12773
- # each individual part. For more information about how checksums are
12774
- # calculated with multipart uploads, see [ Checking object
13083
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
13084
+ # checksum is present if the object was uploaded with the `CRC32C`
13085
+ # checksum algorithm. For more information, see [Checking object
12775
13086
  # integrity][1] in the *Amazon S3 User Guide*.
12776
13087
  #
12777
13088
  #
12778
13089
  #
12779
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
13090
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
13091
+ # @return [String]
13092
+ #
13093
+ # @!attribute [rw] checksum_crc64nvme
13094
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
13095
+ # checksum is present if the multipart upload request was created with
13096
+ # the `CRC64NVME` checksum algorithm, or if the object was uploaded
13097
+ # without a checksum (and Amazon S3 added the default checksum,
13098
+ # `CRC64NVME`, to the uploaded object). For more information, see
13099
+ # [Checking object integrity][1] in the *Amazon S3 User Guide*.
13100
+ #
13101
+ #
13102
+ #
13103
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12780
13104
  # @return [String]
12781
13105
  #
12782
13106
  # @!attribute [rw] checksum_sha1
12783
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
12784
- # only be present if it was uploaded with the object. When you use the
12785
- # API operation on an object that was uploaded using multipart
12786
- # uploads, this value may not be a direct checksum value of the full
12787
- # object. Instead, it's a calculation based on the checksum values of
12788
- # each individual part. For more information about how checksums are
12789
- # calculated with multipart uploads, see [ Checking object
13107
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
13108
+ # checksum is present if the object was uploaded with the `SHA1`
13109
+ # checksum algorithm. For more information, see [Checking object
12790
13110
  # integrity][1] in the *Amazon S3 User Guide*.
12791
13111
  #
12792
13112
  #
12793
13113
  #
12794
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
13114
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
12795
13115
  # @return [String]
12796
13116
  #
12797
13117
  # @!attribute [rw] checksum_sha256
12798
- # This header can be used as a data integrity check to verify that the
12799
- # data received is the same data that was originally sent. This header
12800
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
12801
- # For more information, see [Checking object integrity][1] in the
12802
- # *Amazon S3 User Guide*.
13118
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
13119
+ # checksum is present if the object was uploaded with the `SHA256`
13120
+ # checksum algorithm. For more information, see [Checking object
13121
+ # integrity][1] in the *Amazon S3 User Guide*.
12803
13122
  #
12804
13123
  #
12805
13124
  #
@@ -12815,6 +13134,7 @@ module Aws::S3
12815
13134
  :size,
12816
13135
  :checksum_crc32,
12817
13136
  :checksum_crc32c,
13137
+ :checksum_crc64nvme,
12818
13138
  :checksum_sha1,
12819
13139
  :checksum_sha256)
12820
13140
  SENSITIVE = []
@@ -12990,7 +13310,7 @@ module Aws::S3
12990
13310
  # @return [String]
12991
13311
  #
12992
13312
  # @!attribute [rw] checksum_algorithm
12993
- # Indicates the algorithm used to create the checksum for the object
13313
+ # Indicates the algorithm used to create the checksum for the request
12994
13314
  # when you use the SDK. This header will not provide any additional
12995
13315
  # functionality if you don't use the SDK. When you send this header,
12996
13316
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13031,9 +13351,9 @@ module Aws::S3
13031
13351
  # @return [String]
13032
13352
  #
13033
13353
  # @!attribute [rw] content_md5
13034
- # The base64-encoded 128-bit MD5 digest of the data. This header must
13035
- # be used as a message integrity check to verify that the request body
13036
- # was not corrupted in transit. For more information, go to [RFC
13354
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header
13355
+ # must be used as a message integrity check to verify that the request
13356
+ # body was not corrupted in transit. For more information, go to [RFC
13037
13357
  # 1864.][1]
13038
13358
  #
13039
13359
  # For requests made using the Amazon Web Services Command Line
@@ -13046,7 +13366,7 @@ module Aws::S3
13046
13366
  # @return [String]
13047
13367
  #
13048
13368
  # @!attribute [rw] checksum_algorithm
13049
- # Indicates the algorithm used to create the checksum for the object
13369
+ # Indicates the algorithm used to create the checksum for the request
13050
13370
  # when you use the SDK. This header will not provide any additional
13051
13371
  # functionality if you don't use the SDK. When you send this header,
13052
13372
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13157,9 +13477,9 @@ module Aws::S3
13157
13477
  # @return [Types::CORSConfiguration]
13158
13478
  #
13159
13479
  # @!attribute [rw] content_md5
13160
- # The base64-encoded 128-bit MD5 digest of the data. This header must
13161
- # be used as a message integrity check to verify that the request body
13162
- # was not corrupted in transit. For more information, go to [RFC
13480
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header
13481
+ # must be used as a message integrity check to verify that the request
13482
+ # body was not corrupted in transit. For more information, go to [RFC
13163
13483
  # 1864.][1]
13164
13484
  #
13165
13485
  # For requests made using the Amazon Web Services Command Line
@@ -13172,7 +13492,7 @@ module Aws::S3
13172
13492
  # @return [String]
13173
13493
  #
13174
13494
  # @!attribute [rw] checksum_algorithm
13175
- # Indicates the algorithm used to create the checksum for the object
13495
+ # Indicates the algorithm used to create the checksum for the request
13176
13496
  # when you use the SDK. This header will not provide any additional
13177
13497
  # functionality if you don't use the SDK. When you send this header,
13178
13498
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13228,8 +13548,8 @@ module Aws::S3
13228
13548
  # @return [String]
13229
13549
  #
13230
13550
  # @!attribute [rw] content_md5
13231
- # The base64-encoded 128-bit MD5 digest of the server-side encryption
13232
- # configuration.
13551
+ # The Base64 encoded 128-bit `MD5` digest of the server-side
13552
+ # encryption configuration.
13233
13553
  #
13234
13554
  # For requests made using the Amazon Web Services Command Line
13235
13555
  # Interface (CLI) or Amazon Web Services SDKs, this field is
@@ -13241,7 +13561,7 @@ module Aws::S3
13241
13561
  # @return [String]
13242
13562
  #
13243
13563
  # @!attribute [rw] checksum_algorithm
13244
- # Indicates the algorithm used to create the checksum for the object
13564
+ # Indicates the algorithm used to create the checksum for the request
13245
13565
  # when you use the SDK. This header will not provide any additional
13246
13566
  # functionality if you don't use the SDK. When you send this header,
13247
13567
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13382,7 +13702,7 @@ module Aws::S3
13382
13702
  # @return [String]
13383
13703
  #
13384
13704
  # @!attribute [rw] checksum_algorithm
13385
- # Indicates the algorithm used to create the checksum for the object
13705
+ # Indicates the algorithm used to create the checksum for the request
13386
13706
  # when you use the SDK. This header will not provide any additional
13387
13707
  # functionality if you don't use the SDK. When you send this header,
13388
13708
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13459,7 +13779,7 @@ module Aws::S3
13459
13779
  # @return [String]
13460
13780
  #
13461
13781
  # @!attribute [rw] checksum_algorithm
13462
- # Indicates the algorithm used to create the checksum for the object
13782
+ # Indicates the algorithm used to create the checksum for the request
13463
13783
  # when you use the SDK. This header will not provide any additional
13464
13784
  # functionality if you don't use the SDK. When you send this header,
13465
13785
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13514,7 +13834,7 @@ module Aws::S3
13514
13834
  # @return [String]
13515
13835
  #
13516
13836
  # @!attribute [rw] checksum_algorithm
13517
- # Indicates the algorithm used to create the checksum for the object
13837
+ # Indicates the algorithm used to create the checksum for the request
13518
13838
  # when you use the SDK. This header will not provide any additional
13519
13839
  # functionality if you don't use the SDK. When you send this header,
13520
13840
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13627,7 +13947,7 @@ module Aws::S3
13627
13947
  # @return [String]
13628
13948
  #
13629
13949
  # @!attribute [rw] checksum_algorithm
13630
- # Indicates the algorithm used to create the checksum for the object
13950
+ # Indicates the algorithm used to create the checksum for the request
13631
13951
  # when you use the SDK. This header will not provide any additional
13632
13952
  # functionality if you don't use the SDK. When you send this header,
13633
13953
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13734,7 +14054,7 @@ module Aws::S3
13734
14054
  # @return [String]
13735
14055
  #
13736
14056
  # @!attribute [rw] checksum_algorithm
13737
- # Indicates the algorithm used to create the checksum for the object
14057
+ # Indicates the algorithm used to create the checksum for the request
13738
14058
  # when you use the SDK. This header will not provide any additional
13739
14059
  # functionality if you don't use the SDK. When you send this header,
13740
14060
  # there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -13748,6 +14068,8 @@ module Aws::S3
13748
14068
  #
13749
14069
  # * `CRC32C`
13750
14070
  #
14071
+ # * `CRC64NVME`
14072
+ #
13751
14073
  # * `SHA1`
13752
14074
  #
13753
14075
  # * `SHA256`
@@ -13757,10 +14079,8 @@ module Aws::S3
13757
14079
  #
13758
14080
  # If the individual checksum value you provide through
13759
14081
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm
13760
- # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores
13761
- # any provided `ChecksumAlgorithm` parameter and uses the checksum
13762
- # algorithm that matches the provided value in
13763
- # `x-amz-checksum-algorithm `.
14082
+ # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
14083
+ # request with a `BadDigest` error.
13764
14084
  #
13765
14085
  # <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs,
13766
14086
  # `CRC32` is the default checksum algorithm that's used for
@@ -13820,9 +14140,9 @@ module Aws::S3
13820
14140
  # @return [String]
13821
14141
  #
13822
14142
  # @!attribute [rw] content_md5
13823
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
13824
- # header as a message integrity check to verify that the request body
13825
- # was not corrupted in transit. For more information, see [RFC
14143
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use
14144
+ # this header as a message integrity check to verify that the request
14145
+ # body was not corrupted in transit. For more information, see [RFC
13826
14146
  # 1864][1].
13827
14147
  #
13828
14148
  # For requests made using the Amazon Web Services Command Line
@@ -13835,7 +14155,7 @@ module Aws::S3
13835
14155
  # @return [String]
13836
14156
  #
13837
14157
  # @!attribute [rw] checksum_algorithm
13838
- # Indicates the algorithm used to create the checksum for the object
14158
+ # Indicates the algorithm used to create the checksum for the request
13839
14159
  # when you use the SDK. This header will not provide any additional
13840
14160
  # functionality if you don't use the SDK. When you send this header,
13841
14161
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13885,9 +14205,9 @@ module Aws::S3
13885
14205
  # @return [String]
13886
14206
  #
13887
14207
  # @!attribute [rw] content_md5
13888
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
13889
- # header as a message integrity check to verify that the request body
13890
- # was not corrupted in transit. For more information, see [RFC
14208
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use
14209
+ # this header as a message integrity check to verify that the request
14210
+ # body was not corrupted in transit. For more information, see [RFC
13891
14211
  # 1864][1].
13892
14212
  #
13893
14213
  # For requests made using the Amazon Web Services Command Line
@@ -13900,7 +14220,7 @@ module Aws::S3
13900
14220
  # @return [String]
13901
14221
  #
13902
14222
  # @!attribute [rw] checksum_algorithm
13903
- # Indicates the algorithm used to create the checksum for the object
14223
+ # Indicates the algorithm used to create the checksum for the request
13904
14224
  # when you use the SDK. This header will not provide any additional
13905
14225
  # functionality if you don't use the SDK. When you send this header,
13906
14226
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13944,9 +14264,9 @@ module Aws::S3
13944
14264
  # @return [String]
13945
14265
  #
13946
14266
  # @!attribute [rw] content_md5
13947
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
13948
- # header as a message integrity check to verify that the request body
13949
- # was not corrupted in transit. For more information, see [RFC
14267
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use
14268
+ # this header as a message integrity check to verify that the request
14269
+ # body was not corrupted in transit. For more information, see [RFC
13950
14270
  # 1864][1].
13951
14271
  #
13952
14272
  # For requests made using the Amazon Web Services Command Line
@@ -13959,7 +14279,7 @@ module Aws::S3
13959
14279
  # @return [String]
13960
14280
  #
13961
14281
  # @!attribute [rw] checksum_algorithm
13962
- # Indicates the algorithm used to create the checksum for the object
14282
+ # Indicates the algorithm used to create the checksum for the request
13963
14283
  # when you use the SDK. This header will not provide any additional
13964
14284
  # functionality if you don't use the SDK. When you send this header,
13965
14285
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14003,10 +14323,10 @@ module Aws::S3
14003
14323
  # @return [String]
14004
14324
  #
14005
14325
  # @!attribute [rw] content_md5
14006
- # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
14007
- # this header as a message integrity check to verify that the request
14008
- # body was not corrupted in transit. For more information, see [RFC
14009
- # 1864][1].
14326
+ # &gt;The Base64 encoded 128-bit `MD5` digest of the data. You must
14327
+ # use this header as a message integrity check to verify that the
14328
+ # request body was not corrupted in transit. For more information, see
14329
+ # [RFC 1864][1].
14010
14330
  #
14011
14331
  # For requests made using the Amazon Web Services Command Line
14012
14332
  # Interface (CLI) or Amazon Web Services SDKs, this field is
@@ -14018,7 +14338,7 @@ module Aws::S3
14018
14338
  # @return [String]
14019
14339
  #
14020
14340
  # @!attribute [rw] checksum_algorithm
14021
- # Indicates the algorithm used to create the checksum for the object
14341
+ # Indicates the algorithm used to create the checksum for the request
14022
14342
  # when you use the SDK. This header will not provide any additional
14023
14343
  # functionality if you don't use the SDK. When you send this header,
14024
14344
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14069,9 +14389,9 @@ module Aws::S3
14069
14389
  # @return [String]
14070
14390
  #
14071
14391
  # @!attribute [rw] content_md5
14072
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
14073
- # header as a message integrity check to verify that the request body
14074
- # was not corrupted in transit. For more information, see [RFC
14392
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use
14393
+ # this header as a message integrity check to verify that the request
14394
+ # body was not corrupted in transit. For more information, see [RFC
14075
14395
  # 1864][1].
14076
14396
  #
14077
14397
  # For requests made using the Amazon Web Services Command Line
@@ -14084,7 +14404,7 @@ module Aws::S3
14084
14404
  # @return [String]
14085
14405
  #
14086
14406
  # @!attribute [rw] checksum_algorithm
14087
- # Indicates the algorithm used to create the checksum for the object
14407
+ # Indicates the algorithm used to create the checksum for the request
14088
14408
  # when you use the SDK. This header will not provide any additional
14089
14409
  # functionality if you don't use the SDK. When you send this header,
14090
14410
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14158,25 +14478,28 @@ module Aws::S3
14158
14478
  # The bucket name that contains the object to which you want to attach
14159
14479
  # the ACL.
14160
14480
  #
14161
- # **Access points** - When you use this action with an access point,
14162
- # you must provide the alias of the access point in place of the
14163
- # bucket name or specify the access point ARN. When using the access
14164
- # point ARN, you must direct requests to the access point hostname.
14165
- # The access point hostname takes the form
14481
+ # **Access points** - When you use this action with an access point
14482
+ # for general purpose buckets, you must provide the alias of the
14483
+ # access point in place of the bucket name or specify the access point
14484
+ # ARN. When you use this action with an access point for directory
14485
+ # buckets, you must provide the access point name in place of the
14486
+ # bucket name. When using the access point ARN, you must direct
14487
+ # requests to the access point hostname. The access point hostname
14488
+ # takes the form
14166
14489
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14167
14490
  # When using this action with an access point through the Amazon Web
14168
14491
  # Services SDKs, you provide the access point ARN in place of the
14169
14492
  # bucket name. For more information about access point ARNs, see
14170
14493
  # [Using access points][1] in the *Amazon S3 User Guide*.
14171
14494
  #
14172
- # **S3 on Outposts** - When you use this action with Amazon S3 on
14173
- # Outposts, you must direct requests to the S3 on Outposts hostname.
14174
- # The S3 on Outposts hostname takes the form `
14495
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
14496
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
14497
+ # Outposts hostname takes the form `
14175
14498
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
14176
- # When you use this action with S3 on Outposts through the Amazon Web
14177
- # Services SDKs, you provide the Outposts access point ARN in place of
14178
- # the bucket name. For more information about S3 on Outposts ARNs, see
14179
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
14499
+ # When you use this action with S3 on Outposts, the destination bucket
14500
+ # must be the Outposts access point ARN or the access point alias. For
14501
+ # more information about S3 on Outposts, see [What is S3 on
14502
+ # Outposts?][2] in the *Amazon S3 User Guide*.
14180
14503
  #
14181
14504
  #
14182
14505
  #
@@ -14185,9 +14508,9 @@ module Aws::S3
14185
14508
  # @return [String]
14186
14509
  #
14187
14510
  # @!attribute [rw] content_md5
14188
- # The base64-encoded 128-bit MD5 digest of the data. This header must
14189
- # be used as a message integrity check to verify that the request body
14190
- # was not corrupted in transit. For more information, go to [RFC
14511
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header
14512
+ # must be used as a message integrity check to verify that the request
14513
+ # body was not corrupted in transit. For more information, go to [RFC
14191
14514
  # 1864.&gt;][1]
14192
14515
  #
14193
14516
  # For requests made using the Amazon Web Services Command Line
@@ -14327,11 +14650,14 @@ module Aws::S3
14327
14650
  # The bucket name containing the object that you want to place a legal
14328
14651
  # hold on.
14329
14652
  #
14330
- # **Access points** - When you use this action with an access point,
14331
- # you must provide the alias of the access point in place of the
14332
- # bucket name or specify the access point ARN. When using the access
14333
- # point ARN, you must direct requests to the access point hostname.
14334
- # The access point hostname takes the form
14653
+ # **Access points** - When you use this action with an access point
14654
+ # for general purpose buckets, you must provide the alias of the
14655
+ # access point in place of the bucket name or specify the access point
14656
+ # ARN. When you use this action with an access point for directory
14657
+ # buckets, you must provide the access point name in place of the
14658
+ # bucket name. When using the access point ARN, you must direct
14659
+ # requests to the access point hostname. The access point hostname
14660
+ # takes the form
14335
14661
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14336
14662
  # When using this action with an access point through the Amazon Web
14337
14663
  # Services SDKs, you provide the access point ARN in place of the
@@ -14548,14 +14874,14 @@ module Aws::S3
14548
14874
  # @return [String]
14549
14875
  #
14550
14876
  # @!attribute [rw] checksum_crc32
14551
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
14552
- # only be present if it was uploaded with the object. When you use an
14553
- # API operation on an object that was uploaded using multipart
14554
- # uploads, this value may not be a direct checksum value of the full
14555
- # object. Instead, it's a calculation based on the checksum values of
14556
- # each individual part. For more information about how checksums are
14557
- # calculated with multipart uploads, see [ Checking object
14558
- # integrity][1] in the *Amazon S3 User Guide*.
14877
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
14878
+ # checksum is only be present if the checksum was uploaded with the
14879
+ # object. When you use an API operation on an object that was uploaded
14880
+ # using multipart uploads, this value may not be a direct checksum
14881
+ # value of the full object. Instead, it's a calculation based on the
14882
+ # checksum values of each individual part. For more information about
14883
+ # how checksums are calculated with multipart uploads, see [ Checking
14884
+ # object integrity][1] in the *Amazon S3 User Guide*.
14559
14885
  #
14560
14886
  #
14561
14887
  #
@@ -14563,24 +14889,38 @@ module Aws::S3
14563
14889
  # @return [String]
14564
14890
  #
14565
14891
  # @!attribute [rw] checksum_crc32c
14566
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
14567
- # only be present if it was uploaded with the object. When you use an
14568
- # API operation on an object that was uploaded using multipart
14569
- # uploads, this value may not be a direct checksum value of the full
14570
- # object. Instead, it's a calculation based on the checksum values of
14571
- # each individual part. For more information about how checksums are
14572
- # calculated with multipart uploads, see [ Checking object
14573
- # integrity][1] in the *Amazon S3 User Guide*.
14892
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
14893
+ # checksum is only present if the checksum was uploaded with the
14894
+ # object. When you use an API operation on an object that was uploaded
14895
+ # using multipart uploads, this value may not be a direct checksum
14896
+ # value of the full object. Instead, it's a calculation based on the
14897
+ # checksum values of each individual part. For more information about
14898
+ # how checksums are calculated with multipart uploads, see [ Checking
14899
+ # object integrity][1] in the *Amazon S3 User Guide*.
14574
14900
  #
14575
14901
  #
14576
14902
  #
14577
14903
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
14578
14904
  # @return [String]
14579
14905
  #
14906
+ # @!attribute [rw] checksum_crc64nvme
14907
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
14908
+ # header is present if the object was uploaded with the `CRC64NVME`
14909
+ # checksum algorithm, or if it was uploaded without a checksum (and
14910
+ # Amazon S3 added the default checksum, `CRC64NVME`, to the uploaded
14911
+ # object). For more information about how checksums are calculated
14912
+ # with multipart uploads, see [Checking object integrity in the Amazon
14913
+ # S3 User Guide][1].
14914
+ #
14915
+ #
14916
+ #
14917
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
14918
+ # @return [String]
14919
+ #
14580
14920
  # @!attribute [rw] checksum_sha1
14581
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
14582
- # only be present if it was uploaded with the object. When you use the
14583
- # API operation on an object that was uploaded using multipart
14921
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
14922
+ # only be present if the object was uploaded with the object. When you
14923
+ # use the API operation on an object that was uploaded using multipart
14584
14924
  # uploads, this value may not be a direct checksum value of the full
14585
14925
  # object. Instead, it's a calculation based on the checksum values of
14586
14926
  # each individual part. For more information about how checksums are
@@ -14593,9 +14933,9 @@ module Aws::S3
14593
14933
  # @return [String]
14594
14934
  #
14595
14935
  # @!attribute [rw] checksum_sha256
14596
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
14597
- # only be present if it was uploaded with the object. When you use an
14598
- # API operation on an object that was uploaded using multipart
14936
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
14937
+ # only be present if the object was uploaded with the object. When you
14938
+ # use an API operation on an object that was uploaded using multipart
14599
14939
  # uploads, this value may not be a direct checksum value of the full
14600
14940
  # object. Instead, it's a calculation based on the checksum values of
14601
14941
  # each individual part. For more information about how checksums are
@@ -14607,6 +14947,21 @@ module Aws::S3
14607
14947
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
14608
14948
  # @return [String]
14609
14949
  #
14950
+ # @!attribute [rw] checksum_type
14951
+ # This header specifies the checksum type of the object, which
14952
+ # determines how part-level checksums are combined to create an
14953
+ # object-level checksum for multipart objects. For `PutObject`
14954
+ # uploads, the checksum type is always `FULL_OBJECT`. You can use this
14955
+ # header as a data integrity check to verify that the checksum type
14956
+ # that is received is the same checksum that was specified. For more
14957
+ # information, see [Checking object integrity][1] in the *Amazon S3
14958
+ # User Guide*.
14959
+ #
14960
+ #
14961
+ #
14962
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
14963
+ # @return [String]
14964
+ #
14610
14965
  # @!attribute [rw] server_side_encryption
14611
14966
  # The server-side encryption algorithm used when you store this object
14612
14967
  # in Amazon S3.
@@ -14663,8 +15018,8 @@ module Aws::S3
14663
15018
  #
14664
15019
  # @!attribute [rw] ssekms_encryption_context
14665
15020
  # If present, indicates the Amazon Web Services KMS Encryption Context
14666
- # to use for object encryption. The value of this header is a
14667
- # Base64-encoded string of a UTF-8 encoded JSON, which contains the
15021
+ # to use for object encryption. The value of this header is a Base64
15022
+ # encoded string of a UTF-8 encoded JSON, which contains the
14668
15023
  # encryption context as key-value pairs. This value is stored as
14669
15024
  # object metadata and automatically gets passed on to Amazon Web
14670
15025
  # Services KMS for future `GetObject` operations on this object.
@@ -14677,8 +15032,8 @@ module Aws::S3
14677
15032
  # @return [Boolean]
14678
15033
  #
14679
15034
  # @!attribute [rw] size
14680
- # The size of the object in bytes. This will only be present if you
14681
- # append to an object.
15035
+ # The size of the object in bytes. This value is only be present if
15036
+ # you append to an object.
14682
15037
  #
14683
15038
  # <note markdown="1"> This functionality is only supported for objects in the Amazon S3
14684
15039
  # Express One Zone storage class in directory buckets.
@@ -14702,8 +15057,10 @@ module Aws::S3
14702
15057
  :etag,
14703
15058
  :checksum_crc32,
14704
15059
  :checksum_crc32c,
15060
+ :checksum_crc64nvme,
14705
15061
  :checksum_sha1,
14706
15062
  :checksum_sha256,
15063
+ :checksum_type,
14707
15064
  :server_side_encryption,
14708
15065
  :version_id,
14709
15066
  :sse_customer_algorithm,
@@ -14769,34 +15126,36 @@ module Aws::S3
14769
15126
  # requests are not supported. Directory bucket names must be unique in
14770
15127
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
14771
15128
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
14772
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15129
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
14773
15130
  # naming restrictions, see [Directory bucket naming rules][1] in the
14774
15131
  # *Amazon S3 User Guide*.
14775
15132
  #
14776
- # **Access points** - When you use this action with an access point,
14777
- # you must provide the alias of the access point in place of the
14778
- # bucket name or specify the access point ARN. When using the access
14779
- # point ARN, you must direct requests to the access point hostname.
14780
- # The access point hostname takes the form
15133
+ # **Access points** - When you use this action with an access point
15134
+ # for general purpose buckets, you must provide the alias of the
15135
+ # access point in place of the bucket name or specify the access point
15136
+ # ARN. When you use this action with an access point for directory
15137
+ # buckets, you must provide the access point name in place of the
15138
+ # bucket name. When using the access point ARN, you must direct
15139
+ # requests to the access point hostname. The access point hostname
15140
+ # takes the form
14781
15141
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14782
15142
  # When using this action with an access point through the Amazon Web
14783
15143
  # Services SDKs, you provide the access point ARN in place of the
14784
15144
  # bucket name. For more information about access point ARNs, see
14785
15145
  # [Using access points][2] in the *Amazon S3 User Guide*.
14786
15146
  #
14787
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
14788
- # directory buckets.
15147
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
14789
15148
  #
14790
15149
  # </note>
14791
15150
  #
14792
- # **S3 on Outposts** - When you use this action with Amazon S3 on
14793
- # Outposts, you must direct requests to the S3 on Outposts hostname.
14794
- # The S3 on Outposts hostname takes the form `
15151
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15152
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15153
+ # Outposts hostname takes the form `
14795
15154
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
14796
- # When you use this action with S3 on Outposts through the Amazon Web
14797
- # Services SDKs, you provide the Outposts access point ARN in place of
14798
- # the bucket name. For more information about S3 on Outposts ARNs, see
14799
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
15155
+ # When you use this action with S3 on Outposts, the destination bucket
15156
+ # must be the Outposts access point ARN or the access point alias. For
15157
+ # more information about S3 on Outposts, see [What is S3 on
15158
+ # Outposts?][3] in the *Amazon S3 User Guide*.
14800
15159
  #
14801
15160
  #
14802
15161
  #
@@ -14853,7 +15212,7 @@ module Aws::S3
14853
15212
  # @return [Integer]
14854
15213
  #
14855
15214
  # @!attribute [rw] content_md5
14856
- # The base64-encoded 128-bit MD5 digest of the message (without the
15215
+ # The Base64 encoded 128-bit `MD5` digest of the message (without the
14857
15216
  # headers) according to RFC 1864. This header can be used as a message
14858
15217
  # integrity check to verify that the data is the same data that was
14859
15218
  # originally sent. Although it is optional, we recommend using the
@@ -14904,6 +15263,8 @@ module Aws::S3
14904
15263
  #
14905
15264
  # * `CRC32C`
14906
15265
  #
15266
+ # * `CRC64NVME`
15267
+ #
14907
15268
  # * `SHA1`
14908
15269
  #
14909
15270
  # * `SHA256`
@@ -14913,10 +15274,8 @@ module Aws::S3
14913
15274
  #
14914
15275
  # If the individual checksum value you provide through
14915
15276
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm
14916
- # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores
14917
- # any provided `ChecksumAlgorithm` parameter and uses the checksum
14918
- # algorithm that matches the provided value in
14919
- # `x-amz-checksum-algorithm `.
15277
+ # you set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
15278
+ # request with a `BadDigest` error.
14920
15279
  #
14921
15280
  # <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is
14922
15281
  # required for any request to upload an object with a retention period
@@ -14939,7 +15298,7 @@ module Aws::S3
14939
15298
  # @!attribute [rw] checksum_crc32
14940
15299
  # This header can be used as a data integrity check to verify that the
14941
15300
  # data received is the same data that was originally sent. This header
14942
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
15301
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
14943
15302
  # For more information, see [Checking object integrity][1] in the
14944
15303
  # *Amazon S3 User Guide*.
14945
15304
  #
@@ -14951,9 +15310,22 @@ module Aws::S3
14951
15310
  # @!attribute [rw] checksum_crc32c
14952
15311
  # This header can be used as a data integrity check to verify that the
14953
15312
  # data received is the same data that was originally sent. This header
14954
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
14955
- # For more information, see [Checking object integrity][1] in the
14956
- # *Amazon S3 User Guide*.
15313
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
15314
+ # object. For more information, see [Checking object integrity][1] in
15315
+ # the *Amazon S3 User Guide*.
15316
+ #
15317
+ #
15318
+ #
15319
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
15320
+ # @return [String]
15321
+ #
15322
+ # @!attribute [rw] checksum_crc64nvme
15323
+ # This header can be used as a data integrity check to verify that the
15324
+ # data received is the same data that was originally sent. This header
15325
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
15326
+ # object. The `CRC64NVME` checksum is always a full object checksum.
15327
+ # For more information, see [Checking object integrity in the Amazon
15328
+ # S3 User Guide][1].
14957
15329
  #
14958
15330
  #
14959
15331
  #
@@ -14963,7 +15335,7 @@ module Aws::S3
14963
15335
  # @!attribute [rw] checksum_sha1
14964
15336
  # This header can be used as a data integrity check to verify that the
14965
15337
  # data received is the same data that was originally sent. This header
14966
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object.
15338
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
14967
15339
  # For more information, see [Checking object integrity][1] in the
14968
15340
  # *Amazon S3 User Guide*.
14969
15341
  #
@@ -14975,7 +15347,7 @@ module Aws::S3
14975
15347
  # @!attribute [rw] checksum_sha256
14976
15348
  # This header can be used as a data integrity check to verify that the
14977
15349
  # data received is the same data that was originally sent. This header
14978
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
15350
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
14979
15351
  # For more information, see [Checking object integrity][1] in the
14980
15352
  # *Amazon S3 User Guide*.
14981
15353
  #
@@ -15170,8 +15542,10 @@ module Aws::S3
15170
15542
  # specify a different Storage Class. For more information, see
15171
15543
  # [Storage Classes][1] in the *Amazon S3 User Guide*.
15172
15544
  #
15173
- # <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class
15174
- # is supported to store newly created objects.
15545
+ # <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express
15546
+ # One Zone storage class) in Availability Zones and `ONEZONE_IA`
15547
+ # (the S3 One Zone-Infrequent Access storage class) in Dedicated
15548
+ # Local Zones.
15175
15549
  #
15176
15550
  # * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
15177
15551
  #
@@ -15260,21 +15634,17 @@ module Aws::S3
15260
15634
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
15261
15635
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
15262
15636
  #
15263
- # **Directory buckets** - If you specify
15264
- # `x-amz-server-side-encryption` with `aws:kms`, the `
15265
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
15266
- # assigned the ID of the KMS symmetric encryption customer managed key
15267
- # that's configured for your directory bucket's default encryption
15268
- # setting. If you want to specify the `
15269
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
15270
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
15271
- # customer managed key that's configured for your directory bucket's
15272
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
15273
- # Request` error. Only use the key ID or key ARN. The key alias format
15274
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
15275
- # support 1 [customer managed key][1] per directory bucket for the
15276
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
15277
- # (`aws/s3`) isn't supported.
15637
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
15638
+ # recommended to specify the `x-amz-server-side-encryption` header to
15639
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
15640
+ # header implicitly uses the bucket's default KMS customer managed
15641
+ # key ID. If you want to explicitly set the `
15642
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
15643
+ # the bucket's default customer managed key (using key ID or ARN, not
15644
+ # alias). Your SSE-KMS configuration can only support 1 [customer
15645
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
15646
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
15647
+ # specification results in an HTTP `400 Bad Request` error.
15278
15648
  #
15279
15649
  #
15280
15650
  #
@@ -15285,7 +15655,7 @@ module Aws::S3
15285
15655
  # @!attribute [rw] ssekms_encryption_context
15286
15656
  # Specifies the Amazon Web Services KMS Encryption Context as an
15287
15657
  # additional encryption context to use for object encryption. The
15288
- # value of this header is a Base64-encoded string of a UTF-8 encoded
15658
+ # value of this header is a Base64 encoded string of a UTF-8 encoded
15289
15659
  # JSON, which contains the encryption context as key-value pairs. This
15290
15660
  # value is stored as object metadata and automatically gets passed on
15291
15661
  # to Amazon Web Services KMS for future `GetObject` operations on this
@@ -15415,6 +15785,7 @@ module Aws::S3
15415
15785
  :checksum_algorithm,
15416
15786
  :checksum_crc32,
15417
15787
  :checksum_crc32c,
15788
+ :checksum_crc64nvme,
15418
15789
  :checksum_sha1,
15419
15790
  :checksum_sha256,
15420
15791
  :expires,
@@ -15467,11 +15838,14 @@ module Aws::S3
15467
15838
  # The bucket name that contains the object you want to apply this
15468
15839
  # Object Retention configuration to.
15469
15840
  #
15470
- # **Access points** - When you use this action with an access point,
15471
- # you must provide the alias of the access point in place of the
15472
- # bucket name or specify the access point ARN. When using the access
15473
- # point ARN, you must direct requests to the access point hostname.
15474
- # The access point hostname takes the form
15841
+ # **Access points** - When you use this action with an access point
15842
+ # for general purpose buckets, you must provide the alias of the
15843
+ # access point in place of the bucket name or specify the access point
15844
+ # ARN. When you use this action with an access point for directory
15845
+ # buckets, you must provide the access point name in place of the
15846
+ # bucket name. When using the access point ARN, you must direct
15847
+ # requests to the access point hostname. The access point hostname
15848
+ # takes the form
15475
15849
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15476
15850
  # When using this action with an access point through the Amazon Web
15477
15851
  # Services SDKs, you provide the access point ARN in place of the
@@ -15583,25 +15957,28 @@ module Aws::S3
15583
15957
  # @!attribute [rw] bucket
15584
15958
  # The bucket name containing the object.
15585
15959
  #
15586
- # **Access points** - When you use this action with an access point,
15587
- # you must provide the alias of the access point in place of the
15588
- # bucket name or specify the access point ARN. When using the access
15589
- # point ARN, you must direct requests to the access point hostname.
15590
- # The access point hostname takes the form
15960
+ # **Access points** - When you use this action with an access point
15961
+ # for general purpose buckets, you must provide the alias of the
15962
+ # access point in place of the bucket name or specify the access point
15963
+ # ARN. When you use this action with an access point for directory
15964
+ # buckets, you must provide the access point name in place of the
15965
+ # bucket name. When using the access point ARN, you must direct
15966
+ # requests to the access point hostname. The access point hostname
15967
+ # takes the form
15591
15968
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15592
15969
  # When using this action with an access point through the Amazon Web
15593
15970
  # Services SDKs, you provide the access point ARN in place of the
15594
15971
  # bucket name. For more information about access point ARNs, see
15595
15972
  # [Using access points][1] in the *Amazon S3 User Guide*.
15596
15973
  #
15597
- # **S3 on Outposts** - When you use this action with Amazon S3 on
15598
- # Outposts, you must direct requests to the S3 on Outposts hostname.
15599
- # The S3 on Outposts hostname takes the form `
15974
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15975
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15976
+ # Outposts hostname takes the form `
15600
15977
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
15601
- # When you use this action with S3 on Outposts through the Amazon Web
15602
- # Services SDKs, you provide the Outposts access point ARN in place of
15603
- # the bucket name. For more information about S3 on Outposts ARNs, see
15604
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
15978
+ # When you use this action with S3 on Outposts, the destination bucket
15979
+ # must be the Outposts access point ARN or the access point alias. For
15980
+ # more information about S3 on Outposts, see [What is S3 on
15981
+ # Outposts?][2] in the *Amazon S3 User Guide*.
15605
15982
  #
15606
15983
  #
15607
15984
  #
@@ -15836,7 +16213,7 @@ module Aws::S3
15836
16213
  # record frame. To ensure continuous streaming of data, S3 Select
15837
16214
  # might split the same record across multiple record frames instead of
15838
16215
  # aggregating the results in memory. Some S3 clients (for example, the
15839
- # SDK for Java) handle this behavior by creating a `ByteStream` out of
16216
+ # SDKforJava) handle this behavior by creating a `ByteStream` out of
15840
16217
  # the response by default. Other clients might not handle this
15841
16218
  # behavior by default. In those cases, you must aggregate the results
15842
16219
  # on the client side and parse the response.
@@ -16277,25 +16654,28 @@ module Aws::S3
16277
16654
  # @!attribute [rw] bucket
16278
16655
  # The bucket name containing the object to restore.
16279
16656
  #
16280
- # **Access points** - When you use this action with an access point,
16281
- # you must provide the alias of the access point in place of the
16282
- # bucket name or specify the access point ARN. When using the access
16283
- # point ARN, you must direct requests to the access point hostname.
16284
- # The access point hostname takes the form
16657
+ # **Access points** - When you use this action with an access point
16658
+ # for general purpose buckets, you must provide the alias of the
16659
+ # access point in place of the bucket name or specify the access point
16660
+ # ARN. When you use this action with an access point for directory
16661
+ # buckets, you must provide the access point name in place of the
16662
+ # bucket name. When using the access point ARN, you must direct
16663
+ # requests to the access point hostname. The access point hostname
16664
+ # takes the form
16285
16665
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
16286
16666
  # When using this action with an access point through the Amazon Web
16287
16667
  # Services SDKs, you provide the access point ARN in place of the
16288
16668
  # bucket name. For more information about access point ARNs, see
16289
16669
  # [Using access points][1] in the *Amazon S3 User Guide*.
16290
16670
  #
16291
- # **S3 on Outposts** - When you use this action with Amazon S3 on
16292
- # Outposts, you must direct requests to the S3 on Outposts hostname.
16293
- # The S3 on Outposts hostname takes the form `
16671
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
16672
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
16673
+ # Outposts hostname takes the form `
16294
16674
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
16295
- # When you use this action with S3 on Outposts through the Amazon Web
16296
- # Services SDKs, you provide the Outposts access point ARN in place of
16297
- # the bucket name. For more information about S3 on Outposts ARNs, see
16298
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
16675
+ # When you use this action with S3 on Outposts, the destination bucket
16676
+ # must be the Outposts access point ARN or the access point alias. For
16677
+ # more information about S3 on Outposts, see [What is S3 on
16678
+ # Outposts?][2] in the *Amazon S3 User Guide*.
16299
16679
  #
16300
16680
  #
16301
16681
  #
@@ -16442,9 +16822,10 @@ module Aws::S3
16442
16822
  # archived objects, see [ Working with archived objects][1] in the
16443
16823
  # *Amazon S3 User Guide*.
16444
16824
  #
16445
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the S3
16446
- # Express One Zone storage class is supported by directory buckets to
16447
- # store objects.
16825
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
16826
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
16827
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
16828
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
16448
16829
  #
16449
16830
  # </note>
16450
16831
  #
@@ -17015,9 +17396,8 @@ module Aws::S3
17015
17396
  # to a bucket. By default, Amazon S3 uses this KMS key for SSE-KMS.
17016
17397
  #
17017
17398
  # * **Directory buckets** - Your SSE-KMS configuration can only support
17018
- # 1 [customer managed key][2] per directory bucket for the lifetime of
17019
- # the bucket. The [Amazon Web Services managed key][3] (`aws/s3`)
17020
- # isn't supported.
17399
+ # 1 [customer managed key][2] per directory bucket's lifetime. The
17400
+ # [Amazon Web Services managed key][3] (`aws/s3`) isn't supported.
17021
17401
  #
17022
17402
  # * **Directory buckets** - For directory buckets, there are only two
17023
17403
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
@@ -17595,8 +17975,19 @@ module Aws::S3
17595
17975
  #
17596
17976
  # @!attribute [rw] days
17597
17977
  # Indicates the number of days after creation when objects are
17598
- # transitioned to the specified storage class. The value must be a
17599
- # positive integer.
17978
+ # transitioned to the specified storage class. If the specified
17979
+ # storage class is `INTELLIGENT_TIERING`, `GLACIER_IR`, `GLACIER`, or
17980
+ # `DEEP_ARCHIVE`, valid values are `0` or positive integers. If the
17981
+ # specified storage class is `STANDARD_IA` or `ONEZONE_IA`, valid
17982
+ # values are positive integers greater than `30`. Be aware that some
17983
+ # storage classes have a minimum storage duration and that you're
17984
+ # charged for transitioning objects before their minimum storage
17985
+ # duration. For more information, see [ Constraints and considerations
17986
+ # for transitions][1] in the *Amazon S3 User Guide*.
17987
+ #
17988
+ #
17989
+ #
17990
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-transition-general-considerations.html#lifecycle-configuration-constraints
17600
17991
  # @return [Integer]
17601
17992
  #
17602
17993
  # @!attribute [rw] storage_class
@@ -17697,7 +18088,7 @@ module Aws::S3
17697
18088
  # requests are not supported. Directory bucket names must be unique in
17698
18089
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
17699
18090
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
17700
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18091
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
17701
18092
  # naming restrictions, see [Directory bucket naming rules][1] in the
17702
18093
  # *Amazon S3 User Guide*.
17703
18094
  #
@@ -17709,30 +18100,32 @@ module Aws::S3
17709
18100
  #
17710
18101
  # </note>
17711
18102
  #
17712
- # **Access points** - When you use this action with an access point,
17713
- # you must provide the alias of the access point in place of the
17714
- # bucket name or specify the access point ARN. When using the access
17715
- # point ARN, you must direct requests to the access point hostname.
17716
- # The access point hostname takes the form
18103
+ # **Access points** - When you use this action with an access point
18104
+ # for general purpose buckets, you must provide the alias of the
18105
+ # access point in place of the bucket name or specify the access point
18106
+ # ARN. When you use this action with an access point for directory
18107
+ # buckets, you must provide the access point name in place of the
18108
+ # bucket name. When using the access point ARN, you must direct
18109
+ # requests to the access point hostname. The access point hostname
18110
+ # takes the form
17717
18111
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
17718
18112
  # When using this action with an access point through the Amazon Web
17719
18113
  # Services SDKs, you provide the access point ARN in place of the
17720
18114
  # bucket name. For more information about access point ARNs, see
17721
18115
  # [Using access points][2] in the *Amazon S3 User Guide*.
17722
18116
  #
17723
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
17724
- # directory buckets.
18117
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
17725
18118
  #
17726
18119
  # </note>
17727
18120
  #
17728
- # **S3 on Outposts** - When you use this action with Amazon S3 on
17729
- # Outposts, you must direct requests to the S3 on Outposts hostname.
17730
- # The S3 on Outposts hostname takes the form `
18121
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18122
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18123
+ # Outposts hostname takes the form `
17731
18124
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
17732
- # When you use this action with S3 on Outposts through the Amazon Web
17733
- # Services SDKs, you provide the Outposts access point ARN in place of
17734
- # the bucket name. For more information about S3 on Outposts ARNs, see
17735
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18125
+ # When you use this action with S3 on Outposts, the destination bucket
18126
+ # must be the Outposts access point ARN or the access point alias. For
18127
+ # more information about S3 on Outposts, see [What is S3 on
18128
+ # Outposts?][3] in the *Amazon S3 User Guide*.
17736
18129
  #
17737
18130
  #
17738
18131
  #
@@ -18027,14 +18420,14 @@ module Aws::S3
18027
18420
  # @return [String]
18028
18421
  #
18029
18422
  # @!attribute [rw] checksum_crc32
18030
- # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
18031
- # only be present if it was uploaded with the object. When you use an
18032
- # API operation on an object that was uploaded using multipart
18033
- # uploads, this value may not be a direct checksum value of the full
18034
- # object. Instead, it's a calculation based on the checksum values of
18035
- # each individual part. For more information about how checksums are
18036
- # calculated with multipart uploads, see [ Checking object
18037
- # integrity][1] in the *Amazon S3 User Guide*.
18423
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
18424
+ # checksum is only be present if the checksum was uploaded with the
18425
+ # object. When you use an API operation on an object that was uploaded
18426
+ # using multipart uploads, this value may not be a direct checksum
18427
+ # value of the full object. Instead, it's a calculation based on the
18428
+ # checksum values of each individual part. For more information about
18429
+ # how checksums are calculated with multipart uploads, see [ Checking
18430
+ # object integrity][1] in the *Amazon S3 User Guide*.
18038
18431
  #
18039
18432
  #
18040
18433
  #
@@ -18042,24 +18435,36 @@ module Aws::S3
18042
18435
  # @return [String]
18043
18436
  #
18044
18437
  # @!attribute [rw] checksum_crc32c
18045
- # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
18046
- # only be present if it was uploaded with the object. When you use an
18047
- # API operation on an object that was uploaded using multipart
18048
- # uploads, this value may not be a direct checksum value of the full
18049
- # object. Instead, it's a calculation based on the checksum values of
18050
- # each individual part. For more information about how checksums are
18051
- # calculated with multipart uploads, see [ Checking object
18052
- # integrity][1] in the *Amazon S3 User Guide*.
18438
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
18439
+ # checksum is only present if the checksum was uploaded with the
18440
+ # object. When you use an API operation on an object that was uploaded
18441
+ # using multipart uploads, this value may not be a direct checksum
18442
+ # value of the full object. Instead, it's a calculation based on the
18443
+ # checksum values of each individual part. For more information about
18444
+ # how checksums are calculated with multipart uploads, see [ Checking
18445
+ # object integrity][1] in the *Amazon S3 User Guide*.
18053
18446
  #
18054
18447
  #
18055
18448
  #
18056
18449
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
18057
18450
  # @return [String]
18058
18451
  #
18452
+ # @!attribute [rw] checksum_crc64nvme
18453
+ # This header can be used as a data integrity check to verify that the
18454
+ # data received is the same data that was originally sent. This header
18455
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18456
+ # part. For more information, see [Checking object integrity][1] in
18457
+ # the *Amazon S3 User Guide*.
18458
+ #
18459
+ #
18460
+ #
18461
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
18462
+ # @return [String]
18463
+ #
18059
18464
  # @!attribute [rw] checksum_sha1
18060
- # The base64-encoded, 160-bit SHA-1 digest of the object. This will
18061
- # only be present if it was uploaded with the object. When you use the
18062
- # API operation on an object that was uploaded using multipart
18465
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
18466
+ # only be present if the object was uploaded with the object. When you
18467
+ # use the API operation on an object that was uploaded using multipart
18063
18468
  # uploads, this value may not be a direct checksum value of the full
18064
18469
  # object. Instead, it's a calculation based on the checksum values of
18065
18470
  # each individual part. For more information about how checksums are
@@ -18072,9 +18477,9 @@ module Aws::S3
18072
18477
  # @return [String]
18073
18478
  #
18074
18479
  # @!attribute [rw] checksum_sha256
18075
- # The base64-encoded, 256-bit SHA-256 digest of the object. This will
18076
- # only be present if it was uploaded with the object. When you use an
18077
- # API operation on an object that was uploaded using multipart
18480
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
18481
+ # only be present if the object was uploaded with the object. When you
18482
+ # use an API operation on an object that was uploaded using multipart
18078
18483
  # uploads, this value may not be a direct checksum value of the full
18079
18484
  # object. Instead, it's a calculation based on the checksum values of
18080
18485
  # each individual part. For more information about how checksums are
@@ -18134,6 +18539,7 @@ module Aws::S3
18134
18539
  :etag,
18135
18540
  :checksum_crc32,
18136
18541
  :checksum_crc32c,
18542
+ :checksum_crc64nvme,
18137
18543
  :checksum_sha1,
18138
18544
  :checksum_sha256,
18139
18545
  :sse_customer_algorithm,
@@ -18158,34 +18564,36 @@ module Aws::S3
18158
18564
  # requests are not supported. Directory bucket names must be unique in
18159
18565
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
18160
18566
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
18161
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18567
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
18162
18568
  # naming restrictions, see [Directory bucket naming rules][1] in the
18163
18569
  # *Amazon S3 User Guide*.
18164
18570
  #
18165
- # **Access points** - When you use this action with an access point,
18166
- # you must provide the alias of the access point in place of the
18167
- # bucket name or specify the access point ARN. When using the access
18168
- # point ARN, you must direct requests to the access point hostname.
18169
- # The access point hostname takes the form
18571
+ # **Access points** - When you use this action with an access point
18572
+ # for general purpose buckets, you must provide the alias of the
18573
+ # access point in place of the bucket name or specify the access point
18574
+ # ARN. When you use this action with an access point for directory
18575
+ # buckets, you must provide the access point name in place of the
18576
+ # bucket name. When using the access point ARN, you must direct
18577
+ # requests to the access point hostname. The access point hostname
18578
+ # takes the form
18170
18579
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
18171
18580
  # When using this action with an access point through the Amazon Web
18172
18581
  # Services SDKs, you provide the access point ARN in place of the
18173
18582
  # bucket name. For more information about access point ARNs, see
18174
18583
  # [Using access points][2] in the *Amazon S3 User Guide*.
18175
18584
  #
18176
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
18177
- # directory buckets.
18585
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
18178
18586
  #
18179
18587
  # </note>
18180
18588
  #
18181
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18182
- # Outposts, you must direct requests to the S3 on Outposts hostname.
18183
- # The S3 on Outposts hostname takes the form `
18589
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18590
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18591
+ # Outposts hostname takes the form `
18184
18592
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18185
- # When you use this action with S3 on Outposts through the Amazon Web
18186
- # Services SDKs, you provide the Outposts access point ARN in place of
18187
- # the bucket name. For more information about S3 on Outposts ARNs, see
18188
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18593
+ # When you use this action with S3 on Outposts, the destination bucket
18594
+ # must be the Outposts access point ARN or the access point alias. For
18595
+ # more information about S3 on Outposts, see [What is S3 on
18596
+ # Outposts?][3] in the *Amazon S3 User Guide*.
18189
18597
  #
18190
18598
  #
18191
18599
  #
@@ -18200,7 +18608,7 @@ module Aws::S3
18200
18608
  # @return [Integer]
18201
18609
  #
18202
18610
  # @!attribute [rw] content_md5
18203
- # The base64-encoded 128-bit MD5 digest of the part data. This
18611
+ # The Base64 encoded 128-bit MD5 digest of the part data. This
18204
18612
  # parameter is auto-populated when using the command from the CLI.
18205
18613
  # This parameter is required if object lock parameters are specified.
18206
18614
  #
@@ -18232,7 +18640,7 @@ module Aws::S3
18232
18640
  # @!attribute [rw] checksum_crc32
18233
18641
  # This header can be used as a data integrity check to verify that the
18234
18642
  # data received is the same data that was originally sent. This header
18235
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
18643
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
18236
18644
  # For more information, see [Checking object integrity][1] in the
18237
18645
  # *Amazon S3 User Guide*.
18238
18646
  #
@@ -18244,9 +18652,21 @@ module Aws::S3
18244
18652
  # @!attribute [rw] checksum_crc32c
18245
18653
  # This header can be used as a data integrity check to verify that the
18246
18654
  # data received is the same data that was originally sent. This header
18247
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
18248
- # For more information, see [Checking object integrity][1] in the
18249
- # *Amazon S3 User Guide*.
18655
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
18656
+ # object. For more information, see [Checking object integrity][1] in
18657
+ # the *Amazon S3 User Guide*.
18658
+ #
18659
+ #
18660
+ #
18661
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
18662
+ # @return [String]
18663
+ #
18664
+ # @!attribute [rw] checksum_crc64nvme
18665
+ # This header can be used as a data integrity check to verify that the
18666
+ # data received is the same data that was originally sent. This header
18667
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18668
+ # part. For more information, see [Checking object integrity][1] in
18669
+ # the *Amazon S3 User Guide*.
18250
18670
  #
18251
18671
  #
18252
18672
  #
@@ -18256,7 +18676,7 @@ module Aws::S3
18256
18676
  # @!attribute [rw] checksum_sha1
18257
18677
  # This header can be used as a data integrity check to verify that the
18258
18678
  # data received is the same data that was originally sent. This header
18259
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object.
18679
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
18260
18680
  # For more information, see [Checking object integrity][1] in the
18261
18681
  # *Amazon S3 User Guide*.
18262
18682
  #
@@ -18268,7 +18688,7 @@ module Aws::S3
18268
18688
  # @!attribute [rw] checksum_sha256
18269
18689
  # This header can be used as a data integrity check to verify that the
18270
18690
  # data received is the same data that was originally sent. This header
18271
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
18691
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
18272
18692
  # For more information, see [Checking object integrity][1] in the
18273
18693
  # *Amazon S3 User Guide*.
18274
18694
  #
@@ -18359,6 +18779,7 @@ module Aws::S3
18359
18779
  :checksum_algorithm,
18360
18780
  :checksum_crc32,
18361
18781
  :checksum_crc32c,
18782
+ :checksum_crc64nvme,
18362
18783
  :checksum_sha1,
18363
18784
  :checksum_sha256,
18364
18785
  :key,
@@ -18534,7 +18955,7 @@ module Aws::S3
18534
18955
  # @!attribute [rw] checksum_crc32
18535
18956
  # This header can be used as a data integrity check to verify that the
18536
18957
  # data received is the same data that was originally sent. This
18537
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object
18958
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object
18538
18959
  # returned by the Object Lambda function. This may not match the
18539
18960
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18540
18961
  # validation of the checksum values only when the original `GetObject`
@@ -18555,7 +18976,7 @@ module Aws::S3
18555
18976
  # @!attribute [rw] checksum_crc32c
18556
18977
  # This header can be used as a data integrity check to verify that the
18557
18978
  # data received is the same data that was originally sent. This
18558
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object
18979
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object
18559
18980
  # returned by the Object Lambda function. This may not match the
18560
18981
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18561
18982
  # validation of the checksum values only when the original `GetObject`
@@ -18571,10 +18992,22 @@ module Aws::S3
18571
18992
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
18572
18993
  # @return [String]
18573
18994
  #
18995
+ # @!attribute [rw] checksum_crc64nvme
18996
+ # This header can be used as a data integrity check to verify that the
18997
+ # data received is the same data that was originally sent. This header
18998
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18999
+ # part. For more information, see [Checking object integrity][1] in
19000
+ # the *Amazon S3 User Guide*.
19001
+ #
19002
+ #
19003
+ #
19004
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
19005
+ # @return [String]
19006
+ #
18574
19007
  # @!attribute [rw] checksum_sha1
18575
19008
  # This header can be used as a data integrity check to verify that the
18576
19009
  # data received is the same data that was originally sent. This
18577
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object
19010
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object
18578
19011
  # returned by the Object Lambda function. This may not match the
18579
19012
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18580
19013
  # validation of the checksum values only when the original `GetObject`
@@ -18593,7 +19026,7 @@ module Aws::S3
18593
19026
  # @!attribute [rw] checksum_sha256
18594
19027
  # This header can be used as a data integrity check to verify that the
18595
19028
  # data received is the same data that was originally sent. This
18596
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object
19029
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object
18597
19030
  # returned by the Object Lambda function. This may not match the
18598
19031
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18599
19032
  # validation of the checksum values only when the original `GetObject`
@@ -18611,7 +19044,12 @@ module Aws::S3
18611
19044
  #
18612
19045
  # @!attribute [rw] delete_marker
18613
19046
  # Specifies whether an object stored in Amazon S3 is (`true`) or is
18614
- # not (`false`) a delete marker.
19047
+ # not (`false`) a delete marker. To learn more about delete markers,
19048
+ # see [Working with delete markers][1].
19049
+ #
19050
+ #
19051
+ #
19052
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
18615
19053
  # @return [Boolean]
18616
19054
  #
18617
19055
  # @!attribute [rw] etag
@@ -18767,6 +19205,7 @@ module Aws::S3
18767
19205
  :content_type,
18768
19206
  :checksum_crc32,
18769
19207
  :checksum_crc32c,
19208
+ :checksum_crc64nvme,
18770
19209
  :checksum_sha1,
18771
19210
  :checksum_sha256,
18772
19211
  :delete_marker,