aws-sdk-s3 1.196.1 → 1.213.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 +116 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +17 -17
- data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
- data/lib/aws-sdk-s3/client.rb +1271 -453
- data/lib/aws-sdk-s3/client_api.rb +115 -0
- data/lib/aws-sdk-s3/customizations/object.rb +39 -24
- data/lib/aws-sdk-s3/customizations.rb +3 -1
- data/lib/aws-sdk-s3/default_executor.rb +103 -0
- data/lib/aws-sdk-s3/encryption/client.rb +2 -2
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +2 -0
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +98 -23
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +7 -162
- data/lib/aws-sdk-s3/encryptionV2/decryption.rb +205 -0
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +17 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +8 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +5 -0
- data/lib/aws-sdk-s3/encryptionV3/client.rb +885 -0
- data/lib/aws-sdk-s3/encryptionV3/decrypt_handler.rb +98 -0
- data/lib/aws-sdk-s3/encryptionV3/decryption.rb +244 -0
- data/lib/aws-sdk-s3/encryptionV3/default_cipher_provider.rb +159 -0
- data/lib/aws-sdk-s3/encryptionV3/default_key_provider.rb +35 -0
- data/lib/aws-sdk-s3/encryptionV3/encrypt_handler.rb +98 -0
- data/lib/aws-sdk-s3/encryptionV3/errors.rb +47 -0
- data/lib/aws-sdk-s3/encryptionV3/io_auth_decrypter.rb +60 -0
- data/lib/aws-sdk-s3/encryptionV3/io_decrypter.rb +35 -0
- data/lib/aws-sdk-s3/encryptionV3/io_encrypter.rb +84 -0
- data/lib/aws-sdk-s3/encryptionV3/key_provider.rb +28 -0
- data/lib/aws-sdk-s3/encryptionV3/kms_cipher_provider.rb +159 -0
- data/lib/aws-sdk-s3/encryptionV3/materials.rb +58 -0
- data/lib/aws-sdk-s3/encryptionV3/utils.rb +321 -0
- data/lib/aws-sdk-s3/encryption_v2.rb +1 -0
- data/lib/aws-sdk-s3/encryption_v3.rb +24 -0
- data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
- data/lib/aws-sdk-s3/endpoint_provider.rb +241 -68
- data/lib/aws-sdk-s3/endpoints.rb +39 -0
- data/lib/aws-sdk-s3/errors.rb +11 -0
- data/lib/aws-sdk-s3/file_downloader.rb +192 -104
- data/lib/aws-sdk-s3/file_uploader.rb +17 -13
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +82 -69
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +96 -107
- data/lib/aws-sdk-s3/multipart_upload.rb +12 -12
- data/lib/aws-sdk-s3/multipart_upload_part.rb +8 -8
- data/lib/aws-sdk-s3/object.rb +88 -59
- data/lib/aws-sdk-s3/object_acl.rb +5 -5
- data/lib/aws-sdk-s3/object_summary.rb +70 -41
- data/lib/aws-sdk-s3/object_version.rb +23 -25
- data/lib/aws-sdk-s3/plugins/checksum_algorithm.rb +18 -5
- data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +58 -34
- data/lib/aws-sdk-s3/transfer_manager.rb +321 -0
- data/lib/aws-sdk-s3/types.rb +687 -330
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +1 -1
- data/sig/client.rbs +62 -12
- data/sig/errors.rbs +2 -0
- data/sig/multipart_upload.rbs +1 -1
- data/sig/object.rbs +7 -5
- data/sig/object_summary.rbs +7 -5
- data/sig/types.rbs +84 -14
- metadata +21 -3
data/lib/aws-sdk-s3/client.rb
CHANGED
|
@@ -269,7 +269,7 @@ module Aws::S3
|
|
|
269
269
|
# When set to 'true' the request body will not be compressed
|
|
270
270
|
# for supported operations.
|
|
271
271
|
#
|
|
272
|
-
# @option options [
|
|
272
|
+
# @option options [boolean] :disable_s3_express_session_auth
|
|
273
273
|
# Parameter to indicate whether S3Express session auth should be disabled
|
|
274
274
|
#
|
|
275
275
|
# @option options [String, URI::HTTPS, URI::HTTP] :endpoint
|
|
@@ -650,6 +650,10 @@ module Aws::S3
|
|
|
650
650
|
#
|
|
651
651
|
# * [ListMultipartUploads][9]
|
|
652
652
|
#
|
|
653
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
654
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
655
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
656
|
+
#
|
|
653
657
|
#
|
|
654
658
|
#
|
|
655
659
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
@@ -717,10 +721,10 @@ module Aws::S3
|
|
|
717
721
|
# Confirms that the requester knows that they will be charged for the
|
|
718
722
|
# request. Bucket owners need not specify this parameter in their
|
|
719
723
|
# requests. If either the source or destination S3 bucket has Requester
|
|
720
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
721
|
-
#
|
|
722
|
-
#
|
|
723
|
-
#
|
|
724
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
725
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
726
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
727
|
+
# S3 User Guide*.
|
|
724
728
|
#
|
|
725
729
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
726
730
|
#
|
|
@@ -924,6 +928,10 @@ module Aws::S3
|
|
|
924
928
|
#
|
|
925
929
|
# * [ListMultipartUploads][13]
|
|
926
930
|
#
|
|
931
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
932
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
933
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
934
|
+
#
|
|
927
935
|
#
|
|
928
936
|
#
|
|
929
937
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
|
@@ -1071,10 +1079,10 @@ module Aws::S3
|
|
|
1071
1079
|
# Confirms that the requester knows that they will be charged for the
|
|
1072
1080
|
# request. Bucket owners need not specify this parameter in their
|
|
1073
1081
|
# requests. If either the source or destination S3 bucket has Requester
|
|
1074
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
1075
|
-
#
|
|
1076
|
-
#
|
|
1077
|
-
#
|
|
1082
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
1083
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
1084
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
1085
|
+
# S3 User Guide*.
|
|
1078
1086
|
#
|
|
1079
1087
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
1080
1088
|
#
|
|
@@ -1286,23 +1294,21 @@ module Aws::S3
|
|
|
1286
1294
|
req.send_request(options)
|
|
1287
1295
|
end
|
|
1288
1296
|
|
|
1289
|
-
#
|
|
1290
|
-
#
|
|
1291
|
-
#
|
|
1292
|
-
#
|
|
1293
|
-
#
|
|
1294
|
-
#
|
|
1297
|
+
# Creates a copy of an object that is already stored in Amazon S3.
|
|
1298
|
+
#
|
|
1299
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
1300
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
1301
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
1302
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
1303
|
+
# error.
|
|
1295
1304
|
#
|
|
1296
1305
|
# This change affects the following Amazon Web Services Regions: US
|
|
1297
1306
|
# East
|
|
1298
|
-
# (N. Virginia)
|
|
1299
|
-
#
|
|
1300
|
-
#
|
|
1301
|
-
# America (São Paulo) Region.
|
|
1302
|
-
#
|
|
1303
|
-
# Creates a copy of an object that is already stored in Amazon S3.
|
|
1307
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
1308
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
1309
|
+
# (Ireland), and South America (São Paulo).
|
|
1304
1310
|
#
|
|
1305
|
-
# <note markdown="1"> You can store individual objects of up to
|
|
1311
|
+
# <note markdown="1"> You can store individual objects of up to 50 TB in Amazon S3. You
|
|
1306
1312
|
# create a copy of your object up to 5 GB in size in a single atomic
|
|
1307
1313
|
# action using this API. However, to copy an object greater than 5 GB,
|
|
1308
1314
|
# you must use the multipart upload Upload Part - Copy (UploadPartCopy)
|
|
@@ -1469,6 +1475,10 @@ module Aws::S3
|
|
|
1469
1475
|
#
|
|
1470
1476
|
# * [GetObject][12]
|
|
1471
1477
|
#
|
|
1478
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
1479
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
1480
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
1481
|
+
#
|
|
1472
1482
|
#
|
|
1473
1483
|
#
|
|
1474
1484
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
|
|
@@ -1789,6 +1799,37 @@ module Aws::S3
|
|
|
1789
1799
|
#
|
|
1790
1800
|
# </note>
|
|
1791
1801
|
#
|
|
1802
|
+
# @option params [String] :if_match
|
|
1803
|
+
# Copies the object if the entity tag (ETag) of the destination object
|
|
1804
|
+
# matches the specified tag. If the ETag values do not match, the
|
|
1805
|
+
# operation returns a `412 Precondition Failed` error. If a concurrent
|
|
1806
|
+
# operation occurs during the upload S3 returns a `409
|
|
1807
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
|
1808
|
+
# fetch the object's ETag and retry the upload.
|
|
1809
|
+
#
|
|
1810
|
+
# Expects the ETag value as a string.
|
|
1811
|
+
#
|
|
1812
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
1813
|
+
#
|
|
1814
|
+
#
|
|
1815
|
+
#
|
|
1816
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
1817
|
+
#
|
|
1818
|
+
# @option params [String] :if_none_match
|
|
1819
|
+
# Copies the object only if the object key name at the destination does
|
|
1820
|
+
# not already exist in the bucket specified. Otherwise, Amazon S3
|
|
1821
|
+
# returns a `412 Precondition Failed` error. If a concurrent operation
|
|
1822
|
+
# occurs during the upload S3 returns a `409 ConditionalRequestConflict`
|
|
1823
|
+
# response. On a 409 failure you should retry the upload.
|
|
1824
|
+
#
|
|
1825
|
+
# Expects the '*' (asterisk) character.
|
|
1826
|
+
#
|
|
1827
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
1828
|
+
#
|
|
1829
|
+
#
|
|
1830
|
+
#
|
|
1831
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
1832
|
+
#
|
|
1792
1833
|
# @option params [required, String] :key
|
|
1793
1834
|
# The key of the destination object.
|
|
1794
1835
|
#
|
|
@@ -2168,10 +2209,10 @@ module Aws::S3
|
|
|
2168
2209
|
# Confirms that the requester knows that they will be charged for the
|
|
2169
2210
|
# request. Bucket owners need not specify this parameter in their
|
|
2170
2211
|
# requests. If either the source or destination S3 bucket has Requester
|
|
2171
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
2172
|
-
#
|
|
2173
|
-
#
|
|
2174
|
-
#
|
|
2212
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
2213
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
2214
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
2215
|
+
# S3 User Guide*.
|
|
2175
2216
|
#
|
|
2176
2217
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
2177
2218
|
#
|
|
@@ -2320,6 +2361,8 @@ module Aws::S3
|
|
|
2320
2361
|
# grant_read: "GrantRead",
|
|
2321
2362
|
# grant_read_acp: "GrantReadACP",
|
|
2322
2363
|
# grant_write_acp: "GrantWriteACP",
|
|
2364
|
+
# if_match: "IfMatch",
|
|
2365
|
+
# if_none_match: "IfNoneMatch",
|
|
2323
2366
|
# key: "ObjectKey", # required
|
|
2324
2367
|
# metadata: {
|
|
2325
2368
|
# "MetadataKey" => "MetadataValue",
|
|
@@ -2327,7 +2370,7 @@ module Aws::S3
|
|
|
2327
2370
|
# metadata_directive: "COPY", # accepts COPY, REPLACE
|
|
2328
2371
|
# tagging_directive: "COPY", # accepts COPY, REPLACE
|
|
2329
2372
|
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
|
2330
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
2373
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
2331
2374
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
2332
2375
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
2333
2376
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -2377,33 +2420,6 @@ module Aws::S3
|
|
|
2377
2420
|
req.send_request(options)
|
|
2378
2421
|
end
|
|
2379
2422
|
|
|
2380
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will
|
|
2381
|
-
# discontinue support for creating new Email Grantee Access Control
|
|
2382
|
-
# Lists (ACL). Email Grantee ACLs created prior to this date will
|
|
2383
|
-
# continue to work and remain accessible through the Amazon Web Services
|
|
2384
|
-
# Management Console, Command Line Interface (CLI), SDKs, and REST API.
|
|
2385
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
2386
|
-
#
|
|
2387
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
2388
|
-
# East
|
|
2389
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
2390
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
2391
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
2392
|
-
# America (São Paulo) Region.
|
|
2393
|
-
#
|
|
2394
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
2395
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
2396
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
2397
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
2398
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
2399
|
-
#
|
|
2400
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
2401
|
-
# East
|
|
2402
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
2403
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
2404
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
2405
|
-
# America (São Paulo) Region.
|
|
2406
|
-
#
|
|
2407
2423
|
# <note markdown="1"> This action creates an Amazon S3 bucket. To create an Amazon S3 on
|
|
2408
2424
|
# Outposts bucket, see [ `CreateBucket` ][1].
|
|
2409
2425
|
#
|
|
@@ -2525,6 +2541,10 @@ module Aws::S3
|
|
|
2525
2541
|
#
|
|
2526
2542
|
# * [DeleteBucket][13]
|
|
2527
2543
|
#
|
|
2544
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2545
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2546
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2547
|
+
#
|
|
2528
2548
|
#
|
|
2529
2549
|
#
|
|
2530
2550
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
|
|
@@ -2794,6 +2814,10 @@ module Aws::S3
|
|
|
2794
2814
|
#
|
|
2795
2815
|
# * [UpdateBucketMetadataJournalTableConfiguration][8]
|
|
2796
2816
|
#
|
|
2817
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2818
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2819
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2820
|
+
#
|
|
2797
2821
|
#
|
|
2798
2822
|
#
|
|
2799
2823
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -2911,6 +2935,10 @@ module Aws::S3
|
|
|
2911
2935
|
#
|
|
2912
2936
|
# * [GetBucketMetadataTableConfiguration][6]
|
|
2913
2937
|
#
|
|
2938
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2939
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2940
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2941
|
+
#
|
|
2914
2942
|
#
|
|
2915
2943
|
#
|
|
2916
2944
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
|
@@ -2963,19 +2991,17 @@ module Aws::S3
|
|
|
2963
2991
|
req.send_request(options)
|
|
2964
2992
|
end
|
|
2965
2993
|
|
|
2966
|
-
# End of support notice:
|
|
2967
|
-
#
|
|
2968
|
-
#
|
|
2969
|
-
#
|
|
2970
|
-
#
|
|
2971
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
2994
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
2995
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
2996
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
2997
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
2998
|
+
# error.
|
|
2972
2999
|
#
|
|
2973
3000
|
# This change affects the following Amazon Web Services Regions: US
|
|
2974
3001
|
# East
|
|
2975
|
-
# (N. Virginia)
|
|
2976
|
-
#
|
|
2977
|
-
#
|
|
2978
|
-
# America (São Paulo) Region.
|
|
3002
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
3003
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
3004
|
+
# (Ireland), and South America (São Paulo).
|
|
2979
3005
|
#
|
|
2980
3006
|
# This action initiates a multipart upload and returns an upload ID.
|
|
2981
3007
|
# This upload ID is used to associate all of the parts in the specific
|
|
@@ -3211,6 +3237,10 @@ module Aws::S3
|
|
|
3211
3237
|
#
|
|
3212
3238
|
# * [ListMultipartUploads][19]
|
|
3213
3239
|
#
|
|
3240
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
3241
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
3242
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
3243
|
+
#
|
|
3214
3244
|
#
|
|
3215
3245
|
#
|
|
3216
3246
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
|
@@ -3780,10 +3810,10 @@ module Aws::S3
|
|
|
3780
3810
|
# Confirms that the requester knows that they will be charged for the
|
|
3781
3811
|
# request. Bucket owners need not specify this parameter in their
|
|
3782
3812
|
# requests. If either the source or destination S3 bucket has Requester
|
|
3783
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
3784
|
-
#
|
|
3785
|
-
#
|
|
3786
|
-
#
|
|
3813
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
3814
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
3815
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
3816
|
+
# S3 User Guide*.
|
|
3787
3817
|
#
|
|
3788
3818
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
3789
3819
|
#
|
|
@@ -3901,7 +3931,7 @@ module Aws::S3
|
|
|
3901
3931
|
# "MetadataKey" => "MetadataValue",
|
|
3902
3932
|
# },
|
|
3903
3933
|
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
|
3904
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
3934
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
3905
3935
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
3906
3936
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
3907
3937
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -4091,6 +4121,10 @@ module Aws::S3
|
|
|
4091
4121
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
4092
4122
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
4093
4123
|
#
|
|
4124
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4125
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4126
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4127
|
+
#
|
|
4094
4128
|
#
|
|
4095
4129
|
#
|
|
4096
4130
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
|
|
@@ -4293,6 +4327,10 @@ module Aws::S3
|
|
|
4293
4327
|
#
|
|
4294
4328
|
# * [DeleteObject][5]
|
|
4295
4329
|
#
|
|
4330
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4331
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4332
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4333
|
+
#
|
|
4296
4334
|
#
|
|
4297
4335
|
#
|
|
4298
4336
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -4383,6 +4421,10 @@ module Aws::S3
|
|
|
4383
4421
|
#
|
|
4384
4422
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
4385
4423
|
#
|
|
4424
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4425
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4426
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4427
|
+
#
|
|
4386
4428
|
#
|
|
4387
4429
|
#
|
|
4388
4430
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -4442,6 +4484,10 @@ module Aws::S3
|
|
|
4442
4484
|
#
|
|
4443
4485
|
# * [RESTOPTIONSobject][3]
|
|
4444
4486
|
#
|
|
4487
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4488
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4489
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4490
|
+
#
|
|
4445
4491
|
#
|
|
4446
4492
|
#
|
|
4447
4493
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
|
@@ -4530,6 +4576,10 @@ module Aws::S3
|
|
|
4530
4576
|
#
|
|
4531
4577
|
# * [GetBucketEncryption][7]
|
|
4532
4578
|
#
|
|
4579
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4580
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4581
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4582
|
+
#
|
|
4533
4583
|
#
|
|
4534
4584
|
#
|
|
4535
4585
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
|
@@ -4623,6 +4673,10 @@ module Aws::S3
|
|
|
4623
4673
|
#
|
|
4624
4674
|
# * [ListBucketIntelligentTieringConfigurations][4]
|
|
4625
4675
|
#
|
|
4676
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4677
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4678
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4679
|
+
#
|
|
4626
4680
|
#
|
|
4627
4681
|
#
|
|
4628
4682
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -4686,6 +4740,10 @@ module Aws::S3
|
|
|
4686
4740
|
#
|
|
4687
4741
|
# * [ListBucketInventoryConfigurations][6]
|
|
4688
4742
|
#
|
|
4743
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4744
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4745
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4746
|
+
#
|
|
4689
4747
|
#
|
|
4690
4748
|
#
|
|
4691
4749
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -4786,6 +4844,10 @@ module Aws::S3
|
|
|
4786
4844
|
#
|
|
4787
4845
|
# * [GetBucketLifecycleConfiguration][7]
|
|
4788
4846
|
#
|
|
4847
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4848
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4849
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4850
|
+
#
|
|
4789
4851
|
#
|
|
4790
4852
|
#
|
|
4791
4853
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
@@ -4871,6 +4933,10 @@ module Aws::S3
|
|
|
4871
4933
|
#
|
|
4872
4934
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
4873
4935
|
#
|
|
4936
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4937
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4938
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4939
|
+
#
|
|
4874
4940
|
#
|
|
4875
4941
|
#
|
|
4876
4942
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -4948,6 +5014,10 @@ module Aws::S3
|
|
|
4948
5014
|
#
|
|
4949
5015
|
# * [GetBucketMetadataTableConfiguration][6]
|
|
4950
5016
|
#
|
|
5017
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5018
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5019
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5020
|
+
#
|
|
4951
5021
|
#
|
|
4952
5022
|
#
|
|
4953
5023
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
|
|
@@ -5012,6 +5082,10 @@ module Aws::S3
|
|
|
5012
5082
|
#
|
|
5013
5083
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
|
5014
5084
|
#
|
|
5085
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5086
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5087
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5088
|
+
#
|
|
5015
5089
|
#
|
|
5016
5090
|
#
|
|
5017
5091
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -5072,6 +5146,10 @@ module Aws::S3
|
|
|
5072
5146
|
#
|
|
5073
5147
|
# * PutBucketOwnershipControls
|
|
5074
5148
|
#
|
|
5149
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5150
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5151
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5152
|
+
#
|
|
5075
5153
|
#
|
|
5076
5154
|
#
|
|
5077
5155
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -5168,6 +5246,10 @@ module Aws::S3
|
|
|
5168
5246
|
#
|
|
5169
5247
|
# * [DeleteObject][6]
|
|
5170
5248
|
#
|
|
5249
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5250
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5251
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5252
|
+
#
|
|
5171
5253
|
#
|
|
5172
5254
|
#
|
|
5173
5255
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -5260,6 +5342,10 @@ module Aws::S3
|
|
|
5260
5342
|
#
|
|
5261
5343
|
# * [GetBucketReplication][5]
|
|
5262
5344
|
#
|
|
5345
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5346
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5347
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5348
|
+
#
|
|
5263
5349
|
#
|
|
5264
5350
|
#
|
|
5265
5351
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -5307,7 +5393,14 @@ module Aws::S3
|
|
|
5307
5393
|
#
|
|
5308
5394
|
# </note>
|
|
5309
5395
|
#
|
|
5310
|
-
# Deletes
|
|
5396
|
+
# Deletes tags from the general purpose bucket if attribute based access
|
|
5397
|
+
# control (ABAC) is not enabled for the bucket. When you [enable ABAC
|
|
5398
|
+
# for a general purpose bucket][1], you can no longer use this operation
|
|
5399
|
+
# for that bucket and must use [UntagResource][2] instead.
|
|
5400
|
+
#
|
|
5401
|
+
# if ABAC is not enabled for the bucket. When you [enable ABAC for a
|
|
5402
|
+
# general purpose bucket][1], you can no longer use this operation for
|
|
5403
|
+
# that bucket and must use [UntagResource][2] instead.
|
|
5311
5404
|
#
|
|
5312
5405
|
# To use this operation, you must have permission to perform the
|
|
5313
5406
|
# `s3:PutBucketTagging` action. By default, the bucket owner has this
|
|
@@ -5315,14 +5408,20 @@ module Aws::S3
|
|
|
5315
5408
|
#
|
|
5316
5409
|
# The following operations are related to `DeleteBucketTagging`:
|
|
5317
5410
|
#
|
|
5318
|
-
# * [GetBucketTagging][
|
|
5411
|
+
# * [GetBucketTagging][3]
|
|
5319
5412
|
#
|
|
5320
|
-
# * [PutBucketTagging][
|
|
5413
|
+
# * [PutBucketTagging][4]
|
|
5321
5414
|
#
|
|
5415
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5416
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5417
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5322
5418
|
#
|
|
5323
5419
|
#
|
|
5324
|
-
#
|
|
5325
|
-
# [
|
|
5420
|
+
#
|
|
5421
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
5422
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
5423
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
|
5424
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
5326
5425
|
#
|
|
5327
5426
|
# @option params [required, String] :bucket
|
|
5328
5427
|
# The bucket that has the tag set to be removed.
|
|
@@ -5385,6 +5484,10 @@ module Aws::S3
|
|
|
5385
5484
|
#
|
|
5386
5485
|
# * [PutBucketWebsite][3]
|
|
5387
5486
|
#
|
|
5487
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5488
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5489
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5490
|
+
#
|
|
5388
5491
|
#
|
|
5389
5492
|
#
|
|
5390
5493
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -5507,6 +5610,12 @@ module Aws::S3
|
|
|
5507
5610
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
|
5508
5611
|
# specific version of an object from a versioning-enabled bucket,
|
|
5509
5612
|
# you must have the `s3:DeleteObjectVersion` permission.
|
|
5613
|
+
#
|
|
5614
|
+
# <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
|
|
5615
|
+
# are explicitly denied in your bucket policy, attempts to delete
|
|
5616
|
+
# any unversioned objects result in a `403 Access Denied` error.
|
|
5617
|
+
#
|
|
5618
|
+
# </note>
|
|
5510
5619
|
# * **Directory bucket permissions** - To grant access to this API
|
|
5511
5620
|
# operation on a directory bucket, we recommend that you use the [
|
|
5512
5621
|
# `CreateSession` ][8] API operation for session-based
|
|
@@ -5533,6 +5642,16 @@ module Aws::S3
|
|
|
5533
5642
|
#
|
|
5534
5643
|
# ^
|
|
5535
5644
|
#
|
|
5645
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5646
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5647
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5648
|
+
#
|
|
5649
|
+
# <note markdown="1"> The `If-Match` header is supported for both general purpose and
|
|
5650
|
+
# directory buckets. `IfMatchLastModifiedTime` and `IfMatchSize` is only
|
|
5651
|
+
# supported for directory buckets.
|
|
5652
|
+
#
|
|
5653
|
+
# </note>
|
|
5654
|
+
#
|
|
5536
5655
|
#
|
|
5537
5656
|
#
|
|
5538
5657
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
|
|
@@ -5615,10 +5734,10 @@ module Aws::S3
|
|
|
5615
5734
|
# Confirms that the requester knows that they will be charged for the
|
|
5616
5735
|
# request. Bucket owners need not specify this parameter in their
|
|
5617
5736
|
# requests. If either the source or destination S3 bucket has Requester
|
|
5618
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
5619
|
-
#
|
|
5620
|
-
#
|
|
5621
|
-
#
|
|
5737
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
5738
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
5739
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
5740
|
+
# S3 User Guide*.
|
|
5622
5741
|
#
|
|
5623
5742
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
5624
5743
|
#
|
|
@@ -5643,17 +5762,15 @@ module Aws::S3
|
|
|
5643
5762
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
5644
5763
|
#
|
|
5645
5764
|
# @option params [String] :if_match
|
|
5646
|
-
#
|
|
5647
|
-
#
|
|
5648
|
-
#
|
|
5649
|
-
#
|
|
5650
|
-
# response`.
|
|
5765
|
+
# Deletes the object if the ETag (entity tag) value provided during the
|
|
5766
|
+
# delete operation matches the ETag of the object in S3. If the ETag
|
|
5767
|
+
# values do not match, the operation returns a `412 Precondition Failed`
|
|
5768
|
+
# error.
|
|
5651
5769
|
#
|
|
5652
|
-
#
|
|
5770
|
+
# Expects the ETag value as a string. `If-Match` does accept a string
|
|
5771
|
+
# value of an '*' (asterisk) character to denote a match of any ETag.
|
|
5653
5772
|
#
|
|
5654
|
-
#
|
|
5655
|
-
#
|
|
5656
|
-
# </note>
|
|
5773
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
5657
5774
|
#
|
|
5658
5775
|
#
|
|
5659
5776
|
#
|
|
@@ -5764,6 +5881,10 @@ module Aws::S3
|
|
|
5764
5881
|
#
|
|
5765
5882
|
# * [GetObjectTagging][3]
|
|
5766
5883
|
#
|
|
5884
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5885
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5886
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5887
|
+
#
|
|
5767
5888
|
#
|
|
5768
5889
|
#
|
|
5769
5890
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
|
@@ -5934,6 +6055,12 @@ module Aws::S3
|
|
|
5934
6055
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
|
5935
6056
|
# specific version of an object from a versioning-enabled bucket,
|
|
5936
6057
|
# you must specify the `s3:DeleteObjectVersion` permission.
|
|
6058
|
+
#
|
|
6059
|
+
# <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
|
|
6060
|
+
# are explicitly denied in your bucket policy, attempts to delete
|
|
6061
|
+
# any unversioned objects result in a `403 Access Denied` error.
|
|
6062
|
+
#
|
|
6063
|
+
# </note>
|
|
5937
6064
|
# * **Directory bucket permissions** - To grant access to this API
|
|
5938
6065
|
# operation on a directory bucket, we recommend that you use the [
|
|
5939
6066
|
# `CreateSession` ][4] API operation for session-based
|
|
@@ -5978,6 +6105,10 @@ module Aws::S3
|
|
|
5978
6105
|
#
|
|
5979
6106
|
# * [AbortMultipartUpload][9]
|
|
5980
6107
|
#
|
|
6108
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6109
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6110
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6111
|
+
#
|
|
5981
6112
|
#
|
|
5982
6113
|
#
|
|
5983
6114
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -6065,10 +6196,10 @@ module Aws::S3
|
|
|
6065
6196
|
# Confirms that the requester knows that they will be charged for the
|
|
6066
6197
|
# request. Bucket owners need not specify this parameter in their
|
|
6067
6198
|
# requests. If either the source or destination S3 bucket has Requester
|
|
6068
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
6069
|
-
#
|
|
6070
|
-
#
|
|
6071
|
-
#
|
|
6199
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
6200
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
6201
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
6202
|
+
# S3 User Guide*.
|
|
6072
6203
|
#
|
|
6073
6204
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
6074
6205
|
#
|
|
@@ -6258,7 +6389,10 @@ module Aws::S3
|
|
|
6258
6389
|
# </note>
|
|
6259
6390
|
#
|
|
6260
6391
|
# Removes the `PublicAccessBlock` configuration for an Amazon S3 bucket.
|
|
6261
|
-
#
|
|
6392
|
+
# This operation removes the bucket-level configuration only. The
|
|
6393
|
+
# effective public access behavior will still be governed by
|
|
6394
|
+
# account-level settings (which may inherit from organization-level
|
|
6395
|
+
# policies). To use this operation, you must have the
|
|
6262
6396
|
# `s3:PutBucketPublicAccessBlock` permission. For more information about
|
|
6263
6397
|
# permissions, see [Permissions Related to Bucket Subresource
|
|
6264
6398
|
# Operations][1] and [Managing Access Permissions to Your Amazon S3
|
|
@@ -6274,6 +6408,10 @@ module Aws::S3
|
|
|
6274
6408
|
#
|
|
6275
6409
|
# * [GetBucketPolicyStatus][6]
|
|
6276
6410
|
#
|
|
6411
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6412
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6413
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6414
|
+
#
|
|
6277
6415
|
#
|
|
6278
6416
|
#
|
|
6279
6417
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6310,6 +6448,46 @@ module Aws::S3
|
|
|
6310
6448
|
req.send_request(options)
|
|
6311
6449
|
end
|
|
6312
6450
|
|
|
6451
|
+
# Returns the attribute-based access control (ABAC) property of the
|
|
6452
|
+
# general purpose bucket. If ABAC is enabled on your bucket, you can use
|
|
6453
|
+
# tags on the bucket for access control. For more information, see
|
|
6454
|
+
# [Enabling ABAC in general purpose buckets][1].
|
|
6455
|
+
#
|
|
6456
|
+
#
|
|
6457
|
+
#
|
|
6458
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
6459
|
+
#
|
|
6460
|
+
# @option params [required, String] :bucket
|
|
6461
|
+
# The name of the general purpose bucket.
|
|
6462
|
+
#
|
|
6463
|
+
# @option params [String] :expected_bucket_owner
|
|
6464
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
6465
|
+
# owner.
|
|
6466
|
+
#
|
|
6467
|
+
# @return [Types::GetBucketAbacOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
6468
|
+
#
|
|
6469
|
+
# * {Types::GetBucketAbacOutput#abac_status #abac_status} => Types::AbacStatus
|
|
6470
|
+
#
|
|
6471
|
+
# @example Request syntax with placeholder values
|
|
6472
|
+
#
|
|
6473
|
+
# resp = client.get_bucket_abac({
|
|
6474
|
+
# bucket: "BucketName", # required
|
|
6475
|
+
# expected_bucket_owner: "AccountId",
|
|
6476
|
+
# })
|
|
6477
|
+
#
|
|
6478
|
+
# @example Response structure
|
|
6479
|
+
#
|
|
6480
|
+
# resp.abac_status.status #=> String, one of "Enabled", "Disabled"
|
|
6481
|
+
#
|
|
6482
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAbac AWS API Documentation
|
|
6483
|
+
#
|
|
6484
|
+
# @overload get_bucket_abac(params = {})
|
|
6485
|
+
# @param [Hash] params ({})
|
|
6486
|
+
def get_bucket_abac(params = {}, options = {})
|
|
6487
|
+
req = build_request(:get_bucket_abac, params)
|
|
6488
|
+
req.send_request(options)
|
|
6489
|
+
end
|
|
6490
|
+
|
|
6313
6491
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
6314
6492
|
#
|
|
6315
6493
|
# </note>
|
|
@@ -6346,6 +6524,10 @@ module Aws::S3
|
|
|
6346
6524
|
#
|
|
6347
6525
|
# ^
|
|
6348
6526
|
#
|
|
6527
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6528
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6529
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6530
|
+
#
|
|
6349
6531
|
#
|
|
6350
6532
|
#
|
|
6351
6533
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6366,10 +6548,10 @@ module Aws::S3
|
|
|
6366
6548
|
# Confirms that the requester knows that they will be charged for the
|
|
6367
6549
|
# request. Bucket owners need not specify this parameter in their
|
|
6368
6550
|
# requests. If either the source or destination S3 bucket has Requester
|
|
6369
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
6370
|
-
#
|
|
6371
|
-
#
|
|
6372
|
-
#
|
|
6551
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
6552
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
6553
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
6554
|
+
# S3 User Guide*.
|
|
6373
6555
|
#
|
|
6374
6556
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
6375
6557
|
#
|
|
@@ -6406,19 +6588,6 @@ module Aws::S3
|
|
|
6406
6588
|
req.send_request(options)
|
|
6407
6589
|
end
|
|
6408
6590
|
|
|
6409
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
6410
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
6411
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
6412
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
6413
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
6414
|
-
#
|
|
6415
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
6416
|
-
# East
|
|
6417
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
6418
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
6419
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
6420
|
-
# America (São Paulo) Region.
|
|
6421
|
-
#
|
|
6422
6591
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
6423
6592
|
#
|
|
6424
6593
|
# </note>
|
|
@@ -6448,6 +6617,10 @@ module Aws::S3
|
|
|
6448
6617
|
#
|
|
6449
6618
|
# </note>
|
|
6450
6619
|
#
|
|
6620
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6621
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6622
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6623
|
+
#
|
|
6451
6624
|
# The following operations are related to `GetBucketAcl`:
|
|
6452
6625
|
#
|
|
6453
6626
|
# * [ListObjects][3]
|
|
@@ -6543,6 +6716,10 @@ module Aws::S3
|
|
|
6543
6716
|
#
|
|
6544
6717
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
6545
6718
|
#
|
|
6719
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6720
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6721
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6722
|
+
#
|
|
6546
6723
|
#
|
|
6547
6724
|
#
|
|
6548
6725
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6631,6 +6808,10 @@ module Aws::S3
|
|
|
6631
6808
|
#
|
|
6632
6809
|
# * [DeleteBucketCors][4]
|
|
6633
6810
|
#
|
|
6811
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6812
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6813
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6814
|
+
#
|
|
6634
6815
|
#
|
|
6635
6816
|
#
|
|
6636
6817
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
@@ -6723,17 +6904,19 @@ module Aws::S3
|
|
|
6723
6904
|
|
|
6724
6905
|
# Returns the default encryption configuration for an Amazon S3 bucket.
|
|
6725
6906
|
# By default, all buckets have a default encryption configuration that
|
|
6726
|
-
# uses server-side encryption with Amazon S3 managed keys (SSE-S3).
|
|
6907
|
+
# uses server-side encryption with Amazon S3 managed keys (SSE-S3). This
|
|
6908
|
+
# operation also returns the [BucketKeyEnabled][1] and
|
|
6909
|
+
# [BlockedEncryptionTypes][2] statuses.
|
|
6727
6910
|
#
|
|
6728
6911
|
# <note markdown="1"> * **General purpose buckets** - For information about the bucket
|
|
6729
6912
|
# default encryption feature, see [Amazon S3 Bucket Default
|
|
6730
|
-
# Encryption][
|
|
6913
|
+
# Encryption][3] in the *Amazon S3 User Guide*.
|
|
6731
6914
|
#
|
|
6732
6915
|
# * **Directory buckets** - For directory buckets, there are only two
|
|
6733
6916
|
# supported options for server-side encryption: SSE-S3 and SSE-KMS.
|
|
6734
6917
|
# For information about the default encryption configuration in
|
|
6735
6918
|
# directory buckets, see [Setting default server-side encryption
|
|
6736
|
-
# behavior for directory buckets][
|
|
6919
|
+
# behavior for directory buckets][4].
|
|
6737
6920
|
#
|
|
6738
6921
|
# </note>
|
|
6739
6922
|
#
|
|
@@ -6743,8 +6926,8 @@ module Aws::S3
|
|
|
6743
6926
|
# policy. The bucket owner has this permission by default. The
|
|
6744
6927
|
# bucket owner can grant this permission to others. For more
|
|
6745
6928
|
# information about permissions, see [Permissions Related to Bucket
|
|
6746
|
-
# Operations][
|
|
6747
|
-
# Resources][
|
|
6929
|
+
# Operations][5] and [Managing Access Permissions to Your Amazon S3
|
|
6930
|
+
# Resources][6].
|
|
6748
6931
|
#
|
|
6749
6932
|
# * **Directory bucket permissions** - To grant access to this API
|
|
6750
6933
|
# operation, you must have the
|
|
@@ -6754,7 +6937,7 @@ module Aws::S3
|
|
|
6754
6937
|
# only be performed by the Amazon Web Services account that owns the
|
|
6755
6938
|
# resource. For more information about directory bucket policies and
|
|
6756
6939
|
# permissions, see [Amazon Web Services Identity and Access
|
|
6757
|
-
# Management (IAM) for S3 Express One Zone][
|
|
6940
|
+
# Management (IAM) for S3 Express One Zone][7] in the *Amazon S3
|
|
6758
6941
|
# User Guide*.
|
|
6759
6942
|
#
|
|
6760
6943
|
# HTTP Host header syntax
|
|
@@ -6764,19 +6947,25 @@ module Aws::S3
|
|
|
6764
6947
|
#
|
|
6765
6948
|
# The following operations are related to `GetBucketEncryption`:
|
|
6766
6949
|
#
|
|
6767
|
-
# * [PutBucketEncryption][
|
|
6950
|
+
# * [PutBucketEncryption][8]
|
|
6768
6951
|
#
|
|
6769
|
-
# * [DeleteBucketEncryption][
|
|
6952
|
+
# * [DeleteBucketEncryption][9]
|
|
6770
6953
|
#
|
|
6954
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6955
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6956
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6771
6957
|
#
|
|
6772
6958
|
#
|
|
6773
|
-
#
|
|
6774
|
-
# [
|
|
6775
|
-
# [
|
|
6776
|
-
# [
|
|
6777
|
-
# [
|
|
6778
|
-
# [
|
|
6779
|
-
# [
|
|
6959
|
+
#
|
|
6960
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ServerSideEncryptionRule.html#AmazonS3-Type-ServerSideEncryptionRule-BucketKeyEnabled
|
|
6961
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ServerSideEncryptionRule.html#AmazonS3-Type-ServerSideEncryptionRule-BlockedEncryptionTypes
|
|
6962
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html
|
|
6963
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html
|
|
6964
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
6965
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
6966
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
|
6967
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
|
6968
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
6780
6969
|
#
|
|
6781
6970
|
# @option params [required, String] :bucket
|
|
6782
6971
|
# The name of the bucket from which the server-side encryption
|
|
@@ -6825,6 +7014,8 @@ module Aws::S3
|
|
|
6825
7014
|
# resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.sse_algorithm #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
|
6826
7015
|
# resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.kms_master_key_id #=> String
|
|
6827
7016
|
# resp.server_side_encryption_configuration.rules[0].bucket_key_enabled #=> Boolean
|
|
7017
|
+
# resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type #=> Array
|
|
7018
|
+
# resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type[0] #=> String, one of "NONE", "SSE-C"
|
|
6828
7019
|
#
|
|
6829
7020
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption AWS API Documentation
|
|
6830
7021
|
#
|
|
@@ -6870,6 +7061,10 @@ module Aws::S3
|
|
|
6870
7061
|
#
|
|
6871
7062
|
# * [ListBucketIntelligentTieringConfigurations][4]
|
|
6872
7063
|
#
|
|
7064
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7065
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7066
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7067
|
+
#
|
|
6873
7068
|
#
|
|
6874
7069
|
#
|
|
6875
7070
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -6951,6 +7146,10 @@ module Aws::S3
|
|
|
6951
7146
|
#
|
|
6952
7147
|
# * [PutBucketInventoryConfiguration][6]
|
|
6953
7148
|
#
|
|
7149
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7150
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7151
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7152
|
+
#
|
|
6954
7153
|
#
|
|
6955
7154
|
#
|
|
6956
7155
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6996,7 +7195,7 @@ module Aws::S3
|
|
|
6996
7195
|
# resp.inventory_configuration.id #=> String
|
|
6997
7196
|
# resp.inventory_configuration.included_object_versions #=> String, one of "All", "Current"
|
|
6998
7197
|
# resp.inventory_configuration.optional_fields #=> Array
|
|
6999
|
-
# resp.inventory_configuration.optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner"
|
|
7198
|
+
# resp.inventory_configuration.optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner", "LifecycleExpirationDate"
|
|
7000
7199
|
# resp.inventory_configuration.schedule.frequency #=> String, one of "Daily", "Weekly"
|
|
7001
7200
|
#
|
|
7002
7201
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration AWS API Documentation
|
|
@@ -7047,6 +7246,10 @@ module Aws::S3
|
|
|
7047
7246
|
#
|
|
7048
7247
|
# * [DeleteBucketLifecycle][6]
|
|
7049
7248
|
#
|
|
7249
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7250
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7251
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7252
|
+
#
|
|
7050
7253
|
#
|
|
7051
7254
|
#
|
|
7052
7255
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
|
@@ -7208,6 +7411,10 @@ module Aws::S3
|
|
|
7208
7411
|
#
|
|
7209
7412
|
# * [DeleteBucketLifecycle][8]
|
|
7210
7413
|
#
|
|
7414
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7415
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7416
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7417
|
+
#
|
|
7211
7418
|
#
|
|
7212
7419
|
#
|
|
7213
7420
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
|
@@ -7312,13 +7519,25 @@ module Aws::S3
|
|
|
7312
7519
|
req.send_request(options)
|
|
7313
7520
|
end
|
|
7314
7521
|
|
|
7315
|
-
#
|
|
7316
|
-
#
|
|
7317
|
-
#
|
|
7522
|
+
# Using the `GetBucketLocation` operation is no longer a best practice.
|
|
7523
|
+
# To return the Region that a bucket resides in, we recommend that you
|
|
7524
|
+
# use the [HeadBucket][1] operation instead. For backward compatibility,
|
|
7525
|
+
# Amazon S3 continues to support the `GetBucketLocation` operation.
|
|
7318
7526
|
#
|
|
7319
7527
|
# Returns the Region the bucket resides in. You set the bucket's Region
|
|
7320
7528
|
# using the `LocationConstraint` request parameter in a `CreateBucket`
|
|
7321
|
-
# request. For more information, see [CreateBucket][
|
|
7529
|
+
# request. For more information, see [CreateBucket][2].
|
|
7530
|
+
#
|
|
7531
|
+
# <note markdown="1"> In a bucket's home Region, calls to the `GetBucketLocation` operation
|
|
7532
|
+
# are governed by the bucket's policy. In other Regions, the bucket
|
|
7533
|
+
# policy doesn't apply, which means that cross-account access won't be
|
|
7534
|
+
# authorized. However, calls to the `HeadBucket` operation always return
|
|
7535
|
+
# the bucket’s location through an HTTP response header, whether access
|
|
7536
|
+
# to the bucket is authorized or not. Therefore, we recommend using the
|
|
7537
|
+
# `HeadBucket` operation for bucket Region discovery and to avoid using
|
|
7538
|
+
# the `GetBucketLocation` operation.
|
|
7539
|
+
#
|
|
7540
|
+
# </note>
|
|
7322
7541
|
#
|
|
7323
7542
|
# When you use this API operation with an access point, provide the
|
|
7324
7543
|
# alias of the access point in place of the bucket name.
|
|
@@ -7328,11 +7547,9 @@ module Aws::S3
|
|
|
7328
7547
|
# bucket name. If the Object Lambda access point alias in a request is
|
|
7329
7548
|
# not valid, the error code `InvalidAccessPointAliasError` is returned.
|
|
7330
7549
|
# For more information about `InvalidAccessPointAliasError`, see [List
|
|
7331
|
-
# of Error Codes][
|
|
7550
|
+
# of Error Codes][3].
|
|
7332
7551
|
#
|
|
7333
|
-
# <note markdown="1">
|
|
7334
|
-
# bucket resides in. For backward compatibility, Amazon S3 continues to
|
|
7335
|
-
# support GetBucketLocation.
|
|
7552
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
7336
7553
|
#
|
|
7337
7554
|
# </note>
|
|
7338
7555
|
#
|
|
@@ -7340,13 +7557,17 @@ module Aws::S3
|
|
|
7340
7557
|
#
|
|
7341
7558
|
# * [GetObject][4]
|
|
7342
7559
|
#
|
|
7343
|
-
# * [CreateBucket][
|
|
7560
|
+
# * [CreateBucket][2]
|
|
7344
7561
|
#
|
|
7562
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7563
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7564
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7345
7565
|
#
|
|
7346
7566
|
#
|
|
7347
|
-
#
|
|
7348
|
-
# [
|
|
7349
|
-
# [
|
|
7567
|
+
#
|
|
7568
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
|
|
7569
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
|
7570
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
7350
7571
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
7351
7572
|
#
|
|
7352
7573
|
# @option params [required, String] :bucket
|
|
@@ -7409,19 +7630,6 @@ module Aws::S3
|
|
|
7409
7630
|
req.send_request(options)
|
|
7410
7631
|
end
|
|
7411
7632
|
|
|
7412
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
7413
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
7414
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
7415
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
7416
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
7417
|
-
#
|
|
7418
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
7419
|
-
# East
|
|
7420
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
7421
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
7422
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
7423
|
-
# America (São Paulo) Region.
|
|
7424
|
-
#
|
|
7425
7633
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
7426
7634
|
#
|
|
7427
7635
|
# </note>
|
|
@@ -7435,6 +7643,10 @@ module Aws::S3
|
|
|
7435
7643
|
#
|
|
7436
7644
|
# * [PutBucketLogging][2]
|
|
7437
7645
|
#
|
|
7646
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7647
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7648
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7649
|
+
#
|
|
7438
7650
|
#
|
|
7439
7651
|
#
|
|
7440
7652
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
|
@@ -7516,6 +7728,10 @@ module Aws::S3
|
|
|
7516
7728
|
#
|
|
7517
7729
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
7518
7730
|
#
|
|
7731
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7732
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7733
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7734
|
+
#
|
|
7519
7735
|
#
|
|
7520
7736
|
#
|
|
7521
7737
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -7614,6 +7830,10 @@ module Aws::S3
|
|
|
7614
7830
|
#
|
|
7615
7831
|
# * [DeleteBucketMetadataTableConfiguration][6]
|
|
7616
7832
|
#
|
|
7833
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7834
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7835
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7836
|
+
#
|
|
7617
7837
|
#
|
|
7618
7838
|
#
|
|
7619
7839
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
|
|
@@ -7690,6 +7910,10 @@ module Aws::S3
|
|
|
7690
7910
|
#
|
|
7691
7911
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
|
7692
7912
|
#
|
|
7913
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7914
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7915
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7916
|
+
#
|
|
7693
7917
|
#
|
|
7694
7918
|
#
|
|
7695
7919
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -7913,6 +8137,10 @@ module Aws::S3
|
|
|
7913
8137
|
#
|
|
7914
8138
|
# ^
|
|
7915
8139
|
#
|
|
8140
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8141
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8142
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8143
|
+
#
|
|
7916
8144
|
#
|
|
7917
8145
|
#
|
|
7918
8146
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
@@ -8026,6 +8254,10 @@ module Aws::S3
|
|
|
8026
8254
|
#
|
|
8027
8255
|
# * DeleteBucketOwnershipControls
|
|
8028
8256
|
#
|
|
8257
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8258
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8259
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8260
|
+
#
|
|
8029
8261
|
#
|
|
8030
8262
|
#
|
|
8031
8263
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html
|
|
@@ -8137,6 +8369,10 @@ module Aws::S3
|
|
|
8137
8369
|
#
|
|
8138
8370
|
# ^
|
|
8139
8371
|
#
|
|
8372
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8373
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8374
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8375
|
+
#
|
|
8140
8376
|
#
|
|
8141
8377
|
#
|
|
8142
8378
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -8207,7 +8443,7 @@ module Aws::S3
|
|
|
8207
8443
|
#
|
|
8208
8444
|
# resp.to_h outputs the following:
|
|
8209
8445
|
# {
|
|
8210
|
-
# policy: "{\"Version\":\"2008-10-17\"
|
|
8446
|
+
# policy: "{\"Version\":\"2008-10-17\",&TCX5-2025-waiver;\"Id\":\"LogPolicy\",\"Statement\":[{\"Sid\":\"Enables the log delivery group to publish logs to your bucket \",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"111122223333\"},\"Action\":[\"s3:GetBucketAcl\",\"s3:GetObjectAcl\",\"s3:PutObject\"],\"Resource\":[\"arn:aws:s3:::policytest1/*\",\"arn:aws:s3:::policytest1\"]}]}",
|
|
8211
8447
|
# }
|
|
8212
8448
|
#
|
|
8213
8449
|
# @example Request syntax with placeholder values
|
|
@@ -8253,6 +8489,10 @@ module Aws::S3
|
|
|
8253
8489
|
#
|
|
8254
8490
|
# * [DeletePublicAccessBlock][6]
|
|
8255
8491
|
#
|
|
8492
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8493
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8494
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8495
|
+
#
|
|
8256
8496
|
#
|
|
8257
8497
|
#
|
|
8258
8498
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -8327,6 +8567,10 @@ module Aws::S3
|
|
|
8327
8567
|
#
|
|
8328
8568
|
# * [DeleteBucketReplication][5]
|
|
8329
8569
|
#
|
|
8570
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8571
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8572
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8573
|
+
#
|
|
8330
8574
|
#
|
|
8331
8575
|
#
|
|
8332
8576
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
@@ -8400,7 +8644,7 @@ module Aws::S3
|
|
|
8400
8644
|
# resp.replication_configuration.rules[0].existing_object_replication.status #=> String, one of "Enabled", "Disabled"
|
|
8401
8645
|
# resp.replication_configuration.rules[0].destination.bucket #=> String
|
|
8402
8646
|
# resp.replication_configuration.rules[0].destination.account #=> String
|
|
8403
|
-
# resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
8647
|
+
# resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
8404
8648
|
# resp.replication_configuration.rules[0].destination.access_control_translation.owner #=> String, one of "Destination"
|
|
8405
8649
|
# resp.replication_configuration.rules[0].destination.encryption_configuration.replica_kms_key_id #=> String
|
|
8406
8650
|
# resp.replication_configuration.rules[0].destination.replication_time.status #=> String, one of "Enabled", "Disabled"
|
|
@@ -8432,6 +8676,10 @@ module Aws::S3
|
|
|
8432
8676
|
#
|
|
8433
8677
|
# ^
|
|
8434
8678
|
#
|
|
8679
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8680
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8681
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8682
|
+
#
|
|
8435
8683
|
#
|
|
8436
8684
|
#
|
|
8437
8685
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
|
@@ -8488,7 +8736,11 @@ module Aws::S3
|
|
|
8488
8736
|
#
|
|
8489
8737
|
# </note>
|
|
8490
8738
|
#
|
|
8491
|
-
# Returns the tag set associated with the bucket.
|
|
8739
|
+
# Returns the tag set associated with the general purpose bucket.
|
|
8740
|
+
#
|
|
8741
|
+
# if ABAC is not enabled for the bucket. When you [enable ABAC for a
|
|
8742
|
+
# general purpose bucket][1], you can no longer use this operation for
|
|
8743
|
+
# that bucket and must use [ListTagsForResource][2] instead.
|
|
8492
8744
|
#
|
|
8493
8745
|
# To use this operation, you must have permission to perform the
|
|
8494
8746
|
# `s3:GetBucketTagging` action. By default, the bucket owner has this
|
|
@@ -8504,14 +8756,20 @@ module Aws::S3
|
|
|
8504
8756
|
#
|
|
8505
8757
|
# The following operations are related to `GetBucketTagging`:
|
|
8506
8758
|
#
|
|
8507
|
-
# * [PutBucketTagging][
|
|
8759
|
+
# * [PutBucketTagging][3]
|
|
8508
8760
|
#
|
|
8509
|
-
# * [DeleteBucketTagging][
|
|
8761
|
+
# * [DeleteBucketTagging][4]
|
|
8510
8762
|
#
|
|
8763
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8764
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8765
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8511
8766
|
#
|
|
8512
8767
|
#
|
|
8513
|
-
#
|
|
8514
|
-
# [
|
|
8768
|
+
#
|
|
8769
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
8770
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html
|
|
8771
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
8772
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
8515
8773
|
#
|
|
8516
8774
|
# @option params [required, String] :bucket
|
|
8517
8775
|
# The name of the bucket for which to get the tagging information.
|
|
@@ -8592,6 +8850,10 @@ module Aws::S3
|
|
|
8592
8850
|
#
|
|
8593
8851
|
# * [DeleteObject][3]
|
|
8594
8852
|
#
|
|
8853
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8854
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8855
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8856
|
+
#
|
|
8595
8857
|
#
|
|
8596
8858
|
#
|
|
8597
8859
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
@@ -8668,6 +8930,10 @@ module Aws::S3
|
|
|
8668
8930
|
#
|
|
8669
8931
|
# * [PutBucketWebsite][3]
|
|
8670
8932
|
#
|
|
8933
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8934
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8935
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8936
|
+
#
|
|
8671
8937
|
#
|
|
8672
8938
|
#
|
|
8673
8939
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -8902,6 +9168,10 @@ module Aws::S3
|
|
|
8902
9168
|
#
|
|
8903
9169
|
# * [GetObjectAcl][10]
|
|
8904
9170
|
#
|
|
9171
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
9172
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
9173
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
9174
|
+
#
|
|
8905
9175
|
#
|
|
8906
9176
|
#
|
|
8907
9177
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
|
@@ -9184,10 +9454,10 @@ module Aws::S3
|
|
|
9184
9454
|
# Confirms that the requester knows that they will be charged for the
|
|
9185
9455
|
# request. Bucket owners need not specify this parameter in their
|
|
9186
9456
|
# requests. If either the source or destination S3 bucket has Requester
|
|
9187
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
9188
|
-
#
|
|
9189
|
-
#
|
|
9190
|
-
#
|
|
9457
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
9458
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
9459
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
9460
|
+
# S3 User Guide*.
|
|
9191
9461
|
#
|
|
9192
9462
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
9193
9463
|
#
|
|
@@ -9389,7 +9659,7 @@ module Aws::S3
|
|
|
9389
9659
|
# resp.sse_customer_key_md5 #=> String
|
|
9390
9660
|
# resp.ssekms_key_id #=> String
|
|
9391
9661
|
# resp.bucket_key_enabled #=> Boolean
|
|
9392
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
9662
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
9393
9663
|
# resp.request_charged #=> String, one of "requester"
|
|
9394
9664
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
|
|
9395
9665
|
# resp.parts_count #=> Integer
|
|
@@ -9441,6 +9711,10 @@ module Aws::S3
|
|
|
9441
9711
|
#
|
|
9442
9712
|
# * [PutObject][6]
|
|
9443
9713
|
#
|
|
9714
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
9715
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
9716
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
9717
|
+
#
|
|
9444
9718
|
#
|
|
9445
9719
|
#
|
|
9446
9720
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#acl-access-policy-permission-mapping
|
|
@@ -9485,10 +9759,10 @@ module Aws::S3
|
|
|
9485
9759
|
# Confirms that the requester knows that they will be charged for the
|
|
9486
9760
|
# request. Bucket owners need not specify this parameter in their
|
|
9487
9761
|
# requests. If either the source or destination S3 bucket has Requester
|
|
9488
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
9489
|
-
#
|
|
9490
|
-
#
|
|
9491
|
-
#
|
|
9762
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
9763
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
9764
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
9765
|
+
# S3 User Guide*.
|
|
9492
9766
|
#
|
|
9493
9767
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
9494
9768
|
#
|
|
@@ -9764,6 +10038,10 @@ module Aws::S3
|
|
|
9764
10038
|
#
|
|
9765
10039
|
# * [ListParts][16]
|
|
9766
10040
|
#
|
|
10041
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10042
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10043
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10044
|
+
#
|
|
9767
10045
|
#
|
|
9768
10046
|
#
|
|
9769
10047
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -9892,10 +10170,10 @@ module Aws::S3
|
|
|
9892
10170
|
# Confirms that the requester knows that they will be charged for the
|
|
9893
10171
|
# request. Bucket owners need not specify this parameter in their
|
|
9894
10172
|
# requests. If either the source or destination S3 bucket has Requester
|
|
9895
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
9896
|
-
#
|
|
9897
|
-
#
|
|
9898
|
-
#
|
|
10173
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
10174
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
10175
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
10176
|
+
# S3 User Guide*.
|
|
9899
10177
|
#
|
|
9900
10178
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
9901
10179
|
#
|
|
@@ -9968,7 +10246,7 @@ module Aws::S3
|
|
|
9968
10246
|
# resp.object_parts.parts[0].checksum_crc64nvme #=> String
|
|
9969
10247
|
# resp.object_parts.parts[0].checksum_sha1 #=> String
|
|
9970
10248
|
# resp.object_parts.parts[0].checksum_sha256 #=> String
|
|
9971
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
10249
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
9972
10250
|
# resp.object_size #=> Integer
|
|
9973
10251
|
#
|
|
9974
10252
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributes AWS API Documentation
|
|
@@ -9995,6 +10273,10 @@ module Aws::S3
|
|
|
9995
10273
|
#
|
|
9996
10274
|
# ^
|
|
9997
10275
|
#
|
|
10276
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10277
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10278
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10279
|
+
#
|
|
9998
10280
|
#
|
|
9999
10281
|
#
|
|
10000
10282
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10033,10 +10315,10 @@ module Aws::S3
|
|
|
10033
10315
|
# Confirms that the requester knows that they will be charged for the
|
|
10034
10316
|
# request. Bucket owners need not specify this parameter in their
|
|
10035
10317
|
# requests. If either the source or destination S3 bucket has Requester
|
|
10036
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
10037
|
-
#
|
|
10038
|
-
#
|
|
10039
|
-
#
|
|
10318
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
10319
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
10320
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
10321
|
+
# S3 User Guide*.
|
|
10040
10322
|
#
|
|
10041
10323
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
10042
10324
|
#
|
|
@@ -10093,6 +10375,10 @@ module Aws::S3
|
|
|
10093
10375
|
#
|
|
10094
10376
|
# ^
|
|
10095
10377
|
#
|
|
10378
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10379
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10380
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10381
|
+
#
|
|
10096
10382
|
#
|
|
10097
10383
|
#
|
|
10098
10384
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10165,6 +10451,10 @@ module Aws::S3
|
|
|
10165
10451
|
#
|
|
10166
10452
|
# ^
|
|
10167
10453
|
#
|
|
10454
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10455
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10456
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10457
|
+
#
|
|
10168
10458
|
#
|
|
10169
10459
|
#
|
|
10170
10460
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10203,10 +10493,10 @@ module Aws::S3
|
|
|
10203
10493
|
# Confirms that the requester knows that they will be charged for the
|
|
10204
10494
|
# request. Bucket owners need not specify this parameter in their
|
|
10205
10495
|
# requests. If either the source or destination S3 bucket has Requester
|
|
10206
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
10207
|
-
#
|
|
10208
|
-
#
|
|
10209
|
-
#
|
|
10496
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
10497
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
10498
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
10499
|
+
# S3 User Guide*.
|
|
10210
10500
|
#
|
|
10211
10501
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
10212
10502
|
#
|
|
@@ -10277,6 +10567,10 @@ module Aws::S3
|
|
|
10277
10567
|
#
|
|
10278
10568
|
# * [PutObjectTagging][4]
|
|
10279
10569
|
#
|
|
10570
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10571
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10572
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10573
|
+
#
|
|
10280
10574
|
#
|
|
10281
10575
|
#
|
|
10282
10576
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
|
@@ -10330,10 +10624,10 @@ module Aws::S3
|
|
|
10330
10624
|
# Confirms that the requester knows that they will be charged for the
|
|
10331
10625
|
# request. Bucket owners need not specify this parameter in their
|
|
10332
10626
|
# requests. If either the source or destination S3 bucket has Requester
|
|
10333
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
10334
|
-
#
|
|
10335
|
-
#
|
|
10336
|
-
#
|
|
10627
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
10628
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
10629
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
10630
|
+
# S3 User Guide*.
|
|
10337
10631
|
#
|
|
10338
10632
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
10339
10633
|
#
|
|
@@ -10443,6 +10737,10 @@ module Aws::S3
|
|
|
10443
10737
|
#
|
|
10444
10738
|
# ^
|
|
10445
10739
|
#
|
|
10740
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10741
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10742
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10743
|
+
#
|
|
10446
10744
|
#
|
|
10447
10745
|
#
|
|
10448
10746
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
@@ -10461,10 +10759,10 @@ module Aws::S3
|
|
|
10461
10759
|
# Confirms that the requester knows that they will be charged for the
|
|
10462
10760
|
# request. Bucket owners need not specify this parameter in their
|
|
10463
10761
|
# requests. If either the source or destination S3 bucket has Requester
|
|
10464
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
10465
|
-
#
|
|
10466
|
-
#
|
|
10467
|
-
#
|
|
10762
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
10763
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
10764
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
10765
|
+
# S3 User Guide*.
|
|
10468
10766
|
#
|
|
10469
10767
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
10470
10768
|
#
|
|
@@ -10526,17 +10824,21 @@ module Aws::S3
|
|
|
10526
10824
|
# </note>
|
|
10527
10825
|
#
|
|
10528
10826
|
# Retrieves the `PublicAccessBlock` configuration for an Amazon S3
|
|
10529
|
-
# bucket.
|
|
10827
|
+
# bucket. This operation returns the bucket-level configuration only. To
|
|
10828
|
+
# understand the effective public access behavior, you must also
|
|
10829
|
+
# consider account-level settings (which may inherit from
|
|
10830
|
+
# organization-level policies). To use this operation, you must have the
|
|
10530
10831
|
# `s3:GetBucketPublicAccessBlock` permission. For more information about
|
|
10531
10832
|
# Amazon S3 permissions, see [Specifying Permissions in a Policy][1].
|
|
10532
10833
|
#
|
|
10533
10834
|
# When Amazon S3 evaluates the `PublicAccessBlock` configuration for a
|
|
10534
10835
|
# bucket or an object, it checks the `PublicAccessBlock` configuration
|
|
10535
10836
|
# for both the bucket (or the bucket that contains the object) and the
|
|
10536
|
-
# bucket owner's account.
|
|
10537
|
-
#
|
|
10538
|
-
#
|
|
10539
|
-
#
|
|
10837
|
+
# bucket owner's account. Account-level settings automatically inherit
|
|
10838
|
+
# from organization-level policies when present. If the
|
|
10839
|
+
# `PublicAccessBlock` settings are different between the bucket and the
|
|
10840
|
+
# account, Amazon S3 uses the most restrictive combination of the
|
|
10841
|
+
# bucket-level and account-level settings.
|
|
10540
10842
|
#
|
|
10541
10843
|
# For more information about when Amazon S3 considers a bucket or an
|
|
10542
10844
|
# object public, see [The Meaning of "Public"][2].
|
|
@@ -10551,6 +10853,10 @@ module Aws::S3
|
|
|
10551
10853
|
#
|
|
10552
10854
|
# * [DeletePublicAccessBlock][6]
|
|
10553
10855
|
#
|
|
10856
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10857
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10858
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10859
|
+
#
|
|
10554
10860
|
#
|
|
10555
10861
|
#
|
|
10556
10862
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -10597,13 +10903,19 @@ module Aws::S3
|
|
|
10597
10903
|
end
|
|
10598
10904
|
|
|
10599
10905
|
# You can use this operation to determine if a bucket exists and if you
|
|
10600
|
-
# have permission to access it. The action returns a `200 OK`
|
|
10601
|
-
# bucket exists and you have permission to access it.
|
|
10602
|
-
#
|
|
10603
|
-
#
|
|
10906
|
+
# have permission to access it. The action returns a `200 OK` HTTP
|
|
10907
|
+
# status code if the bucket exists and you have permission to access it.
|
|
10908
|
+
# You can make a `HeadBucket` call on any bucket name to any Region in
|
|
10909
|
+
# the partition, and regardless of the permissions on the bucket, you
|
|
10910
|
+
# will receive a response header with the correct bucket location so
|
|
10911
|
+
# that you can then make a proper, signed request to the appropriate
|
|
10912
|
+
# Regional endpoint.
|
|
10913
|
+
#
|
|
10914
|
+
# <note markdown="1"> If the bucket doesn't exist or you don't have permission to access
|
|
10604
10915
|
# it, the `HEAD` request returns a generic `400 Bad Request`, `403
|
|
10605
|
-
# Forbidden
|
|
10606
|
-
# you
|
|
10916
|
+
# Forbidden`, or `404 Not Found` HTTP status code. A message body isn't
|
|
10917
|
+
# included, so you can't determine the exception beyond these HTTP
|
|
10918
|
+
# response codes.
|
|
10607
10919
|
#
|
|
10608
10920
|
# </note>
|
|
10609
10921
|
#
|
|
@@ -10666,6 +10978,10 @@ module Aws::S3
|
|
|
10666
10978
|
#
|
|
10667
10979
|
# </note>
|
|
10668
10980
|
#
|
|
10981
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10982
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10983
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10984
|
+
#
|
|
10669
10985
|
#
|
|
10670
10986
|
#
|
|
10671
10987
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
|
@@ -10926,6 +11242,10 @@ module Aws::S3
|
|
|
10926
11242
|
#
|
|
10927
11243
|
# * [GetObjectAttributes][9]
|
|
10928
11244
|
#
|
|
11245
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11246
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11247
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11248
|
+
#
|
|
10929
11249
|
#
|
|
10930
11250
|
#
|
|
10931
11251
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
|
|
@@ -11126,10 +11446,10 @@ module Aws::S3
|
|
|
11126
11446
|
# Confirms that the requester knows that they will be charged for the
|
|
11127
11447
|
# request. Bucket owners need not specify this parameter in their
|
|
11128
11448
|
# requests. If either the source or destination S3 bucket has Requester
|
|
11129
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
11130
|
-
#
|
|
11131
|
-
#
|
|
11132
|
-
#
|
|
11449
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
11450
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
11451
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
11452
|
+
# S3 User Guide*.
|
|
11133
11453
|
#
|
|
11134
11454
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
11135
11455
|
#
|
|
@@ -11292,7 +11612,7 @@ module Aws::S3
|
|
|
11292
11612
|
# resp.sse_customer_key_md5 #=> String
|
|
11293
11613
|
# resp.ssekms_key_id #=> String
|
|
11294
11614
|
# resp.bucket_key_enabled #=> Boolean
|
|
11295
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
11615
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
11296
11616
|
# resp.request_charged #=> String, one of "requester"
|
|
11297
11617
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
|
|
11298
11618
|
# resp.parts_count #=> Integer
|
|
@@ -11351,6 +11671,10 @@ module Aws::S3
|
|
|
11351
11671
|
#
|
|
11352
11672
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
11353
11673
|
#
|
|
11674
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11675
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11676
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11677
|
+
#
|
|
11354
11678
|
#
|
|
11355
11679
|
#
|
|
11356
11680
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11452,6 +11776,10 @@ module Aws::S3
|
|
|
11452
11776
|
#
|
|
11453
11777
|
# * [GetBucketIntelligentTieringConfiguration][4]
|
|
11454
11778
|
#
|
|
11779
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11780
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11781
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11782
|
+
#
|
|
11455
11783
|
#
|
|
11456
11784
|
#
|
|
11457
11785
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -11520,7 +11848,7 @@ module Aws::S3
|
|
|
11520
11848
|
# </note>
|
|
11521
11849
|
#
|
|
11522
11850
|
# Returns a list of S3 Inventory configurations for the bucket. You can
|
|
11523
|
-
# have up to 1,000
|
|
11851
|
+
# have up to 1,000 inventory configurations per bucket.
|
|
11524
11852
|
#
|
|
11525
11853
|
# This action supports list pagination and does not return more than 100
|
|
11526
11854
|
# configurations at a time. Always check the `IsTruncated` element in
|
|
@@ -11550,6 +11878,10 @@ module Aws::S3
|
|
|
11550
11878
|
#
|
|
11551
11879
|
# * [PutBucketInventoryConfiguration][6]
|
|
11552
11880
|
#
|
|
11881
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11882
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11883
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11884
|
+
#
|
|
11553
11885
|
#
|
|
11554
11886
|
#
|
|
11555
11887
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11603,7 +11935,7 @@ module Aws::S3
|
|
|
11603
11935
|
# resp.inventory_configuration_list[0].id #=> String
|
|
11604
11936
|
# resp.inventory_configuration_list[0].included_object_versions #=> String, one of "All", "Current"
|
|
11605
11937
|
# resp.inventory_configuration_list[0].optional_fields #=> Array
|
|
11606
|
-
# resp.inventory_configuration_list[0].optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner"
|
|
11938
|
+
# resp.inventory_configuration_list[0].optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner", "LifecycleExpirationDate"
|
|
11607
11939
|
# resp.inventory_configuration_list[0].schedule.frequency #=> String, one of "Daily", "Weekly"
|
|
11608
11940
|
# resp.is_truncated #=> Boolean
|
|
11609
11941
|
# resp.next_continuation_token #=> String
|
|
@@ -11654,6 +11986,10 @@ module Aws::S3
|
|
|
11654
11986
|
#
|
|
11655
11987
|
# * [DeleteBucketMetricsConfiguration][6]
|
|
11656
11988
|
#
|
|
11989
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11990
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11991
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11992
|
+
#
|
|
11657
11993
|
#
|
|
11658
11994
|
#
|
|
11659
11995
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11719,19 +12055,6 @@ module Aws::S3
|
|
|
11719
12055
|
req.send_request(options)
|
|
11720
12056
|
end
|
|
11721
12057
|
|
|
11722
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
11723
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
11724
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
11725
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
11726
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
11727
|
-
#
|
|
11728
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
11729
|
-
# East
|
|
11730
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
11731
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
11732
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
11733
|
-
# America (São Paulo) Region.
|
|
11734
|
-
#
|
|
11735
12058
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
11736
12059
|
#
|
|
11737
12060
|
# </note>
|
|
@@ -11752,6 +12075,10 @@ module Aws::S3
|
|
|
11752
12075
|
# rejected for Amazon Web Services accounts with a general purpose
|
|
11753
12076
|
# bucket quota greater than 10,000.
|
|
11754
12077
|
#
|
|
12078
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12079
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12080
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12081
|
+
#
|
|
11755
12082
|
#
|
|
11756
12083
|
#
|
|
11757
12084
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
|
|
@@ -11910,6 +12237,10 @@ module Aws::S3
|
|
|
11910
12237
|
#
|
|
11911
12238
|
# </note>
|
|
11912
12239
|
#
|
|
12240
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12241
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12242
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12243
|
+
#
|
|
11913
12244
|
#
|
|
11914
12245
|
#
|
|
11915
12246
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
|
@@ -11960,19 +12291,6 @@ module Aws::S3
|
|
|
11960
12291
|
req.send_request(options)
|
|
11961
12292
|
end
|
|
11962
12293
|
|
|
11963
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
11964
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
11965
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
11966
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
11967
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
11968
|
-
#
|
|
11969
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
11970
|
-
# East
|
|
11971
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
11972
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
11973
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
11974
|
-
# America (São Paulo) Region.
|
|
11975
|
-
#
|
|
11976
12294
|
# This operation lists in-progress multipart uploads in a bucket. An
|
|
11977
12295
|
# in-progress multipart upload is a multipart upload that has been
|
|
11978
12296
|
# initiated by the `CreateMultipartUpload` request, but has not yet been
|
|
@@ -12081,6 +12399,10 @@ module Aws::S3
|
|
|
12081
12399
|
#
|
|
12082
12400
|
# * [AbortMultipartUpload][10]
|
|
12083
12401
|
#
|
|
12402
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12403
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12404
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12405
|
+
#
|
|
12084
12406
|
#
|
|
12085
12407
|
#
|
|
12086
12408
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
|
@@ -12245,10 +12567,10 @@ module Aws::S3
|
|
|
12245
12567
|
# Confirms that the requester knows that they will be charged for the
|
|
12246
12568
|
# request. Bucket owners need not specify this parameter in their
|
|
12247
12569
|
# requests. If either the source or destination S3 bucket has Requester
|
|
12248
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
12249
|
-
#
|
|
12250
|
-
#
|
|
12251
|
-
#
|
|
12570
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
12571
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
12572
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
12573
|
+
# S3 User Guide*.
|
|
12252
12574
|
#
|
|
12253
12575
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
12254
12576
|
#
|
|
@@ -12401,7 +12723,7 @@ module Aws::S3
|
|
|
12401
12723
|
# resp.uploads[0].upload_id #=> String
|
|
12402
12724
|
# resp.uploads[0].key #=> String
|
|
12403
12725
|
# resp.uploads[0].initiated #=> Time
|
|
12404
|
-
# resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
12726
|
+
# resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
12405
12727
|
# resp.uploads[0].owner.display_name #=> String
|
|
12406
12728
|
# resp.uploads[0].owner.id #=> String
|
|
12407
12729
|
# resp.uploads[0].initiator.id #=> String
|
|
@@ -12422,19 +12744,6 @@ module Aws::S3
|
|
|
12422
12744
|
req.send_request(options)
|
|
12423
12745
|
end
|
|
12424
12746
|
|
|
12425
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
12426
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
12427
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
12428
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
12429
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
12430
|
-
#
|
|
12431
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
12432
|
-
# East
|
|
12433
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
12434
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
12435
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
12436
|
-
# America (São Paulo) Region.
|
|
12437
|
-
#
|
|
12438
12747
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
12439
12748
|
#
|
|
12440
12749
|
# </note>
|
|
@@ -12464,6 +12773,10 @@ module Aws::S3
|
|
|
12464
12773
|
#
|
|
12465
12774
|
# * [DeleteObject][4]
|
|
12466
12775
|
#
|
|
12776
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12777
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12778
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12779
|
+
#
|
|
12467
12780
|
#
|
|
12468
12781
|
#
|
|
12469
12782
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
|
@@ -12538,10 +12851,10 @@ module Aws::S3
|
|
|
12538
12851
|
# Confirms that the requester knows that they will be charged for the
|
|
12539
12852
|
# request. Bucket owners need not specify this parameter in their
|
|
12540
12853
|
# requests. If either the source or destination S3 bucket has Requester
|
|
12541
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
12542
|
-
#
|
|
12543
|
-
#
|
|
12544
|
-
#
|
|
12854
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
12855
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
12856
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
12857
|
+
# S3 User Guide*.
|
|
12545
12858
|
#
|
|
12546
12859
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
12547
12860
|
#
|
|
@@ -12678,19 +12991,6 @@ module Aws::S3
|
|
|
12678
12991
|
req.send_request(options)
|
|
12679
12992
|
end
|
|
12680
12993
|
|
|
12681
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
12682
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
12683
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
12684
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
12685
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
12686
|
-
#
|
|
12687
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
12688
|
-
# East
|
|
12689
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
12690
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
12691
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
12692
|
-
# America (São Paulo) Region.
|
|
12693
|
-
#
|
|
12694
12994
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
12695
12995
|
#
|
|
12696
12996
|
# </note>
|
|
@@ -12717,6 +13017,10 @@ module Aws::S3
|
|
|
12717
13017
|
#
|
|
12718
13018
|
# * [ListBuckets][5]
|
|
12719
13019
|
#
|
|
13020
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13021
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13022
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13023
|
+
#
|
|
12720
13024
|
#
|
|
12721
13025
|
#
|
|
12722
13026
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
|
@@ -12907,7 +13211,7 @@ module Aws::S3
|
|
|
12907
13211
|
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
|
12908
13212
|
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
|
12909
13213
|
# resp.contents[0].size #=> Integer
|
|
12910
|
-
# 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", "FSX_OPENZFS"
|
|
13214
|
+
# 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", "FSX_OPENZFS", "FSX_ONTAP"
|
|
12911
13215
|
# resp.contents[0].owner.display_name #=> String
|
|
12912
13216
|
# resp.contents[0].owner.id #=> String
|
|
12913
13217
|
# resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
|
|
@@ -13010,6 +13314,10 @@ module Aws::S3
|
|
|
13010
13314
|
#
|
|
13011
13315
|
# * [CreateBucket][11]
|
|
13012
13316
|
#
|
|
13317
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13318
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13319
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13320
|
+
#
|
|
13013
13321
|
#
|
|
13014
13322
|
#
|
|
13015
13323
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
|
|
@@ -13253,7 +13561,7 @@ module Aws::S3
|
|
|
13253
13561
|
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
|
13254
13562
|
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
|
13255
13563
|
# resp.contents[0].size #=> Integer
|
|
13256
|
-
# 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", "FSX_OPENZFS"
|
|
13564
|
+
# 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", "FSX_OPENZFS", "FSX_ONTAP"
|
|
13257
13565
|
# resp.contents[0].owner.display_name #=> String
|
|
13258
13566
|
# resp.contents[0].owner.id #=> String
|
|
13259
13567
|
# resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
|
|
@@ -13280,19 +13588,6 @@ module Aws::S3
|
|
|
13280
13588
|
req.send_request(options)
|
|
13281
13589
|
end
|
|
13282
13590
|
|
|
13283
|
-
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
|
13284
|
-
# returning `DisplayName`. Update your applications to use canonical IDs
|
|
13285
|
-
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
|
13286
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
|
13287
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
13288
|
-
#
|
|
13289
|
-
# This change affects the following Amazon Web Services Regions: US
|
|
13290
|
-
# East
|
|
13291
|
-
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
13292
|
-
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
13293
|
-
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
13294
|
-
# America (São Paulo) Region.
|
|
13295
|
-
#
|
|
13296
13591
|
# Lists the parts that have been uploaded for a specific multipart
|
|
13297
13592
|
# upload.
|
|
13298
13593
|
#
|
|
@@ -13372,6 +13667,10 @@ module Aws::S3
|
|
|
13372
13667
|
#
|
|
13373
13668
|
# * [ListMultipartUploads][11]
|
|
13374
13669
|
#
|
|
13670
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13671
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13672
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13673
|
+
#
|
|
13375
13674
|
#
|
|
13376
13675
|
#
|
|
13377
13676
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
|
@@ -13449,10 +13748,10 @@ module Aws::S3
|
|
|
13449
13748
|
# Confirms that the requester knows that they will be charged for the
|
|
13450
13749
|
# request. Bucket owners need not specify this parameter in their
|
|
13451
13750
|
# requests. If either the source or destination S3 bucket has Requester
|
|
13452
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
13453
|
-
#
|
|
13454
|
-
#
|
|
13455
|
-
#
|
|
13751
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
13752
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
13753
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
13754
|
+
# S3 User Guide*.
|
|
13456
13755
|
#
|
|
13457
13756
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
13458
13757
|
#
|
|
@@ -13608,7 +13907,7 @@ module Aws::S3
|
|
|
13608
13907
|
# resp.initiator.display_name #=> String
|
|
13609
13908
|
# resp.owner.display_name #=> String
|
|
13610
13909
|
# resp.owner.id #=> String
|
|
13611
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
|
|
13910
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
|
|
13612
13911
|
# resp.request_charged #=> String, one of "requester"
|
|
13613
13912
|
# resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
|
13614
13913
|
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
|
@@ -13622,6 +13921,81 @@ module Aws::S3
|
|
|
13622
13921
|
req.send_request(options)
|
|
13623
13922
|
end
|
|
13624
13923
|
|
|
13924
|
+
# Sets the attribute-based access control (ABAC) property of the general
|
|
13925
|
+
# purpose bucket. You must have `s3:PutBucketABAC` permission to perform
|
|
13926
|
+
# this action. When you enable ABAC, you can use tags for access control
|
|
13927
|
+
# on your buckets. Additionally, when ABAC is enabled, you must use the
|
|
13928
|
+
# [TagResource][1] and [UntagResource][2] actions to manage tags on your
|
|
13929
|
+
# buckets. You can nolonger use the [PutBucketTagging][3] and
|
|
13930
|
+
# [DeleteBucketTagging][4] actions to tag your bucket. For more
|
|
13931
|
+
# information, see [Enabling ABAC in general purpose buckets][5].
|
|
13932
|
+
#
|
|
13933
|
+
#
|
|
13934
|
+
#
|
|
13935
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
|
|
13936
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
13937
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
13938
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
13939
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
13940
|
+
#
|
|
13941
|
+
# @option params [required, String] :bucket
|
|
13942
|
+
# The name of the general purpose bucket.
|
|
13943
|
+
#
|
|
13944
|
+
# @option params [String] :content_md5
|
|
13945
|
+
# The MD5 hash of the `PutBucketAbac` request body.
|
|
13946
|
+
#
|
|
13947
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
|
13948
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
|
13949
|
+
# automatically.
|
|
13950
|
+
#
|
|
13951
|
+
# @option params [String] :checksum_algorithm
|
|
13952
|
+
# Indicates the algorithm that you want Amazon S3 to use to create the
|
|
13953
|
+
# checksum. For more information, see [ Checking object integrity][1] in
|
|
13954
|
+
# the *Amazon S3 User Guide*.
|
|
13955
|
+
#
|
|
13956
|
+
#
|
|
13957
|
+
#
|
|
13958
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
|
13959
|
+
#
|
|
13960
|
+
# @option params [String] :expected_bucket_owner
|
|
13961
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
13962
|
+
# owner.
|
|
13963
|
+
#
|
|
13964
|
+
# @option params [required, Types::AbacStatus] :abac_status
|
|
13965
|
+
# The ABAC status of the general purpose bucket. When ABAC is enabled
|
|
13966
|
+
# for the general purpose bucket, you can use tags to manage access to
|
|
13967
|
+
# the general purpose buckets as well as for cost tracking purposes.
|
|
13968
|
+
# When ABAC is disabled for the general purpose buckets, you can only
|
|
13969
|
+
# use tags for cost tracking purposes. For more information, see [Using
|
|
13970
|
+
# tags with S3 general purpose buckets][1].
|
|
13971
|
+
#
|
|
13972
|
+
#
|
|
13973
|
+
#
|
|
13974
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
|
|
13975
|
+
#
|
|
13976
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
13977
|
+
#
|
|
13978
|
+
# @example Request syntax with placeholder values
|
|
13979
|
+
#
|
|
13980
|
+
# resp = client.put_bucket_abac({
|
|
13981
|
+
# bucket: "BucketName", # required
|
|
13982
|
+
# content_md5: "ContentMD5",
|
|
13983
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
|
13984
|
+
# expected_bucket_owner: "AccountId",
|
|
13985
|
+
# abac_status: { # required
|
|
13986
|
+
# status: "Enabled", # accepts Enabled, Disabled
|
|
13987
|
+
# },
|
|
13988
|
+
# })
|
|
13989
|
+
#
|
|
13990
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAbac AWS API Documentation
|
|
13991
|
+
#
|
|
13992
|
+
# @overload put_bucket_abac(params = {})
|
|
13993
|
+
# @param [Hash] params ({})
|
|
13994
|
+
def put_bucket_abac(params = {}, options = {})
|
|
13995
|
+
req = build_request(:put_bucket_abac, params)
|
|
13996
|
+
req.send_request(options)
|
|
13997
|
+
end
|
|
13998
|
+
|
|
13625
13999
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
13626
14000
|
#
|
|
13627
14001
|
# </note>
|
|
@@ -13664,6 +14038,10 @@ module Aws::S3
|
|
|
13664
14038
|
#
|
|
13665
14039
|
# * [CreateBucket][5]
|
|
13666
14040
|
#
|
|
14041
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14042
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14043
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14044
|
+
#
|
|
13667
14045
|
#
|
|
13668
14046
|
#
|
|
13669
14047
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -13721,19 +14099,17 @@ module Aws::S3
|
|
|
13721
14099
|
req.send_request(options)
|
|
13722
14100
|
end
|
|
13723
14101
|
|
|
13724
|
-
# End of support notice:
|
|
13725
|
-
#
|
|
13726
|
-
#
|
|
13727
|
-
#
|
|
13728
|
-
#
|
|
13729
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
14102
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
14103
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
14104
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
14105
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
14106
|
+
# error.
|
|
13730
14107
|
#
|
|
13731
14108
|
# This change affects the following Amazon Web Services Regions: US
|
|
13732
14109
|
# East
|
|
13733
|
-
# (N. Virginia)
|
|
13734
|
-
#
|
|
13735
|
-
#
|
|
13736
|
-
# America (São Paulo) Region.
|
|
14110
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
14111
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
14112
|
+
# (Ireland), and South America (São Paulo).
|
|
13737
14113
|
#
|
|
13738
14114
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
13739
14115
|
#
|
|
@@ -13900,6 +14276,10 @@ module Aws::S3
|
|
|
13900
14276
|
#
|
|
13901
14277
|
# * [GetObjectAcl][9]
|
|
13902
14278
|
#
|
|
14279
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14280
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14281
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14282
|
+
#
|
|
13903
14283
|
#
|
|
13904
14284
|
#
|
|
13905
14285
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
|
@@ -14094,6 +14474,10 @@ module Aws::S3
|
|
|
14094
14474
|
#
|
|
14095
14475
|
# * [ListBucketAnalyticsConfigurations][7]
|
|
14096
14476
|
#
|
|
14477
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14478
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14479
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14480
|
+
#
|
|
14097
14481
|
#
|
|
14098
14482
|
#
|
|
14099
14483
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
|
|
@@ -14219,6 +14603,10 @@ module Aws::S3
|
|
|
14219
14603
|
#
|
|
14220
14604
|
# * [RESTOPTIONSobject][4]
|
|
14221
14605
|
#
|
|
14606
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14607
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14608
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14609
|
+
#
|
|
14222
14610
|
#
|
|
14223
14611
|
#
|
|
14224
14612
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
|
@@ -14350,7 +14738,8 @@ module Aws::S3
|
|
|
14350
14738
|
end
|
|
14351
14739
|
|
|
14352
14740
|
# This operation configures default encryption and Amazon S3 Bucket Keys
|
|
14353
|
-
# for an existing bucket.
|
|
14741
|
+
# for an existing bucket. You can also [block encryption types][1] using
|
|
14742
|
+
# this operation.
|
|
14354
14743
|
#
|
|
14355
14744
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
|
14356
14745
|
# requests for this API operation to the Regional endpoint. These
|
|
@@ -14358,9 +14747,9 @@ module Aws::S3
|
|
|
14358
14747
|
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
|
14359
14748
|
# Virtual-hosted-style requests aren't supported. For more information
|
|
14360
14749
|
# about endpoints in Availability Zones, see [Regional and Zonal
|
|
14361
|
-
# endpoints for directory buckets in Availability Zones][
|
|
14750
|
+
# endpoints for directory buckets in Availability Zones][2] in the
|
|
14362
14751
|
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
|
14363
|
-
# Zones, see [Concepts for directory buckets in Local Zones][
|
|
14752
|
+
# Zones, see [Concepts for directory buckets in Local Zones][3] in the
|
|
14364
14753
|
# *Amazon S3 User Guide*.
|
|
14365
14754
|
#
|
|
14366
14755
|
# </note>
|
|
@@ -14375,12 +14764,12 @@ module Aws::S3
|
|
|
14375
14764
|
# keys (SSE-KMS) or dual-layer server-side encryption with Amazon
|
|
14376
14765
|
# Web Services KMS keys (DSSE-KMS). If you specify default
|
|
14377
14766
|
# encryption by using SSE-KMS, you can also configure [Amazon S3
|
|
14378
|
-
# Bucket Keys][
|
|
14379
|
-
# encryption feature, see [Amazon S3 Bucket Default Encryption][
|
|
14767
|
+
# Bucket Keys][4]. For information about the bucket default
|
|
14768
|
+
# encryption feature, see [Amazon S3 Bucket Default Encryption][5]
|
|
14380
14769
|
# in the *Amazon S3 User Guide*.
|
|
14381
14770
|
#
|
|
14382
14771
|
# * If you use PutBucketEncryption to set your [default bucket
|
|
14383
|
-
# encryption][
|
|
14772
|
+
# encryption][5] to SSE-KMS, you should verify that your KMS key ID
|
|
14384
14773
|
# is correct. Amazon S3 doesn't validate the KMS key ID provided in
|
|
14385
14774
|
# PutBucketEncryption requests.
|
|
14386
14775
|
# * <b>Directory buckets </b> - You can optionally configure default
|
|
@@ -14394,28 +14783,28 @@ module Aws::S3
|
|
|
14394
14783
|
# encrypted with the desired encryption settings. For more
|
|
14395
14784
|
# information about the encryption overriding behaviors in directory
|
|
14396
14785
|
# buckets, see [Specifying server-side encryption with KMS for new
|
|
14397
|
-
# object uploads][
|
|
14786
|
+
# object uploads][6].
|
|
14398
14787
|
#
|
|
14399
14788
|
# * Your SSE-KMS configuration can only support 1 [customer managed
|
|
14400
|
-
# key][
|
|
14401
|
-
# managed key][
|
|
14789
|
+
# key][7] per directory bucket's lifetime. The [Amazon Web Services
|
|
14790
|
+
# managed key][8] (`aws/s3`) isn't supported.
|
|
14402
14791
|
#
|
|
14403
14792
|
# * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
|
|
14404
14793
|
# in a directory bucket and can’t be disabled. S3 Bucket Keys
|
|
14405
14794
|
# aren't supported, when you copy SSE-KMS encrypted objects from
|
|
14406
14795
|
# general purpose buckets to directory buckets, from directory
|
|
14407
14796
|
# buckets to general purpose buckets, or between directory buckets,
|
|
14408
|
-
# through [CopyObject][
|
|
14409
|
-
# in Batch Operations][
|
|
14797
|
+
# through [CopyObject][9], [UploadPartCopy][10], [the Copy operation
|
|
14798
|
+
# in Batch Operations][11], or [the import jobs][12]. In this case,
|
|
14410
14799
|
# Amazon S3 makes a call to KMS every time a copy request is made
|
|
14411
14800
|
# for a KMS-encrypted object.
|
|
14412
14801
|
#
|
|
14413
|
-
# * When you specify an [KMS customer managed key][
|
|
14802
|
+
# * When you specify an [KMS customer managed key][7] for encryption
|
|
14414
14803
|
# in your directory bucket, only use the key ID or key ARN. The key
|
|
14415
14804
|
# alias format of the KMS key isn't supported.
|
|
14416
14805
|
#
|
|
14417
14806
|
# * For directory buckets, if you use PutBucketEncryption to set your
|
|
14418
|
-
# [default bucket encryption][
|
|
14807
|
+
# [default bucket encryption][5] to SSE-KMS, Amazon S3 validates the
|
|
14419
14808
|
# KMS key ID provided in PutBucketEncryption requests.
|
|
14420
14809
|
#
|
|
14421
14810
|
# </note>
|
|
@@ -14428,7 +14817,7 @@ module Aws::S3
|
|
|
14428
14817
|
#
|
|
14429
14818
|
# Also, this action requires Amazon Web Services Signature Version 4.
|
|
14430
14819
|
# For more information, see [ Authenticating Requests (Amazon Web
|
|
14431
|
-
# Services Signature Version 4)][
|
|
14820
|
+
# Services Signature Version 4)][13].
|
|
14432
14821
|
#
|
|
14433
14822
|
# Permissions
|
|
14434
14823
|
# : * **General purpose bucket permissions** - The
|
|
@@ -14436,8 +14825,8 @@ module Aws::S3
|
|
|
14436
14825
|
# policy. The bucket owner has this permission by default. The
|
|
14437
14826
|
# bucket owner can grant this permission to others. For more
|
|
14438
14827
|
# information about permissions, see [Permissions Related to Bucket
|
|
14439
|
-
# Operations][
|
|
14440
|
-
# Resources][
|
|
14828
|
+
# Operations][14] and [Managing Access Permissions to Your Amazon S3
|
|
14829
|
+
# Resources][15] in the *Amazon S3 User Guide*.
|
|
14441
14830
|
#
|
|
14442
14831
|
# * **Directory bucket permissions** - To grant access to this API
|
|
14443
14832
|
# operation, you must have the
|
|
@@ -14447,7 +14836,7 @@ module Aws::S3
|
|
|
14447
14836
|
# only be performed by the Amazon Web Services account that owns the
|
|
14448
14837
|
# resource. For more information about directory bucket policies and
|
|
14449
14838
|
# permissions, see [Amazon Web Services Identity and Access
|
|
14450
|
-
# Management (IAM) for S3 Express One Zone][
|
|
14839
|
+
# Management (IAM) for S3 Express One Zone][16] in the *Amazon S3
|
|
14451
14840
|
# User Guide*.
|
|
14452
14841
|
#
|
|
14453
14842
|
# To set a directory bucket default encryption with SSE-KMS, you
|
|
@@ -14462,29 +14851,34 @@ module Aws::S3
|
|
|
14462
14851
|
#
|
|
14463
14852
|
# The following operations are related to `PutBucketEncryption`:
|
|
14464
14853
|
#
|
|
14465
|
-
# * [GetBucketEncryption][
|
|
14854
|
+
# * [GetBucketEncryption][17]
|
|
14466
14855
|
#
|
|
14467
|
-
# * [DeleteBucketEncryption][
|
|
14856
|
+
# * [DeleteBucketEncryption][18]
|
|
14468
14857
|
#
|
|
14858
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14859
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14860
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14469
14861
|
#
|
|
14470
14862
|
#
|
|
14471
|
-
#
|
|
14472
|
-
# [
|
|
14473
|
-
# [
|
|
14474
|
-
# [
|
|
14475
|
-
# [
|
|
14476
|
-
# [
|
|
14477
|
-
# [
|
|
14478
|
-
# [
|
|
14479
|
-
# [
|
|
14480
|
-
# [
|
|
14481
|
-
# [
|
|
14482
|
-
# [
|
|
14483
|
-
# [
|
|
14484
|
-
# [
|
|
14485
|
-
# [
|
|
14486
|
-
# [
|
|
14487
|
-
# [
|
|
14863
|
+
#
|
|
14864
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_BlockedEncryptionTypes.html
|
|
14865
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
14866
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
|
14867
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
|
14868
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
|
14869
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
|
14870
|
+
# [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
|
14871
|
+
# [8]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
|
14872
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
|
14873
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
|
14874
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
|
|
14875
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
|
14876
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
|
14877
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
14878
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
14879
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
|
14880
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
|
14881
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
14488
14882
|
#
|
|
14489
14883
|
# @option params [required, String] :bucket
|
|
14490
14884
|
# Specifies default encryption for a bucket using server-side encryption
|
|
@@ -14568,6 +14962,9 @@ module Aws::S3
|
|
|
14568
14962
|
# kms_master_key_id: "SSEKMSKeyId",
|
|
14569
14963
|
# },
|
|
14570
14964
|
# bucket_key_enabled: false,
|
|
14965
|
+
# blocked_encryption_types: {
|
|
14966
|
+
# encryption_type: ["NONE"], # accepts NONE, SSE-C
|
|
14967
|
+
# },
|
|
14571
14968
|
# },
|
|
14572
14969
|
# ],
|
|
14573
14970
|
# },
|
|
@@ -14647,6 +15044,10 @@ module Aws::S3
|
|
|
14647
15044
|
# not have the `s3:PutIntelligentTieringConfiguration` bucket
|
|
14648
15045
|
# permission to set the configuration on the bucket.
|
|
14649
15046
|
#
|
|
15047
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15048
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15049
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15050
|
+
#
|
|
14650
15051
|
#
|
|
14651
15052
|
#
|
|
14652
15053
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -14792,6 +15193,10 @@ module Aws::S3
|
|
|
14792
15193
|
#
|
|
14793
15194
|
# * [ListBucketInventoryConfigurations][10]
|
|
14794
15195
|
#
|
|
15196
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15197
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15198
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15199
|
+
#
|
|
14795
15200
|
#
|
|
14796
15201
|
#
|
|
14797
15202
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
|
|
@@ -14849,7 +15254,7 @@ module Aws::S3
|
|
|
14849
15254
|
# },
|
|
14850
15255
|
# id: "InventoryId", # required
|
|
14851
15256
|
# included_object_versions: "All", # required, accepts All, Current
|
|
14852
|
-
# optional_fields: ["Size"], # accepts Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, EncryptionStatus, ObjectLockRetainUntilDate, ObjectLockMode, ObjectLockLegalHoldStatus, IntelligentTieringAccessTier, BucketKeyStatus, ChecksumAlgorithm, ObjectAccessControlList, ObjectOwner
|
|
15257
|
+
# optional_fields: ["Size"], # accepts Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, EncryptionStatus, ObjectLockRetainUntilDate, ObjectLockMode, ObjectLockLegalHoldStatus, IntelligentTieringAccessTier, BucketKeyStatus, ChecksumAlgorithm, ObjectAccessControlList, ObjectOwner, LifecycleExpirationDate
|
|
14853
15258
|
# schedule: { # required
|
|
14854
15259
|
# frequency: "Daily", # required, accepts Daily, Weekly
|
|
14855
15260
|
# },
|
|
@@ -14929,6 +15334,10 @@ module Aws::S3
|
|
|
14929
15334
|
#
|
|
14930
15335
|
# * [Managing Access Permissions to your Amazon S3 Resources][3]
|
|
14931
15336
|
#
|
|
15337
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15338
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15339
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15340
|
+
#
|
|
14932
15341
|
#
|
|
14933
15342
|
#
|
|
14934
15343
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
|
@@ -15039,8 +15448,6 @@ module Aws::S3
|
|
|
15039
15448
|
# </note>
|
|
15040
15449
|
#
|
|
15041
15450
|
# Rules
|
|
15042
|
-
# Permissions
|
|
15043
|
-
# HTTP Host header syntax
|
|
15044
15451
|
#
|
|
15045
15452
|
# : You specify the lifecycle configuration in your request body. The
|
|
15046
15453
|
# lifecycle configuration is specified as XML consisting of one or
|
|
@@ -15079,6 +15486,8 @@ module Aws::S3
|
|
|
15079
15486
|
#
|
|
15080
15487
|
# For more information, see [Object Lifecycle Management][3] and
|
|
15081
15488
|
# [Lifecycle Configuration Elements][4].
|
|
15489
|
+
#
|
|
15490
|
+
# Permissions
|
|
15082
15491
|
# : * **General purpose bucket permissions** - By default, all Amazon S3
|
|
15083
15492
|
# resources are private, including buckets, objects, and related
|
|
15084
15493
|
# subresources (for example, lifecycle configuration and website
|
|
@@ -15128,6 +15537,8 @@ module Aws::S3
|
|
|
15128
15537
|
#
|
|
15129
15538
|
# </note>
|
|
15130
15539
|
#
|
|
15540
|
+
# HTTP Host header syntax
|
|
15541
|
+
#
|
|
15131
15542
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is
|
|
15132
15543
|
# `s3express-control.region.amazonaws.com`.
|
|
15133
15544
|
#
|
|
@@ -15138,6 +15549,10 @@ module Aws::S3
|
|
|
15138
15549
|
#
|
|
15139
15550
|
# * [DeleteBucketLifecycle][10]
|
|
15140
15551
|
#
|
|
15552
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15553
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15554
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15555
|
+
#
|
|
15141
15556
|
#
|
|
15142
15557
|
#
|
|
15143
15558
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
|
|
@@ -15315,19 +15730,17 @@ module Aws::S3
|
|
|
15315
15730
|
req.send_request(options)
|
|
15316
15731
|
end
|
|
15317
15732
|
|
|
15318
|
-
# End of support notice:
|
|
15319
|
-
#
|
|
15320
|
-
#
|
|
15321
|
-
#
|
|
15322
|
-
#
|
|
15323
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
15733
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
15734
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
15735
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
15736
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
15737
|
+
# error.
|
|
15324
15738
|
#
|
|
15325
15739
|
# This change affects the following Amazon Web Services Regions: US
|
|
15326
15740
|
# East
|
|
15327
|
-
# (N. Virginia)
|
|
15328
|
-
#
|
|
15329
|
-
#
|
|
15330
|
-
# America (São Paulo) Region.
|
|
15741
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
15742
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
15743
|
+
# (Ireland), and South America (São Paulo).
|
|
15331
15744
|
#
|
|
15332
15745
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
15333
15746
|
#
|
|
@@ -15402,6 +15815,10 @@ module Aws::S3
|
|
|
15402
15815
|
#
|
|
15403
15816
|
# * [GetBucketLogging][5]
|
|
15404
15817
|
#
|
|
15818
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15819
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15820
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15821
|
+
#
|
|
15405
15822
|
#
|
|
15406
15823
|
#
|
|
15407
15824
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
|
|
@@ -15555,6 +15972,10 @@ module Aws::S3
|
|
|
15555
15972
|
#
|
|
15556
15973
|
# * HTTP Status Code: HTTP 400 Bad Request
|
|
15557
15974
|
#
|
|
15975
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15976
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15977
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15978
|
+
#
|
|
15558
15979
|
#
|
|
15559
15980
|
#
|
|
15560
15981
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -15774,6 +16195,10 @@ module Aws::S3
|
|
|
15774
16195
|
#
|
|
15775
16196
|
# ^
|
|
15776
16197
|
#
|
|
16198
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16199
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16200
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16201
|
+
#
|
|
15777
16202
|
#
|
|
15778
16203
|
#
|
|
15779
16204
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
|
@@ -15908,6 +16333,10 @@ module Aws::S3
|
|
|
15908
16333
|
#
|
|
15909
16334
|
# * DeleteBucketOwnershipControls
|
|
15910
16335
|
#
|
|
16336
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16337
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16338
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16339
|
+
#
|
|
15911
16340
|
#
|
|
15912
16341
|
#
|
|
15913
16342
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html
|
|
@@ -16048,6 +16477,10 @@ module Aws::S3
|
|
|
16048
16477
|
#
|
|
16049
16478
|
# * [DeleteBucket][8]
|
|
16050
16479
|
#
|
|
16480
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16481
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16482
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16483
|
+
#
|
|
16051
16484
|
#
|
|
16052
16485
|
#
|
|
16053
16486
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -16256,6 +16689,10 @@ module Aws::S3
|
|
|
16256
16689
|
#
|
|
16257
16690
|
# * [DeleteBucketReplication][11]
|
|
16258
16691
|
#
|
|
16692
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16693
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16694
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16695
|
+
#
|
|
16259
16696
|
#
|
|
16260
16697
|
#
|
|
16261
16698
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
@@ -16382,7 +16819,7 @@ module Aws::S3
|
|
|
16382
16819
|
# destination: { # required
|
|
16383
16820
|
# bucket: "BucketName", # required
|
|
16384
16821
|
# account: "AccountId",
|
|
16385
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
16822
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
16386
16823
|
# access_control_translation: {
|
|
16387
16824
|
# owner: "Destination", # required, accepts Destination
|
|
16388
16825
|
# },
|
|
@@ -16437,6 +16874,10 @@ module Aws::S3
|
|
|
16437
16874
|
#
|
|
16438
16875
|
# * [GetBucketRequestPayment][3]
|
|
16439
16876
|
#
|
|
16877
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16878
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16879
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16880
|
+
#
|
|
16440
16881
|
#
|
|
16441
16882
|
#
|
|
16442
16883
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
|
@@ -16522,7 +16963,11 @@ module Aws::S3
|
|
|
16522
16963
|
#
|
|
16523
16964
|
# </note>
|
|
16524
16965
|
#
|
|
16525
|
-
# Sets the tags for a bucket
|
|
16966
|
+
# Sets the tags for a general purpose bucket if attribute based access
|
|
16967
|
+
# control (ABAC) is not enabled for the bucket. When you [enable ABAC
|
|
16968
|
+
# for a general purpose bucket][1], you can no longer use this operation
|
|
16969
|
+
# for that bucket and must use the [TagResource][2] or
|
|
16970
|
+
# [UntagResource][3] operations instead.
|
|
16526
16971
|
#
|
|
16527
16972
|
# Use tags to organize your Amazon Web Services bill to reflect your own
|
|
16528
16973
|
# cost structure. To do this, sign up to get your Amazon Web Services
|
|
@@ -16532,8 +16977,8 @@ module Aws::S3
|
|
|
16532
16977
|
# several resources with a specific application name, and then organize
|
|
16533
16978
|
# your billing information to see the total cost of that application
|
|
16534
16979
|
# across several services. For more information, see [Cost Allocation
|
|
16535
|
-
# and Tagging][
|
|
16536
|
-
# Tags][
|
|
16980
|
+
# and Tagging][4] and [Using Cost Allocation in Amazon S3 Bucket
|
|
16981
|
+
# Tags][5].
|
|
16537
16982
|
#
|
|
16538
16983
|
# <note markdown="1"> When this operation sets the tags for a bucket, it will overwrite any
|
|
16539
16984
|
# current tags the bucket already has. You cannot use this operation to
|
|
@@ -16545,16 +16990,16 @@ module Aws::S3
|
|
|
16545
16990
|
# `s3:PutBucketTagging` action. The bucket owner has this permission by
|
|
16546
16991
|
# default and can grant this permission to others. For more information
|
|
16547
16992
|
# about permissions, see [Permissions Related to Bucket Subresource
|
|
16548
|
-
# Operations][
|
|
16549
|
-
# Resources][
|
|
16993
|
+
# Operations][6] and [Managing Access Permissions to Your Amazon S3
|
|
16994
|
+
# Resources][7].
|
|
16550
16995
|
#
|
|
16551
16996
|
# `PutBucketTagging` has the following special errors. For more Amazon
|
|
16552
|
-
# S3 errors see, [Error Responses][
|
|
16997
|
+
# S3 errors see, [Error Responses][8].
|
|
16553
16998
|
#
|
|
16554
16999
|
# * `InvalidTag` - The tag provided was not a valid tag. This error can
|
|
16555
17000
|
# occur if the tag did not pass input validation. For more
|
|
16556
17001
|
# information, see [Using Cost Allocation in Amazon S3 Bucket
|
|
16557
|
-
# Tags][
|
|
17002
|
+
# Tags][5].
|
|
16558
17003
|
#
|
|
16559
17004
|
# * `MalformedXML` - The XML provided does not match the schema.
|
|
16560
17005
|
#
|
|
@@ -16566,19 +17011,26 @@ module Aws::S3
|
|
|
16566
17011
|
#
|
|
16567
17012
|
# The following operations are related to `PutBucketTagging`:
|
|
16568
17013
|
#
|
|
16569
|
-
# * [GetBucketTagging][
|
|
17014
|
+
# * [GetBucketTagging][9]
|
|
16570
17015
|
#
|
|
16571
|
-
# * [DeleteBucketTagging][
|
|
17016
|
+
# * [DeleteBucketTagging][10]
|
|
16572
17017
|
#
|
|
17018
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17019
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17020
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16573
17021
|
#
|
|
16574
17022
|
#
|
|
16575
|
-
#
|
|
16576
|
-
# [
|
|
16577
|
-
# [
|
|
16578
|
-
# [
|
|
16579
|
-
# [
|
|
16580
|
-
# [
|
|
16581
|
-
# [
|
|
17023
|
+
#
|
|
17024
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
17025
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
|
|
17026
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
17027
|
+
# [4]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
|
|
17028
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html
|
|
17029
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
17030
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
17031
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
|
|
17032
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
|
17033
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
16582
17034
|
#
|
|
16583
17035
|
# @option params [required, String] :bucket
|
|
16584
17036
|
# The bucket name.
|
|
@@ -16720,6 +17172,10 @@ module Aws::S3
|
|
|
16720
17172
|
#
|
|
16721
17173
|
# * [GetBucketVersioning][1]
|
|
16722
17174
|
#
|
|
17175
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17176
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17177
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17178
|
+
#
|
|
16723
17179
|
#
|
|
16724
17180
|
#
|
|
16725
17181
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
|
@@ -16763,6 +17219,17 @@ module Aws::S3
|
|
|
16763
17219
|
# @option params [String] :mfa
|
|
16764
17220
|
# The concatenation of the authentication device's serial number, a
|
|
16765
17221
|
# space, and the value that is displayed on your authentication device.
|
|
17222
|
+
# The serial number is the number that uniquely identifies the MFA
|
|
17223
|
+
# device. For physical MFA devices, this is the unique serial number
|
|
17224
|
+
# that's provided with the device. For virtual MFA devices, the serial
|
|
17225
|
+
# number is the device ARN. For more information, see [Enabling
|
|
17226
|
+
# versioning on buckets][1] and [Configuring MFA delete][2] in the
|
|
17227
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
17228
|
+
#
|
|
17229
|
+
#
|
|
17230
|
+
#
|
|
17231
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
|
|
17232
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
|
|
16766
17233
|
#
|
|
16767
17234
|
# @option params [required, Types::VersioningConfiguration] :versioning_configuration
|
|
16768
17235
|
# Container for setting the versioning state.
|
|
@@ -16884,6 +17351,10 @@ module Aws::S3
|
|
|
16884
17351
|
#
|
|
16885
17352
|
# The maximum request length is limited to 128 KB.
|
|
16886
17353
|
#
|
|
17354
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17355
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17356
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17357
|
+
#
|
|
16887
17358
|
#
|
|
16888
17359
|
#
|
|
16889
17360
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -16994,19 +17465,17 @@ module Aws::S3
|
|
|
16994
17465
|
req.send_request(options)
|
|
16995
17466
|
end
|
|
16996
17467
|
|
|
16997
|
-
# End of support notice:
|
|
16998
|
-
#
|
|
16999
|
-
#
|
|
17000
|
-
#
|
|
17001
|
-
#
|
|
17002
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
17468
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
17469
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
17470
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
17471
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
17472
|
+
# error.
|
|
17003
17473
|
#
|
|
17004
17474
|
# This change affects the following Amazon Web Services Regions: US
|
|
17005
17475
|
# East
|
|
17006
|
-
# (N. Virginia)
|
|
17007
|
-
#
|
|
17008
|
-
#
|
|
17009
|
-
# America (São Paulo) Region.
|
|
17476
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
17477
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
17478
|
+
# (Ireland), and South America (São Paulo).
|
|
17010
17479
|
#
|
|
17011
17480
|
# Adds an object to a bucket.
|
|
17012
17481
|
#
|
|
@@ -17130,6 +17599,20 @@ module Aws::S3
|
|
|
17130
17599
|
#
|
|
17131
17600
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
17132
17601
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
17602
|
+
# ^
|
|
17603
|
+
#
|
|
17604
|
+
# Errors
|
|
17605
|
+
# : * You might receive an `InvalidRequest` error for several reasons.
|
|
17606
|
+
# Depending on the reason for the error, you might receive one of
|
|
17607
|
+
# the following messages:
|
|
17608
|
+
#
|
|
17609
|
+
# * Cannot specify both a write offset value and user-defined object
|
|
17610
|
+
# metadata for existing objects.
|
|
17611
|
+
#
|
|
17612
|
+
# * Checksum Type mismatch occurred, expected checksum Type: sha1,
|
|
17613
|
+
# actual checksum Type: crc32c.
|
|
17614
|
+
#
|
|
17615
|
+
# * Request body cannot be empty when 'write offset' is specified.
|
|
17133
17616
|
#
|
|
17134
17617
|
# For more information about related Amazon S3 APIs, see the following:
|
|
17135
17618
|
#
|
|
@@ -17137,6 +17620,10 @@ module Aws::S3
|
|
|
17137
17620
|
#
|
|
17138
17621
|
# * [DeleteObject][10]
|
|
17139
17622
|
#
|
|
17623
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17624
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17625
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17626
|
+
#
|
|
17140
17627
|
#
|
|
17141
17628
|
#
|
|
17142
17629
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -17188,7 +17675,7 @@ module Aws::S3
|
|
|
17188
17675
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
|
17189
17676
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
|
17190
17677
|
#
|
|
17191
|
-
# @option params [String,
|
|
17678
|
+
# @option params [String, IO] :body
|
|
17192
17679
|
# Object data.
|
|
17193
17680
|
#
|
|
17194
17681
|
# @option params [required, String] :bucket
|
|
@@ -17749,10 +18236,10 @@ module Aws::S3
|
|
|
17749
18236
|
# Confirms that the requester knows that they will be charged for the
|
|
17750
18237
|
# request. Bucket owners need not specify this parameter in their
|
|
17751
18238
|
# requests. If either the source or destination S3 bucket has Requester
|
|
17752
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
17753
|
-
#
|
|
17754
|
-
#
|
|
17755
|
-
#
|
|
18239
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
18240
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
18241
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
18242
|
+
# S3 User Guide*.
|
|
17756
18243
|
#
|
|
17757
18244
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
17758
18245
|
#
|
|
@@ -17992,7 +18479,7 @@ module Aws::S3
|
|
|
17992
18479
|
# "MetadataKey" => "MetadataValue",
|
|
17993
18480
|
# },
|
|
17994
18481
|
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
|
17995
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
18482
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
17996
18483
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
17997
18484
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
17998
18485
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -18037,6 +18524,18 @@ module Aws::S3
|
|
|
18037
18524
|
req.send_request(options)
|
|
18038
18525
|
end
|
|
18039
18526
|
|
|
18527
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
18528
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
18529
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
18530
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
18531
|
+
# error.
|
|
18532
|
+
#
|
|
18533
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
18534
|
+
# East
|
|
18535
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
18536
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
18537
|
+
# (Ireland), and South America (São Paulo).
|
|
18538
|
+
#
|
|
18040
18539
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
18041
18540
|
#
|
|
18042
18541
|
# </note>
|
|
@@ -18197,6 +18696,10 @@ module Aws::S3
|
|
|
18197
18696
|
#
|
|
18198
18697
|
# * [GetObject][8]
|
|
18199
18698
|
#
|
|
18699
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
18700
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
18701
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
18702
|
+
#
|
|
18200
18703
|
#
|
|
18201
18704
|
#
|
|
18202
18705
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
|
|
@@ -18315,10 +18818,10 @@ module Aws::S3
|
|
|
18315
18818
|
# Confirms that the requester knows that they will be charged for the
|
|
18316
18819
|
# request. Bucket owners need not specify this parameter in their
|
|
18317
18820
|
# requests. If either the source or destination S3 bucket has Requester
|
|
18318
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
18319
|
-
#
|
|
18320
|
-
#
|
|
18321
|
-
#
|
|
18821
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
18822
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
18823
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
18824
|
+
# S3 User Guide*.
|
|
18322
18825
|
#
|
|
18323
18826
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
18324
18827
|
#
|
|
@@ -18421,6 +18924,10 @@ module Aws::S3
|
|
|
18421
18924
|
#
|
|
18422
18925
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18423
18926
|
#
|
|
18927
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
18928
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
18929
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
18930
|
+
#
|
|
18424
18931
|
#
|
|
18425
18932
|
#
|
|
18426
18933
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18457,10 +18964,10 @@ module Aws::S3
|
|
|
18457
18964
|
# Confirms that the requester knows that they will be charged for the
|
|
18458
18965
|
# request. Bucket owners need not specify this parameter in their
|
|
18459
18966
|
# requests. If either the source or destination S3 bucket has Requester
|
|
18460
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
18461
|
-
#
|
|
18462
|
-
#
|
|
18463
|
-
#
|
|
18967
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
18968
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
18969
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
18970
|
+
# S3 User Guide*.
|
|
18464
18971
|
#
|
|
18465
18972
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
18466
18973
|
#
|
|
@@ -18553,6 +19060,10 @@ module Aws::S3
|
|
|
18553
19060
|
#
|
|
18554
19061
|
# </note>
|
|
18555
19062
|
#
|
|
19063
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19064
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19065
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19066
|
+
#
|
|
18556
19067
|
#
|
|
18557
19068
|
#
|
|
18558
19069
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18570,10 +19081,10 @@ module Aws::S3
|
|
|
18570
19081
|
# Confirms that the requester knows that they will be charged for the
|
|
18571
19082
|
# request. Bucket owners need not specify this parameter in their
|
|
18572
19083
|
# requests. If either the source or destination S3 bucket has Requester
|
|
18573
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
18574
|
-
#
|
|
18575
|
-
#
|
|
18576
|
-
#
|
|
19084
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
19085
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
19086
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
19087
|
+
# S3 User Guide*.
|
|
18577
19088
|
#
|
|
18578
19089
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
18579
19090
|
#
|
|
@@ -18664,6 +19175,10 @@ module Aws::S3
|
|
|
18664
19175
|
#
|
|
18665
19176
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18666
19177
|
#
|
|
19178
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19179
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19180
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19181
|
+
#
|
|
18667
19182
|
#
|
|
18668
19183
|
#
|
|
18669
19184
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18700,10 +19215,10 @@ module Aws::S3
|
|
|
18700
19215
|
# Confirms that the requester knows that they will be charged for the
|
|
18701
19216
|
# request. Bucket owners need not specify this parameter in their
|
|
18702
19217
|
# requests. If either the source or destination S3 bucket has Requester
|
|
18703
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
18704
|
-
#
|
|
18705
|
-
#
|
|
18706
|
-
#
|
|
19218
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
19219
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
19220
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
19221
|
+
# S3 User Guide*.
|
|
18707
19222
|
#
|
|
18708
19223
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
18709
19224
|
#
|
|
@@ -18828,6 +19343,10 @@ module Aws::S3
|
|
|
18828
19343
|
#
|
|
18829
19344
|
# * [DeleteObjectTagging][5]
|
|
18830
19345
|
#
|
|
19346
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19347
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19348
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19349
|
+
#
|
|
18831
19350
|
#
|
|
18832
19351
|
#
|
|
18833
19352
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html
|
|
@@ -18904,21 +19423,9 @@ module Aws::S3
|
|
|
18904
19423
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
18905
19424
|
#
|
|
18906
19425
|
# @option params [String] :request_payer
|
|
18907
|
-
# Confirms that the requester knows that
|
|
18908
|
-
# request. Bucket owners need not specify this
|
|
18909
|
-
#
|
|
18910
|
-
# Pays enabled, the requester will pay for corresponding charges to copy
|
|
18911
|
-
# the object. For information about downloading objects from Requester
|
|
18912
|
-
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
|
18913
|
-
# in the *Amazon S3 User Guide*.
|
|
18914
|
-
#
|
|
18915
|
-
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
18916
|
-
#
|
|
18917
|
-
# </note>
|
|
18918
|
-
#
|
|
18919
|
-
#
|
|
18920
|
-
#
|
|
18921
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
|
19426
|
+
# Confirms that the requester knows that she or he will be charged for
|
|
19427
|
+
# the tagging object request. Bucket owners need not specify this
|
|
19428
|
+
# parameter in their requests.
|
|
18922
19429
|
#
|
|
18923
19430
|
# @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
18924
19431
|
#
|
|
@@ -18996,10 +19503,11 @@ module Aws::S3
|
|
|
18996
19503
|
# When Amazon S3 evaluates the `PublicAccessBlock` configuration for a
|
|
18997
19504
|
# bucket or an object, it checks the `PublicAccessBlock` configuration
|
|
18998
19505
|
# for both the bucket (or the bucket that contains the object) and the
|
|
18999
|
-
# bucket owner's account.
|
|
19000
|
-
#
|
|
19001
|
-
#
|
|
19002
|
-
#
|
|
19506
|
+
# bucket owner's account. Account-level settings automatically inherit
|
|
19507
|
+
# from organization-level policies when present. If the
|
|
19508
|
+
# `PublicAccessBlock` configurations are different between the bucket
|
|
19509
|
+
# and the account, Amazon S3 uses the most restrictive combination of
|
|
19510
|
+
# the bucket-level and account-level settings.
|
|
19003
19511
|
#
|
|
19004
19512
|
# For more information about when Amazon S3 considers a bucket or an
|
|
19005
19513
|
# object public, see [The Meaning of "Public"][2].
|
|
@@ -19014,6 +19522,10 @@ module Aws::S3
|
|
|
19014
19522
|
#
|
|
19015
19523
|
# * [Using Amazon S3 Block Public Access][6]
|
|
19016
19524
|
#
|
|
19525
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19526
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19527
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19528
|
+
#
|
|
19017
19529
|
#
|
|
19018
19530
|
#
|
|
19019
19531
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -19143,6 +19655,10 @@ module Aws::S3
|
|
|
19143
19655
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
19144
19656
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
19145
19657
|
#
|
|
19658
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19659
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19660
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19661
|
+
#
|
|
19146
19662
|
#
|
|
19147
19663
|
#
|
|
19148
19664
|
# [1]: https://datatracker.ietf.org/doc/rfc7232/
|
|
@@ -19427,6 +19943,10 @@ module Aws::S3
|
|
|
19427
19943
|
#
|
|
19428
19944
|
# * [GetBucketNotificationConfiguration][11]
|
|
19429
19945
|
#
|
|
19946
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19947
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19948
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19949
|
+
#
|
|
19430
19950
|
#
|
|
19431
19951
|
#
|
|
19432
19952
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
|
@@ -19484,10 +20004,10 @@ module Aws::S3
|
|
|
19484
20004
|
# Confirms that the requester knows that they will be charged for the
|
|
19485
20005
|
# request. Bucket owners need not specify this parameter in their
|
|
19486
20006
|
# requests. If either the source or destination S3 bucket has Requester
|
|
19487
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
19488
|
-
#
|
|
19489
|
-
#
|
|
19490
|
-
#
|
|
20007
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
20008
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
20009
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
20010
|
+
# S3 User Guide*.
|
|
19491
20011
|
#
|
|
19492
20012
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
19493
20013
|
#
|
|
@@ -19626,7 +20146,7 @@ module Aws::S3
|
|
|
19626
20146
|
# value: "MetadataValue",
|
|
19627
20147
|
# },
|
|
19628
20148
|
# ],
|
|
19629
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
20149
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
19630
20150
|
# },
|
|
19631
20151
|
# },
|
|
19632
20152
|
# },
|
|
@@ -19750,6 +20270,10 @@ module Aws::S3
|
|
|
19750
20270
|
#
|
|
19751
20271
|
# * [PutBucketLifecycleConfiguration][12]
|
|
19752
20272
|
#
|
|
20273
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20274
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20275
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20276
|
+
#
|
|
19753
20277
|
#
|
|
19754
20278
|
#
|
|
19755
20279
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
|
@@ -20114,6 +20638,10 @@ module Aws::S3
|
|
|
20114
20638
|
#
|
|
20115
20639
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
20116
20640
|
#
|
|
20641
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20642
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20643
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20644
|
+
#
|
|
20117
20645
|
#
|
|
20118
20646
|
#
|
|
20119
20647
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20192,6 +20720,10 @@ module Aws::S3
|
|
|
20192
20720
|
#
|
|
20193
20721
|
# * [UpdateBucketMetadataInventoryTableConfiguration][6]
|
|
20194
20722
|
#
|
|
20723
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20724
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20725
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20726
|
+
#
|
|
20195
20727
|
#
|
|
20196
20728
|
#
|
|
20197
20729
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20246,6 +20778,260 @@ module Aws::S3
|
|
|
20246
20778
|
req.send_request(options)
|
|
20247
20779
|
end
|
|
20248
20780
|
|
|
20781
|
+
# <note markdown="1"> This operation is not supported for directory buckets or Amazon S3 on
|
|
20782
|
+
# Outposts buckets.
|
|
20783
|
+
#
|
|
20784
|
+
# </note>
|
|
20785
|
+
#
|
|
20786
|
+
# Updates the server-side encryption type of an existing encrypted
|
|
20787
|
+
# object in a general purpose bucket. You can use the
|
|
20788
|
+
# `UpdateObjectEncryption` operation to change encrypted objects from
|
|
20789
|
+
# server-side encryption with Amazon S3 managed keys (SSE-S3) to
|
|
20790
|
+
# server-side encryption with Key Management Service (KMS) keys
|
|
20791
|
+
# (SSE-KMS), or to apply S3 Bucket Keys. You can also use the
|
|
20792
|
+
# `UpdateObjectEncryption` operation to change the customer-managed KMS
|
|
20793
|
+
# key used to encrypt your data so that you can comply with custom
|
|
20794
|
+
# key-rotation standards.
|
|
20795
|
+
#
|
|
20796
|
+
# Using the `UpdateObjectEncryption` operation, you can atomically
|
|
20797
|
+
# update the server-side encryption type of an existing object in a
|
|
20798
|
+
# general purpose bucket without any data movement. The
|
|
20799
|
+
# `UpdateObjectEncryption` operation uses envelope encryption to
|
|
20800
|
+
# re-encrypt the data key used to encrypt and decrypt your object with
|
|
20801
|
+
# your newly specified server-side encryption type. In other words, when
|
|
20802
|
+
# you use the `UpdateObjectEncryption` operation, your data isn't
|
|
20803
|
+
# copied, archived objects in the S3 Glacier Flexible Retrieval and S3
|
|
20804
|
+
# Glacier Deep Archive storage classes aren't restored, and objects in
|
|
20805
|
+
# the S3 Intelligent-Tiering storage class aren't moved between tiers.
|
|
20806
|
+
# Additionally, the `UpdateObjectEncryption` operation preserves all
|
|
20807
|
+
# object metadata properties, including the storage class, creation
|
|
20808
|
+
# date, last modified date, ETag, and checksum properties. For more
|
|
20809
|
+
# information, see [ Updating server-side encryption for existing
|
|
20810
|
+
# objects][1] in the *Amazon S3 User Guide*.
|
|
20811
|
+
#
|
|
20812
|
+
# By default, all `UpdateObjectEncryption` requests that specify a
|
|
20813
|
+
# customer-managed KMS key are restricted to KMS keys that are owned by
|
|
20814
|
+
# the bucket owner's Amazon Web Services account. If you're using
|
|
20815
|
+
# Organizations, you can request the ability to use KMS keys owned by
|
|
20816
|
+
# other member accounts within your organization by contacting Amazon
|
|
20817
|
+
# Web Services Support.
|
|
20818
|
+
#
|
|
20819
|
+
# <note markdown="1"> Source objects that are unencrypted, or encrypted with either
|
|
20820
|
+
# dual-layer server-side encryption with KMS keys (DSSE-KMS) or
|
|
20821
|
+
# server-side encryption with customer-provided keys (SSE-C) aren't
|
|
20822
|
+
# supported by this operation. Additionally, you cannot specify SSE-S3
|
|
20823
|
+
# encryption as the requested new encryption type
|
|
20824
|
+
# `UpdateObjectEncryption` request.
|
|
20825
|
+
#
|
|
20826
|
+
# </note>
|
|
20827
|
+
#
|
|
20828
|
+
# Permissions
|
|
20829
|
+
# : * To use the `UpdateObjectEncryption` operation, you must have the
|
|
20830
|
+
# following permissions:
|
|
20831
|
+
#
|
|
20832
|
+
# * `s3:PutObject`
|
|
20833
|
+
#
|
|
20834
|
+
# * `s3:UpdateObjectEncryption`
|
|
20835
|
+
#
|
|
20836
|
+
# * `kms:Encrypt`
|
|
20837
|
+
#
|
|
20838
|
+
# * `kms:Decrypt`
|
|
20839
|
+
#
|
|
20840
|
+
# * `kms:GenerateDataKey`
|
|
20841
|
+
#
|
|
20842
|
+
# * `kms:ReEncrypt*`
|
|
20843
|
+
# * If you're using Organizations, to use this operation with
|
|
20844
|
+
# customer-managed KMS keys from other Amazon Web Services accounts
|
|
20845
|
+
# within your organization, you must have the
|
|
20846
|
+
# `organizations:DescribeAccount` permission.
|
|
20847
|
+
# ^
|
|
20848
|
+
#
|
|
20849
|
+
# Errors
|
|
20850
|
+
# : * You might receive an `InvalidRequest` error for several reasons.
|
|
20851
|
+
# Depending on the reason for the error, you might receive one of
|
|
20852
|
+
# the following messages:
|
|
20853
|
+
#
|
|
20854
|
+
# * The `UpdateObjectEncryption` operation doesn't supported
|
|
20855
|
+
# unencrypted source objects. Only source objects encrypted with
|
|
20856
|
+
# SSE-S3 or SSE-KMS are supported.
|
|
20857
|
+
#
|
|
20858
|
+
# * The `UpdateObjectEncryption` operation doesn't support source
|
|
20859
|
+
# objects with the encryption type DSSE-KMS or SSE-C. Only source
|
|
20860
|
+
# objects encrypted with SSE-S3 or SSE-KMS are supported.
|
|
20861
|
+
#
|
|
20862
|
+
# * The `UpdateObjectEncryption` operation doesn't support updating
|
|
20863
|
+
# the encryption type to DSSE-KMS or SSE-C. Modify the request to
|
|
20864
|
+
# specify SSE-KMS for the updated encryption type, and then try
|
|
20865
|
+
# again.
|
|
20866
|
+
#
|
|
20867
|
+
# * Requests that modify an object encryption configuration require
|
|
20868
|
+
# Amazon Web Services Signature Version 4. Modify the request to
|
|
20869
|
+
# use Amazon Web Services Signature Version 4, and then try again.
|
|
20870
|
+
#
|
|
20871
|
+
# * Requests that modify an object encryption configuration require
|
|
20872
|
+
# a valid new encryption type. Valid values are `SSEKMS`. Modify
|
|
20873
|
+
# the request to specify SSE-KMS for the updated encryption type,
|
|
20874
|
+
# and then try again.
|
|
20875
|
+
#
|
|
20876
|
+
# * Requests that modify an object's encryption type to SSE-KMS
|
|
20877
|
+
# require an Amazon Web Services KMS key Amazon Resource Name
|
|
20878
|
+
# (ARN). Modify the request to specify a KMS key ARN, and then try
|
|
20879
|
+
# again.
|
|
20880
|
+
#
|
|
20881
|
+
# * Requests that modify an object's encryption type to SSE-KMS
|
|
20882
|
+
# require a valid Amazon Web Services KMS key Amazon Resource Name
|
|
20883
|
+
# (ARN). Confirm that you have a correctly formatted KMS key ARN
|
|
20884
|
+
# in your request, and then try again.
|
|
20885
|
+
#
|
|
20886
|
+
# * The `BucketKeyEnabled` value isn't valid. Valid values are
|
|
20887
|
+
# `true` or `false`. Modify the request to specify a valid value,
|
|
20888
|
+
# and then try again.
|
|
20889
|
+
# * You might receive an `AccessDenied` error for several reasons.
|
|
20890
|
+
# Depending on the reason for the error, you might receive one of
|
|
20891
|
+
# the following messages:
|
|
20892
|
+
#
|
|
20893
|
+
# * The Amazon Web Services KMS key in the request must be owned by
|
|
20894
|
+
# the same account as the bucket. Modify the request to specify a
|
|
20895
|
+
# KMS key from the same account, and then try again.
|
|
20896
|
+
#
|
|
20897
|
+
# * The bucket owner's account was approved to make
|
|
20898
|
+
# `UpdateObjectEncryption` requests that use any Amazon Web
|
|
20899
|
+
# Services KMS key in their organization, but the bucket owner's
|
|
20900
|
+
# account isn't part of an organization in Organizations. Make
|
|
20901
|
+
# sure that the bucket owner's account and the specified KMS key
|
|
20902
|
+
# belong to the same organization, and then try again.
|
|
20903
|
+
#
|
|
20904
|
+
# * The specified Amazon Web Services KMS key must be from the same
|
|
20905
|
+
# organization in Organizations as the bucket. Specify a KMS key
|
|
20906
|
+
# that belongs to the same organization as the bucket, and then
|
|
20907
|
+
# try again.
|
|
20908
|
+
#
|
|
20909
|
+
# * The encryption type for the specified object can’t be updated
|
|
20910
|
+
# because that object is protected by S3 Object Lock. If the
|
|
20911
|
+
# object has a governance-mode retention period or a legal hold,
|
|
20912
|
+
# you must first remove the Object Lock status on the object
|
|
20913
|
+
# before you issue your `UpdateObjectEncryption` request. You
|
|
20914
|
+
# can't use the `UpdateObjectEncryption` operation with objects
|
|
20915
|
+
# that have an Object Lock compliance mode retention period
|
|
20916
|
+
# applied to them.
|
|
20917
|
+
#
|
|
20918
|
+
#
|
|
20919
|
+
#
|
|
20920
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/update-sse-encryption.html
|
|
20921
|
+
#
|
|
20922
|
+
# @option params [required, String] :bucket
|
|
20923
|
+
# The name of the general purpose bucket that contains the specified
|
|
20924
|
+
# object key name.
|
|
20925
|
+
#
|
|
20926
|
+
# When you use this operation with an access point attached to a general
|
|
20927
|
+
# purpose bucket, you must either provide the alias of the access point
|
|
20928
|
+
# in place of the bucket name or you must specify the access point
|
|
20929
|
+
# Amazon Resource Name (ARN). When using the access point ARN, you must
|
|
20930
|
+
# direct requests to the access point hostname. The access point
|
|
20931
|
+
# hostname takes the form `
|
|
20932
|
+
# AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com`. When
|
|
20933
|
+
# using this operation with an access point through the Amazon Web
|
|
20934
|
+
# Services SDKs, you provide the access point ARN in place of the bucket
|
|
20935
|
+
# name. For more information about access point ARNs, see [ Referencing
|
|
20936
|
+
# access points][1] in the *Amazon S3 User Guide*.
|
|
20937
|
+
#
|
|
20938
|
+
#
|
|
20939
|
+
#
|
|
20940
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points-naming.html
|
|
20941
|
+
#
|
|
20942
|
+
# @option params [required, String] :key
|
|
20943
|
+
# The key name of the object that you want to update the server-side
|
|
20944
|
+
# encryption type for.
|
|
20945
|
+
#
|
|
20946
|
+
# @option params [String] :version_id
|
|
20947
|
+
# The version ID of the object that you want to update the server-side
|
|
20948
|
+
# encryption type for.
|
|
20949
|
+
#
|
|
20950
|
+
# @option params [required, Types::ObjectEncryption] :object_encryption
|
|
20951
|
+
# The updated server-side encryption type for this object. The
|
|
20952
|
+
# `UpdateObjectEncryption` operation supports the SSE-S3 and SSE-KMS
|
|
20953
|
+
# encryption types.
|
|
20954
|
+
#
|
|
20955
|
+
# Valid Values: `SSES3` \| `SSEKMS`
|
|
20956
|
+
#
|
|
20957
|
+
# @option params [String] :request_payer
|
|
20958
|
+
# Confirms that the requester knows that they will be charged for the
|
|
20959
|
+
# request. Bucket owners need not specify this parameter in their
|
|
20960
|
+
# requests. If either the source or destination S3 bucket has Requester
|
|
20961
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
20962
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
20963
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
20964
|
+
# S3 User Guide*.
|
|
20965
|
+
#
|
|
20966
|
+
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
20967
|
+
#
|
|
20968
|
+
# </note>
|
|
20969
|
+
#
|
|
20970
|
+
#
|
|
20971
|
+
#
|
|
20972
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
|
20973
|
+
#
|
|
20974
|
+
# @option params [String] :expected_bucket_owner
|
|
20975
|
+
# The account ID of the expected bucket owner. If the account ID that
|
|
20976
|
+
# you provide doesn't match the actual owner of the bucket, the request
|
|
20977
|
+
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
20978
|
+
#
|
|
20979
|
+
# @option params [String] :content_md5
|
|
20980
|
+
# The MD5 hash for the request body. For requests made using the Amazon
|
|
20981
|
+
# Web Services Command Line Interface (CLI) or Amazon Web Services SDKs,
|
|
20982
|
+
# this field is calculated automatically.
|
|
20983
|
+
#
|
|
20984
|
+
# @option params [String] :checksum_algorithm
|
|
20985
|
+
# Indicates the algorithm used to create the checksum for the object
|
|
20986
|
+
# when you use an Amazon Web Services SDK. This header doesn't provide
|
|
20987
|
+
# any additional functionality if you don't use the SDK. When you send
|
|
20988
|
+
# this header, there must be a corresponding `x-amz-checksum` or
|
|
20989
|
+
# `x-amz-trailer` header sent. Otherwise, Amazon S3 fails the request
|
|
20990
|
+
# with the HTTP status code `400 Bad Request`. For more information, see
|
|
20991
|
+
# [ Checking object integrity ][1] in the *Amazon S3 User Guide*.
|
|
20992
|
+
#
|
|
20993
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
|
20994
|
+
# `ChecksumAlgorithm` parameter.
|
|
20995
|
+
#
|
|
20996
|
+
#
|
|
20997
|
+
#
|
|
20998
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
|
20999
|
+
#
|
|
21000
|
+
# @return [Types::UpdateObjectEncryptionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
21001
|
+
#
|
|
21002
|
+
# * {Types::UpdateObjectEncryptionResponse#request_charged #request_charged} => String
|
|
21003
|
+
#
|
|
21004
|
+
# @example Request syntax with placeholder values
|
|
21005
|
+
#
|
|
21006
|
+
# resp = client.update_object_encryption({
|
|
21007
|
+
# bucket: "BucketName", # required
|
|
21008
|
+
# key: "ObjectKey", # required
|
|
21009
|
+
# version_id: "ObjectVersionId",
|
|
21010
|
+
# object_encryption: { # required
|
|
21011
|
+
# ssekms: {
|
|
21012
|
+
# kms_key_arn: "NonEmptyKmsKeyArnString", # required
|
|
21013
|
+
# bucket_key_enabled: false,
|
|
21014
|
+
# },
|
|
21015
|
+
# },
|
|
21016
|
+
# request_payer: "requester", # accepts requester
|
|
21017
|
+
# expected_bucket_owner: "AccountId",
|
|
21018
|
+
# content_md5: "ContentMD5",
|
|
21019
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
|
21020
|
+
# })
|
|
21021
|
+
#
|
|
21022
|
+
# @example Response structure
|
|
21023
|
+
#
|
|
21024
|
+
# resp.request_charged #=> String, one of "requester"
|
|
21025
|
+
#
|
|
21026
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UpdateObjectEncryption AWS API Documentation
|
|
21027
|
+
#
|
|
21028
|
+
# @overload update_object_encryption(params = {})
|
|
21029
|
+
# @param [Hash] params ({})
|
|
21030
|
+
def update_object_encryption(params = {}, options = {})
|
|
21031
|
+
req = build_request(:update_object_encryption, params)
|
|
21032
|
+
req.send_request(options)
|
|
21033
|
+
end
|
|
21034
|
+
|
|
20249
21035
|
# Uploads a part in a multipart upload.
|
|
20250
21036
|
#
|
|
20251
21037
|
# <note markdown="1"> In this operation, you provide new data as a part of an object in your
|
|
@@ -20373,6 +21159,15 @@ module Aws::S3
|
|
|
20373
21159
|
# Multipart request. For more information, see
|
|
20374
21160
|
# [CreateMultipartUpload][2].
|
|
20375
21161
|
#
|
|
21162
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
21163
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
21164
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
21165
|
+
# headers while writing new data to your bucket. For more
|
|
21166
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
21167
|
+
# purpose bucket][12].
|
|
21168
|
+
#
|
|
21169
|
+
# </note>
|
|
21170
|
+
#
|
|
20376
21171
|
# If you request server-side encryption using a customer-provided
|
|
20377
21172
|
# encryption key (SSE-C) in your initiate multipart upload request,
|
|
20378
21173
|
# you must provide identical encryption information in each part
|
|
@@ -20383,7 +21178,7 @@ module Aws::S3
|
|
|
20383
21178
|
# * x-amz-server-side-encryption-customer-key
|
|
20384
21179
|
#
|
|
20385
21180
|
# * x-amz-server-side-encryption-customer-key-MD5
|
|
20386
|
-
# For more information, see [Using Server-Side Encryption][
|
|
21181
|
+
# For more information, see [Using Server-Side Encryption][13] in
|
|
20387
21182
|
# the *Amazon S3 User Guide*.
|
|
20388
21183
|
#
|
|
20389
21184
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
@@ -20411,13 +21206,17 @@ module Aws::S3
|
|
|
20411
21206
|
#
|
|
20412
21207
|
# * [CreateMultipartUpload][2]
|
|
20413
21208
|
#
|
|
20414
|
-
# * [CompleteMultipartUpload][
|
|
21209
|
+
# * [CompleteMultipartUpload][14]
|
|
20415
21210
|
#
|
|
20416
|
-
# * [AbortMultipartUpload][
|
|
21211
|
+
# * [AbortMultipartUpload][15]
|
|
21212
|
+
#
|
|
21213
|
+
# * [ListParts][16]
|
|
20417
21214
|
#
|
|
20418
|
-
# * [
|
|
21215
|
+
# * [ListMultipartUploads][17]
|
|
20419
21216
|
#
|
|
20420
|
-
#
|
|
21217
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21218
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21219
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20421
21220
|
#
|
|
20422
21221
|
#
|
|
20423
21222
|
#
|
|
@@ -20432,13 +21231,14 @@ module Aws::S3
|
|
|
20432
21231
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
|
20433
21232
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
|
20434
21233
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
|
|
20435
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
20436
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
20437
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20438
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20439
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
21234
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
21235
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
|
21236
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
21237
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
21238
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
21239
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20440
21240
|
#
|
|
20441
|
-
# @option params [String,
|
|
21241
|
+
# @option params [String, IO] :body
|
|
20442
21242
|
# Object data.
|
|
20443
21243
|
#
|
|
20444
21244
|
# @option params [required, String] :bucket
|
|
@@ -20618,10 +21418,10 @@ module Aws::S3
|
|
|
20618
21418
|
# Confirms that the requester knows that they will be charged for the
|
|
20619
21419
|
# request. Bucket owners need not specify this parameter in their
|
|
20620
21420
|
# requests. If either the source or destination S3 bucket has Requester
|
|
20621
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
20622
|
-
#
|
|
20623
|
-
#
|
|
20624
|
-
#
|
|
21421
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
21422
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
21423
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
21424
|
+
# S3 User Guide*.
|
|
20625
21425
|
#
|
|
20626
21426
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
20627
21427
|
#
|
|
@@ -20835,12 +21635,21 @@ module Aws::S3
|
|
|
20835
21635
|
# the `UploadPartCopy` operation, see [CopyObject][13] and
|
|
20836
21636
|
# [UploadPart][2].
|
|
20837
21637
|
#
|
|
21638
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
21639
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
21640
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
21641
|
+
# headers while writing new data to your bucket. For more
|
|
21642
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
21643
|
+
# purpose bucket][14].
|
|
21644
|
+
#
|
|
21645
|
+
# </note>
|
|
21646
|
+
#
|
|
20838
21647
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
20839
21648
|
# two supported options for server-side encryption: server-side
|
|
20840
21649
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
|
20841
21650
|
# server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
|
|
20842
21651
|
# more information, see [Protecting data with server-side
|
|
20843
|
-
# encryption][
|
|
21652
|
+
# encryption][15] in the *Amazon S3 User Guide*.
|
|
20844
21653
|
#
|
|
20845
21654
|
# <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
|
|
20846
21655
|
# operation and an `UploadPartCopy` operation, the request headers
|
|
@@ -20852,7 +21661,7 @@ module Aws::S3
|
|
|
20852
21661
|
# S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
|
|
20853
21662
|
# objects from general purpose buckets to directory buckets, from
|
|
20854
21663
|
# directory buckets to general purpose buckets, or between directory
|
|
20855
|
-
# buckets, through [UploadPartCopy][
|
|
21664
|
+
# buckets, through [UploadPartCopy][16]. In this case, Amazon S3
|
|
20856
21665
|
# makes a call to KMS every time a copy request is made for a
|
|
20857
21666
|
# KMS-encrypted object.
|
|
20858
21667
|
#
|
|
@@ -20878,17 +21687,21 @@ module Aws::S3
|
|
|
20878
21687
|
#
|
|
20879
21688
|
# The following operations are related to `UploadPartCopy`:
|
|
20880
21689
|
#
|
|
20881
|
-
# * [CreateMultipartUpload][
|
|
21690
|
+
# * [CreateMultipartUpload][17]
|
|
20882
21691
|
#
|
|
20883
21692
|
# * [UploadPart][2]
|
|
20884
21693
|
#
|
|
20885
|
-
# * [CompleteMultipartUpload][
|
|
21694
|
+
# * [CompleteMultipartUpload][18]
|
|
21695
|
+
#
|
|
21696
|
+
# * [AbortMultipartUpload][19]
|
|
20886
21697
|
#
|
|
20887
|
-
# * [
|
|
21698
|
+
# * [ListParts][20]
|
|
20888
21699
|
#
|
|
20889
|
-
# * [
|
|
21700
|
+
# * [ListMultipartUploads][21]
|
|
20890
21701
|
#
|
|
20891
|
-
#
|
|
21702
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21703
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21704
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20892
21705
|
#
|
|
20893
21706
|
#
|
|
20894
21707
|
#
|
|
@@ -20905,13 +21718,14 @@ module Aws::S3
|
|
|
20905
21718
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
|
20906
21719
|
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
|
20907
21720
|
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
|
20908
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
20909
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
20910
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20911
|
-
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20912
|
-
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20913
|
-
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
20914
|
-
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
21721
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
21722
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
|
21723
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
|
21724
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
|
21725
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
21726
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
21727
|
+
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
21728
|
+
# [21]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20915
21729
|
#
|
|
20916
21730
|
# @option params [required, String] :bucket
|
|
20917
21731
|
# The bucket name.
|
|
@@ -21169,10 +21983,10 @@ module Aws::S3
|
|
|
21169
21983
|
# Confirms that the requester knows that they will be charged for the
|
|
21170
21984
|
# request. Bucket owners need not specify this parameter in their
|
|
21171
21985
|
# requests. If either the source or destination S3 bucket has Requester
|
|
21172
|
-
# Pays enabled, the requester will pay for corresponding charges
|
|
21173
|
-
#
|
|
21174
|
-
#
|
|
21175
|
-
#
|
|
21986
|
+
# Pays enabled, the requester will pay for the corresponding charges.
|
|
21987
|
+
# For information about downloading objects from Requester Pays buckets,
|
|
21988
|
+
# see [Downloading Objects in Requester Pays Buckets][1] in the *Amazon
|
|
21989
|
+
# S3 User Guide*.
|
|
21176
21990
|
#
|
|
21177
21991
|
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
21178
21992
|
#
|
|
@@ -21353,6 +22167,10 @@ module Aws::S3
|
|
|
21353
22167
|
# Amazon Web Services built Lambda functions][3] in the *Amazon S3 User
|
|
21354
22168
|
# Guide*.
|
|
21355
22169
|
#
|
|
22170
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
22171
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
22172
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
22173
|
+
#
|
|
21356
22174
|
#
|
|
21357
22175
|
#
|
|
21358
22176
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
|
|
@@ -21702,7 +22520,7 @@ module Aws::S3
|
|
|
21702
22520
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
21703
22521
|
# ssekms_key_id: "SSEKMSKeyId",
|
|
21704
22522
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
|
21705
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
|
22523
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
|
|
21706
22524
|
# tag_count: 1,
|
|
21707
22525
|
# version_id: "ObjectVersionId",
|
|
21708
22526
|
# bucket_key_enabled: false,
|
|
@@ -21735,7 +22553,7 @@ module Aws::S3
|
|
|
21735
22553
|
tracer: tracer
|
|
21736
22554
|
)
|
|
21737
22555
|
context[:gem_name] = 'aws-sdk-s3'
|
|
21738
|
-
context[:gem_version] = '1.
|
|
22556
|
+
context[:gem_version] = '1.213.0'
|
|
21739
22557
|
Seahorse::Client::Request.new(handlers, context)
|
|
21740
22558
|
end
|
|
21741
22559
|
|