aws-sdk-s3 1.176.1 → 1.180.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 +22 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +50 -39
  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 +10 -9
  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 +698 -538
  16. data/lib/aws-sdk-s3/client_api.rb +34 -2
  17. data/lib/aws-sdk-s3/endpoint_provider.rb +260 -277
  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 +48 -6
  21. data/lib/aws-sdk-s3/multipart_upload_part.rb +52 -36
  22. data/lib/aws-sdk-s3/object.rb +142 -110
  23. data/lib/aws-sdk-s3/object_acl.rb +4 -4
  24. data/lib/aws-sdk-s3/object_summary.rb +97 -80
  25. data/lib/aws-sdk-s3/object_version.rb +22 -18
  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 +1017 -671
  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 +52 -31
  45. data/sig/multipart_upload.rbs +8 -1
  46. data/sig/multipart_upload_part.rbs +5 -1
  47. data/sig/object.rbs +13 -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 +63 -34
  53. metadata +5 -5
  54. data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +0 -31
@@ -40,6 +40,7 @@ require 'aws-sdk-s3/plugins/access_grants.rb'
40
40
  require 'aws-sdk-s3/plugins/arn.rb'
41
41
  require 'aws-sdk-s3/plugins/bucket_dns.rb'
42
42
  require 'aws-sdk-s3/plugins/bucket_name_restrictions.rb'
43
+ require 'aws-sdk-s3/plugins/checksum_algorithm.rb'
43
44
  require 'aws-sdk-s3/plugins/dualstack.rb'
44
45
  require 'aws-sdk-s3/plugins/expect_100_continue.rb'
45
46
  require 'aws-sdk-s3/plugins/express_session_auth.rb'
@@ -52,7 +53,6 @@ require 'aws-sdk-s3/plugins/redirects.rb'
52
53
  require 'aws-sdk-s3/plugins/s3_host_id.rb'
53
54
  require 'aws-sdk-s3/plugins/s3_signer.rb'
54
55
  require 'aws-sdk-s3/plugins/sse_cpk.rb'
55
- require 'aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb'
56
56
  require 'aws-sdk-s3/plugins/streaming_retry.rb'
57
57
  require 'aws-sdk-s3/plugins/url_encoded_keys.rb'
58
58
  require 'aws-sdk-core/plugins/event_stream_configuration.rb'
@@ -111,6 +111,7 @@ module Aws::S3
111
111
  add_plugin(Aws::S3::Plugins::ARN)
112
112
  add_plugin(Aws::S3::Plugins::BucketDns)
113
113
  add_plugin(Aws::S3::Plugins::BucketNameRestrictions)
114
+ add_plugin(Aws::S3::Plugins::ChecksumAlgorithm)
114
115
  add_plugin(Aws::S3::Plugins::Dualstack)
115
116
  add_plugin(Aws::S3::Plugins::Expect100Continue)
116
117
  add_plugin(Aws::S3::Plugins::ExpressSessionAuth)
@@ -123,7 +124,6 @@ module Aws::S3
123
124
  add_plugin(Aws::S3::Plugins::S3HostId)
124
125
  add_plugin(Aws::S3::Plugins::S3Signer)
125
126
  add_plugin(Aws::S3::Plugins::SseCpk)
126
- add_plugin(Aws::S3::Plugins::SkipWholeMultipartGetChecksums)
127
127
  add_plugin(Aws::S3::Plugins::StreamingRetry)
128
128
  add_plugin(Aws::S3::Plugins::UrlEncodedKeys)
129
129
  add_plugin(Aws::Plugins::EventStreamConfiguration)
@@ -240,11 +240,8 @@ module Aws::S3
240
240
  # will use the Client Side Monitoring Agent Publisher.
241
241
  #
242
242
  # @option options [Boolean] :compute_checksums (true)
243
- # When `true` a MD5 checksum will be computed and sent in the Content Md5
244
- # header for :put_object and :upload_part. When `false`, MD5 checksums
245
- # will not be computed for these operations. Checksums are still computed
246
- # for operations requiring them. Checksum errors returned by Amazon S3 are
247
- # automatically retried up to `:retry_limit` times.
243
+ # This option is deprecated. Please use `:request_checksum_calculation` instead.
244
+ # When `false`, `request_checksum_calculation` is overridden to `when_required`.
248
245
  #
249
246
  # @option options [Boolean] :convert_params (true)
250
247
  # When `true`, an attempt is made to coerce request parameters into
@@ -340,6 +337,18 @@ module Aws::S3
340
337
  # Used when loading credentials from the shared credentials file
341
338
  # at HOME/.aws/credentials. When not specified, 'default' is used.
342
339
  #
340
+ # @option options [String] :request_checksum_calculation ("when_supported")
341
+ # Determines when a checksum will be calculated for request payloads. Values are:
342
+ #
343
+ # * `when_supported` - (default) When set, a checksum will be
344
+ # calculated for all request payloads of operations modeled with the
345
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
346
+ # `requestAlgorithmMember` is modeled.
347
+ # * `when_required` - When set, a checksum will only be calculated for
348
+ # request payloads of operations modeled with the `httpChecksum` trait where
349
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
350
+ # is modeled and supplied.
351
+ #
343
352
  # @option options [Integer] :request_min_compression_size_bytes (10240)
344
353
  # The minimum size in bytes that triggers compression for request
345
354
  # bodies. The value must be non-negative integer value between 0
@@ -350,6 +359,17 @@ module Aws::S3
350
359
  # where server-side-encryption is used with customer-provided keys.
351
360
  # This should only be disabled for local testing.
352
361
  #
362
+ # @option options [String] :response_checksum_validation ("when_supported")
363
+ # Determines when checksum validation will be performed on response payloads. Values are:
364
+ #
365
+ # * `when_supported` - (default) When set, checksum validation is performed on all
366
+ # response payloads of operations modeled with the `httpChecksum` trait where
367
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
368
+ # are supported.
369
+ # * `when_required` - When set, checksum validation is not performed on
370
+ # response payloads of operations unless the checksum algorithm is supported and
371
+ # the `requestValidationModeMember` member is set to `ENABLED`.
372
+ #
353
373
  # @option options [Proc] :retry_backoff
354
374
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
355
375
  # This option is only used in the `legacy` retry mode.
@@ -577,13 +597,13 @@ module Aws::S3
577
597
  # * **Directory buckets** - For directory buckets, you must make
578
598
  # requests for this API operation to the Zonal endpoint. These
579
599
  # endpoints support virtual-hosted-style requests in the format
580
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
600
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
581
601
  # `. Path-style requests are not supported. For more information about
582
602
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
583
603
  # for directory buckets in Availability Zones][2] in the *Amazon S3
584
604
  # User Guide*. For more information about endpoints in Local Zones,
585
- # see [Available Local Zone for directory buckets][3] in the *Amazon
586
- # S3 User Guide*.
605
+ # see [Concepts for directory buckets in Local Zones][3] in the
606
+ # *Amazon S3 User Guide*.
587
607
  #
588
608
  # </note>
589
609
  #
@@ -627,7 +647,7 @@ module Aws::S3
627
647
  #
628
648
  #
629
649
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
630
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
650
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
631
651
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
632
652
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
633
653
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -645,7 +665,7 @@ module Aws::S3
645
665
  # requests are not supported. Directory bucket names must be unique in
646
666
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
647
667
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
648
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
668
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
649
669
  # naming restrictions, see [Directory bucket naming rules][1] in the
650
670
  # *Amazon S3 User Guide*.
651
671
  #
@@ -665,14 +685,14 @@ module Aws::S3
665
685
  #
666
686
  # </note>
667
687
  #
668
- # **S3 on Outposts** - When you use this action with Amazon S3 on
669
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
670
- # S3 on Outposts hostname takes the form `
688
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
689
+ # must direct requests to the S3 on Outposts hostname. The S3 on
690
+ # Outposts hostname takes the form `
671
691
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
672
- # When you use this action with S3 on Outposts through the Amazon Web
673
- # Services SDKs, you provide the Outposts access point ARN in place of
674
- # the bucket name. For more information about S3 on Outposts ARNs, see
675
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
692
+ # When you use this action with S3 on Outposts, the destination bucket
693
+ # must be the Outposts access point ARN or the access point alias. For
694
+ # more information about S3 on Outposts, see [What is S3 on
695
+ # Outposts?][3] in the *Amazon S3 User Guide*.
676
696
  #
677
697
  #
678
698
  #
@@ -810,13 +830,13 @@ module Aws::S3
810
830
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
811
831
  # for this API operation to the Zonal endpoint. These endpoints support
812
832
  # virtual-hosted-style requests in the format
813
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
833
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
814
834
  # `. Path-style requests are not supported. For more information about
815
835
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
816
836
  # directory buckets in Availability Zones][5] in the *Amazon S3 User
817
837
  # Guide*. For more information about endpoints in Local Zones, see
818
- # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
819
- # Guide*.
838
+ # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
839
+ # User Guide*.
820
840
  #
821
841
  # </note>
822
842
  #
@@ -903,7 +923,7 @@ module Aws::S3
903
923
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
904
924
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
905
925
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
906
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
926
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
907
927
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
908
928
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
909
929
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
@@ -922,7 +942,7 @@ module Aws::S3
922
942
  # requests are not supported. Directory bucket names must be unique in
923
943
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
924
944
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
925
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
945
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
926
946
  # naming restrictions, see [Directory bucket naming rules][1] in the
927
947
  # *Amazon S3 User Guide*.
928
948
  #
@@ -942,14 +962,14 @@ module Aws::S3
942
962
  #
943
963
  # </note>
944
964
  #
945
- # **S3 on Outposts** - When you use this action with Amazon S3 on
946
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
947
- # S3 on Outposts hostname takes the form `
965
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
966
+ # must direct requests to the S3 on Outposts hostname. The S3 on
967
+ # Outposts hostname takes the form `
948
968
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
949
- # When you use this action with S3 on Outposts through the Amazon Web
950
- # Services SDKs, you provide the Outposts access point ARN in place of
951
- # the bucket name. For more information about S3 on Outposts ARNs, see
952
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
969
+ # When you use this action with S3 on Outposts, the destination bucket
970
+ # must be the Outposts access point ARN or the access point alias. For
971
+ # more information about S3 on Outposts, see [What is S3 on
972
+ # Outposts?][3] in the *Amazon S3 User Guide*.
953
973
  #
954
974
  #
955
975
  #
@@ -969,7 +989,7 @@ module Aws::S3
969
989
  # @option params [String] :checksum_crc32
970
990
  # This header can be used as a data integrity check to verify that the
971
991
  # data received is the same data that was originally sent. This header
972
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
992
+ # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
973
993
  # For more information, see [Checking object integrity][1] in the
974
994
  # *Amazon S3 User Guide*.
975
995
  #
@@ -980,7 +1000,7 @@ module Aws::S3
980
1000
  # @option params [String] :checksum_crc32c
981
1001
  # This header can be used as a data integrity check to verify that the
982
1002
  # data received is the same data that was originally sent. This header
983
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
1003
+ # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
984
1004
  # For more information, see [Checking object integrity][1] in the
985
1005
  # *Amazon S3 User Guide*.
986
1006
  #
@@ -988,12 +1008,24 @@ module Aws::S3
988
1008
  #
989
1009
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
990
1010
  #
1011
+ # @option params [String] :checksum_crc64nvme
1012
+ # This header can be used as a data integrity check to verify that the
1013
+ # data received is the same data that was originally sent. This header
1014
+ # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
1015
+ # object. The `CRC-64NVME` checksum is always a full object checksum.
1016
+ # For more information, see [Checking object integrity in the Amazon S3
1017
+ # User Guide][1].
1018
+ #
1019
+ #
1020
+ #
1021
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1022
+ #
991
1023
  # @option params [String] :checksum_sha1
992
1024
  # This header can be used as a data integrity check to verify that the
993
1025
  # data received is the same data that was originally sent. This header
994
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object. For
995
- # more information, see [Checking object integrity][1] in the *Amazon S3
996
- # User Guide*.
1026
+ # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
1027
+ # For more information, see [Checking object integrity][1] in the
1028
+ # *Amazon S3 User Guide*.
997
1029
  #
998
1030
  #
999
1031
  #
@@ -1002,7 +1034,7 @@ module Aws::S3
1002
1034
  # @option params [String] :checksum_sha256
1003
1035
  # This header can be used as a data integrity check to verify that the
1004
1036
  # data received is the same data that was originally sent. This header
1005
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
1037
+ # specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
1006
1038
  # For more information, see [Checking object integrity][1] in the
1007
1039
  # *Amazon S3 User Guide*.
1008
1040
  #
@@ -1010,6 +1042,23 @@ module Aws::S3
1010
1042
  #
1011
1043
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
1012
1044
  #
1045
+ # @option params [String] :checksum_type
1046
+ # This header specifies the checksum type of the object, which
1047
+ # determines how part-level checksums are combined to create an
1048
+ # object-level checksum for multipart objects. You can use this header
1049
+ # as a data integrity check to verify that the checksum type that is
1050
+ # received is the same checksum that was specified. If the checksum type
1051
+ # doesn’t match the checksum type that was specified for the object
1052
+ # during the `CreateMultipartUpload` request, it’ll result in a
1053
+ # `BadDigest` error. For more information, see Checking object integrity
1054
+ # in the Amazon S3 User Guide.
1055
+ #
1056
+ # @option params [Integer] :mpu_object_size
1057
+ # The expected total object size of the multipart upload request. If
1058
+ # there’s a mismatch between the specified object size value and the
1059
+ # actual object size value, it results in an `HTTP 400 InvalidRequest`
1060
+ # error.
1061
+ #
1013
1062
  # @option params [String] :request_payer
1014
1063
  # Confirms that the requester knows that they will be charged for the
1015
1064
  # request. Bucket owners need not specify this parameter in their
@@ -1125,8 +1174,10 @@ module Aws::S3
1125
1174
  # * {Types::CompleteMultipartUploadOutput#etag #etag} => String
1126
1175
  # * {Types::CompleteMultipartUploadOutput#checksum_crc32 #checksum_crc32} => String
1127
1176
  # * {Types::CompleteMultipartUploadOutput#checksum_crc32c #checksum_crc32c} => String
1177
+ # * {Types::CompleteMultipartUploadOutput#checksum_crc64nvme #checksum_crc64nvme} => String
1128
1178
  # * {Types::CompleteMultipartUploadOutput#checksum_sha1 #checksum_sha1} => String
1129
1179
  # * {Types::CompleteMultipartUploadOutput#checksum_sha256 #checksum_sha256} => String
1180
+ # * {Types::CompleteMultipartUploadOutput#checksum_type #checksum_type} => String
1130
1181
  # * {Types::CompleteMultipartUploadOutput#server_side_encryption #server_side_encryption} => String
1131
1182
  # * {Types::CompleteMultipartUploadOutput#version_id #version_id} => String
1132
1183
  # * {Types::CompleteMultipartUploadOutput#ssekms_key_id #ssekms_key_id} => String
@@ -1175,6 +1226,7 @@ module Aws::S3
1175
1226
  # etag: "ETag",
1176
1227
  # checksum_crc32: "ChecksumCRC32",
1177
1228
  # checksum_crc32c: "ChecksumCRC32C",
1229
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
1178
1230
  # checksum_sha1: "ChecksumSHA1",
1179
1231
  # checksum_sha256: "ChecksumSHA256",
1180
1232
  # part_number: 1,
@@ -1184,8 +1236,11 @@ module Aws::S3
1184
1236
  # upload_id: "MultipartUploadId", # required
1185
1237
  # checksum_crc32: "ChecksumCRC32",
1186
1238
  # checksum_crc32c: "ChecksumCRC32C",
1239
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
1187
1240
  # checksum_sha1: "ChecksumSHA1",
1188
1241
  # checksum_sha256: "ChecksumSHA256",
1242
+ # checksum_type: "COMPOSITE", # accepts COMPOSITE, FULL_OBJECT
1243
+ # mpu_object_size: 1,
1189
1244
  # request_payer: "requester", # accepts requester
1190
1245
  # expected_bucket_owner: "AccountId",
1191
1246
  # if_match: "IfMatch",
@@ -1204,8 +1259,10 @@ module Aws::S3
1204
1259
  # resp.etag #=> String
1205
1260
  # resp.checksum_crc32 #=> String
1206
1261
  # resp.checksum_crc32c #=> String
1262
+ # resp.checksum_crc64nvme #=> String
1207
1263
  # resp.checksum_sha1 #=> String
1208
1264
  # resp.checksum_sha256 #=> String
1265
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
1209
1266
  # resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
1210
1267
  # resp.version_id #=> String
1211
1268
  # resp.ssekms_key_id #=> String
@@ -1242,13 +1299,13 @@ module Aws::S3
1242
1299
  # * <b>Directory buckets </b> - For directory buckets, you must make
1243
1300
  # requests for this API operation to the Zonal endpoint. These
1244
1301
  # endpoints support virtual-hosted-style requests in the format
1245
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
1302
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
1246
1303
  # `. Path-style requests are not supported. For more information about
1247
1304
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
1248
1305
  # for directory buckets in Availability Zones][2] in the *Amazon S3
