aws-sdk-s3 1.189.1 → 1.192.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +43 -4
- data/lib/aws-sdk-s3/client.rb +535 -61
- data/lib/aws-sdk-s3/client_api.rb +46 -0
- data/lib/aws-sdk-s3/endpoints.rb +14 -0
- data/lib/aws-sdk-s3/errors.rb +11 -0
- data/lib/aws-sdk-s3/object.rb +58 -12
- data/lib/aws-sdk-s3/object_summary.rb +34 -11
- data/lib/aws-sdk-s3/resource.rb +6 -0
- data/lib/aws-sdk-s3/types.rb +406 -25
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +12 -3
- data/sig/client.rbs +63 -30
- data/sig/errors.rbs +2 -0
- data/sig/multipart_upload.rbs +1 -1
- data/sig/object.rbs +13 -10
- data/sig/object_summary.rbs +9 -9
- data/sig/resource.rbs +7 -1
- data/sig/types.rbs +60 -29
- metadata +1 -1
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -1264,7 +1264,7 @@ module Aws::S3
|
|
1264
1264
|
# resp.checksum_sha1 #=> String
|
1265
1265
|
# resp.checksum_sha256 #=> String
|
1266
1266
|
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
1267
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
1267
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
1268
1268
|
# resp.version_id #=> String
|
1269
1269
|
# resp.ssekms_key_id #=> String
|
1270
1270
|
# resp.bucket_key_enabled #=> Boolean
|
@@ -1279,6 +1279,20 @@ module Aws::S3
|
|
1279
1279
|
req.send_request(options)
|
1280
1280
|
end
|
1281
1281
|
|
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.
|
1288
|
+
#
|
1289
|
+
# This change affects the following Amazon Web Services Regions: US
|
1290
|
+
# 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.
|
1295
|
+
#
|
1282
1296
|
# Creates a copy of an object that is already stored in Amazon S3.
|
1283
1297
|
#
|
1284
1298
|
# <note markdown="1"> You can store individual objects of up to 5 TB in Amazon S3. You
|
@@ -1914,6 +1928,14 @@ module Aws::S3
|
|
1914
1928
|
# key is the same customer managed key that you specified for the
|
1915
1929
|
# directory bucket's default encryption configuration.
|
1916
1930
|
#
|
1931
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
1932
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
1933
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
1934
|
+
# systems have encryption configured by default and are encrypted at
|
1935
|
+
# rest. Data is automatically encrypted before being written to the
|
1936
|
+
# file system, and automatically decrypted as it is read. These
|
1937
|
+
# processes are handled transparently by Amazon FSx.
|
1938
|
+
#
|
1917
1939
|
#
|
1918
1940
|
#
|
1919
1941
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
@@ -2297,8 +2319,8 @@ module Aws::S3
|
|
2297
2319
|
# },
|
2298
2320
|
# metadata_directive: "COPY", # accepts COPY, REPLACE
|
2299
2321
|
# tagging_directive: "COPY", # accepts COPY, REPLACE
|
2300
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
2301
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
2322
|
+
# 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
|
2302
2324
|
# website_redirect_location: "WebsiteRedirectLocation",
|
2303
2325
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
2304
2326
|
# sse_customer_key: "SSECustomerKey",
|
@@ -2331,7 +2353,7 @@ module Aws::S3
|
|
2331
2353
|
# resp.expiration #=> String
|
2332
2354
|
# resp.copy_source_version_id #=> String
|
2333
2355
|
# resp.version_id #=> String
|
2334
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
2356
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
2335
2357
|
# resp.sse_customer_algorithm #=> String
|
2336
2358
|
# resp.sse_customer_key_md5 #=> String
|
2337
2359
|
# resp.ssekms_key_id #=> String
|
@@ -2348,6 +2370,33 @@ module Aws::S3
|
|
2348
2370
|
req.send_request(options)
|
2349
2371
|
end
|
2350
2372
|
|
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
|
+
#
|
2351
2400
|
# <note markdown="1"> This action creates an Amazon S3 bucket. To create an Amazon S3 on
|
2352
2401
|
# Outposts bucket, see [ `CreateBucket` ][1].
|
2353
2402
|
#
|
@@ -2603,6 +2652,7 @@ module Aws::S3
|
|
2603
2652
|
# @return [Types::CreateBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2604
2653
|
#
|
2605
2654
|
# * {Types::CreateBucketOutput#location #location} => String
|
2655
|
+
# * {Types::CreateBucketOutput#bucket_arn #bucket_arn} => String
|
2606
2656
|
#
|
2607
2657
|
#
|
2608
2658
|
# @example Example: To create a bucket in a specific region
|
@@ -2649,6 +2699,12 @@ module Aws::S3
|
|
2649
2699
|
# data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
|
2650
2700
|
# type: "Directory", # accepts Directory
|
2651
2701
|
# },
|
2702
|
+
# tags: [
|
2703
|
+
# {
|
2704
|
+
# key: "ObjectKey", # required
|
2705
|
+
# value: "Value", # required
|
2706
|
+
# },
|
2707
|
+
# ],
|
2652
2708
|
# },
|
2653
2709
|
# grant_full_control: "GrantFullControl",
|
2654
2710
|
# grant_read: "GrantRead",
|
@@ -2662,6 +2718,7 @@ module Aws::S3
|
|
2662
2718
|
# @example Response structure
|
2663
2719
|
#
|
2664
2720
|
# resp.location #=> String
|
2721
|
+
# resp.bucket_arn #=> String
|
2665
2722
|
#
|
2666
2723
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucket AWS API Documentation
|
2667
2724
|
#
|
@@ -2756,6 +2813,20 @@ module Aws::S3
|
|
2756
2813
|
req.send_request(options)
|
2757
2814
|
end
|
2758
2815
|
|
2816
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will
|
2817
|
+
# discontinue support for creating new Email Grantee Access Control
|
2818
|
+
# Lists (ACL). Email Grantee ACLs created prior to this date will
|
2819
|
+
# continue to work and remain accessible through the Amazon Web Services
|
2820
|
+
# Management Console, Command Line Interface (CLI), SDKs, and REST API.
|
2821
|
+
# However, you will no longer be able to create new Email Grantee ACLs.
|
2822
|
+
#
|
2823
|
+
# This change affects the following Amazon Web Services Regions: US
|
2824
|
+
# East
|
2825
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
2826
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
2827
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
2828
|
+
# America (São Paulo) Region.
|
2829
|
+
#
|
2759
2830
|
# This action initiates a multipart upload and returns an upload ID.
|
2760
2831
|
# This upload ID is used to associate all of the parts in the specific
|
2761
2832
|
# multipart upload. You specify this upload ID in each of your
|
@@ -3372,7 +3443,7 @@ module Aws::S3
|
|
3372
3443
|
#
|
3373
3444
|
# @option params [String] :server_side_encryption
|
3374
3445
|
# The server-side encryption algorithm used when you store this object
|
3375
|
-
# in Amazon S3
|
3446
|
+
# in Amazon S3 or Amazon FSx.
|
3376
3447
|
#
|
3377
3448
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
3378
3449
|
# two supported options for server-side encryption: server-side
|
@@ -3414,6 +3485,14 @@ module Aws::S3
|
|
3414
3485
|
#
|
3415
3486
|
# </note>
|
3416
3487
|
#
|
3488
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
3489
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
3490
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
3491
|
+
# systems have encryption configured by default and are encrypted at
|
3492
|
+
# rest. Data is automatically encrypted before being written to the
|
3493
|
+
# file system, and automatically decrypted as it is read. These
|
3494
|
+
# processes are handled transparently by Amazon FSx.
|
3495
|
+
#
|
3417
3496
|
#
|
3418
3497
|
#
|
3419
3498
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
@@ -3671,8 +3750,8 @@ module Aws::S3
|
|
3671
3750
|
# metadata: {
|
3672
3751
|
# "MetadataKey" => "MetadataValue",
|
3673
3752
|
# },
|
3674
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
3675
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
3753
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
3754
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
3676
3755
|
# website_redirect_location: "WebsiteRedirectLocation",
|
3677
3756
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
3678
3757
|
# sse_customer_key: "SSECustomerKey",
|
@@ -3697,7 +3776,7 @@ module Aws::S3
|
|
3697
3776
|
# resp.bucket #=> String
|
3698
3777
|
# resp.key #=> String
|
3699
3778
|
# resp.upload_id #=> String
|
3700
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
3779
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
3701
3780
|
# resp.sse_customer_algorithm #=> String
|
3702
3781
|
# resp.sse_customer_key_md5 #=> String
|
3703
3782
|
# resp.ssekms_key_id #=> String
|
@@ -3904,6 +3983,14 @@ module Aws::S3
|
|
3904
3983
|
# SSE-S3. For more information, see [Protecting data with server-side
|
3905
3984
|
# encryption][1] in the *Amazon S3 User Guide*.
|
3906
3985
|
#
|
3986
|
+
# <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
3987
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
3988
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
3989
|
+
# systems have encryption configured by default and are encrypted at
|
3990
|
+
# rest. Data is automatically encrypted before being written to the file
|
3991
|
+
# system, and automatically decrypted as it is read. These processes are
|
3992
|
+
# handled transparently by Amazon FSx.
|
3993
|
+
#
|
3907
3994
|
#
|
3908
3995
|
#
|
3909
3996
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
|
@@ -3984,7 +4071,7 @@ module Aws::S3
|
|
3984
4071
|
# resp = client.create_session({
|
3985
4072
|
# session_mode: "ReadOnly", # accepts ReadOnly, ReadWrite
|
3986
4073
|
# bucket: "BucketName", # required
|
3987
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
4074
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
3988
4075
|
# ssekms_key_id: "SSEKMSKeyId",
|
3989
4076
|
# ssekms_encryption_context: "SSEKMSEncryptionContext",
|
3990
4077
|
# bucket_key_enabled: false,
|
@@ -3992,7 +4079,7 @@ module Aws::S3
|
|
3992
4079
|
#
|
3993
4080
|
# @example Response structure
|
3994
4081
|
#
|
3995
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
4082
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
3996
4083
|
# resp.ssekms_key_id #=> String
|
3997
4084
|
# resp.ssekms_encryption_context #=> String
|
3998
4085
|
# resp.bucket_key_enabled #=> Boolean
|
@@ -4400,6 +4487,11 @@ module Aws::S3
|
|
4400
4487
|
# @option params [required, String] :id
|
4401
4488
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
4402
4489
|
#
|
4490
|
+
# @option params [String] :expected_bucket_owner
|
4491
|
+
# The account ID of the expected bucket owner. If the account ID that
|
4492
|
+
# you provide does not match the actual owner of the bucket, the request
|
4493
|
+
# fails with the HTTP status code `403 Forbidden` (access denied).
|
4494
|
+
#
|
4403
4495
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
4404
4496
|
#
|
4405
4497
|
# @example Request syntax with placeholder values
|
@@ -4407,6 +4499,7 @@ module Aws::S3
|
|
4407
4499
|
# resp = client.delete_bucket_intelligent_tiering_configuration({
|
4408
4500
|
# bucket: "BucketName", # required
|
4409
4501
|
# id: "IntelligentTieringId", # required
|
4502
|
+
# expected_bucket_owner: "AccountId",
|
4410
4503
|
# })
|
4411
4504
|
#
|
4412
4505
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketIntelligentTieringConfiguration AWS API Documentation
|
@@ -6067,6 +6160,19 @@ module Aws::S3
|
|
6067
6160
|
req.send_request(options)
|
6068
6161
|
end
|
6069
6162
|
|
6163
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
6164
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
6165
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
6166
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
6167
|
+
# naming) as a direct replacement of `DisplayName`.
|
6168
|
+
#
|
6169
|
+
# This change affects the following Amazon Web Services Regions: US
|
6170
|
+
# East
|
6171
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
6172
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
6173
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
6174
|
+
# America (São Paulo) Region.
|
6175
|
+
#
|
6070
6176
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
6071
6177
|
#
|
6072
6178
|
# </note>
|
@@ -6470,7 +6576,7 @@ module Aws::S3
|
|
6470
6576
|
# @example Response structure
|
6471
6577
|
#
|
6472
6578
|
# resp.server_side_encryption_configuration.rules #=> Array
|
6473
|
-
# resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.sse_algorithm #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
6579
|
+
# 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"
|
6474
6580
|
# resp.server_side_encryption_configuration.rules[0].apply_server_side_encryption_by_default.kms_master_key_id #=> String
|
6475
6581
|
# resp.server_side_encryption_configuration.rules[0].bucket_key_enabled #=> Boolean
|
6476
6582
|
#
|
@@ -6532,6 +6638,11 @@ module Aws::S3
|
|
6532
6638
|
# @option params [required, String] :id
|
6533
6639
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
6534
6640
|
#
|
6641
|
+
# @option params [String] :expected_bucket_owner
|
6642
|
+
# The account ID of the expected bucket owner. If the account ID that
|
6643
|
+
# you provide does not match the actual owner of the bucket, the request
|
6644
|
+
# fails with the HTTP status code `403 Forbidden` (access denied).
|
6645
|
+
#
|
6535
6646
|
# @return [Types::GetBucketIntelligentTieringConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6536
6647
|
#
|
6537
6648
|
# * {Types::GetBucketIntelligentTieringConfigurationOutput#intelligent_tiering_configuration #intelligent_tiering_configuration} => Types::IntelligentTieringConfiguration
|
@@ -6541,6 +6652,7 @@ module Aws::S3
|
|
6541
6652
|
# resp = client.get_bucket_intelligent_tiering_configuration({
|
6542
6653
|
# bucket: "BucketName", # required
|
6543
6654
|
# id: "IntelligentTieringId", # required
|
6655
|
+
# expected_bucket_owner: "AccountId",
|
6544
6656
|
# })
|
6545
6657
|
#
|
6546
6658
|
# @example Response structure
|
@@ -7051,6 +7163,19 @@ module Aws::S3
|
|
7051
7163
|
req.send_request(options)
|
7052
7164
|
end
|
7053
7165
|
|
7166
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
7167
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
7168
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
7169
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
7170
|
+
# naming) as a direct replacement of `DisplayName`.
|
7171
|
+
#
|
7172
|
+
# This change affects the following Amazon Web Services Regions: US
|
7173
|
+
# East
|
7174
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
7175
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
7176
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
7177
|
+
# America (São Paulo) Region.
|
7178
|
+
#
|
7054
7179
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
7055
7180
|
#
|
7056
7181
|
# </note>
|
@@ -7514,6 +7639,21 @@ module Aws::S3
|
|
7514
7639
|
# permission. For more information about Amazon S3 permissions, see
|
7515
7640
|
# [Specifying permissions in a policy][1].
|
7516
7641
|
#
|
7642
|
+
# <note markdown="1"> A bucket doesn't have `OwnershipControls` settings in the following
|
7643
|
+
# cases:
|
7644
|
+
#
|
7645
|
+
# * The bucket was created before the `BucketOwnerEnforced` ownership
|
7646
|
+
# setting was introduced and you've never explicitly applied this
|
7647
|
+
# value
|
7648
|
+
#
|
7649
|
+
# * You've manually deleted the bucket ownership control value using
|
7650
|
+
# the `DeleteBucketOwnershipControls` API operation.
|
7651
|
+
#
|
7652
|
+
# By default, Amazon S3 sets `OwnershipControls` for all newly created
|
7653
|
+
# buckets.
|
7654
|
+
#
|
7655
|
+
# </note>
|
7656
|
+
#
|
7517
7657
|
# For information about Amazon S3 Object Ownership, see [Using Object
|
7518
7658
|
# Ownership][2].
|
7519
7659
|
#
|
@@ -7897,7 +8037,7 @@ module Aws::S3
|
|
7897
8037
|
# resp.replication_configuration.rules[0].existing_object_replication.status #=> String, one of "Enabled", "Disabled"
|
7898
8038
|
# resp.replication_configuration.rules[0].destination.bucket #=> String
|
7899
8039
|
# resp.replication_configuration.rules[0].destination.account #=> String
|
7900
|
-
# 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"
|
8040
|
+
# 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"
|
7901
8041
|
# resp.replication_configuration.rules[0].destination.access_control_translation.owner #=> String, one of "Destination"
|
7902
8042
|
# resp.replication_configuration.rules[0].destination.encryption_configuration.replica_kms_key_id #=> String
|
7903
8043
|
# resp.replication_configuration.rules[0].destination.replication_time.status #=> String, one of "Enabled", "Disabled"
|
@@ -8879,14 +9019,14 @@ module Aws::S3
|
|
8879
9019
|
# resp.expires #=> Time
|
8880
9020
|
# resp.expires_string #=> String
|
8881
9021
|
# resp.website_redirect_location #=> String
|
8882
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
9022
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
8883
9023
|
# resp.metadata #=> Hash
|
8884
9024
|
# resp.metadata["MetadataKey"] #=> String
|
8885
9025
|
# resp.sse_customer_algorithm #=> String
|
8886
9026
|
# resp.sse_customer_key_md5 #=> String
|
8887
9027
|
# resp.ssekms_key_id #=> String
|
8888
9028
|
# resp.bucket_key_enabled #=> Boolean
|
8889
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
9029
|
+
# 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"
|
8890
9030
|
# resp.request_charged #=> String, one of "requester"
|
8891
9031
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
|
8892
9032
|
# resp.parts_count #=> Integer
|
@@ -9465,7 +9605,7 @@ module Aws::S3
|
|
9465
9605
|
# resp.object_parts.parts[0].checksum_crc64nvme #=> String
|
9466
9606
|
# resp.object_parts.parts[0].checksum_sha1 #=> String
|
9467
9607
|
# resp.object_parts.parts[0].checksum_sha256 #=> String
|
9468
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
9608
|
+
# 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"
|
9469
9609
|
# resp.object_size #=> Integer
|
9470
9610
|
#
|
9471
9611
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributes AWS API Documentation
|
@@ -10232,6 +10372,7 @@ module Aws::S3
|
|
10232
10372
|
#
|
10233
10373
|
# @return [Types::HeadBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
10234
10374
|
#
|
10375
|
+
# * {Types::HeadBucketOutput#bucket_arn #bucket_arn} => String
|
10235
10376
|
# * {Types::HeadBucketOutput#bucket_location_type #bucket_location_type} => String
|
10236
10377
|
# * {Types::HeadBucketOutput#bucket_location_name #bucket_location_name} => String
|
10237
10378
|
# * {Types::HeadBucketOutput#bucket_region #bucket_region} => String
|
@@ -10255,6 +10396,7 @@ module Aws::S3
|
|
10255
10396
|
#
|
10256
10397
|
# @example Response structure
|
10257
10398
|
#
|
10399
|
+
# resp.bucket_arn #=> String
|
10258
10400
|
# resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
|
10259
10401
|
# resp.bucket_location_name #=> String
|
10260
10402
|
# resp.bucket_region #=> String
|
@@ -10700,6 +10842,7 @@ module Aws::S3
|
|
10700
10842
|
# * {Types::HeadObjectOutput#request_charged #request_charged} => String
|
10701
10843
|
# * {Types::HeadObjectOutput#replication_status #replication_status} => String
|
10702
10844
|
# * {Types::HeadObjectOutput#parts_count #parts_count} => Integer
|
10845
|
+
# * {Types::HeadObjectOutput#tag_count #tag_count} => Integer
|
10703
10846
|
# * {Types::HeadObjectOutput#object_lock_mode #object_lock_mode} => String
|
10704
10847
|
# * {Types::HeadObjectOutput#object_lock_retain_until_date #object_lock_retain_until_date} => Time
|
10705
10848
|
# * {Types::HeadObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
@@ -10779,17 +10922,18 @@ module Aws::S3
|
|
10779
10922
|
# resp.expires #=> Time
|
10780
10923
|
# resp.expires_string #=> String
|
10781
10924
|
# resp.website_redirect_location #=> String
|
10782
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
10925
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
10783
10926
|
# resp.metadata #=> Hash
|
10784
10927
|
# resp.metadata["MetadataKey"] #=> String
|
10785
10928
|
# resp.sse_customer_algorithm #=> String
|
10786
10929
|
# resp.sse_customer_key_md5 #=> String
|
10787
10930
|
# resp.ssekms_key_id #=> String
|
10788
10931
|
# resp.bucket_key_enabled #=> Boolean
|
10789
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
10932
|
+
# 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"
|
10790
10933
|
# resp.request_charged #=> String, one of "requester"
|
10791
10934
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA", "COMPLETED"
|
10792
10935
|
# resp.parts_count #=> Integer
|
10936
|
+
# resp.tag_count #=> Integer
|
10793
10937
|
# resp.object_lock_mode #=> String, one of "GOVERNANCE", "COMPLIANCE"
|
10794
10938
|
# resp.object_lock_retain_until_date #=> Time
|
10795
10939
|
# resp.object_lock_legal_hold_status #=> String, one of "ON", "OFF"
|
@@ -10960,6 +11104,11 @@ module Aws::S3
|
|
10960
11104
|
# The `ContinuationToken` that represents a placeholder from where this
|
10961
11105
|
# request should begin.
|
10962
11106
|
#
|
11107
|
+
# @option params [String] :expected_bucket_owner
|
11108
|
+
# The account ID of the expected bucket owner. If the account ID that
|
11109
|
+
# you provide does not match the actual owner of the bucket, the request
|
11110
|
+
# fails with the HTTP status code `403 Forbidden` (access denied).
|
11111
|
+
#
|
10963
11112
|
# @return [Types::ListBucketIntelligentTieringConfigurationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
10964
11113
|
#
|
10965
11114
|
# * {Types::ListBucketIntelligentTieringConfigurationsOutput#is_truncated #is_truncated} => Boolean
|
@@ -10972,6 +11121,7 @@ module Aws::S3
|
|
10972
11121
|
# resp = client.list_bucket_intelligent_tiering_configurations({
|
10973
11122
|
# bucket: "BucketName", # required
|
10974
11123
|
# continuation_token: "Token",
|
11124
|
+
# expected_bucket_owner: "AccountId",
|
10975
11125
|
# })
|
10976
11126
|
#
|
10977
11127
|
# @example Response structure
|
@@ -11206,6 +11356,19 @@ module Aws::S3
|
|
11206
11356
|
req.send_request(options)
|
11207
11357
|
end
|
11208
11358
|
|
11359
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
11360
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
11361
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
11362
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
11363
|
+
# naming) as a direct replacement of `DisplayName`.
|
11364
|
+
#
|
11365
|
+
# This change affects the following Amazon Web Services Regions: US
|
11366
|
+
# East
|
11367
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
11368
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
11369
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
11370
|
+
# America (São Paulo) Region.
|
11371
|
+
#
|
11209
11372
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
11210
11373
|
#
|
11211
11374
|
# </note>
|
@@ -11330,6 +11493,7 @@ module Aws::S3
|
|
11330
11493
|
# resp.buckets[0].name #=> String
|
11331
11494
|
# resp.buckets[0].creation_date #=> Time
|
11332
11495
|
# resp.buckets[0].bucket_region #=> String
|
11496
|
+
# resp.buckets[0].bucket_arn #=> String
|
11333
11497
|
# resp.owner.display_name #=> String
|
11334
11498
|
# resp.owner.id #=> String
|
11335
11499
|
# resp.continuation_token #=> String
|
@@ -11421,6 +11585,7 @@ module Aws::S3
|
|
11421
11585
|
# resp.buckets[0].name #=> String
|
11422
11586
|
# resp.buckets[0].creation_date #=> Time
|
11423
11587
|
# resp.buckets[0].bucket_region #=> String
|
11588
|
+
# resp.buckets[0].bucket_arn #=> String
|
11424
11589
|
# resp.continuation_token #=> String
|
11425
11590
|
#
|
11426
11591
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListDirectoryBuckets AWS API Documentation
|
@@ -11432,6 +11597,19 @@ module Aws::S3
|
|
11432
11597
|
req.send_request(options)
|
11433
11598
|
end
|
11434
11599
|
|
11600
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
11601
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
11602
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
11603
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
11604
|
+
# naming) as a direct replacement of `DisplayName`.
|
11605
|
+
#
|
11606
|
+
# This change affects the following Amazon Web Services Regions: US
|
11607
|
+
# East
|
11608
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
11609
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
11610
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
11611
|
+
# America (São Paulo) Region.
|
11612
|
+
#
|
11435
11613
|
# This operation lists in-progress multipart uploads in a bucket. An
|
11436
11614
|
# in-progress multipart upload is a multipart upload that has been
|
11437
11615
|
# initiated by the `CreateMultipartUpload` request, but has not yet been
|
@@ -11608,6 +11786,9 @@ module Aws::S3
|
|
11608
11786
|
# beginning of the key. The keys that are grouped under `CommonPrefixes`
|
11609
11787
|
# result element are not returned elsewhere in the response.
|
11610
11788
|
#
|
11789
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11790
|
+
# lexicographically greater than the key-marker.
|
11791
|
+
#
|
11611
11792
|
# <note markdown="1"> **Directory buckets** - For directory buckets, `/` is the only
|
11612
11793
|
# supported delimiter.
|
11613
11794
|
#
|
@@ -11857,7 +12038,7 @@ module Aws::S3
|
|
11857
12038
|
# resp.uploads[0].upload_id #=> String
|
11858
12039
|
# resp.uploads[0].key #=> String
|
11859
12040
|
# resp.uploads[0].initiated #=> Time
|
11860
|
-
# 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"
|
12041
|
+
# 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"
|
11861
12042
|
# resp.uploads[0].owner.display_name #=> String
|
11862
12043
|
# resp.uploads[0].owner.id #=> String
|
11863
12044
|
# resp.uploads[0].initiator.id #=> String
|
@@ -11878,6 +12059,19 @@ module Aws::S3
|
|
11878
12059
|
req.send_request(options)
|
11879
12060
|
end
|
11880
12061
|
|
12062
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
12063
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
12064
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
12065
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
12066
|
+
# naming) as a direct replacement of `DisplayName`.
|
12067
|
+
#
|
12068
|
+
# This change affects the following Amazon Web Services Regions: US
|
12069
|
+
# East
|
12070
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
12071
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
12072
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
12073
|
+
# America (São Paulo) Region.
|
12074
|
+
#
|
11881
12075
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
11882
12076
|
#
|
11883
12077
|
# </note>
|
@@ -11925,6 +12119,9 @@ module Aws::S3
|
|
11925
12119
|
# the `max-keys` limitation. These keys are not returned elsewhere in
|
11926
12120
|
# the response.
|
11927
12121
|
#
|
12122
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
12123
|
+
# lexicographically greater than the key-marker.
|
12124
|
+
#
|
11928
12125
|
# @option params [String] :encoding_type
|
11929
12126
|
# Encoding type used by Amazon S3 to encode the [object keys][1] in the
|
11930
12127
|
# response. Responses are encoded only in UTF-8. An object key can
|
@@ -12118,6 +12315,19 @@ module Aws::S3
|
|
12118
12315
|
req.send_request(options)
|
12119
12316
|
end
|
12120
12317
|
|
12318
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
12319
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
12320
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
12321
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
12322
|
+
# naming) as a direct replacement of `DisplayName`.
|
12323
|
+
#
|
12324
|
+
# This change affects the following Amazon Web Services Regions: US
|
12325
|
+
# East
|
12326
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
12327
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
12328
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
12329
|
+
# America (São Paulo) Region.
|
12330
|
+
#
|
12121
12331
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
12122
12332
|
#
|
12123
12333
|
# </note>
|
@@ -12200,6 +12410,9 @@ module Aws::S3
|
|
12200
12410
|
# @option params [String] :delimiter
|
12201
12411
|
# A delimiter is a character that you use to group keys.
|
12202
12412
|
#
|
12413
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
12414
|
+
# lexicographically greater than the key-marker.
|
12415
|
+
#
|
12203
12416
|
# @option params [String] :encoding_type
|
12204
12417
|
# Encoding type used by Amazon S3 to encode the [object keys][1] in the
|
12205
12418
|
# response. Responses are encoded only in UTF-8. An object key can
|
@@ -12331,7 +12544,7 @@ module Aws::S3
|
|
12331
12544
|
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12332
12545
|
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
12333
12546
|
# resp.contents[0].size #=> Integer
|
12334
|
-
# 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"
|
12547
|
+
# 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"
|
12335
12548
|
# resp.contents[0].owner.display_name #=> String
|
12336
12549
|
# resp.contents[0].owner.id #=> String
|
12337
12550
|
# resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
|
@@ -12494,6 +12707,9 @@ module Aws::S3
|
|
12494
12707
|
# @option params [String] :delimiter
|
12495
12708
|
# A delimiter is a character that you use to group keys.
|
12496
12709
|
#
|
12710
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
12711
|
+
# lexicographically greater than the `StartAfter` value.
|
12712
|
+
#
|
12497
12713
|
# <note markdown="1"> * **Directory buckets** - For directory buckets, `/` is the only
|
12498
12714
|
# supported delimiter.
|
12499
12715
|
#
|
@@ -12674,7 +12890,7 @@ module Aws::S3
|
|
12674
12890
|
# resp.contents[0].checksum_algorithm[0] #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
12675
12891
|
# resp.contents[0].checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
12676
12892
|
# resp.contents[0].size #=> Integer
|
12677
|
-
# 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"
|
12893
|
+
# 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"
|
12678
12894
|
# resp.contents[0].owner.display_name #=> String
|
12679
12895
|
# resp.contents[0].owner.id #=> String
|
12680
12896
|
# resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
|
@@ -12701,6 +12917,19 @@ module Aws::S3
|
|
12701
12917
|
req.send_request(options)
|
12702
12918
|
end
|
12703
12919
|
|
12920
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
12921
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
12922
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
12923
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
12924
|
+
# naming) as a direct replacement of `DisplayName`.
|
12925
|
+
#
|
12926
|
+
# This change affects the following Amazon Web Services Regions: US
|
12927
|
+
# East
|
12928
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
12929
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
12930
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
12931
|
+
# America (São Paulo) Region.
|
12932
|
+
#
|
12704
12933
|
# Lists the parts that have been uploaded for a specific multipart
|
12705
12934
|
# upload.
|
12706
12935
|
#
|
@@ -13016,7 +13245,7 @@ module Aws::S3
|
|
13016
13245
|
# resp.initiator.display_name #=> String
|
13017
13246
|
# resp.owner.display_name #=> String
|
13018
13247
|
# resp.owner.id #=> String
|
13019
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW", "EXPRESS_ONEZONE"
|
13248
|
+
# 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"
|
13020
13249
|
# resp.request_charged #=> String, one of "requester"
|
13021
13250
|
# resp.checksum_algorithm #=> String, one of "CRC32", "CRC32C", "SHA1", "SHA256", "CRC64NVME"
|
13022
13251
|
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
@@ -13129,6 +13358,20 @@ module Aws::S3
|
|
13129
13358
|
req.send_request(options)
|
13130
13359
|
end
|
13131
13360
|
|
13361
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will
|
13362
|
+
# discontinue support for creating new Email Grantee Access Control
|
13363
|
+
# Lists (ACL). Email Grantee ACLs created prior to this date will
|
13364
|
+
# continue to work and remain accessible through the Amazon Web Services
|
13365
|
+
# Management Console, Command Line Interface (CLI), SDKs, and REST API.
|
13366
|
+
# However, you will no longer be able to create new Email Grantee ACLs.
|
13367
|
+
#
|
13368
|
+
# This change affects the following Amazon Web Services Regions: US
|
13369
|
+
# East
|
13370
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
13371
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
13372
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
13373
|
+
# America (São Paulo) Region.
|
13374
|
+
#
|
13132
13375
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
13133
13376
|
#
|
13134
13377
|
# </note>
|
@@ -13235,7 +13478,10 @@ module Aws::S3
|
|
13235
13478
|
# Grantee Values
|
13236
13479
|
#
|
13237
13480
|
# : You can specify the person (grantee) to whom you're assigning
|
13238
|
-
# access rights (using request elements) in the following ways
|
13481
|
+
# access rights (using request elements) in the following ways. For
|
13482
|
+
# examples of how to specify these grantee values in JSON format, see
|
13483
|
+
# the Amazon Web Services CLI example in [ Enabling Amazon S3 server
|
13484
|
+
# access logging][6] in the *Amazon S3 User Guide*.
|
13239
13485
|
#
|
13240
13486
|
# * By the person's ID:
|
13241
13487
|
#
|
@@ -13285,11 +13531,11 @@ module Aws::S3
|
|
13285
13531
|
#
|
13286
13532
|
# The following operations are related to `PutBucketAcl`:
|
13287
13533
|
#
|
13288
|
-
# * [CreateBucket][
|
13534
|
+
# * [CreateBucket][7]
|
13289
13535
|
#
|
13290
|
-
# * [DeleteBucket][
|
13536
|
+
# * [DeleteBucket][8]
|
13291
13537
|
#
|
13292
|
-
# * [GetObjectAcl][
|
13538
|
+
# * [GetObjectAcl][9]
|
13293
13539
|
#
|
13294
13540
|
#
|
13295
13541
|
#
|
@@ -13298,9 +13544,10 @@ module Aws::S3
|
|
13298
13544
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
13299
13545
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
13300
13546
|
# [5]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
13301
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
13302
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
13303
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
13547
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html
|
13548
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
13549
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
13550
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
13304
13551
|
#
|
13305
13552
|
# @option params [String] :acl
|
13306
13553
|
# The canned ACL to apply to the bucket.
|
@@ -13954,7 +14201,7 @@ module Aws::S3
|
|
13954
14201
|
# rules: [ # required
|
13955
14202
|
# {
|
13956
14203
|
# apply_server_side_encryption_by_default: {
|
13957
|
-
# sse_algorithm: "AES256", # required, accepts AES256, aws:kms, aws:kms:dsse
|
14204
|
+
# sse_algorithm: "AES256", # required, accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
13958
14205
|
# kms_master_key_id: "SSEKMSKeyId",
|
13959
14206
|
# },
|
13960
14207
|
# bucket_key_enabled: false,
|
@@ -14051,6 +14298,11 @@ module Aws::S3
|
|
14051
14298
|
# @option params [required, String] :id
|
14052
14299
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
14053
14300
|
#
|
14301
|
+
# @option params [String] :expected_bucket_owner
|
14302
|
+
# The account ID of the expected bucket owner. If the account ID that
|
14303
|
+
# you provide does not match the actual owner of the bucket, the request
|
14304
|
+
# fails with the HTTP status code `403 Forbidden` (access denied).
|
14305
|
+
#
|
14054
14306
|
# @option params [required, Types::IntelligentTieringConfiguration] :intelligent_tiering_configuration
|
14055
14307
|
# Container for S3 Intelligent-Tiering configuration.
|
14056
14308
|
#
|
@@ -14061,6 +14313,7 @@ module Aws::S3
|
|
14061
14313
|
# resp = client.put_bucket_intelligent_tiering_configuration({
|
14062
14314
|
# bucket: "BucketName", # required
|
14063
14315
|
# id: "IntelligentTieringId", # required
|
14316
|
+
# expected_bucket_owner: "AccountId",
|
14064
14317
|
# intelligent_tiering_configuration: { # required
|
14065
14318
|
# id: "IntelligentTieringId", # required
|
14066
14319
|
# filter: {
|
@@ -14699,6 +14952,20 @@ module Aws::S3
|
|
14699
14952
|
req.send_request(options)
|
14700
14953
|
end
|
14701
14954
|
|
14955
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will
|
14956
|
+
# discontinue support for creating new Email Grantee Access Control
|
14957
|
+
# Lists (ACL). Email Grantee ACLs created prior to this date will
|
14958
|
+
# continue to work and remain accessible through the Amazon Web Services
|
14959
|
+
# Management Console, Command Line Interface (CLI), SDKs, and REST API.
|
14960
|
+
# However, you will no longer be able to create new Email Grantee ACLs.
|
14961
|
+
#
|
14962
|
+
# This change affects the following Amazon Web Services Regions: US
|
14963
|
+
# East
|
14964
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
14965
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
14966
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
14967
|
+
# America (São Paulo) Region.
|
14968
|
+
#
|
14702
14969
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
14703
14970
|
#
|
14704
14971
|
# </note>
|
@@ -14722,7 +14989,10 @@ module Aws::S3
|
|
14722
14989
|
# Grantee Values
|
14723
14990
|
#
|
14724
14991
|
# : You can specify the person (grantee) to whom you're assigning
|
14725
|
-
# access rights (by using request elements) in the following ways
|
14992
|
+
# access rights (by using request elements) in the following ways. For
|
14993
|
+
# examples of how to specify these grantee values in JSON format, see
|
14994
|
+
# the Amazon Web Services CLI example in [ Enabling Amazon S3 server
|
14995
|
+
# access logging][2] in the *Amazon S3 User Guide*.
|
14726
14996
|
#
|
14727
14997
|
# * By the person's ID:
|
14728
14998
|
#
|
@@ -14753,30 +15023,31 @@ module Aws::S3
|
|
14753
15023
|
# />`
|
14754
15024
|
#
|
14755
15025
|
# For more information about server access logging, see [Server Access
|
14756
|
-
# Logging][
|
15026
|
+
# Logging][3] in the *Amazon S3 User Guide*.
|
14757
15027
|
#
|
14758
|
-
# For more information about creating a bucket, see [CreateBucket][
|
15028
|
+
# For more information about creating a bucket, see [CreateBucket][4].
|
14759
15029
|
# For more information about returning the logging status of a bucket,
|
14760
|
-
# see [GetBucketLogging][
|
15030
|
+
# see [GetBucketLogging][5].
|
14761
15031
|
#
|
14762
15032
|
# The following operations are related to `PutBucketLogging`:
|
14763
15033
|
#
|
14764
|
-
# * [PutObject][
|
15034
|
+
# * [PutObject][6]
|
14765
15035
|
#
|
14766
|
-
# * [DeleteBucket][
|
15036
|
+
# * [DeleteBucket][7]
|
14767
15037
|
#
|
14768
|
-
# * [CreateBucket][
|
15038
|
+
# * [CreateBucket][4]
|
14769
15039
|
#
|
14770
|
-
# * [GetBucketLogging][
|
15040
|
+
# * [GetBucketLogging][5]
|
14771
15041
|
#
|
14772
15042
|
#
|
14773
15043
|
#
|
14774
15044
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
|
14775
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
14776
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14777
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
14778
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
14779
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
15045
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html
|
15046
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html
|
15047
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
15048
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html
|
15049
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
15050
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
14780
15051
|
#
|
14781
15052
|
# @option params [required, String] :bucket
|
14782
15053
|
# The name of the bucket for which to set the logging parameters.
|
@@ -15748,7 +16019,7 @@ module Aws::S3
|
|
15748
16019
|
# destination: { # required
|
15749
16020
|
# bucket: "BucketName", # required
|
15750
16021
|
# account: "AccountId",
|
15751
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
16022
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
15752
16023
|
# access_control_translation: {
|
15753
16024
|
# owner: "Destination", # required, accepts Destination
|
15754
16025
|
# },
|
@@ -16360,6 +16631,20 @@ module Aws::S3
|
|
16360
16631
|
req.send_request(options)
|
16361
16632
|
end
|
16362
16633
|
|
16634
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will
|
16635
|
+
# discontinue support for creating new Email Grantee Access Control
|
16636
|
+
# Lists (ACL). Email Grantee ACLs created prior to this date will
|
16637
|
+
# continue to work and remain accessible through the Amazon Web Services
|
16638
|
+
# Management Console, Command Line Interface (CLI), SDKs, and REST API.
|
16639
|
+
# However, you will no longer be able to create new Email Grantee ACLs.
|
16640
|
+
#
|
16641
|
+
# This change affects the following Amazon Web Services Regions: US
|
16642
|
+
# East
|
16643
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
16644
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
16645
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
16646
|
+
# America (São Paulo) Region.
|
16647
|
+
#
|
16363
16648
|
# Adds an object to a bucket.
|
16364
16649
|
#
|
16365
16650
|
# <note markdown="1"> * Amazon S3 never adds partial objects; if you receive a success
|
@@ -16868,8 +17153,7 @@ module Aws::S3
|
|
16868
17153
|
#
|
16869
17154
|
# @option params [String] :server_side_encryption
|
16870
17155
|
# The server-side encryption algorithm that was used when you store this
|
16871
|
-
# object in Amazon S3
|
16872
|
-
# `aws:kms:dsse`).
|
17156
|
+
# object in Amazon S3 or Amazon FSx.
|
16873
17157
|
#
|
16874
17158
|
# * <b>General purpose buckets </b> - You have four mutually exclusive
|
16875
17159
|
# options to protect data using server-side encryption in Amazon S3,
|
@@ -16923,6 +17207,14 @@ module Aws::S3
|
|
16923
17207
|
#
|
16924
17208
|
# </note>
|
16925
17209
|
#
|
17210
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
17211
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
17212
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
17213
|
+
# systems have encryption configured by default and are encrypted at
|
17214
|
+
# rest. Data is automatically encrypted before being written to the
|
17215
|
+
# file system, and automatically decrypted as it is read. These
|
17216
|
+
# processes are handled transparently by Amazon FSx.
|
17217
|
+
#
|
16926
17218
|
#
|
16927
17219
|
#
|
16928
17220
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
@@ -17336,8 +17628,8 @@ module Aws::S3
|
|
17336
17628
|
# metadata: {
|
17337
17629
|
# "MetadataKey" => "MetadataValue",
|
17338
17630
|
# },
|
17339
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
17340
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
17631
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
17632
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
17341
17633
|
# website_redirect_location: "WebsiteRedirectLocation",
|
17342
17634
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
17343
17635
|
# sse_customer_key: "SSECustomerKey",
|
@@ -17363,7 +17655,7 @@ module Aws::S3
|
|
17363
17655
|
# resp.checksum_sha1 #=> String
|
17364
17656
|
# resp.checksum_sha256 #=> String
|
17365
17657
|
# resp.checksum_type #=> String, one of "COMPOSITE", "FULL_OBJECT"
|
17366
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
17658
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
17367
17659
|
# resp.version_id #=> String
|
17368
17660
|
# resp.sse_customer_algorithm #=> String
|
17369
17661
|
# resp.sse_customer_key_md5 #=> String
|
@@ -17479,7 +17771,10 @@ module Aws::S3
|
|
17479
17771
|
# Grantee Values
|
17480
17772
|
#
|
17481
17773
|
# : You can specify the person (grantee) to whom you're assigning
|
17482
|
-
# access rights (using request elements) in the following ways
|
17774
|
+
# access rights (using request elements) in the following ways. For
|
17775
|
+
# examples of how to specify these grantee values in JSON format, see
|
17776
|
+
# the Amazon Web Services CLI example in [ Enabling Amazon S3 server
|
17777
|
+
# access logging][6] in the *Amazon S3 User Guide*.
|
17483
17778
|
#
|
17484
17779
|
# * By the person's ID:
|
17485
17780
|
#
|
@@ -17535,9 +17830,9 @@ module Aws::S3
|
|
17535
17830
|
#
|
17536
17831
|
# The following operations are related to `PutObjectAcl`:
|
17537
17832
|
#
|
17538
|
-
# * [CopyObject][
|
17833
|
+
# * [CopyObject][7]
|
17539
17834
|
#
|
17540
|
-
# * [GetObject][
|
17835
|
+
# * [GetObject][8]
|
17541
17836
|
#
|
17542
17837
|
#
|
17543
17838
|
#
|
@@ -17546,8 +17841,9 @@ module Aws::S3
|
|
17546
17841
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
17547
17842
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
17548
17843
|
# [5]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
17549
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
17550
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
17844
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html
|
17845
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
17846
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
17551
17847
|
#
|
17552
17848
|
# @option params [String] :acl
|
17553
17849
|
# The canned ACL to apply to the object. For more information, see
|
@@ -18433,6 +18729,179 @@ module Aws::S3
|
|
18433
18729
|
req.send_request(options)
|
18434
18730
|
end
|
18435
18731
|
|
18732
|
+
# Renames an existing object in a directory bucket that uses the S3
|
18733
|
+
# Express One Zone storage class. You can use `RenameObject` by
|
18734
|
+
# specifying an existing object’s name as the source and the new name of
|
18735
|
+
# the object as the destination within the same directory bucket.
|
18736
|
+
#
|
18737
|
+
# <note markdown="1"> `RenameObject` is only supported for objects stored in the S3 Express
|
18738
|
+
# One Zone storage class.
|
18739
|
+
#
|
18740
|
+
# </note>
|
18741
|
+
#
|
18742
|
+
# To prevent overwriting an object, you can use the `If-None-Match`
|
18743
|
+
# conditional header.
|
18744
|
+
#
|
18745
|
+
# * **If-None-Match** - Renames the object only if an object with the
|
18746
|
+
# specified name does not already exist in the directory bucket. If
|
18747
|
+
# you don't want to overwrite an existing object, you can add the
|
18748
|
+
# `If-None-Match` conditional header with the value `‘*’` in the
|
18749
|
+
# `RenameObject` request. Amazon S3 then returns a `412 Precondition
|
18750
|
+
# Failed` error if the object with the specified name already exists.
|
18751
|
+
# For more information, see [RFC 7232][1].
|
18752
|
+
#
|
18753
|
+
# ^
|
18754
|
+
#
|
18755
|
+
# Permissions
|
18756
|
+
#
|
18757
|
+
# : To grant access to the `RenameObject` operation on a directory
|
18758
|
+
# bucket, we recommend that you use the `CreateSession` operation for
|
18759
|
+
# session-based authorization. Specifically, you grant the
|
18760
|
+
# `s3express:CreateSession` permission to the directory bucket in a
|
18761
|
+
# bucket policy or an IAM identity-based policy. Then, you make the
|
18762
|
+
# `CreateSession` API call on the directory bucket to obtain a session
|
18763
|
+
# token. With the session token in your request header, you can make
|
18764
|
+
# API requests to this operation. After the session token expires, you
|
18765
|
+
# make another `CreateSession` API call to generate a new session
|
18766
|
+
# token for use. The Amazon Web Services CLI and SDKs will create and
|
18767
|
+
# manage your session including refreshing the session token
|
18768
|
+
# automatically to avoid service interruptions when a session expires.
|
18769
|
+
# In your bucket policy, you can specify the `s3express:SessionMode`
|
18770
|
+
# condition key to control who can create a `ReadWrite` or `ReadOnly`
|
18771
|
+
# session. A `ReadWrite` session is required for executing all the
|
18772
|
+
# Zonal endpoint API operations, including `RenameObject`. For more
|
18773
|
+
# information about authorization, see [ `CreateSession` ][2]. To
|
18774
|
+
# learn more about Zonal endpoint API operations, see [Authorizing
|
18775
|
+
# Zonal endpoint API operations with CreateSession][3] in the *Amazon
|
18776
|
+
# S3 User Guide*.
|
18777
|
+
#
|
18778
|
+
# HTTP Host header syntax
|
18779
|
+
#
|
18780
|
+
# : <b>Directory buckets </b> - The HTTP Host header syntax is `
|
18781
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
18782
|
+
#
|
18783
|
+
#
|
18784
|
+
#
|
18785
|
+
# [1]: https://datatracker.ietf.org/doc/rfc7232/
|
18786
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
|
18787
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-create-session.html
|
18788
|
+
#
|
18789
|
+
# @option params [required, String] :bucket
|
18790
|
+
# The bucket name of the directory bucket containing the object.
|
18791
|
+
#
|
18792
|
+
# You must use virtual-hosted-style requests in the format
|
18793
|
+
# `Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
18794
|
+
# requests are not supported. Directory bucket names must be unique in
|
18795
|
+
# the chosen Availability Zone. Bucket names must follow the format
|
18796
|
+
# `bucket-base-name--zone-id--x-s3 ` (for example,
|
18797
|
+
# `amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
18798
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
18799
|
+
# *Amazon S3 User Guide*.
|
18800
|
+
#
|
18801
|
+
#
|
18802
|
+
#
|
18803
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
|
18804
|
+
#
|
18805
|
+
# @option params [required, String] :key
|
18806
|
+
# Key name of the object to rename.
|
18807
|
+
#
|
18808
|
+
# @option params [required, String] :rename_source
|
18809
|
+
# Specifies the source for the rename operation. The value must be URL
|
18810
|
+
# encoded.
|
18811
|
+
#
|
18812
|
+
# @option params [String] :destination_if_match
|
18813
|
+
# Renames the object only if the ETag (entity tag) value provided during
|
18814
|
+
# the operation matches the ETag of the object in S3. The `If-Match`
|
18815
|
+
# header field makes the request method conditional on ETags. If the
|
18816
|
+
# ETag values do not match, the operation returns a `412 Precondition
|
18817
|
+
# Failed` error.
|
18818
|
+
#
|
18819
|
+
# Expects the ETag value as a string.
|
18820
|
+
#
|
18821
|
+
# @option params [String] :destination_if_none_match
|
18822
|
+
# Renames the object only if the destination does not already exist in
|
18823
|
+
# the specified directory bucket. If the object does exist when you send
|
18824
|
+
# a request with `If-None-Match:*`, the S3 API will return a `412
|
18825
|
+
# Precondition Failed` error, preventing an overwrite. The
|
18826
|
+
# `If-None-Match` header prevents overwrites of existing data by
|
18827
|
+
# validating that there's not an object with the same key name already
|
18828
|
+
# in your directory bucket.
|
18829
|
+
#
|
18830
|
+
# Expects the `*` character (asterisk).
|
18831
|
+
#
|
18832
|
+
# @option params [Time,DateTime,Date,Integer,String] :destination_if_modified_since
|
18833
|
+
# Renames the object if the destination exists and if it has been
|
18834
|
+
# modified since the specified time.
|
18835
|
+
#
|
18836
|
+
# @option params [Time,DateTime,Date,Integer,String] :destination_if_unmodified_since
|
18837
|
+
# Renames the object if it hasn't been modified since the specified
|
18838
|
+
# time.
|
18839
|
+
#
|
18840
|
+
# @option params [String] :source_if_match
|
18841
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
18842
|
+
# matches the specified ETag.
|
18843
|
+
#
|
18844
|
+
# @option params [String] :source_if_none_match
|
18845
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
18846
|
+
# is different than the specified ETag. If an asterisk (`*`) character
|
18847
|
+
# is provided, the operation will fail and return a `412 Precondition
|
18848
|
+
# Failed` error.
|
18849
|
+
#
|
18850
|
+
# @option params [Time,DateTime,Date,Integer,String] :source_if_modified_since
|
18851
|
+
# Renames the object if the source exists and if it has been modified
|
18852
|
+
# since the specified time.
|
18853
|
+
#
|
18854
|
+
# @option params [Time,DateTime,Date,Integer,String] :source_if_unmodified_since
|
18855
|
+
# Renames the object if the source exists and hasn't been modified
|
18856
|
+
# since the specified time.
|
18857
|
+
#
|
18858
|
+
# @option params [String] :client_token
|
18859
|
+
# A unique string with a max of 64 ASCII characters in the ASCII range
|
18860
|
+
# of 33 - 126.
|
18861
|
+
#
|
18862
|
+
# <note markdown="1"> `RenameObject` supports idempotency using a client token. To make an
|
18863
|
+
# idempotent API request using `RenameObject`, specify a client token in
|
18864
|
+
# the request. You should not reuse the same client token for other API
|
18865
|
+
# requests. If you retry a request that completed successfully using the
|
18866
|
+
# same client token and the same parameters, the retry succeeds without
|
18867
|
+
# performing any further actions. If you retry a successful request
|
18868
|
+
# using the same client token, but one or more of the parameters are
|
18869
|
+
# different, the retry fails and an `IdempotentParameterMismatch` error
|
18870
|
+
# is returned.
|
18871
|
+
#
|
18872
|
+
# </note>
|
18873
|
+
#
|
18874
|
+
# **A suitable default value is auto-generated.** You should normally
|
18875
|
+
# not need to pass this option.**
|
18876
|
+
#
|
18877
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
18878
|
+
#
|
18879
|
+
# @example Request syntax with placeholder values
|
18880
|
+
#
|
18881
|
+
# resp = client.rename_object({
|
18882
|
+
# bucket: "BucketName", # required
|
18883
|
+
# key: "ObjectKey", # required
|
18884
|
+
# rename_source: "RenameSource", # required
|
18885
|
+
# destination_if_match: "IfMatch",
|
18886
|
+
# destination_if_none_match: "IfNoneMatch",
|
18887
|
+
# destination_if_modified_since: Time.now,
|
18888
|
+
# destination_if_unmodified_since: Time.now,
|
18889
|
+
# source_if_match: "RenameSourceIfMatch",
|
18890
|
+
# source_if_none_match: "RenameSourceIfNoneMatch",
|
18891
|
+
# source_if_modified_since: Time.now,
|
18892
|
+
# source_if_unmodified_since: Time.now,
|
18893
|
+
# client_token: "ClientToken",
|
18894
|
+
# })
|
18895
|
+
#
|
18896
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObject AWS API Documentation
|
18897
|
+
#
|
18898
|
+
# @overload rename_object(params = {})
|
18899
|
+
# @param [Hash] params ({})
|
18900
|
+
def rename_object(params = {}, options = {})
|
18901
|
+
req = build_request(:rename_object, params)
|
18902
|
+
req.send_request(options)
|
18903
|
+
end
|
18904
|
+
|
18436
18905
|
# <note markdown="1"> This operation is not supported for directory buckets.
|
18437
18906
|
#
|
18438
18907
|
# </note>
|
@@ -18763,7 +19232,7 @@ module Aws::S3
|
|
18763
19232
|
# bucket_name: "BucketName", # required
|
18764
19233
|
# prefix: "LocationPrefix", # required
|
18765
19234
|
# encryption: {
|
18766
|
-
# encryption_type: "AES256", # required, accepts AES256, aws:kms, aws:kms:dsse
|
19235
|
+
# encryption_type: "AES256", # required, accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
18767
19236
|
# kms_key_id: "SSEKMSKeyId",
|
18768
19237
|
# kms_context: "KMSContext",
|
18769
19238
|
# },
|
@@ -18794,7 +19263,7 @@ module Aws::S3
|
|
18794
19263
|
# value: "MetadataValue",
|
18795
19264
|
# },
|
18796
19265
|
# ],
|
18797
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
19266
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
18798
19267
|
# },
|
18799
19268
|
# },
|
18800
19269
|
# },
|
@@ -19687,7 +20156,7 @@ module Aws::S3
|
|
19687
20156
|
#
|
19688
20157
|
# @example Response structure
|
19689
20158
|
#
|
19690
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
20159
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
19691
20160
|
# resp.etag #=> String
|
19692
20161
|
# resp.checksum_crc32 #=> String
|
19693
20162
|
# resp.checksum_crc32c #=> String
|
@@ -20274,7 +20743,7 @@ module Aws::S3
|
|
20274
20743
|
# resp.copy_part_result.checksum_crc64nvme #=> String
|
20275
20744
|
# resp.copy_part_result.checksum_sha1 #=> String
|
20276
20745
|
# resp.copy_part_result.checksum_sha256 #=> String
|
20277
|
-
# resp.server_side_encryption #=> String, one of "AES256", "aws:kms", "aws:kms:dsse"
|
20746
|
+
# resp.server_side_encryption #=> String, one of "AES256", "aws:fsx", "aws:kms", "aws:kms:dsse"
|
20278
20747
|
# resp.sse_customer_algorithm #=> String
|
20279
20748
|
# resp.sse_customer_key_md5 #=> String
|
20280
20749
|
# resp.ssekms_key_id #=> String
|
@@ -20601,7 +21070,12 @@ module Aws::S3
|
|
20601
21070
|
#
|
20602
21071
|
# @option params [String] :server_side_encryption
|
20603
21072
|
# The server-side encryption algorithm used when storing requested
|
20604
|
-
# object in Amazon S3
|
21073
|
+
# object in Amazon S3 or Amazon FSx.
|
21074
|
+
#
|
21075
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3 access
|
21076
|
+
# points, the only valid server side encryption option is `aws:fsx`.
|
21077
|
+
#
|
21078
|
+
# </note>
|
20605
21079
|
#
|
20606
21080
|
# @option params [String] :sse_customer_algorithm
|
20607
21081
|
# Encryption algorithm used if server-side encryption with a
|
@@ -20685,11 +21159,11 @@ module Aws::S3
|
|
20685
21159
|
# replication_status: "COMPLETE", # accepts COMPLETE, PENDING, FAILED, REPLICA, COMPLETED
|
20686
21160
|
# request_charged: "requester", # accepts requester
|
20687
21161
|
# restore: "Restore",
|
20688
|
-
# server_side_encryption: "AES256", # accepts AES256, aws:kms, aws:kms:dsse
|
21162
|
+
# server_side_encryption: "AES256", # accepts AES256, aws:fsx, aws:kms, aws:kms:dsse
|
20689
21163
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
20690
21164
|
# ssekms_key_id: "SSEKMSKeyId",
|
20691
21165
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
20692
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE
|
21166
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR, SNOW, EXPRESS_ONEZONE, FSX_OPENZFS
|
20693
21167
|
# tag_count: 1,
|
20694
21168
|
# version_id: "ObjectVersionId",
|
20695
21169
|
# bucket_key_enabled: false,
|
@@ -20722,7 +21196,7 @@ module Aws::S3
|
|
20722
21196
|
tracer: tracer
|
20723
21197
|
)
|
20724
21198
|
context[:gem_name] = 'aws-sdk-s3'
|
20725
|
-
context[:gem_version] = '1.
|
21199
|
+
context[:gem_version] = '1.192.0'
|
20726
21200
|
Seahorse::Client::Request.new(handlers, context)
|
20727
21201
|
end
|
20728
21202
|
|