aws-sdk-s3 1.200.0 → 1.206.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 +37 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +1 -1
- 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 +890 -342
- data/lib/aws-sdk-s3/client_api.rb +61 -0
- data/lib/aws-sdk-s3/customizations/object.rb +3 -4
- data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
- data/lib/aws-sdk-s3/endpoint_provider.rb +220 -50
- data/lib/aws-sdk-s3/endpoints.rb +26 -0
- data/lib/aws-sdk-s3/file_downloader.rb +19 -2
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +22 -11
- data/lib/aws-sdk-s3/object.rb +56 -27
- data/lib/aws-sdk-s3/object_acl.rb +1 -1
- data/lib/aws-sdk-s3/object_summary.rb +42 -13
- data/lib/aws-sdk-s3/object_version.rb +7 -9
- data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
- data/lib/aws-sdk-s3/transfer_manager.rb +3 -4
- data/lib/aws-sdk-s3/types.rb +379 -215
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +1 -1
- data/sig/client.rbs +39 -11
- data/sig/multipart_upload.rbs +1 -1
- data/sig/object.rbs +7 -5
- data/sig/object_summary.rbs +7 -5
- data/sig/types.rbs +46 -13
- metadata +3 -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
|
|
@@ -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
|
|
@@ -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.
|
|
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).
|
|
1302
1310
|
#
|
|
1303
|
-
#
|
|
1304
|
-
#
|
|
1305
|
-
# <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
|
|
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
|
#
|
|
@@ -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
|
|
@@ -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]
|
|
5412
|
+
#
|
|
5413
|
+
# * [PutBucketTagging][4]
|
|
5319
5414
|
#
|
|
5320
|
-
#
|
|
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`.
|
|
5321
5418
|
#
|
|
5322
5419
|
#
|
|
5323
5420
|
#
|
|
5324
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
5325
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
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
|
|
@@ -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`.
|
|
5651
|
-
#
|
|
5652
|
-
# For more information about conditional requests, see [RFC 7232][1].
|
|
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.
|
|
5653
5769
|
#
|
|
5654
|
-
#
|
|
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.
|
|
5655
5772
|
#
|
|
5656
|
-
#
|
|
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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -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
|
|
@@ -15138,6 +15547,10 @@ module Aws::S3
|
|
|
15138
15547
|
#
|
|
15139
15548
|
# * [DeleteBucketLifecycle][10]
|
|
15140
15549
|
#
|
|
15550
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15551
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15552
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15553
|
+
#
|
|
15141
15554
|
#
|
|
15142
15555
|
#
|
|
15143
15556
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
|
|
@@ -15315,19 +15728,17 @@ module Aws::S3
|
|
|
15315
15728
|
req.send_request(options)
|
|
15316
15729
|
end
|
|
15317
15730
|
|
|
15318
|
-
# End of support notice:
|
|
15319
|
-
#
|
|
15320
|
-
#
|
|
15321
|
-
#
|
|
15322
|
-
#
|
|
15323
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
15731
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
15732
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
15733
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
15734
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
15735
|
+
# error.
|
|
15324
15736
|
#
|
|
15325
15737
|
# This change affects the following Amazon Web Services Regions: US
|
|
15326
15738
|
# East
|
|
15327
|
-
# (N. Virginia)
|
|
15328
|
-
#
|
|
15329
|
-
#
|
|
15330
|
-
# America (São Paulo) Region.
|
|
15739
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
15740
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
15741
|
+
# (Ireland), and South America (São Paulo).
|
|
15331
15742
|
#
|
|
15332
15743
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
15333
15744
|
#
|
|
@@ -15402,6 +15813,10 @@ module Aws::S3
|
|
|
15402
15813
|
#
|
|
15403
15814
|
# * [GetBucketLogging][5]
|
|
15404
15815
|
#
|
|
15816
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15817
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15818
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15819
|
+
#
|
|
15405
15820
|
#
|
|
15406
15821
|
#
|
|
15407
15822
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
|
|
@@ -15555,6 +15970,10 @@ module Aws::S3
|
|
|
15555
15970
|
#
|
|
15556
15971
|
# * HTTP Status Code: HTTP 400 Bad Request
|
|
15557
15972
|
#
|
|
15973
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15974
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15975
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15976
|
+
#
|
|
15558
15977
|
#
|
|
15559
15978
|
#
|
|
15560
15979
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -15774,6 +16193,10 @@ module Aws::S3
|
|
|
15774
16193
|
#
|
|
15775
16194
|
# ^
|
|
15776
16195
|
#
|
|
16196
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16197
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16198
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16199
|
+
#
|
|
15777
16200
|
#
|
|
15778
16201
|
#
|
|
15779
16202
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
|
@@ -15908,6 +16331,10 @@ module Aws::S3
|
|
|
15908
16331
|
#
|
|
15909
16332
|
# * DeleteBucketOwnershipControls
|
|
15910
16333
|
#
|
|
16334
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16335
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16336
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16337
|
+
#
|
|
15911
16338
|
#
|
|
15912
16339
|
#
|
|
15913
16340
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html
|
|
@@ -16048,6 +16475,10 @@ module Aws::S3
|
|
|
16048
16475
|
#
|
|
16049
16476
|
# * [DeleteBucket][8]
|
|
16050
16477
|
#
|
|
16478
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16479
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16480
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16481
|
+
#
|
|
16051
16482
|
#
|
|
16052
16483
|
#
|
|
16053
16484
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -16256,6 +16687,10 @@ module Aws::S3
|
|
|
16256
16687
|
#
|
|
16257
16688
|
# * [DeleteBucketReplication][11]
|
|
16258
16689
|
#
|
|
16690
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16691
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16692
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16693
|
+
#
|
|
16259
16694
|
#
|
|
16260
16695
|
#
|
|
16261
16696
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
@@ -16382,7 +16817,7 @@ module Aws::S3
|
|
|
16382
16817
|
# destination: { # required
|
|
16383
16818
|
# bucket: "BucketName", # required
|
|
16384
16819
|
# 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
|
|
16820
|
+
# 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
16821
|
# access_control_translation: {
|
|
16387
16822
|
# owner: "Destination", # required, accepts Destination
|
|
16388
16823
|
# },
|
|
@@ -16437,6 +16872,10 @@ module Aws::S3
|
|
|
16437
16872
|
#
|
|
16438
16873
|
# * [GetBucketRequestPayment][3]
|
|
16439
16874
|
#
|
|
16875
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16876
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16877
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16878
|
+
#
|
|
16440
16879
|
#
|
|
16441
16880
|
#
|
|
16442
16881
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
|
@@ -16522,7 +16961,11 @@ module Aws::S3
|
|
|
16522
16961
|
#
|
|
16523
16962
|
# </note>
|
|
16524
16963
|
#
|
|
16525
|
-
# Sets the tags for a bucket
|
|
16964
|
+
# Sets the tags for a general purpose bucket if attribute based access
|
|
16965
|
+
# control (ABAC) is not enabled for the bucket. When you [enable ABAC
|
|
16966
|
+
# for a general purpose bucket][1], you can no longer use this operation
|
|
16967
|
+
# for that bucket and must use the [TagResource][2] or
|
|
16968
|
+
# [UntagResource][3] operations instead.
|
|
16526
16969
|
#
|
|
16527
16970
|
# Use tags to organize your Amazon Web Services bill to reflect your own
|
|
16528
16971
|
# cost structure. To do this, sign up to get your Amazon Web Services
|
|
@@ -16532,8 +16975,8 @@ module Aws::S3
|
|
|
16532
16975
|
# several resources with a specific application name, and then organize
|
|
16533
16976
|
# your billing information to see the total cost of that application
|
|
16534
16977
|
# across several services. For more information, see [Cost Allocation
|
|
16535
|
-
# and Tagging][
|
|
16536
|
-
# Tags][
|
|
16978
|
+
# and Tagging][4] and [Using Cost Allocation in Amazon S3 Bucket
|
|
16979
|
+
# Tags][5].
|
|
16537
16980
|
#
|
|
16538
16981
|
# <note markdown="1"> When this operation sets the tags for a bucket, it will overwrite any
|
|
16539
16982
|
# current tags the bucket already has. You cannot use this operation to
|
|
@@ -16545,16 +16988,16 @@ module Aws::S3
|
|
|
16545
16988
|
# `s3:PutBucketTagging` action. The bucket owner has this permission by
|
|
16546
16989
|
# default and can grant this permission to others. For more information
|
|
16547
16990
|
# about permissions, see [Permissions Related to Bucket Subresource
|
|
16548
|
-
# Operations][
|
|
16549
|
-
# Resources][
|
|
16991
|
+
# Operations][6] and [Managing Access Permissions to Your Amazon S3
|
|
16992
|
+
# Resources][7].
|
|
16550
16993
|
#
|
|
16551
16994
|
# `PutBucketTagging` has the following special errors. For more Amazon
|
|
16552
|
-
# S3 errors see, [Error Responses][
|
|
16995
|
+
# S3 errors see, [Error Responses][8].
|
|
16553
16996
|
#
|
|
16554
16997
|
# * `InvalidTag` - The tag provided was not a valid tag. This error can
|
|
16555
16998
|
# occur if the tag did not pass input validation. For more
|
|
16556
16999
|
# information, see [Using Cost Allocation in Amazon S3 Bucket
|
|
16557
|
-
# Tags][
|
|
17000
|
+
# Tags][5].
|
|
16558
17001
|
#
|
|
16559
17002
|
# * `MalformedXML` - The XML provided does not match the schema.
|
|
16560
17003
|
#
|
|
@@ -16566,19 +17009,26 @@ module Aws::S3
|
|
|
16566
17009
|
#
|
|
16567
17010
|
# The following operations are related to `PutBucketTagging`:
|
|
16568
17011
|
#
|
|
16569
|
-
# * [GetBucketTagging][
|
|
17012
|
+
# * [GetBucketTagging][9]
|
|
16570
17013
|
#
|
|
16571
|
-
# * [DeleteBucketTagging][
|
|
17014
|
+
# * [DeleteBucketTagging][10]
|
|
16572
17015
|
#
|
|
17016
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17017
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17018
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16573
17019
|
#
|
|
16574
17020
|
#
|
|
16575
|
-
#
|
|
16576
|
-
# [
|
|
16577
|
-
# [
|
|
16578
|
-
# [
|
|
16579
|
-
# [
|
|
16580
|
-
# [
|
|
16581
|
-
# [
|
|
17021
|
+
#
|
|
17022
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
17023
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
|
|
17024
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
17025
|
+
# [4]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
|
|
17026
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html
|
|
17027
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
17028
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
17029
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
|
|
17030
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
|
17031
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
16582
17032
|
#
|
|
16583
17033
|
# @option params [required, String] :bucket
|
|
16584
17034
|
# The bucket name.
|
|
@@ -16720,6 +17170,10 @@ module Aws::S3
|
|
|
16720
17170
|
#
|
|
16721
17171
|
# * [GetBucketVersioning][1]
|
|
16722
17172
|
#
|
|
17173
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17174
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17175
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17176
|
+
#
|
|
16723
17177
|
#
|
|
16724
17178
|
#
|
|
16725
17179
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
|
@@ -16763,6 +17217,17 @@ module Aws::S3
|
|
|
16763
17217
|
# @option params [String] :mfa
|
|
16764
17218
|
# The concatenation of the authentication device's serial number, a
|
|
16765
17219
|
# space, and the value that is displayed on your authentication device.
|
|
17220
|
+
# The serial number is the number that uniquely identifies the MFA
|
|
17221
|
+
# device. For physical MFA devices, this is the unique serial number
|
|
17222
|
+
# that's provided with the device. For virtual MFA devices, the serial
|
|
17223
|
+
# number is the device ARN. For more information, see [Enabling
|
|
17224
|
+
# versioning on buckets][1] and [Configuring MFA delete][2] in the
|
|
17225
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
17226
|
+
#
|
|
17227
|
+
#
|
|
17228
|
+
#
|
|
17229
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
|
|
17230
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
|
|
16766
17231
|
#
|
|
16767
17232
|
# @option params [required, Types::VersioningConfiguration] :versioning_configuration
|
|
16768
17233
|
# Container for setting the versioning state.
|
|
@@ -16884,6 +17349,10 @@ module Aws::S3
|
|
|
16884
17349
|
#
|
|
16885
17350
|
# The maximum request length is limited to 128 KB.
|
|
16886
17351
|
#
|
|
17352
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17353
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17354
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17355
|
+
#
|
|
16887
17356
|
#
|
|
16888
17357
|
#
|
|
16889
17358
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -16994,19 +17463,17 @@ module Aws::S3
|
|
|
16994
17463
|
req.send_request(options)
|
|
16995
17464
|
end
|
|
16996
17465
|
|
|
16997
|
-
# End of support notice:
|
|
16998
|
-
#
|
|
16999
|
-
#
|
|
17000
|
-
#
|
|
17001
|
-
#
|
|
17002
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
17466
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
17467
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
17468
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
17469
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
17470
|
+
# error.
|
|
17003
17471
|
#
|
|
17004
17472
|
# This change affects the following Amazon Web Services Regions: US
|
|
17005
17473
|
# East
|
|
17006
|
-
# (N. Virginia)
|
|
17007
|
-
#
|
|
17008
|
-
#
|
|
17009
|
-
# America (São Paulo) Region.
|
|
17474
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
17475
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
17476
|
+
# (Ireland), and South America (São Paulo).
|
|
17010
17477
|
#
|
|
17011
17478
|
# Adds an object to a bucket.
|
|
17012
17479
|
#
|
|
@@ -17137,6 +17604,10 @@ module Aws::S3
|
|
|
17137
17604
|
#
|
|
17138
17605
|
# * [DeleteObject][10]
|
|
17139
17606
|
#
|
|
17607
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17608
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17609
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17610
|
+
#
|
|
17140
17611
|
#
|
|
17141
17612
|
#
|
|
17142
17613
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -17992,7 +18463,7 @@ module Aws::S3
|
|
|
17992
18463
|
# "MetadataKey" => "MetadataValue",
|
|
17993
18464
|
# },
|
|
17994
18465
|
# 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
|
|
18466
|
+
# 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
18467
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
17997
18468
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
17998
18469
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -18037,6 +18508,18 @@ module Aws::S3
|
|
|
18037
18508
|
req.send_request(options)
|
|
18038
18509
|
end
|
|
18039
18510
|
|
|
18511
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
18512
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
18513
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
18514
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
18515
|
+
# error.
|
|
18516
|
+
#
|
|
18517
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
18518
|
+
# East
|
|
18519
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
18520
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
18521
|
+
# (Ireland), and South America (São Paulo).
|
|
18522
|
+
#
|
|
18040
18523
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
18041
18524
|
#
|
|
18042
18525
|
# </note>
|
|
@@ -18197,6 +18680,10 @@ module Aws::S3
|
|
|
18197
18680
|
#
|
|
18198
18681
|
# * [GetObject][8]
|
|
18199
18682
|
#
|
|
18683
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
18684
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
18685
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
18686
|
+
#
|
|
18200
18687
|
#
|
|
18201
18688
|
#
|
|
18202
18689
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
|
|
@@ -18421,6 +18908,10 @@ module Aws::S3
|
|
|
18421
18908
|
#
|
|
18422
18909
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18423
18910
|
#
|
|
18911
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
18912
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
18913
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
18914
|
+
#
|
|
18424
18915
|
#
|
|
18425
18916
|
#
|
|
18426
18917
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18553,6 +19044,10 @@ module Aws::S3
|
|
|
18553
19044
|
#
|
|
18554
19045
|
# </note>
|
|
18555
19046
|
#
|
|
19047
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19048
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19049
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19050
|
+
#
|
|
18556
19051
|
#
|
|
18557
19052
|
#
|
|
18558
19053
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18664,6 +19159,10 @@ module Aws::S3
|
|
|
18664
19159
|
#
|
|
18665
19160
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18666
19161
|
#
|
|
19162
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19163
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19164
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19165
|
+
#
|
|
18667
19166
|
#
|
|
18668
19167
|
#
|
|
18669
19168
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18828,6 +19327,10 @@ module Aws::S3
|
|
|
18828
19327
|
#
|
|
18829
19328
|
# * [DeleteObjectTagging][5]
|
|
18830
19329
|
#
|
|
19330
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19331
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19332
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19333
|
+
#
|
|
18831
19334
|
#
|
|
18832
19335
|
#
|
|
18833
19336
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html
|
|
@@ -18904,21 +19407,9 @@ module Aws::S3
|
|
|
18904
19407
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
18905
19408
|
#
|
|
18906
19409
|
# @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
|
|
19410
|
+
# Confirms that the requester knows that she or he will be charged for
|
|
19411
|
+
# the tagging object request. Bucket owners need not specify this
|
|
19412
|
+
# parameter in their requests.
|
|
18922
19413
|
#
|
|
18923
19414
|
# @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
18924
19415
|
#
|
|
@@ -18996,10 +19487,11 @@ module Aws::S3
|
|
|
18996
19487
|
# When Amazon S3 evaluates the `PublicAccessBlock` configuration for a
|
|
18997
19488
|
# bucket or an object, it checks the `PublicAccessBlock` configuration
|
|
18998
19489
|
# for both the bucket (or the bucket that contains the object) and the
|
|
18999
|
-
# bucket owner's account.
|
|
19000
|
-
#
|
|
19001
|
-
#
|
|
19002
|
-
#
|
|
19490
|
+
# bucket owner's account. Account-level settings automatically inherit
|
|
19491
|
+
# from organization-level policies when present. If the
|
|
19492
|
+
# `PublicAccessBlock` configurations are different between the bucket
|
|
19493
|
+
# and the account, Amazon S3 uses the most restrictive combination of
|
|
19494
|
+
# the bucket-level and account-level settings.
|
|
19003
19495
|
#
|
|
19004
19496
|
# For more information about when Amazon S3 considers a bucket or an
|
|
19005
19497
|
# object public, see [The Meaning of "Public"][2].
|
|
@@ -19014,6 +19506,10 @@ module Aws::S3
|
|
|
19014
19506
|
#
|
|
19015
19507
|
# * [Using Amazon S3 Block Public Access][6]
|
|
19016
19508
|
#
|
|
19509
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19510
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19511
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19512
|
+
#
|
|
19017
19513
|
#
|
|
19018
19514
|
#
|
|
19019
19515
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -19143,6 +19639,10 @@ module Aws::S3
|
|
|
19143
19639
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
19144
19640
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
19145
19641
|
#
|
|
19642
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19643
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19644
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19645
|
+
#
|
|
19146
19646
|
#
|
|
19147
19647
|
#
|
|
19148
19648
|
# [1]: https://datatracker.ietf.org/doc/rfc7232/
|
|
@@ -19427,6 +19927,10 @@ module Aws::S3
|
|
|
19427
19927
|
#
|
|
19428
19928
|
# * [GetBucketNotificationConfiguration][11]
|
|
19429
19929
|
#
|
|
19930
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19931
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19932
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19933
|
+
#
|
|
19430
19934
|
#
|
|
19431
19935
|
#
|
|
19432
19936
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
|
@@ -19626,7 +20130,7 @@ module Aws::S3
|
|
|
19626
20130
|
# value: "MetadataValue",
|
|
19627
20131
|
# },
|
|
19628
20132
|
# ],
|
|
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
|
|
20133
|
+
# 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
20134
|
# },
|
|
19631
20135
|
# },
|
|
19632
20136
|
# },
|
|
@@ -19750,6 +20254,10 @@ module Aws::S3
|
|
|
19750
20254
|
#
|
|
19751
20255
|
# * [PutBucketLifecycleConfiguration][12]
|
|
19752
20256
|
#
|
|
20257
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20258
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20259
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20260
|
+
#
|
|
19753
20261
|
#
|
|
19754
20262
|
#
|
|
19755
20263
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
|
@@ -20114,6 +20622,10 @@ module Aws::S3
|
|
|
20114
20622
|
#
|
|
20115
20623
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
20116
20624
|
#
|
|
20625
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20626
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20627
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20628
|
+
#
|
|
20117
20629
|
#
|
|
20118
20630
|
#
|
|
20119
20631
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20192,6 +20704,10 @@ module Aws::S3
|
|
|
20192
20704
|
#
|
|
20193
20705
|
# * [UpdateBucketMetadataInventoryTableConfiguration][6]
|
|
20194
20706
|
#
|
|
20707
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20708
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20709
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20710
|
+
#
|
|
20195
20711
|
#
|
|
20196
20712
|
#
|
|
20197
20713
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20373,6 +20889,15 @@ module Aws::S3
|
|
|
20373
20889
|
# Multipart request. For more information, see
|
|
20374
20890
|
# [CreateMultipartUpload][2].
|
|
20375
20891
|
#
|
|
20892
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
20893
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
20894
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
20895
|
+
# headers while writing new data to your bucket. For more
|
|
20896
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
20897
|
+
# purpose bucket][12].
|
|
20898
|
+
#
|
|
20899
|
+
# </note>
|
|
20900
|
+
#
|
|
20376
20901
|
# If you request server-side encryption using a customer-provided
|
|
20377
20902
|
# encryption key (SSE-C) in your initiate multipart upload request,
|
|
20378
20903
|
# you must provide identical encryption information in each part
|
|
@@ -20383,7 +20908,7 @@ module Aws::S3
|
|
|
20383
20908
|
# * x-amz-server-side-encryption-customer-key
|
|
20384
20909
|
#
|
|
20385
20910
|
# * x-amz-server-side-encryption-customer-key-MD5
|
|
20386
|
-
# For more information, see [Using Server-Side Encryption][
|
|
20911
|
+
# For more information, see [Using Server-Side Encryption][13] in
|
|
20387
20912
|
# the *Amazon S3 User Guide*.
|
|
20388
20913
|
#
|
|
20389
20914
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
@@ -20411,13 +20936,17 @@ module Aws::S3
|
|
|
20411
20936
|
#
|
|
20412
20937
|
# * [CreateMultipartUpload][2]
|
|
20413
20938
|
#
|
|
20414
|
-
# * [CompleteMultipartUpload][
|
|
20939
|
+
# * [CompleteMultipartUpload][14]
|
|
20415
20940
|
#
|
|
20416
|
-
# * [AbortMultipartUpload][
|
|
20941
|
+
# * [AbortMultipartUpload][15]
|
|
20417
20942
|
#
|
|
20418
|
-
# * [ListParts][
|
|
20943
|
+
# * [ListParts][16]
|
|
20419
20944
|
#
|
|
20420
|
-
# * [ListMultipartUploads][
|
|
20945
|
+
# * [ListMultipartUploads][17]
|
|
20946
|
+
#
|
|
20947
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20948
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20949
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20421
20950
|
#
|
|
20422
20951
|
#
|
|
20423
20952
|
#
|
|
@@ -20432,11 +20961,12 @@ module Aws::S3
|
|
|
20432
20961
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
|
20433
20962
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
|
20434
20963
|
# [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/
|
|
20964
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
20965
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
|
20966
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
20967
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
20968
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
20969
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20440
20970
|
#
|
|
20441
20971
|
# @option params [String, StringIO, File] :body
|
|
20442
20972
|
# Object data.
|
|
@@ -20835,12 +21365,21 @@ module Aws::S3
|
|
|
20835
21365
|
# the `UploadPartCopy` operation, see [CopyObject][13] and
|
|
20836
21366
|
# [UploadPart][2].
|
|
20837
21367
|
#
|
|
21368
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
21369
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
21370
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
21371
|
+
# headers while writing new data to your bucket. For more
|
|
21372
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
21373
|
+
# purpose bucket][14].
|
|
21374
|
+
#
|
|
21375
|
+
# </note>
|
|
21376
|
+
#
|
|
20838
21377
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
20839
21378
|
# two supported options for server-side encryption: server-side
|
|
20840
21379
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
|
20841
21380
|
# server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
|
|
20842
21381
|
# more information, see [Protecting data with server-side
|
|
20843
|
-
# encryption][
|
|
21382
|
+
# encryption][15] in the *Amazon S3 User Guide*.
|
|
20844
21383
|
#
|
|
20845
21384
|
# <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
|
|
20846
21385
|
# operation and an `UploadPartCopy` operation, the request headers
|
|
@@ -20852,7 +21391,7 @@ module Aws::S3
|
|
|
20852
21391
|
# S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
|
|
20853
21392
|
# objects from general purpose buckets to directory buckets, from
|
|
20854
21393
|
# directory buckets to general purpose buckets, or between directory
|
|
20855
|
-
# buckets, through [UploadPartCopy][
|
|
21394
|
+
# buckets, through [UploadPartCopy][16]. In this case, Amazon S3
|
|
20856
21395
|
# makes a call to KMS every time a copy request is made for a
|
|
20857
21396
|
# KMS-encrypted object.
|
|
20858
21397
|
#
|
|
@@ -20878,17 +21417,21 @@ module Aws::S3
|
|
|
20878
21417
|
#
|
|
20879
21418
|
# The following operations are related to `UploadPartCopy`:
|
|
20880
21419
|
#
|
|
20881
|
-
# * [CreateMultipartUpload][
|
|
21420
|
+
# * [CreateMultipartUpload][17]
|
|
20882
21421
|
#
|
|
20883
21422
|
# * [UploadPart][2]
|
|
20884
21423
|
#
|
|
20885
|
-
# * [CompleteMultipartUpload][
|
|
21424
|
+
# * [CompleteMultipartUpload][18]
|
|
20886
21425
|
#
|
|
20887
|
-
# * [AbortMultipartUpload][
|
|
21426
|
+
# * [AbortMultipartUpload][19]
|
|
20888
21427
|
#
|
|
20889
|
-
# * [ListParts][
|
|
21428
|
+
# * [ListParts][20]
|
|
20890
21429
|
#
|
|
20891
|
-
# * [ListMultipartUploads][
|
|
21430
|
+
# * [ListMultipartUploads][21]
|
|
21431
|
+
#
|
|
21432
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21433
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21434
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20892
21435
|
#
|
|
20893
21436
|
#
|
|
20894
21437
|
#
|
|
@@ -20905,13 +21448,14 @@ module Aws::S3
|
|
|
20905
21448
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
|
20906
21449
|
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
|
20907
21450
|
# [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/
|
|
21451
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
21452
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
|
21453
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
|
21454
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
|
21455
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
21456
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
21457
|
+
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
21458
|
+
# [21]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20915
21459
|
#
|
|
20916
21460
|
# @option params [required, String] :bucket
|
|
20917
21461
|
# The bucket name.
|
|
@@ -21353,6 +21897,10 @@ module Aws::S3
|
|
|
21353
21897
|
# Amazon Web Services built Lambda functions][3] in the *Amazon S3 User
|
|
21354
21898
|
# Guide*.
|
|
21355
21899
|
#
|
|
21900
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21901
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21902
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
21903
|
+
#
|
|
21356
21904
|
#
|
|
21357
21905
|
#
|
|
21358
21906
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
|
|
@@ -21702,7 +22250,7 @@ module Aws::S3
|
|
|
21702
22250
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
21703
22251
|
# ssekms_key_id: "SSEKMSKeyId",
|
|
21704
22252
|
# 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
|
|
22253
|
+
# 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
22254
|
# tag_count: 1,
|
|
21707
22255
|
# version_id: "ObjectVersionId",
|
|
21708
22256
|
# bucket_key_enabled: false,
|
|
@@ -21735,7 +22283,7 @@ module Aws::S3
|
|
|
21735
22283
|
tracer: tracer
|
|
21736
22284
|
)
|
|
21737
22285
|
context[:gem_name] = 'aws-sdk-s3'
|
|
21738
|
-
context[:gem_version] = '1.
|
|
22286
|
+
context[:gem_version] = '1.206.0'
|
|
21739
22287
|
Seahorse::Client::Request.new(handlers, context)
|
|
21740
22288
|
end
|
|
21741
22289
|
|