1249
1306
  # User Guide*. For more information about endpoints in Local Zones,
1250
- # see [Available Local Zone for directory buckets][3] in the *Amazon
1251
- # S3 User Guide*.
1307
+ # see [Concepts for directory buckets in Local Zones][3] in the
1308
+ # *Amazon S3 User Guide*.
1252
1309
  #
1253
1310
  # * VPC endpoints don't support cross-Region requests (including
1254
1311
  # copies). If you're using VPC endpoints, your source and destination
@@ -1374,9 +1431,15 @@ module Aws::S3
1374
1431
  # account. For pricing information, see [Amazon S3 pricing][10].
1375
1432
  #
1376
1433
  # HTTP Host header syntax
1434
+ # : * <b>Directory buckets </b> - The HTTP Host header syntax is `
1435
+ # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1377
1436
  #
1378
- # : <b>Directory buckets </b> - The HTTP Host header syntax is `
1379
- # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
1437
+ # * **Amazon S3 on Outposts** - When you use this action with S3 on
1438
+ # Outposts through the REST API, you must direct requests to the S3
1439
+ # on Outposts hostname. The S3 on Outposts hostname takes the form `
1440
+ # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1441
+ # The hostname isn't required when you use the Amazon Web Services
1442
+ # CLI or SDKs.
1380
1443
  #
1381
1444
  # The following operations are related to `CopyObject`:
1382
1445
  #
@@ -1387,7 +1450,7 @@ module Aws::S3
1387
1450
  #
1388
1451
  #
1389
1452
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
1390
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
1453
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
1391
1454
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
1392
1455
  # [4]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
1393
1456
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
@@ -1441,7 +1504,7 @@ module Aws::S3
1441
1504
  # requests are not supported. Directory bucket names must be unique in
1442
1505
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1443
1506
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1444
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1507
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1445
1508
  # naming restrictions, see [Directory bucket naming rules][1] in the
1446
1509
  # *Amazon S3 User Guide*.
1447
1510
  #
@@ -1469,14 +1532,19 @@ module Aws::S3
1469
1532
  #
1470
1533
  # </note>
1471
1534
  #
1472
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1473
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
1474
- # S3 on Outposts hostname takes the form `
1535
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
1536
+ # must use the Outpost bucket access point ARN or the access point alias
1537
+ # for the destination bucket. You can only copy objects within the same
1538
+ # Outpost bucket. It's not supported to copy objects across different
1539
+ # Amazon Web Services Outposts, between buckets on the same Outposts, or
1540
+ # between Outposts buckets and any other bucket types. For more
1541
+ # information about S3 on Outposts, see [What is S3 on Outposts?][3] in
1542
+ # the *S3 on Outposts guide*. When you use this action with S3 on
1543
+ # Outposts through the REST API, you must direct requests to the S3 on
1544
+ # Outposts hostname, in the format `
1475
1545
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1476
- # When you use this action with S3 on Outposts through the Amazon Web
1477
- # Services SDKs, you provide the Outposts access point ARN in place of
1478
- # the bucket name. For more information about S3 on Outposts ARNs, see
1479
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1546
+ # The hostname isn't required when you use the Amazon Web Services CLI
1547
+ # or SDKs.
1480
1548
  #
1481
1549
  #
1482
1550
  #
@@ -1955,20 +2023,17 @@ module Aws::S3
1955
2023
  # Signature Version in Request Authentication][1] in the *Amazon S3 User
1956
2024
  # Guide*.
1957
2025
  #
1958
- # **Directory buckets** - If you specify `x-amz-server-side-encryption`
1959
- # with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
1960
- # header is implicitly assigned the ID of the KMS symmetric encryption
1961
- # customer managed key that's configured for your directory bucket's
1962
- # default encryption setting. If you want to specify the `
1963
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
1964
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
1965
- # customer managed key that's configured for your directory bucket's
1966
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
1967
- # Request` error. Only use the key ID or key ARN. The key alias format
1968
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
1969
- # support 1 [customer managed key][2] per directory bucket for the
1970
- # lifetime of the bucket. The [Amazon Web Services managed key][3]
1971
- # (`aws/s3`) isn't supported.
2026
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
2027
+ # recommended to specify the `x-amz-server-side-encryption` header to
2028
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
2029
+ # header implicitly uses the bucket's default KMS customer managed key
2030
+ # ID. If you want to explicitly set the `
2031
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
2032
+ # bucket's default customer managed key (using key ID or ARN, not
2033
+ # alias). Your SSE-KMS configuration can only support 1 [customer
2034
+ # managed key][2] per directory bucket's lifetime. The [Amazon Web
2035
+ # Services managed key][3] (`aws/s3`) isn't supported. Incorrect key
2036
+ # specification results in an HTTP `400 Bad Request` error.
1972
2037
  #
1973
2038
  #
1974
2039
  #
@@ -2207,7 +2272,7 @@ module Aws::S3
2207
2272
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control
2208
2273
  # bucket: "BucketName", # required
2209
2274
  # cache_control: "CacheControl",
2210
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
2275
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
2211
2276
  # content_disposition: "ContentDisposition",
2212
2277
  # content_encoding: "ContentEncoding",
2213
2278
  # content_language: "ContentLanguage",
@@ -2253,8 +2318,10 @@ module Aws::S3
2253
2318
  #
2254
2319
  # resp.copy_object_result.etag #=> String
2255
2320
  # resp.copy_object_result.last_modified #=> Time
2321
+ # resp.copy_object_result.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
2256
2322
  # resp.copy_object_result.checksum_crc32 #=> String
2257
2323
  # resp.copy_object_result.checksum_crc32c #=> String
2324
+ # resp.copy_object_result.checksum_crc64nvme #=> String
2258
2325
  # resp.copy_object_result.checksum_sha1 #=> String
2259
2326
  # resp.copy_object_result.checksum_sha256 #=> String
2260
2327
  # resp.expiration #=> String
@@ -2310,8 +2377,8 @@ module Aws::S3
2310
2377
  # information about endpoints in Availability Zones, see [Regional and
2311
2378
  # Zonal endpoints for directory buckets in Availability Zones][4] in
2312
2379
  # the *Amazon S3 User Guide*. For more information about endpoints in
2313
- # Local Zones, see [Available Local Zone for directory buckets][5] in
2314
- # the *Amazon S3 User Guide*.
2380
+ # Local Zones, see [Concepts for directory buckets in Local Zones][5]
2381
+ # in the *Amazon S3 User Guide*.
2315
2382
  #
2316
2383
  # </note>
2317
2384
  #
@@ -2403,7 +2470,7 @@ module Aws::S3
2403
2470
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
2404
2471
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2405
2472
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2406
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2473
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
2407
2474
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2408
2475
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2409
2476
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
@@ -2569,7 +2636,7 @@ module Aws::S3
2569
2636
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read
2570
2637
  # bucket: "BucketName", # required
2571
2638
  # create_bucket_configuration: {
2572
- # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
2639
+ # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-4, ap-southeast-5, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-central-2, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, il-central-1, me-central-1, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
2573
2640
  # location: {
2574
2641
  # type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
2575
2642
  # name: "LocationNameAsString",
@@ -2666,7 +2733,7 @@ module Aws::S3
2666
2733
  # resp = client.create_bucket_metadata_table_configuration({
2667
2734
  # bucket: "BucketName", # required
2668
2735
  # content_md5: "ContentMD5",
2669
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
2736
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
2670
2737
  # metadata_table_configuration: { # required
2671
2738
  # s3_tables_destination: { # required
2672
2739
  # table_bucket_arn: "S3TablesBucketArn", # required
@@ -2716,13 +2783,13 @@ module Aws::S3
2716
2783
  # * <b>Directory buckets </b> - For directory buckets, you must make
2717
2784
  # requests for this API operation to the Zonal endpoint. These
2718
2785
  # endpoints support virtual-hosted-style requests in the format
2719
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
2786
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
2720
2787
  # `. Path-style requests are not supported. For more information about
2721
2788
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
2722
2789
  # for directory buckets in Availability Zones][4] in the *Amazon S3
2723
2790
  # User Guide*. For more information about endpoints in Local Zones,
2724
- # see [Available Local Zone for directory buckets][5] in the *Amazon
2725
- # S3 User Guide*.
2791
+ # see [Concepts for directory buckets in Local Zones][5] in the
2792
+ # *Amazon S3 User Guide*.
2726
2793
  #
2727
2794
  # </note>
2728
2795
  #
@@ -2924,7 +2991,7 @@ module Aws::S3
2924
2991
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
2925
2992
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
2926
2993
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
2927
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
2994
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
2928
2995
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2929
2996
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
2930
2997
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
@@ -2976,7 +3043,7 @@ module Aws::S3
2976
3043
  # requests are not supported. Directory bucket names must be unique in
2977
3044
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
2978
3045
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
2979
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3046
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
2980
3047
  # naming restrictions, see [Directory bucket naming rules][1] in the
2981
3048
  # *Amazon S3 User Guide*.
2982
3049
  #
@@ -2996,14 +3063,14 @@ module Aws::S3
2996
3063
  #
2997
3064
  # </note>
2998
3065
  #
2999
- # **S3 on Outposts** - When you use this action with Amazon S3 on
3000
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
3001
- # S3 on Outposts hostname takes the form `
3066
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
3067
+ # must direct requests to the S3 on Outposts hostname. The S3 on
3068
+ # Outposts hostname takes the form `
3002
3069
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
3003
- # When you use this action with S3 on Outposts through the Amazon Web
3004
- # Services SDKs, you provide the Outposts access point ARN in place of
3005
- # the bucket name. For more information about S3 on Outposts ARNs, see
3006
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
3070
+ # When you use this action with S3 on Outposts, the destination bucket
3071
+ # must be the Outposts access point ARN or the access point alias. For
3072
+ # more information about S3 on Outposts, see [What is S3 on
3073
+ # Outposts?][3] in the *Amazon S3 User Guide*.
3007
3074
  #
3008
3075
  #
3009
3076
  #
@@ -3419,20 +3486,17 @@ module Aws::S3
3419
3486
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
3420
3487
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
3421
3488
  #
3422
- # **Directory buckets** - If you specify `x-amz-server-side-encryption`
3423
- # with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
3424
- # header is implicitly assigned the ID of the KMS symmetric encryption
3425
- # customer managed key that's configured for your directory bucket's
3426
- # default encryption setting. If you want to specify the `
3427
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
3428
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
3429
- # customer managed key that's configured for your directory bucket's
3430
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
3431
- # Request` error. Only use the key ID or key ARN. The key alias format
3432
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
3433
- # support 1 [customer managed key][1] per directory bucket for the
3434
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
3435
- # (`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 key
3493
+ # ID. If you want to explicitly set the `
3494
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
3495
+ # 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.
3436
3500
  #
3437
3501
  #
3438
3502
  #
@@ -3441,7 +3505,7 @@ module Aws::S3
3441
3505
  #
3442
3506
  # @option params [String] :ssekms_encryption_context
3443
3507
  # Specifies the Amazon Web Services KMS Encryption Context to use for
3444
- # object encryption. The value of this header is a Base64-encoded string
3508
+ # object encryption. The value of this header is a Base64 encoded string
3445
3509
  # of a UTF-8 encoded JSON, which contains the encryption context as
3446
3510
  # key-value pairs.
3447
3511
  #
@@ -3539,6 +3603,15 @@ module Aws::S3
3539
3603
  #
3540
3604
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
3541
3605
  #
3606
+ # @option params [String] :checksum_type
3607
+ # Indicates the checksum type that you want Amazon S3 to use to
3608
+ # calculate the object’s checksum value. For more information, see
3609
+ # [Checking object integrity in the Amazon S3 User Guide][1].
3610
+ #
3611
+ #
3612
+ #
3613
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
3614
+ #
3542
3615
  # @return [Types::CreateMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3543
3616
  #
3544
3617
  # * {Types::CreateMultipartUploadOutput#abort_date #abort_date} => Time
@@ -3554,6 +3627,7 @@ module Aws::S3
3554
3627
  # * {Types::CreateMultipartUploadOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
3555
3628
  # * {Types::CreateMultipartUploadOutput#request_charged #request_charged} => String
3556
3629
  # * {Types::CreateMultipartUploadOutput#checksum_algorithm #checksum_algorithm} => String
3630
+ # * {Types::CreateMultipartUploadOutput#checksum_type #checksum_type} => String
3557
3631
  #
3558
3632
  #
3559
3633
  # @example Example: To initiate a multipart upload
@@ -3606,7 +3680,8 @@ module Aws::S3
3606
3680
  # object_lock_retain_until_date: Time.now,
3607
3681
  # object_lock_legal_hold_status: "ON", # accepts ON, OFF
3608
3682
  # expected_bucket_owner: "AccountId",
3609
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
3683
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
3684
+ # checksum_type: "COMPOSITE", # accepts COMPOSITE, FULL_OBJECT
3610
3685
  # })
3611
3686
  #
3612
3687
  # @example Response structure
@@ -3623,7 +3698,8 @@ module Aws::S3
3623
3698
  # resp.ssekms_encryption_context #=> String
3624
3699
  # resp.bucket_key_enabled #=> Boolean
3625
3700
  # resp.request_charged #=> String, one of "requester"
3626
- # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
3701
+ # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
3702
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
3627
3703
  #
3628
3704
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateMultipartUpload AWS API Documentation
3629
3705
  #
@@ -3677,8 +3753,8 @@ module Aws::S3
3677
3753
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
3678
3754
  # for directory buckets in Availability Zones][3] in the *Amazon S3
3679
3755
  # User Guide*. For more information about endpoints in Local Zones,
3680
- # see [Available Local Zone for directory buckets][4] in the *Amazon
3681
- # S3 User Guide*.
3756
+ # see [Concepts for directory buckets in Local Zones][4] in the
3757
+ # *Amazon S3 User Guide*.
3682
3758
  #
3683
3759
  # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
3684
3760
  # endpoint API operations, the `CopyObject` API operation doesn't use
@@ -3784,7 +3860,7 @@ module Aws::S3
3784
3860
  #
3785
3861
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
3786
3862
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
3787
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
3863
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
3788
3864
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3789
3865
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
3790
3866
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
@@ -3824,7 +3900,7 @@ module Aws::S3
3824
3900
  #
3825
3901
  #
3826
3902
  #
3827
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3903
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
3828
3904
  #
3829
3905
  # @option params [String] :ssekms_key_id
3830
3906
  # If you specify `x-amz-server-side-encryption` with `aws:kms`, you must
@@ -3837,8 +3913,8 @@ module Aws::S3
3837
3913
  # the Key ID.
3838
3914
  #
3839
3915
  # Your SSE-KMS configuration can only support 1 [customer managed
3840
- # key][1] per directory bucket for the lifetime of the bucket. The
3841
- # [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
3916
+ # key][1] per directory bucket's lifetime. The [Amazon Web Services
3917
+ # managed key][2] (`aws/s3`) isn't supported.
3842
3918
  #
3843
3919
  #
3844
3920
  #
@@ -3848,7 +3924,7 @@ module Aws::S3
3848
3924
  # @option params [String] :ssekms_encryption_context
3849
3925
  # Specifies the Amazon Web Services KMS Encryption Context as an
3850
3926
  # additional encryption context to use for object encryption. The value
3851
- # of this header is a Base64-encoded string of a UTF-8 encoded JSON,
3927
+ # of this header is a Base64 encoded string of a UTF-8 encoded JSON,
3852
3928
  # which contains the encryption context as key-value pairs. This value
3853
3929
  # is stored as object metadata and automatically gets passed on to
3854
3930
  # Amazon Web Services KMS for future `GetObject` operations on this
@@ -3944,8 +4020,8 @@ module Aws::S3
3944
4020
  # information about endpoints in Availability Zones, see [Regional and
3945
4021
  # Zonal endpoints for directory buckets in Availability Zones][1] in
3946
4022
  # the *Amazon S3 User Guide*. For more information about endpoints in
3947
- # Local Zones, see [Available Local Zone for directory buckets][2] in
3948
- # the *Amazon S3 User Guide*.
4023
+ # Local Zones, see [Concepts for directory buckets in Local Zones][2]
4024
+ # in the *Amazon S3 User Guide*.
3949
4025
  #
3950
4026
  # </note>
3951
4027
  #
@@ -3976,7 +4052,7 @@ module Aws::S3
3976
4052
  #
3977
4053
  #
3978
4054
  #
3979
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4055
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
3980
4056
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
3981
4057
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
3982
4058
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
@@ -4441,8 +4517,8 @@ module Aws::S3
4441
4517
  # information about endpoints in Availability Zones, see [Regional
4442
4518
  # and Zonal endpoints for directory buckets in Availability
4443
4519
  # Zones][3] in the *Amazon S3 User Guide*. For more information
4444
- # about endpoints in Local Zones, see [Available Local Zone for
4445
- # directory buckets][4] in the *Amazon S3 User Guide*.
4520
+ # about endpoints in Local Zones, see [Concepts for directory
4521
+ # buckets in Local Zones][4] in the *Amazon S3 User Guide*.
4446
4522
  #
4447
4523
  # </note>
4448
4524
  # ^
@@ -4465,7 +4541,7 @@ module Aws::S3
4465
4541
  #
