aws-sdk-s3 1.176.1 → 1.182.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +32 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +40 -29
  5. data/lib/aws-sdk-s3/bucket_acl.rb +6 -5
  6. data/lib/aws-sdk-s3/bucket_cors.rb +6 -5
  7. data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
  8. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
  9. data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
  10. data/lib/aws-sdk-s3/bucket_policy.rb +6 -5
  11. data/lib/aws-sdk-s3/bucket_request_payment.rb +3 -3
  12. data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
  13. data/lib/aws-sdk-s3/bucket_versioning.rb +9 -9
  14. data/lib/aws-sdk-s3/bucket_website.rb +3 -3
  15. data/lib/aws-sdk-s3/client.rb +764 -602
  16. data/lib/aws-sdk-s3/client_api.rb +35 -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 +46 -4
  21. data/lib/aws-sdk-s3/multipart_upload_part.rb +50 -34
  22. data/lib/aws-sdk-s3/object.rb +139 -100
  23. data/lib/aws-sdk-s3/object_acl.rb +4 -4
  24. data/lib/aws-sdk-s3/object_summary.rb +87 -70
  25. data/lib/aws-sdk-s3/object_version.rb +18 -14
  26. data/lib/aws-sdk-s3/plugins/checksum_algorithm.rb +31 -0
  27. data/lib/aws-sdk-s3/plugins/express_session_auth.rb +11 -20
  28. data/lib/aws-sdk-s3/plugins/md5s.rb +10 -71
  29. data/lib/aws-sdk-s3/presigner.rb +4 -5
  30. data/lib/aws-sdk-s3/resource.rb +1 -1
  31. data/lib/aws-sdk-s3/types.rb +962 -610
  32. data/lib/aws-sdk-s3.rb +1 -1
  33. data/sig/bucket.rbs +4 -3
  34. data/sig/bucket_acl.rbs +1 -1
  35. data/sig/bucket_cors.rbs +1 -1
  36. data/sig/bucket_lifecycle.rbs +1 -1
  37. data/sig/bucket_lifecycle_configuration.rbs +1 -1
  38. data/sig/bucket_logging.rbs +1 -1
  39. data/sig/bucket_policy.rbs +1 -1
  40. data/sig/bucket_request_payment.rbs +1 -1
  41. data/sig/bucket_tagging.rbs +1 -1
  42. data/sig/bucket_versioning.rbs +3 -3
  43. data/sig/bucket_website.rbs +1 -1
  44. data/sig/client.rbs +53 -31
  45. data/sig/multipart_upload.rbs +8 -1
  46. data/sig/multipart_upload_part.rbs +5 -1
  47. data/sig/object.rbs +16 -5
  48. data/sig/object_acl.rbs +1 -1
  49. data/sig/object_summary.rbs +11 -6
  50. data/sig/object_version.rbs +5 -2
  51. data/sig/resource.rbs +3 -1
  52. data/sig/types.rbs +64 -34
  53. metadata +5 -5
  54. data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +0 -31
@@ -7,55 +7,55 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/invocation_id.rb'
26
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
28
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
29
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
30
- require 'aws-sdk-core/plugins/http_checksum.rb'
31
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
- require 'aws-sdk-core/plugins/request_compression.rb'
33
- require 'aws-sdk-core/plugins/defaults_mode.rb'
34
- require 'aws-sdk-core/plugins/recursion_detection.rb'
35
- require 'aws-sdk-core/plugins/telemetry.rb'
36
- require 'aws-sdk-core/plugins/sign.rb'
37
- require 'aws-sdk-core/plugins/protocols/rest_xml.rb'
38
- require 'aws-sdk-s3/plugins/accelerate.rb'
39
- require 'aws-sdk-s3/plugins/access_grants.rb'
40
- require 'aws-sdk-s3/plugins/arn.rb'
41
- require 'aws-sdk-s3/plugins/bucket_dns.rb'
42
- require 'aws-sdk-s3/plugins/bucket_name_restrictions.rb'
43
- require 'aws-sdk-s3/plugins/dualstack.rb'
44
- require 'aws-sdk-s3/plugins/expect_100_continue.rb'
45
- require 'aws-sdk-s3/plugins/express_session_auth.rb'
46
- require 'aws-sdk-s3/plugins/get_bucket_location_fix.rb'
47
- require 'aws-sdk-s3/plugins/http_200_errors.rb'
48
- require 'aws-sdk-s3/plugins/iad_regional_endpoint.rb'
49
- require 'aws-sdk-s3/plugins/location_constraint.rb'
50
- require 'aws-sdk-s3/plugins/md5s.rb'
51
- require 'aws-sdk-s3/plugins/redirects.rb'
52
- require 'aws-sdk-s3/plugins/s3_host_id.rb'
53
- require 'aws-sdk-s3/plugins/s3_signer.rb'
54
- require 'aws-sdk-s3/plugins/sse_cpk.rb'
55
- require 'aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb'
56
- require 'aws-sdk-s3/plugins/streaming_retry.rb'
57
- require 'aws-sdk-s3/plugins/url_encoded_keys.rb'
58
- require 'aws-sdk-core/plugins/event_stream_configuration.rb'
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/rest_xml'
38
+ require 'aws-sdk-s3/plugins/accelerate'
39
+ require 'aws-sdk-s3/plugins/access_grants'
40
+ require 'aws-sdk-s3/plugins/arn'
41
+ require 'aws-sdk-s3/plugins/bucket_dns'
42
+ require 'aws-sdk-s3/plugins/bucket_name_restrictions'
43
+ require 'aws-sdk-s3/plugins/checksum_algorithm'
44
+ require 'aws-sdk-s3/plugins/dualstack'
45
+ require 'aws-sdk-s3/plugins/expect_100_continue'
46
+ require 'aws-sdk-s3/plugins/express_session_auth'
47
+ require 'aws-sdk-s3/plugins/get_bucket_location_fix'
48
+ require 'aws-sdk-s3/plugins/http_200_errors'
49
+ require 'aws-sdk-s3/plugins/iad_regional_endpoint'
50
+ require 'aws-sdk-s3/plugins/location_constraint'
51
+ require 'aws-sdk-s3/plugins/md5s'
52
+ require 'aws-sdk-s3/plugins/redirects'
53
+ require 'aws-sdk-s3/plugins/s3_host_id'
54
+ require 'aws-sdk-s3/plugins/s3_signer'
55
+ require 'aws-sdk-s3/plugins/sse_cpk'
56
+ require 'aws-sdk-s3/plugins/streaming_retry'
57
+ require 'aws-sdk-s3/plugins/url_encoded_keys'
58
+ require 'aws-sdk-core/plugins/event_stream_configuration'
59
59
 
60
60
  module Aws::S3
61
61
  # An API client for S3. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -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 `CRC32` 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 `CRC32C` 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,10 +1008,22 @@ 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 `CRC64NVME` checksum of the
1015
+ # object. The `CRC64NVME` checksum is always a full object checksum. For
1016
+ # more information, see [Checking object integrity in the Amazon S3 User
1017
+ # 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
1026
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
995
1027
  # more information, see [Checking object integrity][1] in the *Amazon S3
996
1028
  # User Guide*.
997
1029
  #
@@ -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 `SHA256` 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
@@ -2534,33 +2601,33 @@ module Aws::S3
2534
2601
  # * {Types::CreateBucketOutput#location #location} => String
2535
2602
  #
2536
2603
  #
2537
- # @example Example: To create a bucket in a specific region
2604
+ # @example Example: To create a bucket
2538
2605
  #
2539
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2606
+ # # The following example creates a bucket.
2540
2607
  #
2541
2608
  # resp = client.create_bucket({
2542
2609
  # bucket: "examplebucket",
2543
- # create_bucket_configuration: {
2544
- # location_constraint: "eu-west-1",
2545
- # },
2546
2610
  # })
2547
2611
  #
2548
2612
  # resp.to_h outputs the following:
2549
2613
  # {
2550
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2614
+ # location: "/examplebucket",
2551
2615
  # }
2552
2616
  #
2553
- # @example Example: To create a bucket
2617
+ # @example Example: To create a bucket in a specific region
2554
2618
  #
2555
- # # The following example creates a bucket.
2619
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
2556
2620
  #
2557
2621
  # resp = client.create_bucket({
2558
2622
  # bucket: "examplebucket",
2623
+ # create_bucket_configuration: {
2624
+ # location_constraint: "eu-west-1",
2625
+ # },
2559
2626
  # })
2560
2627
  #
2561
2628
  # resp.to_h outputs the following:
2562
2629
  # {
2563
- # location: "/examplebucket",
2630
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
2564
2631
  # }
2565
2632
  #
2566
2633
  # @example Request syntax with placeholder values
@@ -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
  #
@@ -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
  #
@@ -5681,6 +5758,8 @@ module Aws::S3
5681
5758
  #
5682
5759
  # * `CRC32C`
5683
5760
  #
5761
+ # * `CRC64NVME`
5762
+ #
5684
5763
  # * `SHA1`
5685
5764
  #
5686
5765
  # * `SHA256`
@@ -5690,9 +5769,8 @@ module Aws::S3
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
@@ -8668,49 +8739,49 @@ module Aws::S3
8668
8739
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
8669
8740
  #
8670
8741
  #
8671
- # @example Example: To retrieve a byte range of an object
8742
+ # @example Example: To retrieve an object
8672
8743
  #
8673
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8674
- # # specific byte range.
8744
+ # # The following example retrieves an object for an S3 bucket.
8675
8745
  #
8676
8746
  # resp = client.get_object({
8677
8747
  # bucket: "examplebucket",
8678
- # key: "SampleFile.txt",
8679
- # range: "bytes=0-9",
8748
+ # key: "HappyFace.jpg",
8680
8749
  # })
8681
8750
  #
8682
8751
  # resp.to_h outputs the following:
8683
8752
  # {
8684
8753
  # accept_ranges: "bytes",
8685
- # content_length: 10,
8686
- # content_range: "bytes 0-9/43",
8687
- # content_type: "text/plain",
8688
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8689
- # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8754
+ # content_length: 3191,
8755
+ # content_type: "image/jpeg",
8756
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8757
+ # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8690
8758
  # metadata: {
