aws-sdk-s3 1.193.0 → 1.209.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.
Files changed (64) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +109 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +1 -1
  5. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  6. data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
  7. data/lib/aws-sdk-s3/client.rb +916 -361
  8. data/lib/aws-sdk-s3/client_api.rb +61 -0
  9. data/lib/aws-sdk-s3/customizations/object.rb +76 -86
  10. data/lib/aws-sdk-s3/customizations.rb +4 -1
  11. data/lib/aws-sdk-s3/default_executor.rb +103 -0
  12. data/lib/aws-sdk-s3/encryption/client.rb +2 -2
  13. data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +2 -0
  14. data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +2 -0
  15. data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +2 -0
  16. data/lib/aws-sdk-s3/encryptionV2/client.rb +98 -23
  17. data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +7 -162
  18. data/lib/aws-sdk-s3/encryptionV2/decryption.rb +205 -0
  19. data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +17 -0
  20. data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +2 -0
  21. data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
  22. data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +8 -0
  23. data/lib/aws-sdk-s3/encryptionV2/utils.rb +5 -0
  24. data/lib/aws-sdk-s3/encryptionV3/client.rb +885 -0
  25. data/lib/aws-sdk-s3/encryptionV3/decrypt_handler.rb +98 -0
  26. data/lib/aws-sdk-s3/encryptionV3/decryption.rb +244 -0
  27. data/lib/aws-sdk-s3/encryptionV3/default_cipher_provider.rb +159 -0
  28. data/lib/aws-sdk-s3/encryptionV3/default_key_provider.rb +35 -0
  29. data/lib/aws-sdk-s3/encryptionV3/encrypt_handler.rb +98 -0
  30. data/lib/aws-sdk-s3/encryptionV3/errors.rb +47 -0
  31. data/lib/aws-sdk-s3/encryptionV3/io_auth_decrypter.rb +60 -0
  32. data/lib/aws-sdk-s3/encryptionV3/io_decrypter.rb +35 -0
  33. data/lib/aws-sdk-s3/encryptionV3/io_encrypter.rb +84 -0
  34. data/lib/aws-sdk-s3/encryptionV3/key_provider.rb +28 -0
  35. data/lib/aws-sdk-s3/encryptionV3/kms_cipher_provider.rb +159 -0
  36. data/lib/aws-sdk-s3/encryptionV3/materials.rb +58 -0
  37. data/lib/aws-sdk-s3/encryptionV3/utils.rb +321 -0
  38. data/lib/aws-sdk-s3/encryption_v2.rb +1 -0
  39. data/lib/aws-sdk-s3/encryption_v3.rb +24 -0
  40. data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
  41. data/lib/aws-sdk-s3/endpoint_provider.rb +241 -68
  42. data/lib/aws-sdk-s3/endpoints.rb +26 -0
  43. data/lib/aws-sdk-s3/file_downloader.rb +197 -134
  44. data/lib/aws-sdk-s3/file_uploader.rb +9 -13
  45. data/lib/aws-sdk-s3/multipart_download_error.rb +8 -0
  46. data/lib/aws-sdk-s3/multipart_file_uploader.rb +92 -107
  47. data/lib/aws-sdk-s3/multipart_stream_uploader.rb +96 -107
  48. data/lib/aws-sdk-s3/multipart_upload_error.rb +3 -4
  49. data/lib/aws-sdk-s3/object.rb +56 -27
  50. data/lib/aws-sdk-s3/object_acl.rb +1 -1
  51. data/lib/aws-sdk-s3/object_summary.rb +42 -13
  52. data/lib/aws-sdk-s3/object_version.rb +7 -9
  53. data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
  54. data/lib/aws-sdk-s3/transfer_manager.rb +303 -0
  55. data/lib/aws-sdk-s3/types.rb +380 -216
  56. data/lib/aws-sdk-s3.rb +1 -1
  57. data/sig/bucket.rbs +1 -1
  58. data/sig/client.rbs +41 -12
  59. data/sig/multipart_upload.rbs +1 -1
  60. data/sig/object.rbs +7 -5
  61. data/sig/object_summary.rbs +7 -5
  62. data/sig/resource.rbs +1 -0
  63. data/sig/types.rbs +47 -14
  64. metadata +22 -3
@@ -137,8 +137,8 @@ module Aws::S3
137
137
  # class name or an instance of a plugin class.
138
138
  #
139
139
  # @option options [required, Aws::CredentialProvider] :credentials
140
- # Your AWS credentials. This can be an instance of any one of the
141
- # following classes:
140
+ # Your AWS credentials used for authentication. This can be any class that includes and implements
141
+ # `Aws::CredentialProvider`, or instance of any one of the following classes:
142
142
  #
143
143
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
144
144
  # credentials.
@@ -166,22 +166,24 @@ module Aws::S3
166
166
  # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
167
167
  # from the Cognito Identity service.
168
168
  #
169
- # When `:credentials` are not configured directly, the following
170
- # locations will be searched for credentials:
169
+ # When `:credentials` are not configured directly, the following locations will be searched for credentials:
171
170
  #
172
171
  # * `Aws.config[:credentials]`
172
+ #
173
173
  # * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
174
174
  # `:account_id` options.
175
- # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
176
- # ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
175
+ #
176
+ # * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
177
+ # `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
178
+ #
177
179
  # * `~/.aws/credentials`
180
+ #
178
181
  # * `~/.aws/config`
179
- # * EC2/ECS IMDS instance profile - When used by default, the timeouts
180
- # are very aggressive. Construct and pass an instance of
181
- # `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
182
- # enable retries and extended timeouts. Instance profile credential
183
- # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
184
- # to true.
182
+ #
183
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
184
+ # Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
185
+ # enable retries and extended timeouts. Instance profile credential fetching can be disabled by
186
+ # setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
185
187
  #
186
188
  # @option options [required, String] :region
187
189
  # The AWS region to connect to. The configured `:region` is
@@ -219,6 +221,11 @@ module Aws::S3
219
221
  # When false, the request will raise a `RetryCapacityNotAvailableError` and will
220
222
  # not retry instead of sleeping.
221
223
  #
224
+ # @option options [Array<String>] :auth_scheme_preference
225
+ # A list of preferred authentication schemes to use when making a request. Supported values are:
226
+ # `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
227
+ # shared config as `auth_scheme_preference`, the value should be a comma-separated list.
228
+ #
222
229
  # @option options [Boolean] :client_side_monitoring (false)
223
230
  # When `true`, client-side metrics will be collected for all API requests from
224
231
  # this client.
@@ -262,7 +269,7 @@ module Aws::S3
262
269
  # When set to 'true' the request body will not be compressed
263
270
  # for supported operations.
264
271
  #
265
- # @option options [Boolean] :disable_s3_express_session_auth
272
+ # @option options [boolean] :disable_s3_express_session_auth
266
273
  # Parameter to indicate whether S3Express session auth should be disabled
267
274
  #
268
275
  # @option options [String, URI::HTTPS, URI::HTTP] :endpoint
@@ -333,8 +340,8 @@ module Aws::S3
333
340
  # When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
334
341
  #
335
342
  # @option options [String] :profile ("default")
336
- # Used when loading credentials from the shared credentials file
337
- # at HOME/.aws/credentials. When not specified, 'default' is used.
343
+ # Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
344
+ # When not specified, 'default' is used.
338
345
  #
339
346
  # @option options [String] :request_checksum_calculation ("when_supported")
340
347
  # Determines when a checksum will be calculated for request payloads. Values are:
@@ -466,8 +473,8 @@ module Aws::S3
466
473
  # `Aws::Telemetry::OTelProvider` for telemetry provider.
467
474
  #
468
475
  # @option options [Aws::TokenProvider] :token_provider
469
- # A Bearer Token Provider. This can be an instance of any one of the
470
- # following classes:
476
+ # Your Bearer token used for authentication. This can be any class that includes and implements
477
+ # `Aws::TokenProvider`, or instance of any one of the following classes:
471
478
  #
472
479
  # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
473
480
  # tokens.
@@ -643,6 +650,10 @@ module Aws::S3
643
650
  #
644
651
  # * [ListMultipartUploads][9]
645
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
+ #
646
657
  #
647
658
  #
648
659
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
@@ -917,6 +928,10 @@ module Aws::S3
917
928
  #
918
929
  # * [ListMultipartUploads][13]
919
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
+ #
920
935
  #
921
936
  #
922
937
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
@@ -1279,23 +1294,21 @@ module Aws::S3
1279
1294
  req.send_request(options)
1280
1295
  end
1281
1296
 
1282
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
1283
- # discontinue support for creating new Email Grantee Access Control
1284
- # Lists (ACL). Email Grantee ACLs created prior to this date will
1285
- # continue to work and remain accessible through the Amazon Web Services
1286
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
1287
- # However, you will no longer be able to create new Email Grantee ACLs.
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.
1288
1304
  #
1289
1305
  # This change affects the following Amazon Web Services Regions: US
1290
1306
  # East
1291
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
1292
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
1293
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
1294
- # America (São Paulo) Region.
1307
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
1308
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
1309
+ # (Ireland), and South America (São Paulo).
1295
1310
  #
1296
- # Creates a copy of an object that is already stored in Amazon S3.
1297
- #
1298
- # <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
1311
+ # <note markdown="1"> You can store individual objects of up to 50 TB in Amazon S3. You
1299
1312
  # create a copy of your object up to 5 GB in size in a single atomic
1300
1313
  # action using this API. However, to copy an object greater than 5 GB,
1301
1314
  # you must use the multipart upload Upload Part - Copy (UploadPartCopy)
@@ -1462,6 +1475,10 @@ module Aws::S3
1462
1475
  #
1463
1476
  # * [GetObject][12]
1464
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
+ #
1465
1482
  #
1466
1483
  #
1467
1484
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
@@ -1782,6 +1799,37 @@ module Aws::S3
1782
1799
  #
1783
1800
  # </note>
1784
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
+ #
1785
1833
  # @option params [required, String] :key
1786
1834
  # The key of the destination object.
1787
1835
  #
@@ -2313,6 +2361,8 @@ module Aws::S3
2313
2361
  # grant_read: "GrantRead",
2314
2362
  # grant_read_acp: "GrantReadACP",
2315
2363
  # grant_write_acp: "GrantWriteACP",
2364
+ # if_match: "IfMatch",
2365
+ # if_none_match: "IfNoneMatch",
2316
2366
  # key: "ObjectKey", # required
2317
2367
  # metadata: {
2318
2368
  # "MetadataKey" => "MetadataValue",
@@ -2320,7 +2370,7 @@ module Aws::S3
2320
2370
  # metadata_directive: "COPY", # accepts COPY, REPLACE
2321
2371
  # tagging_directive: "COPY", # accepts COPY, REPLACE
2322
2372
  # server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
2323
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
2373
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
2324
2374
  # website_redirect_location: "WebsiteRedirectLocation",
2325
2375
  # sse_customer_algorithm: "SSECustomerAlgorithm",
2326
2376
  # sse_customer_key: "SSECustomerKey",
@@ -2370,33 +2420,6 @@ module Aws::S3
2370
2420
  req.send_request(options)
2371
2421
  end
2372
2422
 
2373
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
2374
- # discontinue support for creating new Email Grantee Access Control
2375
- # Lists (ACL). Email Grantee ACLs created prior to this date will
2376
- # continue to work and remain accessible through the Amazon Web Services
2377
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
2378
- # However, you will no longer be able to create new Email Grantee ACLs.
2379
- #
2380
- # This change affects the following Amazon Web Services Regions: US
2381
- # East
2382
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
2383
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
2384
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
2385
- # America (São Paulo) Region.
2386
- #
2387
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
2388
- # returning `DisplayName`. Update your applications to use canonical IDs
2389
- # (unique identifier for Amazon Web Services accounts), Amazon Web
2390
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
2391
- # naming) as a direct replacement of `DisplayName`.
2392
- #
2393
- # This change affects the following Amazon Web Services Regions: US
2394
- # East
2395
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
2396
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
2397
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
2398
- # America (São Paulo) Region.
2399
- #
2400
2423
  # <note markdown="1"> This action creates an Amazon S3 bucket. To create an Amazon S3 on
2401
2424
  # Outposts bucket, see [ `CreateBucket` ][1].
2402
2425
  #
@@ -2518,6 +2541,10 @@ module Aws::S3
2518
2541
  #
2519
2542
  # * [DeleteBucket][13]
2520
2543
  #
2544
+ # You must URL encode any signed header values that contain spaces. For
2545
+ # example, if your header value is `my file.txt`, containing two spaces
2546
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
2547
+ #
2521
2548
  #
2522
2549
  #
2523
2550
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
@@ -2787,6 +2814,10 @@ module Aws::S3
2787
2814
  #
2788
2815
  # * [UpdateBucketMetadataJournalTableConfiguration][8]
2789
2816
  #
2817
+ # You must URL encode any signed header values that contain spaces. For
2818
+ # example, if your header value is `my file.txt`, containing two spaces
2819
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
2820
+ #
2790
2821
  #
2791
2822
  #
2792
2823
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
@@ -2904,6 +2935,10 @@ module Aws::S3
2904
2935
  #
2905
2936
  # * [GetBucketMetadataTableConfiguration][6]
2906
2937
  #
2938
+ # You must URL encode any signed header values that contain spaces. For
2939
+ # example, if your header value is `my file.txt`, containing two spaces
2940
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
2941
+ #
2907
2942
  #
2908
2943
  #
2909
2944
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
@@ -2956,19 +2991,17 @@ module Aws::S3
2956
2991
  req.send_request(options)
2957
2992
  end
2958
2993
 
2959
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
2960
- # discontinue support for creating new Email Grantee Access Control
2961
- # Lists (ACL). Email Grantee ACLs created prior to this date will
2962
- # continue to work and remain accessible through the Amazon Web Services
2963
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
2964
- # However, you will no longer be able to create new Email Grantee ACLs.
2994
+ # End of support notice: As of October 1, 2025, Amazon S3 has
2995
+ # discontinued support for Email Grantee Access Control Lists (ACLs). If
2996
+ # you attempt to use an Email Grantee ACL in a request after October 1,
2997
+ # 2025, the request will receive an `HTTP 405` (Method Not Allowed)
2998
+ # error.
2965
2999
  #
