aws-sdk-s3 1.188.0 → 1.195.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 +40 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +43 -4
- data/lib/aws-sdk-s3/client.rb +1114 -98
- data/lib/aws-sdk-s3/client_api.rb +228 -0
- data/lib/aws-sdk-s3/endpoints.rb +84 -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 +1107 -49
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +12 -3
- data/sig/client.rbs +141 -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 +8 -1
- data/sig/types.rbs +182 -29
- metadata +4 -4
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,19 +2697,69 @@ 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)
|
2722
|
+
SENSITIVE = []
|
2723
|
+
include Aws::Structure
|
2724
|
+
end
|
2725
|
+
|
2726
|
+
# @!attribute [rw] bucket
|
2727
|
+
# The general purpose bucket that you want to create the metadata
|
2728
|
+
# configuration for.
|
2729
|
+
# @return [String]
|
2730
|
+
#
|
2731
|
+
# @!attribute [rw] content_md5
|
2732
|
+
# The `Content-MD5` header for the metadata configuration.
|
2733
|
+
# @return [String]
|
2734
|
+
#
|
2735
|
+
# @!attribute [rw] checksum_algorithm
|
2736
|
+
# The checksum algorithm to use with your metadata configuration.
|
2737
|
+
# @return [String]
|
2738
|
+
#
|
2739
|
+
# @!attribute [rw] metadata_configuration
|
2740
|
+
# The contents of your metadata configuration.
|
2741
|
+
# @return [Types::MetadataConfiguration]
|
2742
|
+
#
|
2743
|
+
# @!attribute [rw] expected_bucket_owner
|
2744
|
+
# The expected owner of the general purpose bucket that corresponds to
|
2745
|
+
# your metadata configuration.
|
2746
|
+
# @return [String]
|
2747
|
+
#
|
2748
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataConfigurationRequest AWS API Documentation
|
2749
|
+
#
|
2750
|
+
class CreateBucketMetadataConfigurationRequest < Struct.new(
|
2751
|
+
:bucket,
|
2752
|
+
:content_md5,
|
2753
|
+
:checksum_algorithm,
|
2754
|
+
:metadata_configuration,
|
2755
|
+
:expected_bucket_owner)
|
2670
2756
|
SENSITIVE = []
|
2671
2757
|
include Aws::Structure
|
2672
2758
|
end
|
2673
2759
|
|
2674
2760
|
# @!attribute [rw] bucket
|
2675
2761
|
# The general purpose bucket that you want to create the metadata
|
2676
|
-
# table configuration
|
2762
|
+
# table configuration for.
|
2677
2763
|
# @return [String]
|
2678
2764
|
#
|
2679
2765
|
# @!attribute [rw] content_md5
|
@@ -2690,8 +2776,8 @@ module Aws::S3
|
|
2690
2776
|
# @return [Types::MetadataTableConfiguration]
|
2691
2777
|
#
|
2692
2778
|
# @!attribute [rw] expected_bucket_owner
|
2693
|
-
# The expected owner of the general purpose bucket that
|
2694
|
-
# metadata table configuration.
|
2779
|
+
# The expected owner of the general purpose bucket that corresponds to
|
2780
|
+
# your metadata table configuration.
|
2695
2781
|
# @return [String]
|
2696
2782
|
#
|
2697
2783
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataTableConfigurationRequest AWS API Documentation
|
@@ -2710,10 +2796,26 @@ module Aws::S3
|
|
2710
2796
|
# A forward slash followed by the name of the bucket.
|
2711
2797
|
# @return [String]
|
2712
2798
|
#
|
2799
|
+
# @!attribute [rw] bucket_arn
|
2800
|
+
# The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
|
2801
|
+
# identify Amazon Web Services resources across all of Amazon Web
|
2802
|
+
# Services.
|
2803
|
+
#
|
2804
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
2805
|
+
# information, see [Using tags with directory buckets][1].
|
2806
|
+
#
|
2807
|
+
# </note>
|
2808
|
+
#
|
2809
|
+
#
|
2810
|
+
#
|
2811
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
2812
|
+
# @return [String]
|
2813
|
+
#
|
2713
2814
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketOutput AWS API Documentation
|
2714
2815
|
#
|
2715
2816
|
class CreateBucketOutput < Struct.new(
|
2716
|
-
:location
|
2817
|
+
:location,
|
2818
|
+
:bucket_arn)
|
2717
2819
|
SENSITIVE = []
|
2718
2820
|
include Aws::Structure
|
2719
2821
|
end
|
@@ -2912,7 +3014,13 @@ module Aws::S3
|
|
2912
3014
|
#
|
2913
3015
|
# @!attribute [rw] server_side_encryption
|
2914
3016
|
# The server-side encryption algorithm used when you store this object
|
2915
|
-
# in Amazon S3
|
3017
|
+
# in Amazon S3 or Amazon FSx.
|
3018
|
+
#
|
3019
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
3020
|
+
# access points, the only valid server side encryption option is
|
3021
|
+
# `aws:fsx`.
|
3022
|
+
#
|
3023
|
+
# </note>
|
2916
3024
|
# @return [String]
|
2917
3025
|
#
|
2918
3026
|
# @!attribute [rw] sse_customer_algorithm
|
@@ -3380,7 +3488,7 @@ module Aws::S3
|
|
3380
3488
|
#
|
3381
3489
|
# @!attribute [rw] server_side_encryption
|
3382
3490
|
# The server-side encryption algorithm used when you store this object
|
3383
|
-
# in Amazon S3
|
3491
|
+
# in Amazon S3 or Amazon FSx.
|
3384
3492
|
#
|
3385
3493
|
# * <b>Directory buckets </b> - For directory buckets, there are only
|
3386
3494
|
# two supported options for server-side encryption: server-side
|
@@ -3423,6 +3531,14 @@ module Aws::S3
|
|
3423
3531
|
#
|
3424
3532
|
# </note>
|
3425
3533
|
#
|
3534
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data
|
3535
|
+
# stored in Amazon FSx file systems using S3 access points, the only
|
3536
|
+
# valid server side encryption option is `aws:fsx`. All Amazon FSx
|
3537
|
+
# file systems have encryption configured by default and are
|
3538
|
+
# encrypted at rest. Data is automatically encrypted before being
|
3539
|
+
# written to the file system, and automatically decrypted as it is
|
3540
|
+
# read. These processes are handled transparently by Amazon FSx.
|
3541
|
+
#
|
3426
3542
|
#
|
3427
3543
|
#
|
3428
3544
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
|
@@ -3689,6 +3805,12 @@ module Aws::S3
|
|
3689
3805
|
# @!attribute [rw] server_side_encryption
|
3690
3806
|
# The server-side encryption algorithm used when you store objects in
|
3691
3807
|
# the directory bucket.
|
3808
|
+
#
|
3809
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
3810
|
+
# access points, the only valid server side encryption option is
|
3811
|
+
# `aws:fsx`.
|
3812
|
+
#
|
3813
|
+
# </note>
|
3692
3814
|
# @return [String]
|
3693
3815
|
#
|
3694
3816
|
# @!attribute [rw] ssekms_key_id
|
@@ -3753,6 +3875,14 @@ module Aws::S3
|
|
3753
3875
|
# SSE-S3. For more information, see [Protecting data with server-side
|
3754
3876
|
# encryption][1] in the *Amazon S3 User Guide*.
|
3755
3877
|
#
|
3878
|
+
# <b>S3 access points for Amazon FSx </b> - When accessing data stored
|
3879
|
+
# in Amazon FSx file systems using S3 access points, the only valid
|
3880
|
+
# server side encryption option is `aws:fsx`. All Amazon FSx file
|
3881
|
+
# systems have encryption configured by default and are encrypted at
|
3882
|
+
# rest. Data is automatically encrypted before being written to the
|
3883
|
+
# file system, and automatically decrypted as it is read. These
|
3884
|
+
# processes are handled transparently by Amazon FSx.
|
3885
|
+
#
|
3756
3886
|
#
|
3757
3887
|
#
|
3758
3888
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
|
@@ -4000,11 +4130,19 @@ module Aws::S3
|
|
4000
4130
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
4001
4131
|
# @return [String]
|
4002
4132
|
#
|
4133
|
+
# @!attribute [rw] expected_bucket_owner
|
4134
|
+
# The account ID of the expected bucket owner. If the account ID that
|
4135
|
+
# you provide does not match the actual owner of the bucket, the
|
4136
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
4137
|
+
# denied).
|
4138
|
+
# @return [String]
|
4139
|
+
#
|
4003
4140
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketIntelligentTieringConfigurationRequest AWS API Documentation
|
4004
4141
|
#
|
4005
4142
|
class DeleteBucketIntelligentTieringConfigurationRequest < Struct.new(
|
4006
4143
|
:bucket,
|
4007
|
-
:id
|
4144
|
+
:id,
|
4145
|
+
:expected_bucket_owner)
|
4008
4146
|
SENSITIVE = []
|
4009
4147
|
include Aws::Structure
|
4010
4148
|
end
|
@@ -4060,6 +4198,25 @@ module Aws::S3
|
|
4060
4198
|
include Aws::Structure
|
4061
4199
|
end
|
4062
4200
|
|
4201
|
+
# @!attribute [rw] bucket
|
4202
|
+
# The general purpose bucket that you want to remove the metadata
|
4203
|
+
# configuration from.
|
4204
|
+
# @return [String]
|
4205
|
+
#
|
4206
|
+
# @!attribute [rw] expected_bucket_owner
|
4207
|
+
# The expected bucket owner of the general purpose bucket that you
|
4208
|
+
# want to remove the metadata table configuration from.
|
4209
|
+
# @return [String]
|
4210
|
+
#
|
4211
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetadataConfigurationRequest AWS API Documentation
|
4212
|
+
#
|
4213
|
+
class DeleteBucketMetadataConfigurationRequest < Struct.new(
|
4214
|
+
:bucket,
|
4215
|
+
:expected_bucket_owner)
|
4216
|
+
SENSITIVE = []
|
4217
|
+
include Aws::Structure
|
4218
|
+
end
|
4219
|
+
|
4063
4220
|
# @!attribute [rw] bucket
|
4064
4221
|
# The general purpose bucket that you want to remove the metadata
|
4065
4222
|
# table configuration from.
|
@@ -4938,6 +5095,8 @@ module Aws::S3
|
|
4938
5095
|
# For valid values, see the `StorageClass` element of the [PUT Bucket
|
4939
5096
|
# replication][1] action in the *Amazon S3 API Reference*.
|
4940
5097
|
#
|
5098
|
+
# `FSX_OPENZFS` is not an accepted value when replicating objects.
|
5099
|
+
#
|
4941
5100
|
#
|
4942
5101
|
#
|
4943
5102
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html
|
@@ -4984,6 +5143,37 @@ module Aws::S3
|
|
4984
5143
|
include Aws::Structure
|
4985
5144
|
end
|
4986
5145
|
|
5146
|
+
# The destination information for the S3 Metadata configuration.
|
5147
|
+
#
|
5148
|
+
# @!attribute [rw] table_bucket_type
|
5149
|
+
# The type of the table bucket where the metadata configuration is
|
5150
|
+
# stored. The `aws` value indicates an Amazon Web Services managed
|
5151
|
+
# table bucket, and the `customer` value indicates a customer-managed
|
5152
|
+
# table bucket. V2 metadata configurations are stored in Amazon Web
|
5153
|
+
# Services managed table buckets, and V1 metadata configurations are
|
5154
|
+
# stored in customer-managed table buckets.
|
5155
|
+
# @return [String]
|
5156
|
+
#
|
5157
|
+
# @!attribute [rw] table_bucket_arn
|
5158
|
+
# The Amazon Resource Name (ARN) of the table bucket where the
|
5159
|
+
# metadata configuration is stored.
|
5160
|
+
# @return [String]
|
5161
|
+
#
|
5162
|
+
# @!attribute [rw] table_namespace
|
5163
|
+
# The namespace in the table bucket where the metadata tables for a
|
5164
|
+
# metadata configuration are stored.
|
5165
|
+
# @return [String]
|
5166
|
+
#
|
5167
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DestinationResult AWS API Documentation
|
5168
|
+
#
|
5169
|
+
class DestinationResult < Struct.new(
|
5170
|
+
:table_bucket_type,
|
5171
|
+
:table_bucket_arn,
|
5172
|
+
:table_namespace)
|
5173
|
+
SENSITIVE = []
|
5174
|
+
include Aws::Structure
|
5175
|
+
end
|
5176
|
+
|
4987
5177
|
# Contains the type of server-side encryption used.
|
4988
5178
|
#
|
4989
5179
|
# @!attribute [rw] encryption_type
|
@@ -5825,12 +6015,24 @@ module Aws::S3
|
|
5825
6015
|
include Aws::Structure
|
5826
6016
|
end
|
5827
6017
|
|
5828
|
-
# If
|
5829
|
-
#
|
5830
|
-
# the
|
6018
|
+
# If an S3 Metadata V1 `CreateBucketMetadataTableConfiguration` or V2
|
6019
|
+
# `CreateBucketMetadataConfiguration` request succeeds, but S3 Metadata
|
6020
|
+
# was unable to create the table, this structure contains the error code
|
6021
|
+
# and error message.
|
6022
|
+
#
|
6023
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
6024
|
+
# recommend that you delete and re-create your configuration by using
|
6025
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
6026
|
+
# table records and create a live inventory table.
|
6027
|
+
#
|
6028
|
+
# </note>
|
6029
|
+
#
|
6030
|
+
#
|
6031
|
+
#
|
6032
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
5831
6033
|
#
|
5832
6034
|
# @!attribute [rw] error_code
|
5833
|
-
# If the `CreateBucketMetadataTableConfiguration` request succeeds,
|
6035
|
+
# If the V1 `CreateBucketMetadataTableConfiguration` request succeeds,
|
5834
6036
|
# but S3 Metadata was unable to create the table, this structure
|
5835
6037
|
# contains the error code. The possible error codes and error messages
|
5836
6038
|
# are as follows:
|
@@ -5869,10 +6071,65 @@ module Aws::S3
|
|
5869
6071
|
# Create or choose a different table bucket. To create a new
|
5870
6072
|
# metadata table, you must delete the metadata configuration for
|
5871
6073
|
# this bucket, and then create a new metadata configuration.
|
6074
|
+
#
|
6075
|
+
# If the V2 `CreateBucketMetadataConfiguration` request succeeds, but
|
6076
|
+
# S3 Metadata was unable to create the table, this structure contains
|
6077
|
+
# the error code. The possible error codes and error messages are as
|
6078
|
+
# follows:
|
6079
|
+
#
|
6080
|
+
# * `AccessDeniedCreatingResources` - You don't have sufficient
|
6081
|
+
# permissions to create the required resources. Make sure that you
|
6082
|
+
# have `s3tables:CreateTableBucket`, `s3tables:CreateNamespace`,
|
6083
|
+
# `s3tables:CreateTable`, `s3tables:GetTable`,
|
6084
|
+
# `s3tables:PutTablePolicy`, `kms:DescribeKey`, and
|
6085
|
+
# `s3tables:PutTableEncryption` permissions. Additionally, ensure
|
6086
|
+
# that the KMS key used to encrypt the table still exists, is active
|
6087
|
+
# and has a resource policy granting access to the S3 service
|
6088
|
+
# principals '`maintenance.s3tables.amazonaws.com`' and
|
6089
|
+
# '`metadata.s3.amazonaws.com`'. To create a new metadata table,
|
6090
|
+
# you must delete the metadata configuration for this bucket, and
|
6091
|
+
# then create a new metadata configuration.
|
6092
|
+
#
|
6093
|
+
# * `AccessDeniedWritingToTable` - Unable to write to the metadata
|
6094
|
+
# table because of missing resource permissions. To fix the resource
|
6095
|
+
# policy, Amazon S3 needs to create a new metadata table. To create
|
6096
|
+
# a new metadata table, you must delete the metadata configuration
|
6097
|
+
# for this bucket, and then create a new metadata configuration.
|
6098
|
+
#
|
6099
|
+
# * `DestinationTableNotFound` - The destination table doesn't exist.
|
6100
|
+
# To create a new metadata table, you must delete the metadata
|
6101
|
+
# configuration for this bucket, and then create a new metadata
|
6102
|
+
# configuration.
|
6103
|
+
#
|
6104
|
+
# * `ServerInternalError` - An internal error has occurred. To create
|
6105
|
+
# a new metadata table, you must delete the metadata configuration
|
6106
|
+
# for this bucket, and then create a new metadata configuration.
|
6107
|
+
#
|
6108
|
+
# * `JournalTableAlreadyExists` - A journal table already exists in
|
6109
|
+
# the Amazon Web Services managed table bucket's namespace. Delete
|
6110
|
+
# the journal table, and then try again. To create a new metadata
|
6111
|
+
# table, you must delete the metadata configuration for this bucket,
|
6112
|
+
# and then create a new metadata configuration.
|
6113
|
+
#
|
6114
|
+
# * `InventoryTableAlreadyExists` - An inventory table already exists
|
6115
|
+
# in the Amazon Web Services managed table bucket's namespace.
|
6116
|
+
# Delete the inventory table, and then try again. To create a new
|
6117
|
+
# metadata table, you must delete the metadata configuration for
|
6118
|
+
# this bucket, and then create a new metadata configuration.
|
6119
|
+
#
|
6120
|
+
# * `JournalTableNotAvailable` - The journal table that the inventory
|
6121
|
+
# table relies on has a `FAILED` status. An inventory table requires
|
6122
|
+
# a journal table with an `ACTIVE` status. To create a new journal
|
6123
|
+
# or inventory table, you must delete the metadata configuration for
|
6124
|
+
# this bucket, along with any journal or inventory tables, and then
|
6125
|
+
# create a new metadata configuration.
|
6126
|
+
#
|
6127
|
+
# * `NoSuchBucket` - The specified general purpose bucket does not
|
6128
|
+
# exist.
|
5872
6129
|
# @return [String]
|
5873
6130
|
#
|
5874
6131
|
# @!attribute [rw] error_message
|
5875
|
-
# If the `CreateBucketMetadataTableConfiguration` request succeeds,
|
6132
|
+
# If the V1 `CreateBucketMetadataTableConfiguration` request succeeds,
|
5876
6133
|
# but S3 Metadata was unable to create the table, this structure
|
5877
6134
|
# contains the error message. The possible error codes and error
|
5878
6135
|
# messages are as follows:
|
@@ -5911,6 +6168,61 @@ module Aws::S3
|
|
5911
6168
|
# Create or choose a different table bucket. To create a new
|
5912
6169
|
# metadata table, you must delete the metadata configuration for
|
5913
6170
|
# this bucket, and then create a new metadata configuration.
|
6171
|
+
#
|
6172
|
+
# If the V2 `CreateBucketMetadataConfiguration` request succeeds, but
|
6173
|
+
# S3 Metadata was unable to create the table, this structure contains
|
6174
|
+
# the error code. The possible error codes and error messages are as
|
6175
|
+
# follows:
|
6176
|
+
#
|
6177
|
+
# * `AccessDeniedCreatingResources` - You don't have sufficient
|
6178
|
+
# permissions to create the required resources. Make sure that you
|
6179
|
+
# have `s3tables:CreateTableBucket`, `s3tables:CreateNamespace`,
|
6180
|
+
# `s3tables:CreateTable`, `s3tables:GetTable`,
|
6181
|
+
# `s3tables:PutTablePolicy`, `kms:DescribeKey`, and
|
6182
|
+
# `s3tables:PutTableEncryption` permissions. Additionally, ensure
|
6183
|
+
# that the KMS key used to encrypt the table still exists, is active
|
6184
|
+
# and has a resource policy granting access to the S3 service
|
6185
|
+
# principals '`maintenance.s3tables.amazonaws.com`' and
|
6186
|
+
# '`metadata.s3.amazonaws.com`'. To create a new metadata table,
|
6187
|
+
# you must delete the metadata configuration for this bucket, and
|
6188
|
+
# then create a new metadata configuration.
|
6189
|
+
#
|
6190
|
+
# * `AccessDeniedWritingToTable` - Unable to write to the metadata
|
6191
|
+
# table because of missing resource permissions. To fix the resource
|
6192
|
+
# policy, Amazon S3 needs to create a new metadata table. To create
|
6193
|
+
# a new metadata table, you must delete the metadata configuration
|
6194
|
+
# for this bucket, and then create a new metadata configuration.
|
6195
|
+
#
|
6196
|
+
# * `DestinationTableNotFound` - The destination table doesn't exist.
|
6197
|
+
# To create a new metadata table, you must delete the metadata
|
6198
|
+
# configuration for this bucket, and then create a new metadata
|
6199
|
+
# configuration.
|
6200
|
+
#
|
6201
|
+
# * `ServerInternalError` - An internal error has occurred. To create
|
6202
|
+
# a new metadata table, you must delete the metadata configuration
|
6203
|
+
# for this bucket, and then create a new metadata configuration.
|
6204
|
+
#
|
6205
|
+
# * `JournalTableAlreadyExists` - A journal table already exists in
|
6206
|
+
# the Amazon Web Services managed table bucket's namespace. Delete
|
6207
|
+
# the journal table, and then try again. To create a new metadata
|
6208
|
+
# table, you must delete the metadata configuration for this bucket,
|
6209
|
+
# and then create a new metadata configuration.
|
6210
|
+
#
|
6211
|
+
# * `InventoryTableAlreadyExists` - An inventory table already exists
|
6212
|
+
# in the Amazon Web Services managed table bucket's namespace.
|
6213
|
+
# Delete the inventory table, and then try again. To create a new
|
6214
|
+
# metadata table, you must delete the metadata configuration for
|
6215
|
+
# this bucket, and then create a new metadata configuration.
|
6216
|
+
#
|
6217
|
+
# * `JournalTableNotAvailable` - The journal table that the inventory
|
6218
|
+
# table relies on has a `FAILED` status. An inventory table requires
|
6219
|
+
# a journal table with an `ACTIVE` status. To create a new journal
|
6220
|
+
# or inventory table, you must delete the metadata configuration for
|
6221
|
+
# this bucket, along with any journal or inventory tables, and then
|
6222
|
+
# create a new metadata configuration.
|
6223
|
+
#
|
6224
|
+
# * `NoSuchBucket` - The specified general purpose bucket does not
|
6225
|
+
# exist.
|
5914
6226
|
# @return [String]
|
5915
6227
|
#
|
5916
6228
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ErrorDetails AWS API Documentation
|
@@ -6292,11 +6604,19 @@ module Aws::S3
|
|
6292
6604
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
6293
6605
|
# @return [String]
|
6294
6606
|
#
|
6607
|
+
# @!attribute [rw] expected_bucket_owner
|
6608
|
+
# The account ID of the expected bucket owner. If the account ID that
|
6609
|
+
# you provide does not match the actual owner of the bucket, the
|
6610
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
6611
|
+
# denied).
|
6612
|
+
# @return [String]
|
6613
|
+
#
|
6295
6614
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketIntelligentTieringConfigurationRequest AWS API Documentation
|
6296
6615
|
#
|
6297
6616
|
class GetBucketIntelligentTieringConfigurationRequest < Struct.new(
|
6298
6617
|
:bucket,
|
6299
|
-
:id
|
6618
|
+
:id,
|
6619
|
+
:expected_bucket_owner)
|
6300
6620
|
SENSITIVE = []
|
6301
6621
|
include Aws::Structure
|
6302
6622
|
end
|
@@ -6525,6 +6845,51 @@ module Aws::S3
|
|
6525
6845
|
include Aws::Structure
|
6526
6846
|
end
|
6527
6847
|
|
6848
|
+
# @!attribute [rw] get_bucket_metadata_configuration_result
|
6849
|
+
# The metadata configuration for the general purpose bucket.
|
6850
|
+
# @return [Types::GetBucketMetadataConfigurationResult]
|
6851
|
+
#
|
6852
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataConfigurationOutput AWS API Documentation
|
6853
|
+
#
|
6854
|
+
class GetBucketMetadataConfigurationOutput < Struct.new(
|
6855
|
+
:get_bucket_metadata_configuration_result)
|
6856
|
+
SENSITIVE = []
|
6857
|
+
include Aws::Structure
|
6858
|
+
end
|
6859
|
+
|
6860
|
+
# @!attribute [rw] bucket
|
6861
|
+
# The general purpose bucket that corresponds to the metadata
|
6862
|
+
# configuration that you want to retrieve.
|
6863
|
+
# @return [String]
|
6864
|
+
#
|
6865
|
+
# @!attribute [rw] expected_bucket_owner
|
6866
|
+
# The expected owner of the general purpose bucket that you want to
|
6867
|
+
# retrieve the metadata table configuration for.
|
6868
|
+
# @return [String]
|
6869
|
+
#
|
6870
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataConfigurationRequest AWS API Documentation
|
6871
|
+
#
|
6872
|
+
class GetBucketMetadataConfigurationRequest < Struct.new(
|
6873
|
+
:bucket,
|
6874
|
+
:expected_bucket_owner)
|
6875
|
+
SENSITIVE = []
|
6876
|
+
include Aws::Structure
|
6877
|
+
end
|
6878
|
+
|
6879
|
+
# The S3 Metadata configuration for a general purpose bucket.
|
6880
|
+
#
|
6881
|
+
# @!attribute [rw] metadata_configuration_result
|
6882
|
+
# The metadata configuration for a general purpose bucket.
|
6883
|
+
# @return [Types::MetadataConfigurationResult]
|
6884
|
+
#
|
6885
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataConfigurationResult AWS API Documentation
|
6886
|
+
#
|
6887
|
+
class GetBucketMetadataConfigurationResult < Struct.new(
|
6888
|
+
:metadata_configuration_result)
|
6889
|
+
SENSITIVE = []
|
6890
|
+
include Aws::Structure
|
6891
|
+
end
|
6892
|
+
|
6528
6893
|
# @!attribute [rw] get_bucket_metadata_table_configuration_result
|
6529
6894
|
# The metadata table configuration for the general purpose bucket.
|
6530
6895
|
# @return [Types::GetBucketMetadataTableConfigurationResult]
|
@@ -6538,13 +6903,13 @@ module Aws::S3
|
|
6538
6903
|
end
|
6539
6904
|
|
6540
6905
|
# @!attribute [rw] bucket
|
6541
|
-
# The general purpose bucket that
|
6906
|
+
# The general purpose bucket that corresponds to the metadata table
|
6542
6907
|
# configuration that you want to retrieve.
|
6543
6908
|
# @return [String]
|
6544
6909
|
#
|
6545
6910
|
# @!attribute [rw] expected_bucket_owner
|
6546
6911
|
# The expected owner of the general purpose bucket that you want to
|
6547
|
-
# retrieve the metadata table configuration
|
6912
|
+
# retrieve the metadata table configuration for.
|
6548
6913
|
# @return [String]
|
6549
6914
|
#
|
6550
6915
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfigurationRequest AWS API Documentation
|
@@ -6556,10 +6921,21 @@ module Aws::S3
|
|
6556
6921
|
include Aws::Structure
|
6557
6922
|
end
|
6558
6923
|
|
6559
|
-
# The
|
6924
|
+
# The V1 S3 Metadata configuration for a general purpose bucket.
|
6925
|
+
#
|
6926
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
6927
|
+
# recommend that you delete and re-create your configuration by using
|
6928
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
6929
|
+
# table records and create a live inventory table.
|
6930
|
+
#
|
6931
|
+
# </note>
|
6932
|
+
#
|
6933
|
+
#
|
6934
|
+
#
|
6935
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
6560
6936
|
#
|
6561
6937
|
# @!attribute [rw] metadata_table_configuration_result
|
6562
|
-
# The
|
6938
|
+
# The V1 S3 Metadata configuration for a general purpose bucket.
|
6563
6939
|
# @return [Types::MetadataTableConfigurationResult]
|
6564
6940
|
#
|
6565
6941
|
# @!attribute [rw] status
|
@@ -6568,7 +6944,7 @@ module Aws::S3
|
|
6568
6944
|
# * `CREATING` - The metadata table is in the process of being created
|
6569
6945
|
# in the specified table bucket.
|
6570
6946
|
#
|
6571
|
-
# * `ACTIVE` - The metadata table has been created successfully and
|
6947
|
+
# * `ACTIVE` - The metadata table has been created successfully, and
|
6572
6948
|
# records are being delivered to the table.
|
6573
6949
|
#
|
6574
6950
|
# * `FAILED` - Amazon S3 is unable to create the metadata table, or
|
@@ -7222,15 +7598,15 @@ module Aws::S3
|
|
7222
7598
|
# A container for elements related to a particular part. A response
|
7223
7599
|
# can contain zero or more `Parts` elements.
|
7224
7600
|
#
|
7225
|
-
# <note markdown="1"> * **General purpose buckets** - For `GetObjectAttributes`, if
|
7601
|
+
# <note markdown="1"> * **General purpose buckets** - For `GetObjectAttributes`, if an
|
7226
7602
|
# additional checksum (including `x-amz-checksum-crc32`,
|
7227
7603
|
# `x-amz-checksum-crc32c`, `x-amz-checksum-sha1`, or
|
7228
7604
|
# `x-amz-checksum-sha256`) isn't applied to the object specified in
|
7229
|
-
# the request, the response doesn't return `Part
|
7605
|
+
# the request, the response doesn't return the `Part` element.
|
7230
7606
|
#
|
7231
|
-
# * **Directory buckets** - For `GetObjectAttributes`,
|
7232
|
-
# whether
|
7233
|
-
# in the request, the response returns `Part
|
7607
|
+
# * **Directory buckets** - For `GetObjectAttributes`, regardless of
|
7608
|
+
# whether an additional checksum is applied to the object specified
|
7609
|
+
# in the request, the response returns the `Part` element.
|
7234
7610
|
#
|
7235
7611
|
# </note>
|
7236
7612
|
# @return [Array<Types::ObjectPart>]
|
@@ -7747,7 +8123,13 @@ module Aws::S3
|
|
7747
8123
|
#
|
7748
8124
|
# @!attribute [rw] server_side_encryption
|
7749
8125
|
# The server-side encryption algorithm used when you store this object
|
7750
|
-
# in Amazon S3.
|
8126
|
+
# in Amazon S3 or Amazon FSx.
|
8127
|
+
#
|
8128
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
8129
|
+
# access points, the only valid server side encryption option is
|
8130
|
+
# `aws:fsx`.
|
8131
|
+
#
|
8132
|
+
# </note>
|
7751
8133
|
# @return [String]
|
7752
8134
|
#
|
7753
8135
|
# @!attribute [rw] metadata
|
@@ -8646,6 +9028,21 @@ module Aws::S3
|
|
8646
9028
|
include Aws::Structure
|
8647
9029
|
end
|
8648
9030
|
|
9031
|
+
# @!attribute [rw] bucket_arn
|
9032
|
+
# The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely
|
9033
|
+
# identify Amazon Web Services resources across all of Amazon Web
|
9034
|
+
# Services.
|
9035
|
+
#
|
9036
|
+
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
9037
|
+
# information, see [Using tags with directory buckets][1].
|
9038
|
+
#
|
9039
|
+
# </note>
|
9040
|
+
#
|
9041
|
+
#
|
9042
|
+
#
|
9043
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html
|
9044
|
+
# @return [String]
|
9045
|
+
#
|
8649
9046
|
# @!attribute [rw] bucket_location_type
|
8650
9047
|
# The type of location where the bucket is created.
|
8651
9048
|
#
|
@@ -8682,6 +9079,7 @@ module Aws::S3
|
|
8682
9079
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucketOutput AWS API Documentation
|
8683
9080
|
#
|
8684
9081
|
class HeadBucketOutput < Struct.new(
|
9082
|
+
:bucket_arn,
|
8685
9083
|
:bucket_location_type,
|
8686
9084
|
:bucket_location_name,
|
8687
9085
|
:bucket_region,
|
@@ -8995,7 +9393,13 @@ module Aws::S3
|
|
8995
9393
|
#
|
8996
9394
|
# @!attribute [rw] server_side_encryption
|
8997
9395
|
# The server-side encryption algorithm used when you store this object
|
8998
|
-
# in Amazon S3
|
9396
|
+
# in Amazon S3 or Amazon FSx.
|
9397
|
+
#
|
9398
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
9399
|
+
# access points, the only valid server side encryption option is
|
9400
|
+
# `aws:fsx`.
|
9401
|
+
#
|
9402
|
+
# </note>
|
8999
9403
|
# @return [String]
|
9000
9404
|
#
|
9001
9405
|
# @!attribute [rw] metadata
|
@@ -9121,6 +9525,22 @@ module Aws::S3
|
|
9121
9525
|
# as a multipart upload.
|
9122
9526
|
# @return [Integer]
|
9123
9527
|
#
|
9528
|
+
# @!attribute [rw] tag_count
|
9529
|
+
# The number of tags, if any, on the object, when you have the
|
9530
|
+
# relevant permission to read object tags.
|
9531
|
+
#
|
9532
|
+
# You can use [GetObjectTagging][1] to retrieve the tag set associated
|
9533
|
+
# with an object.
|
9534
|
+
#
|
9535
|
+
# <note markdown="1"> This functionality is not supported for directory buckets.
|
9536
|
+
#
|
9537
|
+
# </note>
|
9538
|
+
#
|
9539
|
+
#
|
9540
|
+
#
|
9541
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
|
9542
|
+
# @return [Integer]
|
9543
|
+
#
|
9124
9544
|
# @!attribute [rw] object_lock_mode
|
9125
9545
|
# The Object Lock mode, if any, that's in effect for this object.
|
9126
9546
|
# This header is only returned if the requester has the
|
@@ -9201,6 +9621,7 @@ module Aws::S3
|
|
9201
9621
|
:request_charged,
|
9202
9622
|
:replication_status,
|
9203
9623
|
:parts_count,
|
9624
|
+
:tag_count,
|
9204
9625
|
:object_lock_mode,
|
9205
9626
|
:object_lock_retain_until_date,
|
9206
9627
|
:object_lock_legal_hold_status)
|
@@ -9489,6 +9910,27 @@ module Aws::S3
|
|
9489
9910
|
include Aws::Structure
|
9490
9911
|
end
|
9491
9912
|
|
9913
|
+
# Parameters on this idempotent request are inconsistent with parameters
|
9914
|
+
# used in previous request(s).
|
9915
|
+
#
|
9916
|
+
# For a list of error codes and more information on Amazon S3 errors,
|
9917
|
+
# see [Error codes][1].
|
9918
|
+
#
|
9919
|
+
# <note markdown="1"> Idempotency ensures that an API request completes no more than one
|
9920
|
+
# time. With an idempotent request, if the original request completes
|
9921
|
+
# successfully, any subsequent retries complete successfully without
|
9922
|
+
# performing any further actions.
|
9923
|
+
#
|
9924
|
+
# </note>
|
9925
|
+
#
|
9926
|
+
#
|
9927
|
+
#
|
9928
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
|
9929
|
+
#
|
9930
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/IdempotencyParameterMismatch AWS API Documentation
|
9931
|
+
#
|
9932
|
+
class IdempotencyParameterMismatch < Aws::EmptyStructure; end
|
9933
|
+
|
9492
9934
|
# Container for the `Suffix` element.
|
9493
9935
|
#
|
9494
9936
|
# @!attribute [rw] suffix
|
@@ -9729,7 +10171,7 @@ module Aws::S3
|
|
9729
10171
|
#
|
9730
10172
|
class InvalidWriteOffset < Aws::EmptyStructure; end
|
9731
10173
|
|
9732
|
-
# Specifies the
|
10174
|
+
# Specifies the S3 Inventory configuration for an Amazon S3 bucket. For
|
9733
10175
|
# more information, see [GET Bucket inventory][1] in the *Amazon S3 API
|
9734
10176
|
# Reference*.
|
9735
10177
|
#
|
@@ -9787,7 +10229,7 @@ module Aws::S3
|
|
9787
10229
|
include Aws::Structure
|
9788
10230
|
end
|
9789
10231
|
|
9790
|
-
# Specifies the
|
10232
|
+
# Specifies the S3 Inventory configuration for an Amazon S3 bucket.
|
9791
10233
|
#
|
9792
10234
|
# @!attribute [rw] s3_bucket_destination
|
9793
10235
|
# Contains the bucket name, file format, bucket owner (optional), and
|
@@ -9802,8 +10244,8 @@ module Aws::S3
|
|
9802
10244
|
include Aws::Structure
|
9803
10245
|
end
|
9804
10246
|
|
9805
|
-
# Contains the type of server-side encryption used to encrypt the
|
9806
|
-
#
|
10247
|
+
# Contains the type of server-side encryption used to encrypt the S3
|
10248
|
+
# Inventory results.
|
9807
10249
|
#
|
9808
10250
|
# @!attribute [rw] sses3
|
9809
10251
|
# Specifies the use of SSE-S3 to encrypt delivered inventory reports.
|
@@ -9822,7 +10264,7 @@ module Aws::S3
|
|
9822
10264
|
include Aws::Structure
|
9823
10265
|
end
|
9824
10266
|
|
9825
|
-
# Specifies an
|
10267
|
+
# Specifies an S3 Inventory filter. The inventory only includes objects
|
9826
10268
|
# that meet the filter's criteria.
|
9827
10269
|
#
|
9828
10270
|
# @!attribute [rw] prefix
|
@@ -9839,7 +10281,7 @@ module Aws::S3
|
|
9839
10281
|
end
|
9840
10282
|
|
9841
10283
|
# Contains the bucket name, file format, bucket owner (optional), and
|
9842
|
-
# prefix (optional) where
|
10284
|
+
# prefix (optional) where S3 Inventory results are published.
|
9843
10285
|
#
|
9844
10286
|
# @!attribute [rw] account_id
|
9845
10287
|
# The account ID that owns the destination S3 bucket. If no account ID
|
@@ -9882,7 +10324,7 @@ module Aws::S3
|
|
9882
10324
|
include Aws::Structure
|
9883
10325
|
end
|
9884
10326
|
|
9885
|
-
# Specifies the schedule for generating
|
10327
|
+
# Specifies the schedule for generating S3 Inventory results.
|
9886
10328
|
#
|
9887
10329
|
# @!attribute [rw] frequency
|
9888
10330
|
# Specifies how frequently inventory results are produced.
|
@@ -9896,6 +10338,117 @@ module Aws::S3
|
|
9896
10338
|
include Aws::Structure
|
9897
10339
|
end
|
9898
10340
|
|
10341
|
+
# The inventory table configuration for an S3 Metadata configuration.
|
10342
|
+
#
|
10343
|
+
# @!attribute [rw] configuration_state
|
10344
|
+
# The configuration state of the inventory table, indicating whether
|
10345
|
+
# the inventory table is enabled or disabled.
|
10346
|
+
# @return [String]
|
10347
|
+
#
|
10348
|
+
# @!attribute [rw] encryption_configuration
|
10349
|
+
# The encryption configuration for the inventory table.
|
10350
|
+
# @return [Types::MetadataTableEncryptionConfiguration]
|
10351
|
+
#
|
10352
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/InventoryTableConfiguration AWS API Documentation
|
10353
|
+
#
|
10354
|
+
class InventoryTableConfiguration < Struct.new(
|
10355
|
+
:configuration_state,
|
10356
|
+
:encryption_configuration)
|
10357
|
+
SENSITIVE = []
|
10358
|
+
include Aws::Structure
|
10359
|
+
end
|
10360
|
+
|
10361
|
+
# The inventory table configuration for an S3 Metadata configuration.
|
10362
|
+
#
|
10363
|
+
# @!attribute [rw] configuration_state
|
10364
|
+
# The configuration state of the inventory table, indicating whether
|
10365
|
+
# the inventory table is enabled or disabled.
|
10366
|
+
# @return [String]
|
10367
|
+
#
|
10368
|
+
# @!attribute [rw] table_status
|
10369
|
+
# The status of the inventory table. The status values are:
|
10370
|
+
#
|
10371
|
+
# * `CREATING` - The inventory table is in the process of being
|
10372
|
+
# created in the specified Amazon Web Services managed table bucket.
|
10373
|
+
#
|
10374
|
+
# * `BACKFILLING` - The inventory table is in the process of being
|
10375
|
+
# backfilled. When you enable the inventory table for your metadata
|
10376
|
+
# configuration, the table goes through a process known as
|
10377
|
+
# backfilling, during which Amazon S3 scans your general purpose
|
10378
|
+
# bucket to retrieve the initial metadata for all objects in the
|
10379
|
+
# bucket. Depending on the number of objects in your bucket, this
|
10380
|
+
# process can take several hours. When the backfilling process is
|
10381
|
+
# finished, the status of your inventory table changes from
|
10382
|
+
# `BACKFILLING` to `ACTIVE`. After backfilling is completed, updates
|
10383
|
+
# to your objects are reflected in the inventory table within one
|
10384
|
+
# hour.
|
10385
|
+
#
|
10386
|
+
# * `ACTIVE` - The inventory table has been created successfully, and
|
10387
|
+
# records are being delivered to the table.
|
10388
|
+
#
|
10389
|
+
# * `FAILED` - Amazon S3 is unable to create the inventory table, or
|
10390
|
+
# Amazon S3 is unable to deliver records.
|
10391
|
+
# @return [String]
|
10392
|
+
#
|
10393
|
+
# @!attribute [rw] error
|
10394
|
+
# If an S3 Metadata V1 `CreateBucketMetadataTableConfiguration` or V2
|
10395
|
+
# `CreateBucketMetadataConfiguration` request succeeds, but S3
|
10396
|
+
# Metadata was unable to create the table, this structure contains the
|
10397
|
+
# error code and error message.
|
10398
|
+
#
|
10399
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025,
|
10400
|
+
# we recommend that you delete and re-create your configuration by
|
10401
|
+
# using [CreateBucketMetadataConfiguration][1] so that you can expire
|
10402
|
+
# journal table records and create a live inventory table.
|
10403
|
+
#
|
10404
|
+
# </note>
|
10405
|
+
#
|
10406
|
+
#
|
10407
|
+
#
|
10408
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
10409
|
+
# @return [Types::ErrorDetails]
|
10410
|
+
#
|
10411
|
+
# @!attribute [rw] table_name
|
10412
|
+
# The name of the inventory table.
|
10413
|
+
# @return [String]
|
10414
|
+
#
|
10415
|
+
# @!attribute [rw] table_arn
|
10416
|
+
# The Amazon Resource Name (ARN) for the inventory table.
|
10417
|
+
# @return [String]
|
10418
|
+
#
|
10419
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/InventoryTableConfigurationResult AWS API Documentation
|
10420
|
+
#
|
10421
|
+
class InventoryTableConfigurationResult < Struct.new(
|
10422
|
+
:configuration_state,
|
10423
|
+
:table_status,
|
10424
|
+
:error,
|
10425
|
+
:table_name,
|
10426
|
+
:table_arn)
|
10427
|
+
SENSITIVE = []
|
10428
|
+
include Aws::Structure
|
10429
|
+
end
|
10430
|
+
|
10431
|
+
# The specified updates to the S3 Metadata inventory table
|
10432
|
+
# configuration.
|
10433
|
+
#
|
10434
|
+
# @!attribute [rw] configuration_state
|
10435
|
+
# The configuration state of the inventory table, indicating whether
|
10436
|
+
# the inventory table is enabled or disabled.
|
10437
|
+
# @return [String]
|
10438
|
+
#
|
10439
|
+
# @!attribute [rw] encryption_configuration
|
10440
|
+
# The encryption configuration for the inventory table.
|
10441
|
+
# @return [Types::MetadataTableEncryptionConfiguration]
|
10442
|
+
#
|
10443
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/InventoryTableConfigurationUpdates AWS API Documentation
|
10444
|
+
#
|
10445
|
+
class InventoryTableConfigurationUpdates < Struct.new(
|
10446
|
+
:configuration_state,
|
10447
|
+
:encryption_configuration)
|
10448
|
+
SENSITIVE = []
|
10449
|
+
include Aws::Structure
|
10450
|
+
end
|
10451
|
+
|
9899
10452
|
# Specifies JSON as object's input serialization format.
|
9900
10453
|
#
|
9901
10454
|
# @!attribute [rw] type
|
@@ -9925,6 +10478,96 @@ module Aws::S3
|
|
9925
10478
|
include Aws::Structure
|
9926
10479
|
end
|
9927
10480
|
|
10481
|
+
# The journal table configuration for an S3 Metadata configuration.
|
10482
|
+
#
|
10483
|
+
# @!attribute [rw] record_expiration
|
10484
|
+
# The journal table record expiration settings for the journal table.
|
10485
|
+
# @return [Types::RecordExpiration]
|
10486
|
+
#
|
10487
|
+
# @!attribute [rw] encryption_configuration
|
10488
|
+
# The encryption configuration for the journal table.
|
10489
|
+
# @return [Types::MetadataTableEncryptionConfiguration]
|
10490
|
+
#
|
10491
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/JournalTableConfiguration AWS API Documentation
|
10492
|
+
#
|
10493
|
+
class JournalTableConfiguration < Struct.new(
|
10494
|
+
:record_expiration,
|
10495
|
+
:encryption_configuration)
|
10496
|
+
SENSITIVE = []
|
10497
|
+
include Aws::Structure
|
10498
|
+
end
|
10499
|
+
|
10500
|
+
# The journal table configuration for the S3 Metadata configuration.
|
10501
|
+
#
|
10502
|
+
# @!attribute [rw] table_status
|
10503
|
+
# The status of the journal table. The status values are:
|
10504
|
+
#
|
10505
|
+
# * `CREATING` - The journal table is in the process of being created
|
10506
|
+
# in the specified table bucket.
|
10507
|
+
#
|
10508
|
+
# * `ACTIVE` - The journal table has been created successfully, and
|
10509
|
+
# records are being delivered to the table.
|
10510
|
+
#
|
10511
|
+
# * `FAILED` - Amazon S3 is unable to create the journal table, or
|
10512
|
+
# Amazon S3 is unable to deliver records.
|
10513
|
+
# @return [String]
|
10514
|
+
#
|
10515
|
+
# @!attribute [rw] error
|
10516
|
+
# If an S3 Metadata V1 `CreateBucketMetadataTableConfiguration` or V2
|
10517
|
+
# `CreateBucketMetadataConfiguration` request succeeds, but S3
|
10518
|
+
# Metadata was unable to create the table, this structure contains the
|
10519
|
+
# error code and error message.
|
10520
|
+
#
|
10521
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025,
|
10522
|
+
# we recommend that you delete and re-create your configuration by
|
10523
|
+
# using [CreateBucketMetadataConfiguration][1] so that you can expire
|
10524
|
+
# journal table records and create a live inventory table.
|
10525
|
+
#
|
10526
|
+
# </note>
|
10527
|
+
#
|
10528
|
+
#
|
10529
|
+
#
|
10530
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
10531
|
+
# @return [Types::ErrorDetails]
|
10532
|
+
#
|
10533
|
+
# @!attribute [rw] table_name
|
10534
|
+
# The name of the journal table.
|
10535
|
+
# @return [String]
|
10536
|
+
#
|
10537
|
+
# @!attribute [rw] table_arn
|
10538
|
+
# The Amazon Resource Name (ARN) for the journal table.
|
10539
|
+
# @return [String]
|
10540
|
+
#
|
10541
|
+
# @!attribute [rw] record_expiration
|
10542
|
+
# The journal table record expiration settings for the journal table.
|
10543
|
+
# @return [Types::RecordExpiration]
|
10544
|
+
#
|
10545
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/JournalTableConfigurationResult AWS API Documentation
|
10546
|
+
#
|
10547
|
+
class JournalTableConfigurationResult < Struct.new(
|
10548
|
+
:table_status,
|
10549
|
+
:error,
|
10550
|
+
:table_name,
|
10551
|
+
:table_arn,
|
10552
|
+
:record_expiration)
|
10553
|
+
SENSITIVE = []
|
10554
|
+
include Aws::Structure
|
10555
|
+
end
|
10556
|
+
|
10557
|
+
# The specified updates to the S3 Metadata journal table configuration.
|
10558
|
+
#
|
10559
|
+
# @!attribute [rw] record_expiration
|
10560
|
+
# The journal table record expiration settings for the journal table.
|
10561
|
+
# @return [Types::RecordExpiration]
|
10562
|
+
#
|
10563
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/JournalTableConfigurationUpdates AWS API Documentation
|
10564
|
+
#
|
10565
|
+
class JournalTableConfigurationUpdates < Struct.new(
|
10566
|
+
:record_expiration)
|
10567
|
+
SENSITIVE = []
|
10568
|
+
include Aws::Structure
|
10569
|
+
end
|
10570
|
+
|
9928
10571
|
# A container for specifying the configuration for Lambda notifications.
|
9929
10572
|
#
|
9930
10573
|
# @!attribute [rw] id
|
@@ -10076,9 +10719,16 @@ module Aws::S3
|
|
10076
10719
|
# `Filter` is required if the `LifecycleRule` does not contain a
|
10077
10720
|
# `Prefix` element.
|
10078
10721
|
#
|
10722
|
+
# For more information about `Tag` filters, see [Adding filters to
|
10723
|
+
# Lifecycle rules][1] in the *Amazon S3 User Guide*.
|
10724
|
+
#
|
10079
10725
|
# <note markdown="1"> `Tag` filters are not supported for directory buckets.
|
10080
10726
|
#
|
10081
10727
|
# </note>
|
10728
|
+
#
|
10729
|
+
#
|
10730
|
+
#
|
10731
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-filters.html
|
10082
10732
|
# @return [Types::LifecycleRuleFilter]
|
10083
10733
|
#
|
10084
10734
|
# @!attribute [rw] status
|
@@ -10344,11 +10994,19 @@ module Aws::S3
|
|
10344
10994
|
# this request should begin.
|
10345
10995
|
# @return [String]
|
10346
10996
|
#
|
10997
|
+
# @!attribute [rw] expected_bucket_owner
|
10998
|
+
# The account ID of the expected bucket owner. If the account ID that
|
10999
|
+
# you provide does not match the actual owner of the bucket, the
|
11000
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
11001
|
+
# denied).
|
11002
|
+
# @return [String]
|
11003
|
+
#
|
10347
11004
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketIntelligentTieringConfigurationsRequest AWS API Documentation
|
10348
11005
|
#
|
10349
11006
|
class ListBucketIntelligentTieringConfigurationsRequest < Struct.new(
|
10350
11007
|
:bucket,
|
10351
|
-
:continuation_token
|
11008
|
+
:continuation_token,
|
11009
|
+
:expected_bucket_owner)
|
10352
11010
|
SENSITIVE = []
|
10353
11011
|
include Aws::Structure
|
10354
11012
|
end
|
@@ -10809,6 +11467,9 @@ module Aws::S3
|
|
10809
11467
|
# `CommonPrefixes` result element are not returned elsewhere in the
|
10810
11468
|
# response.
|
10811
11469
|
#
|
11470
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11471
|
+
# lexicographically greater than the key-marker.
|
11472
|
+
#
|
10812
11473
|
# <note markdown="1"> **Directory buckets** - For directory buckets, `/` is the only
|
10813
11474
|
# supported delimiter.
|
10814
11475
|
#
|
@@ -11068,6 +11729,9 @@ module Aws::S3
|
|
11068
11729
|
# element in `CommonPrefixes`. These groups are counted as one result
|
11069
11730
|
# against the `max-keys` limitation. These keys are not returned
|
11070
11731
|
# elsewhere in the response.
|
11732
|
+
#
|
11733
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
11734
|
+
# lexicographically greater than the key-marker.
|
11071
11735
|
# @return [String]
|
11072
11736
|
#
|
11073
11737
|
# @!attribute [rw] encoding_type
|
@@ -11341,6 +12005,9 @@ module Aws::S3
|
|
11341
12005
|
#
|
11342
12006
|
# @!attribute [rw] delimiter
|
11343
12007
|
# A delimiter is a character that you use to group keys.
|
12008
|
+
#
|
12009
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
12010
|
+
# lexicographically greater than the key-marker.
|
11344
12011
|
# @return [String]
|
11345
12012
|
#
|
11346
12013
|
# @!attribute [rw] encoding_type
|
@@ -11517,8 +12184,7 @@ module Aws::S3
|
|
11517
12184
|
# @!attribute [rw] continuation_token
|
11518
12185
|
# If `ContinuationToken` was sent with the request, it is included in
|
11519
12186
|
# the response. You can use the returned `ContinuationToken` for
|
11520
|
-
# pagination of the list response.
|
11521
|
-
# `ContinuationToken` for pagination of the list results.
|
12187
|
+
# pagination of the list response.
|
11522
12188
|
# @return [String]
|
11523
12189
|
#
|
11524
12190
|
# @!attribute [rw] next_continuation_token
|
@@ -11621,6 +12287,9 @@ module Aws::S3
|
|
11621
12287
|
# @!attribute [rw] delimiter
|
11622
12288
|
# A delimiter is a character that you use to group keys.
|
11623
12289
|
#
|
12290
|
+
# `CommonPrefixes` is filtered out from results if it is not
|
12291
|
+
# lexicographically greater than the `StartAfter` value.
|
12292
|
+
#
|
11624
12293
|
# <note markdown="1"> * **Directory buckets** - For directory buckets, `/` is the only
|
11625
12294
|
# supported delimiter.
|
11626
12295
|
#
|
@@ -12145,6 +12814,49 @@ module Aws::S3
|
|
12145
12814
|
include Aws::Structure
|
12146
12815
|
end
|
12147
12816
|
|
12817
|
+
# The S3 Metadata configuration for a general purpose bucket.
|
12818
|
+
#
|
12819
|
+
# @!attribute [rw] journal_table_configuration
|
12820
|
+
# The journal table configuration for a metadata configuration.
|
12821
|
+
# @return [Types::JournalTableConfiguration]
|
12822
|
+
#
|
12823
|
+
# @!attribute [rw] inventory_table_configuration
|
12824
|
+
# The inventory table configuration for a metadata configuration.
|
12825
|
+
# @return [Types::InventoryTableConfiguration]
|
12826
|
+
#
|
12827
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataConfiguration AWS API Documentation
|
12828
|
+
#
|
12829
|
+
class MetadataConfiguration < Struct.new(
|
12830
|
+
:journal_table_configuration,
|
12831
|
+
:inventory_table_configuration)
|
12832
|
+
SENSITIVE = []
|
12833
|
+
include Aws::Structure
|
12834
|
+
end
|
12835
|
+
|
12836
|
+
# The S3 Metadata configuration for a general purpose bucket.
|
12837
|
+
#
|
12838
|
+
# @!attribute [rw] destination_result
|
12839
|
+
# The destination settings for a metadata configuration.
|
12840
|
+
# @return [Types::DestinationResult]
|
12841
|
+
#
|
12842
|
+
# @!attribute [rw] journal_table_configuration_result
|
12843
|
+
# The journal table configuration for a metadata configuration.
|
12844
|
+
# @return [Types::JournalTableConfigurationResult]
|
12845
|
+
#
|
12846
|
+
# @!attribute [rw] inventory_table_configuration_result
|
12847
|
+
# The inventory table configuration for a metadata configuration.
|
12848
|
+
# @return [Types::InventoryTableConfigurationResult]
|
12849
|
+
#
|
12850
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataConfigurationResult AWS API Documentation
|
12851
|
+
#
|
12852
|
+
class MetadataConfigurationResult < Struct.new(
|
12853
|
+
:destination_result,
|
12854
|
+
:journal_table_configuration_result,
|
12855
|
+
:inventory_table_configuration_result)
|
12856
|
+
SENSITIVE = []
|
12857
|
+
include Aws::Structure
|
12858
|
+
end
|
12859
|
+
|
12148
12860
|
# A metadata key-value pair to store with an object.
|
12149
12861
|
#
|
12150
12862
|
# @!attribute [rw] name
|
@@ -12164,7 +12876,18 @@ module Aws::S3
|
|
12164
12876
|
include Aws::Structure
|
12165
12877
|
end
|
12166
12878
|
|
12167
|
-
# The
|
12879
|
+
# The V1 S3 Metadata configuration for a general purpose bucket.
|
12880
|
+
#
|
12881
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
12882
|
+
# recommend that you delete and re-create your configuration by using
|
12883
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
12884
|
+
# table records and create a live inventory table.
|
12885
|
+
#
|
12886
|
+
# </note>
|
12887
|
+
#
|
12888
|
+
#
|
12889
|
+
#
|
12890
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
12168
12891
|
#
|
12169
12892
|
# @!attribute [rw] s3_tables_destination
|
12170
12893
|
# The destination information for the metadata table configuration.
|
@@ -12182,12 +12905,23 @@ module Aws::S3
|
|
12182
12905
|
include Aws::Structure
|
12183
12906
|
end
|
12184
12907
|
|
12185
|
-
# The
|
12908
|
+
# The V1 S3 Metadata configuration for a general purpose bucket. The
|
12186
12909
|
# destination table bucket must be in the same Region and Amazon Web
|
12187
12910
|
# Services account as the general purpose bucket. The specified metadata
|
12188
12911
|
# table name must be unique within the `aws_s3_metadata` namespace in
|
12189
12912
|
# the destination table bucket.
|
12190
12913
|
#
|
12914
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
12915
|
+
# recommend that you delete and re-create your configuration by using
|
12916
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
12917
|
+
# table records and create a live inventory table.
|
12918
|
+
#
|
12919
|
+
# </note>
|
12920
|
+
#
|
12921
|
+
#
|
12922
|
+
#
|
12923
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
12924
|
+
#
|
12191
12925
|
# @!attribute [rw] s3_tables_destination_result
|
12192
12926
|
# The destination information for the metadata table configuration.
|
12193
12927
|
# The destination table bucket must be in the same Region and Amazon
|
@@ -12204,6 +12938,34 @@ module Aws::S3
|
|
12204
12938
|
include Aws::Structure
|
12205
12939
|
end
|
12206
12940
|
|
12941
|
+
# The encryption settings for an S3 Metadata journal table or inventory
|
12942
|
+
# table configuration.
|
12943
|
+
#
|
12944
|
+
# @!attribute [rw] sse_algorithm
|
12945
|
+
# The encryption type specified for a metadata table. To specify
|
12946
|
+
# server-side encryption with Key Management Service (KMS) keys
|
12947
|
+
# (SSE-KMS), use the `aws:kms` value. To specify server-side
|
12948
|
+
# encryption with Amazon S3 managed keys (SSE-S3), use the `AES256`
|
12949
|
+
# value.
|
12950
|
+
# @return [String]
|
12951
|
+
#
|
12952
|
+
# @!attribute [rw] kms_key_arn
|
12953
|
+
# If server-side encryption with Key Management Service (KMS) keys
|
12954
|
+
# (SSE-KMS) is specified, you must also specify the KMS key Amazon
|
12955
|
+
# Resource Name (ARN). You must specify a customer-managed KMS key
|
12956
|
+
# that's located in the same Region as the general purpose bucket
|
12957
|
+
# that corresponds to the metadata table configuration.
|
12958
|
+
# @return [String]
|
12959
|
+
#
|
12960
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataTableEncryptionConfiguration AWS API Documentation
|
12961
|
+
#
|
12962
|
+
class MetadataTableEncryptionConfiguration < Struct.new(
|
12963
|
+
:sse_algorithm,
|
12964
|
+
:kms_key_arn)
|
12965
|
+
SENSITIVE = []
|
12966
|
+
include Aws::Structure
|
12967
|
+
end
|
12968
|
+
|
12207
12969
|
# A container specifying replication metrics-related settings enabling
|
12208
12970
|
# replication metrics and events.
|
12209
12971
|
#
|
@@ -13055,6 +13817,19 @@ module Aws::S3
|
|
13055
13817
|
include Aws::Structure
|
13056
13818
|
end
|
13057
13819
|
|
13820
|
+
# End of support notice: Beginning October 1, 2025, Amazon S3 will stop
|
13821
|
+
# returning `DisplayName`. Update your applications to use canonical IDs
|
13822
|
+
# (unique identifier for Amazon Web Services accounts), Amazon Web
|
13823
|
+
# Services account ID (12 digit identifier) or IAM ARNs (full resource
|
13824
|
+
# naming) as a direct replacement of `DisplayName`.
|
13825
|
+
#
|
13826
|
+
# This change affects the following Amazon Web Services Regions: US
|
13827
|
+
# East
|
13828
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
13829
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
13830
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
13831
|
+
# America (São Paulo) Region.
|
13832
|
+
#
|
13058
13833
|
# Container for the owner's display name and ID.
|
13059
13834
|
#
|
13060
13835
|
# @!attribute [rw] display_name
|
@@ -13736,6 +14511,13 @@ module Aws::S3
|
|
13736
14511
|
# The ID used to identify the S3 Intelligent-Tiering configuration.
|
13737
14512
|
# @return [String]
|
13738
14513
|
#
|
14514
|
+
# @!attribute [rw] expected_bucket_owner
|
14515
|
+
# The account ID of the expected bucket owner. If the account ID that
|
14516
|
+
# you provide does not match the actual owner of the bucket, the
|
14517
|
+
# request fails with the HTTP status code `403 Forbidden` (access
|
14518
|
+
# denied).
|
14519
|
+
# @return [String]
|
14520
|
+
#
|
13739
14521
|
# @!attribute [rw] intelligent_tiering_configuration
|
13740
14522
|
# Container for S3 Intelligent-Tiering configuration.
|
13741
14523
|
# @return [Types::IntelligentTieringConfiguration]
|
@@ -13745,6 +14527,7 @@ module Aws::S3
|
|
13745
14527
|
class PutBucketIntelligentTieringConfigurationRequest < Struct.new(
|
13746
14528
|
:bucket,
|
13747
14529
|
:id,
|
14530
|
+
:expected_bucket_owner,
|
13748
14531
|
:intelligent_tiering_configuration)
|
13749
14532
|
SENSITIVE = []
|
13750
14533
|
include Aws::Structure
|
@@ -15115,7 +15898,13 @@ module Aws::S3
|
|
15115
15898
|
#
|
15116
15899
|
# @!attribute [rw] server_side_encryption
|
15117
15900
|
# The server-side encryption algorithm used when you store this object
|
15118
|
-
# in Amazon S3.
|
15901
|
+
# in Amazon S3 or Amazon FSx.
|
15902
|
+
#
|
15903
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
15904
|
+
# access points, the only valid server side encryption option is
|
15905
|
+
# `aws:fsx`.
|
15906
|
+
#
|
15907
|
+
# </note>
|
15119
15908
|
# @return [String]
|
15120
15909
|
#
|
15121
15910
|
# @!attribute [rw] version_id
|
@@ -15627,8 +16416,7 @@ module Aws::S3
|
|
15627
16416
|
#
|
15628
16417
|
# @!attribute [rw] server_side_encryption
|
15629
16418
|
# The server-side encryption algorithm that was used when you store
|
15630
|
-
# this object in Amazon S3
|
15631
|
-
# `aws:kms:dsse`).
|
16419
|
+
# this object in Amazon S3 or Amazon FSx.
|
15632
16420
|
#
|
15633
16421
|
# * <b>General purpose buckets </b> - You have four mutually exclusive
|
15634
16422
|
# options to protect data using server-side encryption in Amazon S3,
|
@@ -15683,6 +16471,14 @@ module Aws::S3
|
|
15683
16471
|
#
|
15684
16472
|
# </note>
|
15685
16473
|
#
|
16474
|
+
# * <b>S3 access points for Amazon FSx </b> - When accessing data
|
16475
|
+
# stored in Amazon FSx file systems using S3 access points, the only
|
16476
|
+
# valid server side encryption option is `aws:fsx`. All Amazon FSx
|
16477
|
+
# file systems have encryption configured by default and are
|
16478
|
+
# encrypted at rest. Data is automatically encrypted before being
|
16479
|
+
# written to the file system, and automatically decrypted as it is
|
16480
|
+
# read. These processes are handled transparently by Amazon FSx.
|
16481
|
+
#
|
15686
16482
|
#
|
15687
16483
|
#
|
15688
16484
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
@@ -16368,6 +17164,32 @@ module Aws::S3
|
|
16368
17164
|
include Aws::Structure
|
16369
17165
|
end
|
16370
17166
|
|
17167
|
+
# The journal table record expiration settings for a journal table in an
|
17168
|
+
# S3 Metadata configuration.
|
17169
|
+
#
|
17170
|
+
# @!attribute [rw] expiration
|
17171
|
+
# Specifies whether journal table record expiration is enabled or
|
17172
|
+
# disabled.
|
17173
|
+
# @return [String]
|
17174
|
+
#
|
17175
|
+
# @!attribute [rw] days
|
17176
|
+
# If you enable journal table record expiration, you can set the
|
17177
|
+
# number of days to retain your journal table records. Journal table
|
17178
|
+
# records must be retained for a minimum of 7 days. To set this value,
|
17179
|
+
# specify any whole number from `7` to `2147483647`. For example, to
|
17180
|
+
# retain your journal table records for one year, set this value to
|
17181
|
+
# `365`.
|
17182
|
+
# @return [Integer]
|
17183
|
+
#
|
17184
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RecordExpiration AWS API Documentation
|
17185
|
+
#
|
17186
|
+
class RecordExpiration < Struct.new(
|
17187
|
+
:expiration,
|
17188
|
+
:days)
|
17189
|
+
SENSITIVE = []
|
17190
|
+
include Aws::Structure
|
17191
|
+
end
|
17192
|
+
|
16371
17193
|
# The container for the records event.
|
16372
17194
|
#
|
16373
17195
|
# @!attribute [rw] payload
|
@@ -16474,6 +17296,129 @@ module Aws::S3
|
|
16474
17296
|
include Aws::Structure
|
16475
17297
|
end
|
16476
17298
|
|
17299
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObjectOutput AWS API Documentation
|
17300
|
+
#
|
17301
|
+
class RenameObjectOutput < Aws::EmptyStructure; end
|
17302
|
+
|
17303
|
+
# @!attribute [rw] bucket
|
17304
|
+
# The bucket name of the directory bucket containing the object.
|
17305
|
+
#
|
17306
|
+
# You must use virtual-hosted-style requests in the format
|
17307
|
+
# `Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
|
17308
|
+
# Path-style requests are not supported. Directory bucket names must
|
17309
|
+
# be unique in the chosen Availability Zone. Bucket names must follow
|
17310
|
+
# the format `bucket-base-name--zone-id--x-s3 ` (for example,
|
17311
|
+
# `amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
|
17312
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
17313
|
+
# *Amazon S3 User Guide*.
|
17314
|
+
#
|
17315
|
+
#
|
17316
|
+
#
|
17317
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
|
17318
|
+
# @return [String]
|
17319
|
+
#
|
17320
|
+
# @!attribute [rw] key
|
17321
|
+
# Key name of the object to rename.
|
17322
|
+
# @return [String]
|
17323
|
+
#
|
17324
|
+
# @!attribute [rw] rename_source
|
17325
|
+
# Specifies the source for the rename operation. The value must be URL
|
17326
|
+
# encoded.
|
17327
|
+
# @return [String]
|
17328
|
+
#
|
17329
|
+
# @!attribute [rw] destination_if_match
|
17330
|
+
# Renames the object only if the ETag (entity tag) value provided
|
17331
|
+
# during the operation matches the ETag of the object in S3. The
|
17332
|
+
# `If-Match` header field makes the request method conditional on
|
17333
|
+
# ETags. If the ETag values do not match, the operation returns a `412
|
17334
|
+
# Precondition Failed` error.
|
17335
|
+
#
|
17336
|
+
# Expects the ETag value as a string.
|
17337
|
+
# @return [String]
|
17338
|
+
#
|
17339
|
+
# @!attribute [rw] destination_if_none_match
|
17340
|
+
# Renames the object only if the destination does not already exist in
|
17341
|
+
# the specified directory bucket. If the object does exist when you
|
17342
|
+
# send a request with `If-None-Match:*`, the S3 API will return a `412
|
17343
|
+
# Precondition Failed` error, preventing an overwrite. The
|
17344
|
+
# `If-None-Match` header prevents overwrites of existing data by
|
17345
|
+
# validating that there's not an object with the same key name
|
17346
|
+
# already in your directory bucket.
|
17347
|
+
#
|
17348
|
+
# Expects the `*` character (asterisk).
|
17349
|
+
# @return [String]
|
17350
|
+
#
|
17351
|
+
# @!attribute [rw] destination_if_modified_since
|
17352
|
+
# Renames the object if the destination exists and if it has been
|
17353
|
+
# modified since the specified time.
|
17354
|
+
# @return [Time]
|
17355
|
+
#
|
17356
|
+
# @!attribute [rw] destination_if_unmodified_since
|
17357
|
+
# Renames the object if it hasn't been modified since the specified
|
17358
|
+
# time.
|
17359
|
+
# @return [Time]
|
17360
|
+
#
|
17361
|
+
# @!attribute [rw] source_if_match
|
17362
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
17363
|
+
# matches the specified ETag.
|
17364
|
+
# @return [String]
|
17365
|
+
#
|
17366
|
+
# @!attribute [rw] source_if_none_match
|
17367
|
+
# Renames the object if the source exists and if its entity tag (ETag)
|
17368
|
+
# is different than the specified ETag. If an asterisk (`*`) character
|
17369
|
+
# is provided, the operation will fail and return a `412 Precondition
|
17370
|
+
# Failed` error.
|
17371
|
+
# @return [String]
|
17372
|
+
#
|
17373
|
+
# @!attribute [rw] source_if_modified_since
|
17374
|
+
# Renames the object if the source exists and if it has been modified
|
17375
|
+
# since the specified time.
|
17376
|
+
# @return [Time]
|
17377
|
+
#
|
17378
|
+
# @!attribute [rw] source_if_unmodified_since
|
17379
|
+
# Renames the object if the source exists and hasn't been modified
|
17380
|
+
# since the specified time.
|
17381
|
+
# @return [Time]
|
17382
|
+
#
|
17383
|
+
# @!attribute [rw] client_token
|
17384
|
+
# A unique string with a max of 64 ASCII characters in the ASCII range
|
17385
|
+
# of 33 - 126.
|
17386
|
+
#
|
17387
|
+
# <note markdown="1"> `RenameObject` supports idempotency using a client token. To make an
|
17388
|
+
# idempotent API request using `RenameObject`, specify a client token
|
17389
|
+
# in the request. You should not reuse the same client token for other
|
17390
|
+
# API requests. If you retry a request that completed successfully
|
17391
|
+
# using the same client token and the same parameters, the retry
|
17392
|
+
# succeeds without performing any further actions. If you retry a
|
17393
|
+
# successful request using the same client token, but one or more of
|
17394
|
+
# the parameters are different, the retry fails and an
|
17395
|
+
# `IdempotentParameterMismatch` error is returned.
|
17396
|
+
#
|
17397
|
+
# </note>
|
17398
|
+
#
|
17399
|
+
# **A suitable default value is auto-generated.** You should normally
|
17400
|
+
# not need to pass this option.
|
17401
|
+
# @return [String]
|
17402
|
+
#
|
17403
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RenameObjectRequest AWS API Documentation
|
17404
|
+
#
|
17405
|
+
class RenameObjectRequest < Struct.new(
|
17406
|
+
:bucket,
|
17407
|
+
:key,
|
17408
|
+
:rename_source,
|
17409
|
+
:destination_if_match,
|
17410
|
+
:destination_if_none_match,
|
17411
|
+
:destination_if_modified_since,
|
17412
|
+
:destination_if_unmodified_since,
|
17413
|
+
:source_if_match,
|
17414
|
+
:source_if_none_match,
|
17415
|
+
:source_if_modified_since,
|
17416
|
+
:source_if_unmodified_since,
|
17417
|
+
:client_token)
|
17418
|
+
SENSITIVE = []
|
17419
|
+
include Aws::Structure
|
17420
|
+
end
|
17421
|
+
|
16477
17422
|
# A filter that you can specify for selection for modifications on
|
16478
17423
|
# replicas. Amazon S3 doesn't replicate replica modifications by
|
16479
17424
|
# default. In the latest version of replication configuration (when
|
@@ -17233,12 +18178,23 @@ module Aws::S3
|
|
17233
18178
|
include Aws::Structure
|
17234
18179
|
end
|
17235
18180
|
|
17236
|
-
# The destination information for
|
18181
|
+
# The destination information for a V1 S3 Metadata configuration. The
|
17237
18182
|
# destination table bucket must be in the same Region and Amazon Web
|
17238
18183
|
# Services account as the general purpose bucket. The specified metadata
|
17239
18184
|
# table name must be unique within the `aws_s3_metadata` namespace in
|
17240
18185
|
# the destination table bucket.
|
17241
18186
|
#
|
18187
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
18188
|
+
# recommend that you delete and re-create your configuration by using
|
18189
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
18190
|
+
# table records and create a live inventory table.
|
18191
|
+
#
|
18192
|
+
# </note>
|
18193
|
+
#
|
18194
|
+
#
|
18195
|
+
#
|
18196
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
18197
|
+
#
|
17242
18198
|
# @!attribute [rw] table_bucket_arn
|
17243
18199
|
# The Amazon Resource Name (ARN) for the table bucket that's
|
17244
18200
|
# specified as the destination in the metadata table configuration.
|
@@ -17262,12 +18218,23 @@ module Aws::S3
|
|
17262
18218
|
include Aws::Structure
|
17263
18219
|
end
|
17264
18220
|
|
17265
|
-
# The destination information for
|
18221
|
+
# The destination information for a V1 S3 Metadata configuration. The
|
17266
18222
|
# destination table bucket must be in the same Region and Amazon Web
|
17267
18223
|
# Services account as the general purpose bucket. The specified metadata
|
17268
18224
|
# table name must be unique within the `aws_s3_metadata` namespace in
|
17269
18225
|
# the destination table bucket.
|
17270
18226
|
#
|
18227
|
+
# <note markdown="1"> If you created your S3 Metadata configuration before July 15, 2025, we
|
18228
|
+
# recommend that you delete and re-create your configuration by using
|
18229
|
+
# [CreateBucketMetadataConfiguration][1] so that you can expire journal
|
18230
|
+
# table records and create a live inventory table.
|
18231
|
+
#
|
18232
|
+
# </note>
|
18233
|
+
#
|
18234
|
+
#
|
18235
|
+
#
|
18236
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html
|
18237
|
+
#
|
17271
18238
|
# @!attribute [rw] table_bucket_arn
|
17272
18239
|
# The Amazon Resource Name (ARN) for the table bucket that's
|
17273
18240
|
# specified as the destination in the metadata table configuration.
|
@@ -18173,6 +19140,79 @@ module Aws::S3
|
|
18173
19140
|
include Aws::Structure
|
18174
19141
|
end
|
18175
19142
|
|
19143
|
+
# @!attribute [rw] bucket
|
19144
|
+
# The general purpose bucket that corresponds to the metadata
|
19145
|
+
# configuration that you want to enable or disable an inventory table
|
19146
|
+
# for.
|
19147
|
+
# @return [String]
|
19148
|
+
#
|
19149
|
+
# @!attribute [rw] content_md5
|
19150
|
+
# The `Content-MD5` header for the inventory table configuration.
|
19151
|
+
# @return [String]
|
19152
|
+
#
|
19153
|
+
# @!attribute [rw] checksum_algorithm
|
19154
|
+
# The checksum algorithm to use with your inventory table
|
19155
|
+
# configuration.
|
19156
|
+
# @return [String]
|
19157
|
+
#
|
19158
|
+
# @!attribute [rw] inventory_table_configuration
|
19159
|
+
# The contents of your inventory table configuration.
|
19160
|
+
# @return [Types::InventoryTableConfigurationUpdates]
|
19161
|
+
#
|
19162
|
+
# @!attribute [rw] expected_bucket_owner
|
19163
|
+
# The expected owner of the general purpose bucket that corresponds to
|
19164
|
+
# the metadata table configuration that you want to enable or disable
|
19165
|
+
# an inventory table for.
|
19166
|
+
# @return [String]
|
19167
|
+
#
|
19168
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UpdateBucketMetadataInventoryTableConfigurationRequest AWS API Documentation
|
19169
|
+
#
|
19170
|
+
class UpdateBucketMetadataInventoryTableConfigurationRequest < Struct.new(
|
19171
|
+
:bucket,
|
19172
|
+
:content_md5,
|
19173
|
+
:checksum_algorithm,
|
19174
|
+
:inventory_table_configuration,
|
19175
|
+
:expected_bucket_owner)
|
19176
|
+
SENSITIVE = []
|
19177
|
+
include Aws::Structure
|
19178
|
+
end
|
19179
|
+
|
19180
|
+
# @!attribute [rw] bucket
|
19181
|
+
# The general purpose bucket that corresponds to the metadata
|
19182
|
+
# configuration that you want to enable or disable journal table
|
19183
|
+
# record expiration for.
|
19184
|
+
# @return [String]
|
19185
|
+
#
|
19186
|
+
# @!attribute [rw] content_md5
|
19187
|
+
# The `Content-MD5` header for the journal table configuration.
|
19188
|
+
# @return [String]
|
19189
|
+
#
|
19190
|
+
# @!attribute [rw] checksum_algorithm
|
19191
|
+
# The checksum algorithm to use with your journal table configuration.
|
19192
|
+
# @return [String]
|
19193
|
+
#
|
19194
|
+
# @!attribute [rw] journal_table_configuration
|
19195
|
+
# The contents of your journal table configuration.
|
19196
|
+
# @return [Types::JournalTableConfigurationUpdates]
|
19197
|
+
#
|
19198
|
+
# @!attribute [rw] expected_bucket_owner
|
19199
|
+
# The expected owner of the general purpose bucket that corresponds to
|
19200
|
+
# the metadata table configuration that you want to enable or disable
|
19201
|
+
# journal table record expiration for.
|
19202
|
+
# @return [String]
|
19203
|
+
#
|
19204
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/UpdateBucketMetadataJournalTableConfigurationRequest AWS API Documentation
|
19205
|
+
#
|
19206
|
+
class UpdateBucketMetadataJournalTableConfigurationRequest < Struct.new(
|
19207
|
+
:bucket,
|
19208
|
+
:content_md5,
|
19209
|
+
:checksum_algorithm,
|
19210
|
+
:journal_table_configuration,
|
19211
|
+
:expected_bucket_owner)
|
19212
|
+
SENSITIVE = []
|
19213
|
+
include Aws::Structure
|
19214
|
+
end
|
19215
|
+
|
18176
19216
|
# @!attribute [rw] copy_source_version_id
|
18177
19217
|
# The version of the source object that was copied, if you have
|
18178
19218
|
# enabled versioning on the source bucket.
|
@@ -18189,7 +19229,13 @@ module Aws::S3
|
|
18189
19229
|
#
|
18190
19230
|
# @!attribute [rw] server_side_encryption
|
18191
19231
|
# The server-side encryption algorithm used when you store this object
|
18192
|
-
# in Amazon S3
|
19232
|
+
# in Amazon S3 or Amazon FSx.
|
19233
|
+
#
|
19234
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
19235
|
+
# access points, the only valid server side encryption option is
|
19236
|
+
# `aws:fsx`.
|
19237
|
+
#
|
19238
|
+
# </note>
|
18193
19239
|
# @return [String]
|
18194
19240
|
#
|
18195
19241
|
# @!attribute [rw] sse_customer_algorithm
|
@@ -18587,7 +19633,13 @@ module Aws::S3
|
|
18587
19633
|
|
18588
19634
|
# @!attribute [rw] server_side_encryption
|
18589
19635
|
# The server-side encryption algorithm used when you store this object
|
18590
|
-
# in Amazon S3
|
19636
|
+
# in Amazon S3 or Amazon FSx.
|
19637
|
+
#
|
19638
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
19639
|
+
# access points, the only valid server side encryption option is
|
19640
|
+
# `aws:fsx`.
|
19641
|
+
#
|
19642
|
+
# </note>
|
18591
19643
|
# @return [String]
|
18592
19644
|
#
|
18593
19645
|
# @!attribute [rw] etag
|
@@ -19320,7 +20372,13 @@ module Aws::S3
|
|
19320
20372
|
#
|
19321
20373
|
# @!attribute [rw] server_side_encryption
|
19322
20374
|
# The server-side encryption algorithm used when storing requested
|
19323
|
-
# object in Amazon S3
|
20375
|
+
# object in Amazon S3 or Amazon FSx.
|
20376
|
+
#
|
20377
|
+
# <note markdown="1"> When accessing data stored in Amazon FSx file systems using S3
|
20378
|
+
# access points, the only valid server side encryption option is
|
20379
|
+
# `aws:fsx`.
|
20380
|
+
#
|
20381
|
+
# </note>
|
19324
20382
|
# @return [String]
|
19325
20383
|
#
|
19326
20384
|
# @!attribute [rw] sse_customer_algorithm
|