4466
4542
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4467
4543
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
4468
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4544
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
4469
4545
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4470
4546
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
4471
4547
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
@@ -4692,7 +4768,7 @@ module Aws::S3
4692
4768
  # about endpoints in Availability Zones, see [Regional and Zonal
4693
4769
  # endpoints for directory buckets in Availability Zones][1] in the
4694
4770
  # *Amazon S3 User Guide*. For more information about endpoints in Local
4695
- # Zones, see [Available Local Zone for directory buckets][2] in the
4771
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
4696
4772
  # *Amazon S3 User Guide*.
4697
4773
  #
4698
4774
  # </note>
@@ -4749,7 +4825,7 @@ module Aws::S3
4749
4825
  #
4750
4826
  #
4751
4827
  #
4752
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
4828
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
4753
4829
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
4754
4830
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
4755
4831
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
@@ -5037,13 +5113,13 @@ module Aws::S3
5037
5113
  # * **Directory buckets** - For directory buckets, you must make
5038
5114
  # requests for this API operation to the Zonal endpoint. These
5039
5115
  # endpoints support virtual-hosted-style requests in the format
5040
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
5116
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
5041
5117
  # `. Path-style requests are not supported. For more information about
5042
5118
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
5043
5119
  # for directory buckets in Availability Zones][3] in the *Amazon S3
5044
5120
  # User Guide*. For more information about endpoints in Local Zones,
5045
- # see [Available Local Zone for directory buckets][4] in the *Amazon
5046
- # S3 User Guide*.
5121
+ # see [Concepts for directory buckets in Local Zones][4] in the
5122
+ # *Amazon S3 User Guide*.
5047
5123
  #
5048
5124
  # </note>
5049
5125
  #
@@ -5116,7 +5192,7 @@ module Aws::S3
5116
5192
  #
5117
5193
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
5118
5194
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
5119
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5195
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
5120
5196
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
5121
5197
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
5122
5198
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
@@ -5133,7 +5209,7 @@ module Aws::S3
5133
5209
  # requests are not supported. Directory bucket names must be unique in
5134
5210
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5135
5211
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
5136
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5212
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
5137
5213
  # naming restrictions, see [Directory bucket naming rules][1] in the
5138
5214
  # *Amazon S3 User Guide*.
5139
5215
  #
@@ -5153,14 +5229,14 @@ module Aws::S3
5153
5229
  #
5154
5230
  # </note>
5155
5231
  #
5156
- # **S3 on Outposts** - When you use this action with Amazon S3 on
5157
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
5158
- # S3 on Outposts hostname takes the form `
5232
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
5233
+ # must direct requests to the S3 on Outposts hostname. The S3 on
5234
+ # Outposts hostname takes the form `
5159
5235
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5160
- # When you use this action with S3 on Outposts through the Amazon Web
5161
- # Services SDKs, you provide the Outposts access point ARN in place of
5162
- # the bucket name. For more information about S3 on Outposts ARNs, see
5163
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
5236
+ # When you use this action with S3 on Outposts, the destination bucket
5237
+ # must be the Outposts access point ARN or the access point alias. For
5238
+ # more information about S3 on Outposts, see [What is S3 on
5239
+ # Outposts?][3] in the *Amazon S3 User Guide*.
5164
5240
  #
5165
5241
  #
5166
5242
  #
@@ -5235,7 +5311,7 @@ module Aws::S3
5235
5311
  #
5236
5312
  #
5237
5313
  #
5238
- # [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
5314
+ # [1]: https://tools.ietf.org/html/rfc7232
5239
5315
  #
5240
5316
  # @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
5241
5317
  # If present, the object is deleted only if its modification times
@@ -5362,14 +5438,14 @@ module Aws::S3
5362
5438
  # name. For more information about access point ARNs, see [Using access
5363
5439
  # points][1] in the *Amazon S3 User Guide*.
5364
5440
  #
5365
- # **S3 on Outposts** - When you use this action with Amazon S3 on
5366
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
5367
- # S3 on Outposts hostname takes the form `
5441
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
5442
+ # must direct requests to the S3 on Outposts hostname. The S3 on
5443
+ # Outposts hostname takes the form `
5368
5444
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5369
- # When you use this action with S3 on Outposts through the Amazon Web
5370
- # Services SDKs, you provide the Outposts access point ARN in place of
5371
- # the bucket name. For more information about S3 on Outposts ARNs, see
5372
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
5445
+ # When you use this action with S3 on Outposts, the destination bucket
5446
+ # must be the Outposts access point ARN or the access point alias. For
5447
+ # more information about S3 on Outposts, see [What is S3 on
5448
+ # Outposts?][2] in the *Amazon S3 User Guide*.
5373
5449
  #
5374
5450
  #
5375
5451
  #
@@ -5393,35 +5469,35 @@ module Aws::S3
5393
5469
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
5394
5470
  #
5395
5471
  #
5396
- # @example Example: To remove tag set from an object
5472
+ # @example Example: To remove tag set from an object version
5397
5473
  #
5398
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
5399
- # # operation removes tag set from the latest object version.
5474
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
5475
+ # # object key and object version.
5400
5476
  #
5401
5477
  # resp = client.delete_object_tagging({
5402
5478
  # bucket: "examplebucket",
5403
5479
  # key: "HappyFace.jpg",
5480
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5404
5481
  # })
5405
5482
  #
5406
5483
  # resp.to_h outputs the following:
5407
5484
  # {
5408
- # version_id: "null",
5485
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5409
5486
  # }
5410
5487
  #
5411
- # @example Example: To remove tag set from an object version
5488
+ # @example Example: To remove tag set from an object
5412
5489
  #
5413
- # # The following example removes tag set associated with the specified object version. The request specifies both the
5414
- # # object key and object version.
5490
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
5491
+ # # operation removes tag set from the latest object version.
5415
5492
  #
5416
5493
  # resp = client.delete_object_tagging({
5417
5494
  # bucket: "examplebucket",
5418
5495
  # key: "HappyFace.jpg",
5419
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5420
5496
  # })
5421
5497
  #
5422
5498
  # resp.to_h outputs the following:
5423
5499
  # {
5424
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5500
+ # version_id: "null",
5425
5501
  # }
5426
5502
  #
5427
5503
  # @example Request syntax with placeholder values
@@ -5451,13 +5527,14 @@ module Aws::S3
5451
5527
  # to delete, then this operation provides a suitable alternative to
5452
5528
  # sending individual delete requests, reducing per-request overhead.
5453
5529
  #
5454
- # The request can contain a list of up to 1000 keys that you want to
5530
+ # The request can contain a list of up to 1,000 keys that you want to
5455
5531
  # delete. In the XML, you provide the object key names, and optionally,
5456
5532
  # version IDs if you want to delete a specific version of the object
5457
5533
  # from a versioning-enabled bucket. For each key, Amazon S3 performs a
5458
5534
  # delete operation and returns the result of that delete, success or
5459
- # failure, in the response. Note that if the object specified in the
5460
- # request is not found, Amazon S3 returns the result as deleted.
5535
+ # failure, in the response. If the object specified in the request
5536
+ # isn't found, Amazon S3 confirms the deletion by returning the result
5537
+ # as deleted.
5461
5538
  #
5462
5539
  # <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
5463
5540
  # for directory buckets.
@@ -5465,13 +5542,13 @@ module Aws::S3
5465
5542
  # * **Directory buckets** - For directory buckets, you must make
5466
5543
  # requests for this API operation to the Zonal endpoint. These
5467
5544
  # endpoints support virtual-hosted-style requests in the format
5468
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
5545
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
5469
5546
  # `. Path-style requests are not supported. For more information about
5470
5547
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
5471
5548
  # for directory buckets in Availability Zones][1] in the *Amazon S3
5472
5549
  # User Guide*. For more information about endpoints in Local Zones,
5473
- # see [Available Local Zone for directory buckets][2] in the *Amazon
5474
- # S3 User Guide*.
5550
+ # see [Concepts for directory buckets in Local Zones][2] in the
5551
+ # *Amazon S3 User Guide*.
5475
5552
  #
5476
5553
  # </note>
5477
5554
  #
@@ -5555,7 +5632,7 @@ module Aws::S3
5555
5632
  #
5556
5633
  #
5557
5634
  #
5558
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
5635
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
5559
5636
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
5560
5637
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
5561
5638
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -5574,7 +5651,7 @@ module Aws::S3
5574
5651
  # requests are not supported. Directory bucket names must be unique in
5575
5652
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
5576
5653
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
5577
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
5654
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
5578
5655
  # naming restrictions, see [Directory bucket naming rules][1] in the
5579
5656
  # *Amazon S3 User Guide*.
5580
5657
  #
@@ -5594,14 +5671,14 @@ module Aws::S3
5594
5671
  #
5595
5672
  # </note>
5596
5673
  #
5597
- # **S3 on Outposts** - When you use this action with Amazon S3 on
5598
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
5599
- # S3 on Outposts hostname takes the form `
5674
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
5675
+ # must direct requests to the S3 on Outposts hostname. The S3 on
5676
+ # Outposts hostname takes the form `
5600
5677
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5601
- # When you use this action with S3 on Outposts through the Amazon Web
5602
- # Services SDKs, you provide the Outposts access point ARN in place of
5603
- # the bucket name. For more information about S3 on Outposts ARNs, see
5604
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
5678
+ # When you use this action with S3 on Outposts, the destination bucket
5679
+ # must be the Outposts access point ARN or the access point alias. For
5680
+ # more information about S3 on Outposts, see [What is S3 on
5681
+ # Outposts?][3] in the *Amazon S3 User Guide*.
5605
5682
  #
5606
5683
  #
5607
5684
  #
@@ -5677,22 +5754,23 @@ module Aws::S3
5677
5754
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
5678
5755
  # the supported algorithm from the following list:
5679
5756
  #
5680
- # * `CRC32`
5757
+ # * `CRC-32`
5681
5758
  #
5682
- # * `CRC32C`
5759
+ # * `CRC-32C`
5683
5760
  #
5684
- # * `SHA1`
5761
+ # * `CRC-64NVME`
5685
5762
  #
5686
- # * `SHA256`
5763
+ # * `SHA-1`
5764
+ #
5765
+ # * `SHA-256`
5687
5766
  #
5688
5767
  # For more information, see [Checking object integrity][1] in the
5689
5768
  # *Amazon S3 User Guide*.
5690
5769
  #
5691
5770
  # If the individual checksum value you provide through
5692
5771
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
5693
- # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores any
5694
- # provided `ChecksumAlgorithm` parameter and uses the checksum algorithm
5695
- # that matches the provided value in `x-amz-checksum-algorithm `.
5772
+ # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
5773
+ # request with a `BadDigest` error.
5696
5774
  #
5697
5775
  # If you provide an individual checksum, Amazon S3 ignores any provided
5698
5776
  # `ChecksumAlgorithm` parameter.
@@ -5708,20 +5786,22 @@ module Aws::S3
5708
5786
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
5709
5787
  #
5710
5788
  #
5711
- # @example Example: To delete multiple objects from a versioned bucket
5789
+ # @example Example: To delete multiple object versions from a versioned bucket
5712
5790
  #
5713
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5714
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5791
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5792
+ # # versions and returns the key and versions of deleted objects in the response.
5715
5793
  #
5716
5794
  # resp = client.delete_objects({
5717
5795
  # bucket: "examplebucket",
5718
5796
  # delete: {
5719
5797
  # objects: [
5720
5798
  # {
5721
- # key: "objectkey1",
5799
+ # key: "HappyFace.jpg",
5800
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5722
5801
  # },
5723
5802
  # {
5724
- # key: "objectkey2",
5803
+ # key: "HappyFace.jpg",
5804
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5725
5805
  # },
5726
5806
  # ],
5727
5807
  # quiet: false,
@@ -5732,34 +5812,30 @@ module Aws::S3
5732
5812
  # {
5733
5813
  # deleted: [
5734
5814
  # {
5735
- # delete_marker: true,
5736
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5737
- # key: "objectkey1",
5815
+ # key: "HappyFace.jpg",
5816
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5738
5817
  # },
5739
5818
  # {
5740
- # delete_marker: true,
5741
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5742
- # key: "objectkey2",
5819
+ # key: "HappyFace.jpg",
5820
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5743
5821
  # },
5744
5822
  # ],
5745
5823
  # }
5746
5824
  #
5747
- # @example Example: To delete multiple object versions from a versioned bucket
5825
+ # @example Example: To delete multiple objects from a versioned bucket
5748
5826
  #
5749
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
5750
- # # versions and returns the key and versions of deleted objects in the response.
5827
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
5828
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
5751
5829
  #
5752
5830
  # resp = client.delete_objects({
5753
5831
  # bucket: "examplebucket",
5754
5832
  # delete: {
5755
5833
  # objects: [
5756
5834
  # {
5757
- # key: "HappyFace.jpg",
5758
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5835
+ # key: "objectkey1",
5759
5836
  # },
5760
5837
  # {
5761
- # key: "HappyFace.jpg",
5762
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5838
+ # key: "objectkey2",
5763
5839
  # },
5764
5840
  # ],
5765
5841
  # quiet: false,
@@ -5770,12 +5846,14 @@ module Aws::S3
5770
5846
  # {
5771
5847
  # deleted: [
5772
5848
  # {
5773
- # key: "HappyFace.jpg",
5774
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
5849
+ # delete_marker: true,
5850
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
5851
+ # key: "objectkey1",
5775
5852
  # },
5776
5853
  # {
5777
- # key: "HappyFace.jpg",
5778
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
5854
+ # delete_marker: true,
5855
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
5856
+ # key: "objectkey2",
5779
5857
  # },
5780
5858
  # ],
5781
5859
  # }
@@ -5800,7 +5878,7 @@ module Aws::S3
5800
5878
  # request_payer: "requester", # accepts requester
5801
5879
  # bypass_governance_retention: false,
5802
5880
  # expected_bucket_owner: "AccountId",
5803
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
5881
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
5804
5882
  # })
5805
5883
  #
5806
5884
  # @example Response structure
@@ -6733,8 +6811,8 @@ module Aws::S3
6733
6811
  # information about endpoints in Availability Zones, see [Regional
6734
6812
  # and Zonal endpoints for directory buckets in Availability
6735
6813
  # Zones][5] in the *Amazon S3 User Guide*. For more information
6736
- # about endpoints in Local Zones, see [Available Local Zone for
6737
- # directory buckets][6] in the *Amazon S3 User Guide*.
6814
+ # about endpoints in Local Zones, see [Concepts for directory
6815
+ # buckets in Local Zones][6] in the *Amazon S3 User Guide*.
6738
6816
  #
6739
6817
  # </note>
6740
6818
  #
@@ -6768,7 +6846,7 @@ module Aws::S3
6768
6846
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
6769
6847
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6770
6848
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6771
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
6849
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
6772
6850
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
6773
6851
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
6774
6852
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
@@ -6952,7 +7030,7 @@ module Aws::S3
6952
7030
  #
6953
7031
  # @example Response structure
6954
7032
  #
6955
- # resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-north-1", "eu-south-1", "eu-south-2", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
7033
+ # resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-south-2", "ap-southeast-1", "ap-southeast-2", "ap-southeast-3", "ap-southeast-4", "ap-southeast-5", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-central-2", "eu-north-1", "eu-south-1", "eu-south-2", "eu-west-1", "eu-west-2", "eu-west-3", "il-central-1", "me-central-1", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
6956
7034
  #
6957
7035
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
6958
7036
  #
@@ -7484,7 +7562,7 @@ module Aws::S3
7484
7562
  # about endpoints in Availability Zones, see [Regional and Zonal
7485
7563
  # endpoints for directory buckets in Availability Zones][1] in the
7486
7564
  # *Amazon S3 User Guide*. For more information about endpoints in Local
7487
- # Zones, see [Available Local Zone for directory buckets][2] in the
7565
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
7488
7566
  # *Amazon S3 User Guide*.
7489
7567
  #
7490
7568
  # </note>
@@ -7548,7 +7626,7 @@ module Aws::S3
7548
7626
  #
7549
7627
  #
7550
7628
  #
7551
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
7629
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
7552
7630
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
7553
7631
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
7554
7632
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
@@ -8167,7 +8245,7 @@ module Aws::S3
8167
8245
  # **Directory buckets** - Only virtual-hosted-style requests are
8168
8246
  # supported. For a virtual hosted-style request example, if you have the
8169
8247
  # object `photos/2006/February/sample.jpg` in the bucket named
8170
- # `examplebucket--use1-az5--x-s3`, specify the object key name as
8248
+ # `amzn-s3-demo-bucket--usw2-az1--x-s3`, specify the object key name as
8171
8249
  # `/photos/2006/February/sample.jpg`. Also, when you make requests to
8172
8250
  # this API operation, your requests are sent to the Zonal endpoint.
8173
8251
  # These endpoints support virtual-hosted-style requests in the format
@@ -8176,8 +8254,8 @@ module Aws::S3
8176
8254
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
8177
8255
  # directory buckets in Availability Zones][2] in the *Amazon S3 User
8178
8256
  # Guide*. For more information about endpoints in Local Zones, see