2966
3000
  # This change affects the following Amazon Web Services Regions: US
2967
3001
  # East
2968
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
2969
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
2970
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
2971
- # America (São Paulo) Region.
3002
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
3003
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
3004
+ # (Ireland), and South America (São Paulo).
2972
3005
  #
2973
3006
  # This action initiates a multipart upload and returns an upload ID.
2974
3007
  # This upload ID is used to associate all of the parts in the specific
@@ -3204,6 +3237,10 @@ module Aws::S3
3204
3237
  #
3205
3238
  # * [ListMultipartUploads][19]
3206
3239
  #
3240
+ # You must URL encode any signed header values that contain spaces. For
3241
+ # example, if your header value is `my file.txt`, containing two spaces
3242
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
3243
+ #
3207
3244
  #
3208
3245
  #
3209
3246
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
@@ -3894,7 +3931,7 @@ module Aws::S3
3894
3931
  # "MetadataKey" => "MetadataValue",
3895
3932
  # },
3896
3933
  # server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
3897
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
3934
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
3898
3935
  # website_redirect_location: "WebsiteRedirectLocation",
3899
3936
  # sse_customer_algorithm: "SSECustomerAlgorithm",
3900
3937
  # sse_customer_key: "SSECustomerKey",
@@ -4084,6 +4121,10 @@ module Aws::S3
4084
4121
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
4085
4122
  # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
4086
4123
  #
4124
+ # You must URL encode any signed header values that contain spaces. For
4125
+ # example, if your header value is `my file.txt`, containing two spaces
4126
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4127
+ #
4087
4128
  #
4088
4129
  #
4089
4130
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
@@ -4286,6 +4327,10 @@ module Aws::S3
4286
4327
  #
4287
4328
  # * [DeleteObject][5]
4288
4329
  #
4330
+ # You must URL encode any signed header values that contain spaces. For
4331
+ # example, if your header value is `my file.txt`, containing two spaces
4332
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4333
+ #
4289
4334
  #
4290
4335
  #
4291
4336
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -4376,6 +4421,10 @@ module Aws::S3
4376
4421
  #
4377
4422
  # * [PutBucketAnalyticsConfiguration][6]
4378
4423
  #
4424
+ # You must URL encode any signed header values that contain spaces. For
4425
+ # example, if your header value is `my file.txt`, containing two spaces
4426
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4427
+ #
4379
4428
  #
4380
4429
  #
4381
4430
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -4435,6 +4484,10 @@ module Aws::S3
4435
4484
  #
4436
4485
  # * [RESTOPTIONSobject][3]
4437
4486
  #
4487
+ # You must URL encode any signed header values that contain spaces. For
4488
+ # example, if your header value is `my file.txt`, containing two spaces
4489
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4490
+ #
4438
4491
  #
4439
4492
  #
4440
4493
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
@@ -4523,6 +4576,10 @@ module Aws::S3
4523
4576
  #
4524
4577
  # * [GetBucketEncryption][7]
4525
4578
  #
4579
+ # You must URL encode any signed header values that contain spaces. For
4580
+ # example, if your header value is `my file.txt`, containing two spaces
4581
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4582
+ #
4526
4583
  #
4527
4584
  #
4528
4585
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
@@ -4616,6 +4673,10 @@ module Aws::S3
4616
4673
  #
4617
4674
  # * [ListBucketIntelligentTieringConfigurations][4]
4618
4675
  #
4676
+ # You must URL encode any signed header values that contain spaces. For
4677
+ # example, if your header value is `my file.txt`, containing two spaces
4678
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4679
+ #
4619
4680
  #
4620
4681
  #
4621
4682
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -4679,6 +4740,10 @@ module Aws::S3
4679
4740
  #
4680
4741
  # * [ListBucketInventoryConfigurations][6]
4681
4742
  #
4743
+ # You must URL encode any signed header values that contain spaces. For
4744
+ # example, if your header value is `my file.txt`, containing two spaces
4745
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4746
+ #
4682
4747
  #
4683
4748
  #
4684
4749
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -4779,6 +4844,10 @@ module Aws::S3
4779
4844
  #
4780
4845
  # * [GetBucketLifecycleConfiguration][7]
4781
4846
  #
4847
+ # You must URL encode any signed header values that contain spaces. For
4848
+ # example, if your header value is `my file.txt`, containing two spaces
4849
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4850
+ #
4782
4851
  #
4783
4852
  #
4784
4853
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
@@ -4864,6 +4933,10 @@ module Aws::S3
4864
4933
  #
4865
4934
  # * [UpdateBucketMetadataJournalTableConfiguration][6]
4866
4935
  #
4936
+ # You must URL encode any signed header values that contain spaces. For
4937
+ # example, if your header value is `my file.txt`, containing two spaces
4938
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
4939
+ #
4867
4940
  #
4868
4941
  #
4869
4942
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
@@ -4941,6 +5014,10 @@ module Aws::S3
4941
5014
  #
4942
5015
  # * [GetBucketMetadataTableConfiguration][6]
4943
5016
  #
5017
+ # You must URL encode any signed header values that contain spaces. For
5018
+ # example, if your header value is `my file.txt`, containing two spaces
5019
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5020
+ #
4944
5021
  #
4945
5022
  #
4946
5023
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
@@ -5005,6 +5082,10 @@ module Aws::S3
5005
5082
  #
5006
5083
  # * [Monitoring Metrics with Amazon CloudWatch][3]
5007
5084
  #
5085
+ # You must URL encode any signed header values that contain spaces. For
5086
+ # example, if your header value is `my file.txt`, containing two spaces
5087
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5088
+ #
5008
5089
  #
5009
5090
  #
5010
5091
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -5065,6 +5146,10 @@ module Aws::S3
5065
5146
  #
5066
5147
  # * PutBucketOwnershipControls
5067
5148
  #
5149
+ # You must URL encode any signed header values that contain spaces. For
5150
+ # example, if your header value is `my file.txt`, containing two spaces
5151
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5152
+ #
5068
5153
  #
5069
5154
  #
5070
5155
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
@@ -5161,6 +5246,10 @@ module Aws::S3
5161
5246
  #
5162
5247
  # * [DeleteObject][6]
5163
5248
  #
5249
+ # You must URL encode any signed header values that contain spaces. For
5250
+ # example, if your header value is `my file.txt`, containing two spaces
5251
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5252
+ #
5164
5253
  #
5165
5254
  #
5166
5255
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -5253,6 +5342,10 @@ module Aws::S3
5253
5342
  #
5254
5343
  # * [GetBucketReplication][5]
5255
5344
  #
5345
+ # You must URL encode any signed header values that contain spaces. For
5346
+ # example, if your header value is `my file.txt`, containing two spaces
5347
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5348
+ #
5256
5349
  #
5257
5350
  #
5258
5351
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -5300,7 +5393,14 @@ module Aws::S3
5300
5393
  #
5301
5394
  # </note>
5302
5395
  #
5303
- # Deletes the tags from the bucket.
5396
+ # Deletes tags from the general purpose bucket if attribute based access
5397
+ # control (ABAC) is not enabled for the bucket. When you [enable ABAC
5398
+ # for a general purpose bucket][1], you can no longer use this operation
5399
+ # for that bucket and must use [UntagResource][2] instead.
5400
+ #
5401
+ # if ABAC is not enabled for the bucket. When you [enable ABAC for a
5402
+ # general purpose bucket][1], you can no longer use this operation for
5403
+ # that bucket and must use [UntagResource][2] instead.
5304
5404
  #
5305
5405
  # To use this operation, you must have permission to perform the
5306
5406
  # `s3:PutBucketTagging` action. By default, the bucket owner has this
@@ -5308,14 +5408,20 @@ module Aws::S3
5308
5408
  #
5309
5409
  # The following operations are related to `DeleteBucketTagging`:
5310
5410
  #
5311
- # * [GetBucketTagging][1]
5411
+ # * [GetBucketTagging][3]
5412
+ #
5413
+ # * [PutBucketTagging][4]
5312
5414
  #
5313
- # * [PutBucketTagging][2]
5415
+ # You must URL encode any signed header values that contain spaces. For
5416
+ # example, if your header value is `my file.txt`, containing two spaces
5417
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5314
5418
  #
5315
5419
  #
5316
5420
  #
5317
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
5318
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
5421
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
5422
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
5423
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
5424
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
5319
5425
  #
5320
5426
  # @option params [required, String] :bucket
5321
5427
  # The bucket that has the tag set to be removed.
@@ -5378,6 +5484,10 @@ module Aws::S3
5378
5484
  #
5379
5485
  # * [PutBucketWebsite][3]
5380
5486
  #
5487
+ # You must URL encode any signed header values that contain spaces. For
5488
+ # example, if your header value is `my file.txt`, containing two spaces
5489
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5490
+ #
5381
5491
  #
5382
5492
  #
5383
5493
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
@@ -5500,6 +5610,12 @@ module Aws::S3
5500
5610
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
5501
5611
  # specific version of an object from a versioning-enabled bucket,
5502
5612
  # you must have the `s3:DeleteObjectVersion` permission.
5613
+ #
5614
+ # <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
5615
+ # are explicitly denied in your bucket policy, attempts to delete
5616
+ # any unversioned objects result in a `403 Access Denied` error.
5617
+ #
5618
+ # </note>
5503
5619
  # * **Directory bucket permissions** - To grant access to this API
5504
5620
  # operation on a directory bucket, we recommend that you use the [
5505
5621
  # `CreateSession` ][8] API operation for session-based
@@ -5526,6 +5642,16 @@ module Aws::S3
5526
5642
  #
5527
5643
  # ^
5528
5644
  #
5645
+ # You must URL encode any signed header values that contain spaces. For
5646
+ # example, if your header value is `my file.txt`, containing two spaces
5647
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5648
+ #
5649
+ # <note markdown="1"> The `If-Match` header is supported for both general purpose and
5650
+ # directory buckets. `IfMatchLastModifiedTime` and `IfMatchSize` is only
5651
+ # supported for directory buckets.
5652
+ #
5653
+ # </note>
5654
+ #
5529
5655
  #
5530
5656
  #
5531
5657
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
@@ -5636,17 +5762,15 @@ module Aws::S3
5636
5762
  # fails with the HTTP status code `403 Forbidden` (access denied).
5637
5763
  #
5638
5764
  # @option params [String] :if_match
5639
- # The `If-Match` header field makes the request method conditional on
5640
- # ETags. If the ETag value does not match, the operation returns a `412
5641
- # Precondition Failed` error. If the ETag matches or if the object
5642
- # doesn't exist, the operation will return a `204 Success (No Content)
5643
- # response`.
5644
- #
5645
- # For more information about conditional requests, see [RFC 7232][1].
5765
+ # Deletes the object if the ETag (entity tag) value provided during the
5766
+ # delete operation matches the ETag of the object in S3. If the ETag
5767
+ # values do not match, the operation returns a `412 Precondition Failed`
5768
+ # error.
5646
5769
  #
5647
- # <note markdown="1"> This functionality is only supported for directory buckets.
5770
+ # Expects the ETag value as a string. `If-Match` does accept a string
5771
+ # value of an '*' (asterisk) character to denote a match of any ETag.
5648
5772
  #
5649
- # </note>
5773
+ # For more information about conditional requests, see [RFC 7232][1].
5650
5774
  #
5651
5775
  #
5652
5776
  #
@@ -5757,6 +5881,10 @@ module Aws::S3
5757
5881
  #
5758
5882
  # * [GetObjectTagging][3]
5759
5883
  #
5884
+ # You must URL encode any signed header values that contain spaces. For
5885
+ # example, if your header value is `my file.txt`, containing two spaces
5886
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
5887
+ #
5760
5888
  #
5761
5889
  #
5762
5890
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
@@ -5927,6 +6055,12 @@ module Aws::S3
5927
6055
  # * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
5928
6056
  # specific version of an object from a versioning-enabled bucket,
5929
6057
  # you must specify the `s3:DeleteObjectVersion` permission.
6058
+ #
6059
+ # <note markdown="1"> If the `s3:DeleteObject` or `s3:DeleteObjectVersion` permissions
6060
+ # are explicitly denied in your bucket policy, attempts to delete
6061
+ # any unversioned objects result in a `403 Access Denied` error.
6062
+ #
6063
+ # </note>
5930
6064
  # * **Directory bucket permissions** - To grant access to this API
5931
6065
  # operation on a directory bucket, we recommend that you use the [
5932
6066
  # `CreateSession` ][4] API operation for session-based
@@ -5971,6 +6105,10 @@ module Aws::S3
5971
6105
  #
5972
6106
  # * [AbortMultipartUpload][9]
5973
6107
  #
6108
+ # You must URL encode any signed header values that contain spaces. For
6109
+ # example, if your header value is `my file.txt`, containing two spaces
6110
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6111
+ #
5974
6112
  #
5975
6113
  #
5976
6114
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -6251,7 +6389,10 @@ module Aws::S3
6251
6389
  # </note>
6252
6390
  #
6253
6391
  # Removes the `PublicAccessBlock` configuration for an Amazon S3 bucket.
6254
- # To use this operation, you must have the
6392
+ # This operation removes the bucket-level configuration only. The
6393
+ # effective public access behavior will still be governed by
6394
+ # account-level settings (which may inherit from organization-level
6395
+ # policies). To use this operation, you must have the
6255
6396
  # `s3:PutBucketPublicAccessBlock` permission. For more information about
6256
6397
  # permissions, see [Permissions Related to Bucket Subresource
6257
6398
  # Operations][1] and [Managing Access Permissions to Your Amazon S3
@@ -6267,6 +6408,10 @@ module Aws::S3
6267
6408
  #
6268
6409
  # * [GetBucketPolicyStatus][6]
6269
6410
  #
6411
+ # You must URL encode any signed header values that contain spaces. For
6412
+ # example, if your header value is `my file.txt`, containing two spaces
6413
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6414
+ #
6270
6415
  #
6271
6416
  #
6272
6417
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -6303,6 +6448,46 @@ module Aws::S3
6303
6448
  req.send_request(options)
6304
6449
  end
6305
6450
 