8691
8759
  # },
8760
+ # tag_count: 2,
8692
8761
  # version_id: "null",
8693
8762
  # }
8694
8763
  #
8695
- # @example Example: To retrieve an object
8764
+ # @example Example: To retrieve a byte range of an object
8696
8765
  #
8697
- # # The following example retrieves an object for an S3 bucket.
8766
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
8767
+ # # specific byte range.
8698
8768
  #
8699
8769
  # resp = client.get_object({
8700
8770
  # bucket: "examplebucket",
8701
- # key: "HappyFace.jpg",
8771
+ # key: "SampleFile.txt",
8772
+ # range: "bytes=0-9",
8702
8773
  # })
8703
8774
  #
8704
8775
  # resp.to_h outputs the following:
8705
8776
  # {
8706
8777
  # accept_ranges: "bytes",
8707
- # content_length: 3191,
8708
- # content_type: "image/jpeg",
8709
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8710
- # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
8778
+ # content_length: 10,
8779
+ # content_range: "bytes 0-9/43",
8780
+ # content_type: "text/plain",
8781
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
8782
+ # last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
8711
8783
  # metadata: {
8712
8784
  # },
8713
- # tag_count: 2,
8714
8785
  # version_id: "null",
8715
8786
  # }
8716
8787
  #
@@ -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
  #
@@ -9728,49 +9804,49 @@ module Aws::S3
9728
9804
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
9729
9805
  #
9730
9806
  #
9731
- # @example Example: To retrieve tag set of an object
9807
+ # @example Example: To retrieve tag set of a specific object version
9732
9808
  #
9733
- # # The following example retrieves tag set of an object.
9809
+ # # The following example retrieves tag set of an object. The request specifies object version.
9734
9810
  #
9735
9811
  # resp = client.get_object_tagging({
9736
9812
  # bucket: "examplebucket",
9737
- # key: "HappyFace.jpg",
9813
+ # key: "exampleobject",
9814
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9738
9815
  # })
9739
9816
  #
9740
9817
  # resp.to_h outputs the following:
9741
9818
  # {
9742
9819
  # tag_set: [
9743
9820
  # {
9744
- # key: "Key4",
9745
- # value: "Value4",
9746
- # },
9747
- # {
9748
- # key: "Key3",
9749
- # value: "Value3",
9821
+ # key: "Key1",
9822
+ # value: "Value1",
9750
9823
  # },
9751
9824
  # ],
9752
- # version_id: "null",
9825
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9753
9826
  # }
9754
9827
  #
9755
- # @example Example: To retrieve tag set of a specific object version
9828
+ # @example Example: To retrieve tag set of an object
9756
9829
  #
9757
- # # The following example retrieves tag set of an object. The request specifies object version.
9830
+ # # The following example retrieves tag set of an object.
9758
9831
  #
9759
9832
  # resp = client.get_object_tagging({
9760
9833
  # bucket: "examplebucket",
9761
- # key: "exampleobject",
9762
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9834
+ # key: "HappyFace.jpg",
9763
9835
  # })
9764
9836
  #
9765
9837
  # resp.to_h outputs the following:
9766
9838
  # {
9767
9839
  # tag_set: [
9768
9840
  # {
9769
- # key: "Key1",
9770
- # value: "Value1",
9841
+ # key: "Key4",
9842
+ # value: "Value4",
9843
+ # },
9844
+ # {
9845
+ # key: "Key3",
9846
+ # value: "Value3",
9771
9847
  # },
9772
9848
  # ],
9773
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9849
+ # version_id: "null",
9774
9850
  # }
9775
9851
  #
9776
9852
  # @example Request syntax with placeholder values
@@ -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
@@ -10564,6 +10642,7 @@ module Aws::S3
10564
10642
  # * {Types::HeadObjectOutput#content_encoding #content_encoding} => String
10565
10643
  # * {Types::HeadObjectOutput#content_language #content_language} => String
10566
10644
  # * {Types::HeadObjectOutput#content_type #content_type} => String
10645
+ # * {Types::HeadObjectOutput#content_range #content_range} => String
10567
10646
  # * {Types::HeadObjectOutput#expires #expires} => Time
10568
10647
  # * {Types::HeadObjectOutput#expires_string #expires_string} => String
10569
10648
  # * {Types::HeadObjectOutput#website_redirect_location #website_redirect_location} => String
@@ -10640,8 +10719,10 @@ module Aws::S3
10640
10719
  # resp.content_length #=> Integer
10641
10720
  # resp.checksum_crc32 #=> String
10642
10721
  # resp.checksum_crc32c #=> String
10722
+ # resp.checksum_crc64nvme #=> String
10643
10723
  # resp.checksum_sha1 #=> String
10644
10724
  # resp.checksum_sha256 #=> String
10725
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
10645
10726
  # resp.etag #=> String
10646
10727
  # resp.missing_meta #=> Integer
10647
10728
  # resp.version_id #=> String
@@ -10650,6 +10731,7 @@ module Aws::S3
10650
10731
  # resp.content_encoding #=> String
10651
10732
  # resp.content_language #=> String
10652
10733
  # resp.content_type #=> String
10734
+ # resp.content_range #=> String
10653
10735
  # resp.expires #=> Time
10654
10736
  # resp.expires_string #=> String
10655
10737
  # resp.website_redirect_location #=> String
@@ -11231,7 +11313,7 @@ module Aws::S3
11231
11313
  # about endpoints in Availability Zones, see [Regional and Zonal
11232
11314
  # endpoints for directory buckets in Availability Zones][2] in the
11233
11315
  # *Amazon S3 User Guide*. For more information about endpoints in Local
11234
- # Zones, see [Available Local Zone for directory buckets][3] in the
11316
+ # Zones, see [Concepts for directory buckets in Local Zones][3] in the
11235
11317
  # *Amazon S3 User Guide*.
11236
11318
  #
11237
11319
  # </note>
@@ -11260,7 +11342,7 @@ module Aws::S3
11260
11342
  #
11261
11343
  #
11262
11344
  # [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
11345
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
11264
11346
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11265
11347
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
11266
11348
  #
@@ -11350,13 +11432,13 @@ module Aws::S3
11350
11432
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
11351
11433
  # for this API operation to the Zonal endpoint. These endpoints support
11352
11434
  # virtual-hosted-style requests in the format
11353
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
11435
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
11354
11436
  # `. Path-style requests are not supported. For more information about
11355
11437
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
11356
11438
  # directory buckets in Availability Zones][2] in the *Amazon S3 User
11357
11439
  # 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*.
11440
+ # [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
11441
+ # User Guide*.
11360
11442
  #
11361
11443
  # </note>
11362
11444
  #
@@ -11417,7 +11499,7 @@ module Aws::S3
11417
11499
  #
11418
11500
  #
11419
11501
  # [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
11502
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
11421
11503
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
11422
11504
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11423
11505
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -11436,7 +11518,7 @@ module Aws::S3
11436
11518
  # requests are not supported. Directory bucket names must be unique in
11437
11519
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11438
11520
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11439
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11521
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11440
11522
  # naming restrictions, see [Directory bucket naming rules][1] in the
11441
11523
  # *Amazon S3 User Guide*.
11442
11524
  #
@@ -11456,14 +11538,14 @@ module Aws::S3
11456
11538
  #
11457
11539
  # </note>
11458
11540
  #
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 `
11541
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
11542
+ # must direct requests to the S3 on Outposts hostname. The S3 on
11543
+ # Outposts hostname takes the form `
11462
11544
  # 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*.
11545
+ # When you use this action with S3 on Outposts, the destination bucket
11546
+ # must be the Outposts access point ARN or the access point alias. For
11547
+ # more information about S3 on Outposts, see [What is S3 on
11548
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11467
11549
  #
11468
11550
  #
11469
11551
  #
@@ -11735,7 +11817,8 @@ module Aws::S3
11735
11817
  # resp.uploads[0].owner.id #=> String
11736
11818
  # resp.uploads[0].initiator.id #=> String
11737
11819
  # resp.uploads[0].initiator.display_name #=> String
11738
- # resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
11820
+ # resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
11821
+ # resp.uploads[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
11739
11822
  # resp.common_prefixes #=> Array
11740
11823
  # resp.common_prefixes[0].prefix #=> String
11741
11824
  # resp.encoding_type #=> String, one of "url"
@@ -11953,7 +12036,8 @@ module Aws::S3
11953
12036
  # resp.versions #=> Array
11954
12037
  # resp.versions[0].etag #=> String
11955
12038
  # resp.versions[0].checksum_algorithm #=> Array
11956
- # resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12039
+ # resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12040
+ # resp.versions[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
11957
12041
  # resp.versions[0].size #=> Integer
11958
12042
  # resp.versions[0].storage_class #=> String, one of "STANDARD"
11959
12043
  # resp.versions[0].key #=> String
@@ -12032,7 +12116,7 @@ module Aws::S3
12032
12116
  # requests are not supported. Directory bucket names must be unique in
12033
12117
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12034
12118
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12035
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12119
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12036
12120
  # naming restrictions, see [Directory bucket naming rules][1] in the
12037
12121
  # *Amazon S3 User Guide*.
12038
12122
  #
@@ -12052,14 +12136,14 @@ module Aws::S3
12052
12136
  #
12053
12137
  # </note>
12054
12138
  #
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 `
12139
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12140
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12141
+ # Outposts hostname takes the form `
12058
12142
  # 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*.
12143
+ # When you use this action with S3 on Outposts, the destination bucket
12144
+ # must be the Outposts access point ARN or the access point alias. For
12145
+ # more information about S3 on Outposts, see [What is S3 on
12146
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12063
12147
  #
12064
12148
  #
12065
12149
  #
@@ -12198,7 +12282,8 @@ module Aws::S3
12198
12282
  # resp.contents[0].last_modified #=> Time
12199
12283
  # resp.contents[0].etag #=> String
12200
12284
  # resp.contents[0].checksum_algorithm #=> Array
