aws-sdk-s3 1.176.1 → 1.180.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
|