6451
+ # Returns the attribute-based access control (ABAC) property of the
6452
+ # general purpose bucket. If ABAC is enabled on your bucket, you can use
6453
+ # tags on the bucket for access control. For more information, see
6454
+ # [Enabling ABAC in general purpose buckets][1].
6455
+ #
6456
+ #
6457
+ #
6458
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
6459
+ #
6460
+ # @option params [required, String] :bucket
6461
+ # The name of the general purpose bucket.
6462
+ #
6463
+ # @option params [String] :expected_bucket_owner
6464
+ # The Amazon Web Services account ID of the general purpose bucket's
6465
+ # owner.
6466
+ #
6467
+ # @return [Types::GetBucketAbacOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6468
+ #
6469
+ # * {Types::GetBucketAbacOutput#abac_status #abac_status} => Types::AbacStatus
6470
+ #
6471
+ # @example Request syntax with placeholder values
6472
+ #
6473
+ # resp = client.get_bucket_abac({
6474
+ # bucket: "BucketName", # required
6475
+ # expected_bucket_owner: "AccountId",
6476
+ # })
6477
+ #
6478
+ # @example Response structure
6479
+ #
6480
+ # resp.abac_status.status #=> String, one of "Enabled", "Disabled"
6481
+ #
6482
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAbac AWS API Documentation
6483
+ #
6484
+ # @overload get_bucket_abac(params = {})
6485
+ # @param [Hash] params ({})
6486
+ def get_bucket_abac(params = {}, options = {})
6487
+ req = build_request(:get_bucket_abac, params)
6488
+ req.send_request(options)
6489
+ end
6490
+
6306
6491
  # <note markdown="1"> This operation is not supported for directory buckets.
6307
6492
  #
6308
6493
  # </note>
@@ -6339,6 +6524,10 @@ module Aws::S3
6339
6524
  #
6340
6525
  # ^
6341
6526
  #
6527
+ # You must URL encode any signed header values that contain spaces. For
6528
+ # example, if your header value is `my file.txt`, containing two spaces
6529
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6530
+ #
6342
6531
  #
6343
6532
  #
6344
6533
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -6399,19 +6588,6 @@ module Aws::S3
6399
6588
  req.send_request(options)
6400
6589
  end
6401
6590
 
6402
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
6403
- # returning `DisplayName`. Update your applications to use canonical IDs
6404
- # (unique identifier for Amazon Web Services accounts), Amazon Web
6405
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
6406
- # naming) as a direct replacement of `DisplayName`.
6407
- #
6408
- # This change affects the following Amazon Web Services Regions: US
6409
- # East
6410
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
6411
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
6412
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
6413
- # America (São Paulo) Region.
6414
- #
6415
6591
  # <note markdown="1"> This operation is not supported for directory buckets.
6416
6592
  #
6417
6593
  # </note>
@@ -6441,6 +6617,10 @@ module Aws::S3
6441
6617
  #
6442
6618
  # </note>
6443
6619
  #
6620
+ # You must URL encode any signed header values that contain spaces. For
6621
+ # example, if your header value is `my file.txt`, containing two spaces
6622
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6623
+ #
6444
6624
  # The following operations are related to `GetBucketAcl`:
6445
6625
  #
6446
6626
  # * [ListObjects][3]
@@ -6536,6 +6716,10 @@ module Aws::S3
6536
6716
  #
6537
6717
  # * [PutBucketAnalyticsConfiguration][6]
6538
6718
  #
6719
+ # You must URL encode any signed header values that contain spaces. For
6720
+ # example, if your header value is `my file.txt`, containing two spaces
6721
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6722
+ #
6539
6723
  #
6540
6724
  #
6541
6725
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -6624,6 +6808,10 @@ module Aws::S3
6624
6808
  #
6625
6809
  # * [DeleteBucketCors][4]
6626
6810
  #
6811
+ # You must URL encode any signed header values that contain spaces. For
6812
+ # example, if your header value is `my file.txt`, containing two spaces
6813
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6814
+ #
6627
6815
  #
6628
6816
  #
6629
6817
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
@@ -6716,17 +6904,19 @@ module Aws::S3
6716
6904
 
6717
6905
  # Returns the default encryption configuration for an Amazon S3 bucket.
6718
6906
  # By default, all buckets have a default encryption configuration that
6719
- # uses server-side encryption with Amazon S3 managed keys (SSE-S3).
6907
+ # uses server-side encryption with Amazon S3 managed keys (SSE-S3). This
6908
+ # operation also returns the [BucketKeyEnabled][1] and
6909
+ # [BlockedEncryptionTypes][2] statuses.
6720
6910
  #
6721
6911
  # <note markdown="1"> * **General purpose buckets** - For information about the bucket
6722
6912
  # default encryption feature, see [Amazon S3 Bucket Default
6723
- # Encryption][1] in the *Amazon S3 User Guide*.
6913
+ # Encryption][3] in the *Amazon S3 User Guide*.
6724
6914
  #
6725
6915
  # * **Directory buckets** - For directory buckets, there are only two
6726
6916
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
6727
6917
  # For information about the default encryption configuration in
6728
6918
  # directory buckets, see [Setting default server-side encryption
6729
- # behavior for directory buckets][2].
6919
+ # behavior for directory buckets][4].
6730
6920
  #
6731
6921
  # </note>
6732
6922
  #
@@ -6736,8 +6926,8 @@ module Aws::S3
6736
6926
  # policy. The bucket owner has this permission by default. The
6737
6927
  # bucket owner can grant this permission to others. For more
6738
6928
  # information about permissions, see [Permissions Related to Bucket
6739
- # Operations][3] and [Managing Access Permissions to Your Amazon S3
6740
- # Resources][4].
6929
+ # Operations][5] and [Managing Access Permissions to Your Amazon S3
6930
+ # Resources][6].
6741
6931
  #
6742
6932
  # * **Directory bucket permissions** - To grant access to this API
6743
6933
  # operation, you must have the
@@ -6747,7 +6937,7 @@ module Aws::S3
6747
6937
  # only be performed by the Amazon Web Services account that owns the
6748
6938
  # resource. For more information about directory bucket policies and
6749
6939
  # permissions, see [Amazon Web Services Identity and Access
6750
- # Management (IAM) for S3 Express One Zone][5] in the *Amazon S3
6940
+ # Management (IAM) for S3 Express One Zone][7] in the *Amazon S3
6751
6941
  # User Guide*.
6752
6942
  #
6753
6943
  # HTTP Host header syntax
@@ -6757,19 +6947,25 @@ module Aws::S3
6757
6947
  #
6758
6948
  # The following operations are related to `GetBucketEncryption`:
6759
6949
  #
6760
- # * [PutBucketEncryption][6]
6950
+ # * [PutBucketEncryption][8]
6761
6951
  #
6762
- # * [DeleteBucketEncryption][7]
6952
+ # * [DeleteBucketEncryption][9]
6763
6953
  #
6954
+ # You must URL encode any signed header values that contain spaces. For
6955
+ # example, if your header value is `my file.txt`, containing two spaces
6956
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
6764
6957
  #
6765
6958
  #
6766
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
6767
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html
6768
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6769
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6770
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6771
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
6772
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
6959
+ #
6960
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ServerSideEncryptionRule.html#AmazonS3-Type-ServerSideEncryptionRule-BucketKeyEnabled
6961
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ServerSideEncryptionRule.html#AmazonS3-Type-ServerSideEncryptionRule-BlockedEncryptionTypes
6962
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html
6963
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html
6964
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6965
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6966
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
6967
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
6968
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
6773
6969
  #
6774
6970
  # @option params [required, String] :bucket
6775
6971
  # The name of the bucket from which the server-side encryption
@@ -6818,6 +7014,8 @@ module Aws::S3
6818
7014
  # resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.sse_algorithm #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
6819
7015
  # resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.kms_master_key_id #=> String
6820
7016
  # resp.server_side_encryption_configuration.rules[0].bucket_key_enabled #=> Boolean
7017
+ # resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type #=> Array
7018
+ # resp.server_side_encryption_configuration.rules[0].blocked_encryption_types.encryption_type[0] #=> String, one of "NONE", "SSE-C"
6821
7019
  #
6822
7020
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryption AWS API Documentation
6823
7021
  #
@@ -6863,6 +7061,10 @@ module Aws::S3
6863
7061
  #
6864
7062
  # * [ListBucketIntelligentTieringConfigurations][4]
6865
7063
  #
7064
+ # You must URL encode any signed header values that contain spaces. For
7065
+ # example, if your header value is `my file.txt`, containing two spaces
7066
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7067
+ #
6866
7068
  #
6867
7069
  #
6868
7070
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -6944,6 +7146,10 @@ module Aws::S3
6944
7146
  #
6945
7147
  # * [PutBucketInventoryConfiguration][6]
6946
7148
  #
7149
+ # You must URL encode any signed header values that contain spaces. For
7150
+ # example, if your header value is `my file.txt`, containing two spaces
7151
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7152
+ #
6947
7153
  #
6948
7154
  #
6949
7155
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -6989,7 +7195,7 @@ module Aws::S3
6989
7195
  # resp.inventory_configuration.id #=> String
6990
7196
  # resp.inventory_configuration.included_object_versions #=> String, one of "All", "Current"
6991
7197
  # resp.inventory_configuration.optional_fields #=> Array
6992
- # resp.inventory_configuration.optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner"
7198
+ # resp.inventory_configuration.optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner", "LifecycleExpirationDate"
6993
7199
  # resp.inventory_configuration.schedule.frequency #=> String, one of "Daily", "Weekly"
6994
7200
  #
6995
7201
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketInventoryConfiguration AWS API Documentation
@@ -7040,6 +7246,10 @@ module Aws::S3
7040
7246
  #
7041
7247
  # * [DeleteBucketLifecycle][6]
7042
7248
  #
7249
+ # You must URL encode any signed header values that contain spaces. For
7250
+ # example, if your header value is `my file.txt`, containing two spaces
7251
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7252
+ #
7043
7253
  #
7044
7254
  #
7045
7255
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
@@ -7201,6 +7411,10 @@ module Aws::S3
7201
7411
  #
7202
7412
  # * [DeleteBucketLifecycle][8]
7203
7413
  #
7414
+ # You must URL encode any signed header values that contain spaces. For
7415
+ # example, if your header value is `my file.txt`, containing two spaces
7416
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7417
+ #
7204
7418
  #
7205
7419
  #
7206
7420
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
@@ -7305,13 +7519,25 @@ module Aws::S3
7305
7519
  req.send_request(options)
7306
7520
  end
7307
7521
 
7308
- # <note markdown="1"> This operation is not supported for directory buckets.
7309
- #
7310
- # </note>
7522
+ # Using the `GetBucketLocation` operation is no longer a best practice.
7523
+ # To return the Region that a bucket resides in, we recommend that you
7524
+ # use the [HeadBucket][1] operation instead. For backward compatibility,
7525
+ # Amazon S3 continues to support the `GetBucketLocation` operation.
7311
7526
  #
7312
7527
  # Returns the Region the bucket resides in. You set the bucket's Region
7313
7528
  # using the `LocationConstraint` request parameter in a `CreateBucket`
7314
- # request. For more information, see [CreateBucket][1].
7529
+ # request. For more information, see [CreateBucket][2].
7530
+ #
7531
+ # <note markdown="1"> In a bucket's home Region, calls to the `GetBucketLocation` operation
7532
+ # are governed by the bucket's policy. In other Regions, the bucket
7533
+ # policy doesn't apply, which means that cross-account access won't be
7534
+ # authorized. However, calls to the `HeadBucket` operation always return
7535
+ # the bucket’s location through an HTTP response header, whether access
7536
+ # to the bucket is authorized or not. Therefore, we recommend using the
7537
+ # `HeadBucket` operation for bucket Region discovery and to avoid using
7538
+ # the `GetBucketLocation` operation.
7539
+ #
7540
+ # </note>
7315
7541
  #
7316
7542
  # When you use this API operation with an access point, provide the
7317
7543
  # alias of the access point in place of the bucket name.
@@ -7321,11 +7547,9 @@ module Aws::S3
7321
7547
  # bucket name. If the Object Lambda access point alias in a request is
7322
7548
  # not valid, the error code `InvalidAccessPointAliasError` is returned.
7323
7549
  # For more information about `InvalidAccessPointAliasError`, see [List
7324
- # of Error Codes][2].
7550
+ # of Error Codes][3].
7325
7551
  #
7326
- # <note markdown="1"> We recommend that you use [HeadBucket][3] to return the Region that a
7327
- # bucket resides in. For backward compatibility, Amazon S3 continues to
7328
- # support GetBucketLocation.
7552
+ # <note markdown="1"> This operation is not supported for directory buckets.
7329
7553
  #
7330
7554
  # </note>
7331
7555
  #
@@ -7333,13 +7557,17 @@ module Aws::S3
7333
7557
  #
7334
7558
  # * [GetObject][4]
7335
7559
  #
7336
- # * [CreateBucket][1]
7560
+ # * [CreateBucket][2]
7337
7561
  #
7562
+ # You must URL encode any signed header values that contain spaces. For
7563
+ # example, if your header value is `my file.txt`, containing two spaces
7564
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7338
7565
  #
7339
7566
  #
7340
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
7341
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
7342
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
7567
+ #
7568
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
7569
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
7570
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
7343
7571
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
7344
7572
  #
7345
7573
  # @option params [required, String] :bucket
@@ -7402,19 +7630,6 @@ module Aws::S3
7402
7630
  req.send_request(options)
7403
7631
  end
7404
7632
 
7405
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
7406
- # returning `DisplayName`. Update your applications to use canonical IDs
7407
- # (unique identifier for Amazon Web Services accounts), Amazon Web
7408
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
7409
- # naming) as a direct replacement of `DisplayName`.
7410
- #
7411
- # This change affects the following Amazon Web Services Regions: US
7412
- # East
7413
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
7414
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
7415
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
7416
- # America (São Paulo) Region.
7417
- #
7418
7633
  # <note markdown="1"> This operation is not supported for directory buckets.
7419
7634
  #
7420
7635
  # </note>
@@ -7428,6 +7643,10 @@ module Aws::S3
7428
7643
  #
