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