aws-sdk-s3 1.199.0 → 1.205.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 +44 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
- data/lib/aws-sdk-s3/client.rb +935 -257
- data/lib/aws-sdk-s3/client_api.rb +61 -0
- data/lib/aws-sdk-s3/customizations/object.rb +33 -24
- data/lib/aws-sdk-s3/customizations.rb +1 -0
- data/lib/aws-sdk-s3/default_executor.rb +103 -0
- 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 +192 -112
- data/lib/aws-sdk-s3/file_uploader.rb +6 -8
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +79 -63
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +41 -44
- data/lib/aws-sdk-s3/object.rb +52 -23
- data/lib/aws-sdk-s3/object_summary.rb +38 -9
- 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 +87 -30
- data/lib/aws-sdk-s3/types.rb +383 -140
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/client.rbs +29 -1
- data/sig/object.rbs +2 -0
- data/sig/object_summary.rbs +2 -0
- data/sig/types.rbs +33 -0
- metadata +4 -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,21 +1294,19 @@ module Aws::S3
|
|
|
1286
1294
|
req.send_request(options)
|
|
1287
1295
|
end
|
|
1288
1296
|
|
|
1289
|
-
#
|
|
1290
|
-
#
|
|
1291
|
-
#
|
|
1292
|
-
#
|
|
1293
|
-
#
|
|
1294
|
-
#
|
|
1297
|
+
# Creates a copy of an object that is already stored in Amazon S3.
|
|
1298
|
+
#
|
|
1299
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
1300
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
1301
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
1302
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
1303
|
+
# error.
|
|
1295
1304
|
#
|
|
1296
1305
|
# This change affects the following Amazon Web Services Regions: US
|
|
1297
1306
|
# East
|
|
1298
|
-
# (N. Virginia)
|
|
1299
|
-
#
|
|
1300
|
-
#
|
|
1301
|
-
# America (São Paulo) Region.
|
|
1302
|
-
#
|
|
1303
|
-
# Creates a copy of an object that is already stored in Amazon S3.
|
|
1307
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
1308
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
1309
|
+
# (Ireland), and South America (São Paulo).
|
|
1304
1310
|
#
|
|
1305
1311
|
# <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
|
|
1306
1312
|
# create a copy of your object up to 5 GB in size in a single atomic
|
|
@@ -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",
|
|
@@ -2377,32 +2420,17 @@ module Aws::S3
|
|
|
2377
2420
|
req.send_request(options)
|
|
2378
2421
|
end
|
|
2379
2422
|
|
|
2380
|
-
# End of support notice:
|
|
2381
|
-
#
|
|
2382
|
-
#
|
|
2383
|
-
#
|
|
2384
|
-
#
|
|
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`.
|
|
2423
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
2424
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
2425
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
2426
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
2427
|
+
# error.
|
|
2399
2428
|
#
|
|
2400
2429
|
# This change affects the following Amazon Web Services Regions: US
|
|
2401
2430
|
# East
|
|
2402
|
-
# (N. Virginia)
|
|
2403
|
-
#
|
|
2404
|
-
#
|
|
2405
|
-
# America (São Paulo) Region.
|
|
2431
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
2432
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
2433
|
+
# (Ireland), and South America (São Paulo).
|
|
2406
2434
|
#
|
|
2407
2435
|
# <note markdown="1"> This action creates an Amazon S3 bucket. To create an Amazon S3 on
|
|
2408
2436
|
# Outposts bucket, see [ `CreateBucket` ][1].
|
|
@@ -2525,6 +2553,10 @@ module Aws::S3
|
|
|
2525
2553
|
#
|
|
2526
2554
|
# * [DeleteBucket][13]
|
|
2527
2555
|
#
|
|
2556
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2557
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2558
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2559
|
+
#
|
|
2528
2560
|
#
|
|
2529
2561
|
#
|
|
2530
2562
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
|
|
@@ -2794,6 +2826,10 @@ module Aws::S3
|
|
|
2794
2826
|
#
|
|
2795
2827
|
# * [UpdateBucketMetadataJournalTableConfiguration][8]
|
|
2796
2828
|
#
|
|
2829
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2830
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2831
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2832
|
+
#
|
|
2797
2833
|
#
|
|
2798
2834
|
#
|
|
2799
2835
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -2911,6 +2947,10 @@ module Aws::S3
|
|
|
2911
2947
|
#
|
|
2912
2948
|
# * [GetBucketMetadataTableConfiguration][6]
|
|
2913
2949
|
#
|
|
2950
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
2951
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
2952
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
2953
|
+
#
|
|
2914
2954
|
#
|
|
2915
2955
|
#
|
|
2916
2956
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
|
@@ -2963,19 +3003,17 @@ module Aws::S3
|
|
|
2963
3003
|
req.send_request(options)
|
|
2964
3004
|
end
|
|
2965
3005
|
|
|
2966
|
-
# End of support notice:
|
|
2967
|
-
#
|
|
2968
|
-
#
|
|
2969
|
-
#
|
|
2970
|
-
#
|
|
2971
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
3006
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
3007
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
3008
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
3009
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
3010
|
+
# error.
|
|
2972
3011
|
#
|
|
2973
3012
|
# This change affects the following Amazon Web Services Regions: US
|
|
2974
3013
|
# East
|
|
2975
|
-
# (N. Virginia)
|
|
2976
|
-
#
|
|
2977
|
-
#
|
|
2978
|
-
# America (São Paulo) Region.
|
|
3014
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
3015
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
3016
|
+
# (Ireland), and South America (São Paulo).
|
|
2979
3017
|
#
|
|
2980
3018
|
# This action initiates a multipart upload and returns an upload ID.
|
|
2981
3019
|
# This upload ID is used to associate all of the parts in the specific
|
|
@@ -3211,6 +3249,10 @@ module Aws::S3
|
|
|
3211
3249
|
#
|
|
3212
3250
|
# * [ListMultipartUploads][19]
|
|
3213
3251
|
#
|
|
3252
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
3253
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
3254
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
3255
|
+
#
|
|
3214
3256
|
#
|
|
3215
3257
|
#
|
|
3216
3258
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
|
@@ -4091,6 +4133,10 @@ module Aws::S3
|
|
|
4091
4133
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
4092
4134
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
4093
4135
|
#
|
|
4136
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4137
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4138
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4139
|
+
#
|
|
4094
4140
|
#
|
|
4095
4141
|
#
|
|
4096
4142
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
|
|
@@ -4293,6 +4339,10 @@ module Aws::S3
|
|
|
4293
4339
|
#
|
|
4294
4340
|
# * [DeleteObject][5]
|
|
4295
4341
|
#
|
|
4342
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4343
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4344
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4345
|
+
#
|
|
4296
4346
|
#
|
|
4297
4347
|
#
|
|
4298
4348
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -4383,6 +4433,10 @@ module Aws::S3
|
|
|
4383
4433
|
#
|
|
4384
4434
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
4385
4435
|
#
|
|
4436
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4437
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4438
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4439
|
+
#
|
|
4386
4440
|
#
|
|
4387
4441
|
#
|
|
4388
4442
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -4442,6 +4496,10 @@ module Aws::S3
|
|
|
4442
4496
|
#
|
|
4443
4497
|
# * [RESTOPTIONSobject][3]
|
|
4444
4498
|
#
|
|
4499
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4500
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4501
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4502
|
+
#
|
|
4445
4503
|
#
|
|
4446
4504
|
#
|
|
4447
4505
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
|
@@ -4530,6 +4588,10 @@ module Aws::S3
|
|
|
4530
4588
|
#
|
|
4531
4589
|
# * [GetBucketEncryption][7]
|
|
4532
4590
|
#
|
|
4591
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4592
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4593
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4594
|
+
#
|
|
4533
4595
|
#
|
|
4534
4596
|
#
|
|
4535
4597
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
|
@@ -4623,6 +4685,10 @@ module Aws::S3
|
|
|
4623
4685
|
#
|
|
4624
4686
|
# * [ListBucketIntelligentTieringConfigurations][4]
|
|
4625
4687
|
#
|
|
4688
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4689
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4690
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4691
|
+
#
|
|
4626
4692
|
#
|
|
4627
4693
|
#
|
|
4628
4694
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -4686,6 +4752,10 @@ module Aws::S3
|
|
|
4686
4752
|
#
|
|
4687
4753
|
# * [ListBucketInventoryConfigurations][6]
|
|
4688
4754
|
#
|
|
4755
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4756
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4757
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4758
|
+
#
|
|
4689
4759
|
#
|
|
4690
4760
|
#
|
|
4691
4761
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -4786,6 +4856,10 @@ module Aws::S3
|
|
|
4786
4856
|
#
|
|
4787
4857
|
# * [GetBucketLifecycleConfiguration][7]
|
|
4788
4858
|
#
|
|
4859
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4860
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4861
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4862
|
+
#
|
|
4789
4863
|
#
|
|
4790
4864
|
#
|
|
4791
4865
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
@@ -4871,6 +4945,10 @@ module Aws::S3
|
|
|
4871
4945
|
#
|
|
4872
4946
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
4873
4947
|
#
|
|
4948
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
4949
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
4950
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
4951
|
+
#
|
|
4874
4952
|
#
|
|
4875
4953
|
#
|
|
4876
4954
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -4948,6 +5026,10 @@ module Aws::S3
|
|
|
4948
5026
|
#
|
|
4949
5027
|
# * [GetBucketMetadataTableConfiguration][6]
|
|
4950
5028
|
#
|
|
5029
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5030
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5031
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5032
|
+
#
|
|
4951
5033
|
#
|
|
4952
5034
|
#
|
|
4953
5035
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
|
|
@@ -5012,6 +5094,10 @@ module Aws::S3
|
|
|
5012
5094
|
#
|
|
5013
5095
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
|
5014
5096
|
#
|
|
5097
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5098
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5099
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5100
|
+
#
|
|
5015
5101
|
#
|
|
5016
5102
|
#
|
|
5017
5103
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -5072,6 +5158,10 @@ module Aws::S3
|
|
|
5072
5158
|
#
|
|
5073
5159
|
# * PutBucketOwnershipControls
|
|
5074
5160
|
#
|
|
5161
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5162
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5163
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5164
|
+
#
|
|
5075
5165
|
#
|
|
5076
5166
|
#
|
|
5077
5167
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -5168,6 +5258,10 @@ module Aws::S3
|
|
|
5168
5258
|
#
|
|
5169
5259
|
# * [DeleteObject][6]
|
|
5170
5260
|
#
|
|
5261
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5262
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5263
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5264
|
+
#
|
|
5171
5265
|
#
|
|
5172
5266
|
#
|
|
5173
5267
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -5260,6 +5354,10 @@ module Aws::S3
|
|
|
5260
5354
|
#
|
|
5261
5355
|
# * [GetBucketReplication][5]
|
|
5262
5356
|
#
|
|
5357
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5358
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5359
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5360
|
+
#
|
|
5263
5361
|
#
|
|
5264
5362
|
#
|
|
5265
5363
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -5307,7 +5405,14 @@ module Aws::S3
|
|
|
5307
5405
|
#
|
|
5308
5406
|
# </note>
|
|
5309
5407
|
#
|
|
5310
|
-
# Deletes
|
|
5408
|
+
# Deletes tags from the general purpose bucket if attribute based access
|
|
5409
|
+
# control (ABAC) is not enabled for the bucket. When you [enable ABAC
|
|
5410
|
+
# for a general purpose bucket][1], you can no longer use this operation
|
|
5411
|
+
# for that bucket and must use [UntagResource][2] instead.
|
|
5412
|
+
#
|
|
5413
|
+
# if ABAC is not enabled for the bucket. When you [enable ABAC for a
|
|
5414
|
+
# general purpose bucket][1], you can no longer use this operation for
|
|
5415
|
+
# that bucket and must use [UntagResource][2] instead.
|
|
5311
5416
|
#
|
|
5312
5417
|
# To use this operation, you must have permission to perform the
|
|
5313
5418
|
# `s3:PutBucketTagging` action. By default, the bucket owner has this
|
|
@@ -5315,14 +5420,20 @@ module Aws::S3
|
|
|
5315
5420
|
#
|
|
5316
5421
|
# The following operations are related to `DeleteBucketTagging`:
|
|
5317
5422
|
#
|
|
5318
|
-
# * [GetBucketTagging][
|
|
5423
|
+
# * [GetBucketTagging][3]
|
|
5424
|
+
#
|
|
5425
|
+
# * [PutBucketTagging][4]
|
|
5319
5426
|
#
|
|
5320
|
-
#
|
|
5427
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5428
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5429
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5321
5430
|
#
|
|
5322
5431
|
#
|
|
5323
5432
|
#
|
|
5324
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
5325
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
5433
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
5434
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
5435
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
|
5436
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
5326
5437
|
#
|
|
5327
5438
|
# @option params [required, String] :bucket
|
|
5328
5439
|
# The bucket that has the tag set to be removed.
|
|
@@ -5385,6 +5496,10 @@ module Aws::S3
|
|
|
5385
5496
|
#
|
|
5386
5497
|
# * [PutBucketWebsite][3]
|
|
5387
5498
|
#
|
|
5499
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5500
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5501
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5502
|
+
#
|
|
5388
5503
|
#
|
|
5389
5504
|
#
|
|
5390
5505
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -5507,6 +5622,12 @@ module Aws::S3
|
|
|
5507
5622
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
|
5508
5623
|
# specific version of an object from a versioning-enabled bucket,
|
|
5509
5624
|
# you must have the `s3:DeleteObjectVersion` permission.
|
|
5625
|
+
#
|
|
5626
|
+
# <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
|
|
5627
|
+
# are explicitly denied in your bucket policy, attempts to delete
|
|
5628
|
+
# any unversioned objects result in a `403 Access Denied` error.
|
|
5629
|
+
#
|
|
5630
|
+
# </note>
|
|
5510
5631
|
# * **Directory bucket permissions** - To grant access to this API
|
|
5511
5632
|
# operation on a directory bucket, we recommend that you use the [
|
|
5512
5633
|
# `CreateSession` ][8] API operation for session-based
|
|
@@ -5533,6 +5654,16 @@ module Aws::S3
|
|
|
5533
5654
|
#
|
|
5534
5655
|
# ^
|
|
5535
5656
|
#
|
|
5657
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5658
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5659
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5660
|
+
#
|
|
5661
|
+
# <note markdown="1"> The `If-Match` header is supported for both general purpose and
|
|
5662
|
+
# directory buckets. `IfMatchLastModifiedTime` and `IfMatchSize` is only
|
|
5663
|
+
# supported for directory buckets.
|
|
5664
|
+
#
|
|
5665
|
+
# </note>
|
|
5666
|
+
#
|
|
5536
5667
|
#
|
|
5537
5668
|
#
|
|
5538
5669
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
|
|
@@ -5643,17 +5774,15 @@ module Aws::S3
|
|
|
5643
5774
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
5644
5775
|
#
|
|
5645
5776
|
# @option params [String] :if_match
|
|
5646
|
-
#
|
|
5647
|
-
#
|
|
5648
|
-
#
|
|
5649
|
-
#
|
|
5650
|
-
# response`.
|
|
5651
|
-
#
|
|
5652
|
-
# For more information about conditional requests, see [RFC 7232][1].
|
|
5777
|
+
# Deletes the object if the ETag (entity tag) value provided during the
|
|
5778
|
+
# delete operation matches the ETag of the object in S3. If the ETag
|
|
5779
|
+
# values do not match, the operation returns a `412 Precondition Failed`
|
|
5780
|
+
# error.
|
|
5653
5781
|
#
|
|
5654
|
-
#
|
|
5782
|
+
# Expects the ETag value as a string. `If-Match` does accept a string
|
|
5783
|
+
# value of an '*' (asterisk) character to denote a match of any ETag.
|
|
5655
5784
|
#
|
|
5656
|
-
#
|
|
5785
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
5657
5786
|
#
|
|
5658
5787
|
#
|
|
5659
5788
|
#
|
|
@@ -5764,6 +5893,10 @@ module Aws::S3
|
|
|
5764
5893
|
#
|
|
5765
5894
|
# * [GetObjectTagging][3]
|
|
5766
5895
|
#
|
|
5896
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
5897
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
5898
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
5899
|
+
#
|
|
5767
5900
|
#
|
|
5768
5901
|
#
|
|
5769
5902
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
|
@@ -5934,6 +6067,12 @@ module Aws::S3
|
|
|
5934
6067
|
# * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
|
|
5935
6068
|
# specific version of an object from a versioning-enabled bucket,
|
|
5936
6069
|
# you must specify the `s3:DeleteObjectVersion` permission.
|
|
6070
|
+
#
|
|
6071
|
+
# <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
|
|
6072
|
+
# are explicitly denied in your bucket policy, attempts to delete
|
|
6073
|
+
# any unversioned objects result in a `403 Access Denied` error.
|
|
6074
|
+
#
|
|
6075
|
+
# </note>
|
|
5937
6076
|
# * **Directory bucket permissions** - To grant access to this API
|
|
5938
6077
|
# operation on a directory bucket, we recommend that you use the [
|
|
5939
6078
|
# `CreateSession` ][4] API operation for session-based
|
|
@@ -5978,6 +6117,10 @@ module Aws::S3
|
|
|
5978
6117
|
#
|
|
5979
6118
|
# * [AbortMultipartUpload][9]
|
|
5980
6119
|
#
|
|
6120
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6121
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6122
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6123
|
+
#
|
|
5981
6124
|
#
|
|
5982
6125
|
#
|
|
5983
6126
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -6274,6 +6417,10 @@ module Aws::S3
|
|
|
6274
6417
|
#
|
|
6275
6418
|
# * [GetBucketPolicyStatus][6]
|
|
6276
6419
|
#
|
|
6420
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6421
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6422
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6423
|
+
#
|
|
6277
6424
|
#
|
|
6278
6425
|
#
|
|
6279
6426
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6310,6 +6457,49 @@ module Aws::S3
|
|
|
6310
6457
|
req.send_request(options)
|
|
6311
6458
|
end
|
|
6312
6459
|
|
|
6460
|
+
# Returns the attribute-based access control (ABAC) property of the
|
|
6461
|
+
# general purpose bucket. If the bucket ABAC is enabled, you can use
|
|
6462
|
+
# tags for bucket access control. For more information, see [Enabling
|
|
6463
|
+
# ABAC in general purpose buckets][1]. Whether ABAC is enabled or
|
|
6464
|
+
# disabled, you can use tags for cost tracking. For more information,
|
|
6465
|
+
# see [Using tags with S3 general purpose buckets][2].
|
|
6466
|
+
#
|
|
6467
|
+
#
|
|
6468
|
+
#
|
|
6469
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
6470
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
|
|
6471
|
+
#
|
|
6472
|
+
# @option params [required, String] :bucket
|
|
6473
|
+
# The name of the general purpose bucket.
|
|
6474
|
+
#
|
|
6475
|
+
# @option params [String] :expected_bucket_owner
|
|
6476
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
6477
|
+
# owner.
|
|
6478
|
+
#
|
|
6479
|
+
# @return [Types::GetBucketAbacOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
6480
|
+
#
|
|
6481
|
+
# * {Types::GetBucketAbacOutput#abac_status #abac_status} => Types::AbacStatus
|
|
6482
|
+
#
|
|
6483
|
+
# @example Request syntax with placeholder values
|
|
6484
|
+
#
|
|
6485
|
+
# resp = client.get_bucket_abac({
|
|
6486
|
+
# bucket: "BucketName", # required
|
|
6487
|
+
# expected_bucket_owner: "AccountId",
|
|
6488
|
+
# })
|
|
6489
|
+
#
|
|
6490
|
+
# @example Response structure
|
|
6491
|
+
#
|
|
6492
|
+
# resp.abac_status.status #=> String, one of "Enabled", "Disabled"
|
|
6493
|
+
#
|
|
6494
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAbac AWS API Documentation
|
|
6495
|
+
#
|
|
6496
|
+
# @overload get_bucket_abac(params = {})
|
|
6497
|
+
# @param [Hash] params ({})
|
|
6498
|
+
def get_bucket_abac(params = {}, options = {})
|
|
6499
|
+
req = build_request(:get_bucket_abac, params)
|
|
6500
|
+
req.send_request(options)
|
|
6501
|
+
end
|
|
6502
|
+
|
|
6313
6503
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
6314
6504
|
#
|
|
6315
6505
|
# </note>
|
|
@@ -6346,6 +6536,10 @@ module Aws::S3
|
|
|
6346
6536
|
#
|
|
6347
6537
|
# ^
|
|
6348
6538
|
#
|
|
6539
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6540
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6541
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6542
|
+
#
|
|
6349
6543
|
#
|
|
6350
6544
|
#
|
|
6351
6545
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6406,11 +6600,11 @@ module Aws::S3
|
|
|
6406
6600
|
req.send_request(options)
|
|
6407
6601
|
end
|
|
6408
6602
|
|
|
6409
|
-
# End of support notice: Beginning
|
|
6410
|
-
# returning `DisplayName`. Update your applications to use
|
|
6411
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
6412
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
6413
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
6603
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
6604
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
6605
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
6606
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
6607
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
6414
6608
|
#
|
|
6415
6609
|
# This change affects the following Amazon Web Services Regions: US
|
|
6416
6610
|
# East
|
|
@@ -6448,6 +6642,10 @@ module Aws::S3
|
|
|
6448
6642
|
#
|
|
6449
6643
|
# </note>
|
|
6450
6644
|
#
|
|
6645
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6646
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6647
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6648
|
+
#
|
|
6451
6649
|
# The following operations are related to `GetBucketAcl`:
|
|
6452
6650
|
#
|
|
6453
6651
|
# * [ListObjects][3]
|
|
@@ -6543,6 +6741,10 @@ module Aws::S3
|
|
|
6543
6741
|
#
|
|
6544
6742
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
6545
6743
|
#
|
|
6744
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6745
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6746
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6747
|
+
#
|
|
6546
6748
|
#
|
|
6547
6749
|
#
|
|
6548
6750
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -6631,6 +6833,10 @@ module Aws::S3
|
|
|
6631
6833
|
#
|
|
6632
6834
|
# * [DeleteBucketCors][4]
|
|
6633
6835
|
#
|
|
6836
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6837
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6838
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6839
|
+
#
|
|
6634
6840
|
#
|
|
6635
6841
|
#
|
|
6636
6842
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
@@ -6723,17 +6929,19 @@ module Aws::S3
|
|
|
6723
6929
|
|
|
6724
6930
|
# Returns the default encryption configuration for an Amazon S3 bucket.
|
|
6725
6931
|
# By default, all buckets have a default encryption configuration that
|
|
6726
|
-
# uses server-side encryption with Amazon S3 managed keys (SSE-S3).
|
|
6932
|
+
# uses server-side encryption with Amazon S3 managed keys (SSE-S3). This
|
|
6933
|
+
# operation also returns the [BucketKeyEnabled][1] and
|
|
6934
|
+
# [BlockedEncryptionTypes][2] statuses.
|
|
6727
6935
|
#
|
|
6728
6936
|
# <note markdown="1"> * **General purpose buckets** - For information about the bucket
|
|
6729
6937
|
# default encryption feature, see [Amazon S3 Bucket Default
|
|
6730
|
-
# Encryption][
|
|
6938
|
+
# Encryption][3] in the *Amazon S3 User Guide*.
|
|
6731
6939
|
#
|
|
6732
6940
|
# * **Directory buckets** - For directory buckets, there are only two
|
|
6733
6941
|
# supported options for server-side encryption: SSE-S3 and SSE-KMS.
|
|
6734
6942
|
# For information about the default encryption configuration in
|
|
6735
6943
|
# directory buckets, see [Setting default server-side encryption
|
|
6736
|
-
# behavior for directory buckets][
|
|
6944
|
+
# behavior for directory buckets][4].
|
|
6737
6945
|
#
|
|
6738
6946
|
# </note>
|
|
6739
6947
|
#
|
|
@@ -6743,8 +6951,8 @@ module Aws::S3
|
|
|
6743
6951
|
# policy. The bucket owner has this permission by default. The
|
|
6744
6952
|
# bucket owner can grant this permission to others. For more
|
|
6745
6953
|
# information about permissions, see [Permissions Related to Bucket
|
|
6746
|
-
# Operations][
|
|
6747
|
-
# Resources][
|
|
6954
|
+
# Operations][5] and [Managing Access Permissions to Your Amazon S3
|
|
6955
|
+
# Resources][6].
|
|
6748
6956
|
#
|
|
6749
6957
|
# * **Directory bucket permissions** - To grant access to this API
|
|
6750
6958
|
# operation, you must have the
|
|
@@ -6754,7 +6962,7 @@ module Aws::S3
|
|
|
6754
6962
|
# only be performed by the Amazon Web Services account that owns the
|
|
6755
6963
|
# resource. For more information about directory bucket policies and
|
|
6756
6964
|
# permissions, see [Amazon Web Services Identity and Access
|
|
6757
|
-
# Management (IAM) for S3 Express One Zone][
|
|
6965
|
+
# Management (IAM) for S3 Express One Zone][7] in the *Amazon S3
|
|
6758
6966
|
# User Guide*.
|
|
6759
6967
|
#
|
|
6760
6968
|
# HTTP Host header syntax
|
|
@@ -6764,19 +6972,25 @@ module Aws::S3
|
|
|
6764
6972
|
#
|
|
6765
6973
|
# The following operations are related to `GetBucketEncryption`:
|
|
6766
6974
|
#
|
|
6767
|
-
# * [PutBucketEncryption][
|
|
6975
|
+
# * [PutBucketEncryption][8]
|
|
6768
6976
|
#
|
|
6769
|
-
# * [DeleteBucketEncryption][
|
|
6977
|
+
# * [DeleteBucketEncryption][9]
|
|
6770
6978
|
#
|
|
6979
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
6980
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
6981
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
6771
6982
|
#
|
|
6772
6983
|
#
|
|
6773
|
-
#
|
|
6774
|
-
# [
|
|
6775
|
-
# [
|
|
6776
|
-
# [
|
|
6777
|
-
# [
|
|
6778
|
-
# [
|
|
6779
|
-
# [
|
|
6984
|
+
#
|
|
6985
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_BucketKeyEnabled.html
|
|
6986
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_BlockedEncryptionTypes.html
|
|
6987
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html
|
|
6988
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html
|
|
6989
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
6990
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
6991
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
|
6992
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
|
6993
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
6780
6994
|
#
|
|
6781
6995
|
# @option params [required, String] :bucket
|
|
6782
6996
|
# The name of the bucket from which the server-side encryption
|
|
@@ -6825,6 +7039,8 @@ module Aws::S3
|
|
|
6825
7039
|
# 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
7040
|
# resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.kms_master_key_id #=> String
|
|
6827
7041
|
# resp.server_side_encryption_configuration.rules[0].bucket_key_enabled #=> Boolean
|
|
7042
|
+
# resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type #=> Array
|
|
7043
|
+
# resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type[0] #=> String, one of "NONE", "SSE-C"
|
|
6828
7044
|
#
|
|
6829
7045
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption AWS API Documentation
|
|
6830
7046
|
#
|
|
@@ -6870,6 +7086,10 @@ module Aws::S3
|
|
|
6870
7086
|
#
|
|
6871
7087
|
# * [ListBucketIntelligentTieringConfigurations][4]
|
|
6872
7088
|
#
|
|
7089
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7090
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7091
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7092
|
+
#
|
|
6873
7093
|
#
|
|
6874
7094
|
#
|
|
6875
7095
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -6951,6 +7171,10 @@ module Aws::S3
|
|
|
6951
7171
|
#
|
|
6952
7172
|
# * [PutBucketInventoryConfiguration][6]
|
|
6953
7173
|
#
|
|
7174
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7175
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7176
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7177
|
+
#
|
|
6954
7178
|
#
|
|
6955
7179
|
#
|
|
6956
7180
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -7047,6 +7271,10 @@ module Aws::S3
|
|
|
7047
7271
|
#
|
|
7048
7272
|
# * [DeleteBucketLifecycle][6]
|
|
7049
7273
|
#
|
|
7274
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7275
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7276
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7277
|
+
#
|
|
7050
7278
|
#
|
|
7051
7279
|
#
|
|
7052
7280
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
|
@@ -7208,6 +7436,10 @@ module Aws::S3
|
|
|
7208
7436
|
#
|
|
7209
7437
|
# * [DeleteBucketLifecycle][8]
|
|
7210
7438
|
#
|
|
7439
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7440
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7441
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7442
|
+
#
|
|
7211
7443
|
#
|
|
7212
7444
|
#
|
|
7213
7445
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
|
|
@@ -7312,13 +7544,25 @@ module Aws::S3
|
|
|
7312
7544
|
req.send_request(options)
|
|
7313
7545
|
end
|
|
7314
7546
|
|
|
7315
|
-
#
|
|
7316
|
-
#
|
|
7317
|
-
#
|
|
7547
|
+
# Using the `GetBucketLocation` operation is no longer a best practice.
|
|
7548
|
+
# To return the Region that a bucket resides in, we recommend that you
|
|
7549
|
+
# use the [HeadBucket][1] operation instead. For backward compatibility,
|
|
7550
|
+
# Amazon S3 continues to support the `GetBucketLocation` operation.
|
|
7318
7551
|
#
|
|
7319
7552
|
# Returns the Region the bucket resides in. You set the bucket's Region
|
|
7320
7553
|
# using the `LocationConstraint` request parameter in a `CreateBucket`
|
|
7321
|
-
# request. For more information, see [CreateBucket][
|
|
7554
|
+
# request. For more information, see [CreateBucket][2].
|
|
7555
|
+
#
|
|
7556
|
+
# <note markdown="1"> In a bucket's home Region, calls to the `GetBucketLocation` operation
|
|
7557
|
+
# are governed by the bucket's policy. In other Regions, the bucket
|
|
7558
|
+
# policy doesn't apply, which means that cross-account access won't be
|
|
7559
|
+
# authorized. However, calls to the `HeadBucket` operation always return
|
|
7560
|
+
# the bucket’s location through an HTTP response header, whether access
|
|
7561
|
+
# to the bucket is authorized or not. Therefore, we recommend using the
|
|
7562
|
+
# `HeadBucket` operation for bucket Region discovery and to avoid using
|
|
7563
|
+
# the `GetBucketLocation` operation.
|
|
7564
|
+
#
|
|
7565
|
+
# </note>
|
|
7322
7566
|
#
|
|
7323
7567
|
# When you use this API operation with an access point, provide the
|
|
7324
7568
|
# alias of the access point in place of the bucket name.
|
|
@@ -7328,11 +7572,9 @@ module Aws::S3
|
|
|
7328
7572
|
# bucket name. If the Object Lambda access point alias in a request is
|
|
7329
7573
|
# not valid, the error code `InvalidAccessPointAliasError` is returned.
|
|
7330
7574
|
# For more information about `InvalidAccessPointAliasError`, see [List
|
|
7331
|
-
# of Error Codes][
|
|
7575
|
+
# of Error Codes][3].
|
|
7332
7576
|
#
|
|
7333
|
-
# <note markdown="1">
|
|
7334
|
-
# bucket resides in. For backward compatibility, Amazon S3 continues to
|
|
7335
|
-
# support GetBucketLocation.
|
|
7577
|
+
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
7336
7578
|
#
|
|
7337
7579
|
# </note>
|
|
7338
7580
|
#
|
|
@@ -7340,13 +7582,17 @@ module Aws::S3
|
|
|
7340
7582
|
#
|
|
7341
7583
|
# * [GetObject][4]
|
|
7342
7584
|
#
|
|
7343
|
-
# * [CreateBucket][
|
|
7585
|
+
# * [CreateBucket][2]
|
|
7344
7586
|
#
|
|
7587
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7588
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7589
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7345
7590
|
#
|
|
7346
7591
|
#
|
|
7347
|
-
#
|
|
7348
|
-
# [
|
|
7349
|
-
# [
|
|
7592
|
+
#
|
|
7593
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
|
|
7594
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
|
7595
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
7350
7596
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
7351
7597
|
#
|
|
7352
7598
|
# @option params [required, String] :bucket
|
|
@@ -7409,11 +7655,11 @@ module Aws::S3
|
|
|
7409
7655
|
req.send_request(options)
|
|
7410
7656
|
end
|
|
7411
7657
|
|
|
7412
|
-
# End of support notice: Beginning
|
|
7413
|
-
# returning `DisplayName`. Update your applications to use
|
|
7414
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
7415
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
7416
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
7658
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
7659
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
7660
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
7661
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
7662
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
7417
7663
|
#
|
|
7418
7664
|
# This change affects the following Amazon Web Services Regions: US
|
|
7419
7665
|
# East
|
|
@@ -7435,6 +7681,10 @@ module Aws::S3
|
|
|
7435
7681
|
#
|
|
7436
7682
|
# * [PutBucketLogging][2]
|
|
7437
7683
|
#
|
|
7684
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7685
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7686
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7687
|
+
#
|
|
7438
7688
|
#
|
|
7439
7689
|
#
|
|
7440
7690
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
|
@@ -7516,6 +7766,10 @@ module Aws::S3
|
|
|
7516
7766
|
#
|
|
7517
7767
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
7518
7768
|
#
|
|
7769
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7770
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7771
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7772
|
+
#
|
|
7519
7773
|
#
|
|
7520
7774
|
#
|
|
7521
7775
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -7614,6 +7868,10 @@ module Aws::S3
|
|
|
7614
7868
|
#
|
|
7615
7869
|
# * [DeleteBucketMetadataTableConfiguration][6]
|
|
7616
7870
|
#
|
|
7871
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7872
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7873
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7874
|
+
#
|
|
7617
7875
|
#
|
|
7618
7876
|
#
|
|
7619
7877
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
|
|
@@ -7690,6 +7948,10 @@ module Aws::S3
|
|
|
7690
7948
|
#
|
|
7691
7949
|
# * [Monitoring Metrics with Amazon CloudWatch][3]
|
|
7692
7950
|
#
|
|
7951
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
7952
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
7953
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
7954
|
+
#
|
|
7693
7955
|
#
|
|
7694
7956
|
#
|
|
7695
7957
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -7913,6 +8175,10 @@ module Aws::S3
|
|
|
7913
8175
|
#
|
|
7914
8176
|
# ^
|
|
7915
8177
|
#
|
|
8178
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8179
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8180
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8181
|
+
#
|
|
7916
8182
|
#
|
|
7917
8183
|
#
|
|
7918
8184
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
|
@@ -8026,6 +8292,10 @@ module Aws::S3
|
|
|
8026
8292
|
#
|
|
8027
8293
|
# * DeleteBucketOwnershipControls
|
|
8028
8294
|
#
|
|
8295
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8296
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8297
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8298
|
+
#
|
|
8029
8299
|
#
|
|
8030
8300
|
#
|
|
8031
8301
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html
|
|
@@ -8137,6 +8407,10 @@ module Aws::S3
|
|
|
8137
8407
|
#
|
|
8138
8408
|
# ^
|
|
8139
8409
|
#
|
|
8410
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8411
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8412
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8413
|
+
#
|
|
8140
8414
|
#
|
|
8141
8415
|
#
|
|
8142
8416
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -8207,7 +8481,7 @@ module Aws::S3
|
|
|
8207
8481
|
#
|
|
8208
8482
|
# resp.to_h outputs the following:
|
|
8209
8483
|
# {
|
|
8210
|
-
# policy: "{\"Version\":\"2008-10-17\"
|
|
8484
|
+
# 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
8485
|
# }
|
|
8212
8486
|
#
|
|
8213
8487
|
# @example Request syntax with placeholder values
|
|
@@ -8253,6 +8527,10 @@ module Aws::S3
|
|
|
8253
8527
|
#
|
|
8254
8528
|
# * [DeletePublicAccessBlock][6]
|
|
8255
8529
|
#
|
|
8530
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8531
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8532
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8533
|
+
#
|
|
8256
8534
|
#
|
|
8257
8535
|
#
|
|
8258
8536
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -8327,6 +8605,10 @@ module Aws::S3
|
|
|
8327
8605
|
#
|
|
8328
8606
|
# * [DeleteBucketReplication][5]
|
|
8329
8607
|
#
|
|
8608
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8609
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8610
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8611
|
+
#
|
|
8330
8612
|
#
|
|
8331
8613
|
#
|
|
8332
8614
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
@@ -8432,6 +8714,10 @@ module Aws::S3
|
|
|
8432
8714
|
#
|
|
8433
8715
|
# ^
|
|
8434
8716
|
#
|
|
8717
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8718
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8719
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8720
|
+
#
|
|
8435
8721
|
#
|
|
8436
8722
|
#
|
|
8437
8723
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
|
@@ -8488,7 +8774,11 @@ module Aws::S3
|
|
|
8488
8774
|
#
|
|
8489
8775
|
# </note>
|
|
8490
8776
|
#
|
|
8491
|
-
# Returns the tag set associated with the bucket.
|
|
8777
|
+
# Returns the tag set associated with the general purpose bucket.
|
|
8778
|
+
#
|
|
8779
|
+
# if ABAC is not enabled for the bucket. When you [enable ABAC for a
|
|
8780
|
+
# general purpose bucket][1], you can no longer use this operation for
|
|
8781
|
+
# that bucket and must use [ListTagsForResource][2] instead.
|
|
8492
8782
|
#
|
|
8493
8783
|
# To use this operation, you must have permission to perform the
|
|
8494
8784
|
# `s3:GetBucketTagging` action. By default, the bucket owner has this
|
|
@@ -8504,14 +8794,20 @@ module Aws::S3
|
|
|
8504
8794
|
#
|
|
8505
8795
|
# The following operations are related to `GetBucketTagging`:
|
|
8506
8796
|
#
|
|
8507
|
-
# * [PutBucketTagging][
|
|
8797
|
+
# * [PutBucketTagging][3]
|
|
8798
|
+
#
|
|
8799
|
+
# * [DeleteBucketTagging][4]
|
|
8508
8800
|
#
|
|
8509
|
-
#
|
|
8801
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8802
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8803
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8510
8804
|
#
|
|
8511
8805
|
#
|
|
8512
8806
|
#
|
|
8513
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
8514
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
8807
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
8808
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html
|
|
8809
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
8810
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
8515
8811
|
#
|
|
8516
8812
|
# @option params [required, String] :bucket
|
|
8517
8813
|
# The name of the bucket for which to get the tagging information.
|
|
@@ -8592,6 +8888,10 @@ module Aws::S3
|
|
|
8592
8888
|
#
|
|
8593
8889
|
# * [DeleteObject][3]
|
|
8594
8890
|
#
|
|
8891
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8892
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8893
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8894
|
+
#
|
|
8595
8895
|
#
|
|
8596
8896
|
#
|
|
8597
8897
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
@@ -8668,6 +8968,10 @@ module Aws::S3
|
|
|
8668
8968
|
#
|
|
8669
8969
|
# * [PutBucketWebsite][3]
|
|
8670
8970
|
#
|
|
8971
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
8972
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
8973
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
8974
|
+
#
|
|
8671
8975
|
#
|
|
8672
8976
|
#
|
|
8673
8977
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -8902,6 +9206,10 @@ module Aws::S3
|
|
|
8902
9206
|
#
|
|
8903
9207
|
# * [GetObjectAcl][10]
|
|
8904
9208
|
#
|
|
9209
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
9210
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
9211
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
9212
|
+
#
|
|
8905
9213
|
#
|
|
8906
9214
|
#
|
|
8907
9215
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
|
|
@@ -9407,6 +9715,19 @@ module Aws::S3
|
|
|
9407
9715
|
req.send_request(options, &block)
|
|
9408
9716
|
end
|
|
9409
9717
|
|
|
9718
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
9719
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
9720
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
9721
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
9722
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
9723
|
+
#
|
|
9724
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
9725
|
+
# East
|
|
9726
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
9727
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
9728
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
9729
|
+
# America (São Paulo) Region.
|
|
9730
|
+
#
|
|
9410
9731
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
9411
9732
|
#
|
|
9412
9733
|
# </note>
|
|
@@ -9441,6 +9762,10 @@ module Aws::S3
|
|
|
9441
9762
|
#
|
|
9442
9763
|
# * [PutObject][6]
|
|
9443
9764
|
#
|
|
9765
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
9766
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
9767
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
9768
|
+
#
|
|
9444
9769
|
#
|
|
9445
9770
|
#
|
|
9446
9771
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#acl-access-policy-permission-mapping
|
|
@@ -9764,6 +10089,10 @@ module Aws::S3
|
|
|
9764
10089
|
#
|
|
9765
10090
|
# * [ListParts][16]
|
|
9766
10091
|
#
|
|
10092
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10093
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10094
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10095
|
+
#
|
|
9767
10096
|
#
|
|
9768
10097
|
#
|
|
9769
10098
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -9995,6 +10324,10 @@ module Aws::S3
|
|
|
9995
10324
|
#
|
|
9996
10325
|
# ^
|
|
9997
10326
|
#
|
|
10327
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10328
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10329
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10330
|
+
#
|
|
9998
10331
|
#
|
|
9999
10332
|
#
|
|
10000
10333
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10093,6 +10426,10 @@ module Aws::S3
|
|
|
10093
10426
|
#
|
|
10094
10427
|
# ^
|
|
10095
10428
|
#
|
|
10429
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10430
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10431
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10432
|
+
#
|
|
10096
10433
|
#
|
|
10097
10434
|
#
|
|
10098
10435
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10165,6 +10502,10 @@ module Aws::S3
|
|
|
10165
10502
|
#
|
|
10166
10503
|
# ^
|
|
10167
10504
|
#
|
|
10505
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10506
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10507
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10508
|
+
#
|
|
10168
10509
|
#
|
|
10169
10510
|
#
|
|
10170
10511
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -10277,6 +10618,10 @@ module Aws::S3
|
|
|
10277
10618
|
#
|
|
10278
10619
|
# * [PutObjectTagging][4]
|
|
10279
10620
|
#
|
|
10621
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10622
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10623
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10624
|
+
#
|
|
10280
10625
|
#
|
|
10281
10626
|
#
|
|
10282
10627
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
|
@@ -10443,6 +10788,10 @@ module Aws::S3
|
|
|
10443
10788
|
#
|
|
10444
10789
|
# ^
|
|
10445
10790
|
#
|
|
10791
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10792
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10793
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10794
|
+
#
|
|
10446
10795
|
#
|
|
10447
10796
|
#
|
|
10448
10797
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
|
@@ -10551,6 +10900,10 @@ module Aws::S3
|
|
|
10551
10900
|
#
|
|
10552
10901
|
# * [DeletePublicAccessBlock][6]
|
|
10553
10902
|
#
|
|
10903
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
10904
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
10905
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
10906
|
+
#
|
|
10554
10907
|
#
|
|
10555
10908
|
#
|
|
10556
10909
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -10597,13 +10950,19 @@ module Aws::S3
|
|
|
10597
10950
|
end
|
|
10598
10951
|
|
|
10599
10952
|
# 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
|
-
#
|
|
10953
|
+
# have permission to access it. The action returns a `200 OK` HTTP
|
|
10954
|
+
# status code if the bucket exists and you have permission to access it.
|
|
10955
|
+
# You can make a `HeadBucket` call on any bucket name to any Region in
|
|
10956
|
+
# the partition, and regardless of the permissions on the bucket, you
|
|
10957
|
+
# will receive a response header with the correct bucket location so
|
|
10958
|
+
# that you can then make a proper, signed request to the appropriate
|
|
10959
|
+
# Regional endpoint.
|
|
10960
|
+
#
|
|
10961
|
+
# <note markdown="1"> If the bucket doesn't exist or you don't have permission to access
|
|
10604
10962
|
# it, the `HEAD` request returns a generic `400 Bad Request`, `403
|
|
10605
|
-
# Forbidden
|
|
10606
|
-
# you
|
|
10963
|
+
# Forbidden`, or `404 Not Found` HTTP status code. A message body isn't
|
|
10964
|
+
# included, so you can't determine the exception beyond these HTTP
|
|
10965
|
+
# response codes.
|
|
10607
10966
|
#
|
|
10608
10967
|
# </note>
|
|
10609
10968
|
#
|
|
@@ -10666,6 +11025,10 @@ module Aws::S3
|
|
|
10666
11025
|
#
|
|
10667
11026
|
# </note>
|
|
10668
11027
|
#
|
|
11028
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11029
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11030
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11031
|
+
#
|
|
10669
11032
|
#
|
|
10670
11033
|
#
|
|
10671
11034
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
|
@@ -10926,6 +11289,10 @@ module Aws::S3
|
|
|
10926
11289
|
#
|
|
10927
11290
|
# * [GetObjectAttributes][9]
|
|
10928
11291
|
#
|
|
11292
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11293
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11294
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11295
|
+
#
|
|
10929
11296
|
#
|
|
10930
11297
|
#
|
|
10931
11298
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
|
|
@@ -11351,6 +11718,10 @@ module Aws::S3
|
|
|
11351
11718
|
#
|
|
11352
11719
|
# * [PutBucketAnalyticsConfiguration][6]
|
|
11353
11720
|
#
|
|
11721
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11722
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11723
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11724
|
+
#
|
|
11354
11725
|
#
|
|
11355
11726
|
#
|
|
11356
11727
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11452,6 +11823,10 @@ module Aws::S3
|
|
|
11452
11823
|
#
|
|
11453
11824
|
# * [GetBucketIntelligentTieringConfiguration][4]
|
|
11454
11825
|
#
|
|
11826
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11827
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11828
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11829
|
+
#
|
|
11455
11830
|
#
|
|
11456
11831
|
#
|
|
11457
11832
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -11520,7 +11895,7 @@ module Aws::S3
|
|
|
11520
11895
|
# </note>
|
|
11521
11896
|
#
|
|
11522
11897
|
# Returns a list of S3 Inventory configurations for the bucket. You can
|
|
11523
|
-
# have up to 1,000
|
|
11898
|
+
# have up to 1,000 inventory configurations per bucket.
|
|
11524
11899
|
#
|
|
11525
11900
|
# This action supports list pagination and does not return more than 100
|
|
11526
11901
|
# configurations at a time. Always check the `IsTruncated` element in
|
|
@@ -11550,6 +11925,10 @@ module Aws::S3
|
|
|
11550
11925
|
#
|
|
11551
11926
|
# * [PutBucketInventoryConfiguration][6]
|
|
11552
11927
|
#
|
|
11928
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
11929
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
11930
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
11931
|
+
#
|
|
11553
11932
|
#
|
|
11554
11933
|
#
|
|
11555
11934
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11654,6 +12033,10 @@ module Aws::S3
|
|
|
11654
12033
|
#
|
|
11655
12034
|
# * [DeleteBucketMetricsConfiguration][6]
|
|
11656
12035
|
#
|
|
12036
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12037
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12038
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12039
|
+
#
|
|
11657
12040
|
#
|
|
11658
12041
|
#
|
|
11659
12042
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -11719,11 +12102,11 @@ module Aws::S3
|
|
|
11719
12102
|
req.send_request(options)
|
|
11720
12103
|
end
|
|
11721
12104
|
|
|
11722
|
-
# End of support notice: Beginning
|
|
11723
|
-
# returning `DisplayName`. Update your applications to use
|
|
11724
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
11725
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
11726
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
12105
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
12106
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
12107
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
12108
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
12109
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
11727
12110
|
#
|
|
11728
12111
|
# This change affects the following Amazon Web Services Regions: US
|
|
11729
12112
|
# East
|
|
@@ -11752,6 +12135,10 @@ module Aws::S3
|
|
|
11752
12135
|
# rejected for Amazon Web Services accounts with a general purpose
|
|
11753
12136
|
# bucket quota greater than 10,000.
|
|
11754
12137
|
#
|
|
12138
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12139
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12140
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12141
|
+
#
|
|
11755
12142
|
#
|
|
11756
12143
|
#
|
|
11757
12144
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
|
|
@@ -11910,6 +12297,10 @@ module Aws::S3
|
|
|
11910
12297
|
#
|
|
11911
12298
|
# </note>
|
|
11912
12299
|
#
|
|
12300
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12301
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12302
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12303
|
+
#
|
|
11913
12304
|
#
|
|
11914
12305
|
#
|
|
11915
12306
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
|
@@ -11960,11 +12351,11 @@ module Aws::S3
|
|
|
11960
12351
|
req.send_request(options)
|
|
11961
12352
|
end
|
|
11962
12353
|
|
|
11963
|
-
# End of support notice: Beginning
|
|
11964
|
-
# returning `DisplayName`. Update your applications to use
|
|
11965
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
11966
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
11967
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
12354
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
12355
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
12356
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
12357
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
12358
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
11968
12359
|
#
|
|
11969
12360
|
# This change affects the following Amazon Web Services Regions: US
|
|
11970
12361
|
# East
|
|
@@ -12081,6 +12472,10 @@ module Aws::S3
|
|
|
12081
12472
|
#
|
|
12082
12473
|
# * [AbortMultipartUpload][10]
|
|
12083
12474
|
#
|
|
12475
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12476
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12477
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12478
|
+
#
|
|
12084
12479
|
#
|
|
12085
12480
|
#
|
|
12086
12481
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
|
@@ -12422,11 +12817,11 @@ module Aws::S3
|
|
|
12422
12817
|
req.send_request(options)
|
|
12423
12818
|
end
|
|
12424
12819
|
|
|
12425
|
-
# End of support notice: Beginning
|
|
12426
|
-
# returning `DisplayName`. Update your applications to use
|
|
12427
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
12428
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
12429
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
12820
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
12821
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
12822
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
12823
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
12824
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
12430
12825
|
#
|
|
12431
12826
|
# This change affects the following Amazon Web Services Regions: US
|
|
12432
12827
|
# East
|
|
@@ -12464,6 +12859,10 @@ module Aws::S3
|
|
|
12464
12859
|
#
|
|
12465
12860
|
# * [DeleteObject][4]
|
|
12466
12861
|
#
|
|
12862
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
12863
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
12864
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
12865
|
+
#
|
|
12467
12866
|
#
|
|
12468
12867
|
#
|
|
12469
12868
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
|
@@ -12678,11 +13077,11 @@ module Aws::S3
|
|
|
12678
13077
|
req.send_request(options)
|
|
12679
13078
|
end
|
|
12680
13079
|
|
|
12681
|
-
# End of support notice: Beginning
|
|
12682
|
-
# returning `DisplayName`. Update your applications to use
|
|
12683
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
12684
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
12685
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
13080
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
13081
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
13082
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
13083
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13084
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
12686
13085
|
#
|
|
12687
13086
|
# This change affects the following Amazon Web Services Regions: US
|
|
12688
13087
|
# East
|
|
@@ -12717,6 +13116,10 @@ module Aws::S3
|
|
|
12717
13116
|
#
|
|
12718
13117
|
# * [ListBuckets][5]
|
|
12719
13118
|
#
|
|
13119
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13120
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13121
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13122
|
+
#
|
|
12720
13123
|
#
|
|
12721
13124
|
#
|
|
12722
13125
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
|
|
@@ -12930,6 +13333,19 @@ module Aws::S3
|
|
|
12930
13333
|
req.send_request(options)
|
|
12931
13334
|
end
|
|
12932
13335
|
|
|
13336
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
13337
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
13338
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
13339
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13340
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
13341
|
+
#
|
|
13342
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
13343
|
+
# East
|
|
13344
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
13345
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
13346
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
13347
|
+
# America (São Paulo) Region.
|
|
13348
|
+
#
|
|
12933
13349
|
# Returns some or all (up to 1,000) of the objects in a bucket with each
|
|
12934
13350
|
# request. You can use the request parameters as selection criteria to
|
|
12935
13351
|
# return a subset of the objects in a bucket. A `200 OK` response can
|
|
@@ -13010,6 +13426,10 @@ module Aws::S3
|
|
|
13010
13426
|
#
|
|
13011
13427
|
# * [CreateBucket][11]
|
|
13012
13428
|
#
|
|
13429
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13430
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13431
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13432
|
+
#
|
|
13013
13433
|
#
|
|
13014
13434
|
#
|
|
13015
13435
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
|
|
@@ -13280,11 +13700,11 @@ module Aws::S3
|
|
|
13280
13700
|
req.send_request(options)
|
|
13281
13701
|
end
|
|
13282
13702
|
|
|
13283
|
-
# End of support notice: Beginning
|
|
13284
|
-
# returning `DisplayName`. Update your applications to use
|
|
13285
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
13286
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13287
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
13703
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
13704
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
13705
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
13706
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13707
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
13288
13708
|
#
|
|
13289
13709
|
# This change affects the following Amazon Web Services Regions: US
|
|
13290
13710
|
# East
|
|
@@ -13372,6 +13792,10 @@ module Aws::S3
|
|
|
13372
13792
|
#
|
|
13373
13793
|
# * [ListMultipartUploads][11]
|
|
13374
13794
|
#
|
|
13795
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
13796
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
13797
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
13798
|
+
#
|
|
13375
13799
|
#
|
|
13376
13800
|
#
|
|
13377
13801
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
|
@@ -13622,6 +14046,83 @@ module Aws::S3
|
|
|
13622
14046
|
req.send_request(options)
|
|
13623
14047
|
end
|
|
13624
14048
|
|
|
14049
|
+
# Sets the attribute-based access control (ABAC) property of the general
|
|
14050
|
+
# purpose bucket. When you enable ABAC, you can use tags for bucket
|
|
14051
|
+
# access control. Additionally, when ABAC is enabled, you must use the
|
|
14052
|
+
# [TagResource][1], [UntagResource][2], and [ListTagsForResource][3]
|
|
14053
|
+
# actions to manage bucket tags, and you can nolonger use the
|
|
14054
|
+
# [PutBucketTagging][4] and [DeleteBucketTagging][5] actions to tag the
|
|
14055
|
+
# bucket. You must also have the correct permissions for these actions.
|
|
14056
|
+
# For more information, see [Enabling ABAC in general purpose
|
|
14057
|
+
# buckets][6].
|
|
14058
|
+
#
|
|
14059
|
+
#
|
|
14060
|
+
#
|
|
14061
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
|
|
14062
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
14063
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html
|
|
14064
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
|
|
14065
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
14066
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
14067
|
+
#
|
|
14068
|
+
# @option params [required, String] :bucket
|
|
14069
|
+
# The name of the general purpose bucket.
|
|
14070
|
+
#
|
|
14071
|
+
# @option params [String] :content_md5
|
|
14072
|
+
# The MD5 hash of the `PutBucketAbac` request body.
|
|
14073
|
+
#
|
|
14074
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
|
14075
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
|
14076
|
+
# automatically.
|
|
14077
|
+
#
|
|
14078
|
+
# @option params [String] :checksum_algorithm
|
|
14079
|
+
# Indicates the algorithm that you want Amazon S3 to use to create the
|
|
14080
|
+
# checksum. For more information, see [ Checking object integrity][1] in
|
|
14081
|
+
# the *Amazon S3 User Guide*.
|
|
14082
|
+
#
|
|
14083
|
+
#
|
|
14084
|
+
#
|
|
14085
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
|
14086
|
+
#
|
|
14087
|
+
# @option params [String] :expected_bucket_owner
|
|
14088
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
14089
|
+
# owner.
|
|
14090
|
+
#
|
|
14091
|
+
# @option params [required, Types::AbacStatus] :abac_status
|
|
14092
|
+
# The ABAC status of the general purpose bucket. When ABAC is enabled
|
|
14093
|
+
# for the general purpose bucket, you can use tags to manage access to
|
|
14094
|
+
# the general purpose buckets as well as for cost tracking purposes.
|
|
14095
|
+
# When ABAC is disabled for the general purpose buckets, you can only
|
|
14096
|
+
# use tags for cost tracking purposes. For more information, see [Using
|
|
14097
|
+
# tags with S3 general purpose buckets][1].
|
|
14098
|
+
#
|
|
14099
|
+
#
|
|
14100
|
+
#
|
|
14101
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
|
|
14102
|
+
#
|
|
14103
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
|
14104
|
+
#
|
|
14105
|
+
# @example Request syntax with placeholder values
|
|
14106
|
+
#
|
|
14107
|
+
# resp = client.put_bucket_abac({
|
|
14108
|
+
# bucket: "BucketName", # required
|
|
14109
|
+
# content_md5: "ContentMD5",
|
|
14110
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
|
|
14111
|
+
# expected_bucket_owner: "AccountId",
|
|
14112
|
+
# abac_status: { # required
|
|
14113
|
+
# status: "Enabled", # accepts Enabled, Disabled
|
|
14114
|
+
# },
|
|
14115
|
+
# })
|
|
14116
|
+
#
|
|
14117
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAbac AWS API Documentation
|
|
14118
|
+
#
|
|
14119
|
+
# @overload put_bucket_abac(params = {})
|
|
14120
|
+
# @param [Hash] params ({})
|
|
14121
|
+
def put_bucket_abac(params = {}, options = {})
|
|
14122
|
+
req = build_request(:put_bucket_abac, params)
|
|
14123
|
+
req.send_request(options)
|
|
14124
|
+
end
|
|
14125
|
+
|
|
13625
14126
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
13626
14127
|
#
|
|
13627
14128
|
# </note>
|
|
@@ -13664,6 +14165,10 @@ module Aws::S3
|
|
|
13664
14165
|
#
|
|
13665
14166
|
# * [CreateBucket][5]
|
|
13666
14167
|
#
|
|
14168
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14169
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14170
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14171
|
+
#
|
|
13667
14172
|
#
|
|
13668
14173
|
#
|
|
13669
14174
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -13721,19 +14226,17 @@ module Aws::S3
|
|
|
13721
14226
|
req.send_request(options)
|
|
13722
14227
|
end
|
|
13723
14228
|
|
|
13724
|
-
# End of support notice:
|
|
13725
|
-
#
|
|
13726
|
-
#
|
|
13727
|
-
#
|
|
13728
|
-
#
|
|
13729
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
14229
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
14230
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
14231
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
14232
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
14233
|
+
# error.
|
|
13730
14234
|
#
|
|
13731
14235
|
# This change affects the following Amazon Web Services Regions: US
|
|
13732
14236
|
# East
|
|
13733
|
-
# (N. Virginia)
|
|
13734
|
-
#
|
|
13735
|
-
#
|
|
13736
|
-
# America (São Paulo) Region.
|
|
14237
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
14238
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
14239
|
+
# (Ireland), and South America (São Paulo).
|
|
13737
14240
|
#
|
|
13738
14241
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
13739
14242
|
#
|
|
@@ -13900,6 +14403,10 @@ module Aws::S3
|
|
|
13900
14403
|
#
|
|
13901
14404
|
# * [GetObjectAcl][9]
|
|
13902
14405
|
#
|
|
14406
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14407
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14408
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14409
|
+
#
|
|
13903
14410
|
#
|
|
13904
14411
|
#
|
|
13905
14412
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
|
@@ -14094,6 +14601,10 @@ module Aws::S3
|
|
|
14094
14601
|
#
|
|
14095
14602
|
# * [ListBucketAnalyticsConfigurations][7]
|
|
14096
14603
|
#
|
|
14604
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14605
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14606
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14607
|
+
#
|
|
14097
14608
|
#
|
|
14098
14609
|
#
|
|
14099
14610
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
|
|
@@ -14219,6 +14730,10 @@ module Aws::S3
|
|
|
14219
14730
|
#
|
|
14220
14731
|
# * [RESTOPTIONSobject][4]
|
|
14221
14732
|
#
|
|
14733
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14734
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14735
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14736
|
+
#
|
|
14222
14737
|
#
|
|
14223
14738
|
#
|
|
14224
14739
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
|
|
@@ -14350,7 +14865,8 @@ module Aws::S3
|
|
|
14350
14865
|
end
|
|
14351
14866
|
|
|
14352
14867
|
# This operation configures default encryption and Amazon S3 Bucket Keys
|
|
14353
|
-
# for an existing bucket.
|
|
14868
|
+
# for an existing bucket. You can also [block encryption types][1] using
|
|
14869
|
+
# this operation.
|
|
14354
14870
|
#
|
|
14355
14871
|
# <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
|
|
14356
14872
|
# requests for this API operation to the Regional endpoint. These
|
|
@@ -14358,9 +14874,9 @@ module Aws::S3
|
|
|
14358
14874
|
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
|
14359
14875
|
# Virtual-hosted-style requests aren't supported. For more information
|
|
14360
14876
|
# about endpoints in Availability Zones, see [Regional and Zonal
|
|
14361
|
-
# endpoints for directory buckets in Availability Zones][
|
|
14877
|
+
# endpoints for directory buckets in Availability Zones][2] in the
|
|
14362
14878
|
# *Amazon S3 User Guide*. For more information about endpoints in Local
|
|
14363
|
-
# Zones, see [Concepts for directory buckets in Local Zones][
|
|
14879
|
+
# Zones, see [Concepts for directory buckets in Local Zones][3] in the
|
|
14364
14880
|
# *Amazon S3 User Guide*.
|
|
14365
14881
|
#
|
|
14366
14882
|
# </note>
|
|
@@ -14375,12 +14891,12 @@ module Aws::S3
|
|
|
14375
14891
|
# keys (SSE-KMS) or dual-layer server-side encryption with Amazon
|
|
14376
14892
|
# Web Services KMS keys (DSSE-KMS). If you specify default
|
|
14377
14893
|
# encryption by using SSE-KMS, you can also configure [Amazon S3
|
|
14378
|
-
# Bucket Keys][
|
|
14379
|
-
# encryption feature, see [Amazon S3 Bucket Default Encryption][
|
|
14894
|
+
# Bucket Keys][4]. For information about the bucket default
|
|
14895
|
+
# encryption feature, see [Amazon S3 Bucket Default Encryption][5]
|
|
14380
14896
|
# in the *Amazon S3 User Guide*.
|
|
14381
14897
|
#
|
|
14382
14898
|
# * If you use PutBucketEncryption to set your [default bucket
|
|
14383
|
-
# encryption][
|
|
14899
|
+
# encryption][5] to SSE-KMS, you should verify that your KMS key ID
|
|
14384
14900
|
# is correct. Amazon S3 doesn't validate the KMS key ID provided in
|
|
14385
14901
|
# PutBucketEncryption requests.
|
|
14386
14902
|
# * <b>Directory buckets </b> - You can optionally configure default
|
|
@@ -14394,28 +14910,28 @@ module Aws::S3
|
|
|
14394
14910
|
# encrypted with the desired encryption settings. For more
|
|
14395
14911
|
# information about the encryption overriding behaviors in directory
|
|
14396
14912
|
# buckets, see [Specifying server-side encryption with KMS for new
|
|
14397
|
-
# object uploads][
|
|
14913
|
+
# object uploads][6].
|
|
14398
14914
|
#
|
|
14399
14915
|
# * Your SSE-KMS configuration can only support 1 [customer managed
|
|
14400
|
-
# key][
|
|
14401
|
-
# managed key][
|
|
14916
|
+
# key][7] per directory bucket's lifetime. The [Amazon Web Services
|
|
14917
|
+
# managed key][8] (`aws/s3`) isn't supported.
|
|
14402
14918
|
#
|
|
14403
14919
|
# * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
|
|
14404
14920
|
# in a directory bucket and can’t be disabled. S3 Bucket Keys
|
|
14405
14921
|
# aren't supported, when you copy SSE-KMS encrypted objects from
|
|
14406
14922
|
# general purpose buckets to directory buckets, from directory
|
|
14407
14923
|
# buckets to general purpose buckets, or between directory buckets,
|
|
14408
|
-
# through [CopyObject][
|
|
14409
|
-
# in Batch Operations][
|
|
14924
|
+
# through [CopyObject][9], [UploadPartCopy][10], [the Copy operation
|
|
14925
|
+
# in Batch Operations][11], or [the import jobs][12]. In this case,
|
|
14410
14926
|
# Amazon S3 makes a call to KMS every time a copy request is made
|
|
14411
14927
|
# for a KMS-encrypted object.
|
|
14412
14928
|
#
|
|
14413
|
-
# * When you specify an [KMS customer managed key][
|
|
14929
|
+
# * When you specify an [KMS customer managed key][7] for encryption
|
|
14414
14930
|
# in your directory bucket, only use the key ID or key ARN. The key
|
|
14415
14931
|
# alias format of the KMS key isn't supported.
|
|
14416
14932
|
#
|
|
14417
14933
|
# * For directory buckets, if you use PutBucketEncryption to set your
|
|
14418
|
-
# [default bucket encryption][
|
|
14934
|
+
# [default bucket encryption][5] to SSE-KMS, Amazon S3 validates the
|
|
14419
14935
|
# KMS key ID provided in PutBucketEncryption requests.
|
|
14420
14936
|
#
|
|
14421
14937
|
# </note>
|
|
@@ -14428,7 +14944,7 @@ module Aws::S3
|
|
|
14428
14944
|
#
|
|
14429
14945
|
# Also, this action requires Amazon Web Services Signature Version 4.
|
|
14430
14946
|
# For more information, see [ Authenticating Requests (Amazon Web
|
|
14431
|
-
# Services Signature Version 4)][
|
|
14947
|
+
# Services Signature Version 4)][13].
|
|
14432
14948
|
#
|
|
14433
14949
|
# Permissions
|
|
14434
14950
|
# : * **General purpose bucket permissions** - The
|
|
@@ -14436,8 +14952,8 @@ module Aws::S3
|
|
|
14436
14952
|
# policy. The bucket owner has this permission by default. The
|
|
14437
14953
|
# bucket owner can grant this permission to others. For more
|
|
14438
14954
|
# information about permissions, see [Permissions Related to Bucket
|
|
14439
|
-
# Operations][
|
|
14440
|
-
# Resources][
|
|
14955
|
+
# Operations][14] and [Managing Access Permissions to Your Amazon S3
|
|
14956
|
+
# Resources][15] in the *Amazon S3 User Guide*.
|
|
14441
14957
|
#
|
|
14442
14958
|
# * **Directory bucket permissions** - To grant access to this API
|
|
14443
14959
|
# operation, you must have the
|
|
@@ -14447,7 +14963,7 @@ module Aws::S3
|
|
|
14447
14963
|
# only be performed by the Amazon Web Services account that owns the
|
|
14448
14964
|
# resource. For more information about directory bucket policies and
|
|
14449
14965
|
# permissions, see [Amazon Web Services Identity and Access
|
|
14450
|
-
# Management (IAM) for S3 Express One Zone][
|
|
14966
|
+
# Management (IAM) for S3 Express One Zone][16] in the *Amazon S3
|
|
14451
14967
|
# User Guide*.
|
|
14452
14968
|
#
|
|
14453
14969
|
# To set a directory bucket default encryption with SSE-KMS, you
|
|
@@ -14462,29 +14978,34 @@ module Aws::S3
|
|
|
14462
14978
|
#
|
|
14463
14979
|
# The following operations are related to `PutBucketEncryption`:
|
|
14464
14980
|
#
|
|
14465
|
-
# * [GetBucketEncryption][
|
|
14981
|
+
# * [GetBucketEncryption][17]
|
|
14466
14982
|
#
|
|
14467
|
-
# * [DeleteBucketEncryption][
|
|
14983
|
+
# * [DeleteBucketEncryption][18]
|
|
14468
14984
|
#
|
|
14985
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
14986
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
14987
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
14469
14988
|
#
|
|
14470
14989
|
#
|
|
14471
|
-
#
|
|
14472
|
-
# [
|
|
14473
|
-
# [
|
|
14474
|
-
# [
|
|
14475
|
-
# [
|
|
14476
|
-
# [
|
|
14477
|
-
# [
|
|
14478
|
-
# [
|
|
14479
|
-
# [
|
|
14480
|
-
# [
|
|
14481
|
-
# [
|
|
14482
|
-
# [
|
|
14483
|
-
# [
|
|
14484
|
-
# [
|
|
14485
|
-
# [
|
|
14486
|
-
# [
|
|
14487
|
-
# [
|
|
14990
|
+
#
|
|
14991
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_BlockedEncryptionTypes.html
|
|
14992
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
14993
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
|
|
14994
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
|
14995
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
|
|
14996
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
|
|
14997
|
+
# [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
|
|
14998
|
+
# [8]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
|
|
14999
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
|
15000
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
|
15001
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
|
|
15002
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
|
15003
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
|
|
15004
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
15005
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
15006
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
|
|
15007
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
|
15008
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
14488
15009
|
#
|
|
14489
15010
|
# @option params [required, String] :bucket
|
|
14490
15011
|
# Specifies default encryption for a bucket using server-side encryption
|
|
@@ -14568,6 +15089,9 @@ module Aws::S3
|
|
|
14568
15089
|
# kms_master_key_id: "SSEKMSKeyId",
|
|
14569
15090
|
# },
|
|
14570
15091
|
# bucket_key_enabled: false,
|
|
15092
|
+
# blocked_encryption_types: {
|
|
15093
|
+
# encryption_type: ["NONE"], # accepts NONE, SSE-C
|
|
15094
|
+
# },
|
|
14571
15095
|
# },
|
|
14572
15096
|
# ],
|
|
14573
15097
|
# },
|
|
@@ -14647,6 +15171,10 @@ module Aws::S3
|
|
|
14647
15171
|
# not have the `s3:PutIntelligentTieringConfiguration` bucket
|
|
14648
15172
|
# permission to set the configuration on the bucket.
|
|
14649
15173
|
#
|
|
15174
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15175
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15176
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15177
|
+
#
|
|
14650
15178
|
#
|
|
14651
15179
|
#
|
|
14652
15180
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
|
|
@@ -14792,6 +15320,10 @@ module Aws::S3
|
|
|
14792
15320
|
#
|
|
14793
15321
|
# * [ListBucketInventoryConfigurations][10]
|
|
14794
15322
|
#
|
|
15323
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15324
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15325
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15326
|
+
#
|
|
14795
15327
|
#
|
|
14796
15328
|
#
|
|
14797
15329
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
|
|
@@ -14929,6 +15461,10 @@ module Aws::S3
|
|
|
14929
15461
|
#
|
|
14930
15462
|
# * [Managing Access Permissions to your Amazon S3 Resources][3]
|
|
14931
15463
|
#
|
|
15464
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15465
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15466
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15467
|
+
#
|
|
14932
15468
|
#
|
|
14933
15469
|
#
|
|
14934
15470
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
|
@@ -15138,6 +15674,10 @@ module Aws::S3
|
|
|
15138
15674
|
#
|
|
15139
15675
|
# * [DeleteBucketLifecycle][10]
|
|
15140
15676
|
#
|
|
15677
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15678
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15679
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15680
|
+
#
|
|
15141
15681
|
#
|
|
15142
15682
|
#
|
|
15143
15683
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
|
|
@@ -15315,19 +15855,17 @@ module Aws::S3
|
|
|
15315
15855
|
req.send_request(options)
|
|
15316
15856
|
end
|
|
15317
15857
|
|
|
15318
|
-
# End of support notice:
|
|
15319
|
-
#
|
|
15320
|
-
#
|
|
15321
|
-
#
|
|
15322
|
-
#
|
|
15323
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
15858
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
15859
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
15860
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
15861
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
15862
|
+
# error.
|
|
15324
15863
|
#
|
|
15325
15864
|
# This change affects the following Amazon Web Services Regions: US
|
|
15326
15865
|
# East
|
|
15327
|
-
# (N. Virginia)
|
|
15328
|
-
#
|
|
15329
|
-
#
|
|
15330
|
-
# America (São Paulo) Region.
|
|
15866
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
15867
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
15868
|
+
# (Ireland), and South America (São Paulo).
|
|
15331
15869
|
#
|
|
15332
15870
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
15333
15871
|
#
|
|
@@ -15402,6 +15940,10 @@ module Aws::S3
|
|
|
15402
15940
|
#
|
|
15403
15941
|
# * [GetBucketLogging][5]
|
|
15404
15942
|
#
|
|
15943
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
15944
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
15945
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
15946
|
+
#
|
|
15405
15947
|
#
|
|
15406
15948
|
#
|
|
15407
15949
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
|
|
@@ -15555,6 +16097,10 @@ module Aws::S3
|
|
|
15555
16097
|
#
|
|
15556
16098
|
# * HTTP Status Code: HTTP 400 Bad Request
|
|
15557
16099
|
#
|
|
16100
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16101
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16102
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16103
|
+
#
|
|
15558
16104
|
#
|
|
15559
16105
|
#
|
|
15560
16106
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
@@ -15774,6 +16320,10 @@ module Aws::S3
|
|
|
15774
16320
|
#
|
|
15775
16321
|
# ^
|
|
15776
16322
|
#
|
|
16323
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16324
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16325
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16326
|
+
#
|
|
15777
16327
|
#
|
|
15778
16328
|
#
|
|
15779
16329
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
|
|
@@ -15908,6 +16458,10 @@ module Aws::S3
|
|
|
15908
16458
|
#
|
|
15909
16459
|
# * DeleteBucketOwnershipControls
|
|
15910
16460
|
#
|
|
16461
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16462
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16463
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16464
|
+
#
|
|
15911
16465
|
#
|
|
15912
16466
|
#
|
|
15913
16467
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html
|
|
@@ -16048,6 +16602,10 @@ module Aws::S3
|
|
|
16048
16602
|
#
|
|
16049
16603
|
# * [DeleteBucket][8]
|
|
16050
16604
|
#
|
|
16605
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16606
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16607
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16608
|
+
#
|
|
16051
16609
|
#
|
|
16052
16610
|
#
|
|
16053
16611
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -16256,6 +16814,10 @@ module Aws::S3
|
|
|
16256
16814
|
#
|
|
16257
16815
|
# * [DeleteBucketReplication][11]
|
|
16258
16816
|
#
|
|
16817
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
16818
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
16819
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16820
|
+
#
|
|
16259
16821
|
#
|
|
16260
16822
|
#
|
|
16261
16823
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
|
|
@@ -16437,6 +16999,10 @@ module Aws::S3
|
|
|
16437
16999
|
#
|
|
16438
17000
|
# * [GetBucketRequestPayment][3]
|
|
16439
17001
|
#
|
|
17002
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17003
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17004
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17005
|
+
#
|
|
16440
17006
|
#
|
|
16441
17007
|
#
|
|
16442
17008
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
|
|
@@ -16522,7 +17088,15 @@ module Aws::S3
|
|
|
16522
17088
|
#
|
|
16523
17089
|
# </note>
|
|
16524
17090
|
#
|
|
16525
|
-
# Sets the tags for a bucket
|
|
17091
|
+
# Sets the tags for a general purpose bucket if attribute based access
|
|
17092
|
+
# control (ABAC) is not enabled for the bucket. When you [enable ABAC
|
|
17093
|
+
# for a general purpose bucket][1], you can no longer use this operation
|
|
17094
|
+
# for that bucket and must use the [TagResource][2] or
|
|
17095
|
+
# [UntagResource][3] operations instead.
|
|
17096
|
+
#
|
|
17097
|
+
# if ABAC is not enabled for the bucket. When you [enable ABAC for a
|
|
17098
|
+
# general purpose bucket][1], you can no longer use this operation for
|
|
17099
|
+
# that bucket and must use [TagResource][2] instead.
|
|
16526
17100
|
#
|
|
16527
17101
|
# Use tags to organize your Amazon Web Services bill to reflect your own
|
|
16528
17102
|
# cost structure. To do this, sign up to get your Amazon Web Services
|
|
@@ -16532,8 +17106,8 @@ module Aws::S3
|
|
|
16532
17106
|
# several resources with a specific application name, and then organize
|
|
16533
17107
|
# your billing information to see the total cost of that application
|
|
16534
17108
|
# across several services. For more information, see [Cost Allocation
|
|
16535
|
-
# and Tagging][
|
|
16536
|
-
# Tags][
|
|
17109
|
+
# and Tagging][4] and [Using Cost Allocation in Amazon S3 Bucket
|
|
17110
|
+
# Tags][5].
|
|
16537
17111
|
#
|
|
16538
17112
|
# <note markdown="1"> When this operation sets the tags for a bucket, it will overwrite any
|
|
16539
17113
|
# current tags the bucket already has. You cannot use this operation to
|
|
@@ -16545,16 +17119,16 @@ module Aws::S3
|
|
|
16545
17119
|
# `s3:PutBucketTagging` action. The bucket owner has this permission by
|
|
16546
17120
|
# default and can grant this permission to others. For more information
|
|
16547
17121
|
# about permissions, see [Permissions Related to Bucket Subresource
|
|
16548
|
-
# Operations][
|
|
16549
|
-
# Resources][
|
|
17122
|
+
# Operations][6] and [Managing Access Permissions to Your Amazon S3
|
|
17123
|
+
# Resources][7].
|
|
16550
17124
|
#
|
|
16551
17125
|
# `PutBucketTagging` has the following special errors. For more Amazon
|
|
16552
|
-
# S3 errors see, [Error Responses][
|
|
17126
|
+
# S3 errors see, [Error Responses][8].
|
|
16553
17127
|
#
|
|
16554
17128
|
# * `InvalidTag` - The tag provided was not a valid tag. This error can
|
|
16555
17129
|
# occur if the tag did not pass input validation. For more
|
|
16556
17130
|
# information, see [Using Cost Allocation in Amazon S3 Bucket
|
|
16557
|
-
# Tags][
|
|
17131
|
+
# Tags][5].
|
|
16558
17132
|
#
|
|
16559
17133
|
# * `MalformedXML` - The XML provided does not match the schema.
|
|
16560
17134
|
#
|
|
@@ -16566,19 +17140,26 @@ module Aws::S3
|
|
|
16566
17140
|
#
|
|
16567
17141
|
# The following operations are related to `PutBucketTagging`:
|
|
16568
17142
|
#
|
|
16569
|
-
# * [GetBucketTagging][
|
|
17143
|
+
# * [GetBucketTagging][9]
|
|
16570
17144
|
#
|
|
16571
|
-
# * [DeleteBucketTagging][
|
|
17145
|
+
# * [DeleteBucketTagging][10]
|
|
16572
17146
|
#
|
|
17147
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17148
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17149
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
16573
17150
|
#
|
|
16574
17151
|
#
|
|
16575
|
-
#
|
|
16576
|
-
# [
|
|
16577
|
-
# [
|
|
16578
|
-
# [
|
|
16579
|
-
# [
|
|
16580
|
-
# [
|
|
16581
|
-
# [
|
|
17152
|
+
#
|
|
17153
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
|
|
17154
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
|
|
17155
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
|
|
17156
|
+
# [4]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
|
|
17157
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html
|
|
17158
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
|
|
17159
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
|
17160
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
|
|
17161
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
|
|
17162
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
|
|
16582
17163
|
#
|
|
16583
17164
|
# @option params [required, String] :bucket
|
|
16584
17165
|
# The bucket name.
|
|
@@ -16720,6 +17301,10 @@ module Aws::S3
|
|
|
16720
17301
|
#
|
|
16721
17302
|
# * [GetBucketVersioning][1]
|
|
16722
17303
|
#
|
|
17304
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17305
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17306
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17307
|
+
#
|
|
16723
17308
|
#
|
|
16724
17309
|
#
|
|
16725
17310
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
|
@@ -16763,6 +17348,17 @@ module Aws::S3
|
|
|
16763
17348
|
# @option params [String] :mfa
|
|
16764
17349
|
# The concatenation of the authentication device's serial number, a
|
|
16765
17350
|
# space, and the value that is displayed on your authentication device.
|
|
17351
|
+
# The serial number is the number that uniquely identifies the MFA
|
|
17352
|
+
# device. For physical MFA devices, this is the unique serial number
|
|
17353
|
+
# that's provided with the device. For virtual MFA devices, the serial
|
|
17354
|
+
# number is the device ARN. For more information, see [Enabling
|
|
17355
|
+
# versioning on buckets][1] and [Configuring MFA delete][2] in the
|
|
17356
|
+
# *Amazon Simple Storage Service User Guide*.
|
|
17357
|
+
#
|
|
17358
|
+
#
|
|
17359
|
+
#
|
|
17360
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
|
|
17361
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
|
|
16766
17362
|
#
|
|
16767
17363
|
# @option params [required, Types::VersioningConfiguration] :versioning_configuration
|
|
16768
17364
|
# Container for setting the versioning state.
|
|
@@ -16884,6 +17480,10 @@ module Aws::S3
|
|
|
16884
17480
|
#
|
|
16885
17481
|
# The maximum request length is limited to 128 KB.
|
|
16886
17482
|
#
|
|
17483
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17484
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17485
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17486
|
+
#
|
|
16887
17487
|
#
|
|
16888
17488
|
#
|
|
16889
17489
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
|
|
@@ -16994,19 +17594,17 @@ module Aws::S3
|
|
|
16994
17594
|
req.send_request(options)
|
|
16995
17595
|
end
|
|
16996
17596
|
|
|
16997
|
-
# End of support notice:
|
|
16998
|
-
#
|
|
16999
|
-
#
|
|
17000
|
-
#
|
|
17001
|
-
#
|
|
17002
|
-
# However, you will no longer be able to create new Email Grantee ACLs.
|
|
17597
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
17598
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
17599
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
17600
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
17601
|
+
# error.
|
|
17003
17602
|
#
|
|
17004
17603
|
# This change affects the following Amazon Web Services Regions: US
|
|
17005
17604
|
# East
|
|
17006
|
-
# (N. Virginia)
|
|
17007
|
-
#
|
|
17008
|
-
#
|
|
17009
|
-
# America (São Paulo) Region.
|
|
17605
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
17606
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
17607
|
+
# (Ireland), and South America (São Paulo).
|
|
17010
17608
|
#
|
|
17011
17609
|
# Adds an object to a bucket.
|
|
17012
17610
|
#
|
|
@@ -17137,6 +17735,10 @@ module Aws::S3
|
|
|
17137
17735
|
#
|
|
17138
17736
|
# * [DeleteObject][10]
|
|
17139
17737
|
#
|
|
17738
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
17739
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
17740
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
17741
|
+
#
|
|
17140
17742
|
#
|
|
17141
17743
|
#
|
|
17142
17744
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
|
|
@@ -18037,6 +18639,18 @@ module Aws::S3
|
|
|
18037
18639
|
req.send_request(options)
|
|
18038
18640
|
end
|
|
18039
18641
|
|
|
18642
|
+
# End of support notice: As of October 1, 2025, Amazon S3 has
|
|
18643
|
+
# discontinued support for Email Grantee Access Control Lists (ACLs). If
|
|
18644
|
+
# you attempt to use an Email Grantee ACL in a request after October 1,
|
|
18645
|
+
# 2025, the request will receive an `HTTP 405` (Method Not Allowed)
|
|
18646
|
+
# error.
|
|
18647
|
+
#
|
|
18648
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
18649
|
+
# East
|
|
18650
|
+
# (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
|
|
18651
|
+
# (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
|
|
18652
|
+
# (Ireland), and South America (São Paulo).
|
|
18653
|
+
#
|
|
18040
18654
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
|
18041
18655
|
#
|
|
18042
18656
|
# </note>
|
|
@@ -18197,6 +18811,10 @@ module Aws::S3
|
|
|
18197
18811
|
#
|
|
18198
18812
|
# * [GetObject][8]
|
|
18199
18813
|
#
|
|
18814
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
18815
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
18816
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
18817
|
+
#
|
|
18200
18818
|
#
|
|
18201
18819
|
#
|
|
18202
18820
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
|
|
@@ -18421,6 +19039,10 @@ module Aws::S3
|
|
|
18421
19039
|
#
|
|
18422
19040
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18423
19041
|
#
|
|
19042
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19043
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19044
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19045
|
+
#
|
|
18424
19046
|
#
|
|
18425
19047
|
#
|
|
18426
19048
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18553,6 +19175,10 @@ module Aws::S3
|
|
|
18553
19175
|
#
|
|
18554
19176
|
# </note>
|
|
18555
19177
|
#
|
|
19178
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19179
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19180
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19181
|
+
#
|
|
18556
19182
|
#
|
|
18557
19183
|
#
|
|
18558
19184
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18664,6 +19290,10 @@ module Aws::S3
|
|
|
18664
19290
|
#
|
|
18665
19291
|
# This functionality is not supported for Amazon S3 on Outposts.
|
|
18666
19292
|
#
|
|
19293
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19294
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19295
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19296
|
+
#
|
|
18667
19297
|
#
|
|
18668
19298
|
#
|
|
18669
19299
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
|
@@ -18828,6 +19458,10 @@ module Aws::S3
|
|
|
18828
19458
|
#
|
|
18829
19459
|
# * [DeleteObjectTagging][5]
|
|
18830
19460
|
#
|
|
19461
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19462
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19463
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19464
|
+
#
|
|
18831
19465
|
#
|
|
18832
19466
|
#
|
|
18833
19467
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html
|
|
@@ -18904,21 +19538,9 @@ module Aws::S3
|
|
|
18904
19538
|
# fails with the HTTP status code `403 Forbidden` (access denied).
|
|
18905
19539
|
#
|
|
18906
19540
|
# @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
|
|
19541
|
+
# Confirms that the requester knows that she or he will be charged for
|
|
19542
|
+
# the tagging object request. Bucket owners need not specify this
|
|
19543
|
+
# parameter in their requests.
|
|
18922
19544
|
#
|
|
18923
19545
|
# @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
18924
19546
|
#
|
|
@@ -19014,6 +19636,10 @@ module Aws::S3
|
|
|
19014
19636
|
#
|
|
19015
19637
|
# * [Using Amazon S3 Block Public Access][6]
|
|
19016
19638
|
#
|
|
19639
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19640
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19641
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19642
|
+
#
|
|
19017
19643
|
#
|
|
19018
19644
|
#
|
|
19019
19645
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
|
@@ -19143,6 +19769,10 @@ module Aws::S3
|
|
|
19143
19769
|
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
|
19144
19770
|
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
|
19145
19771
|
#
|
|
19772
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
19773
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
19774
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
19775
|
+
#
|
|
19146
19776
|
#
|
|
19147
19777
|
#
|
|
19148
19778
|
# [1]: https://datatracker.ietf.org/doc/rfc7232/
|
|
@@ -19427,6 +20057,10 @@ module Aws::S3
|
|
|
19427
20057
|
#
|
|
19428
20058
|
# * [GetBucketNotificationConfiguration][11]
|
|
19429
20059
|
#
|
|
20060
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20061
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20062
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20063
|
+
#
|
|
19430
20064
|
#
|
|
19431
20065
|
#
|
|
19432
20066
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
|
@@ -19750,6 +20384,10 @@ module Aws::S3
|
|
|
19750
20384
|
#
|
|
19751
20385
|
# * [PutBucketLifecycleConfiguration][12]
|
|
19752
20386
|
#
|
|
20387
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20388
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20389
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20390
|
+
#
|
|
19753
20391
|
#
|
|
19754
20392
|
#
|
|
19755
20393
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
|
@@ -20114,6 +20752,10 @@ module Aws::S3
|
|
|
20114
20752
|
#
|
|
20115
20753
|
# * [UpdateBucketMetadataJournalTableConfiguration][6]
|
|
20116
20754
|
#
|
|
20755
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20756
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20757
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20758
|
+
#
|
|
20117
20759
|
#
|
|
20118
20760
|
#
|
|
20119
20761
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20192,6 +20834,10 @@ module Aws::S3
|
|
|
20192
20834
|
#
|
|
20193
20835
|
# * [UpdateBucketMetadataInventoryTableConfiguration][6]
|
|
20194
20836
|
#
|
|
20837
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
20838
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
20839
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20840
|
+
#
|
|
20195
20841
|
#
|
|
20196
20842
|
#
|
|
20197
20843
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
|
|
@@ -20373,6 +21019,15 @@ module Aws::S3
|
|
|
20373
21019
|
# Multipart request. For more information, see
|
|
20374
21020
|
# [CreateMultipartUpload][2].
|
|
20375
21021
|
#
|
|
21022
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
21023
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
21024
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
21025
|
+
# headers while writing new data to your bucket. For more
|
|
21026
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
21027
|
+
# purpose bucket][12].
|
|
21028
|
+
#
|
|
21029
|
+
# </note>
|
|
21030
|
+
#
|
|
20376
21031
|
# If you request server-side encryption using a customer-provided
|
|
20377
21032
|
# encryption key (SSE-C) in your initiate multipart upload request,
|
|
20378
21033
|
# you must provide identical encryption information in each part
|
|
@@ -20383,7 +21038,7 @@ module Aws::S3
|
|
|
20383
21038
|
# * x-amz-server-side-encryption-customer-key
|
|
20384
21039
|
#
|
|
20385
21040
|
# * x-amz-server-side-encryption-customer-key-MD5
|
|
20386
|
-
# For more information, see [Using Server-Side Encryption][
|
|
21041
|
+
# For more information, see [Using Server-Side Encryption][13] in
|
|
20387
21042
|
# the *Amazon S3 User Guide*.
|
|
20388
21043
|
#
|
|
20389
21044
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
@@ -20411,13 +21066,17 @@ module Aws::S3
|
|
|
20411
21066
|
#
|
|
20412
21067
|
# * [CreateMultipartUpload][2]
|
|
20413
21068
|
#
|
|
20414
|
-
# * [CompleteMultipartUpload][
|
|
21069
|
+
# * [CompleteMultipartUpload][14]
|
|
20415
21070
|
#
|
|
20416
|
-
# * [AbortMultipartUpload][
|
|
21071
|
+
# * [AbortMultipartUpload][15]
|
|
20417
21072
|
#
|
|
20418
|
-
# * [ListParts][
|
|
21073
|
+
# * [ListParts][16]
|
|
20419
21074
|
#
|
|
20420
|
-
# * [ListMultipartUploads][
|
|
21075
|
+
# * [ListMultipartUploads][17]
|
|
21076
|
+
#
|
|
21077
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21078
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21079
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20421
21080
|
#
|
|
20422
21081
|
#
|
|
20423
21082
|
#
|
|
@@ -20432,11 +21091,12 @@ module Aws::S3
|
|
|
20432
21091
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
|
|
20433
21092
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
|
20434
21093
|
# [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/
|
|
21094
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
21095
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
|
21096
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
21097
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
21098
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
21099
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20440
21100
|
#
|
|
20441
21101
|
# @option params [String, StringIO, File] :body
|
|
20442
21102
|
# Object data.
|
|
@@ -20835,12 +21495,21 @@ module Aws::S3
|
|
|
20835
21495
|
# the `UploadPartCopy` operation, see [CopyObject][13] and
|
|
20836
21496
|
# [UploadPart][2].
|
|
20837
21497
|
#
|
|
21498
|
+
# <note markdown="1"> If you have server-side encryption with customer-provided keys
|
|
21499
|
+
# (SSE-C) blocked for your general purpose bucket, you will get an
|
|
21500
|
+
# HTTP 403 Access Denied error when you specify the SSE-C request
|
|
21501
|
+
# headers while writing new data to your bucket. For more
|
|
21502
|
+
# information, see [Blocking or unblocking SSE-C for a general
|
|
21503
|
+
# purpose bucket][14].
|
|
21504
|
+
#
|
|
21505
|
+
# </note>
|
|
21506
|
+
#
|
|
20838
21507
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
|
20839
21508
|
# two supported options for server-side encryption: server-side
|
|
20840
21509
|
# encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
|
|
20841
21510
|
# server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
|
|
20842
21511
|
# more information, see [Protecting data with server-side
|
|
20843
|
-
# encryption][
|
|
21512
|
+
# encryption][15] in the *Amazon S3 User Guide*.
|
|
20844
21513
|
#
|
|
20845
21514
|
# <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
|
|
20846
21515
|
# operation and an `UploadPartCopy` operation, the request headers
|
|
@@ -20852,7 +21521,7 @@ module Aws::S3
|
|
|
20852
21521
|
# S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
|
|
20853
21522
|
# objects from general purpose buckets to directory buckets, from
|
|
20854
21523
|
# directory buckets to general purpose buckets, or between directory
|
|
20855
|
-
# buckets, through [UploadPartCopy][
|
|
21524
|
+
# buckets, through [UploadPartCopy][16]. In this case, Amazon S3
|
|
20856
21525
|
# makes a call to KMS every time a copy request is made for a
|
|
20857
21526
|
# KMS-encrypted object.
|
|
20858
21527
|
#
|
|
@@ -20878,17 +21547,21 @@ module Aws::S3
|
|
|
20878
21547
|
#
|
|
20879
21548
|
# The following operations are related to `UploadPartCopy`:
|
|
20880
21549
|
#
|
|
20881
|
-
# * [CreateMultipartUpload][
|
|
21550
|
+
# * [CreateMultipartUpload][17]
|
|
20882
21551
|
#
|
|
20883
21552
|
# * [UploadPart][2]
|
|
20884
21553
|
#
|
|
20885
|
-
# * [CompleteMultipartUpload][
|
|
21554
|
+
# * [CompleteMultipartUpload][18]
|
|
20886
21555
|
#
|
|
20887
|
-
# * [AbortMultipartUpload][
|
|
21556
|
+
# * [AbortMultipartUpload][19]
|
|
20888
21557
|
#
|
|
20889
|
-
# * [ListParts][
|
|
21558
|
+
# * [ListParts][20]
|
|
20890
21559
|
#
|
|
20891
|
-
# * [ListMultipartUploads][
|
|
21560
|
+
# * [ListMultipartUploads][21]
|
|
21561
|
+
#
|
|
21562
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
21563
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
21564
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
20892
21565
|
#
|
|
20893
21566
|
#
|
|
20894
21567
|
#
|
|
@@ -20905,13 +21578,14 @@ module Aws::S3
|
|
|
20905
21578
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
|
|
20906
21579
|
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
|
|
20907
21580
|
# [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/
|
|
21581
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
|
|
21582
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
|
21583
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
|
21584
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
|
21585
|
+
# [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
|
21586
|
+
# [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
|
21587
|
+
# [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
|
21588
|
+
# [21]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
|
20915
21589
|
#
|
|
20916
21590
|
# @option params [required, String] :bucket
|
|
20917
21591
|
# The bucket name.
|
|
@@ -21353,6 +22027,10 @@ module Aws::S3
|
|
|
21353
22027
|
# Amazon Web Services built Lambda functions][3] in the *Amazon S3 User
|
|
21354
22028
|
# Guide*.
|
|
21355
22029
|
#
|
|
22030
|
+
# You must URL encode any signed header values that contain spaces. For
|
|
22031
|
+
# example, if your header value is `my file.txt`, containing two spaces
|
|
22032
|
+
# after `my`, you must URL encode this value to `my%20%20file.txt`.
|
|
22033
|
+
#
|
|
21356
22034
|
#
|
|
21357
22035
|
#
|
|
21358
22036
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
|
|
@@ -21735,7 +22413,7 @@ module Aws::S3
|
|
|
21735
22413
|
tracer: tracer
|
|
21736
22414
|
)
|
|
21737
22415
|
context[:gem_name] = 'aws-sdk-s3'
|
|
21738
|
-
context[:gem_version] = '1.
|
|
22416
|
+
context[:gem_version] = '1.205.0'
|
|
21739
22417
|
Seahorse::Client::Request.new(handlers, context)
|
|
21740
22418
|
end
|
|
21741
22419
|
|