7429
7644
  # * [PutBucketLogging][2]
7430
7645
  #
7646
+ # You must URL encode any signed header values that contain spaces. For
7647
+ # example, if your header value is `my file.txt`, containing two spaces
7648
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7649
+ #
7431
7650
  #
7432
7651
  #
7433
7652
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
@@ -7509,6 +7728,10 @@ module Aws::S3
7509
7728
  #
7510
7729
  # * [UpdateBucketMetadataJournalTableConfiguration][6]
7511
7730
  #
7731
+ # You must URL encode any signed header values that contain spaces. For
7732
+ # example, if your header value is `my file.txt`, containing two spaces
7733
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7734
+ #
7512
7735
  #
7513
7736
  #
7514
7737
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
@@ -7607,6 +7830,10 @@ module Aws::S3
7607
7830
  #
7608
7831
  # * [DeleteBucketMetadataTableConfiguration][6]
7609
7832
  #
7833
+ # You must URL encode any signed header values that contain spaces. For
7834
+ # example, if your header value is `my file.txt`, containing two spaces
7835
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7836
+ #
7610
7837
  #
7611
7838
  #
7612
7839
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
@@ -7683,6 +7910,10 @@ module Aws::S3
7683
7910
  #
7684
7911
  # * [Monitoring Metrics with Amazon CloudWatch][3]
7685
7912
  #
7913
+ # You must URL encode any signed header values that contain spaces. For
7914
+ # example, if your header value is `my file.txt`, containing two spaces
7915
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
7916
+ #
7686
7917
  #
7687
7918
  #
7688
7919
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -7906,6 +8137,10 @@ module Aws::S3
7906
8137
  #
7907
8138
  # ^
7908
8139
  #
8140
+ # You must URL encode any signed header values that contain spaces. For
8141
+ # example, if your header value is `my file.txt`, containing two spaces
8142
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8143
+ #
7909
8144
  #
7910
8145
  #
7911
8146
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
@@ -8019,6 +8254,10 @@ module Aws::S3
8019
8254
  #
8020
8255
  # * DeleteBucketOwnershipControls
8021
8256
  #
8257
+ # You must URL encode any signed header values that contain spaces. For
8258
+ # example, if your header value is `my file.txt`, containing two spaces
8259
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8260
+ #
8022
8261
  #
8023
8262
  #
8024
8263
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html
@@ -8130,6 +8369,10 @@ module Aws::S3
8130
8369
  #
8131
8370
  # ^
8132
8371
  #
8372
+ # You must URL encode any signed header values that contain spaces. For
8373
+ # example, if your header value is `my file.txt`, containing two spaces
8374
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8375
+ #
8133
8376
  #
8134
8377
  #
8135
8378
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -8200,7 +8443,7 @@ module Aws::S3
8200
8443
  #
8201
8444
  # resp.to_h outputs the following:
8202
8445
  # {
8203
- # policy: "{\"Version\":\"2008-10-17\",\"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\"]}]}",
8446
+ # policy: "{\"Version\":\"2008-10-17\",&TCX5-2025-waiver;\"Id\":\"LogPolicy\",\"Statement\":[{\"Sid\":\"Enables the log delivery group to publish logs to your bucket \",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"111122223333\"},\"Action\":[\"s3:GetBucketAcl\",\"s3:GetObjectAcl\",\"s3:PutObject\"],\"Resource\":[\"arn:aws:s3:::policytest1/*\",\"arn:aws:s3:::policytest1\"]}]}",
8204
8447
  # }
8205
8448
  #
8206
8449
  # @example Request syntax with placeholder values
@@ -8246,6 +8489,10 @@ module Aws::S3
8246
8489
  #
8247
8490
  # * [DeletePublicAccessBlock][6]
8248
8491
  #
8492
+ # You must URL encode any signed header values that contain spaces. For
8493
+ # example, if your header value is `my file.txt`, containing two spaces
8494
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8495
+ #
8249
8496
  #
8250
8497
  #
8251
8498
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
@@ -8320,6 +8567,10 @@ module Aws::S3
8320
8567
  #
8321
8568
  # * [DeleteBucketReplication][5]
8322
8569
  #
8570
+ # You must URL encode any signed header values that contain spaces. For
8571
+ # example, if your header value is `my file.txt`, containing two spaces
8572
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8573
+ #
8323
8574
  #
8324
8575
  #
8325
8576
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
@@ -8393,7 +8644,7 @@ module Aws::S3
8393
8644
  # resp.replication_configuration.rules[0].existing_object_replication.status #=> String, one of "Enabled", "Disabled"
8394
8645
  # resp.replication_configuration.rules[0].destination.bucket #=> String
8395
8646
  # resp.replication_configuration.rules[0].destination.account #=> String
8396
- # resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
8647
+ # resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
8397
8648
  # resp.replication_configuration.rules[0].destination.access_control_translation.owner #=> String, one of "Destination"
8398
8649
  # resp.replication_configuration.rules[0].destination.encryption_configuration.replica_kms_key_id #=> String
8399
8650
  # resp.replication_configuration.rules[0].destination.replication_time.status #=> String, one of "Enabled", "Disabled"
@@ -8425,6 +8676,10 @@ module Aws::S3
8425
8676
  #
8426
8677
  # ^
8427
8678
  #
8679
+ # You must URL encode any signed header values that contain spaces. For
8680
+ # example, if your header value is `my file.txt`, containing two spaces
8681
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8682
+ #
8428
8683
  #
8429
8684
  #
8430
8685
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
@@ -8481,7 +8736,11 @@ module Aws::S3
8481
8736
  #
8482
8737
  # </note>
8483
8738
  #
8484
- # Returns the tag set associated with the bucket.
8739
+ # Returns the tag set associated with the general purpose bucket.
8740
+ #
8741
+ # if ABAC is not enabled for the bucket. When you [enable ABAC for a
8742
+ # general purpose bucket][1], you can no longer use this operation for
8743
+ # that bucket and must use [ListTagsForResource][2] instead.
8485
8744
  #
8486
8745
  # To use this operation, you must have permission to perform the
8487
8746
  # `s3:GetBucketTagging` action. By default, the bucket owner has this
@@ -8497,14 +8756,20 @@ module Aws::S3
8497
8756
  #
8498
8757
  # The following operations are related to `GetBucketTagging`:
8499
8758
  #
8500
- # * [PutBucketTagging][1]
8759
+ # * [PutBucketTagging][3]
8760
+ #
8761
+ # * [DeleteBucketTagging][4]
8501
8762
  #
8502
- # * [DeleteBucketTagging][2]
8763
+ # You must URL encode any signed header values that contain spaces. For
8764
+ # example, if your header value is `my file.txt`, containing two spaces
8765
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8503
8766
  #
8504
8767
  #
8505
8768
  #
8506
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
8507
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
8769
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
8770
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html
8771
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
8772
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
8508
8773
  #
8509
8774
  # @option params [required, String] :bucket
8510
8775
  # The name of the bucket for which to get the tagging information.
@@ -8585,6 +8850,10 @@ module Aws::S3
8585
8850
  #
8586
8851
  # * [DeleteObject][3]
8587
8852
  #
8853
+ # You must URL encode any signed header values that contain spaces. For
8854
+ # example, if your header value is `my file.txt`, containing two spaces
8855
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8856
+ #
8588
8857
  #
8589
8858
  #
8590
8859
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
@@ -8661,6 +8930,10 @@ module Aws::S3
8661
8930
  #
8662
8931
  # * [PutBucketWebsite][3]
8663
8932
  #
8933
+ # You must URL encode any signed header values that contain spaces. For
8934
+ # example, if your header value is `my file.txt`, containing two spaces
8935
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
8936
+ #
8664
8937
  #
8665
8938
  #
8666
8939
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
@@ -8895,6 +9168,10 @@ module Aws::S3
8895
9168
  #
8896
9169
  # * [GetObjectAcl][10]
8897
9170
  #
9171
+ # You must URL encode any signed header values that contain spaces. For
9172
+ # example, if your header value is `my file.txt`, containing two spaces
9173
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
9174
+ #
8898
9175
  #
8899
9176
  #
8900
9177
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
@@ -9382,7 +9659,7 @@ module Aws::S3
9382
9659
  # resp.sse_customer_key_md5 #=> String
9383
9660
  # resp.ssekms_key_id #=> String
9384
9661
  # resp.bucket_key_enabled #=> Boolean
9385
- # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
9662
+ # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
9386
9663
  # resp.request_charged #=> String, one of "requester"
9387
9664
  # resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
9388
9665
  # resp.parts_count #=> Integer
@@ -9434,6 +9711,10 @@ module Aws::S3
9434
9711
  #
9435
9712
  # * [PutObject][6]
9436
9713
  #
9714
+ # You must URL encode any signed header values that contain spaces. For
9715
+ # example, if your header value is `my file.txt`, containing two spaces
9716
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
9717
+ #
9437
9718
  #
9438
9719
  #
9439
9720
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#acl-access-policy-permission-mapping
@@ -9757,6 +10038,10 @@ module Aws::S3
9757
10038
  #
9758
10039
  # * [ListParts][16]
9759
10040
  #
10041
+ # You must URL encode any signed header values that contain spaces. For
10042
+ # example, if your header value is `my file.txt`, containing two spaces
10043
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10044
+ #
9760
10045
  #
9761
10046
  #
9762
10047
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -9961,7 +10246,7 @@ module Aws::S3
9961
10246
  # resp.object_parts.parts[0].checksum_crc64nvme #=> String
9962
10247
  # resp.object_parts.parts[0].checksum_sha1 #=> String
9963
10248
  # resp.object_parts.parts[0].checksum_sha256 #=> String
9964
- # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
10249
+ # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
9965
10250
  # resp.object_size #=> Integer
9966
10251
  #
9967
10252
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributes AWS API Documentation
@@ -9988,6 +10273,10 @@ module Aws::S3
9988
10273
  #
9989
10274
  # ^
9990
10275
  #
10276
+ # You must URL encode any signed header values that contain spaces. For
10277
+ # example, if your header value is `my file.txt`, containing two spaces
10278
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10279
+ #
9991
10280
  #
9992
10281
  #
9993
10282
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -10086,6 +10375,10 @@ module Aws::S3
10086
10375
  #
10087
10376
  # ^
10088
10377
  #
10378
+ # You must URL encode any signed header values that contain spaces. For
10379
+ # example, if your header value is `my file.txt`, containing two spaces
10380
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10381
+ #
10089
10382
  #
10090
10383
  #
10091
10384
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -10158,6 +10451,10 @@ module Aws::S3
10158
10451
  #
10159
10452
  # ^
10160
10453
  #
10454
+ # You must URL encode any signed header values that contain spaces. For
10455
+ # example, if your header value is `my file.txt`, containing two spaces
10456
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10457
+ #
10161
10458
  #
10162
10459
  #
10163
10460
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -10270,6 +10567,10 @@ module Aws::S3
10270
10567
  #
10271
10568
  # * [PutObjectTagging][4]
10272
10569
  #
10570
+ # You must URL encode any signed header values that contain spaces. For
10571
+ # example, if your header value is `my file.txt`, containing two spaces
10572
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10573
+ #
10273
10574
  #
10274
10575
  #
10275
10576
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
@@ -10436,6 +10737,10 @@ module Aws::S3
10436
10737
  #
10437
10738
  # ^
10438
10739
  #
10740
+ # You must URL encode any signed header values that contain spaces. For
10741
+ # example, if your header value is `my file.txt`, containing two spaces
10742
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10743
+ #
10439
10744
  #
10440
10745
  #
10441
10746
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
@@ -10519,17 +10824,21 @@ module Aws::S3
10519
10824
  # </note>
10520
10825
  #
10521
10826
  # Retrieves the `PublicAccessBlock` configuration for an Amazon S3
10522
- # bucket. To use this operation, you must have the
10827
+ # bucket. This operation returns the bucket-level configuration only. To
10828
+ # understand the effective public access behavior, you must also
10829
+ # consider account-level settings (which may inherit from
10830
+ # organization-level policies). To use this operation, you must have the
10523
10831
  # `s3:GetBucketPublicAccessBlock` permission. For more information about
10524
10832
  # Amazon S3 permissions, see [Specifying Permissions in a Policy][1].
10525
10833
  #
10526
10834
  # When Amazon S3 evaluates the `PublicAccessBlock` configuration for a
10527
10835
  # bucket or an object, it checks the `PublicAccessBlock` configuration
10528
10836
  # for both the bucket (or the bucket that contains the object) and the
10529
- # bucket owner's account. If the `PublicAccessBlock` settings are
10530
- # different between the bucket and the account, Amazon S3 uses the most
10531
- # restrictive combination of the bucket-level and account-level
10532
- # settings.
10837
+ # bucket owner's account. Account-level settings automatically inherit
10838
+ # from organization-level policies when present. If the
10839
+ # `PublicAccessBlock` settings are different between the bucket and the
10840
+ # account, Amazon S3 uses the most restrictive combination of the
10841
+ # bucket-level and account-level settings.
10533
10842
  #
10534
10843
  # For more information about when Amazon S3 considers a bucket or an
10535
10844
  # object public, see [The Meaning of "Public"][2].
@@ -10544,6 +10853,10 @@ module Aws::S3
10544
10853
  #
10545
10854
  # * [DeletePublicAccessBlock][6]
10546
10855
  #
10856
+ # You must URL encode any signed header values that contain spaces. For
10857
+ # example, if your header value is `my file.txt`, containing two spaces
10858
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10859
+ #
10547
10860
  #
10548
10861
  #
10549
10862
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
@@ -10590,13 +10903,19 @@ module Aws::S3
10590
10903
  end
10591
10904
 
10592
10905
  # You can use this operation to determine if a bucket exists and if you