8179
- # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
8180
- # Guide*.
8257
+ # [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
8258
+ # User Guide*.
8181
8259
  #
8182
8260
  # Permissions
8183
8261
  # : * **General purpose bucket permissions** - You must have the
@@ -8313,7 +8391,7 @@ module Aws::S3
8313
8391
  #
8314
8392
  #
8315
8393
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
8316
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
8394
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
8317
8395
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
8318
8396
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
8319
8397
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -8335,7 +8413,7 @@ module Aws::S3
8335
8413
  # requests are not supported. Directory bucket names must be unique in
8336
8414
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8337
8415
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8338
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8416
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
8339
8417
  # naming restrictions, see [Directory bucket naming rules][1] in the
8340
8418
  # *Amazon S3 User Guide*.
8341
8419
  #
@@ -8361,14 +8439,14 @@ module Aws::S3
8361
8439
  #
8362
8440
  # </note>
8363
8441
  #
8364
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8365
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
8366
- # S3 on Outposts hostname takes the form `
8442
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
8443
+ # must direct requests to the S3 on Outposts hostname. The S3 on
8444
+ # Outposts hostname takes the form `
8367
8445
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8368
- # When you use this action with S3 on Outposts through the Amazon Web
8369
- # Services SDKs, you provide the Outposts access point ARN in place of
8370
- # the bucket name. For more information about S3 on Outposts ARNs, see
8371
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
8446
+ # When you use this action with S3 on Outposts, the destination bucket
8447
+ # must be the Outposts access point ARN or the access point alias. For
8448
+ # more information about S3 on Outposts, see [What is S3 on
8449
+ # Outposts?][3] in the *Amazon S3 User Guide*.
8372
8450
  #
8373
8451
  #
8374
8452
  #
@@ -8618,15 +8696,6 @@ module Aws::S3
8618
8696
  # @option params [String] :checksum_mode
8619
8697
  # To retrieve the checksum, this mode must be enabled.
8620
8698
  #
8621
- # **General purpose buckets** - In addition, if you enable checksum mode
8622
- # and the object is uploaded with a [checksum][1] and encrypted with an
8623
- # Key Management Service (KMS) key, you must have permission to use the
8624
- # `kms:Decrypt` action to retrieve the checksum.
8625
- #
8626
- #
8627
- #
8628
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
8629
- #
8630
8699
  # @return [Types::GetObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8631
8700
  #
8632
8701
  # * {Types::GetObjectOutput#body #body} => IO
@@ -8639,8 +8708,10 @@ module Aws::S3
8639
8708
  # * {Types::GetObjectOutput#etag #etag} => String
8640
8709
  # * {Types::GetObjectOutput#checksum_crc32 #checksum_crc32} => String
8641
8710
  # * {Types::GetObjectOutput#checksum_crc32c #checksum_crc32c} => String
8711
+ # * {Types::GetObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
8642
8712
  # * {Types::GetObjectOutput#checksum_sha1 #checksum_sha1} => String
8643
8713
  # * {Types::GetObjectOutput#checksum_sha256 #checksum_sha256} => String
8714
+ # * {Types::GetObjectOutput#checksum_type #checksum_type} => String
8644
8715
  # * {Types::GetObjectOutput#missing_meta #missing_meta} => Integer
8645
8716
  # * {Types::GetObjectOutput#version_id #version_id} => String
8646
8717
  # * {Types::GetObjectOutput#cache_control #cache_control} => String
@@ -8781,8 +8852,10 @@ module Aws::S3
8781
8852
  # resp.etag #=> String
8782
8853
  # resp.checksum_crc32 #=> String
8783
8854
  # resp.checksum_crc32c #=> String
8855
+ # resp.checksum_crc64nvme #=> String
8784
8856
  # resp.checksum_sha1 #=> String
8785
8857
  # resp.checksum_sha256 #=> String
8858
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
8786
8859
  # resp.missing_meta #=> Integer
8787
8860
  # resp.version_id #=> String
8788
8861
  # resp.cache_control #=> String
@@ -9014,13 +9087,13 @@ module Aws::S3
9014
9087
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
9015
9088
  # for this API operation to the Zonal endpoint. These endpoints support
9016
9089
  # virtual-hosted-style requests in the format
9017
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
9090
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
9018
9091
  # `. Path-style requests are not supported. For more information about
9019
9092
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
9020
9093
  # directory buckets in Availability Zones][1] in the *Amazon S3 User
9021
9094
  # Guide*. For more information about endpoints in Local Zones, see
9022
- # [Available Local Zone for directory buckets][2] in the *Amazon S3 User
9023
- # Guide*.
9095
+ # [Concepts for directory buckets in Local Zones][2] in the *Amazon S3
9096
+ # User Guide*.
9024
9097
  #
9025
9098
  # </note>
9026
9099
  #
@@ -9169,7 +9242,7 @@ module Aws::S3
9169
9242
  #
9170
9243
  #
9171
9244
  #
9172
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
9245
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
9173
9246
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
9174
9247
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
9175
9248
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -9195,7 +9268,7 @@ module Aws::S3
9195
9268
  # requests are not supported. Directory bucket names must be unique in
9196
9269
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
9197
9270
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9198
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9271
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
9199
9272
  # naming restrictions, see [Directory bucket naming rules][1] in the
9200
9273
  # *Amazon S3 User Guide*.
9201
9274
  #
@@ -9215,14 +9288,14 @@ module Aws::S3
9215
9288
  #
9216
9289
  # </note>
9217
9290
  #
9218
- # **S3 on Outposts** - When you use this action with Amazon S3 on
9219
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
9220
- # S3 on Outposts hostname takes the form `
9291
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
9292
+ # must direct requests to the S3 on Outposts hostname. The S3 on
9293
+ # Outposts hostname takes the form `
9221
9294
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
9222
- # When you use this action with S3 on Outposts through the Amazon Web
9223
- # Services SDKs, you provide the Outposts access point ARN in place of
9224
- # the bucket name. For more information about S3 on Outposts ARNs, see
9225
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
9295
+ # When you use this action with S3 on Outposts, the destination bucket
9296
+ # must be the Outposts access point ARN or the access point alias. For
9297
+ # more information about S3 on Outposts, see [What is S3 on
9298
+ # Outposts?][3] in the *Amazon S3 User Guide*.
9226
9299
  #
9227
9300
  #
9228
9301
  #
@@ -9341,8 +9414,10 @@ module Aws::S3
9341
9414
  # resp.etag #=> String
9342
9415
  # resp.checksum.checksum_crc32 #=> String
9343
9416
  # resp.checksum.checksum_crc32c #=> String
9417
+ # resp.checksum.checksum_crc64nvme #=> String
9344
9418
  # resp.checksum.checksum_sha1 #=> String
9345
9419
  # resp.checksum.checksum_sha256 #=> String
9420
+ # resp.checksum.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
9346
9421
  # resp.object_parts.total_parts_count #=> Integer
9347
9422
  # resp.object_parts.part_number_marker #=> Integer
9348
9423
  # resp.object_parts.next_part_number_marker #=> Integer
@@ -9353,6 +9428,7 @@ module Aws::S3
9353
9428
  # resp.object_parts.parts[0].size #=> Integer
9354
9429
  # resp.object_parts.parts[0].checksum_crc32 #=> String
9355
9430
  # resp.object_parts.parts[0].checksum_crc32c #=> String
9431
+ # resp.object_parts.parts[0].checksum_crc64nvme #=> String
9356
9432
  # resp.object_parts.parts[0].checksum_sha1 #=> String
9357
9433
  # resp.object_parts.parts[0].checksum_sha256 #=> String
9358
9434
  # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
@@ -9680,14 +9756,14 @@ module Aws::S3
9680
9756
  # name. For more information about access point ARNs, see [Using access
9681
9757
  # points][1] in the *Amazon S3 User Guide*.
9682
9758
  #
9683
- # **S3 on Outposts** - When you use this action with Amazon S3 on
9684
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
9685
- # S3 on Outposts hostname takes the form `
9759
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
9760
+ # must direct requests to the S3 on Outposts hostname. The S3 on
9761
+ # Outposts hostname takes the form `
9686
9762
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
9687
- # When you use this action with S3 on Outposts through the Amazon Web
9688
- # Services SDKs, you provide the Outposts access point ARN in place of
9689
- # the bucket name. For more information about S3 on Outposts ARNs, see
9690
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
9763
+ # When you use this action with S3 on Outposts, the destination bucket
9764
+ # must be the Outposts access point ARN or the access point alias. For
9765
+ # more information about S3 on Outposts, see [What is S3 on
9766
+ # Outposts?][2] in the *Amazon S3 User Guide*.
9691
9767
  #
9692
9768
  #
9693
9769
  #
@@ -10040,8 +10116,8 @@ module Aws::S3
10040
10116
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
10041
10117
  # for directory buckets in Availability Zones][5] in the *Amazon S3
10042
10118
  # User Guide*. For more information about endpoints in Local Zones,
10043
- # see [Available Local Zone for directory buckets][6] in the *Amazon
10044
- # S3 User Guide*.
10119
+ # see [Concepts for directory buckets in Local Zones][6] in the
10120
+ # *Amazon S3 User Guide*.
10045
10121
  #
10046
10122
  # </note>
10047
10123
  #
@@ -10051,7 +10127,7 @@ module Aws::S3
10051
10127
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10052
10128
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
10053
10129
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
10054
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10130
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
10055
10131
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
10056
10132
  #
10057
10133
  # @option params [required, String] :bucket
@@ -10063,7 +10139,7 @@ module Aws::S3
10063
10139
  # requests are not supported. Directory bucket names must be unique in
10064
10140
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10065
10141
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10066
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10142
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10067
10143
  # naming restrictions, see [Directory bucket naming rules][1] in the
10068
10144
  # *Amazon S3 User Guide*.
10069
10145
  #
@@ -10090,14 +10166,14 @@ module Aws::S3
10090
10166
  #
10091
10167
  # </note>
10092
10168
  #
10093
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10094
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
10095
- # S3 on Outposts hostname takes the form `
10169
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
10170
+ # must direct requests to the S3 on Outposts hostname. The S3 on
10171
+ # Outposts hostname takes the form `
10096
10172
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10097
- # When you use this action with S3 on Outposts through the Amazon Web
10098
- # Services SDKs, you provide the Outposts access point ARN in place of
10099
- # the bucket name. For more information about S3 on Outposts ARNs, see
10100
- # [What is S3 on Outposts?][4] in the *Amazon S3 User Guide*.
10173
+ # When you use this action with S3 on Outposts, the destination bucket
10174
+ # must be the Outposts access point ARN or the access point alias. For
10175
+ # more information about S3 on Outposts, see [What is S3 on
10176
+ # Outposts?][4] in the *Amazon S3 User Guide*.
10101
10177
  #
10102
10178
  #
10103
10179
  #
@@ -10286,13 +10362,13 @@ module Aws::S3
10286
10362
  # <note markdown="1"> For directory buckets, you must make requests for this API operation
10287
10363
  # to the Zonal endpoint. These endpoints support virtual-hosted-style
10288
10364
  # requests in the format
10289
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
10365
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
10290
10366
  # `. Path-style requests are not supported. For more information about
10291
10367
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
10292
10368
  # for directory buckets in Availability Zones][6] in the *Amazon S3
10293
10369
  # User Guide*. For more information about endpoints in Local Zones,
10294
- # see [Available Local Zone for directory buckets][7] in the *Amazon
10295
- # S3 User Guide*.
10370
+ # see [Concepts for directory buckets in Local Zones][7] in the
10371
+ # *Amazon S3 User Guide*.
10296
10372
  #
10297
10373
  # </note>
10298
10374
  #
@@ -10309,7 +10385,7 @@ module Aws::S3
10309
10385
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
10310
10386
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
10311
10387
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
10312
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
10388
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
10313
10389
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
10314
10390
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
10315
10391
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
@@ -10323,7 +10399,7 @@ module Aws::S3
10323
10399
  # requests are not supported. Directory bucket names must be unique in
10324
10400
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10325
10401
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10326
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10402
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10327
10403
  # naming restrictions, see [Directory bucket naming rules][1] in the
10328
10404
  # *Amazon S3 User Guide*.
10329
10405
  #
@@ -10343,14 +10419,14 @@ module Aws::S3
10343
10419
  #
10344
10420
  # </note>
10345
10421
  #
10346
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10347
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
10348
- # S3 on Outposts hostname takes the form `
10422
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
10423
+ # must direct requests to the S3 on Outposts hostname. The S3 on
10424
+ # Outposts hostname takes the form `
10349
10425
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10350
- # When you use this action with S3 on Outposts through the Amazon Web
10351
- # Services SDKs, you provide the Outposts access point ARN in place of
10352
- # the bucket name. For more information about S3 on Outposts ARNs, see
10353
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
10426
+ # When you use this action with S3 on Outposts, the destination bucket
10427
+ # must be the Outposts access point ARN or the access point alias. For
10428
+ # more information about S3 on Outposts, see [What is S3 on
10429
+ # Outposts?][3] in the *Amazon S3 User Guide*.
10354
10430
  #
10355
10431
  #
10356
10432
  #
@@ -10554,8 +10630,10 @@ module Aws::S3
10554
10630
  # * {Types::HeadObjectOutput#content_length #content_length} => Integer
10555
10631
  # * {Types::HeadObjectOutput#checksum_crc32 #checksum_crc32} => String
10556
10632
  # * {Types::HeadObjectOutput#checksum_crc32c #checksum_crc32c} => String
10633
+ # * {Types::HeadObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
10557
10634
  # * {Types::HeadObjectOutput#checksum_sha1 #checksum_sha1} => String
10558
10635
  # * {Types::HeadObjectOutput#checksum_sha256 #checksum_sha256} => String
10636
+ # * {Types::HeadObjectOutput#checksum_type #checksum_type} => String
10559
10637
  # * {Types::HeadObjectOutput#etag #etag} => String
10560
10638
  # * {Types::HeadObjectOutput#missing_meta #missing_meta} => Integer
10561
10639
  # * {Types::HeadObjectOutput#version_id #version_id} => String
@@ -10640,8 +10718,10 @@ module Aws::S3
10640
10718
  # resp.content_length #=> Integer
10641
10719
  # resp.checksum_crc32 #=> String
10642
10720
  # resp.checksum_crc32c #=> String
10721
+ # resp.checksum_crc64nvme #=> String
10643
10722
  # resp.checksum_sha1 #=> String
10644
10723
  # resp.checksum_sha256 #=> String
10724
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
10645
10725
  # resp.etag #=> String
10646
10726
  # resp.missing_meta #=> Integer
10647
10727
  # resp.version_id #=> String
@@ -11231,7 +11311,7 @@ module Aws::S3
11231
11311
  # about endpoints in Availability Zones, see [Regional and Zonal
11232
11312
  # endpoints for directory buckets in Availability Zones][2] in the
11233
11313
  # *Amazon S3 User Guide*. For more information about endpoints in Local
11234
- # Zones, see [Available Local Zone for directory buckets][3] in the
11314
+ # Zones, see [Concepts for directory buckets in Local Zones][3] in the
11235
11315
  # *Amazon S3 User Guide*.
11236
11316
  #
11237
11317
  # </note>
@@ -11260,7 +11340,7 @@ module Aws::S3
11260
11340
  #
11261
11341
  #
11262
11342
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
11263
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11343
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
11264
11344
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11265
11345
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
11266
11346
  #
@@ -11350,13 +11430,13 @@ module Aws::S3
11350
11430
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
11351
11431
  # for this API operation to the Zonal endpoint. These endpoints support
11352
11432
  # virtual-hosted-style requests in the format
11353
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
11433
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
11354
11434
  # `. Path-style requests are not supported. For more information about
11355
11435
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
11356
11436
  # directory buckets in Availability Zones][2] in the *Amazon S3 User
11357
11437
  # Guide*. For more information about endpoints in Local Zones, see
11358
- # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
11359
- # Guide*.
11438
+ # [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
11439
+ # User Guide*.
11360
11440
  #
11361
11441
  # </note>
11362
11442
  #
@@ -11417,7 +11497,7 @@ module Aws::S3
11417
11497
  #
11418
11498
  #
11419
11499
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
11420
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
11500
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
11421
11501
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11422
11502
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11423
11503
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -11436,7 +11516,7 @@ module Aws::S3
11436
11516
  # requests are not supported. Directory bucket names must be unique in
11437
11517
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11438
11518
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11439
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11519
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11440
11520
  # naming restrictions, see [Directory bucket naming rules][1] in the
11441
11521
  # *Amazon S3 User Guide*.
11442
11522
  #
@@ -11456,14 +11536,14 @@ module Aws::S3
11456
11536
  #
11457
11537
  # </note>
11458
11538
  #
11459
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11460
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
11461
- # S3 on Outposts hostname takes the form `
11539
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
11540
+ # must direct requests to the S3 on Outposts hostname. The S3 on
11541
+ # Outposts hostname takes the form `
11462
11542
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11463
- # When you use this action with S3 on Outposts through the Amazon Web
11464
- # Services SDKs, you provide the Outposts access point ARN in place of
11465
- # the bucket name. For more information about S3 on Outposts ARNs, see
11466
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11543
+ # When you use this action with S3 on Outposts, the destination bucket
11544
+ # must be the Outposts access point ARN or the access point alias. For
11545
+ # more information about S3 on Outposts, see [What is S3 on
11546
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11467
11547
  #
