aws-sdk-s3 1.176.1 → 1.180.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +22 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +50 -39
- data/lib/aws-sdk-s3/bucket_acl.rb +6 -5
- data/lib/aws-sdk-s3/bucket_cors.rb +6 -5
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +3 -3
- data/lib/aws-sdk-s3/bucket_logging.rb +2 -2
- data/lib/aws-sdk-s3/bucket_policy.rb +10 -9
- data/lib/aws-sdk-s3/bucket_request_payment.rb +3 -3
- data/lib/aws-sdk-s3/bucket_tagging.rb +3 -3
- data/lib/aws-sdk-s3/bucket_versioning.rb +9 -9
- data/lib/aws-sdk-s3/bucket_website.rb +3 -3
- data/lib/aws-sdk-s3/client.rb +698 -538
- data/lib/aws-sdk-s3/client_api.rb +34 -2
- data/lib/aws-sdk-s3/endpoint_provider.rb +260 -277
- data/lib/aws-sdk-s3/file_downloader.rb +4 -21
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +31 -13
- data/lib/aws-sdk-s3/multipart_upload.rb +48 -6
- data/lib/aws-sdk-s3/multipart_upload_part.rb +52 -36
- data/lib/aws-sdk-s3/object.rb +142 -110
- data/lib/aws-sdk-s3/object_acl.rb +4 -4
- data/lib/aws-sdk-s3/object_summary.rb +97 -80
- data/lib/aws-sdk-s3/object_version.rb +22 -18
- data/lib/aws-sdk-s3/plugins/checksum_algorithm.rb +31 -0
- data/lib/aws-sdk-s3/plugins/express_session_auth.rb +11 -20
- data/lib/aws-sdk-s3/plugins/md5s.rb +10 -71
- data/lib/aws-sdk-s3/presigner.rb +4 -5
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +1017 -671
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +4 -3
- data/sig/bucket_acl.rbs +1 -1
- data/sig/bucket_cors.rbs +1 -1
- data/sig/bucket_lifecycle.rbs +1 -1
- data/sig/bucket_lifecycle_configuration.rbs +1 -1
- data/sig/bucket_logging.rbs +1 -1
- data/sig/bucket_policy.rbs +1 -1
- data/sig/bucket_request_payment.rbs +1 -1
- data/sig/bucket_tagging.rbs +1 -1
- data/sig/bucket_versioning.rbs +3 -3
- data/sig/bucket_website.rbs +1 -1
- data/sig/client.rbs +52 -31
- data/sig/multipart_upload.rbs +8 -1
- data/sig/multipart_upload_part.rbs +5 -1
- data/sig/object.rbs +13 -5
- data/sig/object_acl.rbs +1 -1
- data/sig/object_summary.rbs +11 -6
- data/sig/object_version.rbs +5 -2
- data/sig/resource.rbs +3 -1
- data/sig/types.rbs +63 -34
- metadata +5 -5
- data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +0 -31
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -40,6 +40,7 @@ require 'aws-sdk-s3/plugins/access_grants.rb'
|
|
40
40
|
require 'aws-sdk-s3/plugins/arn.rb'
|
41
41
|
require 'aws-sdk-s3/plugins/bucket_dns.rb'
|
42
42
|
require 'aws-sdk-s3/plugins/bucket_name_restrictions.rb'
|
43
|
+
require 'aws-sdk-s3/plugins/checksum_algorithm.rb'
|
43
44
|
require 'aws-sdk-s3/plugins/dualstack.rb'
|
44
45
|
require 'aws-sdk-s3/plugins/expect_100_continue.rb'
|
45
46
|
require 'aws-sdk-s3/plugins/express_session_auth.rb'
|
@@ -52,7 +53,6 @@ require 'aws-sdk-s3/plugins/redirects.rb'
|
|
52
53
|
require 'aws-sdk-s3/plugins/s3_host_id.rb'
|
53
54
|
require 'aws-sdk-s3/plugins/s3_signer.rb'
|
54
55
|
require 'aws-sdk-s3/plugins/sse_cpk.rb'
|
55
|
-
require 'aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb'
|
56
56
|
require 'aws-sdk-s3/plugins/streaming_retry.rb'
|
57
57
|
require 'aws-sdk-s3/plugins/url_encoded_keys.rb'
|
58
58
|
require 'aws-sdk-core/plugins/event_stream_configuration.rb'
|
@@ -111,6 +111,7 @@ module Aws::S3
|
|
111
111
|
add_plugin(Aws::S3::Plugins::ARN)
|
112
112
|
add_plugin(Aws::S3::Plugins::BucketDns)
|
113
113
|
add_plugin(Aws::S3::Plugins::BucketNameRestrictions)
|
114
|
+
add_plugin(Aws::S3::Plugins::ChecksumAlgorithm)
|
114
115
|
add_plugin(Aws::S3::Plugins::Dualstack)
|
115
116
|
add_plugin(Aws::S3::Plugins::Expect100Continue)
|
116
117
|
add_plugin(Aws::S3::Plugins::ExpressSessionAuth)
|
@@ -123,7 +124,6 @@ module Aws::S3
|
|
123
124
|
add_plugin(Aws::S3::Plugins::S3HostId)
|
124
125
|
add_plugin(Aws::S3::Plugins::S3Signer)
|
125
126
|
add_plugin(Aws::S3::Plugins::SseCpk)
|
126
|
-
add_plugin(Aws::S3::Plugins::SkipWholeMultipartGetChecksums)
|
127
127
|
add_plugin(Aws::S3::Plugins::StreamingRetry)
|
128
128
|
add_plugin(Aws::S3::Plugins::UrlEncodedKeys)
|
129
129
|
add_plugin(Aws::Plugins::EventStreamConfiguration)
|
@@ -240,11 +240,8 @@ module Aws::S3
|
|
240
240
|
# will use the Client Side Monitoring Agent Publisher.
|
241
241
|
#
|
242
242
|
# @option options [Boolean] :compute_checksums (true)
|
243
|
-
#
|
244
|
-
#
|
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
|
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 [
|
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/
|
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
|
-
#
|
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
|
669
|
-
#
|
670
|
-
#
|
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
|
673
|
-
#
|
674
|
-
#
|
675
|
-
#
|
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
|
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
|
-
# [
|
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/
|
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
|
-
#
|
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
|
946
|
-
#
|
947
|
-
#
|
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
|
950
|
-
#
|
951
|
-
#
|
952
|
-
#
|
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
|
992
|
+
# specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
|
973
993
|
# For more information, see [Checking object integrity][1] in the
|
974
994
|
# *Amazon S3 User Guide*.
|
975
995
|
#
|
@@ -980,7 +1000,7 @@ module Aws::S3
|
|
980
1000
|
# @option params [String] :checksum_crc32c
|
981
1001
|
# This header can be used as a data integrity check to verify that the
|
982
1002
|
# data received is the same data that was originally sent. This header
|
983
|
-
# specifies the
|
1003
|
+
# specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
|
984
1004
|
# For more information, see [Checking object integrity][1] in the
|
985
1005
|
# *Amazon S3 User Guide*.
|
986
1006
|
#
|
@@ -988,12 +1008,24 @@ module Aws::S3
|
|
988
1008
|
#
|
989
1009
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
990
1010
|
#
|
1011
|
+
# @option params [String] :checksum_crc64nvme
|
1012
|
+
# This header can be used as a data integrity check to verify that the
|
1013
|
+
# data received is the same data that was originally sent. This header
|
1014
|
+
# specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
|
1015
|
+
# object. The `CRC-64NVME` checksum is always a full object checksum.
|
1016
|
+
# For more information, see [Checking object integrity in the Amazon S3
|
1017
|
+
# User Guide][1].
|
1018
|
+
#
|
1019
|
+
#
|
1020
|
+
#
|
1021
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
1022
|
+
#
|
991
1023
|
# @option params [String] :checksum_sha1
|
992
1024
|
# This header can be used as a data integrity check to verify that the
|
993
1025
|
# data received is the same data that was originally sent. This header
|
994
|
-
# specifies the
|
995
|
-
# more information, see [Checking object integrity][1] in the
|
996
|
-
# User Guide*.
|
1026
|
+
# specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
|
1027
|
+
# For more information, see [Checking object integrity][1] in the
|
1028
|
+
# *Amazon S3 User Guide*.
|
997
1029
|
#
|
998
1030
|
#
|
999
1031
|
#
|
@@ -1002,7 +1034,7 @@ module Aws::S3
|
|
1002
1034
|
# @option params [String] :checksum_sha256
|
1003
1035
|
# This header can be used as a data integrity check to verify that the
|
1004
1036
|
# data received is the same data that was originally sent. This header
|
1005
|
-
# specifies the
|
1037
|
+
# specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
|
1006
1038
|
# For more information, see [Checking object integrity][1] in the
|
1007
1039
|
# *Amazon S3 User Guide*.
|
1008
1040
|
#
|
@@ -1010,6 +1042,23 @@ module Aws::S3
|
|
1010
1042
|
#
|
1011
1043
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
1012
1044
|
#
|
1045
|
+
# @option params [String] :checksum_type
|
1046
|
+
# This header specifies the checksum type of the object, which
|
1047
|
+
# determines how part-level checksums are combined to create an
|
1048
|
+
# object-level checksum for multipart objects. You can use this header
|
1049
|
+
# as a data integrity check to verify that the checksum type that is
|
1050
|
+
# received is the same checksum that was specified. If the checksum type
|
1051
|
+
# doesn’t match the checksum type that was specified for the object
|
1052
|
+
# during the `CreateMultipartUpload` request, it’ll result in a
|
1053
|
+
# `BadDigest` error. For more information, see Checking object integrity
|
1054
|
+
# in the Amazon S3 User Guide.
|
1055
|
+
#
|
1056
|
+
# @option params [Integer] :mpu_object_size
|
1057
|
+
# The expected total object size of the multipart upload request. If
|
1058
|
+
# there’s a mismatch between the specified object size value and the
|
1059
|
+
# actual object size value, it results in an `HTTP 400 InvalidRequest`
|
1060
|
+
# error.
|
1061
|
+
#
|
1013
1062
|
# @option params [String] :request_payer
|
1014
1063
|
# Confirms that the requester knows that they will be charged for the
|
1015
1064
|
# request. Bucket owners need not specify this parameter in their
|
@@ -1125,8 +1174,10 @@ module Aws::S3
|
|
1125
1174
|
# * {Types::CompleteMultipartUploadOutput#etag #etag} => String
|
1126
1175
|
# * {Types::CompleteMultipartUploadOutput#checksum_crc32 #checksum_crc32} => String
|
1127
1176
|
# * {Types::CompleteMultipartUploadOutput#checksum_crc32c #checksum_crc32c} => String
|
1177
|
+
# * {Types::CompleteMultipartUploadOutput#checksum_crc64nvme #checksum_crc64nvme} => String
|
1128
1178
|
# * {Types::CompleteMultipartUploadOutput#checksum_sha1 #checksum_sha1} => String
|
1129
1179
|
# * {Types::CompleteMultipartUploadOutput#checksum_sha256 #checksum_sha256} => String
|
1180
|
+
# * {Types::CompleteMultipartUploadOutput#checksum_type #checksum_type} => String
|
1130
1181
|
# * {Types::CompleteMultipartUploadOutput#server_side_encryption #server_side_encryption} => String
|
1131
1182
|
# * {Types::CompleteMultipartUploadOutput#version_id #version_id} => String
|
1132
1183
|
# * {Types::CompleteMultipartUploadOutput#ssekms_key_id #ssekms_key_id} => String
|
@@ -1175,6 +1226,7 @@ module Aws::S3
|
|
1175
1226
|
# etag: "ETag",
|
1176
1227
|
# checksum_crc32: "ChecksumCRC32",
|
1177
1228
|
# checksum_crc32c: "ChecksumCRC32C",
|
1229
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
1178
1230
|
# checksum_sha1: "ChecksumSHA1",
|
1179
1231
|
# checksum_sha256: "ChecksumSHA256",
|
1180
1232
|
# part_number: 1,
|
@@ -1184,8 +1236,11 @@ module Aws::S3
|
|
1184
1236
|
# upload_id: "MultipartUploadId", # required
|
1185
1237
|
# checksum_crc32: "ChecksumCRC32",
|
1186
1238
|
# checksum_crc32c: "ChecksumCRC32C",
|
1239
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
1187
1240
|
# checksum_sha1: "ChecksumSHA1",
|
1188
1241
|
# checksum_sha256: "ChecksumSHA256",
|
1242
|
+
# checksum_type: "COMPOSITE", # accepts COMPOSITE, FULL_OBJECT
|
1243
|
+
# mpu_object_size: 1,
|
1189
1244
|
# request_payer: "requester", # accepts requester
|
1190
1245
|
# expected_bucket_owner: "AccountId",
|
1191
1246
|
# if_match: "IfMatch",
|
@@ -1204,8 +1259,10 @@ module Aws::S3
|
|
1204
1259
|
# resp.etag #=> String
|
1205
1260
|
# resp.checksum_crc32 #=> String
|
1206
1261
|
# resp.checksum_crc32c #=> String
|
1262
|
+
# resp.checksum_crc64nvme #=> String
|
1207
1263
|
# resp.checksum_sha1 #=> String
|
1208
1264
|
# resp.checksum_sha256 #=> String
|
1265
|
+
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
1209
1266
|
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
1210
1267
|
# resp.version_id #=> String
|
1211
1268
|
# resp.ssekms_key_id #=> String
|
@@ -1242,13 +1299,13 @@ module Aws::S3
|
|
1242
1299
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
1243
1300
|
# requests for this API operation to the Zonal endpoint. These
|
1244
1301
|
# endpoints support virtual-hosted-style requests in the format
|
1245
|
-
# `https://bucket
|
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 [
|
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
|
-
#
|
1379
|
-
#
|
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/
|
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
|
-
#
|
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
|
1473
|
-
#
|
1474
|
-
#
|
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
|
-
#
|
1477
|
-
#
|
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** -
|
1959
|
-
#
|
1960
|
-
#
|
1961
|
-
#
|
1962
|
-
#
|
1963
|
-
# x-amz-server-side-encryption-aws-kms-key-id` header
|
1964
|
-
#
|
1965
|
-
#
|
1966
|
-
#
|
1967
|
-
#
|
1968
|
-
#
|
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 [
|
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/
|
2473
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
2407
2474
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
2408
2475
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
2409
2476
|
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
|
@@ -2569,7 +2636,7 @@ module Aws::S3
|
|
2569
2636
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
2570
2637
|
# bucket: "BucketName", # required
|
2571
2638
|
# create_bucket_configuration: {
|
2572
|
-
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
2639
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-4, ap-southeast-5, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-central-2, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, il-central-1, me-central-1, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
2573
2640
|
# location: {
|
2574
2641
|
# type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
|
2575
2642
|
# name: "LocationNameAsString",
|
@@ -2666,7 +2733,7 @@ module Aws::S3
|
|
2666
2733
|
# resp = client.create_bucket_metadata_table_configuration({
|
2667
2734
|
# bucket: "BucketName", # required
|
2668
2735
|
# content_md5: "ContentMD5",
|
2669
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
2736
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
2670
2737
|
# metadata_table_configuration: { # required
|
2671
2738
|
# s3_tables_destination: { # required
|
2672
2739
|
# table_bucket_arn: "S3TablesBucketArn", # required
|
@@ -2716,13 +2783,13 @@ module Aws::S3
|
|
2716
2783
|
# * <b>Directory buckets </b> - For directory buckets, you must make
|
2717
2784
|
# requests for this API operation to the Zonal endpoint. These
|
2718
2785
|
# endpoints support virtual-hosted-style requests in the format
|
2719
|
-
# `https://bucket
|
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 [
|
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/
|
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
|
-
#
|
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
|
3000
|
-
#
|
3001
|
-
#
|
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
|
3004
|
-
#
|
3005
|
-
#
|
3006
|
-
#
|
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** -
|
3423
|
-
#
|
3424
|
-
#
|
3425
|
-
#
|
3426
|
-
#
|
3427
|
-
# x-amz-server-side-encryption-aws-kms-key-id` header
|
3428
|
-
#
|
3429
|
-
#
|
3430
|
-
#
|
3431
|
-
#
|
3432
|
-
#
|
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
|
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 [
|
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/
|
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/
|
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
|
3841
|
-
#
|
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
|
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 [
|
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/
|
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 [
|
4445
|
-
#
|
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/
|
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 [
|
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/
|
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
|
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 [
|
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/
|
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
|
-
#
|
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
|
5157
|
-
#
|
5158
|
-
#
|
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
|
5161
|
-
#
|
5162
|
-
#
|
5163
|
-
#
|
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://
|
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
|
5366
|
-
#
|
5367
|
-
#
|
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
|
5370
|
-
#
|
5371
|
-
#
|
5372
|
-
#
|
5445
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
5446
|
+
# must be the Outposts access point ARN or the access point alias. For
|
5447
|
+
# more information about S3 on Outposts, see [What is S3 on
|
5448
|
+
# Outposts?][2] in the *Amazon S3 User Guide*.
|
5373
5449
|
#
|
5374
5450
|
#
|
5375
5451
|
#
|
@@ -5393,35 +5469,35 @@ module Aws::S3
|
|
5393
5469
|
# * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
|
5394
5470
|
#
|
5395
5471
|
#
|
5396
|
-
# @example Example: To remove tag set from an object
|
5472
|
+
# @example Example: To remove tag set from an object version
|
5397
5473
|
#
|
5398
|
-
# # The following example removes tag set associated with the specified object.
|
5399
|
-
# #
|
5474
|
+
# # The following example removes tag set associated with the specified object version. The request specifies both the
|
5475
|
+
# # object key and object version.
|
5400
5476
|
#
|
5401
5477
|
# resp = client.delete_object_tagging({
|
5402
5478
|
# bucket: "examplebucket",
|
5403
5479
|
# key: "HappyFace.jpg",
|
5480
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5404
5481
|
# })
|
5405
5482
|
#
|
5406
5483
|
# resp.to_h outputs the following:
|
5407
5484
|
# {
|
5408
|
-
# version_id: "
|
5485
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5409
5486
|
# }
|
5410
5487
|
#
|
5411
|
-
# @example Example: To remove tag set from an object
|
5488
|
+
# @example Example: To remove tag set from an object
|
5412
5489
|
#
|
5413
|
-
# # The following example removes tag set associated with the specified object
|
5414
|
-
# #
|
5490
|
+
# # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
|
5491
|
+
# # operation removes tag set from the latest object version.
|
5415
5492
|
#
|
5416
5493
|
# resp = client.delete_object_tagging({
|
5417
5494
|
# bucket: "examplebucket",
|
5418
5495
|
# key: "HappyFace.jpg",
|
5419
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5420
5496
|
# })
|
5421
5497
|
#
|
5422
5498
|
# resp.to_h outputs the following:
|
5423
5499
|
# {
|
5424
|
-
# version_id: "
|
5500
|
+
# version_id: "null",
|
5425
5501
|
# }
|
5426
5502
|
#
|
5427
5503
|
# @example Request syntax with placeholder values
|
@@ -5451,13 +5527,14 @@ module Aws::S3
|
|
5451
5527
|
# to delete, then this operation provides a suitable alternative to
|
5452
5528
|
# sending individual delete requests, reducing per-request overhead.
|
5453
5529
|
#
|
5454
|
-
# The request can contain a list of up to
|
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.
|
5460
|
-
#
|
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
|
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 [
|
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/
|
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
|
-
#
|
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
|
5598
|
-
#
|
5599
|
-
#
|
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
|
5602
|
-
#
|
5603
|
-
#
|
5604
|
-
#
|
5678
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
5679
|
+
# must be the Outposts access point ARN or the access point alias. For
|
5680
|
+
# more information about S3 on Outposts, see [What is S3 on
|
5681
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
5605
5682
|
#
|
5606
5683
|
#
|
5607
5684
|
#
|
@@ -5677,22 +5754,23 @@ module Aws::S3
|
|
5677
5754
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
5678
5755
|
# the supported algorithm from the following list:
|
5679
5756
|
#
|
5680
|
-
# * `
|
5757
|
+
# * `CRC-32`
|
5681
5758
|
#
|
5682
|
-
# * `
|
5759
|
+
# * `CRC-32C`
|
5683
5760
|
#
|
5684
|
-
# * `
|
5761
|
+
# * `CRC-64NVME`
|
5685
5762
|
#
|
5686
|
-
# * `
|
5763
|
+
# * `SHA-1`
|
5764
|
+
#
|
5765
|
+
# * `SHA-256`
|
5687
5766
|
#
|
5688
5767
|
# For more information, see [Checking object integrity][1] in the
|
5689
5768
|
# *Amazon S3 User Guide*.
|
5690
5769
|
#
|
5691
5770
|
# If the individual checksum value you provide through
|
5692
5771
|
# `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
|
5693
|
-
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3
|
5694
|
-
#
|
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<Types::Error>
|
5709
5787
|
#
|
5710
5788
|
#
|
5711
|
-
# @example Example: To delete multiple
|
5789
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
5712
5790
|
#
|
5713
|
-
# # The following example deletes objects from a bucket. The
|
5714
|
-
# #
|
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: "
|
5799
|
+
# key: "HappyFace.jpg",
|
5800
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5722
5801
|
# },
|
5723
5802
|
# {
|
5724
|
-
# key: "
|
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
|
-
#
|
5736
|
-
#
|
5737
|
-
# key: "objectkey1",
|
5815
|
+
# key: "HappyFace.jpg",
|
5816
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
5738
5817
|
# },
|
5739
5818
|
# {
|
5740
|
-
#
|
5741
|
-
#
|
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
|
5825
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
5748
5826
|
#
|
5749
|
-
# # The following example deletes objects from a bucket. The
|
5750
|
-
# #
|
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: "
|
5758
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
5835
|
+
# key: "objectkey1",
|
5759
5836
|
# },
|
5760
5837
|
# {
|
5761
|
-
# key: "
|
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
|
-
#
|
5774
|
-
#
|
5849
|
+
# delete_marker: true,
|
5850
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
5851
|
+
# key: "objectkey1",
|
5775
5852
|
# },
|
5776
5853
|
# {
|
5777
|
-
#
|
5778
|
-
#
|
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 [
|
6737
|
-
#
|
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/
|
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 [
|
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/
|
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
|
-
# `
|
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
|
-
# [
|
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/
|
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
|
-
#
|
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
|
8365
|
-
#
|
8366
|
-
#
|
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
|
8369
|
-
#
|
8370
|
-
#
|
8371
|
-
#
|
8446
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
8447
|
+
# must be the Outposts access point ARN or the access point alias. For
|
8448
|
+
# more information about S3 on Outposts, see [What is S3 on
|
8449
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
8372
8450
|
#
|
8373
8451
|
#
|
8374
8452
|
#
|
@@ -8618,15 +8696,6 @@ module Aws::S3
|
|
8618
8696
|
# @option params [String] :checksum_mode
|
8619
8697
|
# To retrieve the checksum, this mode must be enabled.
|
8620
8698
|
#
|
8621
|
-
# **General purpose buckets** - In addition, if you enable checksum mode
|
8622
|
-
# and the object is uploaded with a [checksum][1] and encrypted with an
|
8623
|
-
# Key Management Service (KMS) key, you must have permission to use the
|
8624
|
-
# `kms:Decrypt` action to retrieve the checksum.
|
8625
|
-
#
|
8626
|
-
#
|
8627
|
-
#
|
8628
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
|
8629
|
-
#
|
8630
8699
|
# @return [Types::GetObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
8631
8700
|
#
|
8632
8701
|
# * {Types::GetObjectOutput#body #body} => IO
|
@@ -8639,8 +8708,10 @@ module Aws::S3
|
|
8639
8708
|
# * {Types::GetObjectOutput#etag #etag} => String
|
8640
8709
|
# * {Types::GetObjectOutput#checksum_crc32 #checksum_crc32} => String
|
8641
8710
|
# * {Types::GetObjectOutput#checksum_crc32c #checksum_crc32c} => String
|
8711
|
+
# * {Types::GetObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
|
8642
8712
|
# * {Types::GetObjectOutput#checksum_sha1 #checksum_sha1} => String
|
8643
8713
|
# * {Types::GetObjectOutput#checksum_sha256 #checksum_sha256} => String
|
8714
|
+
# * {Types::GetObjectOutput#checksum_type #checksum_type} => String
|
8644
8715
|
# * {Types::GetObjectOutput#missing_meta #missing_meta} => Integer
|
8645
8716
|
# * {Types::GetObjectOutput#version_id #version_id} => String
|
8646
8717
|
# * {Types::GetObjectOutput#cache_control #cache_control} => String
|
@@ -8781,8 +8852,10 @@ module Aws::S3
|
|
8781
8852
|
# resp.etag #=> String
|
8782
8853
|
# resp.checksum_crc32 #=> String
|
8783
8854
|
# resp.checksum_crc32c #=> String
|
8855
|
+
# resp.checksum_crc64nvme #=> String
|
8784
8856
|
# resp.checksum_sha1 #=> String
|
8785
8857
|
# resp.checksum_sha256 #=> String
|
8858
|
+
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
8786
8859
|
# resp.missing_meta #=> Integer
|
8787
8860
|
# resp.version_id #=> String
|
8788
8861
|
# resp.cache_control #=> String
|
@@ -9014,13 +9087,13 @@ module Aws::S3
|
|
9014
9087
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
9015
9088
|
# for this API operation to the Zonal endpoint. These endpoints support
|
9016
9089
|
# virtual-hosted-style requests in the format
|
9017
|
-
# `https://bucket
|
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
|
-
# [
|
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/
|
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
|
-
#
|
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
|
9219
|
-
#
|
9220
|
-
#
|
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
|
9223
|
-
#
|
9224
|
-
#
|
9225
|
-
#
|
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
|
9684
|
-
#
|
9685
|
-
#
|
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
|
9688
|
-
#
|
9689
|
-
#
|
9690
|
-
#
|
9763
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
9764
|
+
# must be the Outposts access point ARN or the access point alias. For
|
9765
|
+
# more information about S3 on Outposts, see [What is S3 on
|
9766
|
+
# Outposts?][2] in the *Amazon S3 User Guide*.
|
9691
9767
|
#
|
9692
9768
|
#
|
9693
9769
|
#
|
@@ -10040,8 +10116,8 @@ module Aws::S3
|
|
10040
10116
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
10041
10117
|
# for directory buckets in Availability Zones][5] in the *Amazon S3
|
10042
10118
|
# User Guide*. For more information about endpoints in Local Zones,
|
10043
|
-
# see [
|
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/
|
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
|
-
#
|
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
|
10094
|
-
#
|
10095
|
-
#
|
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
|
10098
|
-
#
|
10099
|
-
#
|
10100
|
-
#
|
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
|
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 [
|
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/
|
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
|
-
#
|
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
|
10347
|
-
#
|
10348
|
-
#
|
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
|
10351
|
-
#
|
10352
|
-
#
|
10353
|
-
#
|
10426
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
10427
|
+
# must be the Outposts access point ARN or the access point alias. For
|
10428
|
+
# more information about S3 on Outposts, see [What is S3 on
|
10429
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
10354
10430
|
#
|
10355
10431
|
#
|
10356
10432
|
#
|
@@ -10554,8 +10630,10 @@ module Aws::S3
|
|
10554
10630
|
# * {Types::HeadObjectOutput#content_length #content_length} => Integer
|
10555
10631
|
# * {Types::HeadObjectOutput#checksum_crc32 #checksum_crc32} => String
|
10556
10632
|
# * {Types::HeadObjectOutput#checksum_crc32c #checksum_crc32c} => String
|
10633
|
+
# * {Types::HeadObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
|
10557
10634
|
# * {Types::HeadObjectOutput#checksum_sha1 #checksum_sha1} => String
|
10558
10635
|
# * {Types::HeadObjectOutput#checksum_sha256 #checksum_sha256} => String
|
10636
|
+
# * {Types::HeadObjectOutput#checksum_type #checksum_type} => String
|
10559
10637
|
# * {Types::HeadObjectOutput#etag #etag} => String
|
10560
10638
|
# * {Types::HeadObjectOutput#missing_meta #missing_meta} => Integer
|
10561
10639
|
# * {Types::HeadObjectOutput#version_id #version_id} => String
|
@@ -10640,8 +10718,10 @@ module Aws::S3
|
|
10640
10718
|
# resp.content_length #=> Integer
|
10641
10719
|
# resp.checksum_crc32 #=> String
|
10642
10720
|
# resp.checksum_crc32c #=> String
|
10721
|
+
# resp.checksum_crc64nvme #=> String
|
10643
10722
|
# resp.checksum_sha1 #=> String
|
10644
10723
|
# resp.checksum_sha256 #=> String
|
10724
|
+
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
10645
10725
|
# resp.etag #=> String
|
10646
10726
|
# resp.missing_meta #=> Integer
|
10647
10727
|
# resp.version_id #=> String
|
@@ -11231,7 +11311,7 @@ module Aws::S3
|
|
11231
11311
|
# about endpoints in Availability Zones, see [Regional and Zonal
|
11232
11312
|
# endpoints for directory buckets in Availability Zones][2] in the
|
11233
11313
|
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
11234
|
-
# Zones, see [
|
11314
|
+
# Zones, see [Concepts for directory buckets in Local Zones][3] in the
|
11235
11315
|
# *Amazon S3 User Guide*.
|
11236
11316
|
#
|
11237
11317
|
# </note>
|
@@ -11260,7 +11340,7 @@ module Aws::S3
|
|
11260
11340
|
#
|
11261
11341
|
#
|
11262
11342
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
11263
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
11343
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
11264
11344
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11265
11345
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
11266
11346
|
#
|
@@ -11350,13 +11430,13 @@ module Aws::S3
|
|
11350
11430
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
11351
11431
|
# for this API operation to the Zonal endpoint. These endpoints support
|
11352
11432
|
# virtual-hosted-style requests in the format
|
11353
|
-
# `https://bucket
|
11433
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
11354
11434
|
# `. Path-style requests are not supported. For more information about
|
11355
11435
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
11356
11436
|
# directory buckets in Availability Zones][2] in the *Amazon S3 User
|
11357
11437
|
# Guide*. For more information about endpoints in Local Zones, see
|
11358
|
-
# [
|
11359
|
-
# Guide*.
|
11438
|
+
# [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
|
11439
|
+
# User Guide*.
|
11360
11440
|
#
|
11361
11441
|
# </note>
|
11362
11442
|
#
|
@@ -11417,7 +11497,7 @@ module Aws::S3
|
|
11417
11497
|
#
|
11418
11498
|
#
|
11419
11499
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
11420
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
11500
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
11421
11501
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
11422
11502
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
11423
11503
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
@@ -11436,7 +11516,7 @@ module Aws::S3
|
|
11436
11516
|
# requests are not supported. Directory bucket names must be unique in
|
11437
11517
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11438
11518
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11439
|
-
#
|
11519
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
11440
11520
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11441
11521
|
# *Amazon S3 User Guide*.
|
11442
11522
|
#
|
@@ -11456,14 +11536,14 @@ module Aws::S3
|
|
11456
11536
|
#
|
11457
11537
|
# </note>
|
11458
11538
|
#
|
11459
|
-
# **S3 on Outposts** - When you use this action with
|
11460
|
-
#
|
11461
|
-
#
|
11539
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
11540
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
11541
|
+
# Outposts hostname takes the form `
|
11462
11542
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
11463
|
-
# When you use this action with S3 on Outposts
|
11464
|
-
#
|
11465
|
-
#
|
11466
|
-
#
|
11543
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
11544
|
+
# must be the Outposts access point ARN or the access point alias. For
|
11545
|
+
# more information about S3 on Outposts, see [What is S3 on
|
11546
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
11467
11547
|
#
|
11468
11548
|
#
|
11469
11549
|
#
|
@@ -11735,7 +11815,8 @@ module Aws::S3
|
|
11735
11815
|
# resp.uploads[0].owner.id #=> String
|
11736
11816
|
# resp.uploads[0].initiator.id #=> String
|
11737
11817
|
# resp.uploads[0].initiator.display_name #=> String
|
11738
|
-
# resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
|
11818
|
+
# resp.uploads[0].checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
11819
|
+
# resp.uploads[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
11739
11820
|
# resp.common_prefixes #=> Array
|
11740
11821
|
# resp.common_prefixes[0].prefix #=> String
|
11741
11822
|
# resp.encoding_type #=> String, one of "url"
|
@@ -11953,7 +12034,8 @@ module Aws::S3
|
|
11953
12034
|
# resp.versions #=> Array
|
11954
12035
|
# resp.versions[0].etag #=> String
|
11955
12036
|
# resp.versions[0].checksum_algorithm #=> Array
|
11956
|
-
# resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
|
12037
|
+
# resp.versions[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12038
|
+
# resp.versions[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
11957
12039
|
# resp.versions[0].size #=> Integer
|
11958
12040
|
# resp.versions[0].storage_class #=> String, one of "STANDARD"
|
11959
12041
|
# resp.versions[0].key #=> String
|
@@ -12032,7 +12114,7 @@ module Aws::S3
|
|
12032
12114
|
# requests are not supported. Directory bucket names must be unique in
|
12033
12115
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12034
12116
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
12035
|
-
#
|
12117
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
12036
12118
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
12037
12119
|
# *Amazon S3 User Guide*.
|
12038
12120
|
#
|
@@ -12052,14 +12134,14 @@ module Aws::S3
|
|
12052
12134
|
#
|
12053
12135
|
# </note>
|
12054
12136
|
#
|
12055
|
-
# **S3 on Outposts** - When you use this action with
|
12056
|
-
#
|
12057
|
-
#
|
12137
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
12138
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
12139
|
+
# Outposts hostname takes the form `
|
12058
12140
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
12059
|
-
# When you use this action with S3 on Outposts
|
12060
|
-
#
|
12061
|
-
#
|
12062
|
-
#
|
12141
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
12142
|
+
# must be the Outposts access point ARN or the access point alias. For
|
12143
|
+
# more information about S3 on Outposts, see [What is S3 on
|
12144
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
12063
12145
|
#
|
12064
12146
|
#
|
12065
12147
|
#
|
@@ -12198,7 +12280,8 @@ module Aws::S3
|
|
12198
12280
|
# resp.contents[0].last_modified #=> Time
|
12199
12281
|
# resp.contents[0].etag #=> String
|
12200
12282
|
# resp.contents[0].checksum_algorithm #=> Array
|
12201
|
-
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
|
12283
|
+
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12284
|
+
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
12202
12285
|
# resp.contents[0].size #=> Integer
|
12203
12286
|
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
12204
12287
|
# resp.contents[0].owner.display_name #=> String
|
@@ -12243,13 +12326,13 @@ module Aws::S3
|
|
12243
12326
|
# * **Directory buckets** - For directory buckets, you must make
|
12244
12327
|
# requests for this API operation to the Zonal endpoint. These
|
12245
12328
|
# endpoints support virtual-hosted-style requests in the format
|
12246
|
-
# `https://bucket
|
12329
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
12247
12330
|
# `. Path-style requests are not supported. For more information about
|
12248
12331
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
12249
12332
|
# for directory buckets in Availability Zones][3] in the *Amazon S3
|
12250
12333
|
# User Guide*. For more information about endpoints in Local Zones,
|
12251
|
-
# see [
|
12252
|
-
# S3 User Guide*.
|
12334
|
+
# see [Concepts for directory buckets in Local Zones][4] in the
|
12335
|
+
# *Amazon S3 User Guide*.
|
12253
12336
|
#
|
12254
12337
|
# </note>
|
12255
12338
|
#
|
@@ -12307,7 +12390,7 @@ module Aws::S3
|
|
12307
12390
|
#
|
12308
12391
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
|
12309
12392
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
|
12310
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
12393
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
12311
12394
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12312
12395
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
12313
12396
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
@@ -12324,7 +12407,7 @@ module Aws::S3
|
|
12324
12407
|
# requests are not supported. Directory bucket names must be unique in
|
12325
12408
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12326
12409
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
12327
|
-
#
|
12410
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
12328
12411
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
12329
12412
|
# *Amazon S3 User Guide*.
|
12330
12413
|
#
|
@@ -12344,14 +12427,14 @@ module Aws::S3
|
|
12344
12427
|
#
|
12345
12428
|
# </note>
|
12346
12429
|
#
|
12347
|
-
# **S3 on Outposts** - When you use this action with
|
12348
|
-
#
|
12349
|
-
#
|
12430
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
12431
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
12432
|
+
# Outposts hostname takes the form `
|
12350
12433
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
12351
|
-
# When you use this action with S3 on Outposts
|
12352
|
-
#
|
12353
|
-
#
|
12354
|
-
#
|
12434
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
12435
|
+
# must be the Outposts access point ARN or the access point alias. For
|
12436
|
+
# more information about S3 on Outposts, see [What is S3 on
|
12437
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
12355
12438
|
#
|
12356
12439
|
#
|
12357
12440
|
#
|
@@ -12539,7 +12622,8 @@ module Aws::S3
|
|
12539
12622
|
# resp.contents[0].last_modified #=> Time
|
12540
12623
|
# resp.contents[0].etag #=> String
|
12541
12624
|
# resp.contents[0].checksum_algorithm #=> Array
|
12542
|
-
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
|
12625
|
+
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12626
|
+
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
12543
12627
|
# resp.contents[0].size #=> Integer
|
12544
12628
|
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
12545
12629
|
# resp.contents[0].owner.display_name #=> String
|
@@ -12591,13 +12675,13 @@ module Aws::S3
|
|
12591
12675
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
12592
12676
|
# for this API operation to the Zonal endpoint. These endpoints support
|
12593
12677
|
# virtual-hosted-style requests in the format
|
12594
|
-
# `https://bucket
|
12678
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
12595
12679
|
# `. Path-style requests are not supported. For more information about
|
12596
12680
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
12597
12681
|
# directory buckets in Availability Zones][3] in the *Amazon S3 User
|
12598
12682
|
# Guide*. For more information about endpoints in Local Zones, see
|
12599
|
-
# [
|
12600
|
-
# Guide*.
|
12683
|
+
# [Concepts for directory buckets in Local Zones][4] in the *Amazon S3
|
12684
|
+
# User Guide*.
|
12601
12685
|
#
|
12602
12686
|
# </note>
|
12603
12687
|
#
|
@@ -12651,7 +12735,7 @@ module Aws::S3
|
|
12651
12735
|
#
|
12652
12736
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
12653
12737
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
12654
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
12738
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
12655
12739
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
12656
12740
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
12657
12741
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
@@ -12670,7 +12754,7 @@ module Aws::S3
|
|
12670
12754
|
# requests are not supported. Directory bucket names must be unique in
|
12671
12755
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
12672
12756
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
12673
|
-
#
|
12757
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
12674
12758
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
12675
12759
|
# *Amazon S3 User Guide*.
|
12676
12760
|
#
|
@@ -12690,14 +12774,14 @@ module Aws::S3
|
|
12690
12774
|
#
|
12691
12775
|
# </note>
|
12692
12776
|
#
|
12693
|
-
# **S3 on Outposts** - When you use this action with
|
12694
|
-
#
|
12695
|
-
#
|
12777
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
12778
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
12779
|
+
# Outposts hostname takes the form `
|
12696
12780
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
12697
|
-
# When you use this action with S3 on Outposts
|
12698
|
-
#
|
12699
|
-
#
|
12700
|
-
#
|
12781
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
12782
|
+
# must be the Outposts access point ARN or the access point alias. For
|
12783
|
+
# more information about S3 on Outposts, see [What is S3 on
|
12784
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
12701
12785
|
#
|
12702
12786
|
#
|
12703
12787
|
#
|
@@ -12800,6 +12884,7 @@ module Aws::S3
|
|
12800
12884
|
# * {Types::ListPartsOutput#storage_class #storage_class} => String
|
12801
12885
|
# * {Types::ListPartsOutput#request_charged #request_charged} => String
|
12802
12886
|
# * {Types::ListPartsOutput#checksum_algorithm #checksum_algorithm} => String
|
12887
|
+
# * {Types::ListPartsOutput#checksum_type #checksum_type} => String
|
12803
12888
|
#
|
12804
12889
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
12805
12890
|
#
|
@@ -12874,6 +12959,7 @@ module Aws::S3
|
|
12874
12959
|
# resp.parts[0].size #=> Integer
|
12875
12960
|
# resp.parts[0].checksum_crc32 #=> String
|
12876
12961
|
# resp.parts[0].checksum_crc32c #=> String
|
12962
|
+
# resp.parts[0].checksum_crc64nvme #=> String
|
12877
12963
|
# resp.parts[0].checksum_sha1 #=> String
|
12878
12964
|
# resp.parts[0].checksum_sha256 #=> String
|
12879
12965
|
# resp.initiator.id #=> String
|
@@ -12882,7 +12968,8 @@ module Aws::S3
|
|
12882
12968
|
# resp.owner.id #=> String
|
12883
12969
|
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
12884
12970
|
# resp.request_charged #=> String, one of "requester"
|
12885
|
-
# resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256"
|
12971
|
+
# resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12972
|
+
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
12886
12973
|
#
|
12887
12974
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts AWS API Documentation
|
12888
12975
|
#
|
@@ -12955,7 +13042,7 @@ module Aws::S3
|
|
12955
13042
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
12956
13043
|
#
|
12957
13044
|
# @option params [String] :checksum_algorithm
|
12958
|
-
# Indicates the algorithm used to create the checksum for the
|
13045
|
+
# Indicates the algorithm used to create the checksum for the request
|
12959
13046
|
# when you use the SDK. This header will not provide any additional
|
12960
13047
|
# functionality if you don't use the SDK. When you send this header,
|
12961
13048
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -12980,7 +13067,7 @@ module Aws::S3
|
|
12980
13067
|
# status: "Enabled", # accepts Enabled, Suspended
|
12981
13068
|
# },
|
12982
13069
|
# expected_bucket_owner: "AccountId",
|
12983
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
13070
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
12984
13071
|
# })
|
12985
13072
|
#
|
12986
13073
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfiguration AWS API Documentation
|
@@ -13176,9 +13263,10 @@ module Aws::S3
|
|
13176
13263
|
# The bucket to which to apply the ACL.
|
13177
13264
|
#
|
13178
13265
|
# @option params [String] :content_md5
|
13179
|
-
# The
|
13180
|
-
# used as a message integrity check to verify that the request body
|
13181
|
-
# not corrupted in transit. For more information, go to [RFC
|
13266
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. This header must
|
13267
|
+
# be used as a message integrity check to verify that the request body
|
13268
|
+
# was not corrupted in transit. For more information, go to [RFC
|
13269
|
+
# 1864.][1]
|
13182
13270
|
#
|
13183
13271
|
# For requests made using the Amazon Web Services Command Line Interface
|
13184
13272
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
@@ -13189,7 +13277,7 @@ module Aws::S3
|
|
13189
13277
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
13190
13278
|
#
|
13191
13279
|
# @option params [String] :checksum_algorithm
|
13192
|
-
# Indicates the algorithm used to create the checksum for the
|
13280
|
+
# Indicates the algorithm used to create the checksum for the request
|
13193
13281
|
# when you use the SDK. This header will not provide any additional
|
13194
13282
|
# functionality if you don't use the SDK. When you send this header,
|
13195
13283
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -13267,7 +13355,7 @@ module Aws::S3
|
|
13267
13355
|
# },
|
13268
13356
|
# bucket: "BucketName", # required
|
13269
13357
|
# content_md5: "ContentMD5",
|
13270
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
13358
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
13271
13359
|
# grant_full_control: "GrantFullControl",
|
13272
13360
|
# grant_read: "GrantRead",
|
13273
13361
|
# grant_read_acp: "GrantReadACP",
|
@@ -13491,9 +13579,10 @@ module Aws::S3
|
|
13491
13579
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
13492
13580
|
#
|
13493
13581
|
# @option params [String] :content_md5
|
13494
|
-
# The
|
13495
|
-
# used as a message integrity check to verify that the request body
|
13496
|
-
# not corrupted in transit. For more information, go to [RFC
|
13582
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. This header must
|
13583
|
+
# be used as a message integrity check to verify that the request body
|
13584
|
+
# was not corrupted in transit. For more information, go to [RFC
|
13585
|
+
# 1864.][1]
|
13497
13586
|
#
|
13498
13587
|
# For requests made using the Amazon Web Services Command Line Interface
|
13499
13588
|
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
@@ -13504,7 +13593,7 @@ module Aws::S3
|
|
13504
13593
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
13505
13594
|
#
|
13506
13595
|
# @option params [String] :checksum_algorithm
|
13507
|
-
# Indicates the algorithm used to create the checksum for the
|
13596
|
+
# Indicates the algorithm used to create the checksum for the request
|
13508
13597
|
# when you use the SDK. This header will not provide any additional
|
13509
13598
|
# functionality if you don't use the SDK. When you send this header,
|
13510
13599
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -13587,7 +13676,7 @@ module Aws::S3
|
|
13587
13676
|
# ],
|
13588
13677
|
# },
|
13589
13678
|
# content_md5: "ContentMD5",
|
13590
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
13679
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
13591
13680
|
# expected_bucket_owner: "AccountId",
|
13592
13681
|
# })
|
13593
13682
|
#
|
@@ -13611,7 +13700,7 @@ module Aws::S3
|
|
13611
13700
|
# about endpoints in Availability Zones, see [Regional and Zonal
|
13612
13701
|
# endpoints for directory buckets in Availability Zones][1] in the
|
13613
13702
|
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
13614
|
-
# Zones, see [
|
13703
|
+
# Zones, see [Concepts for directory buckets in Local Zones][2] in the
|
13615
13704
|
# *Amazon S3 User Guide*.
|
13616
13705
|
#
|
13617
13706
|
# </note>
|
@@ -13648,8 +13737,8 @@ module Aws::S3
|
|
13648
13737
|
# object uploads][5].
|
13649
13738
|
#
|
13650
13739
|
# * Your SSE-KMS configuration can only support 1 [customer managed
|
13651
|
-
# key][6] per directory bucket
|
13652
|
-
#
|
13740
|
+
# key][6] per directory bucket's lifetime. The [Amazon Web Services
|
13741
|
+
# managed key][7] (`aws/s3`) isn't supported.
|
13653
13742
|
#
|
13654
13743
|
# * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
|
13655
13744
|
# in a directory bucket and can’t be disabled. S3 Bucket Keys
|
@@ -13719,7 +13808,7 @@ module Aws::S3
|
|
13719
13808
|
#
|
13720
13809
|
#
|
13721
13810
|
#
|
13722
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
13811
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
13723
13812
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
13724
13813
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
13725
13814
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
@@ -13757,7 +13846,7 @@ module Aws::S3
|
|
13757
13846
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
|
13758
13847
|
#
|
13759
13848
|
# @option params [String] :content_md5
|
13760
|
-
# The
|
13849
|
+
# The Base64 encoded 128-bit `MD5` digest of the server-side encryption
|
13761
13850
|
# configuration.
|
13762
13851
|
#
|
13763
13852
|
# For requests made using the Amazon Web Services Command Line Interface
|
@@ -13769,7 +13858,7 @@ module Aws::S3
|
|
13769
13858
|
# </note>
|
13770
13859
|
#
|
13771
13860
|
# @option params [String] :checksum_algorithm
|
13772
|
-
# Indicates the algorithm used to create the checksum for the
|
13861
|
+
# Indicates the algorithm used to create the checksum for the request
|
13773
13862
|
# when you use the SDK. This header will not provide any additional
|
13774
13863
|
# functionality if you don't use the SDK. When you send this header,
|
13775
13864
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -13810,7 +13899,7 @@ module Aws::S3
|
|
13810
13899
|
# resp = client.put_bucket_encryption({
|
13811
13900
|
# bucket: "BucketName", # required
|
13812
13901
|
# content_md5: "ContentMD5",
|
13813
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
13902
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
13814
13903
|
# server_side_encryption_configuration: { # required
|
13815
13904
|
# rules: [ # required
|
13816
13905
|
# {
|
@@ -14111,6 +14200,10 @@ module Aws::S3
|
|
14111
14200
|
req.send_request(options)
|
14112
14201
|
end
|
14113
14202
|
|
14203
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
14204
|
+
#
|
14205
|
+
# </note>
|
14206
|
+
#
|
14114
14207
|
# For an updated version of this API, see
|
14115
14208
|
# [PutBucketLifecycleConfiguration][1]. This version has been
|
14116
14209
|
# deprecated. Existing lifecycle configurations will work. For new
|
@@ -14189,7 +14282,7 @@ module Aws::S3
|
|
14189
14282
|
# automatically.
|
14190
14283
|
#
|
14191
14284
|
# @option params [String] :checksum_algorithm
|
14192
|
-
# Indicates the algorithm used to create the checksum for the
|
14285
|
+
# Indicates the algorithm used to create the checksum for the request
|
14193
14286
|
# when you use the SDK. This header will not provide any additional
|
14194
14287
|
# functionality if you don't use the SDK. When you send this header,
|
14195
14288
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -14218,7 +14311,7 @@ module Aws::S3
|
|
14218
14311
|
# resp = client.put_bucket_lifecycle({
|
14219
14312
|
# bucket: "BucketName", # required
|
14220
14313
|
# content_md5: "ContentMD5",
|
14221
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
14314
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
14222
14315
|
# lifecycle_configuration: {
|
14223
14316
|
# rules: [ # required
|
14224
14317
|
# {
|
@@ -14364,8 +14457,8 @@ module Aws::S3
|
|
14364
14457
|
# information about endpoints in Availability Zones, see [Regional
|
14365
14458
|
# and Zonal endpoints for directory buckets in Availability
|
14366
14459
|
# Zones][7] in the *Amazon S3 User Guide*. For more information
|
14367
|
-
# about endpoints in Local Zones, see [
|
14368
|
-
#
|
14460
|
+
# about endpoints in Local Zones, see [Concepts for directory
|
14461
|
+
# buckets in Local Zones][8] in the *Amazon S3 User Guide*.
|
14369
14462
|
#
|
14370
14463
|
# </note>
|
14371
14464
|
#
|
@@ -14387,7 +14480,7 @@ module Aws::S3
|
|
14387
14480
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
|
14388
14481
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
14389
14482
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
14390
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
14483
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
14391
14484
|
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
14392
14485
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
14393
14486
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
|
@@ -14396,7 +14489,7 @@ module Aws::S3
|
|
14396
14489
|
# The name of the bucket for which to set the configuration.
|
14397
14490
|
#
|
14398
14491
|
# @option params [String] :checksum_algorithm
|
14399
|
-
# Indicates the algorithm used to create the checksum for the
|
14492
|
+
# Indicates the algorithm used to create the checksum for the request
|
14400
14493
|
# when you use the SDK. This header will not provide any additional
|
14401
14494
|
# functionality if you don't use the SDK. When you send this header,
|
14402
14495
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -14483,7 +14576,7 @@ module Aws::S3
|
|
14483
14576
|
#
|
14484
14577
|
# resp = client.put_bucket_lifecycle_configuration({
|
14485
14578
|
# bucket: "BucketName", # required
|
14486
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
14579
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
14487
14580
|
# lifecycle_configuration: {
|
14488
14581
|
# rules: [ # required
|
14489
14582
|
# {
|
@@ -14649,7 +14742,7 @@ module Aws::S3
|
|
14649
14742
|
# automatically.
|
14650
14743
|
#
|
14651
14744
|
# @option params [String] :checksum_algorithm
|
14652
|
-
# Indicates the algorithm used to create the checksum for the
|
14745
|
+
# Indicates the algorithm used to create the checksum for the request
|
14653
14746
|
# when you use the SDK. This header will not provide any additional
|
14654
14747
|
# functionality if you don't use the SDK. When you send this header,
|
14655
14748
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -14726,7 +14819,7 @@ module Aws::S3
|
|
14726
14819
|
# },
|
14727
14820
|
# },
|
14728
14821
|
# content_md5: "ContentMD5",
|
14729
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
14822
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
14730
14823
|
# expected_bucket_owner: "AccountId",
|
14731
14824
|
# })
|
14732
14825
|
#
|
@@ -14865,7 +14958,7 @@ module Aws::S3
|
|
14865
14958
|
# automatically.
|
14866
14959
|
#
|
14867
14960
|
# @option params [String] :checksum_algorithm
|
14868
|
-
# Indicates the algorithm used to create the checksum for the
|
14961
|
+
# Indicates the algorithm used to create the checksum for the request
|
14869
14962
|
# when you use the SDK. This header will not provide any additional
|
14870
14963
|
# functionality if you don't use the SDK. When you send this header,
|
14871
14964
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -14895,7 +14988,7 @@ module Aws::S3
|
|
14895
14988
|
# resp = client.put_bucket_notification({
|
14896
14989
|
# bucket: "BucketName", # required
|
14897
14990
|
# content_md5: "ContentMD5",
|
14898
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
14991
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
14899
14992
|
# notification_configuration: { # required
|
14900
14993
|
# topic_configuration: {
|
14901
14994
|
# id: "NotificationId",
|
@@ -15192,7 +15285,7 @@ module Aws::S3
|
|
15192
15285
|
# about endpoints in Availability Zones, see [Regional and Zonal
|
15193
15286
|
# endpoints for directory buckets in Availability Zones][1] in the
|
15194
15287
|
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
15195
|
-
# Zones, see [
|
15288
|
+
# Zones, see [Concepts for directory buckets in Local Zones][2] in the
|
15196
15289
|
# *Amazon S3 User Guide*.
|
15197
15290
|
#
|
15198
15291
|
# </note>
|
@@ -15256,7 +15349,7 @@ module Aws::S3
|
|
15256
15349
|
#
|
15257
15350
|
#
|
15258
15351
|
#
|
15259
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
15352
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
15260
15353
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
15261
15354
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
|
15262
15355
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
@@ -15295,7 +15388,7 @@ module Aws::S3
|
|
15295
15388
|
# </note>
|
15296
15389
|
#
|
15297
15390
|
# @option params [String] :checksum_algorithm
|
15298
|
-
# Indicates the algorithm used to create the checksum for the
|
15391
|
+
# Indicates the algorithm used to create the checksum for the request
|
15299
15392
|
# when you use the SDK. This header will not provide any additional
|
15300
15393
|
# functionality if you don't use the SDK. When you send this header,
|
15301
15394
|
# there must be a corresponding `x-amz-checksum-algorithm ` or
|
@@ -15305,22 +15398,23 @@ module Aws::S3
|
|
15305
15398
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
15306
15399
|
# the supported algorithm from the following list:
|
15307
15400
|
#
|
15308
|
-
# * `
|
15401
|
+
# * `CRC-32`
|
15309
15402
|
#
|
15310
|
-
# * `
|
15403
|
+
# * `CRC-32C`
|
15311
15404
|
#
|
15312
|
-
# * `
|
15405
|
+
# * `CRC-64NVME`
|
15313
15406
|
#
|
15314
|
-
# * `
|
15407
|
+
# * `SHA-1`
|
15408
|
+
#
|
15409
|
+
# * `SHA-256`
|
15315
15410
|
#
|
15316
15411
|
# For more information, see [Checking object integrity][1] in the
|
15317
15412
|
# *Amazon S3 User Guide*.
|
15318
15413
|
#
|
15319
15414
|
# If the individual checksum value you provide through
|
15320
15415
|
# `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
|
15321
|
-
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3
|
15322
|
-
#
|
15323
|
-
# that matches the provided value in `x-amz-checksum-algorithm `.
|
15416
|
+
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
|
15417
|
+
# request with a `BadDigest` error.
|
15324
15418
|
#
|
15325
15419
|
# <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
|
15326
15420
|
# is the default checksum algorithm that's used for performance.
|
@@ -15373,7 +15467,7 @@ module Aws::S3
|
|
15373
15467
|
# resp = client.put_bucket_policy({
|
15374
15468
|
# bucket: "BucketName", # required
|
15375
15469
|
# content_md5: "ContentMD5",
|
15376
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
15470
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
15377
15471
|
# confirm_remove_self_bucket_access: false,
|
15378
15472
|
# policy: "Policy", # required
|
15379
15473
|
# expected_bucket_owner: "AccountId",
|
@@ -15479,7 +15573,7 @@ module Aws::S3
|
|
15479
15573
|
# The name of the bucket
|
15480
15574
|
#
|
15481
15575
|
# @option params [String] :content_md5
|
15482
|
-
# The
|
15576
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. You must use this
|
15483
15577
|
# header as a message integrity check to verify that the request body
|
15484
15578
|
# was not corrupted in transit. For more information, see [RFC 1864][1].
|
15485
15579
|
#
|
@@ -15492,7 +15586,7 @@ module Aws::S3
|
|
15492
15586
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
15493
15587
|
#
|
15494
15588
|
# @option params [String] :checksum_algorithm
|
15495
|
-
# Indicates the algorithm used to create the checksum for the
|
15589
|
+
# Indicates the algorithm used to create the checksum for the request
|
15496
15590
|
# when you use the SDK. This header will not provide any additional
|
15497
15591
|
# functionality if you don't use the SDK. When you send this header,
|
15498
15592
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -15548,7 +15642,7 @@ module Aws::S3
|
|
15548
15642
|
# resp = client.put_bucket_replication({
|
15549
15643
|
# bucket: "BucketName", # required
|
15550
15644
|
# content_md5: "ContentMD5",
|
15551
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
15645
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
15552
15646
|
# replication_configuration: { # required
|
15553
15647
|
# role: "Role", # required
|
15554
15648
|
# rules: [ # required
|
@@ -15652,7 +15746,7 @@ module Aws::S3
|
|
15652
15746
|
# The bucket name.
|
15653
15747
|
#
|
15654
15748
|
# @option params [String] :content_md5
|
15655
|
-
# The
|
15749
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. You must use this
|
15656
15750
|
# header as a message integrity check to verify that the request body
|
15657
15751
|
# was not corrupted in transit. For more information, see [RFC 1864][1].
|
15658
15752
|
#
|
@@ -15665,7 +15759,7 @@ module Aws::S3
|
|
15665
15759
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
15666
15760
|
#
|
15667
15761
|
# @option params [String] :checksum_algorithm
|
15668
|
-
# Indicates the algorithm used to create the checksum for the
|
15762
|
+
# Indicates the algorithm used to create the checksum for the request
|
15669
15763
|
# when you use the SDK. This header will not provide any additional
|
15670
15764
|
# functionality if you don't use the SDK. When you send this header,
|
15671
15765
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -15707,7 +15801,7 @@ module Aws::S3
|
|
15707
15801
|
# resp = client.put_bucket_request_payment({
|
15708
15802
|
# bucket: "BucketName", # required
|
15709
15803
|
# content_md5: "ContentMD5",
|
15710
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
15804
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
15711
15805
|
# request_payment_configuration: { # required
|
15712
15806
|
# payer: "Requester", # required, accepts Requester, BucketOwner
|
15713
15807
|
# },
|
@@ -15789,7 +15883,7 @@ module Aws::S3
|
|
15789
15883
|
# The bucket name.
|
15790
15884
|
#
|
15791
15885
|
# @option params [String] :content_md5
|
15792
|
-
# The
|
15886
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. You must use this
|
15793
15887
|
# header as a message integrity check to verify that the request body
|
15794
15888
|
# was not corrupted in transit. For more information, see [RFC 1864][1].
|
15795
15889
|
#
|
@@ -15802,7 +15896,7 @@ module Aws::S3
|
|
15802
15896
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
15803
15897
|
#
|
15804
15898
|
# @option params [String] :checksum_algorithm
|
15805
|
-
# Indicates the algorithm used to create the checksum for the
|
15899
|
+
# Indicates the algorithm used to create the checksum for the request
|
15806
15900
|
# when you use the SDK. This header will not provide any additional
|
15807
15901
|
# functionality if you don't use the SDK. When you send this header,
|
15808
15902
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -15853,7 +15947,7 @@ module Aws::S3
|
|
15853
15947
|
# resp = client.put_bucket_tagging({
|
15854
15948
|
# bucket: "BucketName", # required
|
15855
15949
|
# content_md5: "ContentMD5",
|
15856
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
15950
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
15857
15951
|
# tagging: { # required
|
15858
15952
|
# tag_set: [ # required
|
15859
15953
|
# {
|
@@ -15880,10 +15974,10 @@ module Aws::S3
|
|
15880
15974
|
#
|
15881
15975
|
# <note markdown="1"> When you enable versioning on a bucket for the first time, it might
|
15882
15976
|
# take a short amount of time for the change to be fully propagated.
|
15883
|
-
# While this change is propagating, you
|
15884
|
-
# 404 NoSuchKey` errors for requests to objects created or updated
|
15885
|
-
# enabling versioning. We recommend that you wait for 15 minutes
|
15886
|
-
# enabling versioning before issuing write operations (`PUT` or
|
15977
|
+
# While this change is propagating, you might encounter intermittent
|
15978
|
+
# `HTTP 404 NoSuchKey` errors for requests to objects created or updated
|
15979
|
+
# after enabling versioning. We recommend that you wait for 15 minutes
|
15980
|
+
# after enabling versioning before issuing write operations (`PUT` or
|
15887
15981
|
# `DELETE`) on objects in the bucket.
|
15888
15982
|
#
|
15889
15983
|
# </note>
|
@@ -15936,7 +16030,7 @@ module Aws::S3
|
|
15936
16030
|
# The bucket name.
|
15937
16031
|
#
|
15938
16032
|
# @option params [String] :content_md5
|
15939
|
-
# >The
|
16033
|
+
# >The Base64 encoded 128-bit `MD5` digest of the data. You must use
|
15940
16034
|
# this header as a message integrity check to verify that the request
|
15941
16035
|
# body was not corrupted in transit. For more information, see [RFC
|
15942
16036
|
# 1864][1].
|
@@ -15950,7 +16044,7 @@ module Aws::S3
|
|
15950
16044
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
15951
16045
|
#
|
15952
16046
|
# @option params [String] :checksum_algorithm
|
15953
|
-
# Indicates the algorithm used to create the checksum for the
|
16047
|
+
# Indicates the algorithm used to create the checksum for the request
|
15954
16048
|
# when you use the SDK. This header will not provide any additional
|
15955
16049
|
# functionality if you don't use the SDK. When you send this header,
|
15956
16050
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -15997,7 +16091,7 @@ module Aws::S3
|
|
15997
16091
|
# resp = client.put_bucket_versioning({
|
15998
16092
|
# bucket: "BucketName", # required
|
15999
16093
|
# content_md5: "ContentMD5",
|
16000
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
16094
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
16001
16095
|
# mfa: "MFA",
|
16002
16096
|
# versioning_configuration: { # required
|
16003
16097
|
# mfa_delete: "Enabled", # accepts Enabled, Disabled
|
@@ -16098,7 +16192,7 @@ module Aws::S3
|
|
16098
16192
|
# The bucket name.
|
16099
16193
|
#
|
16100
16194
|
# @option params [String] :content_md5
|
16101
|
-
# The
|
16195
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. You must use this
|
16102
16196
|
# header as a message integrity check to verify that the request body
|
16103
16197
|
# was not corrupted in transit. For more information, see [RFC 1864][1].
|
16104
16198
|
#
|
@@ -16111,7 +16205,7 @@ module Aws::S3
|
|
16111
16205
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
16112
16206
|
#
|
16113
16207
|
# @option params [String] :checksum_algorithm
|
16114
|
-
# Indicates the algorithm used to create the checksum for the
|
16208
|
+
# Indicates the algorithm used to create the checksum for the request
|
16115
16209
|
# when you use the SDK. This header will not provide any additional
|
16116
16210
|
# functionality if you don't use the SDK. When you send this header,
|
16117
16211
|
# there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
|
@@ -16159,7 +16253,7 @@ module Aws::S3
|
|
16159
16253
|
# resp = client.put_bucket_website({
|
16160
16254
|
# bucket: "BucketName", # required
|
16161
16255
|
# content_md5: "ContentMD5",
|
16162
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
16256
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
16163
16257
|
# website_configuration: { # required
|
16164
16258
|
# error_document: {
|
16165
16259
|
# key: "ObjectKey", # required
|
@@ -16215,13 +16309,13 @@ module Aws::S3
|
|
16215
16309
|
# * **Directory buckets** - For directory buckets, you must make
|
16216
16310
|
# requests for this API operation to the Zonal endpoint. These
|
16217
16311
|
# endpoints support virtual-hosted-style requests in the format
|
16218
|
-
# `https://bucket
|
16312
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
16219
16313
|
# `. Path-style requests are not supported. For more information about
|
16220
16314
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints
|
16221
16315
|
# for directory buckets in Availability Zones][1] in the *Amazon S3
|
16222
16316
|
# User Guide*. For more information about endpoints in Local Zones,
|
16223
|
-
# see [
|
16224
|
-
# S3 User Guide*.
|
16317
|
+
# see [Concepts for directory buckets in Local Zones][2] in the
|
16318
|
+
# *Amazon S3 User Guide*.
|
16225
16319
|
#
|
16226
16320
|
# </note>
|
16227
16321
|
#
|
@@ -16238,6 +16332,23 @@ module Aws::S3
|
|
16238
16332
|
#
|
16239
16333
|
# </note>
|
16240
16334
|
#
|
16335
|
+
# * **If-None-Match** - Uploads the object only if the object key name
|
16336
|
+
# does not already exist in the specified bucket. Otherwise, Amazon S3
|
16337
|
+
# returns a `412 Precondition Failed` error. If a conflicting
|
16338
|
+
# operation occurs during the upload, S3 returns a `409
|
16339
|
+
# ConditionalRequestConflict` response. On a 409 failure, retry the
|
16340
|
+
# upload.
|
16341
|
+
#
|
16342
|
+
# Expects the * character (asterisk).
|
16343
|
+
#
|
16344
|
+
# For more information, see [Add preconditions to S3 operations with
|
16345
|
+
# conditional requests][4] in the *Amazon S3 User Guide* or [RFC
|
16346
|
+
# 7232][5].
|
16347
|
+
#
|
16348
|
+
# <note markdown="1"> This functionality is not supported for S3 on Outposts.
|
16349
|
+
#
|
16350
|
+
# </note>
|
16351
|
+
#
|
16241
16352
|
# * **S3 Versioning** - When you enable versioning for a bucket, if
|
16242
16353
|
# Amazon S3 receives multiple write requests for the same object
|
16243
16354
|
# simultaneously, it stores all versions of the objects. For each
|
@@ -16245,9 +16356,9 @@ module Aws::S3
|
|
16245
16356
|
# automatically generates a unique version ID of that object being
|
16246
16357
|
# stored in Amazon S3. You can retrieve, replace, or delete any
|
16247
16358
|
# version of the object. For more information about versioning, see
|
16248
|
-
# [Adding Objects to Versioning-Enabled Buckets][
|
16359
|
+
# [Adding Objects to Versioning-Enabled Buckets][6] in the *Amazon S3
|
16249
16360
|
# User Guide*. For information about returning the versioning state of
|
16250
|
-
# a bucket, see [GetBucketVersioning][
|
16361
|
+
# a bucket, see [GetBucketVersioning][7].
|
16251
16362
|
#
|
16252
16363
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
16253
16364
|
#
|
@@ -16271,7 +16382,7 @@ module Aws::S3
|
|
16271
16382
|
# `s3:PutObjectTagging`.
|
16272
16383
|
# * **Directory bucket permissions** - To grant access to this API
|
16273
16384
|
# operation on a directory bucket, we recommend that you use the [
|
16274
|
-
# `CreateSession` ][
|
16385
|
+
# `CreateSession` ][8] API operation for session-based
|
16275
16386
|
# authorization. Specifically, you grant the
|
16276
16387
|
# `s3express:CreateSession` permission to the directory bucket in a
|
16277
16388
|
# bucket policy or an IAM identity-based policy. Then, you make the
|
@@ -16282,7 +16393,7 @@ module Aws::S3
|
|
16282
16393
|
# token for use. Amazon Web Services CLI or SDKs create session and
|
16283
16394
|
# refresh the session token automatically to avoid service
|
16284
16395
|
# interruptions when a session expires. For more information about
|
16285
|
-
# authorization, see [ `CreateSession` ][
|
16396
|
+
# authorization, see [ `CreateSession` ][8].
|
16286
16397
|
#
|
16287
16398
|
# If the object is encrypted with SSE-KMS, you must also have the
|
16288
16399
|
# `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
|
@@ -16307,20 +16418,22 @@ module Aws::S3
|
|
16307
16418
|
#
|
16308
16419
|
# For more information about related Amazon S3 APIs, see the following:
|
16309
16420
|
#
|
16310
|
-
# * [CopyObject][
|
16421
|
+
# * [CopyObject][9]
|
16311
16422
|
#
|
16312
|
-
# * [DeleteObject][
|
16423
|
+
# * [DeleteObject][10]
|
16313
16424
|
#
|
16314
16425
|
#
|
16315
16426
|
#
|
16316
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
16427
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
16317
16428
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
16318
16429
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
|
16319
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
16320
|
-
# [5]: https://
|
16321
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
16322
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
16323
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
16430
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
16431
|
+
# [5]: https://datatracker.ietf.org/doc/rfc7232/
|
16432
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
|
16433
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
16434
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
16435
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
16436
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
16324
16437
|
#
|
16325
16438
|
# @option params [String] :acl
|
16326
16439
|
# The canned ACL to apply to the object. For more information, see
|
@@ -16372,7 +16485,7 @@ module Aws::S3
|
|
16372
16485
|
# requests are not supported. Directory bucket names must be unique in
|
16373
16486
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
16374
16487
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
16375
|
-
#
|
16488
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
16376
16489
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
16377
16490
|
# *Amazon S3 User Guide*.
|
16378
16491
|
#
|
@@ -16392,14 +16505,14 @@ module Aws::S3
|
|
16392
16505
|
#
|
16393
16506
|
# </note>
|
16394
16507
|
#
|
16395
|
-
# **S3 on Outposts** - When you use this action with
|
16396
|
-
#
|
16397
|
-
#
|
16508
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
16509
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
16510
|
+
# Outposts hostname takes the form `
|
16398
16511
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
16399
|
-
# When you use this action with S3 on Outposts
|
16400
|
-
#
|
16401
|
-
#
|
16402
|
-
#
|
16512
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
16513
|
+
# must be the Outposts access point ARN or the access point alias. For
|
16514
|
+
# more information about S3 on Outposts, see [What is S3 on
|
16515
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
16403
16516
|
#
|
16404
16517
|
#
|
16405
16518
|
#
|
@@ -16448,7 +16561,7 @@ module Aws::S3
|
|
16448
16561
|
# [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
|
16449
16562
|
#
|
16450
16563
|
# @option params [String] :content_md5
|
16451
|
-
# The
|
16564
|
+
# The Base64 encoded 128-bit `MD5` digest of the message (without the
|
16452
16565
|
# headers) according to RFC 1864. This header can be used as a message
|
16453
16566
|
# integrity check to verify that the data is the same data that was
|
16454
16567
|
# originally sent. Although it is optional, we recommend using the
|
@@ -16493,22 +16606,23 @@ module Aws::S3
|
|
16493
16606
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
16494
16607
|
# the supported algorithm from the following list:
|
16495
16608
|
#
|
16496
|
-
# * `
|
16609
|
+
# * `CRC-32`
|
16610
|
+
#
|
16611
|
+
# * `CRC-32C`
|
16497
16612
|
#
|
16498
|
-
# * `
|
16613
|
+
# * `CRC-64NVME`
|
16499
16614
|
#
|
16500
|
-
# * `
|
16615
|
+
# * `SHA-1`
|
16501
16616
|
#
|
16502
|
-
# * `
|
16617
|
+
# * `SHA-256`
|
16503
16618
|
#
|
16504
16619
|
# For more information, see [Checking object integrity][1] in the
|
16505
16620
|
# *Amazon S3 User Guide*.
|
16506
16621
|
#
|
16507
16622
|
# If the individual checksum value you provide through
|
16508
16623
|
# `x-amz-checksum-algorithm ` doesn't match the checksum algorithm you
|
16509
|
-
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3
|
16510
|
-
#
|
16511
|
-
# that matches the provided value in `x-amz-checksum-algorithm `.
|
16624
|
+
# set through `x-amz-sdk-checksum-algorithm`, Amazon S3 fails the
|
16625
|
+
# request with a `BadDigest` error.
|
16512
16626
|
#
|
16513
16627
|
# <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
|
16514
16628
|
# for any request to upload an object with a retention period configured
|
@@ -16529,7 +16643,7 @@ module Aws::S3
|
|
16529
16643
|
# @option params [String] :checksum_crc32
|
16530
16644
|
# This header can be used as a data integrity check to verify that the
|
16531
16645
|
# data received is the same data that was originally sent. This header
|
16532
|
-
# specifies the
|
16646
|
+
# specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
|
16533
16647
|
# For more information, see [Checking object integrity][1] in the
|
16534
16648
|
# *Amazon S3 User Guide*.
|
16535
16649
|
#
|
@@ -16540,7 +16654,7 @@ module Aws::S3
|
|
16540
16654
|
# @option params [String] :checksum_crc32c
|
16541
16655
|
# This header can be used as a data integrity check to verify that the
|
16542
16656
|
# data received is the same data that was originally sent. This header
|
16543
|
-
# specifies the
|
16657
|
+
# specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
|
16544
16658
|
# For more information, see [Checking object integrity][1] in the
|
16545
16659
|
# *Amazon S3 User Guide*.
|
16546
16660
|
#
|
@@ -16548,12 +16662,24 @@ module Aws::S3
|
|
16548
16662
|
#
|
16549
16663
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
16550
16664
|
#
|
16665
|
+
# @option params [String] :checksum_crc64nvme
|
16666
|
+
# This header can be used as a data integrity check to verify that the
|
16667
|
+
# data received is the same data that was originally sent. This header
|
16668
|
+
# specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
|
16669
|
+
# object. The `CRC-64NVME` checksum is always a full object checksum.
|
16670
|
+
# For more information, see [Checking object integrity in the Amazon S3
|
16671
|
+
# User Guide][1].
|
16672
|
+
#
|
16673
|
+
#
|
16674
|
+
#
|
16675
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
16676
|
+
#
|
16551
16677
|
# @option params [String] :checksum_sha1
|
16552
16678
|
# This header can be used as a data integrity check to verify that the
|
16553
16679
|
# data received is the same data that was originally sent. This header
|
16554
|
-
# specifies the
|
16555
|
-
# more information, see [Checking object integrity][1] in the
|
16556
|
-
# User Guide*.
|
16680
|
+
# specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
|
16681
|
+
# For more information, see [Checking object integrity][1] in the
|
16682
|
+
# *Amazon S3 User Guide*.
|
16557
16683
|
#
|
16558
16684
|
#
|
16559
16685
|
#
|
@@ -16562,7 +16688,7 @@ module Aws::S3
|
|
16562
16688
|
# @option params [String] :checksum_sha256
|
16563
16689
|
# This header can be used as a data integrity check to verify that the
|
16564
16690
|
# data received is the same data that was originally sent. This header
|
16565
|
-
# specifies the
|
16691
|
+
# specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
|
16566
16692
|
# For more information, see [Checking object integrity][1] in the
|
16567
16693
|
# *Amazon S3 User Guide*.
|
16568
16694
|
#
|
@@ -16828,20 +16954,17 @@ module Aws::S3
|
|
16828
16954
|
# `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
16829
16955
|
# Amazon Web Services managed key (`aws/s3`) to protect the data.
|
16830
16956
|
#
|
16831
|
-
# **Directory buckets** -
|
16832
|
-
#
|
16833
|
-
#
|
16834
|
-
#
|
16835
|
-
#
|
16836
|
-
# x-amz-server-side-encryption-aws-kms-key-id` header
|
16837
|
-
#
|
16838
|
-
#
|
16839
|
-
#
|
16840
|
-
#
|
16841
|
-
#
|
16842
|
-
# support 1 [customer managed key][1] per directory bucket for the
|
16843
|
-
# lifetime of the bucket. The [Amazon Web Services managed key][2]
|
16844
|
-
# (`aws/s3`) isn't supported.
|
16957
|
+
# **Directory buckets** - To encrypt data using SSE-KMS, it's
|
16958
|
+
# recommended to specify the `x-amz-server-side-encryption` header to
|
16959
|
+
# `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
|
16960
|
+
# header implicitly uses the bucket's default KMS customer managed key
|
16961
|
+
# ID. If you want to explicitly set the `
|
16962
|
+
# x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
|
16963
|
+
# bucket's default customer managed key (using key ID or ARN, not
|
16964
|
+
# alias). Your SSE-KMS configuration can only support 1 [customer
|
16965
|
+
# managed key][1] per directory bucket's lifetime. The [Amazon Web
|
16966
|
+
# Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
|
16967
|
+
# specification results in an HTTP `400 Bad Request` error.
|
16845
16968
|
#
|
16846
16969
|
#
|
16847
16970
|
#
|
@@ -16851,7 +16974,7 @@ module Aws::S3
|
|
16851
16974
|
# @option params [String] :ssekms_encryption_context
|
16852
16975
|
# Specifies the Amazon Web Services KMS Encryption Context as an
|
16853
16976
|
# additional encryption context to use for object encryption. The value
|
16854
|
-
# of this header is a Base64
|
16977
|
+
# of this header is a Base64 encoded string of a UTF-8 encoded JSON,
|
16855
16978
|
# which contains the encryption context as key-value pairs. This value
|
16856
16979
|
# is stored as object metadata and automatically gets passed on to
|
16857
16980
|
# Amazon Web Services KMS for future `GetObject` operations on this
|
@@ -16962,8 +17085,10 @@ module Aws::S3
|
|
16962
17085
|
# * {Types::PutObjectOutput#etag #etag} => String
|
16963
17086
|
# * {Types::PutObjectOutput#checksum_crc32 #checksum_crc32} => String
|
16964
17087
|
# * {Types::PutObjectOutput#checksum_crc32c #checksum_crc32c} => String
|
17088
|
+
# * {Types::PutObjectOutput#checksum_crc64nvme #checksum_crc64nvme} => String
|
16965
17089
|
# * {Types::PutObjectOutput#checksum_sha1 #checksum_sha1} => String
|
16966
17090
|
# * {Types::PutObjectOutput#checksum_sha256 #checksum_sha256} => String
|
17091
|
+
# * {Types::PutObjectOutput#checksum_type #checksum_type} => String
|
16967
17092
|
# * {Types::PutObjectOutput#server_side_encryption #server_side_encryption} => String
|
16968
17093
|
# * {Types::PutObjectOutput#version_id #version_id} => String
|
16969
17094
|
# * {Types::PutObjectOutput#sse_customer_algorithm #sse_customer_algorithm} => String
|
@@ -16975,26 +17100,6 @@ module Aws::S3
|
|
16975
17100
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
16976
17101
|
#
|
16977
17102
|
#
|
16978
|
-
# @example Example: To upload an object (specify optional headers)
|
16979
|
-
#
|
16980
|
-
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
16981
|
-
# # storage class and use server-side encryption.
|
16982
|
-
#
|
16983
|
-
# resp = client.put_object({
|
16984
|
-
# body: "HappyFace.jpg",
|
16985
|
-
# bucket: "examplebucket",
|
16986
|
-
# key: "HappyFace.jpg",
|
16987
|
-
# server_side_encryption: "AES256",
|
16988
|
-
# storage_class: "STANDARD_IA",
|
16989
|
-
# })
|
16990
|
-
#
|
16991
|
-
# resp.to_h outputs the following:
|
16992
|
-
# {
|
16993
|
-
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
16994
|
-
# server_side_encryption: "AES256",
|
16995
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
16996
|
-
# }
|
16997
|
-
#
|
16998
17103
|
# @example Example: To upload an object and specify server-side encryption and object tags
|
16999
17104
|
#
|
17000
17105
|
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
@@ -17036,22 +17141,20 @@ module Aws::S3
|
|
17036
17141
|
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
17037
17142
|
# }
|
17038
17143
|
#
|
17039
|
-
# @example Example: To
|
17144
|
+
# @example Example: To create an object.
|
17040
17145
|
#
|
17041
|
-
# # The following example
|
17042
|
-
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
17146
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
17043
17147
|
#
|
17044
17148
|
# resp = client.put_object({
|
17045
|
-
# acl: "authenticated-read",
|
17046
17149
|
# body: "filetoupload",
|
17047
17150
|
# bucket: "examplebucket",
|
17048
|
-
# key: "
|
17151
|
+
# key: "objectkey",
|
17049
17152
|
# })
|
17050
17153
|
#
|
17051
17154
|
# resp.to_h outputs the following:
|
17052
17155
|
# {
|
17053
17156
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17054
|
-
# version_id: "
|
17157
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
17055
17158
|
# }
|
17056
17159
|
#
|
17057
17160
|
# @example Example: To upload an object and specify optional tags
|
@@ -17072,37 +17175,59 @@ module Aws::S3
|
|
17072
17175
|
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
17073
17176
|
# }
|
17074
17177
|
#
|
17075
|
-
# @example Example: To upload an object
|
17178
|
+
# @example Example: To upload an object and specify canned ACL.
|
17076
17179
|
#
|
17077
|
-
# # The following example uploads
|
17078
|
-
# #
|
17180
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
17181
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
17182
|
+
#
|
17183
|
+
# resp = client.put_object({
|
17184
|
+
# acl: "authenticated-read",
|
17185
|
+
# body: "filetoupload",
|
17186
|
+
# bucket: "examplebucket",
|
17187
|
+
# key: "exampleobject",
|
17188
|
+
# })
|
17189
|
+
#
|
17190
|
+
# resp.to_h outputs the following:
|
17191
|
+
# {
|
17192
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17193
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
17194
|
+
# }
|
17195
|
+
#
|
17196
|
+
# @example Example: To upload an object (specify optional headers)
|
17197
|
+
#
|
17198
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
17199
|
+
# # storage class and use server-side encryption.
|
17079
17200
|
#
|
17080
17201
|
# resp = client.put_object({
|
17081
17202
|
# body: "HappyFace.jpg",
|
17082
17203
|
# bucket: "examplebucket",
|
17083
17204
|
# key: "HappyFace.jpg",
|
17205
|
+
# server_side_encryption: "AES256",
|
17206
|
+
# storage_class: "STANDARD_IA",
|
17084
17207
|
# })
|
17085
17208
|
#
|
17086
17209
|
# resp.to_h outputs the following:
|
17087
17210
|
# {
|
17088
17211
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17089
|
-
#
|
17212
|
+
# server_side_encryption: "AES256",
|
17213
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
17090
17214
|
# }
|
17091
17215
|
#
|
17092
|
-
# @example Example: To
|
17216
|
+
# @example Example: To upload an object
|
17093
17217
|
#
|
17094
|
-
# # The following example
|
17218
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
17219
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
17095
17220
|
#
|
17096
17221
|
# resp = client.put_object({
|
17097
|
-
# body: "
|
17222
|
+
# body: "HappyFace.jpg",
|
17098
17223
|
# bucket: "examplebucket",
|
17099
|
-
# key: "
|
17224
|
+
# key: "HappyFace.jpg",
|
17100
17225
|
# })
|
17101
17226
|
#
|
17102
17227
|
# resp.to_h outputs the following:
|
17103
17228
|
# {
|
17104
17229
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17105
|
-
# version_id: "
|
17230
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
17106
17231
|
# }
|
17107
17232
|
#
|
17108
17233
|
# @example Streaming a file from disk
|
@@ -17124,9 +17249,10 @@ module Aws::S3
|
|
17124
17249
|
# content_length: 1,
|
17125
17250
|
# content_md5: "ContentMD5",
|
17126
17251
|
# content_type: "ContentType",
|
17127
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
17252
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
17128
17253
|
# checksum_crc32: "ChecksumCRC32",
|
17129
17254
|
# checksum_crc32c: "ChecksumCRC32C",
|
17255
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
17130
17256
|
# checksum_sha1: "ChecksumSHA1",
|
17131
17257
|
# checksum_sha256: "ChecksumSHA256",
|
17132
17258
|
# expires: Time.now,
|
@@ -17164,8 +17290,10 @@ module Aws::S3
|
|
17164
17290
|
# resp.etag #=> String
|
17165
17291
|
# resp.checksum_crc32 #=> String
|
17166
17292
|
# resp.checksum_crc32c #=> String
|
17293
|
+
# resp.checksum_crc64nvme #=> String
|
17167
17294
|
# resp.checksum_sha1 #=> String
|
17168
17295
|
# resp.checksum_sha256 #=> String
|
17296
|
+
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
17169
17297
|
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
17170
17298
|
# resp.version_id #=> String
|
17171
17299
|
# resp.sse_customer_algorithm #=> String
|
@@ -17379,14 +17507,14 @@ module Aws::S3
|
|
17379
17507
|
# name. For more information about access point ARNs, see [Using access
|
17380
17508
|
# points][1] in the *Amazon S3 User Guide*.
|
17381
17509
|
#
|
17382
|
-
# **S3 on Outposts** - When you use this action with
|
17383
|
-
#
|
17384
|
-
#
|
17510
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
17511
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
17512
|
+
# Outposts hostname takes the form `
|
17385
17513
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
17386
|
-
# When you use this action with S3 on Outposts
|
17387
|
-
#
|
17388
|
-
#
|
17389
|
-
#
|
17514
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
17515
|
+
# must be the Outposts access point ARN or the access point alias. For
|
17516
|
+
# more information about S3 on Outposts, see [What is S3 on
|
17517
|
+
# Outposts?][2] in the *Amazon S3 User Guide*.
|
17390
17518
|
#
|
17391
17519
|
#
|
17392
17520
|
#
|
@@ -17394,9 +17522,9 @@ module Aws::S3
|
|
17394
17522
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
|
17395
17523
|
#
|
17396
17524
|
# @option params [String] :content_md5
|
17397
|
-
# The
|
17398
|
-
# used as a message integrity check to verify that the request body
|
17399
|
-
# not corrupted in transit. For more information, go to [RFC
|
17525
|
+
# The Base64 encoded 128-bit `MD5` digest of the data. This header must
|
17526
|
+
# be used as a message integrity check to verify that the request body
|
17527
|
+
# was not corrupted in transit. For more information, go to [RFC
|
17400
17528
|
# 1864.>][1]
|
17401
17529
|
#
|
17402
17530
|
# For requests made using the Amazon Web Services Command Line Interface
|
@@ -17529,7 +17657,7 @@ module Aws::S3
|
|
17529
17657
|
# },
|
17530
17658
|
# bucket: "BucketName", # required
|
17531
17659
|
# content_md5: "ContentMD5",
|
17532
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
17660
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
17533
17661
|
# grant_full_control: "GrantFullControl",
|
17534
17662
|
# grant_read: "GrantRead",
|
17535
17663
|
# grant_read_acp: "GrantReadACP",
|
@@ -17656,7 +17784,7 @@ module Aws::S3
|
|
17656
17784
|
# request_payer: "requester", # accepts requester
|
17657
17785
|
# version_id: "ObjectVersionId",
|
17658
17786
|
# content_md5: "ContentMD5",
|
17659
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
17787
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
17660
17788
|
# expected_bucket_owner: "AccountId",
|
17661
17789
|
# })
|
17662
17790
|
#
|
@@ -17775,7 +17903,7 @@ module Aws::S3
|
|
17775
17903
|
# request_payer: "requester", # accepts requester
|
17776
17904
|
# token: "ObjectLockToken",
|
17777
17905
|
# content_md5: "ContentMD5",
|
17778
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
17906
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
17779
17907
|
# expected_bucket_owner: "AccountId",
|
17780
17908
|
# })
|
17781
17909
|
#
|
@@ -17904,7 +18032,7 @@ module Aws::S3
|
|
17904
18032
|
# version_id: "ObjectVersionId",
|
17905
18033
|
# bypass_governance_retention: false,
|
17906
18034
|
# content_md5: "ContentMD5",
|
17907
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
18035
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
17908
18036
|
# expected_bucket_owner: "AccountId",
|
17909
18037
|
# })
|
17910
18038
|
#
|
@@ -17988,14 +18116,14 @@ module Aws::S3
|
|
17988
18116
|
# name. For more information about access point ARNs, see [Using access
|
17989
18117
|
# points][1] in the *Amazon S3 User Guide*.
|
17990
18118
|
#
|
17991
|
-
# **S3 on Outposts** - When you use this action with
|
17992
|
-
#
|
17993
|
-
#
|
18119
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
18120
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
18121
|
+
# Outposts hostname takes the form `
|
17994
18122
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
17995
|
-
# When you use this action with S3 on Outposts
|
17996
|
-
#
|
17997
|
-
#
|
17998
|
-
#
|
18123
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
18124
|
+
# must be the Outposts access point ARN or the access point alias. For
|
18125
|
+
# more information about S3 on Outposts, see [What is S3 on
|
18126
|
+
# Outposts?][2] in the *Amazon S3 User Guide*.
|
17999
18127
|
#
|
18000
18128
|
#
|
18001
18129
|
#
|
@@ -18094,7 +18222,7 @@ module Aws::S3
|
|
18094
18222
|
# key: "ObjectKey", # required
|
18095
18223
|
# version_id: "ObjectVersionId",
|
18096
18224
|
# content_md5: "ContentMD5",
|
18097
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
18225
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
18098
18226
|
# tagging: { # required
|
18099
18227
|
# tag_set: [ # required
|
18100
18228
|
# {
|
@@ -18209,7 +18337,7 @@ module Aws::S3
|
|
18209
18337
|
# resp = client.put_public_access_block({
|
18210
18338
|
# bucket: "BucketName", # required
|
18211
18339
|
# content_md5: "ContentMD5",
|
18212
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
18340
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
18213
18341
|
# public_access_block_configuration: { # required
|
18214
18342
|
# block_public_acls: false,
|
18215
18343
|
# ignore_public_acls: false,
|
@@ -18420,14 +18548,14 @@ module Aws::S3
|
|
18420
18548
|
# name. For more information about access point ARNs, see [Using access
|
18421
18549
|
# points][1] in the *Amazon S3 User Guide*.
|
18422
18550
|
#
|
18423
|
-
# **S3 on Outposts** - When you use this action with
|
18424
|
-
#
|
18425
|
-
#
|
18551
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
18552
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
18553
|
+
# Outposts hostname takes the form `
|
18426
18554
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
18427
|
-
# When you use this action with S3 on Outposts
|
18428
|
-
#
|
18429
|
-
#
|
18430
|
-
#
|
18555
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
18556
|
+
# must be the Outposts access point ARN or the access point alias. For
|
18557
|
+
# more information about S3 on Outposts, see [What is S3 on
|
18558
|
+
# Outposts?][2] in the *Amazon S3 User Guide*.
|
18431
18559
|
#
|
18432
18560
|
#
|
18433
18561
|
#
|
@@ -18594,7 +18722,7 @@ module Aws::S3
|
|
18594
18722
|
# },
|
18595
18723
|
# },
|
18596
18724
|
# request_payer: "requester", # accepts requester
|
18597
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
18725
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
18598
18726
|
# expected_bucket_owner: "AccountId",
|
18599
18727
|
# })
|
18600
18728
|
#
|
@@ -19066,13 +19194,13 @@ module Aws::S3
|
|
19066
19194
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
19067
19195
|
# for this API operation to the Zonal endpoint. These endpoints support
|
19068
19196
|
# virtual-hosted-style requests in the format
|
19069
|
-
# `https://bucket
|
19197
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
19070
19198
|
# `. Path-style requests are not supported. For more information about
|
19071
19199
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
19072
19200
|
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
19073
19201
|
# Guide*. For more information about endpoints in Local Zones, see
|
19074
|
-
# [
|
19075
|
-
# Guide*.
|
19202
|
+
# [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
|
19203
|
+
# User Guide*.
|
19076
19204
|
#
|
19077
19205
|
# </note>
|
19078
19206
|
#
|
@@ -19206,7 +19334,7 @@ module Aws::S3
|
|
19206
19334
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
19207
19335
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
|
19208
19336
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
19209
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
19337
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
19210
19338
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19211
19339
|
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
19212
19340
|
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
@@ -19231,7 +19359,7 @@ module Aws::S3
|
|
19231
19359
|
# requests are not supported. Directory bucket names must be unique in
|
19232
19360
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19233
19361
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
19234
|
-
#
|
19362
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
19235
19363
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
19236
19364
|
# *Amazon S3 User Guide*.
|
19237
19365
|
#
|
@@ -19251,14 +19379,14 @@ module Aws::S3
|
|
19251
19379
|
#
|
19252
19380
|
# </note>
|
19253
19381
|
#
|
19254
|
-
# **S3 on Outposts** - When you use this action with
|
19255
|
-
#
|
19256
|
-
#
|
19382
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
19383
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
19384
|
+
# Outposts hostname takes the form `
|
19257
19385
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
19258
|
-
# When you use this action with S3 on Outposts
|
19259
|
-
#
|
19260
|
-
#
|
19261
|
-
#
|
19386
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
19387
|
+
# must be the Outposts access point ARN or the access point alias. For
|
19388
|
+
# more information about S3 on Outposts, see [What is S3 on
|
19389
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
19262
19390
|
#
|
19263
19391
|
#
|
19264
19392
|
#
|
@@ -19271,7 +19399,7 @@ module Aws::S3
|
|
19271
19399
|
# the body cannot be determined automatically.
|
19272
19400
|
#
|
19273
19401
|
# @option params [String] :content_md5
|
19274
|
-
# The
|
19402
|
+
# The Base64 encoded 128-bit MD5 digest of the part data. This parameter
|
19275
19403
|
# is auto-populated when using the command from the CLI. This parameter
|
19276
19404
|
# is required if object lock parameters are specified.
|
19277
19405
|
#
|
@@ -19301,7 +19429,7 @@ module Aws::S3
|
|
19301
19429
|
# @option params [String] :checksum_crc32
|
19302
19430
|
# This header can be used as a data integrity check to verify that the
|
19303
19431
|
# data received is the same data that was originally sent. This header
|
19304
|
-
# specifies the
|
19432
|
+
# specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
|
19305
19433
|
# For more information, see [Checking object integrity][1] in the
|
19306
19434
|
# *Amazon S3 User Guide*.
|
19307
19435
|
#
|
@@ -19312,7 +19440,7 @@ module Aws::S3
|
|
19312
19440
|
# @option params [String] :checksum_crc32c
|
19313
19441
|
# This header can be used as a data integrity check to verify that the
|
19314
19442
|
# data received is the same data that was originally sent. This header
|
19315
|
-
# specifies the
|
19443
|
+
# specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
|
19316
19444
|
# For more information, see [Checking object integrity][1] in the
|
19317
19445
|
# *Amazon S3 User Guide*.
|
19318
19446
|
#
|
@@ -19320,12 +19448,23 @@ module Aws::S3
|
|
19320
19448
|
#
|
19321
19449
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
19322
19450
|
#
|
19451
|
+
# @option params [String] :checksum_crc64nvme
|
19452
|
+
# This header can be used as a data integrity check to verify that the
|
19453
|
+
# data received is the same data that was originally sent. This header
|
19454
|
+
# specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
|
19455
|
+
# part. For more information, see [Checking object integrity][1] in the
|
19456
|
+
# *Amazon S3 User Guide*.
|
19457
|
+
#
|
19458
|
+
#
|
19459
|
+
#
|
19460
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
19461
|
+
#
|
19323
19462
|
# @option params [String] :checksum_sha1
|
19324
19463
|
# This header can be used as a data integrity check to verify that the
|
19325
19464
|
# data received is the same data that was originally sent. This header
|
19326
|
-
# specifies the
|
19327
|
-
# more information, see [Checking object integrity][1] in the
|
19328
|
-
# User Guide*.
|
19465
|
+
# specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
|
19466
|
+
# For more information, see [Checking object integrity][1] in the
|
19467
|
+
# *Amazon S3 User Guide*.
|
19329
19468
|
#
|
19330
19469
|
#
|
19331
19470
|
#
|
@@ -19334,7 +19473,7 @@ module Aws::S3
|
|
19334
19473
|
# @option params [String] :checksum_sha256
|
19335
19474
|
# This header can be used as a data integrity check to verify that the
|
19336
19475
|
# data received is the same data that was originally sent. This header
|
19337
|
-
# specifies the
|
19476
|
+
# specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
|
19338
19477
|
# For more information, see [Checking object integrity][1] in the
|
19339
19478
|
# *Amazon S3 User Guide*.
|
19340
19479
|
#
|
@@ -19411,6 +19550,7 @@ module Aws::S3
|
|
19411
19550
|
# * {Types::UploadPartOutput#etag #etag} => String
|
19412
19551
|
# * {Types::UploadPartOutput#checksum_crc32 #checksum_crc32} => String
|
19413
19552
|
# * {Types::UploadPartOutput#checksum_crc32c #checksum_crc32c} => String
|
19553
|
+
# * {Types::UploadPartOutput#checksum_crc64nvme #checksum_crc64nvme} => String
|
19414
19554
|
# * {Types::UploadPartOutput#checksum_sha1 #checksum_sha1} => String
|
19415
19555
|
# * {Types::UploadPartOutput#checksum_sha256 #checksum_sha256} => String
|
19416
19556
|
# * {Types::UploadPartOutput#sse_customer_algorithm #sse_customer_algorithm} => String
|
@@ -19445,9 +19585,10 @@ module Aws::S3
|
|
19445
19585
|
# bucket: "BucketName", # required
|
19446
19586
|
# content_length: 1,
|
19447
19587
|
# content_md5: "ContentMD5",
|
19448
|
-
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
19588
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
19449
19589
|
# checksum_crc32: "ChecksumCRC32",
|
19450
19590
|
# checksum_crc32c: "ChecksumCRC32C",
|
19591
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
19451
19592
|
# checksum_sha1: "ChecksumSHA1",
|
19452
19593
|
# checksum_sha256: "ChecksumSHA256",
|
19453
19594
|
# key: "ObjectKey", # required
|
@@ -19466,6 +19607,7 @@ module Aws::S3
|
|
19466
19607
|
# resp.etag #=> String
|
19467
19608
|
# resp.checksum_crc32 #=> String
|
19468
19609
|
# resp.checksum_crc32c #=> String
|
19610
|
+
# resp.checksum_crc64nvme #=> String
|
19469
19611
|
# resp.checksum_sha1 #=> String
|
19470
19612
|
# resp.checksum_sha256 #=> String
|
19471
19613
|
# resp.sse_customer_algorithm #=> String
|
@@ -19511,13 +19653,13 @@ module Aws::S3
|
|
19511
19653
|
# <note markdown="1"> **Directory buckets** - For directory buckets, you must make requests
|
19512
19654
|
# for this API operation to the Zonal endpoint. These endpoints support
|
19513
19655
|
# virtual-hosted-style requests in the format
|
19514
|
-
# `https://bucket
|
19656
|
+
# `https://amzn-s3-demo-bucket.s3express-zone-id.region-code.amazonaws.com/key-name
|
19515
19657
|
# `. Path-style requests are not supported. For more information about
|
19516
19658
|
# endpoints in Availability Zones, see [Regional and Zonal endpoints for
|
19517
19659
|
# directory buckets in Availability Zones][5] in the *Amazon S3 User
|
19518
19660
|
# Guide*. For more information about endpoints in Local Zones, see
|
19519
|
-
# [
|
19520
|
-
# Guide*.
|
19661
|
+
# [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
|
19662
|
+
# User Guide*.
|
19521
19663
|
#
|
19522
19664
|
# </note>
|
19523
19665
|
#
|
@@ -19662,7 +19804,7 @@ module Aws::S3
|
|
19662
19804
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
19663
19805
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
19664
19806
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
|
19665
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
19807
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
19666
19808
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
19667
19809
|
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
19668
19810
|
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
|
@@ -19688,7 +19830,7 @@ module Aws::S3
|
|
19688
19830
|
# requests are not supported. Directory bucket names must be unique in
|
19689
19831
|
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
19690
19832
|
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
19691
|
-
#
|
19833
|
+
# amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
19692
19834
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
19693
19835
|
# *Amazon S3 User Guide*.
|
19694
19836
|
#
|
@@ -19716,14 +19858,14 @@ module Aws::S3
|
|
19716
19858
|
#
|
19717
19859
|
# </note>
|
19718
19860
|
#
|
19719
|
-
# **S3 on Outposts** - When you use this action with
|
19720
|
-
#
|
19721
|
-
#
|
19861
|
+
# **S3 on Outposts** - When you use this action with S3 on Outposts, you
|
19862
|
+
# must direct requests to the S3 on Outposts hostname. The S3 on
|
19863
|
+
# Outposts hostname takes the form `
|
19722
19864
|
# AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
|
19723
|
-
# When you use this action with S3 on Outposts
|
19724
|
-
#
|
19725
|
-
#
|
19726
|
-
#
|
19865
|
+
# When you use this action with S3 on Outposts, the destination bucket
|
19866
|
+
# must be the Outposts access point ARN or the access point alias. For
|
19867
|
+
# more information about S3 on Outposts, see [What is S3 on
|
19868
|
+
# Outposts?][3] in the *Amazon S3 User Guide*.
|
19727
19869
|
#
|
19728
19870
|
#
|
19729
19871
|
#
|
@@ -19971,45 +20113,45 @@ module Aws::S3
|
|
19971
20113
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
19972
20114
|
#
|
19973
20115
|
#
|
19974
|
-
# @example Example: To upload a part by copying
|
20116
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
19975
20117
|
#
|
19976
|
-
# # The following example uploads a part of a multipart upload by copying
|
19977
|
-
# # data source.
|
20118
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
19978
20119
|
#
|
19979
20120
|
# resp = client.upload_part_copy({
|
19980
20121
|
# bucket: "examplebucket",
|
19981
20122
|
# copy_source: "/bucketname/sourceobjectkey",
|
19982
|
-
# copy_source_range: "bytes=1-100000",
|
19983
20123
|
# key: "examplelargeobject",
|
19984
|
-
# part_number:
|
20124
|
+
# part_number: 1,
|
19985
20125
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
19986
20126
|
# })
|
19987
20127
|
#
|
19988
20128
|
# resp.to_h outputs the following:
|
19989
20129
|
# {
|
19990
20130
|
# copy_part_result: {
|
19991
|
-
# etag: "\"
|
19992
|
-
# last_modified: Time.parse("2016-12-29T21:
|
20131
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
20132
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
19993
20133
|
# },
|
19994
20134
|
# }
|
19995
20135
|
#
|
19996
|
-
# @example Example: To upload a part by copying
|
20136
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
19997
20137
|
#
|
19998
|
-
# # The following example uploads a part of a multipart upload by copying
|
20138
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
20139
|
+
# # data source.
|
19999
20140
|
#
|
20000
20141
|
# resp = client.upload_part_copy({
|
20001
20142
|
# bucket: "examplebucket",
|
20002
20143
|
# copy_source: "/bucketname/sourceobjectkey",
|
20144
|
+
# copy_source_range: "bytes=1-100000",
|
20003
20145
|
# key: "examplelargeobject",
|
20004
|
-
# part_number:
|
20146
|
+
# part_number: 2,
|
20005
20147
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
20006
20148
|
# })
|
20007
20149
|
#
|
20008
20150
|
# resp.to_h outputs the following:
|
20009
20151
|
# {
|
20010
20152
|
# copy_part_result: {
|
20011
|
-
# etag: "\"
|
20012
|
-
# last_modified: Time.parse("2016-12-29T21:
|
20153
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
20154
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
20013
20155
|
# },
|
20014
20156
|
# }
|
20015
20157
|
#
|
@@ -20044,6 +20186,7 @@ module Aws::S3
|
|
20044
20186
|
# resp.copy_part_result.last_modified #=> Time
|
20045
20187
|
# resp.copy_part_result.checksum_crc32 #=> String
|
20046
20188
|
# resp.copy_part_result.checksum_crc32c #=> String
|
20189
|
+
# resp.copy_part_result.checksum_crc64nvme #=> String
|
20047
20190
|
# resp.copy_part_result.checksum_sha1 #=> String
|
20048
20191
|
# resp.copy_part_result.checksum_sha256 #=> String
|
20049
20192
|
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
@@ -20208,7 +20351,7 @@ module Aws::S3
|
|
20208
20351
|
# @option params [String] :checksum_crc32
|
20209
20352
|
# This header can be used as a data integrity check to verify that the
|
20210
20353
|
# data received is the same data that was originally sent. This
|
20211
|
-
# specifies the
|
20354
|
+
# specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object
|
20212
20355
|
# returned by the Object Lambda function. This may not match the
|
20213
20356
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20214
20357
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20228,7 +20371,7 @@ module Aws::S3
|
|
20228
20371
|
# @option params [String] :checksum_crc32c
|
20229
20372
|
# This header can be used as a data integrity check to verify that the
|
20230
20373
|
# data received is the same data that was originally sent. This
|
20231
|
-
# specifies the
|
20374
|
+
# specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object
|
20232
20375
|
# returned by the Object Lambda function. This may not match the
|
20233
20376
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20234
20377
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20243,10 +20386,21 @@ module Aws::S3
|
|
20243
20386
|
#
|
20244
20387
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
20245
20388
|
#
|
20389
|
+
# @option params [String] :checksum_crc64nvme
|
20390
|
+
# This header can be used as a data integrity check to verify that the
|
20391
|
+
# data received is the same data that was originally sent. This header
|
20392
|
+
# specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
|
20393
|
+
# part. For more information, see [Checking object integrity][1] in the
|
20394
|
+
# *Amazon S3 User Guide*.
|
20395
|
+
#
|
20396
|
+
#
|
20397
|
+
#
|
20398
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
20399
|
+
#
|
20246
20400
|
# @option params [String] :checksum_sha1
|
20247
20401
|
# This header can be used as a data integrity check to verify that the
|
20248
20402
|
# data received is the same data that was originally sent. This
|
20249
|
-
# specifies the
|
20403
|
+
# specifies the Base64 encoded, 160-bit `SHA-1` digest of the object
|
20250
20404
|
# returned by the Object Lambda function. This may not match the
|
20251
20405
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20252
20406
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20264,7 +20418,7 @@ module Aws::S3
|
|
20264
20418
|
# @option params [String] :checksum_sha256
|
20265
20419
|
# This header can be used as a data integrity check to verify that the
|
20266
20420
|
# data received is the same data that was originally sent. This
|
20267
|
-
# specifies the
|
20421
|
+
# specifies the Base64 encoded, 256-bit `SHA-256` digest of the object
|
20268
20422
|
# returned by the Object Lambda function. This may not match the
|
20269
20423
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20270
20424
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20281,7 +20435,12 @@ module Aws::S3
|
|
20281
20435
|
#
|
20282
20436
|
# @option params [Boolean] :delete_marker
|
20283
20437
|
# Specifies whether an object stored in Amazon S3 is (`true`) or is not
|
20284
|
-
# (`false`) a delete marker.
|
20438
|
+
# (`false`) a delete marker. To learn more about delete markers, see
|
20439
|
+
# [Working with delete markers][1].
|
20440
|
+
#
|
20441
|
+
#
|
20442
|
+
#
|
20443
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
|
20285
20444
|
#
|
20286
20445
|
# @option params [String] :etag
|
20287
20446
|
# An opaque identifier assigned by a web server to a specific version of
|
@@ -20416,6 +20575,7 @@ module Aws::S3
|
|
20416
20575
|
# content_type: "ContentType",
|
20417
20576
|
# checksum_crc32: "ChecksumCRC32",
|
20418
20577
|
# checksum_crc32c: "ChecksumCRC32C",
|
20578
|
+
# checksum_crc64nvme: "ChecksumCRC64NVME",
|
20419
20579
|
# checksum_sha1: "ChecksumSHA1",
|
20420
20580
|
# checksum_sha256: "ChecksumSHA256",
|
20421
20581
|
# delete_marker: false,
|
@@ -20471,7 +20631,7 @@ module Aws::S3
|
|
20471
20631
|
tracer: tracer
|
20472
20632
|
)
|
20473
20633
|
context[:gem_name] = 'aws-sdk-s3'
|
20474
|
-
context[:gem_version] = '1.
|
20634
|
+
context[:gem_version] = '1.180.0'
|
20475
20635
|
Seahorse::Client::Request.new(handlers, context)
|
20476
20636
|
end
|
20477
20637
|
|