10593
- # have permission to access it. The action returns a `200 OK` if the
10594
- # bucket exists and you have permission to access it.
10595
- #
10596
- # <note markdown="1"> If the bucket does not exist or you do not have permission to access
10906
+ # have permission to access it. The action returns a `200 OK` HTTP
10907
+ # status code if the bucket exists and you have permission to access it.
10908
+ # You can make a `HeadBucket` call on any bucket name to any Region in
10909
+ # the partition, and regardless of the permissions on the bucket, you
10910
+ # will receive a response header with the correct bucket location so
10911
+ # that you can then make a proper, signed request to the appropriate
10912
+ # Regional endpoint.
10913
+ #
10914
+ # <note markdown="1"> If the bucket doesn't exist or you don't have permission to access
10597
10915
  # it, the `HEAD` request returns a generic `400 Bad Request`, `403
10598
- # Forbidden` or `404 Not Found` code. A message body is not included, so
10599
- # you cannot determine the exception beyond these HTTP response codes.
10916
+ # Forbidden`, or `404 Not Found` HTTP status code. A message body isn't
10917
+ # included, so you can't determine the exception beyond these HTTP
10918
+ # response codes.
10600
10919
  #
10601
10920
  # </note>
10602
10921
  #
@@ -10659,6 +10978,10 @@ module Aws::S3
10659
10978
  #
10660
10979
  # </note>
10661
10980
  #
10981
+ # You must URL encode any signed header values that contain spaces. For
10982
+ # example, if your header value is `my file.txt`, containing two spaces
10983
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
10984
+ #
10662
10985
  #
10663
10986
  #
10664
10987
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
@@ -10919,6 +11242,10 @@ module Aws::S3
10919
11242
  #
10920
11243
  # * [GetObjectAttributes][9]
10921
11244
  #
11245
+ # You must URL encode any signed header values that contain spaces. For
11246
+ # example, if your header value is `my file.txt`, containing two spaces
11247
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
11248
+ #
10922
11249
  #
10923
11250
  #
10924
11251
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
@@ -11285,7 +11612,7 @@ module Aws::S3
11285
11612
  # resp.sse_customer_key_md5 #=> String
11286
11613
  # resp.ssekms_key_id #=> String
11287
11614
  # resp.bucket_key_enabled #=> Boolean
11288
- # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
11615
+ # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
11289
11616
  # resp.request_charged #=> String, one of "requester"
11290
11617
  # resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
11291
11618
  # resp.parts_count #=> Integer
@@ -11344,6 +11671,10 @@ module Aws::S3
11344
11671
  #
11345
11672
  # * [PutBucketAnalyticsConfiguration][6]
11346
11673
  #
11674
+ # You must URL encode any signed header values that contain spaces. For
11675
+ # example, if your header value is `my file.txt`, containing two spaces
11676
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
11677
+ #
11347
11678
  #
11348
11679
  #
11349
11680
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -11445,6 +11776,10 @@ module Aws::S3
11445
11776
  #
11446
11777
  # * [GetBucketIntelligentTieringConfiguration][4]
11447
11778
  #
11779
+ # You must URL encode any signed header values that contain spaces. For
11780
+ # example, if your header value is `my file.txt`, containing two spaces
11781
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
11782
+ #
11448
11783
  #
11449
11784
  #
11450
11785
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -11513,7 +11848,7 @@ module Aws::S3
11513
11848
  # </note>
11514
11849
  #
11515
11850
  # Returns a list of S3 Inventory configurations for the bucket. You can
11516
- # have up to 1,000 analytics configurations per bucket.
11851
+ # have up to 1,000 inventory configurations per bucket.
11517
11852
  #
11518
11853
  # This action supports list pagination and does not return more than 100
11519
11854
  # configurations at a time. Always check the `IsTruncated` element in
@@ -11543,6 +11878,10 @@ module Aws::S3
11543
11878
  #
11544
11879
  # * [PutBucketInventoryConfiguration][6]
11545
11880
  #
11881
+ # You must URL encode any signed header values that contain spaces. For
11882
+ # example, if your header value is `my file.txt`, containing two spaces
11883
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
11884
+ #
11546
11885
  #
11547
11886
  #
11548
11887
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -11596,7 +11935,7 @@ module Aws::S3
11596
11935
  # resp.inventory_configuration_list[0].id #=> String
11597
11936
  # resp.inventory_configuration_list[0].included_object_versions #=> String, one of "All", "Current"
11598
11937
  # resp.inventory_configuration_list[0].optional_fields #=> Array
11599
- # resp.inventory_configuration_list[0].optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner"
11938
+ # resp.inventory_configuration_list[0].optional_fields[0] #=> String, one of "Size", "LastModifiedDate", "StorageClass", "ETag", "IsMultipartUploaded", "ReplicationStatus", "EncryptionStatus", "ObjectLockRetainUntilDate", "ObjectLockMode", "ObjectLockLegalHoldStatus", "IntelligentTieringAccessTier", "BucketKeyStatus", "ChecksumAlgorithm", "ObjectAccessControlList", "ObjectOwner", "LifecycleExpirationDate"
11600
11939
  # resp.inventory_configuration_list[0].schedule.frequency #=> String, one of "Daily", "Weekly"
11601
11940
  # resp.is_truncated #=> Boolean
11602
11941
  # resp.next_continuation_token #=> String
@@ -11647,6 +11986,10 @@ module Aws::S3
11647
11986
  #
11648
11987
  # * [DeleteBucketMetricsConfiguration][6]
11649
11988
  #
11989
+ # You must URL encode any signed header values that contain spaces. For
11990
+ # example, if your header value is `my file.txt`, containing two spaces
11991
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
11992
+ #
11650
11993
  #
11651
11994
  #
11652
11995
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -11712,19 +12055,6 @@ module Aws::S3
11712
12055
  req.send_request(options)
11713
12056
  end
11714
12057
 
11715
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
11716
- # returning `DisplayName`. Update your applications to use canonical IDs
11717
- # (unique identifier for Amazon Web Services accounts), Amazon Web
11718
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
11719
- # naming) as a direct replacement of `DisplayName`.
11720
- #
11721
- # This change affects the following Amazon Web Services Regions: US
11722
- # East
11723
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
11724
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
11725
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
11726
- # America (São Paulo) Region.
11727
- #
11728
12058
  # <note markdown="1"> This operation is not supported for directory buckets.
11729
12059
  #
11730
12060
  # </note>
@@ -11745,6 +12075,10 @@ module Aws::S3
11745
12075
  # rejected for Amazon Web Services accounts with a general purpose
11746
12076
  # bucket quota greater than 10,000.
11747
12077
  #
12078
+ # You must URL encode any signed header values that contain spaces. For
12079
+ # example, if your header value is `my file.txt`, containing two spaces
12080
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
12081
+ #
11748
12082
  #
11749
12083
  #
11750
12084
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
@@ -11903,6 +12237,10 @@ module Aws::S3
11903
12237
  #
11904
12238
  # </note>
11905
12239
  #
12240
+ # You must URL encode any signed header values that contain spaces. For
12241
+ # example, if your header value is `my file.txt`, containing two spaces
12242
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
12243
+ #
11906
12244
  #
11907
12245
  #
11908
12246
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
@@ -11953,19 +12291,6 @@ module Aws::S3
11953
12291
  req.send_request(options)
11954
12292
  end
11955
12293
 
11956
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
11957
- # returning `DisplayName`. Update your applications to use canonical IDs
11958
- # (unique identifier for Amazon Web Services accounts), Amazon Web
11959
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
11960
- # naming) as a direct replacement of `DisplayName`.
11961
- #
11962
- # This change affects the following Amazon Web Services Regions: US
11963
- # East
11964
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
11965
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
11966
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
11967
- # America (São Paulo) Region.
11968
- #
11969
12294
  # This operation lists in-progress multipart uploads in a bucket. An
11970
12295
  # in-progress multipart upload is a multipart upload that has been
11971
12296
  # initiated by the `CreateMultipartUpload` request, but has not yet been
@@ -12074,6 +12399,10 @@ module Aws::S3
12074
12399
  #
12075
12400
  # * [AbortMultipartUpload][10]
12076
12401
  #
12402
+ # You must URL encode any signed header values that contain spaces. For
12403
+ # example, if your header value is `my file.txt`, containing two spaces
12404
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
12405
+ #
12077
12406
  #
12078
12407
  #
12079
12408
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
@@ -12394,7 +12723,7 @@ module Aws::S3
12394
12723
  # resp.uploads[0].upload_id #=> String
12395
12724
  # resp.uploads[0].key #=> String
12396
12725
  # resp.uploads[0].initiated #=> Time
12397
- # resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
12726
+ # resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
12398
12727
  # resp.uploads[0].owner.display_name #=> String
12399
12728
  # resp.uploads[0].owner.id #=> String
12400
12729
  # resp.uploads[0].initiator.id #=> String
@@ -12415,19 +12744,6 @@ module Aws::S3
12415
12744
  req.send_request(options)
12416
12745
  end
12417
12746
 
12418
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
12419
- # returning `DisplayName`. Update your applications to use canonical IDs
12420
- # (unique identifier for Amazon Web Services accounts), Amazon Web
12421
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
12422
- # naming) as a direct replacement of `DisplayName`.
12423
- #
12424
- # This change affects the following Amazon Web Services Regions: US
12425
- # East
12426
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
12427
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
12428
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
12429
- # America (São Paulo) Region.
12430
- #
12431
12747
  # <note markdown="1"> This operation is not supported for directory buckets.
12432
12748
  #
12433
12749
  # </note>
@@ -12457,6 +12773,10 @@ module Aws::S3
12457
12773
  #
12458
12774
  # * [DeleteObject][4]
12459
12775
  #
12776
+ # You must URL encode any signed header values that contain spaces. For
12777
+ # example, if your header value is `my file.txt`, containing two spaces
12778
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
12779
+ #
12460
12780
  #
12461
12781
  #
12462
12782
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
@@ -12671,19 +12991,6 @@ module Aws::S3
12671
12991
  req.send_request(options)
12672
12992
  end
12673
12993
 
12674
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
12675
- # returning `DisplayName`. Update your applications to use canonical IDs
12676
- # (unique identifier for Amazon Web Services accounts), Amazon Web
12677
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
12678
- # naming) as a direct replacement of `DisplayName`.
12679
- #
12680
- # This change affects the following Amazon Web Services Regions: US
12681
- # East
12682
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
12683
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
12684
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
12685
- # America (São Paulo) Region.
12686
- #
12687
12994
  # <note markdown="1"> This operation is not supported for directory buckets.
12688
12995
  #
12689
12996
  # </note>
@@ -12710,6 +13017,10 @@ module Aws::S3
12710
13017
  #
12711
13018
  # * [ListBuckets][5]
12712
13019
  #
13020
+ # You must URL encode any signed header values that contain spaces. For
13021
+ # example, if your header value is `my file.txt`, containing two spaces
13022
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
13023
+ #
12713
13024
  #
12714
13025
  #
12715
13026
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html
@@ -12900,7 +13211,7 @@ module Aws::S3
12900
13211
  # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
12901
13212
  # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
12902
13213
  # resp.contents[0].size #=> Integer
12903
- # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
13214
+ # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
12904
13215
  # resp.contents[0].owner.display_name #=> String
12905
13216
  # resp.contents[0].owner.id #=> String
12906
13217
  # resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
@@ -13003,6 +13314,10 @@ module Aws::S3
13003
13314
  #
13004
13315
  # * [CreateBucket][11]
13005
13316
  #
13317
+ # You must URL encode any signed header values that contain spaces. For
13318
+ # example, if your header value is `my file.txt`, containing two spaces
13319
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
13320
+ #
13006
13321
  #
13007
13322
  #
13008
13323
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
@@ -13246,7 +13561,7 @@ module Aws::S3
13246
13561
  # resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
13247
13562
  # resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
13248
13563
  # resp.contents[0].size #=> Integer
13249
- # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
13564
+ # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
13250
13565
  # resp.contents[0].owner.display_name #=> String
13251
13566
  # resp.contents[0].owner.id #=> String
13252
13567
  # resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
@@ -13273,19 +13588,6 @@ module Aws::S3
13273
13588
  req.send_request(options)
13274
13589
  end
13275
13590
 
13276
- # End of support notice: Beginning October 1, 2025, Amazon S3 will stop
13277
- # returning `DisplayName`. Update your applications to use canonical IDs
13278
- # (unique identifier for Amazon Web Services accounts), Amazon Web
13279
- # Services account ID (12 digit identifier) or IAM ARNs (full resource
13280
- # naming) as a direct replacement of `DisplayName`.
13281
- #
13282
- # This change affects the following Amazon Web Services Regions: US
13283
- # East
13284
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
13285
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
13286
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
13287
- # America (São Paulo) Region.
13288
- #
13289
13591
  # Lists the parts that have been uploaded for a specific multipart
13290
13592
  # upload.
13291
13593
  #
@@ -13365,6 +13667,10 @@ module Aws::S3
13365
13667
  #
13366
13668
  # * [ListMultipartUploads][11]
13367
13669
  #
13670
+ # You must URL encode any signed header values that contain spaces. For
13671
+ # example, if your header value is `my file.txt`, containing two spaces
13672
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
13673
+ #
13368
13674
  #
13369
13675
  #
13370
13676
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
@@ -13601,7 +13907,7 @@ module Aws::S3
13601
13907
  # resp.initiator.display_name #=> String
13602
13908
  # resp.owner.display_name #=> String
13603
13909
  # resp.owner.id #=> String
13604
- # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS"
13910
+ # resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE", "FSX_OPENZFS", "FSX_ONTAP"
13605
13911
  # resp.request_charged #=> String, one of "requester"
13606
13912
  # resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
13607
13913
  # resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
@@ -13615,6 +13921,81 @@ module Aws::S3
13615
13921
  req.send_request(options)
13616
13922
  end
13617
13923
 