11468
11548
  #
11469
11549
  #
@@ -11735,7 +11815,8 @@ module Aws::S3
11735
11815
  # resp.uploads[0].owner.id #=> String
11736
11816
  # resp.uploads[0].initiator.id #=> String
11737
11817
  # resp.uploads[0].initiator.display_name #=> String
11738
- # resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
11818
+ # resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
11819
+ # resp.uploads[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
11739
11820
  # resp.common_prefixes #=> Array
11740
11821
  # resp.common_prefixes[0].prefix #=> String
11741
11822
  # resp.encoding_type #=> String, one of "url"
@@ -11953,7 +12034,8 @@ module Aws::S3
11953
12034
  # resp.versions #=> Array
11954
12035
  # resp.versions[0].etag #=> String
11955
12036
  # resp.versions[0].checksum_algorithm #=> Array
11956
- # resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12037
+ # resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12038
+ # resp.versions[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
11957
12039
  # resp.versions[0].size #=> Integer
11958
12040
  # resp.versions[0].storage_class #=> String, one of "STANDARD"
11959
12041
  # resp.versions[0].key #=> String
@@ -12032,7 +12114,7 @@ module Aws::S3
12032
12114
  # requests are not supported. Directory bucket names must be unique in
12033
12115
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12034
12116
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12035
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12117
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12036
12118
  # naming restrictions, see [Directory bucket naming rules][1] in the
12037
12119
  # *Amazon S3 User Guide*.
12038
12120
  #
@@ -12052,14 +12134,14 @@ module Aws::S3
12052
12134
  #
12053
12135
  # </note>
12054
12136
  #
12055
- # **S3 on Outposts** - When you use this action with Amazon S3 on
12056
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
12057
- # S3 on Outposts hostname takes the form `
12137
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12138
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12139
+ # Outposts hostname takes the form `
12058
12140
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
12059
- # When you use this action with S3 on Outposts through the Amazon Web
12060
- # Services SDKs, you provide the Outposts access point ARN in place of
12061
- # the bucket name. For more information about S3 on Outposts ARNs, see
12062
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
12141
+ # When you use this action with S3 on Outposts, the destination bucket
12142
+ # must be the Outposts access point ARN or the access point alias. For
12143
+ # more information about S3 on Outposts, see [What is S3 on
12144
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12063
12145
  #
12064
12146
  #
12065
12147
  #
@@ -12198,7 +12280,8 @@ module Aws::S3
12198
12280
  # resp.contents[0].last_modified #=> Time
12199
12281
  # resp.contents[0].etag #=> String
12200
12282
  # resp.contents[0].checksum_algorithm #=> Array
12201
- # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12283
+ # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12284
+ # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12202
12285
  # resp.contents[0].size #=> Integer
12203
12286
  # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
12204
12287
  # resp.contents[0].owner.display_name #=> String
@@ -12243,13 +12326,13 @@ module Aws::S3
12243
12326
  # * **Directory buckets** - For directory buckets, you must make
12244
12327
  # requests for this API operation to the Zonal endpoint. These
12245
12328
  # endpoints support virtual-hosted-style requests in the format
12246
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12329
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
12247
12330
  # `. Path-style requests are not supported. For more information about
12248
12331
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
12249
12332
  # for directory buckets in Availability Zones][3] in the *Amazon S3
12250
12333
  # User Guide*. For more information about endpoints in Local Zones,
12251
- # see [Available Local Zone for directory buckets][4] in the *Amazon
12252
- # S3 User Guide*.
12334
+ # see [Concepts for directory buckets in Local Zones][4] in the
12335
+ # *Amazon S3 User Guide*.
12253
12336
  #
12254
12337
  # </note>
12255
12338
  #
@@ -12307,7 +12390,7 @@ module Aws::S3
12307
12390
  #
12308
12391
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
12309
12392
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
12310
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
12393
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
12311
12394
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12312
12395
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12313
12396
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
@@ -12324,7 +12407,7 @@ module Aws::S3
12324
12407
  # requests are not supported. Directory bucket names must be unique in
12325
12408
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12326
12409
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12327
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12410
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12328
12411
  # naming restrictions, see [Directory bucket naming rules][1] in the
12329
12412
  # *Amazon S3 User Guide*.
12330
12413
  #
@@ -12344,14 +12427,14 @@ module Aws::S3
12344
12427
  #
12345
12428
  # </note>
12346
12429
  #
12347
- # **S3 on Outposts** - When you use this action with Amazon S3 on
12348
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
12349
- # S3 on Outposts hostname takes the form `
12430
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12431
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12432
+ # Outposts hostname takes the form `
12350
12433
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
12351
- # When you use this action with S3 on Outposts through the Amazon Web
12352
- # Services SDKs, you provide the Outposts access point ARN in place of
12353
- # the bucket name. For more information about S3 on Outposts ARNs, see
12354
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
12434
+ # When you use this action with S3 on Outposts, the destination bucket
12435
+ # must be the Outposts access point ARN or the access point alias. For
12436
+ # more information about S3 on Outposts, see [What is S3 on
12437
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12355
12438
  #
12356
12439
  #
12357
12440
  #
@@ -12539,7 +12622,8 @@ module Aws::S3
12539
12622
  # resp.contents[0].last_modified #=> Time
12540
12623
  # resp.contents[0].etag #=> String
12541
12624
  # resp.contents[0].checksum_algorithm #=> Array
12542
- # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12625
+ # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12626
+ # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12543
12627
  # resp.contents[0].size #=> Integer
12544
12628
  # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
12545
12629
  # resp.contents[0].owner.display_name #=> String
@@ -12591,13 +12675,13 @@ module Aws::S3
12591
12675
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12592
12676
  # for this API operation to the Zonal endpoint. These endpoints support
12593
12677
  # virtual-hosted-style requests in the format
12594
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12678
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
12595
12679
  # `. Path-style requests are not supported. For more information about
12596
12680
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
12597
12681
  # directory buckets in Availability Zones][3] in the *Amazon S3 User
12598
12682
  # Guide*. For more information about endpoints in Local Zones, see
12599
- # [Available Local Zone for directory buckets][4] in the *Amazon S3 User
12600
- # Guide*.
12683
+ # [Concepts for directory buckets in Local Zones][4] in the *Amazon S3
12684
+ # User Guide*.
12601
12685
  #
12602
12686
  # </note>
12603
12687
  #
@@ -12651,7 +12735,7 @@ module Aws::S3
12651
12735
  #
12652
12736
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12653
12737
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
12654
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
12738
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
12655
12739
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12656
12740
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12657
12741
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -12670,7 +12754,7 @@ module Aws::S3
12670
12754
  # requests are not supported. Directory bucket names must be unique in
12671
12755
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12672
12756
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12673
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12757
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12674
12758
  # naming restrictions, see [Directory bucket naming rules][1] in the
12675
12759
  # *Amazon S3 User Guide*.
12676
12760
  #
@@ -12690,14 +12774,14 @@ module Aws::S3
12690
12774
  #
12691
12775
  # </note>
12692
12776
  #
12693
- # **S3 on Outposts** - When you use this action with Amazon S3 on
12694
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
12695
- # S3 on Outposts hostname takes the form `
12777
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12778
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12779
+ # Outposts hostname takes the form `
12696
12780
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
12697
- # When you use this action with S3 on Outposts through the Amazon Web
12698
- # Services SDKs, you provide the Outposts access point ARN in place of
12699
- # the bucket name. For more information about S3 on Outposts ARNs, see
12700
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
12781
+ # When you use this action with S3 on Outposts, the destination bucket
12782
+ # must be the Outposts access point ARN or the access point alias. For
12783
+ # more information about S3 on Outposts, see [What is S3 on
12784
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12701
12785
  #
12702
12786
  #
12703
12787
  #
@@ -12800,6 +12884,7 @@ module Aws::S3
12800
12884
  # * {Types::ListPartsOutput#storage_class #storage_class} => String
12801
12885
  # * {Types::ListPartsOutput#request_charged #request_charged} => String
12802
12886
  # * {Types::ListPartsOutput#checksum_algorithm #checksum_algorithm} => String
12887
+ # * {Types::ListPartsOutput#checksum_type #checksum_type} => String
12803
12888
  #
12804
12889
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
12805
12890
  #
@@ -12874,6 +12959,7 @@ module Aws::S3
12874
12959
  # resp.parts[0].size #=> Integer
12875
12960
  # resp.parts[0].checksum_crc32 #=> String
12876
12961
  # resp.parts[0].checksum_crc32c #=> String
12962
+ # resp.parts[0].checksum_crc64nvme #=> String
12877
12963
  # resp.parts[0].checksum_sha1 #=> String
12878
12964
  # resp.parts[0].checksum_sha256 #=> String
12879
12965
  # resp.initiator.id #=> String
@@ -12882,7 +12968,8 @@ module Aws::S3
12882
12968
  # resp.owner.id #=> String
12883
12969
  # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
12884
12970
  # resp.request_charged #=> String, one of "requester"
12885
- # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12971
+ # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12972
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12886
12973
  #
12887
12974
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts AWS API Documentation
12888
12975
  #
@@ -12955,7 +13042,7 @@ module Aws::S3
12955
13042
  # fails with the HTTP status code `403 Forbidden` (access denied).
12956
13043
  #
12957
13044
  # @option params [String] :checksum_algorithm
12958
- # Indicates the algorithm used to create the checksum for the object
13045
+ # Indicates the algorithm used to create the checksum for the request
12959
13046
  # when you use the SDK. This header will not provide any additional
12960
13047
  # functionality if you don't use the SDK. When you send this header,
12961
13048
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -12980,7 +13067,7 @@ module Aws::S3
12980
13067
  # status: "Enabled", # accepts Enabled, Suspended
12981
13068
  # },
12982
13069
  # expected_bucket_owner: "AccountId",
12983
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13070
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
12984
13071
  # })
12985
13072
  #
12986
13073
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration AWS API Documentation
@@ -13176,9 +13263,10 @@ module Aws::S3
13176
13263
  # The bucket to which to apply the ACL.
13177
13264
  #
13178
13265
  # @option params [String] :content_md5
13179
- # The base64-encoded 128-bit MD5 digest of the data. This header must be
13180
- # used as a message integrity check to verify that the request body was
13181
- # not corrupted in transit. For more information, go to [RFC 1864.][1]
13266
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
13267
+ # be used as a message integrity check to verify that the request body
13268
+ # was not corrupted in transit. For more information, go to [RFC
13269
+ # 1864.][1]
13182
13270
  #
13183
13271
  # For requests made using the Amazon Web Services Command Line Interface
13184
13272
  # (CLI) or Amazon Web Services SDKs, this field is calculated
@@ -13189,7 +13277,7 @@ module Aws::S3
13189
13277
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
13190
13278
  #
13191
13279
  # @option params [String] :checksum_algorithm
13192
- # Indicates the algorithm used to create the checksum for the object
13280
+ # Indicates the algorithm used to create the checksum for the request
13193
13281
  # when you use the SDK. This header will not provide any additional
13194
13282
  # functionality if you don't use the SDK. When you send this header,
13195
13283
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13267,7 +13355,7 @@ module Aws::S3
13267
13355
  # },
13268
13356
  # bucket: "BucketName", # required
13269
13357
  # content_md5: "ContentMD5",
13270
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13358
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13271
13359
  # grant_full_control: "GrantFullControl",
13272
13360
  # grant_read: "GrantRead",
13273
13361
  # grant_read_acp: "GrantReadACP",
@@ -13491,9 +13579,10 @@ module Aws::S3
13491
13579
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
13492
13580
  #
13493
13581
  # @option params [String] :content_md5
13494
- # The base64-encoded 128-bit MD5 digest of the data. This header must be
13495
- # used as a message integrity check to verify that the request body was
13496
- # not corrupted in transit. For more information, go to [RFC 1864.][1]
13582
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
13583
+ # be used as a message integrity check to verify that the request body
13584
+ # was not corrupted in transit. For more information, go to [RFC
13585
+ # 1864.][1]
13497
13586
  #
13498
13587
  # For requests made using the Amazon Web Services Command Line Interface
13499
13588
  # (CLI) or Amazon Web Services SDKs, this field is calculated
@@ -13504,7 +13593,7 @@ module Aws::S3
13504
13593
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
13505
13594
  #
13506
13595
  # @option params [String] :checksum_algorithm
13507
- # Indicates the algorithm used to create the checksum for the object
13596
+ # Indicates the algorithm used to create the checksum for the request
13508
13597
  # when you use the SDK. This header will not provide any additional
13509
13598
  # functionality if you don't use the SDK. When you send this header,
13510
13599
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13587,7 +13676,7 @@ module Aws::S3
13587
13676
  # ],
13588
13677
  # },
13589
13678
  # content_md5: "ContentMD5",
13590
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13679
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13591
13680
  # expected_bucket_owner: "AccountId",
13592
13681
  # })
13593
13682
  #
@@ -13611,7 +13700,7 @@ module Aws::S3
13611
13700
  # about endpoints in Availability Zones, see [Regional and Zonal
13612
13701
  # endpoints for directory buckets in Availability Zones][1] in the
13613
13702
  # *Amazon S3 User Guide*. For more information about endpoints in Local
13614
- # Zones, see [Available Local Zone for directory buckets][2] in the
13703
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
13615
13704
  # *Amazon S3 User Guide*.
13616
13705
  #
13617
13706
  # </note>
@@ -13648,8 +13737,8 @@ module Aws::S3
13648
13737
  # object uploads][5].
13649
13738
  #
13650
13739
  # * Your SSE-KMS configuration can only support 1 [customer managed
13651
- # key][6] per directory bucket for the lifetime of the bucket. The
13652
- # [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
13740
+ # key][6] per directory bucket's lifetime. The [Amazon Web Services
13741
+ # managed key][7] (`aws/s3`) isn't supported.
13653
13742
  #
13654
13743
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13655
13744
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
@@ -13719,7 +13808,7 @@ module Aws::S3
13719
13808
  #
13720
13809
  #
13721
13810
  #
13722
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13811
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
13723
13812
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
13724
13813
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13725
13814
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
@@ -13757,7 +13846,7 @@ module Aws::S3
13757
13846
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
13758
13847
  #
13759
13848
  # @option params [String] :content_md5
13760
- # The base64-encoded 128-bit MD5 digest of the server-side encryption
13849
+ # The Base64 encoded 128-bit `MD5` digest of the server-side encryption
13761
13850
  # configuration.
13762
13851
  #
13763
13852
  # For requests made using the Amazon Web Services Command Line Interface
@@ -13769,7 +13858,7 @@ module Aws::S3
13769
13858
  # </note>
13770
13859
  #
13771
13860
  # @option params [String] :checksum_algorithm
13772
- # Indicates the algorithm used to create the checksum for the object
13861
+ # Indicates the algorithm used to create the checksum for the request
13773
13862
  # when you use the SDK. This header will not provide any additional
13774
13863
  # functionality if you don't use the SDK. When you send this header,
13775
13864
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13810,7 +13899,7 @@ module Aws::S3
13810
13899
  # resp = client.put_bucket_encryption({
13811
13900
  # bucket: "BucketName", # required
13812
13901
  # content_md5: "ContentMD5",
13813
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13902
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13814
13903
  # server_side_encryption_configuration: { # required
13815
13904
  # rules: [ # required
13816
13905
  # {
@@ -14111,6 +14200,10 @@ module Aws::S3
14111
14200
  req.send_request(options)
14112
14201
  end
14113
14202
 
14203
+ # <note markdown="1"> This operation is not supported for directory buckets.
14204
+ #
14205
+ # </note>
14206
+ #
14114
14207
  # For an updated version of this API, see
14115
14208
  # [PutBucketLifecycleConfiguration][1]. This version has been
14116
14209
  # deprecated. Existing lifecycle configurations will work. For new
@@ -14189,7 +14282,7 @@ module Aws::S3
14189
14282
  # automatically.
14190
14283
  #
14191
14284
  # @option params [String] :checksum_algorithm
14192
- # Indicates the algorithm used to create the checksum for the object
14285
+ # Indicates the algorithm used to create the checksum for the request
14193
14286
  # when you use the SDK. This header will not provide any additional
14194
14287
  # functionality if you don't use the SDK. When you send this header,
14195
14288
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14218,7 +14311,7 @@ module Aws::S3
14218
14311
  # resp = client.put_bucket_lifecycle({
14219
14312
  # bucket: "BucketName", # required
14220
14313
  # content_md5: "ContentMD5",
14221
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14314
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14222
14315
  # lifecycle_configuration: {
14223
14316
  # rules: [ # required
14224
14317
  # {
@@ -14364,8 +14457,8 @@ module Aws::S3
14364
14457
  # information about endpoints in Availability Zones, see [Regional
14365
14458
  # and Zonal endpoints for directory buckets in Availability
14366
14459
  # Zones][7] in the *Amazon S3 User Guide*. For more information