12201
- # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12285
+ # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12286
+ # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12202
12287
  # resp.contents[0].size #=> Integer
12203
12288
  # 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
12289
  # resp.contents[0].owner.display_name #=> String
@@ -12243,13 +12328,13 @@ module Aws::S3
12243
12328
  # * **Directory buckets** - For directory buckets, you must make
12244
12329
  # requests for this API operation to the Zonal endpoint. These
12245
12330
  # endpoints support virtual-hosted-style requests in the format
12246
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12331
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
12247
12332
  # `. Path-style requests are not supported. For more information about
12248
12333
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
12249
12334
  # for directory buckets in Availability Zones][3] in the *Amazon S3
12250
12335
  # 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*.
12336
+ # see [Concepts for directory buckets in Local Zones][4] in the
12337
+ # *Amazon S3 User Guide*.
12253
12338
  #
12254
12339
  # </note>
12255
12340
  #
@@ -12307,7 +12392,7 @@ module Aws::S3
12307
12392
  #
12308
12393
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
12309
12394
  # [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
12395
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
12311
12396
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12312
12397
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12313
12398
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
@@ -12324,7 +12409,7 @@ module Aws::S3
12324
12409
  # requests are not supported. Directory bucket names must be unique in
12325
12410
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12326
12411
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12327
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12412
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12328
12413
  # naming restrictions, see [Directory bucket naming rules][1] in the
12329
12414
  # *Amazon S3 User Guide*.
12330
12415
  #
@@ -12344,14 +12429,14 @@ module Aws::S3
12344
12429
  #
12345
12430
  # </note>
12346
12431
  #
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 `
12432
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12433
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12434
+ # Outposts hostname takes the form `
12350
12435
  # 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*.
12436
+ # When you use this action with S3 on Outposts, the destination bucket
12437
+ # must be the Outposts access point ARN or the access point alias. For
12438
+ # more information about S3 on Outposts, see [What is S3 on
12439
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12355
12440
  #
12356
12441
  #
12357
12442
  #
@@ -12539,7 +12624,8 @@ module Aws::S3
12539
12624
  # resp.contents[0].last_modified #=> Time
12540
12625
  # resp.contents[0].etag #=> String
12541
12626
  # resp.contents[0].checksum_algorithm #=> Array
12542
- # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12627
+ # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12628
+ # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12543
12629
  # resp.contents[0].size #=> Integer
12544
12630
  # 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
12631
  # resp.contents[0].owner.display_name #=> String
@@ -12591,13 +12677,13 @@ module Aws::S3
12591
12677
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
12592
12678
  # for this API operation to the Zonal endpoint. These endpoints support
12593
12679
  # virtual-hosted-style requests in the format
12594
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
12680
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
12595
12681
  # `. Path-style requests are not supported. For more information about
12596
12682
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
12597
12683
  # directory buckets in Availability Zones][3] in the *Amazon S3 User
12598
12684
  # 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*.
12685
+ # [Concepts for directory buckets in Local Zones][4] in the *Amazon S3
12686
+ # User Guide*.
12601
12687
  #
12602
12688
  # </note>
12603
12689
  #
@@ -12651,7 +12737,7 @@ module Aws::S3
12651
12737
  #
12652
12738
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
12653
12739
  # [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
12740
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
12655
12741
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
12656
12742
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12657
12743
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
@@ -12670,7 +12756,7 @@ module Aws::S3
12670
12756
  # requests are not supported. Directory bucket names must be unique in
12671
12757
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
12672
12758
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
12673
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
12759
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
12674
12760
  # naming restrictions, see [Directory bucket naming rules][1] in the
12675
12761
  # *Amazon S3 User Guide*.
12676
12762
  #
@@ -12690,14 +12776,14 @@ module Aws::S3
12690
12776
  #
12691
12777
  # </note>
12692
12778
  #
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 `
12779
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
12780
+ # must direct requests to the S3 on Outposts hostname. The S3 on
12781
+ # Outposts hostname takes the form `
12696
12782
  # 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*.
12783
+ # When you use this action with S3 on Outposts, the destination bucket
12784
+ # must be the Outposts access point ARN or the access point alias. For
12785
+ # more information about S3 on Outposts, see [What is S3 on
12786
+ # Outposts?][3] in the *Amazon S3 User Guide*.
12701
12787
  #
12702
12788
  #
12703
12789
  #
@@ -12800,6 +12886,7 @@ module Aws::S3
12800
12886
  # * {Types::ListPartsOutput#storage_class #storage_class} => String
12801
12887
  # * {Types::ListPartsOutput#request_charged #request_charged} => String
12802
12888
  # * {Types::ListPartsOutput#checksum_algorithm #checksum_algorithm} => String
12889
+ # * {Types::ListPartsOutput#checksum_type #checksum_type} => String
12803
12890
  #
12804
12891
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
12805
12892
  #
@@ -12874,6 +12961,7 @@ module Aws::S3
12874
12961
  # resp.parts[0].size #=> Integer
12875
12962
  # resp.parts[0].checksum_crc32 #=> String
12876
12963
  # resp.parts[0].checksum_crc32c #=> String
12964
+ # resp.parts[0].checksum_crc64nvme #=> String
12877
12965
  # resp.parts[0].checksum_sha1 #=> String
12878
12966
  # resp.parts[0].checksum_sha256 #=> String
12879
12967
  # resp.initiator.id #=> String
@@ -12882,7 +12970,8 @@ module Aws::S3
12882
12970
  # resp.owner.id #=> String
12883
12971
  # 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
12972
  # resp.request_charged #=> String, one of "requester"
12885
- # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
12973
+ # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12974
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12886
12975
  #
12887
12976
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts AWS API Documentation
12888
12977
  #
@@ -12955,7 +13044,7 @@ module Aws::S3
12955
13044
  # fails with the HTTP status code `403 Forbidden` (access denied).
12956
13045
  #
12957
13046
  # @option params [String] :checksum_algorithm
12958
- # Indicates the algorithm used to create the checksum for the object
13047
+ # Indicates the algorithm used to create the checksum for the request
12959
13048
  # when you use the SDK. This header will not provide any additional
12960
13049
  # functionality if you don't use the SDK. When you send this header,
12961
13050
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -12980,7 +13069,7 @@ module Aws::S3
12980
13069
  # status: "Enabled", # accepts Enabled, Suspended
12981
13070
  # },
12982
13071
  # expected_bucket_owner: "AccountId",
12983
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13072
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
12984
13073
  # })
12985
13074
  #
12986
13075
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration AWS API Documentation
@@ -13176,9 +13265,10 @@ module Aws::S3
13176
13265
  # The bucket to which to apply the ACL.
13177
13266
  #
13178
13267
  # @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]
13268
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
13269
+ # be used as a message integrity check to verify that the request body
13270
+ # was not corrupted in transit. For more information, go to [RFC
13271
+ # 1864.][1]
13182
13272
  #
13183
13273
  # For requests made using the Amazon Web Services Command Line Interface
13184
13274
  # (CLI) or Amazon Web Services SDKs, this field is calculated
@@ -13189,7 +13279,7 @@ module Aws::S3
13189
13279
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
13190
13280
  #
13191
13281
  # @option params [String] :checksum_algorithm
13192
- # Indicates the algorithm used to create the checksum for the object
13282
+ # Indicates the algorithm used to create the checksum for the request
13193
13283
  # when you use the SDK. This header will not provide any additional
13194
13284
  # functionality if you don't use the SDK. When you send this header,
13195
13285
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13267,7 +13357,7 @@ module Aws::S3
13267
13357
  # },
13268
13358
  # bucket: "BucketName", # required
13269
13359
  # content_md5: "ContentMD5",
13270
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13360
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13271
13361
  # grant_full_control: "GrantFullControl",
13272
13362
  # grant_read: "GrantRead",
13273
13363
  # grant_read_acp: "GrantReadACP",
@@ -13491,9 +13581,10 @@ module Aws::S3
13491
13581
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
13492
13582
  #
13493
13583
  # @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]
13584
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
13585
+ # be used as a message integrity check to verify that the request body
13586
+ # was not corrupted in transit. For more information, go to [RFC
13587
+ # 1864.][1]
13497
13588
  #
13498
13589
  # For requests made using the Amazon Web Services Command Line Interface
13499
13590
  # (CLI) or Amazon Web Services SDKs, this field is calculated
@@ -13504,7 +13595,7 @@ module Aws::S3
13504
13595
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
13505
13596
  #
13506
13597
  # @option params [String] :checksum_algorithm
13507
- # Indicates the algorithm used to create the checksum for the object
13598
+ # Indicates the algorithm used to create the checksum for the request
13508
13599
  # when you use the SDK. This header will not provide any additional
13509
13600
  # functionality if you don't use the SDK. When you send this header,
13510
13601
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13587,7 +13678,7 @@ module Aws::S3
13587
13678
  # ],
13588
13679
  # },
13589
13680
  # content_md5: "ContentMD5",
13590
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13681
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13591
13682
  # expected_bucket_owner: "AccountId",
13592
13683
  # })
13593
13684
  #
@@ -13611,7 +13702,7 @@ module Aws::S3
13611
13702
  # about endpoints in Availability Zones, see [Regional and Zonal
13612
13703
  # endpoints for directory buckets in Availability Zones][1] in the
13613
13704
  # *Amazon S3 User Guide*. For more information about endpoints in Local
13614
- # Zones, see [Available Local Zone for directory buckets][2] in the
13705
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
13615
13706
  # *Amazon S3 User Guide*.
13616
13707
  #
13617
13708
  # </note>
@@ -13648,8 +13739,8 @@ module Aws::S3
13648
13739
  # object uploads][5].
13649
13740
  #
13650
13741
  # * 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.
13742
+ # key][6] per directory bucket's lifetime. The [Amazon Web Services
13743
+ # managed key][7] (`aws/s3`) isn't supported.
13653
13744
  #
13654
13745
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
13655
13746
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
@@ -13719,7 +13810,7 @@ module Aws::S3
13719
13810
  #
13720
13811
  #
13721
13812
  #