13924
+ # Sets the attribute-based access control (ABAC) property of the general
13925
+ # purpose bucket. You must have `s3:PutBucketABAC` permission to perform
13926
+ # this action. When you enable ABAC, you can use tags for access control
13927
+ # on your buckets. Additionally, when ABAC is enabled, you must use the
13928
+ # [TagResource][1] and [UntagResource][2] actions to manage tags on your
13929
+ # buckets. You can nolonger use the [PutBucketTagging][3] and
13930
+ # [DeleteBucketTagging][4] actions to tag your bucket. For more
13931
+ # information, see [Enabling ABAC in general purpose buckets][5].
13932
+ #
13933
+ #
13934
+ #
13935
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
13936
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
13937
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
13938
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
13939
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
13940
+ #
13941
+ # @option params [required, String] :bucket
13942
+ # The name of the general purpose bucket.
13943
+ #
13944
+ # @option params [String] :content_md5
13945
+ # The MD5 hash of the `PutBucketAbac` request body.
13946
+ #
13947
+ # For requests made using the Amazon Web Services Command Line Interface
13948
+ # (CLI) or Amazon Web Services SDKs, this field is calculated
13949
+ # automatically.
13950
+ #
13951
+ # @option params [String] :checksum_algorithm
13952
+ # Indicates the algorithm that you want Amazon S3 to use to create the
13953
+ # checksum. For more information, see [ Checking object integrity][1] in
13954
+ # the *Amazon S3 User Guide*.
13955
+ #
13956
+ #
13957
+ #
13958
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
13959
+ #
13960
+ # @option params [String] :expected_bucket_owner
13961
+ # The Amazon Web Services account ID of the general purpose bucket's
13962
+ # owner.
13963
+ #
13964
+ # @option params [required, Types::AbacStatus] :abac_status
13965
+ # The ABAC status of the general purpose bucket. When ABAC is enabled
13966
+ # for the general purpose bucket, you can use tags to manage access to
13967
+ # the general purpose buckets as well as for cost tracking purposes.
13968
+ # When ABAC is disabled for the general purpose buckets, you can only
13969
+ # use tags for cost tracking purposes. For more information, see [Using
13970
+ # tags with S3 general purpose buckets][1].
13971
+ #
13972
+ #
13973
+ #
13974
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
13975
+ #
13976
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
13977
+ #
13978
+ # @example Request syntax with placeholder values
13979
+ #
13980
+ # resp = client.put_bucket_abac({
13981
+ # bucket: "BucketName", # required
13982
+ # content_md5: "ContentMD5",
13983
+ # checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256, CRC64NVME
13984
+ # expected_bucket_owner: "AccountId",
13985
+ # abac_status: { # required
13986
+ # status: "Enabled", # accepts Enabled, Disabled
13987
+ # },
13988
+ # })
13989
+ #
13990
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAbac AWS API Documentation
13991
+ #
13992
+ # @overload put_bucket_abac(params = {})
13993
+ # @param [Hash] params ({})
13994
+ def put_bucket_abac(params = {}, options = {})
13995
+ req = build_request(:put_bucket_abac, params)
13996
+ req.send_request(options)
13997
+ end
13998
+
13618
13999
  # <note markdown="1"> This operation is not supported for directory buckets.
13619
14000
  #
13620
14001
  # </note>
@@ -13657,6 +14038,10 @@ module Aws::S3
13657
14038
  #
13658
14039
  # * [CreateBucket][5]
13659
14040
  #
14041
+ # You must URL encode any signed header values that contain spaces. For
14042
+ # example, if your header value is `my file.txt`, containing two spaces
14043
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
14044
+ #
13660
14045
  #
13661
14046
  #
13662
14047
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -13714,19 +14099,17 @@ module Aws::S3
13714
14099
  req.send_request(options)
13715
14100
  end
13716
14101
 
13717
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
13718
- # discontinue support for creating new Email Grantee Access Control
13719
- # Lists (ACL). Email Grantee ACLs created prior to this date will
13720
- # continue to work and remain accessible through the Amazon Web Services
13721
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
13722
- # However, you will no longer be able to create new Email Grantee ACLs.
14102
+ # End of support notice: As of October 1, 2025, Amazon S3 has
14103
+ # discontinued support for Email Grantee Access Control Lists (ACLs). If
14104
+ # you attempt to use an Email Grantee ACL in a request after October 1,
14105
+ # 2025, the request will receive an `HTTP 405` (Method Not Allowed)
14106
+ # error.
13723
14107
  #
13724
14108
  # This change affects the following Amazon Web Services Regions: US
13725
14109
  # East
13726
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
13727
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
13728
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
13729
- # America (São Paulo) Region.
14110
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
14111
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
14112
+ # (Ireland), and South America (São Paulo).
13730
14113
  #
13731
14114
  # <note markdown="1"> This operation is not supported for directory buckets.
13732
14115
  #
@@ -13893,6 +14276,10 @@ module Aws::S3
13893
14276
  #
13894
14277
  # * [GetObjectAcl][9]
13895
14278
  #
14279
+ # You must URL encode any signed header values that contain spaces. For
14280
+ # example, if your header value is `my file.txt`, containing two spaces
14281
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
14282
+ #
13896
14283
  #
13897
14284
  #
13898
14285
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
@@ -14087,6 +14474,10 @@ module Aws::S3
14087
14474
  #
14088
14475
  # * [ListBucketAnalyticsConfigurations][7]
14089
14476
  #
14477
+ # You must URL encode any signed header values that contain spaces. For
14478
+ # example, if your header value is `my file.txt`, containing two spaces
14479
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
14480
+ #
14090
14481
  #
14091
14482
  #
14092
14483
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
@@ -14212,6 +14603,10 @@ module Aws::S3
14212
14603
  #
14213
14604
  # * [RESTOPTIONSobject][4]
14214
14605
  #
14606
+ # You must URL encode any signed header values that contain spaces. For
14607
+ # example, if your header value is `my file.txt`, containing two spaces
14608
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
14609
+ #
14215
14610
  #
14216
14611
  #
14217
14612
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html
@@ -14343,7 +14738,8 @@ module Aws::S3
14343
14738
  end
14344
14739
 
14345
14740
  # This operation configures default encryption and Amazon S3 Bucket Keys
14346
- # for an existing bucket.
14741
+ # for an existing bucket. You can also [block encryption types][1] using
14742
+ # this operation.
14347
14743
  #
14348
14744
  # <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
14349
14745
  # requests for this API operation to the Regional endpoint. These
@@ -14351,9 +14747,9 @@ module Aws::S3
14351
14747
  # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
14352
14748
  # Virtual-hosted-style requests aren't supported. For more information
14353
14749
  # about endpoints in Availability Zones, see [Regional and Zonal
14354
- # endpoints for directory buckets in Availability Zones][1] in the
14750
+ # endpoints for directory buckets in Availability Zones][2] in the
14355
14751
  # *Amazon S3 User Guide*. For more information about endpoints in Local
14356
- # Zones, see [Concepts for directory buckets in Local Zones][2] in the
14752
+ # Zones, see [Concepts for directory buckets in Local Zones][3] in the
14357
14753
  # *Amazon S3 User Guide*.
14358
14754
  #
14359
14755
  # </note>
@@ -14368,12 +14764,12 @@ module Aws::S3
14368
14764
  # keys (SSE-KMS) or dual-layer server-side encryption with Amazon
14369
14765
  # Web Services KMS keys (DSSE-KMS). If you specify default
14370
14766
  # encryption by using SSE-KMS, you can also configure [Amazon S3
14371
- # Bucket Keys][3]. For information about the bucket default
14372
- # encryption feature, see [Amazon S3 Bucket Default Encryption][4]
14767
+ # Bucket Keys][4]. For information about the bucket default
14768
+ # encryption feature, see [Amazon S3 Bucket Default Encryption][5]
14373
14769
  # in the *Amazon S3 User Guide*.
14374
14770
  #
14375
14771
  # * If you use PutBucketEncryption to set your [default bucket
14376
- # encryption][4] to SSE-KMS, you should verify that your KMS key ID
14772
+ # encryption][5] to SSE-KMS, you should verify that your KMS key ID
14377
14773
  # is correct. Amazon S3 doesn't validate the KMS key ID provided in
14378
14774
  # PutBucketEncryption requests.
14379
14775
  # * <b>Directory buckets </b> - You can optionally configure default
@@ -14387,28 +14783,28 @@ module Aws::S3
14387
14783
  # encrypted with the desired encryption settings. For more
14388
14784
  # information about the encryption overriding behaviors in directory
14389
14785
  # buckets, see [Specifying server-side encryption with KMS for new
14390
- # object uploads][5].
14786
+ # object uploads][6].
14391
14787
  #
14392
14788
  # * Your SSE-KMS configuration can only support 1 [customer managed
14393
- # key][6] per directory bucket's lifetime. The [Amazon Web Services
14394
- # managed key][7] (`aws/s3`) isn't supported.
14789
+ # key][7] per directory bucket's lifetime. The [Amazon Web Services
14790
+ # managed key][8] (`aws/s3`) isn't supported.
14395
14791
  #
14396
14792
  # * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
14397
14793
  # in a directory bucket and can’t be disabled. S3 Bucket Keys
14398
14794
  # aren't supported, when you copy SSE-KMS encrypted objects from
14399
14795
  # general purpose buckets to directory buckets, from directory
14400
14796
  # buckets to general purpose buckets, or between directory buckets,
14401
- # through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
14402
- # in Batch Operations][10], or [the import jobs][11]. In this case,
14797
+ # through [CopyObject][9], [UploadPartCopy][10], [the Copy operation
14798
+ # in Batch Operations][11], or [the import jobs][12]. In this case,
14403
14799
  # Amazon S3 makes a call to KMS every time a copy request is made
14404
14800
  # for a KMS-encrypted object.
14405
14801
  #
14406
- # * When you specify an [KMS customer managed key][6] for encryption
14802
+ # * When you specify an [KMS customer managed key][7] for encryption
14407
14803
  # in your directory bucket, only use the key ID or key ARN. The key
14408
14804
  # alias format of the KMS key isn't supported.
14409
14805
  #
14410
14806
  # * For directory buckets, if you use PutBucketEncryption to set your
14411
- # [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
14807
+ # [default bucket encryption][5] to SSE-KMS, Amazon S3 validates the
14412
14808
  # KMS key ID provided in PutBucketEncryption requests.
14413
14809
  #
14414
14810
  # </note>
@@ -14421,7 +14817,7 @@ module Aws::S3
14421
14817
  #
14422
14818
  # Also, this action requires Amazon Web Services Signature Version 4.
14423
14819
  # For more information, see [ Authenticating Requests (Amazon Web
14424
- # Services Signature Version 4)][12].
14820
+ # Services Signature Version 4)][13].
14425
14821
  #
14426
14822
  # Permissions
14427
14823
  # : * **General purpose bucket permissions** - The
@@ -14429,8 +14825,8 @@ module Aws::S3
14429
14825
  # policy. The bucket owner has this permission by default. The
14430
14826
  # bucket owner can grant this permission to others. For more
14431
14827
  # information about permissions, see [Permissions Related to Bucket
14432
- # Operations][13] and [Managing Access Permissions to Your Amazon S3
14433
- # Resources][14] in the *Amazon S3 User Guide*.
14828
+ # Operations][14] and [Managing Access Permissions to Your Amazon S3
14829
+ # Resources][15] in the *Amazon S3 User Guide*.
14434
14830
  #
14435
14831
  # * **Directory bucket permissions** - To grant access to this API
14436
14832
  # operation, you must have the
@@ -14440,7 +14836,7 @@ module Aws::S3
14440
14836
  # only be performed by the Amazon Web Services account that owns the
14441
14837
  # resource. For more information about directory bucket policies and
14442
14838
  # permissions, see [Amazon Web Services Identity and Access
14443
- # Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
14839
+ # Management (IAM) for S3 Express One Zone][16] in the *Amazon S3
14444
14840
  # User Guide*.
14445
14841
  #
14446
14842
  # To set a directory bucket default encryption with SSE-KMS, you
@@ -14455,29 +14851,34 @@ module Aws::S3
14455
14851
  #
14456
14852
  # The following operations are related to `PutBucketEncryption`:
14457
14853
  #
14458
- # * [GetBucketEncryption][16]
14854
+ # * [GetBucketEncryption][17]
14459
14855
  #
14460
- # * [DeleteBucketEncryption][17]
14856
+ # * [DeleteBucketEncryption][18]
14461
14857
  #
14858
+ # You must URL encode any signed header values that contain spaces. For
14859
+ # example, if your header value is `my file.txt`, containing two spaces
14860
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
14462
14861
  #
14463
14862
  #
14464
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
14465
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14466
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
14467
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
14468
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
14469
- # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
14470
- # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
14471
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
14472
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
14473
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
14474
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
14475
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
14476
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
14477
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14478
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14479
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
14480
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
14863
+ #
14864
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_BlockedEncryptionTypes.html
14865
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
14866
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
14867
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
14868
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
14869
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
14870
+ # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
14871
+ # [8]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
14872
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
14873
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
14874
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
14875
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
14876
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
14877
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
14878
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
14879
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
14880
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
14881
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
14481
14882
  #
14482
14883
  # @option params [required, String] :bucket
14483
14884
  # Specifies default encryption for a bucket using server-side encryption
@@ -14561,6 +14962,9 @@ module Aws::S3
14561
14962
  # kms_master_key_id: "SSEKMSKeyId",
14562
14963
  # },
14563
14964
  # bucket_key_enabled: false,
14965
+ # blocked_encryption_types: {
14966
+ # encryption_type: ["NONE"], # accepts NONE, SSE-C
14967
+ # },
14564
14968
  # },
14565
14969
  # ],
14566
14970
  # },
@@ -14640,6 +15044,10 @@ module Aws::S3
14640
15044
  # not have the `s3:PutIntelligentTieringConfiguration` bucket
14641
15045
  # permission to set the configuration on the bucket.
14642
15046
  #
15047
+ # You must URL encode any signed header values that contain spaces. For
15048
+ # example, if your header value is `my file.txt`, containing two spaces
15049
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15050
+ #
14643
15051
  #
14644
15052
  #
14645
15053
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access
@@ -14785,6 +15193,10 @@ module Aws::S3
14785
15193
  #
14786
15194
  # * [ListBucketInventoryConfigurations][10]
14787
15195
  #
15196
+ # You must URL encode any signed header values that contain spaces. For
15197
+ # example, if your header value is `my file.txt`, containing two spaces
15198
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15199
+ #
14788
15200
  #
14789
15201
  #
14790
15202
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
@@ -14842,7 +15254,7 @@ module Aws::S3
14842
15254
  # },
14843
15255
  # id: "InventoryId", # required
14844
15256
  # included_object_versions: "All", # required, accepts All, Current