14367
- # about endpoints in Local Zones, see [Available Local Zone for
14368
- # directory buckets][8] in the *Amazon S3 User Guide*.
14460
+ # about endpoints in Local Zones, see [Concepts for directory
14461
+ # buckets in Local Zones][8] in the *Amazon S3 User Guide*.
14369
14462
  #
14370
14463
  # </note>
14371
14464
  #
@@ -14387,7 +14480,7 @@ module Aws::S3
14387
14480
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
14388
14481
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14389
14482
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14390
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
14483
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
14391
14484
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14392
14485
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14393
14486
  # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
@@ -14396,7 +14489,7 @@ module Aws::S3
14396
14489
  # The name of the bucket for which to set the configuration.
14397
14490
  #
14398
14491
  # @option params [String] :checksum_algorithm
14399
- # Indicates the algorithm used to create the checksum for the object
14492
+ # Indicates the algorithm used to create the checksum for the request
14400
14493
  # when you use the SDK. This header will not provide any additional
14401
14494
  # functionality if you don't use the SDK. When you send this header,
14402
14495
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14483,7 +14576,7 @@ module Aws::S3
14483
14576
  #
14484
14577
  # resp = client.put_bucket_lifecycle_configuration({
14485
14578
  # bucket: "BucketName", # required
14486
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14579
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14487
14580
  # lifecycle_configuration: {
14488
14581
  # rules: [ # required
14489
14582
  # {
@@ -14649,7 +14742,7 @@ module Aws::S3
14649
14742
  # automatically.
14650
14743
  #
14651
14744
  # @option params [String] :checksum_algorithm
14652
- # Indicates the algorithm used to create the checksum for the object
14745
+ # Indicates the algorithm used to create the checksum for the request
14653
14746
  # when you use the SDK. This header will not provide any additional
14654
14747
  # functionality if you don't use the SDK. When you send this header,
14655
14748
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14726,7 +14819,7 @@ module Aws::S3
14726
14819
  # },
14727
14820
  # },
14728
14821
  # content_md5: "ContentMD5",
14729
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14822
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14730
14823
  # expected_bucket_owner: "AccountId",
14731
14824
  # })
14732
14825
  #
@@ -14865,7 +14958,7 @@ module Aws::S3
14865
14958
  # automatically.
14866
14959
  #
14867
14960
  # @option params [String] :checksum_algorithm
14868
- # Indicates the algorithm used to create the checksum for the object
14961
+ # Indicates the algorithm used to create the checksum for the request
14869
14962
  # when you use the SDK. This header will not provide any additional
14870
14963
  # functionality if you don't use the SDK. When you send this header,
14871
14964
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14895,7 +14988,7 @@ module Aws::S3
14895
14988
  # resp = client.put_bucket_notification({
14896
14989
  # bucket: "BucketName", # required
14897
14990
  # content_md5: "ContentMD5",
14898
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14991
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14899
14992
  # notification_configuration: { # required
14900
14993
  # topic_configuration: {
14901
14994
  # id: "NotificationId",
@@ -15192,7 +15285,7 @@ module Aws::S3
15192
15285
  # about endpoints in Availability Zones, see [Regional and Zonal
15193
15286
  # endpoints for directory buckets in Availability Zones][1] in the
15194
15287
  # *Amazon S3 User Guide*. For more information about endpoints in Local
15195
- # Zones, see [Available Local Zone for directory buckets][2] in the
15288
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
15196
15289
  # *Amazon S3 User Guide*.
15197
15290
  #
15198
15291
  # </note>
@@ -15256,7 +15349,7 @@ module Aws::S3
15256
15349
  #
15257
15350
  #
15258
15351
  #
15259
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
15352
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
15260
15353
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
15261
15354
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
15262
15355
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
@@ -15295,7 +15388,7 @@ module Aws::S3
15295
15388
  # </note>
15296
15389
  #
15297
15390
  # @option params [String] :checksum_algorithm
15298
- # Indicates the algorithm used to create the checksum for the object
15391
+ # Indicates the algorithm used to create the checksum for the request
15299
15392
  # when you use the SDK. This header will not provide any additional
15300
15393
  # functionality if you don't use the SDK. When you send this header,
15301
15394
  # there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -15305,22 +15398,23 @@ module Aws::S3
15305
15398
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
15306
15399
  # the supported algorithm from the following list:
15307
15400
  #
15308
- # * `CRC32`
15401
+ # * `CRC-32`
15309
15402
  #
15310
- # * `CRC32C`
15403
+ # * `CRC-32C`
15311
15404
  #
15312
- # * `SHA1`
15405
+ # * `CRC-64NVME`
15313
15406
  #
15314
- # * `SHA256`
15407
+ # * `SHA-1`
15408
+ #
15409
+ # * `SHA-256`
15315
15410
  #
15316
15411
  # For more information, see [Checking object integrity][1] in the
15317
15412
  # *Amazon S3 User Guide*.
15318
15413
  #
15319
15414
  # If the individual checksum value you provide through
15320
15415
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
15321
- # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores any
15322
- # provided `ChecksumAlgorithm` parameter and uses the checksum algorithm
15323
- # that matches the provided value in `x-amz-checksum-algorithm `.
15416
+ # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
15417
+ # request with a `BadDigest` error.
15324
15418
  #
15325
15419
  # <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
15326
15420
  # is the default checksum algorithm that's used for performance.
@@ -15373,7 +15467,7 @@ module Aws::S3
15373
15467
  # resp = client.put_bucket_policy({
15374
15468
  # bucket: "BucketName", # required
15375
15469
  # content_md5: "ContentMD5",
15376
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15470
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15377
15471
  # confirm_remove_self_bucket_access: false,
15378
15472
  # policy: "Policy", # required
15379
15473
  # expected_bucket_owner: "AccountId",
@@ -15479,7 +15573,7 @@ module Aws::S3
15479
15573
  # The name of the bucket
15480
15574
  #
15481
15575
  # @option params [String] :content_md5
15482
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15576
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15483
15577
  # header as a message integrity check to verify that the request body
15484
15578
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15485
15579
  #
@@ -15492,7 +15586,7 @@ module Aws::S3
15492
15586
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15493
15587
  #
15494
15588
  # @option params [String] :checksum_algorithm
15495
- # Indicates the algorithm used to create the checksum for the object
15589
+ # Indicates the algorithm used to create the checksum for the request
15496
15590
  # when you use the SDK. This header will not provide any additional
15497
15591
  # functionality if you don't use the SDK. When you send this header,
15498
15592
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15548,7 +15642,7 @@ module Aws::S3
15548
15642
  # resp = client.put_bucket_replication({
15549
15643
  # bucket: "BucketName", # required
15550
15644
  # content_md5: "ContentMD5",
15551
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15645
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15552
15646
  # replication_configuration: { # required
15553
15647
  # role: "Role", # required
15554
15648
  # rules: [ # required
@@ -15652,7 +15746,7 @@ module Aws::S3
15652
15746
  # The bucket name.
15653
15747
  #
15654
15748
  # @option params [String] :content_md5
15655
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15749
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15656
15750
  # header as a message integrity check to verify that the request body
15657
15751
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15658
15752
  #
@@ -15665,7 +15759,7 @@ module Aws::S3
15665
15759
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15666
15760
  #
15667
15761
  # @option params [String] :checksum_algorithm
15668
- # Indicates the algorithm used to create the checksum for the object
15762
+ # Indicates the algorithm used to create the checksum for the request
15669
15763
  # when you use the SDK. This header will not provide any additional
15670
15764
  # functionality if you don't use the SDK. When you send this header,
15671
15765
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15707,7 +15801,7 @@ module Aws::S3
15707
15801
  # resp = client.put_bucket_request_payment({
15708
15802
  # bucket: "BucketName", # required
15709
15803
  # content_md5: "ContentMD5",
15710
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15804
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15711
15805
  # request_payment_configuration: { # required
15712
15806
  # payer: "Requester", # required, accepts Requester, BucketOwner
15713
15807
  # },
@@ -15789,7 +15883,7 @@ module Aws::S3
15789
15883
  # The bucket name.
15790
15884
  #
15791
15885
  # @option params [String] :content_md5
15792
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15886
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15793
15887
  # header as a message integrity check to verify that the request body
15794
15888
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15795
15889
  #
@@ -15802,7 +15896,7 @@ module Aws::S3
15802
15896
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15803
15897
  #
15804
15898
  # @option params [String] :checksum_algorithm
15805
- # Indicates the algorithm used to create the checksum for the object
15899
+ # Indicates the algorithm used to create the checksum for the request
15806
15900
  # when you use the SDK. This header will not provide any additional
15807
15901
  # functionality if you don't use the SDK. When you send this header,
15808
15902
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15853,7 +15947,7 @@ module Aws::S3
15853
15947
  # resp = client.put_bucket_tagging({
15854
15948
  # bucket: "BucketName", # required
15855
15949
  # content_md5: "ContentMD5",
15856
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15950
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15857
15951
  # tagging: { # required
15858
15952
  # tag_set: [ # required
15859
15953
  # {
@@ -15880,10 +15974,10 @@ module Aws::S3
15880
15974
  #
15881
15975
  # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
15882
15976
  # take a short amount of time for the change to be fully propagated.
15883
- # While this change is propagating, you may encounter intermittent `HTTP
15884
- # 404 NoSuchKey` errors for requests to objects created or updated after
15885
- # enabling versioning. We recommend that you wait for 15 minutes after
15886
- # enabling versioning before issuing write operations (`PUT` or
15977
+ # While this change is propagating, you might encounter intermittent
15978
+ # `HTTP 404 NoSuchKey` errors for requests to objects created or updated
15979
+ # after enabling versioning. We recommend that you wait for 15 minutes
15980
+ # after enabling versioning before issuing write operations (`PUT` or
15887
15981
  # `DELETE`) on objects in the bucket.
15888
15982
  #
15889
15983
  # </note>
@@ -15936,7 +16030,7 @@ module Aws::S3
15936
16030
  # The bucket name.
15937
16031
  #
15938
16032
  # @option params [String] :content_md5
15939
- # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
16033
+ # &gt;The Base64 encoded 128-bit `MD5` digest of the data. You must use
15940
16034
  # this header as a message integrity check to verify that the request
15941
16035
  # body was not corrupted in transit. For more information, see [RFC
15942
16036
  # 1864][1].
@@ -15950,7 +16044,7 @@ module Aws::S3
15950
16044
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15951
16045
  #
15952
16046
  # @option params [String] :checksum_algorithm
15953
- # Indicates the algorithm used to create the checksum for the object
16047
+ # Indicates the algorithm used to create the checksum for the request
15954
16048
  # when you use the SDK. This header will not provide any additional
15955
16049
  # functionality if you don't use the SDK. When you send this header,
15956
16050
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15997,7 +16091,7 @@ module Aws::S3
15997
16091
  # resp = client.put_bucket_versioning({
15998
16092
  # bucket: "BucketName", # required
15999
16093
  # content_md5: "ContentMD5",
16000
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
16094
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
16001
16095
  # mfa: "MFA",
16002
16096
  # versioning_configuration: { # required
16003
16097
  # mfa_delete: "Enabled", # accepts Enabled, Disabled
@@ -16098,7 +16192,7 @@ module Aws::S3
16098
16192
  # The bucket name.
16099
16193
  #
16100
16194
  # @option params [String] :content_md5
16101
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
16195
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
16102
16196
  # header as a message integrity check to verify that the request body
16103
16197
  # was not corrupted in transit. For more information, see [RFC 1864][1].
16104
16198
  #
@@ -16111,7 +16205,7 @@ module Aws::S3
16111
16205
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
16112
16206
  #
16113
16207
  # @option params [String] :checksum_algorithm
16114
- # Indicates the algorithm used to create the checksum for the object
16208
+ # Indicates the algorithm used to create the checksum for the request
16115
16209
  # when you use the SDK. This header will not provide any additional
16116
16210
  # functionality if you don't use the SDK. When you send this header,
16117
16211
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -16159,7 +16253,7 @@ module Aws::S3
16159
16253
  # resp = client.put_bucket_website({
16160
16254
  # bucket: "BucketName", # required
16161
16255
  # content_md5: "ContentMD5",
16162
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
16256
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
16163
16257
  # website_configuration: { # required
16164
16258
  # error_document: {
16165
16259
  # key: "ObjectKey", # required
@@ -16215,13 +16309,13 @@ module Aws::S3
16215
16309
  # * **Directory buckets** - For directory buckets, you must make
16216
16310
  # requests for this API operation to the Zonal endpoint. These
16217
16311
  # endpoints support virtual-hosted-style requests in the format
16218
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
16312
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
16219
16313
  # `. Path-style requests are not supported. For more information about
16220
16314
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
16221
16315
  # for directory buckets in Availability Zones][1] in the *Amazon S3
16222
16316
  # User Guide*. For more information about endpoints in Local Zones,
16223
- # see [Available Local Zone for directory buckets][2] in the *Amazon
16224
- # S3 User Guide*.
16317
+ # see [Concepts for directory buckets in Local Zones][2] in the
16318
+ # *Amazon S3 User Guide*.
16225
16319
  #
16226
16320
  # </note>
16227
16321
  #
@@ -16238,6 +16332,23 @@ module Aws::S3
16238
16332
  #
16239
16333
  # </note>
16240
16334
  #
16335
+ # * **If-None-Match** - Uploads the object only if the object key name
16336
+ # does not already exist in the specified bucket. Otherwise, Amazon S3
16337
+ # returns a `412 Precondition Failed` error. If a conflicting
16338
+ # operation occurs during the upload, S3 returns a `409
16339
+ # ConditionalRequestConflict` response. On a 409 failure, retry the
16340
+ # upload.
16341
+ #
16342
+ # Expects the * character (asterisk).
16343
+ #
16344
+ # For more information, see [Add preconditions to S3 operations with
16345
+ # conditional requests][4] in the *Amazon S3 User Guide* or [RFC
16346
+ # 7232][5].
16347
+ #
16348
+ # <note markdown="1"> This functionality is not supported for S3 on Outposts.
16349
+ #
16350
+ # </note>
16351
+ #
16241
16352
  # * **S3 Versioning** - When you enable versioning for a bucket, if
16242
16353
  # Amazon S3 receives multiple write requests for the same object
16243
16354
  # simultaneously, it stores all versions of the objects. For each
@@ -16245,9 +16356,9 @@ module Aws::S3
16245
16356
  # automatically generates a unique version ID of that object being
16246
16357
  # stored in Amazon S3. You can retrieve, replace, or delete any
16247
16358
  # version of the object. For more information about versioning, see
16248
- # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
16359
+ # [Adding Objects to Versioning-Enabled Buckets][6] in the *Amazon S3
16249
16360
  # User Guide*. For information about returning the versioning state of
16250
- # a bucket, see [GetBucketVersioning][5].
16361
+ # a bucket, see [GetBucketVersioning][7].
16251
16362
  #
16252
16363
  # <note markdown="1"> This functionality is not supported for directory buckets.
16253
16364
  #
@@ -16271,7 +16382,7 @@ module Aws::S3
16271
16382
  # `s3:PutObjectTagging`.
16272
16383
  # * **Directory bucket permissions** - To grant access to this API
16273
16384
  # operation on a directory bucket, we recommend that you use the [
16274
- # `CreateSession` ][6] API operation for session-based
16385
+ # `CreateSession` ][8] API operation for session-based
16275
16386
  # authorization. Specifically, you grant the
16276
16387
  # `s3express:CreateSession` permission to the directory bucket in a
16277
16388
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -16282,7 +16393,7 @@ module Aws::S3
16282
16393
  # token for use. Amazon Web Services CLI or SDKs create session and
16283
16394
  # refresh the session token automatically to avoid service
16284
16395
  # interruptions when a session expires. For more information about
16285
- # authorization, see [ `CreateSession` ][6].
16396
+ # authorization, see [ `CreateSession` ][8].
16286
16397
  #
16287
16398
  # If the object is encrypted with SSE-KMS, you must also have the
16288
16399
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -16307,20 +16418,22 @@ module Aws::S3
16307
16418
  #
16308
16419
  # For more information about related Amazon S3 APIs, see the following:
16309
16420
  #
16310
- # * [CopyObject][7]
16421
+ # * [CopyObject][9]
16311
16422
  #
16312
- # * [DeleteObject][8]
16423
+ # * [DeleteObject][10]
16313
16424
  #
16314
16425
  #
16315
16426
  #
16316
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
16427
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
16317
16428
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
16318
16429
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
16319
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
16320
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
16321
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
16322
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
16323
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
16430
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
16431
+ # [5]: https://datatracker.ietf.org/doc/rfc7232/
16432
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
16433
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
16434
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
16435
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
16436
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
16324
16437
  #
16325
16438
  # @option params [String] :acl
16326
16439
  # The canned ACL to apply to the object. For more information, see
@@ -16372,7 +16485,7 @@ module Aws::S3
16372
16485
  # requests are not supported. Directory bucket names must be unique in
16373
16486
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
16374
16487
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
16375
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
16488
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
16376
16489
  # naming restrictions, see [Directory bucket naming rules][1] in the
16377
16490
  # *Amazon S3 User Guide*.
16378
16491
  #
@@ -16392,14 +16505,14 @@ module Aws::S3
16392
16505
  #