13722
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
13813
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
13723
13814
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
13724
13815
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
13725
13816
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
@@ -13757,7 +13848,7 @@ module Aws::S3
13757
13848
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
13758
13849
  #
13759
13850
  # @option params [String] :content_md5
13760
- # The base64-encoded 128-bit MD5 digest of the server-side encryption
13851
+ # The Base64 encoded 128-bit `MD5` digest of the server-side encryption
13761
13852
  # configuration.
13762
13853
  #
13763
13854
  # For requests made using the Amazon Web Services Command Line Interface
@@ -13769,7 +13860,7 @@ module Aws::S3
13769
13860
  # </note>
13770
13861
  #
13771
13862
  # @option params [String] :checksum_algorithm
13772
- # Indicates the algorithm used to create the checksum for the object
13863
+ # Indicates the algorithm used to create the checksum for the request
13773
13864
  # when you use the SDK. This header will not provide any additional
13774
13865
  # functionality if you don't use the SDK. When you send this header,
13775
13866
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13810,7 +13901,7 @@ module Aws::S3
13810
13901
  # resp = client.put_bucket_encryption({
13811
13902
  # bucket: "BucketName", # required
13812
13903
  # content_md5: "ContentMD5",
13813
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
13904
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13814
13905
  # server_side_encryption_configuration: { # required
13815
13906
  # rules: [ # required
13816
13907
  # {
@@ -14111,6 +14202,10 @@ module Aws::S3
14111
14202
  req.send_request(options)
14112
14203
  end
14113
14204
 
14205
+ # <note markdown="1"> This operation is not supported for directory buckets.
14206
+ #
14207
+ # </note>
14208
+ #
14114
14209
  # For an updated version of this API, see
14115
14210
  # [PutBucketLifecycleConfiguration][1]. This version has been
14116
14211
  # deprecated. Existing lifecycle configurations will work. For new
@@ -14189,7 +14284,7 @@ module Aws::S3
14189
14284
  # automatically.
14190
14285
  #
14191
14286
  # @option params [String] :checksum_algorithm
14192
- # Indicates the algorithm used to create the checksum for the object
14287
+ # Indicates the algorithm used to create the checksum for the request
14193
14288
  # when you use the SDK. This header will not provide any additional
14194
14289
  # functionality if you don't use the SDK. When you send this header,
14195
14290
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14218,7 +14313,7 @@ module Aws::S3
14218
14313
  # resp = client.put_bucket_lifecycle({
14219
14314
  # bucket: "BucketName", # required
14220
14315
  # content_md5: "ContentMD5",
14221
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14316
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14222
14317
  # lifecycle_configuration: {
14223
14318
  # rules: [ # required
14224
14319
  # {
@@ -14364,8 +14459,8 @@ module Aws::S3
14364
14459
  # information about endpoints in Availability Zones, see [Regional
14365
14460
  # and Zonal endpoints for directory buckets in Availability
14366
14461
  # 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*.
14462
+ # about endpoints in Local Zones, see [Concepts for directory
14463
+ # buckets in Local Zones][8] in the *Amazon S3 User Guide*.
14369
14464
  #
14370
14465
  # </note>
14371
14466
  #
@@ -14387,7 +14482,7 @@ module Aws::S3
14387
14482
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
14388
14483
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14389
14484
  # [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
14485
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
14391
14486
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14392
14487
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
14393
14488
  # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
@@ -14396,7 +14491,7 @@ module Aws::S3
14396
14491
  # The name of the bucket for which to set the configuration.
14397
14492
  #
14398
14493
  # @option params [String] :checksum_algorithm
14399
- # Indicates the algorithm used to create the checksum for the object
14494
+ # Indicates the algorithm used to create the checksum for the request
14400
14495
  # when you use the SDK. This header will not provide any additional
14401
14496
  # functionality if you don't use the SDK. When you send this header,
14402
14497
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14483,7 +14578,7 @@ module Aws::S3
14483
14578
  #
14484
14579
  # resp = client.put_bucket_lifecycle_configuration({
14485
14580
  # bucket: "BucketName", # required
14486
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14581
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14487
14582
  # lifecycle_configuration: {
14488
14583
  # rules: [ # required
14489
14584
  # {
@@ -14649,7 +14744,7 @@ module Aws::S3
14649
14744
  # automatically.
14650
14745
  #
14651
14746
  # @option params [String] :checksum_algorithm
14652
- # Indicates the algorithm used to create the checksum for the object
14747
+ # Indicates the algorithm used to create the checksum for the request
14653
14748
  # when you use the SDK. This header will not provide any additional
14654
14749
  # functionality if you don't use the SDK. When you send this header,
14655
14750
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14726,7 +14821,7 @@ module Aws::S3
14726
14821
  # },
14727
14822
  # },
14728
14823
  # content_md5: "ContentMD5",
14729
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14824
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14730
14825
  # expected_bucket_owner: "AccountId",
14731
14826
  # })
14732
14827
  #
@@ -14865,7 +14960,7 @@ module Aws::S3
14865
14960
  # automatically.
14866
14961
  #
14867
14962
  # @option params [String] :checksum_algorithm
14868
- # Indicates the algorithm used to create the checksum for the object
14963
+ # Indicates the algorithm used to create the checksum for the request
14869
14964
  # when you use the SDK. This header will not provide any additional
14870
14965
  # functionality if you don't use the SDK. When you send this header,
14871
14966
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14895,7 +14990,7 @@ module Aws::S3
14895
14990
  # resp = client.put_bucket_notification({
14896
14991
  # bucket: "BucketName", # required
14897
14992
  # content_md5: "ContentMD5",
14898
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
14993
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
14899
14994
  # notification_configuration: { # required
14900
14995
  # topic_configuration: {
14901
14996
  # id: "NotificationId",
@@ -15192,7 +15287,7 @@ module Aws::S3
15192
15287
  # about endpoints in Availability Zones, see [Regional and Zonal
15193
15288
  # endpoints for directory buckets in Availability Zones][1] in the
15194
15289
  # *Amazon S3 User Guide*. For more information about endpoints in Local
15195
- # Zones, see [Available Local Zone for directory buckets][2] in the
15290
+ # Zones, see [Concepts for directory buckets in Local Zones][2] in the
15196
15291
  # *Amazon S3 User Guide*.
15197
15292
  #
15198
15293
  # </note>
@@ -15256,7 +15351,7 @@ module Aws::S3
15256
15351
  #
15257
15352
  #
15258
15353
  #
15259
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
15354
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
15260
15355
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
15261
15356
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
15262
15357
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
@@ -15295,7 +15390,7 @@ module Aws::S3
15295
15390
  # </note>
15296
15391
  #
15297
15392
  # @option params [String] :checksum_algorithm
15298
- # Indicates the algorithm used to create the checksum for the object
15393
+ # Indicates the algorithm used to create the checksum for the request
15299
15394
  # when you use the SDK. This header will not provide any additional
15300
15395
  # functionality if you don't use the SDK. When you send this header,
15301
15396
  # there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -15309,6 +15404,8 @@ module Aws::S3
15309
15404
  #
15310
15405
  # * `CRC32C`
15311
15406
  #
15407
+ # * `CRC64NVME`
15408
+ #
15312
15409
  # * `SHA1`
15313
15410
  #
15314
15411
  # * `SHA256`
@@ -15318,9 +15415,8 @@ module Aws::S3
15318
15415
  #
15319
15416
  # If the individual checksum value you provide through
15320
15417
  # `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 `.
15418
+ # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
15419
+ # request with a `BadDigest` error.
15324
15420
  #
15325
15421
  # <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
15326
15422
  # is the default checksum algorithm that's used for performance.
@@ -15373,7 +15469,7 @@ module Aws::S3
15373
15469
  # resp = client.put_bucket_policy({
15374
15470
  # bucket: "BucketName", # required
15375
15471
  # content_md5: "ContentMD5",
15376
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15472
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15377
15473
  # confirm_remove_self_bucket_access: false,
15378
15474
  # policy: "Policy", # required
15379
15475
  # expected_bucket_owner: "AccountId",
@@ -15479,7 +15575,7 @@ module Aws::S3
15479
15575
  # The name of the bucket
15480
15576
  #
15481
15577
  # @option params [String] :content_md5
15482
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15578
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15483
15579
  # header as a message integrity check to verify that the request body
15484
15580
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15485
15581
  #
@@ -15492,7 +15588,7 @@ module Aws::S3
15492
15588
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15493
15589
  #
15494
15590
  # @option params [String] :checksum_algorithm
15495
- # Indicates the algorithm used to create the checksum for the object
15591
+ # Indicates the algorithm used to create the checksum for the request
15496
15592
  # when you use the SDK. This header will not provide any additional
15497
15593
  # functionality if you don't use the SDK. When you send this header,
15498
15594
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15548,7 +15644,7 @@ module Aws::S3
15548
15644
  # resp = client.put_bucket_replication({
15549
15645
  # bucket: "BucketName", # required
15550
15646
  # content_md5: "ContentMD5",
15551
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15647
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15552
15648
  # replication_configuration: { # required
15553
15649
  # role: "Role", # required
15554
15650
  # rules: [ # required
@@ -15652,7 +15748,7 @@ module Aws::S3
15652
15748
  # The bucket name.
15653
15749
  #
15654
15750
  # @option params [String] :content_md5
15655
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15751
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15656
15752
  # header as a message integrity check to verify that the request body
15657
15753
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15658
15754
  #
@@ -15665,7 +15761,7 @@ module Aws::S3
15665
15761
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15666
15762
  #
15667
15763
  # @option params [String] :checksum_algorithm
15668
- # Indicates the algorithm used to create the checksum for the object
15764
+ # Indicates the algorithm used to create the checksum for the request
15669
15765
  # when you use the SDK. This header will not provide any additional
15670
15766
  # functionality if you don't use the SDK. When you send this header,
15671
15767
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15707,7 +15803,7 @@ module Aws::S3
15707
15803
  # resp = client.put_bucket_request_payment({
15708
15804
  # bucket: "BucketName", # required
15709
15805
  # content_md5: "ContentMD5",
