aws-sdk-s3 1.189.0 → 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 +20 -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/legacy_signer.rb +2 -1
- data/lib/aws-sdk-s3/object.rb +58 -12
- data/lib/aws-sdk-s3/object_multipart_copier.rb +2 -1
- data/lib/aws-sdk-s3/object_summary.rb +34 -11
- data/lib/aws-sdk-s3/plugins/url_encoded_keys.rb +2 -1
- 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/types.rb
CHANGED
@@ -372,12 +372,28 @@ module Aws::S3
|
|
372
372
|
# parameter, it is included in the response.
|
373
373
|
# @return [String]
|
374
374
|
#
|
375
|
+
# @!attribute [rw] bucket_arn
|
376
|
+
# The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
|
377
|
+
# identify Amazon Web Services resources across all of Amazon Web
|
378
|
+
# Services.
|
379
|
+
#
|
380
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
381
|
+
# information, see [Using tags with directory buckets][1].
|
382
|
+
#
|
383
|
+
# </note>
|
384
|
+
#
|
385
|
+
#
|
386
|
+
#
|
387
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
388
|
+
# @return [String]
|
389
|
+
#
|
375
390
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Bucket AWS API Documentation
|
376
391
|
#
|
377
392
|
class Bucket < Struct.new(
|
378
393
|
:name,
|
379
394
|
:creation_date,
|
380
|
-
:bucket_region
|
395
|
+
:bucket_region,
|
396
|
+
:bucket_arn)
|
381
397
|
SENSITIVE = []
|
382
398
|
include Aws::Structure
|
383
399
|
end
|
@@ -945,7 +961,13 @@ module Aws::S3
|
|
945
961
|
#
|
946
962
|
# @!attribute [rw] server_side_encryption
|
947
963
|
# The server-side encryption algorithm used when storing this object
|
948
|
-
# in Amazon S3
|
964
|
+
# in Amazon S3.
|
965
|
+
#
|
966
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
967
|
+
# access points, the only valid server side encryption option is
|
968
|
+
# `aws:fsx`.
|
969
|
+
#
|
970
|
+
# </note>
|
949
971
|
# @return [String]
|
950
972
|
#
|
951
973
|
# @!attribute [rw] version_id
|
@@ -1481,7 +1503,13 @@ module Aws::S3
|
|
1481
1503
|
#
|
1482
1504
|
# @!attribute [rw] server_side_encryption
|
1483
1505
|
# The server-side encryption algorithm used when you store this object
|
1484
|
-
# in Amazon S3
|
1506
|
+
# in Amazon S3 or Amazon FSx.
|
1507
|
+
#
|
1508
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
1509
|
+
# access points, the only valid server side encryption option is
|
1510
|
+
# `aws:fsx`.
|
1511
|
+
#
|
1512
|
+
# </note>
|
1485
1513
|
# @return [String]
|
1486
1514
|
#
|
1487
1515
|
# @!attribute [rw] sse_customer_algorithm
|
@@ -2038,6 +2066,14 @@ module Aws::S3
|
|
2038
2066
|
# key is the same customer managed key that you specified for the
|
2039
2067
|
# directory bucket's default encryption configuration.
|
2040
2068
|
#
|
2069
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data
|
2070
|
+
# stored in Amazon FSx file systems using S3 access points, the only
|
2071
|
+
# valid server side encryption option is `aws:fsx`. All Amazon FSx
|
2072
|
+
# file systems have encryption configured by default and are
|
2073
|
+
# encrypted at rest. Data is automatically encrypted before being
|
2074
|
+
# written to the file system, and automatically decrypted as it is
|
2075
|
+
# read. These processes are handled transparently by Amazon FSx.
|
2076
|
+
#
|
2041
2077
|
#
|
2042
2078
|
#
|
2043
2079
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
@@ -2661,12 +2697,28 @@ module Aws::S3
|
|
2661
2697
|
# </note>
|
2662
2698
|
# @return [Types::BucketInfo]
|
2663
2699
|
#
|
2700
|
+
# @!attribute [rw] tags
|
2701
|
+
# An array of tags that you can apply to the bucket that you're
|
2702
|
+
# creating. Tags are key-value pairs of metadata used to categorize
|
2703
|
+
# and organize your buckets, track costs, and control access.
|
2704
|
+
#
|
2705
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
2706
|
+
# information, see [Using tags with directory buckets][1].
|
2707
|
+
#
|
2708
|
+
# </note>
|
2709
|
+
#
|
2710
|
+
#
|
2711
|
+
#
|
2712
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
2713
|
+
# @return [Array<Types::Tag>]
|
2714
|
+
#
|
2664
2715
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketConfiguration AWS API Documentation
|
2665
2716
|
#
|
2666
2717
|
class CreateBucketConfiguration < Struct.new(
|
2667
2718
|
:location_constraint,
|
2668
2719
|
:location,
|
2669
|
-
:bucket
|
2720
|
+
:bucket,
|
2721
|
+
:tags)
|
2670
2722
|
SENSITIVE = []
|
2671
2723
|
include Aws::Structure
|
2672
2724
|
end
|
@@ -2710,10 +2762,26 @@ module Aws::S3
|
|
2710
2762
|
# A forward slash followed by the name of the bucket.
|
2711
2763
|
# @return [String]
|
2712
2764
|
#
|
2765
|
+
# @!attribute [rw] bucket_arn
|
2766
|
+
# The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
|
2767
|
+
# identify Amazon Web Services resources across all of Amazon Web
|
2768
|
+
# Services.
|
2769
|
+
#
|
2770
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
2771
|
+
# information, see [Using tags with directory buckets][1].
|
2772
|
+
#
|
2773
|
+
# </note>
|
2774
|
+
#
|
2775
|
+
#
|
2776
|
+
#
|
2777
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
2778
|
+
# @return [String]
|
2779
|
+
#
|
2713
2780
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketOutput AWS API Documentation
|
2714
2781
|
#
|
2715
2782
|
class CreateBucketOutput < Struct.new(
|
2716
|
-
:location
|
2783
|
+
:location,
|
2784
|
+
:bucket_arn)
|
2717
2785
|
SENSITIVE = []
|
2718
2786
|
include Aws::Structure
|
2719
2787
|
end
|
@@ -2912,7 +2980,13 @@ module Aws::S3
|
|
2912
2980
|
#
|
2913
2981
|
# @!attribute [rw] server_side_encryption
|
2914
2982
|
# The server-side encryption algorithm used when you store this object
|
2915
|
-
# in Amazon S3
|
2983
|
+
# in Amazon S3 or Amazon FSx.
|
2984
|
+
#
|
2985
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
2986
|
+
# access points, the only valid server side encryption option is
|
2987
|
+
# `aws:fsx`.
|
2988
|
+
#
|
2989
|
+
# </note>
|
2916
2990
|
# @return [String]
|
2917
2991
|
#
|
2918
2992
|
# @!attribute [rw] sse_customer_algorithm
|
@@ -3380,7 +3454,7 @@ module Aws::S3
|
|
3380
3454
|
#
|
3381
3455
|
# @!attribute [rw] server_side_encryption
|
3382
3456
|
# The server-side encryption algorithm used when you store this object
|
3383
|
-
# in Amazon S3
|
3457
|
+
# in Amazon S3 or Amazon FSx.
|
3384
3458
|
#
|
3385
3459
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
3386
3460
|
# two supported options for server-side encryption: server-side
|
@@ -3423,6 +3497,14 @@ module Aws::S3
|
|
3423
3497
|
#
|
3424
3498
|
# </note>
|
3425
3499
|
#
|
3500
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data
|
3501
|
+
# stored in Amazon FSx file systems using S3 access points, the only
|
3502
|
+
# valid server side encryption option is `aws:fsx`. All Amazon FSx
|
3503
|
+
# file systems have encryption configured by default and are
|
3504
|
+
# encrypted at rest. Data is automatically encrypted before being
|
3505
|
+
# written to the file system, and automatically decrypted as it is
|
3506
|
+
# read. These processes are handled transparently by Amazon FSx.
|
3507
|
+
#
|
3426
3508
|
#
|
3427
3509
|
#
|
3428
3510
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
@@ -3689,6 +3771,12 @@ module Aws::S3
|
|
3689
3771
|
# @!attribute [rw] server_side_encryption
|
3690
3772
|
# The server-side encryption algorithm used when you store objects in
|
3691
3773
|
# the directory bucket.
|
3774
|
+
#
|
3775
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
3776
|
+
# access points, the only valid server side encryption option is
|
3777
|
+
# `aws:fsx`.
|
3778
|
+
#
|
3779
|
+
# </note>
|
3692
3780
|
# @return [String]
|
3693
3781
|
#
|
3694
3782
|
# @!attribute [rw] ssekms_key_id
|
@@ -3753,6 +3841,14 @@ module Aws::S3
|
|
3753
3841
|
# SSE-S3. For more information, see [Protecting data with server-side
|
3754
3842
|
# encryption][1] in the *Amazon S3 User Guide*.
|
3755
3843
|
#
|
3844
|
+
# <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
3845
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
3846
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
3847
|
+
# systems have encryption configured by default and are encrypted at
|
3848
|
+
# rest. Data is automatically encrypted before being written to the
|
3849
|
+
# file system, and automatically decrypted as it is read. These
|
3850
|
+
# processes are handled transparently by Amazon FSx.
|
3851
|
+
#
|
3756
3852
|
#
|
3757
3853
|
#
|
3758
3854
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
|
@@ -4000,11 +4096,19 @@ module Aws::S3
|
|
4000
4096
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
4001
4097
|
# @return [String]
|
4002
4098
|
#
|
4099
|
+
# @!attribute [rw] expected_bucket_owner
|
4100
|
+
# The account ID of the expected bucket owner. If the account ID that
|
4101
|
+
# you provide does not match the actual owner of the bucket, the
|
4102
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
4103
|
+
# denied).
|
4104
|
+
# @return [String]
|
4105
|
+
#
|
4003
4106
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketIntelligentTieringConfigurationRequest AWS API Documentation
|
4004
4107
|
#
|
4005
4108
|
class DeleteBucketIntelligentTieringConfigurationRequest < Struct.new(
|
4006
4109
|
:bucket,
|
4007
|
-
:id
|
4110
|
+
:id,
|
4111
|
+
:expected_bucket_owner)
|
4008
4112
|
SENSITIVE = []
|
4009
4113
|
include Aws::Structure
|
4010
4114
|
end
|
@@ -4938,6 +5042,8 @@ module Aws::S3
|
|
4938
5042
|
# For valid values, see the `StorageClass` element of the [PUT Bucket
|
4939
5043
|
# replication][1] action in the *Amazon S3 API Reference*.
|
4940
5044
|
#
|
5045
|
+
# `FSX_OPENZFS` is not an accepted value when replicating objects.
|
5046
|
+
#
|
4941
5047
|
#
|
4942
5048
|
#
|
4943
5049
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html
|
@@ -6292,11 +6398,19 @@ module Aws::S3
|
|
6292
6398
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
6293
6399
|
# @return [String]
|
6294
6400
|
#
|
6401
|
+
# @!attribute [rw] expected_bucket_owner
|
6402
|
+
# The account ID of the expected bucket owner. If the account ID that
|
6403
|
+
# you provide does not match the actual owner of the bucket, the
|
6404
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
6405
|
+
# denied).
|
6406
|
+
# @return [String]
|
6407
|
+
#
|
6295
6408
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketIntelligentTieringConfigurationRequest AWS API Documentation
|
6296
6409
|
#
|
6297
6410
|
class GetBucketIntelligentTieringConfigurationRequest < Struct.new(
|
6298
6411
|
:bucket,
|
6299
|
-
:id
|
6412
|
+
:id,
|
6413
|
+
:expected_bucket_owner)
|
6300
6414
|
SENSITIVE = []
|
6301
6415
|
include Aws::Structure
|
6302
6416
|
end
|
@@ -7222,15 +7336,15 @@ module Aws::S3
|
|
7222
7336
|
# A container for elements related to a particular part. A response
|
7223
7337
|
# can contain zero or more `Parts` elements.
|
7224
7338
|
#
|
7225
|
-
# <note markdown="1"> * **General purpose buckets** - For `GetObjectAttributes`, if
|
7339
|
+
# <note markdown="1"> * **General purpose buckets** - For `GetObjectAttributes`, if an
|
7226
7340
|
# additional checksum (including `x-amz-checksum-crc32`,
|
7227
7341
|
# `x-amz-checksum-crc32c`, `x-amz-checksum-sha1`, or
|
7228
7342
|
# `x-amz-checksum-sha256`) isn't applied to the object specified in
|
7229
|
-
# the request, the response doesn't return `Part
|
7343
|
+
# the request, the response doesn't return the `Part` element.
|
7230
7344
|
#
|
7231
|
-
# * **Directory buckets** - For `GetObjectAttributes`,
|
7232
|
-
# whether
|
7233
|
-
# in the request, the response returns `Part
|
7345
|
+
# * **Directory buckets** - For `GetObjectAttributes`, regardless of
|
7346
|
+
# whether an additional checksum is applied to the object specified
|
7347
|
+
# in the request, the response returns the `Part` element.
|
7234
7348
|
#
|
7235
7349
|
# </note>
|
7236
7350
|
# @return [Array<Types::ObjectPart>]
|
@@ -7747,7 +7861,13 @@ module Aws::S3
|
|
7747
7861
|
#
|
7748
7862
|
# @!attribute [rw] server_side_encryption
|
7749
7863
|
# The server-side encryption algorithm used when you store this object
|
7750
|
-
# in Amazon S3.
|
7864
|
+
# in Amazon S3 or Amazon FSx.
|
7865
|
+
#
|
7866
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
7867
|
+
# access points, the only valid server side encryption option is
|
7868
|
+
# `aws:fsx`.
|
7869
|
+
#
|
7870
|
+
# </note>
|
7751
7871
|
# @return [String]
|
7752
7872
|
#
|
7753
7873
|
# @!attribute [rw] metadata
|
@@ -8646,6 +8766,21 @@ module Aws::S3
|
|
8646
8766
|
include Aws::Structure
|
8647
8767
|
end
|
8648
8768
|
|
8769
|
+
# @!attribute [rw] bucket_arn
|
8770
|
+
# The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
|
8771
|
+
# identify Amazon Web Services resources across all of Amazon Web
|
8772
|
+
# Services.
|
8773
|
+
#
|
8774
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
8775
|
+
# information, see [Using tags with directory buckets][1].
|
8776
|
+
#
|
8777
|
+
# </note>
|
8778
|
+
#
|
8779
|
+
#
|
8780
|
+
#
|
8781
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
8782
|
+
# @return [String]
|
8783
|
+
#
|
8649
8784
|
# @!attribute [rw] bucket_location_type
|
8650
8785
|
# The type of location where the bucket is created.
|
8651
8786
|
#
|
@@ -8682,6 +8817,7 @@ module Aws::S3
|
|
8682
8817
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucketOutput AWS API Documentation
|
8683
8818
|
#
|
8684
8819
|
class HeadBucketOutput < Struct.new(
|
8820
|
+
:bucket_arn,
|
8685
8821
|
:bucket_location_type,
|
8686
8822
|
:bucket_location_name,
|
8687
8823
|
:bucket_region,
|
@@ -8995,7 +9131,13 @@ module Aws::S3
|
|
8995
9131
|
#
|
8996
9132
|
# @!attribute [rw] server_side_encryption
|
8997
9133
|
# The server-side encryption algorithm used when you store this object
|
8998
|
-
# in Amazon S3
|
9134
|
+
# in Amazon S3 or Amazon FSx.
|
9135
|
+
#
|
9136
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
9137
|
+
# access points, the only valid server side encryption option is
|
9138
|
+
# `aws:fsx`.
|
9139
|
+
#
|
9140
|
+
# </note>
|
8999
9141
|
# @return [String]
|
9000
9142
|
#
|
9001
9143
|
# @!attribute [rw] metadata
|
@@ -9121,6 +9263,22 @@ module Aws::S3
|
|
9121
9263
|
# as a multipart upload.
|
9122
9264
|
# @return [Integer]
|
9123
9265
|
#
|
9266
|
+
# @!attribute [rw] tag_count
|
9267
|
+
# The number of tags, if any, on the object, when you have the
|
9268
|
+
# relevant permission to read object tags.
|
9269
|
+
#
|
9270
|
+
# You can use [GetObjectTagging][1] to retrieve the tag set associated
|
9271
|
+
# with an object.
|
9272
|
+
#
|
9273
|
+
# <note markdown="1"> This functionality is not supported for directory buckets.
|
9274
|
+
#
|
9275
|
+
# </note>
|
9276
|
+
#
|
9277
|
+
#
|
9278
|
+
#
|
9279
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
9280
|
+
# @return [Integer]
|
9281
|
+
#
|
9124
9282
|
# @!attribute [rw] object_lock_mode
|
9125
9283
|
# The Object Lock mode, if any, that's in effect for this object.
|
9126
9284
|
# This header is only returned if the requester has the
|
@@ -9201,6 +9359,7 @@ module Aws::S3
|
|
9201
9359
|
:request_charged,
|
9202
9360
|
:replication_status,
|
9203
9361
|
:parts_count,
|
9362
|
+
:tag_count,
|
9204
9363
|
:object_lock_mode,
|
9205
9364
|
:object_lock_retain_until_date,
|
9206
9365
|
:object_lock_legal_hold_status)
|
@@ -9489,6 +9648,27 @@ module Aws::S3
|
|
9489
9648
|
include Aws::Structure
|
9490
9649
|
end
|
9491
9650
|
|
9651
|
+
# Parameters on this idempotent request are inconsistent with parameters
|
9652
|
+
# used in previous request(s).
|
9653
|
+
#
|
9654
|
+
# For a list of error codes and more information on Amazon S3 errors,
|
9655
|
+
# see [Error codes][1].
|
9656
|
+
#
|
9657
|
+
# <note markdown="1"> Idempotency ensures that an API request completes no more than one
|
9658
|
+
# time. With an idempotent request, if the original request completes
|
9659
|
+
# successfully, any subsequent retries complete successfully without
|
9660
|
+
# performing any further actions.
|
9661
|
+
#
|
9662
|
+
# </note>
|
9663
|
+
#
|
9664
|
+
#
|
9665
|
+
#
|
9666
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
9667
|
+
#
|
9668
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/IdempotencyParameterMismatch AWS API Documentation
|
9669
|
+
#
|
9670
|
+
class IdempotencyParameterMismatch < Aws::EmptyStructure; end
|
9671
|
+
|
9492
9672
|
# Container for the `Suffix` element.
|
9493
9673
|
#
|
9494
9674
|
# @!attribute [rw] suffix
|
@@ -10076,9 +10256,16 @@ module Aws::S3
|
|
10076
10256
|
# `Filter` is required if the `LifecycleRule` does not contain a
|
10077
10257
|
# `Prefix` element.
|
10078
10258
|
#
|
10259
|
+
# For more information about `Tag` filters, see [Adding filters to
|
10260
|
+
# Lifecycle rules][1] in the *Amazon S3 User Guide*.
|
10261
|
+
#
|
10079
10262
|
# <note markdown="1"> `Tag` filters are not supported for directory buckets.
|
10080
10263
|
#
|
10081
10264
|
# </note>
|
10265
|
+
#
|
10266
|
+
#
|
10267
|
+
#
|
10268
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-filters.html
|
10082
10269
|
# @return [Types::LifecycleRuleFilter]
|
10083
10270
|
#
|
10084
10271
|
# @!attribute [rw] status
|
@@ -10344,11 +10531,19 @@ module Aws::S3
|
|
10344
10531
|
# this request should begin.
|
10345
10532
|
# @return [String]
|
10346
10533
|
#
|
10534
|
+
# @!attribute [rw] expected_bucket_owner
|
10535
|
+
# The account ID of the expected bucket owner. If the account ID that
|
10536
|
+
# you provide does not match the actual owner of the bucket, the
|
10537
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
10538
|
+
# denied).
|
10539
|
+
# @return [String]
|
10540
|
+
#
|
10347
10541
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketIntelligentTieringConfigurationsRequest AWS API Documentation
|
10348
10542
|
#
|
10349
10543
|
class ListBucketIntelligentTieringConfigurationsRequest < Struct.new(
|
10350
10544
|
:bucket,
|
10351
|
-
:continuation_token
|
10545
|
+
:continuation_token,
|
10546
|
+
:expected_bucket_owner)
|
10352
10547
|
SENSITIVE = []
|
10353
10548
|
include Aws::Structure
|
10354
10549
|
end
|
@@ -10809,6 +11004,9 @@ module Aws::S3
|
|
10809
11004
|
# `CommonPrefixes` result element are not returned elsewhere in the
|
10810
11005
|
# response.
|
10811
11006
|
#
|
11007
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11008
|
+
# lexicographically greater than the key-marker.
|
11009
|
+
#
|
10812
11010
|
# <note markdown="1"> **Directory buckets** - For directory buckets, `/` is the only
|
10813
11011
|
# supported delimiter.
|
10814
11012
|
#
|
@@ -11068,6 +11266,9 @@ module Aws::S3
|
|
11068
11266
|
# element in `CommonPrefixes`. These groups are counted as one result
|
11069
11267
|
# against the `max-keys` limitation. These keys are not returned
|
11070
11268
|
# elsewhere in the response.
|
11269
|
+
#
|
11270
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11271
|
+
# lexicographically greater than the key-marker.
|
11071
11272
|
# @return [String]
|
11072
11273
|
#
|
11073
11274
|
# @!attribute [rw] encoding_type
|
@@ -11341,6 +11542,9 @@ module Aws::S3
|
|
11341
11542
|
#
|
11342
11543
|
# @!attribute [rw] delimiter
|
11343
11544
|
# A delimiter is a character that you use to group keys.
|
11545
|
+
#
|
11546
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11547
|
+
# lexicographically greater than the key-marker.
|
11344
11548
|
# @return [String]
|
11345
11549
|
#
|
11346
11550
|
# @!attribute [rw] encoding_type
|
@@ -11517,8 +11721,7 @@ module Aws::S3
|
|
11517
11721
|
# @!attribute [rw] continuation_token
|
11518
11722
|
# If `ContinuationToken` was sent with the request, it is included in
|
11519
11723
|
# the response. You can use the returned `ContinuationToken` for
|
11520
|
-
# pagination of the list response.
|
11521
|
-
# `ContinuationToken` for pagination of the list results.
|
11724
|
+
# pagination of the list response.
|
11522
11725
|
# @return [String]
|
11523
11726
|
#
|
11524
11727
|
# @!attribute [rw] next_continuation_token
|
@@ -11621,6 +11824,9 @@ module Aws::S3
|
|
11621
11824
|
# @!attribute [rw] delimiter
|
11622
11825
|
# A delimiter is a character that you use to group keys.
|
11623
11826
|
#
|
11827
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11828
|
+
# lexicographically greater than the `StartAfter` value.
|
11829
|
+
#
|
11624
11830
|
# <note markdown="1"> * **Directory buckets** - For directory buckets, `/` is the only
|
11625
11831
|
# supported delimiter.
|
11626
11832
|
#
|
@@ -13055,6 +13261,19 @@ module Aws::S3
|
|
13055
13261
|
include Aws::Structure
|
13056
13262
|
end
|
13057
13263
|
|
13264
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
13265
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
13266
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
13267
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
13268
|
+
# naming) as a direct replacement of `DisplayName`.
|
13269
|
+
#
|
13270
|
+
# This change affects the following Amazon Web Services Regions: US
|
13271
|
+
# East
|
13272
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
13273
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
13274
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
13275
|
+
# America (São Paulo) Region.
|
13276
|
+
#
|
13058
13277
|
# Container for the owner's display name and ID.
|
13059
13278
|
#
|
13060
13279
|
# @!attribute [rw] display_name
|
@@ -13736,6 +13955,13 @@ module Aws::S3
|
|
13736
13955
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
13737
13956
|
# @return [String]
|
13738
13957
|
#
|
13958
|
+
# @!attribute [rw] expected_bucket_owner
|
13959
|
+
# The account ID of the expected bucket owner. If the account ID that
|
13960
|
+
# you provide does not match the actual owner of the bucket, the
|
13961
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
13962
|
+
# denied).
|
13963
|
+
# @return [String]
|
13964
|
+
#
|
13739
13965
|
# @!attribute [rw] intelligent_tiering_configuration
|
13740
13966
|
# Container for S3 Intelligent-Tiering configuration.
|
13741
13967
|
# @return [Types::IntelligentTieringConfiguration]
|
@@ -13745,6 +13971,7 @@ module Aws::S3
|
|
13745
13971
|
class PutBucketIntelligentTieringConfigurationRequest < Struct.new(
|
13746
13972
|
:bucket,
|
13747
13973
|
:id,
|
13974
|
+
:expected_bucket_owner,
|
13748
13975
|
:intelligent_tiering_configuration)
|
13749
13976
|
SENSITIVE = []
|
13750
13977
|
include Aws::Structure
|
@@ -15115,7 +15342,13 @@ module Aws::S3
|
|
15115
15342
|
#
|
15116
15343
|
# @!attribute [rw] server_side_encryption
|
15117
15344
|
# The server-side encryption algorithm used when you store this object
|
15118
|
-
# in Amazon S3.
|
15345
|
+
# in Amazon S3 or Amazon FSx.
|
15346
|
+
#
|
15347
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
15348
|
+
# access points, the only valid server side encryption option is
|
15349
|
+
# `aws:fsx`.
|
15350
|
+
#
|
15351
|
+
# </note>
|
15119
15352
|
# @return [String]
|
15120
15353
|
#
|
15121
15354
|
# @!attribute [rw] version_id
|
@@ -15627,8 +15860,7 @@ module Aws::S3
|
|
15627
15860
|
#
|
15628
15861
|
# @!attribute [rw] server_side_encryption
|
15629
15862
|
# The server-side encryption algorithm that was used when you store
|
15630
|
-
# this object in Amazon S3
|
15631
|
-
# `aws:kms:dsse`).
|
15863
|
+
# this object in Amazon S3 or Amazon FSx.
|
15632
15864
|
#
|
15633
15865
|
# * <b>General purpose buckets </b> - You have four mutually exclusive
|
15634
15866
|
# options to protect data using server-side encryption in Amazon S3,
|
@@ -15683,6 +15915,14 @@ module Aws::S3
|
|
15683
15915
|
#
|
15684
15916
|
# </note>
|
15685
15917
|
#
|
15918
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data
|
15919
|
+
# stored in Amazon FSx file systems using S3 access points, the only
|
15920
|
+
# valid server side encryption option is `aws:fsx`. All Amazon FSx
|
15921
|
+
# file systems have encryption configured by default and are
|
15922
|
+
# encrypted at rest. Data is automatically encrypted before being
|
15923
|
+
# written to the file system, and automatically decrypted as it is
|
15924
|
+
# read. These processes are handled transparently by Amazon FSx.
|
15925
|
+
#
|
15686
15926
|
#
|
15687
15927
|
#
|
15688
15928
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
@@ -16474,6 +16714,129 @@ module Aws::S3
|
|
16474
16714
|
include Aws::Structure
|
16475
16715
|
end
|
16476
16716
|
|
16717
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObjectOutput AWS API Documentation
|
16718
|
+
#
|
16719
|
+
class RenameObjectOutput < Aws::EmptyStructure; end
|
16720
|
+
|
16721
|
+
# @!attribute [rw] bucket
|
16722
|
+
# The bucket name of the directory bucket containing the object.
|
16723
|
+
#
|
16724
|
+
# You must use virtual-hosted-style requests in the format
|
16725
|
+
# `Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
16726
|
+
# Path-style requests are not supported. Directory bucket names must
|
16727
|
+
# be unique in the chosen Availability Zone. Bucket names must follow
|
16728
|
+
# the format `bucket-base-name--zone-id--x-s3 ` (for example,
|
16729
|
+
# `amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
16730
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
16731
|
+
# *Amazon S3 User Guide*.
|
16732
|
+
#
|
16733
|
+
#
|
16734
|
+
#
|
16735
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
|
16736
|
+
# @return [String]
|
16737
|
+
#
|
16738
|
+
# @!attribute [rw] key
|
16739
|
+
# Key name of the object to rename.
|
16740
|
+
# @return [String]
|
16741
|
+
#
|
16742
|
+
# @!attribute [rw] rename_source
|
16743
|
+
# Specifies the source for the rename operation. The value must be URL
|
16744
|
+
# encoded.
|
16745
|
+
# @return [String]
|
16746
|
+
#
|
16747
|
+
# @!attribute [rw] destination_if_match
|
16748
|
+
# Renames the object only if the ETag (entity tag) value provided
|
16749
|
+
# during the operation matches the ETag of the object in S3. The
|
16750
|
+
# `If-Match` header field makes the request method conditional on
|
16751
|
+
# ETags. If the ETag values do not match, the operation returns a `412
|
16752
|
+
# Precondition Failed` error.
|
16753
|
+
#
|
16754
|
+
# Expects the ETag value as a string.
|
16755
|
+
# @return [String]
|
16756
|
+
#
|
16757
|
+
# @!attribute [rw] destination_if_none_match
|
16758
|
+
# Renames the object only if the destination does not already exist in
|
16759
|
+
# the specified directory bucket. If the object does exist when you
|
16760
|
+
# send a request with `If-None-Match:*`, the S3 API will return a `412
|
16761
|
+
# Precondition Failed` error, preventing an overwrite. The
|
16762
|
+
# `If-None-Match` header prevents overwrites of existing data by
|
16763
|
+
# validating that there's not an object with the same key name
|
16764
|
+
# already in your directory bucket.
|
16765
|
+
#
|
16766
|
+
# Expects the `*` character (asterisk).
|
16767
|
+
# @return [String]
|
16768
|
+
#
|
16769
|
+
# @!attribute [rw] destination_if_modified_since
|
16770
|
+
# Renames the object if the destination exists and if it has been
|
16771
|
+
# modified since the specified time.
|
16772
|
+
# @return [Time]
|
16773
|
+
#
|
16774
|
+
# @!attribute [rw] destination_if_unmodified_since
|
16775
|
+
# Renames the object if it hasn't been modified since the specified
|
16776
|
+
# time.
|
16777
|
+
# @return [Time]
|
16778
|
+
#
|
16779
|
+
# @!attribute [rw] source_if_match
|
16780
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
16781
|
+
# matches the specified ETag.
|
16782
|
+
# @return [String]
|
16783
|
+
#
|
16784
|
+
# @!attribute [rw] source_if_none_match
|
16785
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
16786
|
+
# is different than the specified ETag. If an asterisk (`*`) character
|
16787
|
+
# is provided, the operation will fail and return a `412 Precondition
|
16788
|
+
# Failed` error.
|
16789
|
+
# @return [String]
|
16790
|
+
#
|
16791
|
+
# @!attribute [rw] source_if_modified_since
|
16792
|
+
# Renames the object if the source exists and if it has been modified
|
16793
|
+
# since the specified time.
|
16794
|
+
# @return [Time]
|
16795
|
+
#
|
16796
|
+
# @!attribute [rw] source_if_unmodified_since
|
16797
|
+
# Renames the object if the source exists and hasn't been modified
|
16798
|
+
# since the specified time.
|
16799
|
+
# @return [Time]
|
16800
|
+
#
|
16801
|
+
# @!attribute [rw] client_token
|
16802
|
+
# A unique string with a max of 64 ASCII characters in the ASCII range
|
16803
|
+
# of 33 - 126.
|
16804
|
+
#
|
16805
|
+
# <note markdown="1"> `RenameObject` supports idempotency using a client token. To make an
|
16806
|
+
# idempotent API request using `RenameObject`, specify a client token
|
16807
|
+
# in the request. You should not reuse the same client token for other
|
16808
|
+
# API requests. If you retry a request that completed successfully
|
16809
|
+
# using the same client token and the same parameters, the retry
|
16810
|
+
# succeeds without performing any further actions. If you retry a
|
16811
|
+
# successful request using the same client token, but one or more of
|
16812
|
+
# the parameters are different, the retry fails and an
|
16813
|
+
# `IdempotentParameterMismatch` error is returned.
|
16814
|
+
#
|
16815
|
+
# </note>
|
16816
|
+
#
|
16817
|
+
# **A suitable default value is auto-generated.** You should normally
|
16818
|
+
# not need to pass this option.
|
16819
|
+
# @return [String]
|
16820
|
+
#
|
16821
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObjectRequest AWS API Documentation
|
16822
|
+
#
|
16823
|
+
class RenameObjectRequest < Struct.new(
|
16824
|
+
:bucket,
|
16825
|
+
:key,
|
16826
|
+
:rename_source,
|
16827
|
+
:destination_if_match,
|
16828
|
+
:destination_if_none_match,
|
16829
|
+
:destination_if_modified_since,
|
16830
|
+
:destination_if_unmodified_since,
|
16831
|
+
:source_if_match,
|
16832
|
+
:source_if_none_match,
|
16833
|
+
:source_if_modified_since,
|
16834
|
+
:source_if_unmodified_since,
|
16835
|
+
:client_token)
|
16836
|
+
SENSITIVE = []
|
16837
|
+
include Aws::Structure
|
16838
|
+
end
|
16839
|
+
|
16477
16840
|
# A filter that you can specify for selection for modifications on
|
16478
16841
|
# replicas. Amazon S3 doesn't replicate replica modifications by
|
16479
16842
|
# default. In the latest version of replication configuration (when
|
@@ -18189,7 +18552,13 @@ module Aws::S3
|
|
18189
18552
|
#
|
18190
18553
|
# @!attribute [rw] server_side_encryption
|
18191
18554
|
# The server-side encryption algorithm used when you store this object
|
18192
|
-
# in Amazon S3
|
18555
|
+
# in Amazon S3 or Amazon FSx.
|
18556
|
+
#
|
18557
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
18558
|
+
# access points, the only valid server side encryption option is
|
18559
|
+
# `aws:fsx`.
|
18560
|
+
#
|
18561
|
+
# </note>
|
18193
18562
|
# @return [String]
|
18194
18563
|
#
|
18195
18564
|
# @!attribute [rw] sse_customer_algorithm
|
@@ -18587,7 +18956,13 @@ module Aws::S3
|
|
18587
18956
|
|
18588
18957
|
# @!attribute [rw] server_side_encryption
|
18589
18958
|
# The server-side encryption algorithm used when you store this object
|
18590
|
-
# in Amazon S3
|
18959
|
+
# in Amazon S3 or Amazon FSx.
|
18960
|
+
#
|
18961
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
18962
|
+
# access points, the only valid server side encryption option is
|
18963
|
+
# `aws:fsx`.
|
18964
|
+
#
|
18965
|
+
# </note>
|
18591
18966
|
# @return [String]
|
18592
18967
|
#
|
18593
18968
|
# @!attribute [rw] etag
|
@@ -19320,7 +19695,13 @@ module Aws::S3
|
|
19320
19695
|
#
|
19321
19696
|
# @!attribute [rw] server_side_encryption
|
19322
19697
|
# The server-side encryption algorithm used when storing requested
|
19323
|
-
# object in Amazon S3
|
19698
|
+
# object in Amazon S3 or Amazon FSx.
|
19699
|
+
#
|
19700
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
19701
|
+
# access points, the only valid server side encryption option is
|
19702
|
+
# `aws:fsx`.
|
19703
|
+
#
|
19704
|
+
# </note>
|
19324
19705
|
# @return [String]
|
19325
19706
|
#
|
19326
19707
|
# @!attribute [rw] sse_customer_algorithm
|