16393
16506
  # </note>
16394
16507
  #
16395
- # **S3 on Outposts** - When you use this action with Amazon S3 on
16396
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
16397
- # S3 on Outposts hostname takes the form `
16508
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
16509
+ # must direct requests to the S3 on Outposts hostname. The S3 on
16510
+ # Outposts hostname takes the form `
16398
16511
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
16399
- # When you use this action with S3 on Outposts through the Amazon Web
16400
- # Services SDKs, you provide the Outposts access point ARN in place of
16401
- # the bucket name. For more information about S3 on Outposts ARNs, see
16402
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
16512
+ # When you use this action with S3 on Outposts, the destination bucket
16513
+ # must be the Outposts access point ARN or the access point alias. For
16514
+ # more information about S3 on Outposts, see [What is S3 on
16515
+ # Outposts?][3] in the *Amazon S3 User Guide*.
16403
16516
  #
16404
16517
  #
16405
16518
  #
@@ -16448,7 +16561,7 @@ module Aws::S3
16448
16561
  # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
16449
16562
  #
16450
16563
  # @option params [String] :content_md5
16451
- # The base64-encoded 128-bit MD5 digest of the message (without the
16564
+ # The Base64 encoded 128-bit `MD5` digest of the message (without the
16452
16565
  # headers) according to RFC 1864. This header can be used as a message
16453
16566
  # integrity check to verify that the data is the same data that was
16454
16567
  # originally sent. Although it is optional, we recommend using the
@@ -16493,22 +16606,23 @@ module Aws::S3
16493
16606
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
16494
16607
  # the supported algorithm from the following list:
16495
16608
  #
16496
- # * `CRC32`
16609
+ # * `CRC-32`
16610
+ #
16611
+ # * `CRC-32C`
16497
16612
  #
16498
- # * `CRC32C`
16613
+ # * `CRC-64NVME`
16499
16614
  #
16500
- # * `SHA1`
16615
+ # * `SHA-1`
16501
16616
  #
16502
- # * `SHA256`
16617
+ # * `SHA-256`
16503
16618
  #
16504
16619
  # For more information, see [Checking object integrity][1] in the
16505
16620
  # *Amazon S3 User Guide*.
16506
16621
  #
16507
16622
  # If the individual checksum value you provide through
16508
16623
  # `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
16509
- # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 ignores any
16510
- # provided `ChecksumAlgorithm` parameter and uses the checksum algorithm
16511
- # that matches the provided value in `x-amz-checksum-algorithm `.
16624
+ # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
16625
+ # request with a `BadDigest` error.
16512
16626
  #
16513
16627
  # <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
16514
16628
  # for any request to upload an object with a retention period configured
@@ -16529,7 +16643,7 @@ module Aws::S3
16529
16643
  # @option params [String] :checksum_crc32
16530
16644
  # This header can be used as a data integrity check to verify that the
16531
16645
  # data received is the same data that was originally sent. This header
16532
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
16646
+ # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
16533
16647
  # For more information, see [Checking object integrity][1] in the
16534
16648
  # *Amazon S3 User Guide*.
16535
16649
  #
@@ -16540,7 +16654,7 @@ module Aws::S3
16540
16654
  # @option params [String] :checksum_crc32c
16541
16655
  # This header can be used as a data integrity check to verify that the
16542
16656
  # data received is the same data that was originally sent. This header
16543
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
16657
+ # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
16544
16658
  # For more information, see [Checking object integrity][1] in the
16545
16659
  # *Amazon S3 User Guide*.
16546
16660
  #
@@ -16548,12 +16662,24 @@ module Aws::S3
16548
16662
  #
16549
16663
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
16550
16664
  #
16665
+ # @option params [String] :checksum_crc64nvme
16666
+ # This header can be used as a data integrity check to verify that the
16667
+ # data received is the same data that was originally sent. This header
16668
+ # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
16669
+ # object. The `CRC-64NVME` checksum is always a full object checksum.
16670
+ # For more information, see [Checking object integrity in the Amazon S3
16671
+ # User Guide][1].
16672
+ #
16673
+ #
16674
+ #
16675
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
16676
+ #
16551
16677
  # @option params [String] :checksum_sha1
16552
16678
  # This header can be used as a data integrity check to verify that the
16553
16679
  # data received is the same data that was originally sent. This header
16554
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object. For
16555
- # more information, see [Checking object integrity][1] in the *Amazon S3
16556
- # User Guide*.
16680
+ # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
16681
+ # For more information, see [Checking object integrity][1] in the
16682
+ # *Amazon S3 User Guide*.
16557
16683
  #
16558
16684
  #
16559
16685
  #
@@ -16562,7 +16688,7 @@ module Aws::S3
16562
16688
  # @option params [String] :checksum_sha256
16563
16689
  # This header can be used as a data integrity check to verify that the
16564
16690
  # data received is the same data that was originally sent. This header
16565
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
16691
+ # specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
16566
16692
  # For more information, see [Checking object integrity][1] in the
16567
16693
  # *Amazon S3 User Guide*.
16568
16694
  #
@@ -16828,20 +16954,17 @@ module Aws::S3
16828
16954
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
16829
16955
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
16830
16956
  #
16831
- # **Directory buckets** - If you specify `x-amz-server-side-encryption`
16832
- # with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
16833
- # header is implicitly assigned the ID of the KMS symmetric encryption
16834
- # customer managed key that's configured for your directory bucket's
16835
- # default encryption setting. If you want to specify the `
16836
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
16837
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
16838
- # customer managed key that's configured for your directory bucket's
16839
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
16840
- # Request` error. Only use the key ID or key ARN. The key alias format
16841
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
16842
- # support 1 [customer managed key][1] per directory bucket for the
16843
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
16844
- # (`aws/s3`) isn't supported.
16957
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
16958
+ # recommended to specify the `x-amz-server-side-encryption` header to
16959
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
16960
+ # header implicitly uses the bucket's default KMS customer managed key
16961
+ # ID. If you want to explicitly set the `
16962
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
16963
+ # bucket's default customer managed key (using key ID or ARN, not
16964
+ # alias). Your SSE-KMS configuration can only support 1 [customer
16965
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
16966
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
16967
+ # specification results in an HTTP `400 Bad Request` error.
16845
16968
  #
16846
16969
  #
16847
16970
  #
@@ -16851,7 +16974,7 @@ module Aws::S3
16851
16974
  # @option params [String] :ssekms_encryption_context
16852
16975
  # Specifies the Amazon Web Services KMS Encryption Context as an
16853
16976
  # additional encryption context to use for object encryption. The value
16854
- # of this header is a Base64-encoded string of a UTF-8 encoded JSON,
16977
+ # of this header is a Base64 encoded string of a UTF-8 encoded JSON,
16855
16978
  # which contains the encryption context as key-value pairs. This value
16856
16979
  # is stored as object metadata and automatically gets passed on to
16857
16980
  # Amazon Web Services KMS for future `GetObject` operations on this
@@ -16962,8 +17085,10 @@ module Aws::S3
16962
17085
  # * {Types::PutObjectOutput#etag #etag} => String
16963
17086
  # * {Types::PutObjectOutput#checksum_crc32 #checksum_crc32} => String
16964
17087
  # * {Types::PutObjectOutput#checksum_crc32c #checksum_crc32c} => String
17088
+ # * {Types::PutObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
16965
17089
  # * {Types::PutObjectOutput#checksum_sha1 #checksum_sha1} => String
16966
17090
  # * {Types::PutObjectOutput#checksum_sha256 #checksum_sha256} => String
17091
+ # * {Types::PutObjectOutput#checksum_type #checksum_type} => String
16967
17092
  # * {Types::PutObjectOutput#server_side_encryption #server_side_encryption} => String
16968
17093
  # * {Types::PutObjectOutput#version_id #version_id} => String
16969
17094
  # * {Types::PutObjectOutput#sse_customer_algorithm #sse_customer_algorithm} => String
@@ -16975,26 +17100,6 @@ module Aws::S3
16975
17100
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16976
17101
  #
16977
17102
  #
16978
- # @example Example: To upload an object (specify optional headers)
16979
- #
16980
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
16981
- # # storage class and use server-side encryption.
16982
- #
16983
- # resp = client.put_object({
16984
- # body: "HappyFace.jpg",
16985
- # bucket: "examplebucket",
16986
- # key: "HappyFace.jpg",
16987
- # server_side_encryption: "AES256",
16988
- # storage_class: "STANDARD_IA",
16989
- # })
16990
- #
16991
- # resp.to_h outputs the following:
16992
- # {
16993
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16994
- # server_side_encryption: "AES256",
16995
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
16996
- # }
16997
- #
16998
17103
  # @example Example: To upload an object and specify server-side encryption and object tags
16999
17104
  #
17000
17105
  # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
@@ -17036,22 +17141,20 @@ module Aws::S3
17036
17141
  # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
17037
17142
  # }
17038
17143
  #
17039
- # @example Example: To upload an object and specify canned ACL.
17144
+ # @example Example: To create an object.
17040
17145
  #
17041
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
17042
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
17146
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
17043
17147
  #
17044
17148
  # resp = client.put_object({
17045
- # acl: "authenticated-read",
17046
17149
  # body: "filetoupload",
17047
17150
  # bucket: "examplebucket",
17048
- # key: "exampleobject",
17151
+ # key: "objectkey",
17049
17152
  # })
17050
17153
  #
17051
17154
  # resp.to_h outputs the following:
17052
17155
  # {
17053
17156
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17054
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
17157
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
17055
17158
  # }
17056
17159
  #
17057
17160
  # @example Example: To upload an object and specify optional tags
@@ -17072,37 +17175,59 @@ module Aws::S3
17072
17175
  # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
17073
17176
  # }
17074
17177
  #
17075
- # @example Example: To upload an object
17178
+ # @example Example: To upload an object and specify canned ACL.
17076
17179
  #
17077
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
17078
- # # syntax. S3 returns VersionId of the newly created object.
17180
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
17181
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
17182
+ #
17183
+ # resp = client.put_object({
17184
+ # acl: "authenticated-read",
17185
+ # body: "filetoupload",
17186
+ # bucket: "examplebucket",
17187
+ # key: "exampleobject",
17188
+ # })
17189
+ #
17190
+ # resp.to_h outputs the following:
17191
+ # {
17192
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17193
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
17194
+ # }
17195
+ #
17196
+ # @example Example: To upload an object (specify optional headers)
17197
+ #
17198
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
17199
+ # # storage class and use server-side encryption.
17079
17200
  #
17080
17201
  # resp = client.put_object({
17081
17202
  # body: "HappyFace.jpg",
17082
17203
  # bucket: "examplebucket",
17083
17204
  # key: "HappyFace.jpg",
17205
+ # server_side_encryption: "AES256",
17206
+ # storage_class: "STANDARD_IA",
17084
17207
  # })
17085
17208
  #
17086
17209
  # resp.to_h outputs the following:
17087
17210
  # {
17088
17211
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17089
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
17212
+ # server_side_encryption: "AES256",
17213
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
17090
17214
  # }
17091
17215
  #
17092
- # @example Example: To create an object.
17216
+ # @example Example: To upload an object
17093
17217
  #
17094
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
17218
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
17219
+ # # syntax. S3 returns VersionId of the newly created object.
17095
17220
  #
17096
17221
  # resp = client.put_object({
17097
- # body: "filetoupload",
17222
+ # body: "HappyFace.jpg",
17098
17223
  # bucket: "examplebucket",
17099
- # key: "objectkey",
17224
+ # key: "HappyFace.jpg",
17100
17225
  # })
17101
17226
  #
17102
17227
  # resp.to_h outputs the following:
17103
17228
  # {
17104
17229
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17105
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
17230
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
17106
17231
  # }
17107
17232
  #
17108
17233
  # @example Streaming a file from disk
@@ -17124,9 +17249,10 @@ module Aws::S3
17124
17249
  # content_length: 1,
17125
17250
  # content_md5: "ContentMD5",
17126
17251
  # content_type: "ContentType",
17127
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17252
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17128
17253
  # checksum_crc32: "ChecksumCRC32",
17129
17254
  # checksum_crc32c: "ChecksumCRC32C",
17255
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
17130
17256
  # checksum_sha1: "ChecksumSHA1",
17131
17257
  # checksum_sha256: "ChecksumSHA256",
17132
17258
  # expires: Time.now,
@@ -17164,8 +17290,10 @@ module Aws::S3
17164
17290
  # resp.etag #=> String
17165
17291
  # resp.checksum_crc32 #=> String
17166
17292
  # resp.checksum_crc32c #=> String
17293
+ # resp.checksum_crc64nvme #=> String
17167
17294
  # resp.checksum_sha1 #=> String
17168
17295
  # resp.checksum_sha256 #=> String
17296
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
17169
17297
  # resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
17170
17298
  # resp.version_id #=> String
17171
17299
  # resp.sse_customer_algorithm #=> String
@@ -17379,14 +17507,14 @@ module Aws::S3
17379
17507
  # name. For more information about access point ARNs, see [Using access
17380
17508
  # points][1] in the *Amazon S3 User Guide*.
17381
17509
  #
17382
- # **S3 on Outposts** - When you use this action with Amazon S3 on
17383
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
17384
- # S3 on Outposts hostname takes the form `
17510
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
17511
+ # must direct requests to the S3 on Outposts hostname. The S3 on
17512
+ # Outposts hostname takes the form `
17385
17513
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
17386
- # When you use this action with S3 on Outposts through the Amazon Web
17387
- # Services SDKs, you provide the Outposts access point ARN in place of
17388
- # the bucket name. For more information about S3 on Outposts ARNs, see
17389
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
17514
+ # When you use this action with S3 on Outposts, the destination bucket
17515
+ # must be the Outposts access point ARN or the access point alias. For
17516
+ # more information about S3 on Outposts, see [What is S3 on
17517
+ # Outposts?][2] in the *Amazon S3 User Guide*.
17390
17518
  #
17391
17519
  #
17392
17520
  #
@@ -17394,9 +17522,9 @@ module Aws::S3
17394
17522
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
17395
17523
  #
17396
17524
  # @option params [String] :content_md5
17397
- # The base64-encoded 128-bit MD5 digest of the data. This header must be
17398
- # used as a message integrity check to verify that the request body was
17399
- # not corrupted in transit. For more information, go to [RFC
17525
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
17526
+ # be used as a message integrity check to verify that the request body
17527
+ # was not corrupted in transit. For more information, go to [RFC
17400
17528
  # 1864.&gt;][1]
17401
17529
  #
17402
17530
  # For requests made using the Amazon Web Services Command Line Interface
@@ -17529,7 +17657,7 @@ module Aws::S3
17529
17657
  # },
17530
17658
  # bucket: "BucketName", # required
17531
17659
  # content_md5: "ContentMD5",
17532
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17660
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17533
17661
  # grant_full_control: "GrantFullControl",
17534
17662
  # grant_read: "GrantRead",
17535
17663
  # grant_read_acp: "GrantReadACP",
@@ -17656,7 +17784,7 @@ module Aws::S3
17656
17784
  # request_payer: "requester", # accepts requester
17657
17785
  # version_id: "ObjectVersionId",
17658
17786
  # content_md5: "ContentMD5",
17659
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17787
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17660
17788
  # expected_bucket_owner: "AccountId",
17661
17789
  # })
17662
17790
  #
@@ -17775,7 +17903,7 @@ module Aws::S3
17775
17903
  # request_payer: "requester", # accepts requester
17776
17904
  # token: "ObjectLockToken",
17777
17905
  # content_md5: "ContentMD5",
17778
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17906
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17779
17907
  # expected_bucket_owner: "AccountId",
17780
17908
  # })
17781
17909
  #
@@ -17904,7 +18032,7 @@ module Aws::S3
17904
18032
  # version_id: "ObjectVersionId",
17905
18033
  # bypass_governance_retention: false,
17906
18034
  # content_md5: "ContentMD5",
17907
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18035
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17908
18036
  # expected_bucket_owner: "AccountId",
17909
18037
  # })
17910
18038
  #
@@ -17988,14 +18116,14 @@ module Aws::S3
17988
18116
  # name. For more information about access point ARNs, see [Using access
17989
18117
  # points][1] in the *Amazon S3 User Guide*.
17990
18118
  #
17991
- # **S3 on Outposts** - When you use this action with Amazon S3 on
17992
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
17993
- # S3 on Outposts hostname takes the form `
18119
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
18120
+ # must direct requests to the S3 on Outposts hostname. The S3 on
18121
+ # Outposts hostname takes the form `
17994
18122
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
17995
- # When you use this action with S3 on Outposts through the Amazon Web
17996
- # Services SDKs, you provide the Outposts access point ARN in place of
17997
- # the bucket name. For more information about S3 on Outposts ARNs, see
17998
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
18123
+ # When you use this action with S3 on Outposts, the destination bucket
18124
+ # must be the Outposts access point ARN or the access point alias. For
18125
+ # more information about S3 on Outposts, see [What is S3 on
18126
+ # Outposts?][2] in the *Amazon S3 User Guide*.
17999
18127
  #
18000
18128
  #
18001
18129
  #