15710
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15806
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15711
15807
  # request_payment_configuration: { # required
15712
15808
  # payer: "Requester", # required, accepts Requester, BucketOwner
15713
15809
  # },
@@ -15789,7 +15885,7 @@ module Aws::S3
15789
15885
  # The bucket name.
15790
15886
  #
15791
15887
  # @option params [String] :content_md5
15792
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
15888
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
15793
15889
  # header as a message integrity check to verify that the request body
15794
15890
  # was not corrupted in transit. For more information, see [RFC 1864][1].
15795
15891
  #
@@ -15802,7 +15898,7 @@ module Aws::S3
15802
15898
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15803
15899
  #
15804
15900
  # @option params [String] :checksum_algorithm
15805
- # Indicates the algorithm used to create the checksum for the object
15901
+ # Indicates the algorithm used to create the checksum for the request
15806
15902
  # when you use the SDK. This header will not provide any additional
15807
15903
  # functionality if you don't use the SDK. When you send this header,
15808
15904
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15853,7 +15949,7 @@ module Aws::S3
15853
15949
  # resp = client.put_bucket_tagging({
15854
15950
  # bucket: "BucketName", # required
15855
15951
  # content_md5: "ContentMD5",
15856
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
15952
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
15857
15953
  # tagging: { # required
15858
15954
  # tag_set: [ # required
15859
15955
  # {
@@ -15880,10 +15976,10 @@ module Aws::S3
15880
15976
  #
15881
15977
  # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
15882
15978
  # 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
15979
+ # While this change is propagating, you might encounter intermittent
15980
+ # `HTTP 404 NoSuchKey` errors for requests to objects created or updated
15981
+ # after enabling versioning. We recommend that you wait for 15 minutes
15982
+ # after enabling versioning before issuing write operations (`PUT` or
15887
15983
  # `DELETE`) on objects in the bucket.
15888
15984
  #
15889
15985
  # </note>
@@ -15936,7 +16032,7 @@ module Aws::S3
15936
16032
  # The bucket name.
15937
16033
  #
15938
16034
  # @option params [String] :content_md5
15939
- # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
16035
+ # &gt;The Base64 encoded 128-bit `MD5` digest of the data. You must use
15940
16036
  # this header as a message integrity check to verify that the request
15941
16037
  # body was not corrupted in transit. For more information, see [RFC
15942
16038
  # 1864][1].
@@ -15950,7 +16046,7 @@ module Aws::S3
15950
16046
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
15951
16047
  #
15952
16048
  # @option params [String] :checksum_algorithm
15953
- # Indicates the algorithm used to create the checksum for the object
16049
+ # Indicates the algorithm used to create the checksum for the request
15954
16050
  # when you use the SDK. This header will not provide any additional
15955
16051
  # functionality if you don't use the SDK. When you send this header,
15956
16052
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15997,7 +16093,7 @@ module Aws::S3
15997
16093
  # resp = client.put_bucket_versioning({
15998
16094
  # bucket: "BucketName", # required
15999
16095
  # content_md5: "ContentMD5",
16000
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
16096
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
16001
16097
  # mfa: "MFA",
16002
16098
  # versioning_configuration: { # required
16003
16099
  # mfa_delete: "Enabled", # accepts Enabled, Disabled
@@ -16098,7 +16194,7 @@ module Aws::S3
16098
16194
  # The bucket name.
16099
16195
  #
16100
16196
  # @option params [String] :content_md5
16101
- # The base64-encoded 128-bit MD5 digest of the data. You must use this
16197
+ # The Base64 encoded 128-bit `MD5` digest of the data. You must use this
16102
16198
  # header as a message integrity check to verify that the request body
16103
16199
  # was not corrupted in transit. For more information, see [RFC 1864][1].
16104
16200
  #
@@ -16111,7 +16207,7 @@ module Aws::S3
16111
16207
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
16112
16208
  #
16113
16209
  # @option params [String] :checksum_algorithm
16114
- # Indicates the algorithm used to create the checksum for the object
16210
+ # Indicates the algorithm used to create the checksum for the request
16115
16211
  # when you use the SDK. This header will not provide any additional
16116
16212
  # functionality if you don't use the SDK. When you send this header,
16117
16213
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -16159,7 +16255,7 @@ module Aws::S3
16159
16255
  # resp = client.put_bucket_website({
16160
16256
  # bucket: "BucketName", # required
16161
16257
  # content_md5: "ContentMD5",
16162
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
16258
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
16163
16259
  # website_configuration: { # required
16164
16260
  # error_document: {
16165
16261
  # key: "ObjectKey", # required
@@ -16215,13 +16311,13 @@ module Aws::S3
16215
16311
  # * **Directory buckets** - For directory buckets, you must make
16216
16312
  # requests for this API operation to the Zonal endpoint. These
16217
16313
  # endpoints support virtual-hosted-style requests in the format
16218
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
16314
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
16219
16315
  # `. Path-style requests are not supported. For more information about
16220
16316
  # endpoints in Availability Zones, see [Regional and Zonal endpoints
16221
16317
  # for directory buckets in Availability Zones][1] in the *Amazon S3
16222
16318
  # 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*.
16319
+ # see [Concepts for directory buckets in Local Zones][2] in the
16320
+ # *Amazon S3 User Guide*.
16225
16321
  #
16226
16322
  # </note>
16227
16323
  #
@@ -16238,6 +16334,23 @@ module Aws::S3
16238
16334
  #
16239
16335
  # </note>
16240
16336
  #
16337
+ # * **If-None-Match** - Uploads the object only if the object key name
16338
+ # does not already exist in the specified bucket. Otherwise, Amazon S3
16339
+ # returns a `412 Precondition Failed` error. If a conflicting
16340
+ # operation occurs during the upload, S3 returns a `409
16341
+ # ConditionalRequestConflict` response. On a 409 failure, retry the
16342
+ # upload.
16343
+ #
16344
+ # Expects the * character (asterisk).
16345
+ #
16346
+ # For more information, see [Add preconditions to S3 operations with
16347
+ # conditional requests][4] in the *Amazon S3 User Guide* or [RFC
16348
+ # 7232][5].
16349
+ #
16350
+ # <note markdown="1"> This functionality is not supported for S3 on Outposts.
16351
+ #
16352
+ # </note>
16353
+ #
16241
16354
  # * **S3 Versioning** - When you enable versioning for a bucket, if
16242
16355
  # Amazon S3 receives multiple write requests for the same object
16243
16356
  # simultaneously, it stores all versions of the objects. For each
@@ -16245,9 +16358,9 @@ module Aws::S3
16245
16358
  # automatically generates a unique version ID of that object being
16246
16359
  # stored in Amazon S3. You can retrieve, replace, or delete any
16247
16360
  # version of the object. For more information about versioning, see
16248
- # [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
16361
+ # [Adding Objects to Versioning-Enabled Buckets][6] in the *Amazon S3
16249
16362
  # User Guide*. For information about returning the versioning state of
16250
- # a bucket, see [GetBucketVersioning][5].
16363
+ # a bucket, see [GetBucketVersioning][7].
16251
16364
  #
16252
16365
  # <note markdown="1"> This functionality is not supported for directory buckets.
16253
16366
  #
@@ -16271,7 +16384,7 @@ module Aws::S3
16271
16384
  # `s3:PutObjectTagging`.
16272
16385
  # * **Directory bucket permissions** - To grant access to this API
16273
16386
  # operation on a directory bucket, we recommend that you use the [
16274
- # `CreateSession` ][6] API operation for session-based
16387
+ # `CreateSession` ][8] API operation for session-based
16275
16388
  # authorization. Specifically, you grant the
16276
16389
  # `s3express:CreateSession` permission to the directory bucket in a
16277
16390
  # bucket policy or an IAM identity-based policy. Then, you make the
@@ -16282,7 +16395,7 @@ module Aws::S3
16282
16395
  # token for use. Amazon Web Services CLI or SDKs create session and
16283
16396
  # refresh the session token automatically to avoid service
16284
16397
  # interruptions when a session expires. For more information about
16285
- # authorization, see [ `CreateSession` ][6].
16398
+ # authorization, see [ `CreateSession` ][8].
16286
16399
  #
16287
16400
  # If the object is encrypted with SSE-KMS, you must also have the
16288
16401
  # `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -16307,20 +16420,22 @@ module Aws::S3
16307
16420
  #
16308
16421
  # For more information about related Amazon S3 APIs, see the following:
16309
16422
  #
16310
- # * [CopyObject][7]
16423
+ # * [CopyObject][9]
16311
16424
  #
16312
- # * [DeleteObject][8]
16425
+ # * [DeleteObject][10]
16313
16426
  #
16314
16427
  #
16315
16428
  #
16316
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
16429
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
16317
16430
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
16318
16431
  # [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
16432
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
16433
+ # [5]: https://datatracker.ietf.org/doc/rfc7232/
16434
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
16435
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
16436
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
16437
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
16438
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
16324
16439
  #
16325
16440
  # @option params [String] :acl
16326
16441
  # The canned ACL to apply to the object. For more information, see
@@ -16372,7 +16487,7 @@ module Aws::S3
16372
16487
  # requests are not supported. Directory bucket names must be unique in
16373
16488
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
16374
16489
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
16375
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
16490
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
16376
16491
  # naming restrictions, see [Directory bucket naming rules][1] in the
16377
16492
  # *Amazon S3 User Guide*.
16378
16493
  #
@@ -16392,14 +16507,14 @@ module Aws::S3
16392
16507
  #
16393
16508
  # </note>
16394
16509
  #
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 `
16510
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
16511
+ # must direct requests to the S3 on Outposts hostname. The S3 on
16512
+ # Outposts hostname takes the form `
16398
16513
  # 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*.
16514
+ # When you use this action with S3 on Outposts, the destination bucket
16515
+ # must be the Outposts access point ARN or the access point alias. For
16516
+ # more information about S3 on Outposts, see [What is S3 on
16517
+ # Outposts?][3] in the *Amazon S3 User Guide*.
16403
16518
  #
16404
16519
  #