14845
- # optional_fields: ["Size"], # accepts Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, EncryptionStatus, ObjectLockRetainUntilDate, ObjectLockMode, ObjectLockLegalHoldStatus, IntelligentTieringAccessTier, BucketKeyStatus, ChecksumAlgorithm, ObjectAccessControlList, ObjectOwner
15257
+ # optional_fields: ["Size"], # accepts Size, LastModifiedDate, StorageClass, ETag, IsMultipartUploaded, ReplicationStatus, EncryptionStatus, ObjectLockRetainUntilDate, ObjectLockMode, ObjectLockLegalHoldStatus, IntelligentTieringAccessTier, BucketKeyStatus, ChecksumAlgorithm, ObjectAccessControlList, ObjectOwner, LifecycleExpirationDate
14846
15258
  # schedule: { # required
14847
15259
  # frequency: "Daily", # required, accepts Daily, Weekly
14848
15260
  # },
@@ -14922,6 +15334,10 @@ module Aws::S3
14922
15334
  #
14923
15335
  # * [Managing Access Permissions to your Amazon S3 Resources][3]
14924
15336
  #
15337
+ # You must URL encode any signed header values that contain spaces. For
15338
+ # example, if your header value is `my file.txt`, containing two spaces
15339
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15340
+ #
14925
15341
  #
14926
15342
  #
14927
15343
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
@@ -15131,6 +15547,10 @@ module Aws::S3
15131
15547
  #
15132
15548
  # * [DeleteBucketLifecycle][10]
15133
15549
  #
15550
+ # You must URL encode any signed header values that contain spaces. For
15551
+ # example, if your header value is `my file.txt`, containing two spaces
15552
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15553
+ #
15134
15554
  #
15135
15555
  #
15136
15556
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
@@ -15308,19 +15728,17 @@ module Aws::S3
15308
15728
  req.send_request(options)
15309
15729
  end
15310
15730
 
15311
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
15312
- # discontinue support for creating new Email Grantee Access Control
15313
- # Lists (ACL). Email Grantee ACLs created prior to this date will
15314
- # continue to work and remain accessible through the Amazon Web Services
15315
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
15316
- # However, you will no longer be able to create new Email Grantee ACLs.
15731
+ # End of support notice: As of October 1, 2025, Amazon S3 has
15732
+ # discontinued support for Email Grantee Access Control Lists (ACLs). If
15733
+ # you attempt to use an Email Grantee ACL in a request after October 1,
15734
+ # 2025, the request will receive an `HTTP 405` (Method Not Allowed)
15735
+ # error.
15317
15736
  #
15318
15737
  # This change affects the following Amazon Web Services Regions: US
15319
15738
  # East
15320
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
15321
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
15322
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
15323
- # America (São Paulo) Region.
15739
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
15740
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
15741
+ # (Ireland), and South America (São Paulo).
15324
15742
  #
15325
15743
  # <note markdown="1"> This operation is not supported for directory buckets.
15326
15744
  #
@@ -15395,6 +15813,10 @@ module Aws::S3
15395
15813
  #
15396
15814
  # * [GetBucketLogging][5]
15397
15815
  #
15816
+ # You must URL encode any signed header values that contain spaces. For
15817
+ # example, if your header value is `my file.txt`, containing two spaces
15818
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15819
+ #
15398
15820
  #
15399
15821
  #
15400
15822
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
@@ -15548,6 +15970,10 @@ module Aws::S3
15548
15970
  #
15549
15971
  # * HTTP Status Code: HTTP 400 Bad Request
15550
15972
  #
15973
+ # You must URL encode any signed header values that contain spaces. For
15974
+ # example, if your header value is `my file.txt`, containing two spaces
15975
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
15976
+ #
15551
15977
  #
15552
15978
  #
15553
15979
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
@@ -15767,6 +16193,10 @@ module Aws::S3
15767
16193
  #
15768
16194
  # ^
15769
16195
  #
16196
+ # You must URL encode any signed header values that contain spaces. For
16197
+ # example, if your header value is `my file.txt`, containing two spaces
16198
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16199
+ #
15770
16200
  #
15771
16201
  #
15772
16202
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
@@ -15901,6 +16331,10 @@ module Aws::S3
15901
16331
  #
15902
16332
  # * DeleteBucketOwnershipControls
15903
16333
  #
16334
+ # You must URL encode any signed header values that contain spaces. For
16335
+ # example, if your header value is `my file.txt`, containing two spaces
16336
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16337
+ #
15904
16338
  #
15905
16339
  #
15906
16340
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html
@@ -16041,6 +16475,10 @@ module Aws::S3
16041
16475
  #
16042
16476
  # * [DeleteBucket][8]
16043
16477
  #
16478
+ # You must URL encode any signed header values that contain spaces. For
16479
+ # example, if your header value is `my file.txt`, containing two spaces
16480
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16481
+ #
16044
16482
  #
16045
16483
  #
16046
16484
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -16249,6 +16687,10 @@ module Aws::S3
16249
16687
  #
16250
16688
  # * [DeleteBucketReplication][11]
16251
16689
  #
16690
+ # You must URL encode any signed header values that contain spaces. For
16691
+ # example, if your header value is `my file.txt`, containing two spaces
16692
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16693
+ #
16252
16694
  #
16253
16695
  #
16254
16696
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
@@ -16375,7 +16817,7 @@ module Aws::S3
16375
16817
  # destination: { # required
16376
16818
  # bucket: "BucketName", # required
16377
16819
  # account: "AccountId",
16378
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
16820
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
16379
16821
  # access_control_translation: {
16380
16822
  # owner: "Destination", # required, accepts Destination
16381
16823
  # },
@@ -16430,6 +16872,10 @@ module Aws::S3
16430
16872
  #
16431
16873
  # * [GetBucketRequestPayment][3]
16432
16874
  #
16875
+ # You must URL encode any signed header values that contain spaces. For
16876
+ # example, if your header value is `my file.txt`, containing two spaces
16877
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16878
+ #
16433
16879
  #
16434
16880
  #
16435
16881
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
@@ -16515,7 +16961,11 @@ module Aws::S3
16515
16961
  #
16516
16962
  # </note>
16517
16963
  #
16518
- # Sets the tags for a bucket.
16964
+ # Sets the tags for a general purpose bucket if attribute based access
16965
+ # control (ABAC) is not enabled for the bucket. When you [enable ABAC
16966
+ # for a general purpose bucket][1], you can no longer use this operation
16967
+ # for that bucket and must use the [TagResource][2] or
16968
+ # [UntagResource][3] operations instead.
16519
16969
  #
16520
16970
  # Use tags to organize your Amazon Web Services bill to reflect your own
16521
16971
  # cost structure. To do this, sign up to get your Amazon Web Services
@@ -16525,8 +16975,8 @@ module Aws::S3
16525
16975
  # several resources with a specific application name, and then organize
16526
16976
  # your billing information to see the total cost of that application
16527
16977
  # across several services. For more information, see [Cost Allocation
16528
- # and Tagging][1] and [Using Cost Allocation in Amazon S3 Bucket
16529
- # Tags][2].
16978
+ # and Tagging][4] and [Using Cost Allocation in Amazon S3 Bucket
16979
+ # Tags][5].
16530
16980
  #
16531
16981
  # <note markdown="1"> When this operation sets the tags for a bucket, it will overwrite any
16532
16982
  # current tags the bucket already has. You cannot use this operation to
@@ -16538,16 +16988,16 @@ module Aws::S3
16538
16988
  # `s3:PutBucketTagging` action. The bucket owner has this permission by
16539
16989
  # default and can grant this permission to others. For more information
16540
16990
  # about permissions, see [Permissions Related to Bucket Subresource
16541
- # Operations][3] and [Managing Access Permissions to Your Amazon S3
16542
- # Resources][4].
16991
+ # Operations][6] and [Managing Access Permissions to Your Amazon S3
16992
+ # Resources][7].
16543
16993
  #
16544
16994
  # `PutBucketTagging` has the following special errors. For more Amazon
16545
- # S3 errors see, [Error Responses][5].
16995
+ # S3 errors see, [Error Responses][8].
16546
16996
  #
16547
16997
  # * `InvalidTag` - The tag provided was not a valid tag. This error can
16548
16998
  # occur if the tag did not pass input validation. For more
16549
16999
  # information, see [Using Cost Allocation in Amazon S3 Bucket
16550
- # Tags][2].
17000
+ # Tags][5].
16551
17001
  #
16552
17002
  # * `MalformedXML` - The XML provided does not match the schema.
16553
17003
  #
@@ -16559,19 +17009,26 @@ module Aws::S3
16559
17009
  #
16560
17010
  # The following operations are related to `PutBucketTagging`:
16561
17011
  #
16562
- # * [GetBucketTagging][6]
17012
+ # * [GetBucketTagging][9]
16563
17013
  #
16564
- # * [DeleteBucketTagging][7]
17014
+ # * [DeleteBucketTagging][10]
16565
17015
  #
17016
+ # You must URL encode any signed header values that contain spaces. For
17017
+ # example, if your header value is `my file.txt`, containing two spaces
17018
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
16566
17019
  #
16567
17020
  #
16568
- # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
16569
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html
16570
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
16571
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
16572
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
16573
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
16574
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
17021
+ #
17022
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
17023
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html
17024
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html
17025
+ # [4]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
17026
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html
17027
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
17028
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
17029
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
17030
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
17031
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
16575
17032
  #
16576
17033
  # @option params [required, String] :bucket
16577
17034
  # The bucket name.
@@ -16713,6 +17170,10 @@ module Aws::S3
16713
17170
  #
16714
17171
  # * [GetBucketVersioning][1]
16715
17172
  #
17173
+ # You must URL encode any signed header values that contain spaces. For
17174
+ # example, if your header value is `my file.txt`, containing two spaces
17175
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
17176
+ #
16716
17177
  #
16717
17178
  #
16718
17179
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
@@ -16756,6 +17217,17 @@ module Aws::S3
16756
17217
  # @option params [String] :mfa
16757
17218
  # The concatenation of the authentication device's serial number, a
16758
17219
  # space, and the value that is displayed on your authentication device.
17220
+ # The serial number is the number that uniquely identifies the MFA
17221
+ # device. For physical MFA devices, this is the unique serial number
17222
+ # that's provided with the device. For virtual MFA devices, the serial
17223
+ # number is the device ARN. For more information, see [Enabling
17224
+ # versioning on buckets][1] and [Configuring MFA delete][2] in the
17225
+ # *Amazon Simple Storage Service User Guide*.
17226
+ #
17227
+ #
17228
+ #
17229
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
17230
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
16759
17231
  #
16760
17232
  # @option params [required, Types::VersioningConfiguration] :versioning_configuration
16761
17233
  # Container for setting the versioning state.
@@ -16877,6 +17349,10 @@ module Aws::S3
16877
17349
  #
16878
17350
  # The maximum request length is limited to 128 KB.
16879
17351
  #
17352
+ # You must URL encode any signed header values that contain spaces. For
17353
+ # example, if your header value is `my file.txt`, containing two spaces
17354
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
17355
+ #
16880
17356
  #
16881
17357
  #
16882
17358
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
@@ -16987,19 +17463,17 @@ module Aws::S3
16987
17463
  req.send_request(options)
16988
17464
  end
16989
17465
 
16990
- # End of support notice: Beginning October 1, 2025, Amazon S3 will
16991
- # discontinue support for creating new Email Grantee Access Control
16992
- # Lists (ACL). Email Grantee ACLs created prior to this date will
16993
- # continue to work and remain accessible through the Amazon Web Services
16994
- # Management Console, Command Line Interface (CLI), SDKs, and REST API.
16995
- # However, you will no longer be able to create new Email Grantee ACLs.
17466
+ # End of support notice: As of October 1, 2025, Amazon S3 has
17467
+ # discontinued support for Email Grantee Access Control Lists (ACLs). If
17468
+ # you attempt to use an Email Grantee ACL in a request after October 1,
17469
+ # 2025, the request will receive an `HTTP 405` (Method Not Allowed)
17470
+ # error.
16996
17471
  #
16997
17472
  # This change affects the following Amazon Web Services Regions: US
16998
17473
  # East
16999
- # (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
17000
- # Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
17001
- # Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
17002
- # America (São Paulo) Region.
17474
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
17475
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
17476
+ # (Ireland), and South America (São Paulo).
17003
17477
  #
17004
17478
  # Adds an object to a bucket.
17005
17479
  #
@@ -17130,6 +17604,10 @@ module Aws::S3
17130
17604
  #
17131
17605
  # * [DeleteObject][10]
17132
17606
  #
17607
+ # You must URL encode any signed header values that contain spaces. For
17608
+ # example, if your header value is `my file.txt`, containing two spaces
17609
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
17610
+ #
17133
17611
  #
17134
17612
  #
17135
17613
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
@@ -17985,7 +18463,7 @@ module Aws::S3
17985
18463
  # "MetadataKey" => "MetadataValue",
17986
18464
  # },
17987
18465
  # server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
17988
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
18466
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
17989
18467
  # website_redirect_location: "WebsiteRedirectLocation",
17990
18468
  # sse_customer_algorithm: "SSECustomerAlgorithm",
17991
18469
  # sse_customer_key: "SSECustomerKey",
@@ -18030,6 +18508,18 @@ module Aws::S3
18030
18508
  req.send_request(options)
18031
18509
  end
18032
18510
 
18511
+ # End of support notice: As of October 1, 2025, Amazon S3 has
18512
+ # discontinued support for Email Grantee Access Control Lists (ACLs). If
18513
+ # you attempt to use an Email Grantee ACL in a request after October 1,
18514
+ # 2025, the request will receive an `HTTP 405` (Method Not Allowed)
18515
+ # error.
18516
+ #
18517
+ # This change affects the following Amazon Web Services Regions: US
18518
+ # East
18519
+ # (N. Virginia), US West (N. California), US West (Oregon), Asia Pacific
18520
+ # (Singapore), Asia Pacific (Sydney), Asia Pacific (Tokyo), Europe
18521
+ # (Ireland), and South America (São Paulo).
18522
+ #
18033
18523
  # <note markdown="1"> This operation is not supported for directory buckets.
18034
18524
  #