@@ -18094,7 +18222,7 @@ module Aws::S3
18094
18222
  # key: "ObjectKey", # required
18095
18223
  # version_id: "ObjectVersionId",
18096
18224
  # content_md5: "ContentMD5",
18097
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18225
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18098
18226
  # tagging: { # required
18099
18227
  # tag_set: [ # required
18100
18228
  # {
@@ -18209,7 +18337,7 @@ module Aws::S3
18209
18337
  # resp = client.put_public_access_block({
18210
18338
  # bucket: "BucketName", # required
18211
18339
  # content_md5: "ContentMD5",
18212
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18340
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18213
18341
  # public_access_block_configuration: { # required
18214
18342
  # block_public_acls: false,
18215
18343
  # ignore_public_acls: false,
@@ -18420,14 +18548,14 @@ module Aws::S3
18420
18548
  # name. For more information about access point ARNs, see [Using access
18421
18549
  # points][1] in the *Amazon S3 User Guide*.
18422
18550
  #
18423
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18424
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
18425
- # S3 on Outposts hostname takes the form `
18551
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
18552
+ # must direct requests to the S3 on Outposts hostname. The S3 on
18553
+ # Outposts hostname takes the form `
18426
18554
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18427
- # When you use this action with S3 on Outposts through the Amazon Web
18428
- # Services SDKs, you provide the Outposts access point ARN in place of
18429
- # the bucket name. For more information about S3 on Outposts ARNs, see
18430
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
18555
+ # When you use this action with S3 on Outposts, the destination bucket
18556
+ # must be the Outposts access point ARN or the access point alias. For
18557
+ # more information about S3 on Outposts, see [What is S3 on
18558
+ # Outposts?][2] in the *Amazon S3 User Guide*.
18431
18559
  #
18432
18560
  #
18433
18561
  #
@@ -18594,7 +18722,7 @@ module Aws::S3
18594
18722
  # },
18595
18723
  # },
18596
18724
  # request_payer: "requester", # accepts requester
18597
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18725
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18598
18726
  # expected_bucket_owner: "AccountId",
18599
18727
  # })
18600
18728
  #
@@ -19066,13 +19194,13 @@ module Aws::S3
19066
19194
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19067
19195
  # for this API operation to the Zonal endpoint. These endpoints support
19068
19196
  # virtual-hosted-style requests in the format
19069
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19197
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
19070
19198
  # `. Path-style requests are not supported. For more information about
19071
19199
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19072
19200
  # directory buckets in Availability Zones][5] in the *Amazon S3 User
19073
19201
  # Guide*. For more information about endpoints in Local Zones, see
19074
- # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
19075
- # Guide*.
19202
+ # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
19203
+ # User Guide*.
19076
19204
  #
19077
19205
  # </note>
19078
19206
  #
@@ -19206,7 +19334,7 @@ module Aws::S3
19206
19334
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19207
19335
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
19208
19336
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
19209
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
19337
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
19210
19338
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19211
19339
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19212
19340
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
@@ -19231,7 +19359,7 @@ module Aws::S3
19231
19359
  # requests are not supported. Directory bucket names must be unique in
19232
19360
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19233
19361
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19234
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19362
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
19235
19363
  # naming restrictions, see [Directory bucket naming rules][1] in the
19236
19364
  # *Amazon S3 User Guide*.
19237
19365
  #
@@ -19251,14 +19379,14 @@ module Aws::S3
19251
19379
  #
19252
19380
  # </note>
19253
19381
  #
19254
- # **S3 on Outposts** - When you use this action with Amazon S3 on
19255
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
19256
- # S3 on Outposts hostname takes the form `
19382
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
19383
+ # must direct requests to the S3 on Outposts hostname. The S3 on
19384
+ # Outposts hostname takes the form `
19257
19385
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
19258
- # When you use this action with S3 on Outposts through the Amazon Web
19259
- # Services SDKs, you provide the Outposts access point ARN in place of
19260
- # the bucket name. For more information about S3 on Outposts ARNs, see
19261
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
19386
+ # When you use this action with S3 on Outposts, the destination bucket
19387
+ # must be the Outposts access point ARN or the access point alias. For
19388
+ # more information about S3 on Outposts, see [What is S3 on
19389
+ # Outposts?][3] in the *Amazon S3 User Guide*.
19262
19390
  #
19263
19391
  #
19264
19392
  #
@@ -19271,7 +19399,7 @@ module Aws::S3
19271
19399
  # the body cannot be determined automatically.
19272
19400
  #
19273
19401
  # @option params [String] :content_md5
19274
- # The base64-encoded 128-bit MD5 digest of the part data. This parameter
19402
+ # The Base64 encoded 128-bit MD5 digest of the part data. This parameter
19275
19403
  # is auto-populated when using the command from the CLI. This parameter
19276
19404
  # is required if object lock parameters are specified.
19277
19405
  #
@@ -19301,7 +19429,7 @@ module Aws::S3
19301
19429
  # @option params [String] :checksum_crc32
19302
19430
  # This header can be used as a data integrity check to verify that the
19303
19431
  # data received is the same data that was originally sent. This header
19304
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
19432
+ # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
19305
19433
  # For more information, see [Checking object integrity][1] in the
19306
19434
  # *Amazon S3 User Guide*.
19307
19435
  #
@@ -19312,7 +19440,7 @@ module Aws::S3
19312
19440
  # @option params [String] :checksum_crc32c
19313
19441
  # This header can be used as a data integrity check to verify that the
19314
19442
  # data received is the same data that was originally sent. This header
19315
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
19443
+ # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
19316
19444
  # For more information, see [Checking object integrity][1] in the
19317
19445
  # *Amazon S3 User Guide*.
19318
19446
  #
@@ -19320,12 +19448,23 @@ module Aws::S3
19320
19448
  #
19321
19449
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
19322
19450
  #
19451
+ # @option params [String] :checksum_crc64nvme
19452
+ # This header can be used as a data integrity check to verify that the
19453
+ # data received is the same data that was originally sent. This header
19454
+ # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
19455
+ # part. For more information, see [Checking object integrity][1] in the
19456
+ # *Amazon S3 User Guide*.
19457
+ #
19458
+ #
19459
+ #
19460
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
19461
+ #
19323
19462
  # @option params [String] :checksum_sha1
19324
19463
  # This header can be used as a data integrity check to verify that the
19325
19464
  # data received is the same data that was originally sent. This header
19326
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object. For
19327
- # more information, see [Checking object integrity][1] in the *Amazon S3
19328
- # User Guide*.
19465
+ # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
19466
+ # For more information, see [Checking object integrity][1] in the
19467
+ # *Amazon S3 User Guide*.
19329
19468
  #
19330
19469
  #
19331
19470
  #
@@ -19334,7 +19473,7 @@ module Aws::S3
19334
19473
  # @option params [String] :checksum_sha256
19335
19474
  # This header can be used as a data integrity check to verify that the
19336
19475
  # data received is the same data that was originally sent. This header
19337
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object.
19476
+ # specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
19338
19477
  # For more information, see [Checking object integrity][1] in the
19339
19478
  # *Amazon S3 User Guide*.
19340
19479
  #
@@ -19411,6 +19550,7 @@ module Aws::S3
19411
19550
  # * {Types::UploadPartOutput#etag #etag} => String
19412
19551
  # * {Types::UploadPartOutput#checksum_crc32 #checksum_crc32} => String
19413
19552
  # * {Types::UploadPartOutput#checksum_crc32c #checksum_crc32c} => String
19553
+ # * {Types::UploadPartOutput#checksum_crc64nvme #checksum_crc64nvme} => String
19414
19554
  # * {Types::UploadPartOutput#checksum_sha1 #checksum_sha1} => String
19415
19555
  # * {Types::UploadPartOutput#checksum_sha256 #checksum_sha256} => String
19416
19556
  # * {Types::UploadPartOutput#sse_customer_algorithm #sse_customer_algorithm} => String
@@ -19445,9 +19585,10 @@ module Aws::S3
19445
19585
  # bucket: "BucketName", # required
19446
19586
  # content_length: 1,
19447
19587
  # content_md5: "ContentMD5",
19448
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
19588
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
19449
19589
  # checksum_crc32: "ChecksumCRC32",
19450
19590
  # checksum_crc32c: "ChecksumCRC32C",
19591
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
19451
19592
  # checksum_sha1: "ChecksumSHA1",
19452
19593
  # checksum_sha256: "ChecksumSHA256",
19453
19594
  # key: "ObjectKey", # required
@@ -19466,6 +19607,7 @@ module Aws::S3
19466
19607
  # resp.etag #=> String
19467
19608
  # resp.checksum_crc32 #=> String
19468
19609
  # resp.checksum_crc32c #=> String
19610
+ # resp.checksum_crc64nvme #=> String
19469
19611
  # resp.checksum_sha1 #=> String
19470
19612
  # resp.checksum_sha256 #=> String
19471
19613
  # resp.sse_customer_algorithm #=> String
@@ -19511,13 +19653,13 @@ module Aws::S3
19511
19653
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19512
19654
  # for this API operation to the Zonal endpoint. These endpoints support
19513
19655
  # virtual-hosted-style requests in the format
19514
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19656
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
19515
19657
  # `. Path-style requests are not supported. For more information about
19516
19658
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19517
19659
  # directory buckets in Availability Zones][5] in the *Amazon S3 User
19518
19660
  # Guide*. For more information about endpoints in Local Zones, see
19519
- # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
19520
- # Guide*.
19661
+ # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
19662
+ # User Guide*.
19521
19663
  #
19522
19664
  # </note>
19523
19665
  #
@@ -19662,7 +19804,7 @@ module Aws::S3
19662
19804
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
19663
19805
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19664
19806
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
19665
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
19807
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
19666
19808
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19667
19809
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19668
19810
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
@@ -19688,7 +19830,7 @@ module Aws::S3
19688
19830
  # requests are not supported. Directory bucket names must be unique in
19689
19831
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19690
19832
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19691
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19833
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
19692
19834
  # naming restrictions, see [Directory bucket naming rules][1] in the
19693
19835
  # *Amazon S3 User Guide*.
19694
19836
  #
@@ -19716,14 +19858,14 @@ module Aws::S3
19716
19858
  #
19717
19859
  # </note>
19718
19860
  #
19719
- # **S3 on Outposts** - When you use this action with Amazon S3 on
19720
- # Outposts, you must direct requests to the S3 on Outposts hostname. The
19721
- # S3 on Outposts hostname takes the form `
19861
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
19862
+ # must direct requests to the S3 on Outposts hostname. The S3 on
19863
+ # Outposts hostname takes the form `
19722
19864
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
19723
- # When you use this action with S3 on Outposts through the Amazon Web
19724
- # Services SDKs, you provide the Outposts access point ARN in place of
19725
- # the bucket name. For more information about S3 on Outposts ARNs, see
19726
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
19865
+ # When you use this action with S3 on Outposts, the destination bucket
19866
+ # must be the Outposts access point ARN or the access point alias. For
19867
+ # more information about S3 on Outposts, see [What is S3 on
19868
+ # Outposts?][3] in the *Amazon S3 User Guide*.
19727
19869
  #
19728
19870
  #
19729
19871
  #
@@ -19971,45 +20113,45 @@ module Aws::S3
19971
20113
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
19972
20114
  #
19973
20115
  #
19974
- # @example Example: To upload a part by copying byte range from an existing object as data source
20116
+ # @example Example: To upload a part by copying data from an existing object as data source
19975
20117
  #
19976
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
19977
- # # data source.
20118
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
19978
20119
  #
19979
20120
  # resp = client.upload_part_copy({
19980
20121
  # bucket: "examplebucket",
19981
20122
  # copy_source: "/bucketname/sourceobjectkey",
19982
- # copy_source_range: "bytes=1-100000",
19983
20123
  # key: "examplelargeobject",
19984
- # part_number: 2,
20124
+ # part_number: 1,
19985
20125
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
19986
20126
  # })
19987
20127
  #
19988
20128
  # resp.to_h outputs the following:
19989
20129
  # {
19990
20130
  # copy_part_result: {
19991
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
19992
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
20131
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
20132
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
19993
20133
  # },
19994
20134
  # }
19995
20135
  #
19996
- # @example Example: To upload a part by copying data from an existing object as data source
20136
+ # @example Example: To upload a part by copying byte range from an existing object as data source
19997
20137
  #
19998
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
20138
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
20139
+ # # data source.
19999
20140
  #
20000
20141
  # resp = client.upload_part_copy({
20001
20142
  # bucket: "examplebucket",
20002
20143
  # copy_source: "/bucketname/sourceobjectkey",
20144
+ # copy_source_range: "bytes=1-100000",
20003
20145
  # key: "examplelargeobject",
20004
- # part_number: 1,
20146
+ # part_number: 2,
20005
20147
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
20006
20148
  # })
20007
20149
  #
20008
20150
  # resp.to_h outputs the following:
20009
20151
  # {
20010
20152
  # copy_part_result: {
20011
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
20012
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
20153
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
20154
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
20013
20155
  # },
20014
20156
  # }
20015
20157
  #
@@ -20044,6 +20186,7 @@ module Aws::S3
20044
20186
  # resp.copy_part_result.last_modified #=> Time
20045
20187
  # resp.copy_part_result.checksum_crc32 #=> String
20046
20188
  # resp.copy_part_result.checksum_crc32c #=> String
20189
+ # resp.copy_part_result.checksum_crc64nvme #=> String
20047
20190
  # resp.copy_part_result.checksum_sha1 #=> String
20048
20191
  # resp.copy_part_result.checksum_sha256 #=> String
20049
20192
  # resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
@@ -20208,7 +20351,7 @@ module Aws::S3
20208
20351
  # @option params [String] :checksum_crc32
20209
20352
  # This header can be used as a data integrity check to verify that the
20210
20353
  # data received is the same data that was originally sent. This
20211
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object
20354
+ # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object
20212
20355
  # returned by the Object Lambda function. This may not match the
20213
20356
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20214
20357
  # validation of the checksum values only when the original `GetObject`
@@ -20228,7 +20371,7 @@ module Aws::S3
20228
20371
  # @option params [String] :checksum_crc32c
20229
20372
  # This header can be used as a data integrity check to verify that the
20230
20373
  # data received is the same data that was originally sent. This
20231
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object
20374
+ # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object
20232
20375
  # returned by the Object Lambda function. This may not match the
20233
20376
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20234
20377
  # validation of the checksum values only when the original `GetObject`
@@ -20243,10 +20386,21 @@ module Aws::S3
20243
20386
  #
20244
20387
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
20245
20388
  #
20389
+ # @option params [String] :checksum_crc64nvme
20390
+ # This header can be used as a data integrity check to verify that the
20391
+ # data received is the same data that was originally sent. This header
20392
+ # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
20393
+ # part. For more information, see [Checking object integrity][1] in the
20394
+ # *Amazon S3 User Guide*.
20395
+ #
20396
+ #
20397
+ #
20398
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
20399
+ #
20246
20400
  # @option params [String] :checksum_sha1
20247
20401
  # This header can be used as a data integrity check to verify that the
20248
20402
  # data received is the same data that was originally sent. This
20249
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object
20403
+ # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object
20250
20404
  # returned by the Object Lambda function. This may not match the
20251
20405
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20252
20406
  # validation of the checksum values only when the original `GetObject`
@@ -20264,7 +20418,7 @@ module Aws::S3
20264
20418
  # @option params [String] :checksum_sha256
20265
20419
  # This header can be used as a data integrity check to verify that the
20266
20420
  # data received is the same data that was originally sent. This
20267
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object
20421
+ # specifies the Base64 encoded, 256-bit `SHA-256` digest of the object
20268
20422
  # returned by the Object Lambda function. This may not match the
20269
20423
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20270
20424
  # validation of the checksum values only when the original `GetObject`
@@ -20281,7 +20435,12 @@ module Aws::S3
20281
20435
  #
20282
20436
  # @option params [Boolean] :delete_marker
20283
20437
  # Specifies whether an object stored in Amazon S3 is (`true`) or is not
20284
- # (`false`) a delete marker.
20438
+ # (`false`) a delete marker. To learn more about delete markers, see
20439
+ # [Working with delete markers][1].
20440
+ #
20441
+ #
20442
+ #
20443
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
20285
20444
  #
20286
20445
  # @option params [String] :etag
20287
20446
  # An opaque identifier assigned by a web server to a specific version of
@@ -20416,6 +20575,7 @@ module Aws::S3
20416
20575
  # content_type: "ContentType",
20417
20576
  # checksum_crc32: "ChecksumCRC32",
20418
20577
  # checksum_crc32c: "ChecksumCRC32C",
20578
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
20419
20579
  # checksum_sha1: "ChecksumSHA1",
20420
20580
  # checksum_sha256: "ChecksumSHA256",
20421
20581
  # delete_marker: false,
@@ -20471,7 +20631,7 @@ module Aws::S3
20471
20631
  tracer: tracer
20472
20632
  )
20473
20633
  context[:gem_name] = 'aws-sdk-s3'
20474
- context[:gem_version] = '1.176.1'
20634
+ context[:gem_version] = '1.180.0'
20475
20635
  Seahorse::Client::Request.new(handlers, context)
20476
20636
  end
20477
20637