16405
16520
  #
@@ -16448,7 +16563,7 @@ module Aws::S3
16448
16563
  # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
16449
16564
  #
16450
16565
  # @option params [String] :content_md5
16451
- # The base64-encoded 128-bit MD5 digest of the message (without the
16566
+ # The Base64 encoded 128-bit `MD5` digest of the message (without the
16452
16567
  # headers) according to RFC 1864. This header can be used as a message
16453
16568
  # integrity check to verify that the data is the same data that was
16454
16569
  # originally sent. Although it is optional, we recommend using the
@@ -16497,6 +16612,8 @@ module Aws::S3
16497
16612
  #
16498
16613
  # * `CRC32C`
16499
16614
  #
16615
+ # * `CRC64NVME`
16616
+ #
16500
16617
  # * `SHA1`
16501
16618
  #
16502
16619
  # * `SHA256`
@@ -16506,9 +16623,8 @@ module Aws::S3
16506
16623
  #
16507
16624
  # If the individual checksum value you provide through
16508
16625
  # `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 `.
16626
+ # set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
16627
+ # request with a `BadDigest` error.
16512
16628
  #
16513
16629
  # <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
16514
16630
  # for any request to upload an object with a retention period configured
@@ -16529,7 +16645,7 @@ module Aws::S3
16529
16645
  # @option params [String] :checksum_crc32
16530
16646
  # This header can be used as a data integrity check to verify that the
16531
16647
  # 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.
16648
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
16533
16649
  # For more information, see [Checking object integrity][1] in the
16534
16650
  # *Amazon S3 User Guide*.
16535
16651
  #
@@ -16540,7 +16656,7 @@ module Aws::S3
16540
16656
  # @option params [String] :checksum_crc32c
16541
16657
  # This header can be used as a data integrity check to verify that the
16542
16658
  # 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.
16659
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
16544
16660
  # For more information, see [Checking object integrity][1] in the
16545
16661
  # *Amazon S3 User Guide*.
16546
16662
  #
@@ -16548,10 +16664,22 @@ module Aws::S3
16548
16664
  #
16549
16665
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
16550
16666
  #
16667
+ # @option params [String] :checksum_crc64nvme
16668
+ # This header can be used as a data integrity check to verify that the
16669
+ # data received is the same data that was originally sent. This header
16670
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
16671
+ # object. The `CRC64NVME` checksum is always a full object checksum. For
16672
+ # more information, see [Checking object integrity in the Amazon S3 User
16673
+ # Guide][1].
16674
+ #
16675
+ #
16676
+ #
16677
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
16678
+ #
16551
16679
  # @option params [String] :checksum_sha1
16552
16680
  # This header can be used as a data integrity check to verify that the
16553
16681
  # 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
16682
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
16555
16683
  # more information, see [Checking object integrity][1] in the *Amazon S3
16556
16684
  # User Guide*.
16557
16685
  #
@@ -16562,7 +16690,7 @@ module Aws::S3
16562
16690
  # @option params [String] :checksum_sha256
16563
16691
  # This header can be used as a data integrity check to verify that the
16564
16692
  # 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.
16693
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
16566
16694
  # For more information, see [Checking object integrity][1] in the
16567
16695
  # *Amazon S3 User Guide*.
16568
16696
  #
@@ -16828,20 +16956,17 @@ module Aws::S3
16828
16956
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
16829
16957
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
16830
16958
  #
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.
16959
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
16960
+ # recommended to specify the `x-amz-server-side-encryption` header to
16961
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
16962
+ # header implicitly uses the bucket's default KMS customer managed key
16963
+ # ID. If you want to explicitly set the `
16964
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
16965
+ # bucket's default customer managed key (using key ID or ARN, not
16966
+ # alias). Your SSE-KMS configuration can only support 1 [customer
16967
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
16968
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
16969
+ # specification results in an HTTP `400 Bad Request` error.
16845
16970
  #
16846
16971
  #
16847
16972
  #
@@ -16851,7 +16976,7 @@ module Aws::S3
16851
16976
  # @option params [String] :ssekms_encryption_context
16852
16977
  # Specifies the Amazon Web Services KMS Encryption Context as an
16853
16978
  # 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,
16979
+ # of this header is a Base64 encoded string of a UTF-8 encoded JSON,
16855
16980
  # which contains the encryption context as key-value pairs. This value
16856
16981
  # is stored as object metadata and automatically gets passed on to
16857
16982
  # Amazon Web Services KMS for future `GetObject` operations on this
@@ -16962,8 +17087,10 @@ module Aws::S3
16962
17087
  # * {Types::PutObjectOutput#etag #etag} => String
16963
17088
  # * {Types::PutObjectOutput#checksum_crc32 #checksum_crc32} => String
16964
17089
  # * {Types::PutObjectOutput#checksum_crc32c #checksum_crc32c} => String
17090
+ # * {Types::PutObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
16965
17091
  # * {Types::PutObjectOutput#checksum_sha1 #checksum_sha1} => String
16966
17092
  # * {Types::PutObjectOutput#checksum_sha256 #checksum_sha256} => String
17093
+ # * {Types::PutObjectOutput#checksum_type #checksum_type} => String
16967
17094
  # * {Types::PutObjectOutput#server_side_encryption #server_side_encryption} => String
16968
17095
  # * {Types::PutObjectOutput#version_id #version_id} => String
16969
17096
  # * {Types::PutObjectOutput#sse_customer_algorithm #sse_customer_algorithm} => String
@@ -16975,134 +17102,134 @@ module Aws::S3
16975
17102
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
16976
17103
  #
16977
17104
  #
16978
- # @example Example: To upload an object (specify optional headers)
17105
+ # @example Example: To upload an object
16979
17106
  #
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.
17107
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
17108
+ # # syntax. S3 returns VersionId of the newly created object.
16982
17109
  #
16983
17110
  # resp = client.put_object({
16984
17111
  # body: "HappyFace.jpg",
16985
17112
  # bucket: "examplebucket",
16986
17113
  # key: "HappyFace.jpg",
16987
- # server_side_encryption: "AES256",
16988
- # storage_class: "STANDARD_IA",
16989
17114
  # })
16990
17115
  #
16991
17116
  # resp.to_h outputs the following:
16992
17117
  # {
16993
17118
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
16994
- # server_side_encryption: "AES256",
16995
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
17119
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
16996
17120
  # }
16997
17121
  #
16998
- # @example Example: To upload an object and specify server-side encryption and object tags
17122
+ # @example Example: To upload an object (specify optional headers)
16999
17123
  #
17000
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
17001
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
17124
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
17125
+ # # storage class and use server-side encryption.
17002
17126
  #
17003
17127
  # resp = client.put_object({
17004
- # body: "filetoupload",
17128
+ # body: "HappyFace.jpg",
17005
17129
  # bucket: "examplebucket",
17006
- # key: "exampleobject",
17130
+ # key: "HappyFace.jpg",
17007
17131
  # server_side_encryption: "AES256",
17008
- # tagging: "key1=value1&key2=value2",
17132
+ # storage_class: "STANDARD_IA",
17009
17133
  # })
17010
17134
  #
17011
17135
  # resp.to_h outputs the following:
17012
17136
  # {
17013
17137
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17014
17138
  # server_side_encryption: "AES256",
17015
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
17139
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
17016
17140
  # }
17017
17141
  #
17018
- # @example Example: To upload object and specify user-defined metadata
17142
+ # @example Example: To create an object.
17019
17143
  #
17020
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
17021
- # # enabled, S3 returns version ID in response.
17144
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
17022
17145
  #
17023
17146
  # resp = client.put_object({
17024
17147
  # body: "filetoupload",
17025
17148
  # bucket: "examplebucket",
17026
- # key: "exampleobject",
17027
- # metadata: {
17028
- # "metadata1" => "value1",
17029
- # "metadata2" => "value2",
17030
- # },
17149
+ # key: "objectkey",
17031
17150
  # })
17032
17151
  #
17033
17152
  # resp.to_h outputs the following:
17034
17153
  # {
17035
17154
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17036
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
17155
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
17037
17156
  # }
17038
17157
  #
17039
- # @example Example: To upload an object and specify canned ACL.
17158
+ # @example Example: To upload an object and specify optional tags
17040
17159
  #
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.
17160
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
17161
+ # # S3 returns version ID of the newly created object.
17043
17162
  #
17044
17163
  # resp = client.put_object({
17045
- # acl: "authenticated-read",
17046
- # body: "filetoupload",
17164
+ # body: "c:\\HappyFace.jpg",
17047
17165
  # bucket: "examplebucket",
17048
- # key: "exampleobject",
17166
+ # key: "HappyFace.jpg",
17167
+ # tagging: "key1=value1&key2=value2",
17049
17168
  # })
17050
17169
  #
17051
17170
  # resp.to_h outputs the following:
17052
17171
  # {
17053
17172
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17054
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
17173
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
17055
17174
  # }
17056
17175
  #
17057
- # @example Example: To upload an object and specify optional tags
17176
+ # @example Example: To upload an object and specify server-side encryption and object tags
17058
17177
  #
17059
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
17060
- # # S3 returns version ID of the newly created object.
17178
+ # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
17179
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
17061
17180
  #
17062
17181
  # resp = client.put_object({
17063
- # body: "c:\\HappyFace.jpg",
17182
+ # body: "filetoupload",
17064
17183
  # bucket: "examplebucket",
17065
- # key: "HappyFace.jpg",
17184
+ # key: "exampleobject",
17185
+ # server_side_encryption: "AES256",
17066
17186
  # tagging: "key1=value1&key2=value2",
17067
17187
  # })
17068
17188
  #
17069
17189
  # resp.to_h outputs the following:
17070
17190
  # {
17071
17191
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17072
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
17192
+ # server_side_encryption: "AES256",
17193
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
17073
17194
  # }
17074
17195
  #
17075
- # @example Example: To upload an object
17196
+ # @example Example: To upload object and specify user-defined metadata
17076
17197
  #
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.
17198
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
17199
+ # # enabled, S3 returns version ID in response.
17079
17200
  #