18035
18525
  # </note>
@@ -18190,6 +18680,10 @@ module Aws::S3
18190
18680
  #
18191
18681
  # * [GetObject][8]
18192
18682
  #
18683
+ # You must URL encode any signed header values that contain spaces. For
18684
+ # example, if your header value is `my file.txt`, containing two spaces
18685
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
18686
+ #
18193
18687
  #
18194
18688
  #
18195
18689
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
@@ -18414,6 +18908,10 @@ module Aws::S3
18414
18908
  #
18415
18909
  # This functionality is not supported for Amazon S3 on Outposts.
18416
18910
  #
18911
+ # You must URL encode any signed header values that contain spaces. For
18912
+ # example, if your header value is `my file.txt`, containing two spaces
18913
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
18914
+ #
18417
18915
  #
18418
18916
  #
18419
18917
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -18546,6 +19044,10 @@ module Aws::S3
18546
19044
  #
18547
19045
  # </note>
18548
19046
  #
19047
+ # You must URL encode any signed header values that contain spaces. For
19048
+ # example, if your header value is `my file.txt`, containing two spaces
19049
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19050
+ #
18549
19051
  #
18550
19052
  #
18551
19053
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -18657,6 +19159,10 @@ module Aws::S3
18657
19159
  #
18658
19160
  # This functionality is not supported for Amazon S3 on Outposts.
18659
19161
  #
19162
+ # You must URL encode any signed header values that contain spaces. For
19163
+ # example, if your header value is `my file.txt`, containing two spaces
19164
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19165
+ #
18660
19166
  #
18661
19167
  #
18662
19168
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -18821,6 +19327,10 @@ module Aws::S3
18821
19327
  #
18822
19328
  # * [DeleteObjectTagging][5]
18823
19329
  #
19330
+ # You must URL encode any signed header values that contain spaces. For
19331
+ # example, if your header value is `my file.txt`, containing two spaces
19332
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19333
+ #
18824
19334
  #
18825
19335
  #
18826
19336
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html
@@ -18897,21 +19407,9 @@ module Aws::S3
18897
19407
  # fails with the HTTP status code `403 Forbidden` (access denied).
18898
19408
  #
18899
19409
  # @option params [String] :request_payer
18900
- # Confirms that the requester knows that they will be charged for the
18901
- # request. Bucket owners need not specify this parameter in their
18902
- # requests. If either the source or destination S3 bucket has Requester
18903
- # Pays enabled, the requester will pay for corresponding charges to copy
18904
- # the object. For information about downloading objects from Requester
18905
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
18906
- # in the *Amazon S3 User Guide*.
18907
- #
18908
- # <note markdown="1"> This functionality is not supported for directory buckets.
18909
- #
18910
- # </note>
18911
- #
18912
- #
18913
- #
18914
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
19410
+ # Confirms that the requester knows that she or he will be charged for
19411
+ # the tagging object request. Bucket owners need not specify this
19412
+ # parameter in their requests.
18915
19413
  #
18916
19414
  # @return [Types::PutObjectTaggingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
18917
19415
  #
@@ -18989,10 +19487,11 @@ module Aws::S3
18989
19487
  # When Amazon S3 evaluates the `PublicAccessBlock` configuration for a
18990
19488
  # bucket or an object, it checks the `PublicAccessBlock` configuration
18991
19489
  # for both the bucket (or the bucket that contains the object) and the
18992
- # bucket owner's account. If the `PublicAccessBlock` configurations are
18993
- # different between the bucket and the account, Amazon S3 uses the most
18994
- # restrictive combination of the bucket-level and account-level
18995
- # settings.
19490
+ # bucket owner's account. Account-level settings automatically inherit
19491
+ # from organization-level policies when present. If the
19492
+ # `PublicAccessBlock` configurations are different between the bucket
19493
+ # and the account, Amazon S3 uses the most restrictive combination of
19494
+ # the bucket-level and account-level settings.
18996
19495
  #
18997
19496
  # For more information about when Amazon S3 considers a bucket or an
18998
19497
  # object public, see [The Meaning of "Public"][2].
@@ -19007,6 +19506,10 @@ module Aws::S3
19007
19506
  #
19008
19507
  # * [Using Amazon S3 Block Public Access][6]
19009
19508
  #
19509
+ # You must URL encode any signed header values that contain spaces. For
19510
+ # example, if your header value is `my file.txt`, containing two spaces
19511
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19512
+ #
19010
19513
  #
19011
19514
  #
19012
19515
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
@@ -19136,6 +19639,10 @@ module Aws::S3
19136
19639
  # : <b>Directory buckets </b> - The HTTP Host header syntax is `
19137
19640
  # Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
19138
19641
  #
19642
+ # You must URL encode any signed header values that contain spaces. For
19643
+ # example, if your header value is `my file.txt`, containing two spaces
19644
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19645
+ #
19139
19646
  #
19140
19647
  #
19141
19648
  # [1]: https://datatracker.ietf.org/doc/rfc7232/
@@ -19420,6 +19927,10 @@ module Aws::S3
19420
19927
  #
19421
19928
  # * [GetBucketNotificationConfiguration][11]
19422
19929
  #
19930
+ # You must URL encode any signed header values that contain spaces. For
19931
+ # example, if your header value is `my file.txt`, containing two spaces
19932
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
19933
+ #
19423
19934
  #
19424
19935
  #
19425
19936
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
@@ -19619,7 +20130,7 @@ module Aws::S3
19619
20130
  # value: "MetadataValue",
19620
20131
  # },
19621
20132
  # ],
19622
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
20133
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
19623
20134
  # },
19624
20135
  # },
19625
20136
  # },
@@ -19743,6 +20254,10 @@ module Aws::S3
19743
20254
  #
19744
20255
  # * [PutBucketLifecycleConfiguration][12]
19745
20256
  #
20257
+ # You must URL encode any signed header values that contain spaces. For
20258
+ # example, if your header value is `my file.txt`, containing two spaces
20259
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
20260
+ #
19746
20261
  #
19747
20262
  #
19748
20263
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
@@ -20107,6 +20622,10 @@ module Aws::S3
20107
20622
  #
20108
20623
  # * [UpdateBucketMetadataJournalTableConfiguration][6]
20109
20624
  #
20625
+ # You must URL encode any signed header values that contain spaces. For
20626
+ # example, if your header value is `my file.txt`, containing two spaces
20627
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
20628
+ #
20110
20629
  #
20111
20630
  #
20112
20631
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
@@ -20185,6 +20704,10 @@ module Aws::S3
20185
20704
  #
20186
20705
  # * [UpdateBucketMetadataInventoryTableConfiguration][6]
20187
20706
  #
20707
+ # You must URL encode any signed header values that contain spaces. For
20708
+ # example, if your header value is `my file.txt`, containing two spaces
20709
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
20710
+ #
20188
20711
  #
20189
20712
  #
20190
20713
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
@@ -20366,6 +20889,15 @@ module Aws::S3
20366
20889
  # Multipart request. For more information, see
20367
20890
  # [CreateMultipartUpload][2].
20368
20891
  #
20892
+ # <note markdown="1"> If you have server-side encryption with customer-provided keys
20893
+ # (SSE-C) blocked for your general purpose bucket, you will get an
20894
+ # HTTP 403 Access Denied error when you specify the SSE-C request
20895
+ # headers while writing new data to your bucket. For more
20896
+ # information, see [Blocking or unblocking SSE-C for a general
20897
+ # purpose bucket][12].
20898
+ #
20899
+ # </note>
20900
+ #
20369
20901
  # If you request server-side encryption using a customer-provided
20370
20902
  # encryption key (SSE-C) in your initiate multipart upload request,
20371
20903
  # you must provide identical encryption information in each part
@@ -20376,7 +20908,7 @@ module Aws::S3
20376
20908
  # * x-amz-server-side-encryption-customer-key
20377
20909
  #
20378
20910
  # * x-amz-server-side-encryption-customer-key-MD5
20379
- # For more information, see [Using Server-Side Encryption][12] in
20911
+ # For more information, see [Using Server-Side Encryption][13] in
20380
20912
  # the *Amazon S3 User Guide*.
20381
20913
  #
20382
20914
  # * <b>Directory buckets </b> - For directory buckets, there are only
@@ -20404,13 +20936,17 @@ module Aws::S3
20404
20936
  #
20405
20937
  # * [CreateMultipartUpload][2]
20406
20938
  #
20407
- # * [CompleteMultipartUpload][13]
20939
+ # * [CompleteMultipartUpload][14]
20408
20940
  #
20409
- # * [AbortMultipartUpload][14]
20941
+ # * [AbortMultipartUpload][15]
20410
20942
  #
20411
- # * [ListParts][15]
20943
+ # * [ListParts][16]
20412
20944
  #
20413
- # * [ListMultipartUploads][16]
20945
+ # * [ListMultipartUploads][17]
20946
+ #
20947
+ # You must URL encode any signed header values that contain spaces. For
20948
+ # example, if your header value is `my file.txt`, containing two spaces
20949
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
20414
20950
  #
20415
20951
  #
20416
20952
  #
@@ -20425,11 +20961,12 @@ module Aws::S3
20425
20961
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
20426
20962
  # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
20427
20963
  # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
20428
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
20429
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
20430
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
20431
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
20432
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
20964
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
20965
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
20966
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
20967
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
20968
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
20969
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
20433
20970
  #
20434
20971
  # @option params [String, StringIO, File] :body
20435
20972
  # Object data.
@@ -20828,12 +21365,21 @@ module Aws::S3
20828
21365
  # the `UploadPartCopy` operation, see [CopyObject][13] and
20829
21366
  # [UploadPart][2].
20830
21367
  #
21368
+ # <note markdown="1"> If you have server-side encryption with customer-provided keys
21369
+ # (SSE-C) blocked for your general purpose bucket, you will get an
21370
+ # HTTP 403 Access Denied error when you specify the SSE-C request
21371
+ # headers while writing new data to your bucket. For more
21372
+ # information, see [Blocking or unblocking SSE-C for a general
21373
+ # purpose bucket][14].
21374
+ #
21375
+ # </note>
21376
+ #
20831
21377
  # * <b>Directory buckets </b> - For directory buckets, there are only
20832
21378
  # two supported options for server-side encryption: server-side
20833
21379
  # encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
20834
21380
  # server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
20835
21381
  # more information, see [Protecting data with server-side
20836
- # encryption][14] in the *Amazon S3 User Guide*.
21382
+ # encryption][15] in the *Amazon S3 User Guide*.
20837
21383
  #
20838
21384
  # <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
20839
21385
  # operation and an `UploadPartCopy` operation, the request headers
@@ -20845,7 +21391,7 @@ module Aws::S3
20845
21391
  # S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
20846
21392
  # objects from general purpose buckets to directory buckets, from
20847
21393
  # directory buckets to general purpose buckets, or between directory
20848
- # buckets, through [UploadPartCopy][15]. In this case, Amazon S3
21394
+ # buckets, through [UploadPartCopy][16]. In this case, Amazon S3
20849
21395
  # makes a call to KMS every time a copy request is made for a
20850
21396
  # KMS-encrypted object.
20851
21397
  #
@@ -20871,17 +21417,21 @@ module Aws::S3
20871
21417
  #
20872
21418
  # The following operations are related to `UploadPartCopy`:
20873
21419
  #
20874
- # * [CreateMultipartUpload][16]
21420
+ # * [CreateMultipartUpload][17]
20875
21421
  #
20876
21422
  # * [UploadPart][2]
20877
21423
  #
20878
- # * [CompleteMultipartUpload][17]
21424
+ # * [CompleteMultipartUpload][18]
20879
21425
  #
20880
- # * [AbortMultipartUpload][18]
21426
+ # * [AbortMultipartUpload][19]
20881
21427
  #
20882
- # * [ListParts][19]
21428
+ # * [ListParts][20]
20883
21429
  #
20884
- # * [ListMultipartUploads][20]
21430
+ # * [ListMultipartUploads][21]
21431
+ #
21432
+ # You must URL encode any signed header values that contain spaces. For
21433
+ # example, if your header value is `my file.txt`, containing two spaces
21434
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
20885
21435
  #
20886
21436
  #
20887
21437
  #
@@ -20898,13 +21448,14 @@ module Aws::S3
20898
21448
  # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
20899
21449
  # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
20900
21450
  # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
20901
- # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
20902
- # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
20903
- # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
20904
- # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
20905
- # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
20906
- # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
20907
- # [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
21451
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/blocking-unblocking-s3-c-encryption-gpb.html
21452
+ # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
21453
+ # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
21454
+ # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
21455
+ # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
21456
+ # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
21457
+ # [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
21458
+ # [21]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
20908
21459
  #
20909
21460
  # @option params [required, String] :bucket
20910
21461
  # The bucket name.
@@ -21346,6 +21897,10 @@ module Aws::S3
21346
21897
  # Amazon Web Services built Lambda functions][3] in the *Amazon S3 User
21347
21898
  # Guide*.
21348
21899
  #
21900
+ # You must URL encode any signed header values that contain spaces. For
21901
+ # example, if your header value is `my file.txt`, containing two spaces
21902
+ # after `my`, you must URL encode this value to `my%20%20file.txt`.
21903
+ #
21349
21904
  #
21350
21905
  #
21351
21906
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
@@ -21695,7 +22250,7 @@ module Aws::S3
21695
22250
  # sse_customer_algorithm: "SSECustomerAlgorithm",
21696
22251
  # ssekms_key_id: "SSEKMSKeyId",
21697
22252
  # sse_customer_key_md5: "SSECustomerKeyMD5",
21698
- # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
22253
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS, FSX_ONTAP
21699
22254
  # tag_count: 1,
21700
22255
  # version_id: "ObjectVersionId",
21701
22256
  # bucket_key_enabled: false,
@@ -21728,7 +22283,7 @@ module Aws::S3
21728
22283
  tracer: tracer
21729
22284
  )
21730
22285
  context[:gem_name] = 'aws-sdk-s3'
21731
- context[:gem_version] = '1.193.0'
22286
+ context[:gem_version] = '1.209.0'
21732
22287
  Seahorse::Client::Request.new(handlers, context)
21733
22288
  end
21734
22289