17080
17201
  # resp = client.put_object({
17081
- # body: "HappyFace.jpg",
17202
+ # body: "filetoupload",
17082
17203
  # bucket: "examplebucket",
17083
- # key: "HappyFace.jpg",
17204
+ # key: "exampleobject",
17205
+ # metadata: {
17206
+ # "metadata1" => "value1",
17207
+ # "metadata2" => "value2",
17208
+ # },
17084
17209
  # })
17085
17210
  #
17086
17211
  # resp.to_h outputs the following:
17087
17212
  # {
17088
17213
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17089
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
17214
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
17090
17215
  # }
17091
17216
  #
17092
- # @example Example: To create an object.
17217
+ # @example Example: To upload an object and specify canned ACL.
17093
17218
  #
17094
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
17219
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
17220
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
17095
17221
  #
17096
17222
  # resp = client.put_object({
17223
+ # acl: "authenticated-read",
17097
17224
  # body: "filetoupload",
17098
17225
  # bucket: "examplebucket",
17099
- # key: "objectkey",
17226
+ # key: "exampleobject",
17100
17227
  # })
17101
17228
  #
17102
17229
  # resp.to_h outputs the following:
17103
17230
  # {
17104
17231
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17105
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
17232
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
17106
17233
  # }
17107
17234
  #
17108
17235
  # @example Streaming a file from disk
@@ -17124,9 +17251,10 @@ module Aws::S3
17124
17251
  # content_length: 1,
17125
17252
  # content_md5: "ContentMD5",
17126
17253
  # content_type: "ContentType",
17127
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17254
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17128
17255
  # checksum_crc32: "ChecksumCRC32",
17129
17256
  # checksum_crc32c: "ChecksumCRC32C",
17257
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
17130
17258
  # checksum_sha1: "ChecksumSHA1",
17131
17259
  # checksum_sha256: "ChecksumSHA256",
17132
17260
  # expires: Time.now,
@@ -17164,8 +17292,10 @@ module Aws::S3
17164
17292
  # resp.etag #=> String
17165
17293
  # resp.checksum_crc32 #=> String
17166
17294
  # resp.checksum_crc32c #=> String
17295
+ # resp.checksum_crc64nvme #=> String
17167
17296
  # resp.checksum_sha1 #=> String
17168
17297
  # resp.checksum_sha256 #=> String
17298
+ # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
17169
17299
  # resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
17170
17300
  # resp.version_id #=> String
17171
17301
  # resp.sse_customer_algorithm #=> String
@@ -17379,14 +17509,14 @@ module Aws::S3
17379
17509
  # name. For more information about access point ARNs, see [Using access
17380
17510
  # points][1] in the *Amazon S3 User Guide*.
17381
17511
  #
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 `
17512
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
17513
+ # must direct requests to the S3 on Outposts hostname. The S3 on
17514
+ # Outposts hostname takes the form `
17385
17515
  # 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*.
17516
+ # When you use this action with S3 on Outposts, the destination bucket
17517
+ # must be the Outposts access point ARN or the access point alias. For
17518
+ # more information about S3 on Outposts, see [What is S3 on
17519
+ # Outposts?][2] in the *Amazon S3 User Guide*.
17390
17520
  #
17391
17521
  #
17392
17522
  #
@@ -17394,9 +17524,9 @@ module Aws::S3
17394
17524
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
17395
17525
  #
17396
17526
  # @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
17527
+ # The Base64 encoded 128-bit `MD5` digest of the data. This header must
17528
+ # be used as a message integrity check to verify that the request body
17529
+ # was not corrupted in transit. For more information, go to [RFC
17400
17530
  # 1864.&gt;][1]
17401
17531
  #
17402
17532
  # For requests made using the Amazon Web Services Command Line Interface
@@ -17529,7 +17659,7 @@ module Aws::S3
17529
17659
  # },
17530
17660
  # bucket: "BucketName", # required
17531
17661
  # content_md5: "ContentMD5",
17532
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17662
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17533
17663
  # grant_full_control: "GrantFullControl",
17534
17664
  # grant_read: "GrantRead",
17535
17665
  # grant_read_acp: "GrantReadACP",
@@ -17656,7 +17786,7 @@ module Aws::S3
17656
17786
  # request_payer: "requester", # accepts requester
17657
17787
  # version_id: "ObjectVersionId",
17658
17788
  # content_md5: "ContentMD5",
17659
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17789
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17660
17790
  # expected_bucket_owner: "AccountId",
17661
17791
  # })
17662
17792
  #
@@ -17775,7 +17905,7 @@ module Aws::S3
17775
17905
  # request_payer: "requester", # accepts requester
17776
17906
  # token: "ObjectLockToken",
17777
17907
  # content_md5: "ContentMD5",
17778
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
17908
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17779
17909
  # expected_bucket_owner: "AccountId",
17780
17910
  # })
17781
17911
  #
@@ -17904,7 +18034,7 @@ module Aws::S3
17904
18034
  # version_id: "ObjectVersionId",
17905
18035
  # bypass_governance_retention: false,
17906
18036
  # content_md5: "ContentMD5",
17907
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18037
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
17908
18038
  # expected_bucket_owner: "AccountId",
17909
18039
  # })
17910
18040
  #
@@ -17988,14 +18118,14 @@ module Aws::S3
17988
18118
  # name. For more information about access point ARNs, see [Using access
17989
18119
  # points][1] in the *Amazon S3 User Guide*.
17990
18120
  #
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 `
18121
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
18122
+ # must direct requests to the S3 on Outposts hostname. The S3 on
18123
+ # Outposts hostname takes the form `
17994
18124
  # 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*.
18125
+ # When you use this action with S3 on Outposts, the destination bucket
18126
+ # must be the Outposts access point ARN or the access point alias. For
18127
+ # more information about S3 on Outposts, see [What is S3 on
18128
+ # Outposts?][2] in the *Amazon S3 User Guide*.
17999
18129
  #
18000
18130
  #
18001
18131
  #
@@ -18094,7 +18224,7 @@ module Aws::S3
18094
18224
  # key: "ObjectKey", # required
18095
18225
  # version_id: "ObjectVersionId",
18096
18226
  # content_md5: "ContentMD5",
18097
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18227
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18098
18228
  # tagging: { # required
18099
18229
  # tag_set: [ # required
18100
18230
  # {
@@ -18209,7 +18339,7 @@ module Aws::S3
18209
18339
  # resp = client.put_public_access_block({
18210
18340
  # bucket: "BucketName", # required
18211
18341
  # content_md5: "ContentMD5",
18212
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18342
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18213
18343
  # public_access_block_configuration: { # required
18214
18344
  # block_public_acls: false,
18215
18345
  # ignore_public_acls: false,
@@ -18420,14 +18550,14 @@ module Aws::S3
18420
18550
  # name. For more information about access point ARNs, see [Using access
18421
18551
  # points][1] in the *Amazon S3 User Guide*.
18422
18552
  #
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 `
18553
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
18554
+ # must direct requests to the S3 on Outposts hostname. The S3 on
18555
+ # Outposts hostname takes the form `
18426
18556
  # 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*.
18557
+ # When you use this action with S3 on Outposts, the destination bucket
18558
+ # must be the Outposts access point ARN or the access point alias. For
18559
+ # more information about S3 on Outposts, see [What is S3 on
18560
+ # Outposts?][2] in the *Amazon S3 User Guide*.
18431
18561
  #
18432
18562
  #
18433
18563
  #
@@ -18594,7 +18724,7 @@ module Aws::S3
18594
18724
  # },
18595
18725
  # },
18596
18726
  # request_payer: "requester", # accepts requester
18597
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
18727
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
18598
18728
  # expected_bucket_owner: "AccountId",
18599
18729
  # })
18600
18730
  #
@@ -19066,13 +19196,13 @@ module Aws::S3
19066
19196
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19067
19197
  # for this API operation to the Zonal endpoint. These endpoints support
19068
19198
  # virtual-hosted-style requests in the format
19069
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19199
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
19070
19200
  # `. Path-style requests are not supported. For more information about
19071
19201
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19072
19202
  # directory buckets in Availability Zones][5] in the *Amazon S3 User
19073
19203
  # 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*.
19204
+ # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
19205
+ # User Guide*.
19076
19206
  #
19077
19207
  # </note>
19078
19208
  #
@@ -19206,7 +19336,7 @@ module Aws::S3
19206
19336
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
19207
19337
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
19208
19338
  # [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
19339
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
19210
19340
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19211
19341
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
19212
19342
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
@@ -19231,7 +19361,7 @@ module Aws::S3
19231
19361
  # requests are not supported. Directory bucket names must be unique in
19232
19362
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19233
19363
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19234
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19364
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
19235
19365
  # naming restrictions, see [Directory bucket naming rules][1] in the
19236
19366
  # *Amazon S3 User Guide*.
19237
19367
  #
@@ -19251,14 +19381,14 @@ module Aws::S3
19251
19381
  #
19252
19382
  # </note>
19253
19383
  #
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 `
19384
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
19385
+ # must direct requests to the S3 on Outposts hostname. The S3 on
19386
+ # Outposts hostname takes the form `
19257
19387
  # 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*.
19388
+ # When you use this action with S3 on Outposts, the destination bucket
19389
+ # must be the Outposts access point ARN or the access point alias. For
19390
+ # more information about S3 on Outposts, see [What is S3 on
19391
+ # Outposts?][3] in the *Amazon S3 User Guide*.
19262
19392
  #
19263
19393
  #
19264
19394
  #
@@ -19271,7 +19401,7 @@ module Aws::S3
19271
19401
  # the body cannot be determined automatically.
19272
19402
  #
19273
19403
  # @option params [String] :content_md5
19274
- # The base64-encoded 128-bit MD5 digest of the part data. This parameter
19404
+ # The Base64 encoded 128-bit MD5 digest of the part data. This parameter
19275
19405
  # is auto-populated when using the command from the CLI. This parameter
19276
19406
  # is required if object lock parameters are specified.
19277
19407
  #
@@ -19301,7 +19431,7 @@ module Aws::S3
19301
19431
  # @option params [String] :checksum_crc32
19302
19432
  # This header can be used as a data integrity check to verify that the
19303
19433
  # 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.
19434
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
19305
19435
  # For more information, see [Checking object integrity][1] in the
19306
19436
  # *Amazon S3 User Guide*.
19307
19437
  #
@@ -19312,7 +19442,18 @@ module Aws::S3
19312
19442
  # @option params [String] :checksum_crc32c
19313
19443
  # This header can be used as a data integrity check to verify that the
19314
19444
  # 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.
19445
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
19446
+ # For more information, see [Checking object integrity][1] in the
19447
+ # *Amazon S3 User Guide*.
19448
+ #
19449
+ #
19450
+ #
19451
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
19452
+ #
19453
+ # @option params [String] :checksum_crc64nvme
19454
+ # This header can be used as a data integrity check to verify that the
19455
+ # data received is the same data that was originally sent. This header
19456
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
19316
19457
  # For more information, see [Checking object integrity][1] in the
19317
19458
  # *Amazon S3 User Guide*.
19318
19459
  #
@@ -19323,7 +19464,7 @@ module Aws::S3
19323
19464
  # @option params [String] :checksum_sha1
19324
19465
  # This header can be used as a data integrity check to verify that the
19325
19466
  # 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
19467
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
19327
19468
  # more information, see [Checking object integrity][1] in the *Amazon S3
19328
19469
  # User Guide*.
19329
19470
  #
@@ -19334,7 +19475,7 @@ module Aws::S3
19334
19475
  # @option params [String] :checksum_sha256
19335
19476
  # This header can be used as a data integrity check to verify that the
19336
19477
  # 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.
19478
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
19338
19479
  # For more information, see [Checking object integrity][1] in the
19339
19480
  # *Amazon S3 User Guide*.
19340
19481
  #
@@ -19411,6 +19552,7 @@ module Aws::S3
19411
19552
  # * {Types::UploadPartOutput#etag #etag} => String
19412
19553
  # * {Types::UploadPartOutput#checksum_crc32 #checksum_crc32} => String
19413
19554
  # * {Types::UploadPartOutput#checksum_crc32c #checksum_crc32c} => String
19555
+ # * {Types::UploadPartOutput#checksum_crc64nvme #checksum_crc64nvme} => String
19414
19556
  # * {Types::UploadPartOutput#checksum_sha1 #checksum_sha1} => String
19415
19557
  # * {Types::UploadPartOutput#checksum_sha256 #checksum_sha256} => String
19416
19558
  # * {Types::UploadPartOutput#sse_customer_algorithm #sse_customer_algorithm} => String
@@ -19445,9 +19587,10 @@ module Aws::S3
19445
19587
  # bucket: "BucketName", # required
19446
19588
  # content_length: 1,
19447
19589
  # content_md5: "ContentMD5",
19448
- # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
19590
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
19449
19591
  # checksum_crc32: "ChecksumCRC32",
19450
19592
  # checksum_crc32c: "ChecksumCRC32C",
19593
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
19451
19594
  # checksum_sha1: "ChecksumSHA1",
19452
19595
  # checksum_sha256: "ChecksumSHA256",
19453
19596
  # key: "ObjectKey", # required
@@ -19466,6 +19609,7 @@ module Aws::S3
19466
19609
  # resp.etag #=> String
19467
19610
  # resp.checksum_crc32 #=> String
19468
19611
  # resp.checksum_crc32c #=> String
19612
+ # resp.checksum_crc64nvme #=> String
19469
19613
  # resp.checksum_sha1 #=> String
19470
19614
  # resp.checksum_sha256 #=> String
19471
19615
  # resp.sse_customer_algorithm #=> String
@@ -19511,13 +19655,13 @@ module Aws::S3
19511
19655
  # <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
19512
19656
  # for this API operation to the Zonal endpoint. These endpoints support
19513
19657
  # virtual-hosted-style requests in the format
19514
- # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
19658
+ # `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
19515
19659
  # `. Path-style requests are not supported. For more information about
19516
19660
  # endpoints in Availability Zones, see [Regional and Zonal endpoints for
19517
19661
  # directory buckets in Availability Zones][5] in the *Amazon S3 User
19518
19662
  # 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*.
19663
+ # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
19664
+ # User Guide*.
19521
19665
  #
19522
19666
  # </note>
19523
19667
  #
@@ -19662,7 +19806,7 @@ module Aws::S3
19662
19806
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
19663
19807
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
19664
19808
  # [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
19809
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
19666
19810
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
19667
19811
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
19668
19812
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
@@ -19688,7 +19832,7 @@ module Aws::S3
19688
19832
  # requests are not supported. Directory bucket names must be unique in
19689
19833
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
19690
19834
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
19691
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
19835
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
19692
19836
  # naming restrictions, see [Directory bucket naming rules][1] in the
19693
19837
  # *Amazon S3 User Guide*.
19694
19838
  #
@@ -19716,14 +19860,14 @@ module Aws::S3
19716
19860
  #
19717
19861
  # </note>
19718
19862
  #
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 `
19863
+ # **S3 on Outposts** - When you use this action with S3 on Outposts, you
19864
+ # must direct requests to the S3 on Outposts hostname. The S3 on
19865
+ # Outposts hostname takes the form `
19722
19866
  # 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*.
19867
+ # When you use this action with S3 on Outposts, the destination bucket
19868
+ # must be the Outposts access point ARN or the access point alias. For
19869
+ # more information about S3 on Outposts, see [What is S3 on
19870
+ # Outposts?][3] in the *Amazon S3 User Guide*.
19727
19871
  #
19728
19872
  #
19729
19873
  #
@@ -20044,6 +20188,7 @@ module Aws::S3
20044
20188
  # resp.copy_part_result.last_modified #=> Time
20045
20189
  # resp.copy_part_result.checksum_crc32 #=> String
20046
20190
  # resp.copy_part_result.checksum_crc32c #=> String
20191
+ # resp.copy_part_result.checksum_crc64nvme #=> String
20047
20192
  # resp.copy_part_result.checksum_sha1 #=> String
20048
20193
  # resp.copy_part_result.checksum_sha256 #=> String
20049
20194
  # resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
@@ -20208,7 +20353,7 @@ module Aws::S3
20208
20353
  # @option params [String] :checksum_crc32
20209
20354
  # This header can be used as a data integrity check to verify that the
20210
20355
  # data received is the same data that was originally sent. This
20211
- # specifies the base64-encoded, 32-bit CRC-32 checksum of the object
20356
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object
20212
20357
  # returned by the Object Lambda function. This may not match the
20213
20358
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20214
20359
  # validation of the checksum values only when the original `GetObject`
@@ -20228,7 +20373,7 @@ module Aws::S3
20228
20373
  # @option params [String] :checksum_crc32c
20229
20374
  # This header can be used as a data integrity check to verify that the
20230
20375
  # data received is the same data that was originally sent. This
20231
- # specifies the base64-encoded, 32-bit CRC-32C checksum of the object
20376
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object
20232
20377
  # returned by the Object Lambda function. This may not match the
20233
20378
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20234
20379
  # validation of the checksum values only when the original `GetObject`
@@ -20243,10 +20388,21 @@ module Aws::S3
20243
20388
  #
20244
20389
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
20245
20390
  #
20391
+ # @option params [String] :checksum_crc64nvme
20392
+ # This header can be used as a data integrity check to verify that the
20393
+ # data received is the same data that was originally sent. This header
20394
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
20395
+ # For more information, see [Checking object integrity][1] in the
20396
+ # *Amazon S3 User Guide*.
20397
+ #
20398
+ #
20399
+ #
20400
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
20401
+ #
20246
20402
  # @option params [String] :checksum_sha1
20247
20403
  # This header can be used as a data integrity check to verify that the
20248
20404
  # data received is the same data that was originally sent. This
20249
- # specifies the base64-encoded, 160-bit SHA-1 digest of the object
20405
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object
20250
20406
  # returned by the Object Lambda function. This may not match the
20251
20407
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20252
20408
  # validation of the checksum values only when the original `GetObject`
@@ -20264,7 +20420,7 @@ module Aws::S3
20264
20420
  # @option params [String] :checksum_sha256
20265
20421
  # This header can be used as a data integrity check to verify that the
20266
20422
  # data received is the same data that was originally sent. This
20267
- # specifies the base64-encoded, 256-bit SHA-256 digest of the object
20423
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object
20268
20424
  # returned by the Object Lambda function. This may not match the
20269
20425
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
20270
20426
  # validation of the checksum values only when the original `GetObject`
@@ -20281,7 +20437,12 @@ module Aws::S3
20281
20437
  #
20282
20438
  # @option params [Boolean] :delete_marker
20283
20439
  # Specifies whether an object stored in Amazon S3 is (`true`) or is not
20284
- # (`false`) a delete marker.
20440
+ # (`false`) a delete marker. To learn more about delete markers, see
20441
+ # [Working with delete markers][1].
20442
+ #
20443
+ #
20444
+ #
20445
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
20285
20446
  #
20286
20447
  # @option params [String] :etag
20287
20448
  # An opaque identifier assigned by a web server to a specific version of
@@ -20416,6 +20577,7 @@ module Aws::S3
20416
20577
  # content_type: "ContentType",
20417
20578
  # checksum_crc32: "ChecksumCRC32",
20418
20579
  # checksum_crc32c: "ChecksumCRC32C",
20580
+ # checksum_crc64nvme: "ChecksumCRC64NVME",
20419
20581
  # checksum_sha1: "ChecksumSHA1",
20420
20582
  # checksum_sha256: "ChecksumSHA256",
20421
20583
  # delete_marker: false,
@@ -20471,7 +20633,7 @@ module Aws::S3
20471
20633
  tracer: tracer
20472
20634
  )
20473
20635
  context[:gem_name] = 'aws-sdk-s3'
20474
- context[:gem_version] = '1.176.1'
20636
+ context[:gem_version] = '1.182.0'
20475
20637
  Seahorse::Client::Request.new(handlers, context)
20476
20638
  end
20477
20639