aws-sdk-s3 1.172.0 → 1.176.1
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 +25 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +36 -2
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +5 -0
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +20 -0
- data/lib/aws-sdk-s3/client.rb +1525 -892
- data/lib/aws-sdk-s3/client_api.rb +126 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +36 -0
- data/lib/aws-sdk-s3/endpoints.rb +42 -0
- data/lib/aws-sdk-s3/errors.rb +44 -0
- data/lib/aws-sdk-s3/multipart_upload.rb +33 -0
- data/lib/aws-sdk-s3/object.rb +77 -1
- data/lib/aws-sdk-s3/object_summary.rb +74 -0
- data/lib/aws-sdk-s3/object_version.rb +43 -0
- data/lib/aws-sdk-s3/presigner.rb +1 -0
- data/lib/aws-sdk-s3/resource.rb +9 -8
- data/lib/aws-sdk-s3/types.rb +823 -120
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +8 -3
- data/sig/client.rbs +50 -6
- data/sig/errors.rbs +8 -0
- data/sig/multipart_upload.rbs +3 -1
- data/sig/object.rbs +6 -1
- data/sig/object_summary.rbs +6 -1
- data/sig/object_version.rbs +4 -1
- data/sig/resource.rbs +2 -2
- data/sig/types.rbs +89 -3
- metadata +2 -2
data/lib/aws-sdk-s3/types.rb
CHANGED
@@ -55,10 +55,10 @@ module Aws::S3
|
|
55
55
|
#
|
56
56
|
# **Directory buckets** - When you use this operation with a directory
|
57
57
|
# bucket, you must use virtual-hosted-style requests in the format `
|
58
|
-
#
|
58
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
59
59
|
# requests are not supported. Directory bucket names must be unique in
|
60
|
-
# the chosen Availability Zone. Bucket names must
|
61
|
-
#
|
60
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
61
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
62
62
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
63
63
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
64
64
|
# *Amazon S3 User Guide*.
|
@@ -128,6 +128,19 @@ module Aws::S3
|
|
128
128
|
# denied).
|
129
129
|
# @return [String]
|
130
130
|
#
|
131
|
+
# @!attribute [rw] if_match_initiated_time
|
132
|
+
# If present, this header aborts an in progress multipart upload only
|
133
|
+
# if it was initiated on the provided timestamp. If the initiated
|
134
|
+
# timestamp of the multipart upload does not match the provided value,
|
135
|
+
# the operation returns a `412 Precondition Failed` error. If the
|
136
|
+
# initiated timestamp matches or if the multipart upload doesn’t
|
137
|
+
# exist, the operation returns a `204 Success (No Content)` response.
|
138
|
+
#
|
139
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
140
|
+
#
|
141
|
+
# </note>
|
142
|
+
# @return [Time]
|
143
|
+
#
|
131
144
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbortMultipartUploadRequest AWS API Documentation
|
132
145
|
#
|
133
146
|
class AbortMultipartUploadRequest < Struct.new(
|
@@ -135,7 +148,8 @@ module Aws::S3
|
|
135
148
|
:key,
|
136
149
|
:upload_id,
|
137
150
|
:request_payer,
|
138
|
-
:expected_bucket_owner
|
151
|
+
:expected_bucket_owner,
|
152
|
+
:if_match_initiated_time)
|
139
153
|
SENSITIVE = []
|
140
154
|
include Aws::Structure
|
141
155
|
end
|
@@ -392,8 +406,8 @@ module Aws::S3
|
|
392
406
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
|
393
407
|
#
|
394
408
|
# @!attribute [rw] data_redundancy
|
395
|
-
# The number of Availability Zone that's used
|
396
|
-
# bucket.
|
409
|
+
# The number of Zone (Availability Zone or Local Zone) that's used
|
410
|
+
# for redundancy for the bucket.
|
397
411
|
# @return [String]
|
398
412
|
#
|
399
413
|
# @!attribute [rw] type
|
@@ -929,10 +943,10 @@ module Aws::S3
|
|
929
943
|
#
|
930
944
|
# **Directory buckets** - When you use this operation with a directory
|
931
945
|
# bucket, you must use virtual-hosted-style requests in the format `
|
932
|
-
#
|
946
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
933
947
|
# requests are not supported. Directory bucket names must be unique in
|
934
|
-
# the chosen Availability Zone. Bucket names must
|
935
|
-
#
|
948
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
949
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
936
950
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
937
951
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
938
952
|
# *Amazon S3 User Guide*.
|
@@ -1054,6 +1068,28 @@ module Aws::S3
|
|
1054
1068
|
# denied).
|
1055
1069
|
# @return [String]
|
1056
1070
|
#
|
1071
|
+
# @!attribute [rw] if_match
|
1072
|
+
# Uploads the object only if the ETag (entity tag) value provided
|
1073
|
+
# during the WRITE operation matches the ETag of the object in S3. If
|
1074
|
+
# the ETag values do not match, the operation returns a `412
|
1075
|
+
# Precondition Failed` error.
|
1076
|
+
#
|
1077
|
+
# If a conflicting operation occurs during the upload S3 returns a
|
1078
|
+
# `409 ConditionalRequestConflict` response. On a 409 failure you
|
1079
|
+
# should fetch the object's ETag, re-initiate the multipart upload
|
1080
|
+
# with `CreateMultipartUpload`, and re-upload each part.
|
1081
|
+
#
|
1082
|
+
# Expects the ETag value as a string.
|
1083
|
+
#
|
1084
|
+
# For more information about conditional requests, see [RFC 7232][1],
|
1085
|
+
# or [Conditional requests][2] in the *Amazon S3 User Guide*.
|
1086
|
+
#
|
1087
|
+
#
|
1088
|
+
#
|
1089
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
1090
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
1091
|
+
# @return [String]
|
1092
|
+
#
|
1057
1093
|
# @!attribute [rw] if_none_match
|
1058
1094
|
# Uploads the object only if the object key name does not already
|
1059
1095
|
# exist in the bucket specified. Otherwise, Amazon S3 returns a `412
|
@@ -1134,6 +1170,7 @@ module Aws::S3
|
|
1134
1170
|
:checksum_sha256,
|
1135
1171
|
:request_payer,
|
1136
1172
|
:expected_bucket_owner,
|
1173
|
+
:if_match,
|
1137
1174
|
:if_none_match,
|
1138
1175
|
:sse_customer_algorithm,
|
1139
1176
|
:sse_customer_key,
|
@@ -1316,7 +1353,9 @@ module Aws::S3
|
|
1316
1353
|
# If the object expiration is configured, the response includes this
|
1317
1354
|
# header.
|
1318
1355
|
#
|
1319
|
-
# <note markdown="1">
|
1356
|
+
# <note markdown="1"> Object expiration information is not returned in directory buckets
|
1357
|
+
# and this header returns the value "`NotImplemented`" in all
|
1358
|
+
# responses for directory buckets.
|
1320
1359
|
#
|
1321
1360
|
# </note>
|
1322
1361
|
# @return [String]
|
@@ -1448,14 +1487,22 @@ module Aws::S3
|
|
1448
1487
|
#
|
1449
1488
|
# **Directory buckets** - When you use this operation with a directory
|
1450
1489
|
# bucket, you must use virtual-hosted-style requests in the format `
|
1451
|
-
#
|
1490
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
1452
1491
|
# requests are not supported. Directory bucket names must be unique in
|
1453
|
-
# the chosen Availability Zone. Bucket names must
|
1454
|
-
#
|
1492
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
1493
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
1455
1494
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
1456
1495
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
1457
1496
|
# *Amazon S3 User Guide*.
|
1458
1497
|
#
|
1498
|
+
# <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
|
1499
|
+
# supported when the source or destination bucket is in Amazon Web
|
1500
|
+
# Services Local Zones. The source and destination buckets must have
|
1501
|
+
# the same parent Amazon Web Services Region. Otherwise, you get an
|
1502
|
+
# HTTP `400 Bad Request` error with the error code `InvalidRequest`.
|
1503
|
+
#
|
1504
|
+
# </note>
|
1505
|
+
#
|
1459
1506
|
# **Access points** - When you use this action with an access point,
|
1460
1507
|
# you must provide the alias of the access point in place of the
|
1461
1508
|
# bucket name or specify the access point ARN. When using the access
|
@@ -2449,11 +2496,20 @@ module Aws::S3
|
|
2449
2496
|
# @!attribute [rw] location
|
2450
2497
|
# Specifies the location where the bucket will be created.
|
2451
2498
|
#
|
2452
|
-
#
|
2499
|
+
# <b>Directory buckets </b> - The location type is Availability Zone
|
2500
|
+
# or Local Zone. When the location type is Local Zone, your Local Zone
|
2501
|
+
# must be in opt-in status. Otherwise, you get an HTTP `400 Bad
|
2502
|
+
# Request` error with the error code `Access denied`. To learn more
|
2503
|
+
# about opt-in Local Zones, see [Opt-in Dedicated Local Zones][1]in
|
2504
|
+
# the *Amazon S3 User Guide*.
|
2453
2505
|
#
|
2454
2506
|
# <note markdown="1"> This functionality is only supported by directory buckets.
|
2455
2507
|
#
|
2456
2508
|
# </note>
|
2509
|
+
#
|
2510
|
+
#
|
2511
|
+
#
|
2512
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/opt-in-directory-bucket-lz.html
|
2457
2513
|
# @return [Types::LocationInfo]
|
2458
2514
|
#
|
2459
2515
|
# @!attribute [rw] bucket
|
@@ -2474,6 +2530,41 @@ module Aws::S3
|
|
2474
2530
|
include Aws::Structure
|
2475
2531
|
end
|
2476
2532
|
|
2533
|
+
# @!attribute [rw] bucket
|
2534
|
+
# The general purpose bucket that you want to create the metadata
|
2535
|
+
# table configuration in.
|
2536
|
+
# @return [String]
|
2537
|
+
#
|
2538
|
+
# @!attribute [rw] content_md5
|
2539
|
+
# The `Content-MD5` header for the metadata table configuration.
|
2540
|
+
# @return [String]
|
2541
|
+
#
|
2542
|
+
# @!attribute [rw] checksum_algorithm
|
2543
|
+
# The checksum algorithm to use with your metadata table
|
2544
|
+
# configuration.
|
2545
|
+
# @return [String]
|
2546
|
+
#
|
2547
|
+
# @!attribute [rw] metadata_table_configuration
|
2548
|
+
# The contents of your metadata table configuration.
|
2549
|
+
# @return [Types::MetadataTableConfiguration]
|
2550
|
+
#
|
2551
|
+
# @!attribute [rw] expected_bucket_owner
|
2552
|
+
# The expected owner of the general purpose bucket that contains your
|
2553
|
+
# metadata table configuration.
|
2554
|
+
# @return [String]
|
2555
|
+
#
|
2556
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataTableConfigurationRequest AWS API Documentation
|
2557
|
+
#
|
2558
|
+
class CreateBucketMetadataTableConfigurationRequest < Struct.new(
|
2559
|
+
:bucket,
|
2560
|
+
:content_md5,
|
2561
|
+
:checksum_algorithm,
|
2562
|
+
:metadata_table_configuration,
|
2563
|
+
:expected_bucket_owner)
|
2564
|
+
SENSITIVE = []
|
2565
|
+
include Aws::Structure
|
2566
|
+
end
|
2567
|
+
|
2477
2568
|
# @!attribute [rw] location
|
2478
2569
|
# A forward slash followed by the name of the bucket.
|
2479
2570
|
# @return [String]
|
@@ -2503,13 +2594,14 @@ module Aws::S3
|
|
2503
2594
|
#
|
2504
2595
|
# <b>Directory buckets </b> - When you use this operation with a
|
2505
2596
|
# directory bucket, you must use path-style requests in the format
|
2506
|
-
# `https://s3express-control.
|
2597
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
2507
2598
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
2508
|
-
# names must be unique in the chosen Availability Zone
|
2509
|
-
# must also follow the format `
|
2510
|
-
#
|
2511
|
-
#
|
2512
|
-
# rules][2] in the
|
2599
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
2600
|
+
# Zone). Bucket names must also follow the format `
|
2601
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
2602
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
2603
|
+
# naming restrictions, see [Directory bucket naming rules][2] in the
|
2604
|
+
# *Amazon S3 User Guide*
|
2513
2605
|
#
|
2514
2606
|
#
|
2515
2607
|
#
|
@@ -2787,10 +2879,10 @@ module Aws::S3
|
|
2787
2879
|
#
|
2788
2880
|
# **Directory buckets** - When you use this operation with a directory
|
2789
2881
|
# bucket, you must use virtual-hosted-style requests in the format `
|
2790
|
-
#
|
2882
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
2791
2883
|
# requests are not supported. Directory bucket names must be unique in
|
2792
|
-
# the chosen Availability Zone. Bucket names must
|
2793
|
-
#
|
2884
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
2885
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
2794
2886
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
2795
2887
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
2796
2888
|
# *Amazon S3 User Guide*.
|
@@ -3694,13 +3786,14 @@ module Aws::S3
|
|
3694
3786
|
#
|
3695
3787
|
# <b>Directory buckets </b> - When you use this operation with a
|
3696
3788
|
# directory bucket, you must use path-style requests in the format
|
3697
|
-
# `https://s3express-control.
|
3789
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3698
3790
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
3699
|
-
# names must be unique in the chosen Availability Zone
|
3700
|
-
# must also follow the format `
|
3701
|
-
#
|
3702
|
-
#
|
3703
|
-
# rules][1] in the
|
3791
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
3792
|
+
# Zone). Bucket names must also follow the format `
|
3793
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
3794
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
3795
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
3796
|
+
# *Amazon S3 User Guide*
|
3704
3797
|
#
|
3705
3798
|
#
|
3706
3799
|
#
|
@@ -3782,6 +3875,11 @@ module Aws::S3
|
|
3782
3875
|
# you provide does not match the actual owner of the bucket, the
|
3783
3876
|
# request fails with the HTTP status code `403 Forbidden` (access
|
3784
3877
|
# denied).
|
3878
|
+
#
|
3879
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
3880
|
+
# supported for directory bucket lifecycle configurations.
|
3881
|
+
#
|
3882
|
+
# </note>
|
3785
3883
|
# @return [String]
|
3786
3884
|
#
|
3787
3885
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycleRequest AWS API Documentation
|
@@ -3793,6 +3891,25 @@ module Aws::S3
|
|
3793
3891
|
include Aws::Structure
|
3794
3892
|
end
|
3795
3893
|
|
3894
|
+
# @!attribute [rw] bucket
|
3895
|
+
# The general purpose bucket that you want to remove the metadata
|
3896
|
+
# table configuration from.
|
3897
|
+
# @return [String]
|
3898
|
+
#
|
3899
|
+
# @!attribute [rw] expected_bucket_owner
|
3900
|
+
# The expected bucket owner of the general purpose bucket that you
|
3901
|
+
# want to remove the metadata table configuration from.
|
3902
|
+
# @return [String]
|
3903
|
+
#
|
3904
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetadataTableConfigurationRequest AWS API Documentation
|
3905
|
+
#
|
3906
|
+
class DeleteBucketMetadataTableConfigurationRequest < Struct.new(
|
3907
|
+
:bucket,
|
3908
|
+
:expected_bucket_owner)
|
3909
|
+
SENSITIVE = []
|
3910
|
+
include Aws::Structure
|
3911
|
+
end
|
3912
|
+
|
3796
3913
|
# @!attribute [rw] bucket
|
3797
3914
|
# The name of the bucket containing the metrics configuration to
|
3798
3915
|
# delete.
|
@@ -3846,13 +3963,14 @@ module Aws::S3
|
|
3846
3963
|
#
|
3847
3964
|
# <b>Directory buckets </b> - When you use this operation with a
|
3848
3965
|
# directory bucket, you must use path-style requests in the format
|
3849
|
-
# `https://s3express-control.
|
3966
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3850
3967
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
3851
|
-
# names must be unique in the chosen Availability Zone
|
3852
|
-
# must also follow the format `
|
3853
|
-
#
|
3854
|
-
#
|
3855
|
-
# rules][1] in the
|
3968
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
3969
|
+
# Zone). Bucket names must also follow the format `
|
3970
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
3971
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
3972
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
3973
|
+
# *Amazon S3 User Guide*
|
3856
3974
|
#
|
3857
3975
|
#
|
3858
3976
|
#
|
@@ -3906,13 +4024,14 @@ module Aws::S3
|
|
3906
4024
|
#
|
3907
4025
|
# <b>Directory buckets </b> - When you use this operation with a
|
3908
4026
|
# directory bucket, you must use path-style requests in the format
|
3909
|
-
# `https://s3express-control.
|
4027
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
3910
4028
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
3911
|
-
# names must be unique in the chosen Availability Zone
|
3912
|
-
# must also follow the format `
|
3913
|
-
#
|
3914
|
-
#
|
3915
|
-
# rules][1] in the
|
4029
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
4030
|
+
# Zone). Bucket names must also follow the format `
|
4031
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
4032
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4033
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4034
|
+
# *Amazon S3 User Guide*
|
3916
4035
|
#
|
3917
4036
|
#
|
3918
4037
|
#
|
@@ -4100,10 +4219,10 @@ module Aws::S3
|
|
4100
4219
|
#
|
4101
4220
|
# **Directory buckets** - When you use this operation with a directory
|
4102
4221
|
# bucket, you must use virtual-hosted-style requests in the format `
|
4103
|
-
#
|
4222
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
4104
4223
|
# requests are not supported. Directory bucket names must be unique in
|
4105
|
-
# the chosen Availability Zone. Bucket names must
|
4106
|
-
#
|
4224
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
4225
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
4107
4226
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4108
4227
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4109
4228
|
# *Amazon S3 User Guide*.
|
@@ -4199,6 +4318,52 @@ module Aws::S3
|
|
4199
4318
|
# denied).
|
4200
4319
|
# @return [String]
|
4201
4320
|
#
|
4321
|
+
# @!attribute [rw] if_match
|
4322
|
+
# The `If-Match` header field makes the request method conditional on
|
4323
|
+
# ETags. If the ETag value does not match, the operation returns a
|
4324
|
+
# `412 Precondition Failed` error. If the ETag matches or if the
|
4325
|
+
# object doesn't exist, the operation will return a `204 Success (No
|
4326
|
+
# Content) response`.
|
4327
|
+
#
|
4328
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
4329
|
+
#
|
4330
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
4331
|
+
#
|
4332
|
+
# </note>
|
4333
|
+
#
|
4334
|
+
#
|
4335
|
+
#
|
4336
|
+
# [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
|
4337
|
+
# @return [String]
|
4338
|
+
#
|
4339
|
+
# @!attribute [rw] if_match_last_modified_time
|
4340
|
+
# If present, the object is deleted only if its modification times
|
4341
|
+
# matches the provided `Timestamp`. If the `Timestamp` values do not
|
4342
|
+
# match, the operation returns a `412 Precondition Failed` error. If
|
4343
|
+
# the `Timestamp` matches or if the object doesn’t exist, the
|
4344
|
+
# operation returns a `204 Success (No Content)` response.
|
4345
|
+
#
|
4346
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
4347
|
+
#
|
4348
|
+
# </note>
|
4349
|
+
# @return [Time]
|
4350
|
+
#
|
4351
|
+
# @!attribute [rw] if_match_size
|
4352
|
+
# If present, the object is deleted only if its size matches the
|
4353
|
+
# provided size in bytes. If the `Size` value does not match, the
|
4354
|
+
# operation returns a `412 Precondition Failed` error. If the `Size`
|
4355
|
+
# matches or if the object doesn’t exist, the operation returns a `204
|
4356
|
+
# Success (No Content)` response.
|
4357
|
+
#
|
4358
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
4359
|
+
#
|
4360
|
+
# </note>
|
4361
|
+
#
|
4362
|
+
# You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
|
4363
|
+
# `x-amz-if-match-size` conditional headers in conjunction with
|
4364
|
+
# each-other or individually.
|
4365
|
+
# @return [Integer]
|
4366
|
+
#
|
4202
4367
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectRequest AWS API Documentation
|
4203
4368
|
#
|
4204
4369
|
class DeleteObjectRequest < Struct.new(
|
@@ -4208,7 +4373,10 @@ module Aws::S3
|
|
4208
4373
|
:version_id,
|
4209
4374
|
:request_payer,
|
4210
4375
|
:bypass_governance_retention,
|
4211
|
-
:expected_bucket_owner
|
4376
|
+
:expected_bucket_owner,
|
4377
|
+
:if_match,
|
4378
|
+
:if_match_last_modified_time,
|
4379
|
+
:if_match_size)
|
4212
4380
|
SENSITIVE = []
|
4213
4381
|
include Aws::Structure
|
4214
4382
|
end
|
@@ -4316,10 +4484,10 @@ module Aws::S3
|
|
4316
4484
|
#
|
4317
4485
|
# **Directory buckets** - When you use this operation with a directory
|
4318
4486
|
# bucket, you must use virtual-hosted-style requests in the format `
|
4319
|
-
#
|
4487
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
4320
4488
|
# requests are not supported. Directory bucket names must be unique in
|
4321
|
-
# the chosen Availability Zone. Bucket names must
|
4322
|
-
#
|
4489
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
4490
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
4323
4491
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
4324
4492
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
4325
4493
|
# *Amazon S3 User Guide*.
|
@@ -4684,6 +4852,14 @@ module Aws::S3
|
|
4684
4852
|
include Aws::Structure
|
4685
4853
|
end
|
4686
4854
|
|
4855
|
+
# The existing object was created with a different encryption type.
|
4856
|
+
# Subsequent write requests must include the appropriate encryption
|
4857
|
+
# parameters in the request or while creating the session.
|
4858
|
+
#
|
4859
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/EncryptionTypeMismatch AWS API Documentation
|
4860
|
+
#
|
4861
|
+
class EncryptionTypeMismatch < Aws::EmptyStructure; end
|
4862
|
+
|
4687
4863
|
# A message that indicates the request is complete and no more messages
|
4688
4864
|
# will be sent. You should not assume that the request is complete until
|
4689
4865
|
# the client receives an `EndEvent`.
|
@@ -5449,6 +5625,103 @@ module Aws::S3
|
|
5449
5625
|
include Aws::Structure
|
5450
5626
|
end
|
5451
5627
|
|
5628
|
+
# If the `CreateBucketMetadataTableConfiguration` request succeeds, but
|
5629
|
+
# S3 Metadata was unable to create the table, this structure contains
|
5630
|
+
# the error code and error message.
|
5631
|
+
#
|
5632
|
+
# @!attribute [rw] error_code
|
5633
|
+
# If the `CreateBucketMetadataTableConfiguration` request succeeds,
|
5634
|
+
# but S3 Metadata was unable to create the table, this structure
|
5635
|
+
# contains the error code. The possible error codes and error messages
|
5636
|
+
# are as follows:
|
5637
|
+
#
|
5638
|
+
# * `AccessDeniedCreatingResources` - You don't have sufficient
|
5639
|
+
# permissions to create the required resources. Make sure that you
|
5640
|
+
# have `s3tables:CreateNamespace`, `s3tables:CreateTable`,
|
5641
|
+
# `s3tables:GetTable` and `s3tables:PutTablePolicy` permissions, and
|
5642
|
+
# then try again. To create a new metadata table, you must delete
|
5643
|
+
# the metadata configuration for this bucket, and then create a new
|
5644
|
+
# metadata configuration.
|
5645
|
+
#
|
5646
|
+
# * `AccessDeniedWritingToTable` - Unable to write to the metadata
|
5647
|
+
# table because of missing resource permissions. To fix the resource
|
5648
|
+
# policy, Amazon S3 needs to create a new metadata table. To create
|
5649
|
+
# a new metadata table, you must delete the metadata configuration
|
5650
|
+
# for this bucket, and then create a new metadata configuration.
|
5651
|
+
#
|
5652
|
+
# * `DestinationTableNotFound` - The destination table doesn't exist.
|
5653
|
+
# To create a new metadata table, you must delete the metadata
|
5654
|
+
# configuration for this bucket, and then create a new metadata
|
5655
|
+
# configuration.
|
5656
|
+
#
|
5657
|
+
# * `ServerInternalError` - An internal error has occurred. To create
|
5658
|
+
# a new metadata table, you must delete the metadata configuration
|
5659
|
+
# for this bucket, and then create a new metadata configuration.
|
5660
|
+
#
|
5661
|
+
# * `TableAlreadyExists` - The table that you specified already exists
|
5662
|
+
# in the table bucket's namespace. Specify a different table name.
|
5663
|
+
# To create a new metadata table, you must delete the metadata
|
5664
|
+
# configuration for this bucket, and then create a new metadata
|
5665
|
+
# configuration.
|
5666
|
+
#
|
5667
|
+
# * `TableBucketNotFound` - The table bucket that you specified
|
5668
|
+
# doesn't exist in this Amazon Web Services Region and account.
|
5669
|
+
# Create or choose a different table bucket. To create a new
|
5670
|
+
# metadata table, you must delete the metadata configuration for
|
5671
|
+
# this bucket, and then create a new metadata configuration.
|
5672
|
+
# @return [String]
|
5673
|
+
#
|
5674
|
+
# @!attribute [rw] error_message
|
5675
|
+
# If the `CreateBucketMetadataTableConfiguration` request succeeds,
|
5676
|
+
# but S3 Metadata was unable to create the table, this structure
|
5677
|
+
# contains the error message. The possible error codes and error
|
5678
|
+
# messages are as follows:
|
5679
|
+
#
|
5680
|
+
# * `AccessDeniedCreatingResources` - You don't have sufficient
|
5681
|
+
# permissions to create the required resources. Make sure that you
|
5682
|
+
# have `s3tables:CreateNamespace`, `s3tables:CreateTable`,
|
5683
|
+
# `s3tables:GetTable` and `s3tables:PutTablePolicy` permissions, and
|
5684
|
+
# then try again. To create a new metadata table, you must delete
|
5685
|
+
# the metadata configuration for this bucket, and then create a new
|
5686
|
+
# metadata configuration.
|
5687
|
+
#
|
5688
|
+
# * `AccessDeniedWritingToTable` - Unable to write to the metadata
|
5689
|
+
# table because of missing resource permissions. To fix the resource
|
5690
|
+
# policy, Amazon S3 needs to create a new metadata table. To create
|
5691
|
+
# a new metadata table, you must delete the metadata configuration
|
5692
|
+
# for this bucket, and then create a new metadata configuration.
|
5693
|
+
#
|
5694
|
+
# * `DestinationTableNotFound` - The destination table doesn't exist.
|
5695
|
+
# To create a new metadata table, you must delete the metadata
|
5696
|
+
# configuration for this bucket, and then create a new metadata
|
5697
|
+
# configuration.
|
5698
|
+
#
|
5699
|
+
# * `ServerInternalError` - An internal error has occurred. To create
|
5700
|
+
# a new metadata table, you must delete the metadata configuration
|
5701
|
+
# for this bucket, and then create a new metadata configuration.
|
5702
|
+
#
|
5703
|
+
# * `TableAlreadyExists` - The table that you specified already exists
|
5704
|
+
# in the table bucket's namespace. Specify a different table name.
|
5705
|
+
# To create a new metadata table, you must delete the metadata
|
5706
|
+
# configuration for this bucket, and then create a new metadata
|
5707
|
+
# configuration.
|
5708
|
+
#
|
5709
|
+
# * `TableBucketNotFound` - The table bucket that you specified
|
5710
|
+
# doesn't exist in this Amazon Web Services Region and account.
|
5711
|
+
# Create or choose a different table bucket. To create a new
|
5712
|
+
# metadata table, you must delete the metadata configuration for
|
5713
|
+
# this bucket, and then create a new metadata configuration.
|
5714
|
+
# @return [String]
|
5715
|
+
#
|
5716
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ErrorDetails AWS API Documentation
|
5717
|
+
#
|
5718
|
+
class ErrorDetails < Struct.new(
|
5719
|
+
:error_code,
|
5720
|
+
:error_message)
|
5721
|
+
SENSITIVE = []
|
5722
|
+
include Aws::Structure
|
5723
|
+
end
|
5724
|
+
|
5452
5725
|
# The error information.
|
5453
5726
|
#
|
5454
5727
|
# @!attribute [rw] key
|
@@ -5756,13 +6029,14 @@ module Aws::S3
|
|
5756
6029
|
#
|
5757
6030
|
# <b>Directory buckets </b> - When you use this operation with a
|
5758
6031
|
# directory bucket, you must use path-style requests in the format
|
5759
|
-
# `https://s3express-control.
|
6032
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
5760
6033
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
5761
|
-
# names must be unique in the chosen Availability Zone
|
5762
|
-
# must also follow the format `
|
5763
|
-
#
|
5764
|
-
#
|
5765
|
-
# rules][1] in the
|
6034
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
6035
|
+
# Zone). Bucket names must also follow the format `
|
6036
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
6037
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
6038
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
6039
|
+
# *Amazon S3 User Guide*
|
5766
6040
|
#
|
5767
6041
|
#
|
5768
6042
|
#
|
@@ -5867,6 +6141,11 @@ module Aws::S3
|
|
5867
6141
|
# Indicates which default minimum object size behavior is applied to
|
5868
6142
|
# the lifecycle configuration.
|
5869
6143
|
#
|
6144
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
6145
|
+
# supported for directory bucket lifecycle configurations.
|
6146
|
+
#
|
6147
|
+
# </note>
|
6148
|
+
#
|
5870
6149
|
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
5871
6150
|
# transition to any storage class by default.
|
5872
6151
|
#
|
@@ -5899,6 +6178,11 @@ module Aws::S3
|
|
5899
6178
|
# you provide does not match the actual owner of the bucket, the
|
5900
6179
|
# request fails with the HTTP status code `403 Forbidden` (access
|
5901
6180
|
# denied).
|
6181
|
+
#
|
6182
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
6183
|
+
# supported for directory bucket lifecycle configurations.
|
6184
|
+
#
|
6185
|
+
# </note>
|
5902
6186
|
# @return [String]
|
5903
6187
|
#
|
5904
6188
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfigurationRequest AWS API Documentation
|
@@ -6033,6 +6317,73 @@ module Aws::S3
|
|
6033
6317
|
include Aws::Structure
|
6034
6318
|
end
|
6035
6319
|
|
6320
|
+
# @!attribute [rw] get_bucket_metadata_table_configuration_result
|
6321
|
+
# The metadata table configuration for the general purpose bucket.
|
6322
|
+
# @return [Types::GetBucketMetadataTableConfigurationResult]
|
6323
|
+
#
|
6324
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfigurationOutput AWS API Documentation
|
6325
|
+
#
|
6326
|
+
class GetBucketMetadataTableConfigurationOutput < Struct.new(
|
6327
|
+
:get_bucket_metadata_table_configuration_result)
|
6328
|
+
SENSITIVE = []
|
6329
|
+
include Aws::Structure
|
6330
|
+
end
|
6331
|
+
|
6332
|
+
# @!attribute [rw] bucket
|
6333
|
+
# The general purpose bucket that contains the metadata table
|
6334
|
+
# configuration that you want to retrieve.
|
6335
|
+
# @return [String]
|
6336
|
+
#
|
6337
|
+
# @!attribute [rw] expected_bucket_owner
|
6338
|
+
# The expected owner of the general purpose bucket that you want to
|
6339
|
+
# retrieve the metadata table configuration from.
|
6340
|
+
# @return [String]
|
6341
|
+
#
|
6342
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfigurationRequest AWS API Documentation
|
6343
|
+
#
|
6344
|
+
class GetBucketMetadataTableConfigurationRequest < Struct.new(
|
6345
|
+
:bucket,
|
6346
|
+
:expected_bucket_owner)
|
6347
|
+
SENSITIVE = []
|
6348
|
+
include Aws::Structure
|
6349
|
+
end
|
6350
|
+
|
6351
|
+
# The metadata table configuration for a general purpose bucket.
|
6352
|
+
#
|
6353
|
+
# @!attribute [rw] metadata_table_configuration_result
|
6354
|
+
# The metadata table configuration for a general purpose bucket.
|
6355
|
+
# @return [Types::MetadataTableConfigurationResult]
|
6356
|
+
#
|
6357
|
+
# @!attribute [rw] status
|
6358
|
+
# The status of the metadata table. The status values are:
|
6359
|
+
#
|
6360
|
+
# * `CREATING` - The metadata table is in the process of being created
|
6361
|
+
# in the specified table bucket.
|
6362
|
+
#
|
6363
|
+
# * `ACTIVE` - The metadata table has been created successfully and
|
6364
|
+
# records are being delivered to the table.
|
6365
|
+
#
|
6366
|
+
# * `FAILED` - Amazon S3 is unable to create the metadata table, or
|
6367
|
+
# Amazon S3 is unable to deliver records. See `ErrorDetails` for
|
6368
|
+
# details.
|
6369
|
+
# @return [String]
|
6370
|
+
#
|
6371
|
+
# @!attribute [rw] error
|
6372
|
+
# If the `CreateBucketMetadataTableConfiguration` request succeeds,
|
6373
|
+
# but S3 Metadata was unable to create the table, this structure
|
6374
|
+
# contains the error code and error message.
|
6375
|
+
# @return [Types::ErrorDetails]
|
6376
|
+
#
|
6377
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfigurationResult AWS API Documentation
|
6378
|
+
#
|
6379
|
+
class GetBucketMetadataTableConfigurationResult < Struct.new(
|
6380
|
+
:metadata_table_configuration_result,
|
6381
|
+
:status,
|
6382
|
+
:error)
|
6383
|
+
SENSITIVE = []
|
6384
|
+
include Aws::Structure
|
6385
|
+
end
|
6386
|
+
|
6036
6387
|
# @!attribute [rw] metrics_configuration
|
6037
6388
|
# Specifies the metrics configuration.
|
6038
6389
|
# @return [Types::MetricsConfiguration]
|
@@ -6159,13 +6510,14 @@ module Aws::S3
|
|
6159
6510
|
#
|
6160
6511
|
# <b>Directory buckets </b> - When you use this operation with a
|
6161
6512
|
# directory bucket, you must use path-style requests in the format
|
6162
|
-
# `https://s3express-control.
|
6513
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
6163
6514
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
6164
|
-
# names must be unique in the chosen Availability Zone
|
6165
|
-
# must also follow the format `
|
6166
|
-
#
|
6167
|
-
#
|
6168
|
-
# rules][1] in the
|
6515
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
6516
|
+
# Zone). Bucket names must also follow the format `
|
6517
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
6518
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
6519
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
6520
|
+
# *Amazon S3 User Guide*
|
6169
6521
|
#
|
6170
6522
|
# **Access points** - When you use this API operation with an access
|
6171
6523
|
# point, provide the alias of the access point in place of the bucket
|
@@ -6540,7 +6892,7 @@ module Aws::S3
|
|
6540
6892
|
# @return [Boolean]
|
6541
6893
|
#
|
6542
6894
|
# @!attribute [rw] last_modified
|
6543
|
-
#
|
6895
|
+
# Date and time when the object was last modified.
|
6544
6896
|
# @return [Time]
|
6545
6897
|
#
|
6546
6898
|
# @!attribute [rw] version_id
|
@@ -6672,10 +7024,10 @@ module Aws::S3
|
|
6672
7024
|
#
|
6673
7025
|
# **Directory buckets** - When you use this operation with a directory
|
6674
7026
|
# bucket, you must use virtual-hosted-style requests in the format `
|
6675
|
-
#
|
7027
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
6676
7028
|
# requests are not supported. Directory bucket names must be unique in
|
6677
|
-
# the chosen Availability Zone. Bucket names must
|
6678
|
-
#
|
7029
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
7030
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
6679
7031
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
6680
7032
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
6681
7033
|
# *Amazon S3 User Guide*.
|
@@ -6972,7 +7324,9 @@ module Aws::S3
|
|
6972
7324
|
# providing object expiration information. The value of the `rule-id`
|
6973
7325
|
# is URL-encoded.
|
6974
7326
|
#
|
6975
|
-
# <note markdown="1">
|
7327
|
+
# <note markdown="1"> Object expiration information is not returned in directory buckets
|
7328
|
+
# and this header returns the value "`NotImplemented`" in all
|
7329
|
+
# responses for directory buckets.
|
6976
7330
|
#
|
6977
7331
|
# </note>
|
6978
7332
|
#
|
@@ -7284,10 +7638,10 @@ module Aws::S3
|
|
7284
7638
|
#
|
7285
7639
|
# **Directory buckets** - When you use this operation with a directory
|
7286
7640
|
# bucket, you must use virtual-hosted-style requests in the format `
|
7287
|
-
#
|
7641
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
7288
7642
|
# requests are not supported. Directory bucket names must be unique in
|
7289
|
-
# the chosen Availability Zone. Bucket names must
|
7290
|
-
#
|
7643
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
7644
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
7291
7645
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
7292
7646
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
7293
7647
|
# *Amazon S3 User Guide*.
|
@@ -8015,8 +8369,9 @@ module Aws::S3
|
|
8015
8369
|
# @!attribute [rw] bucket_location_name
|
8016
8370
|
# The name of the location where the bucket will be created.
|
8017
8371
|
#
|
8018
|
-
# For directory buckets, the
|
8019
|
-
# bucket is created. An example
|
8372
|
+
# For directory buckets, the Zone ID of the Availability Zone or the
|
8373
|
+
# Local Zone where the bucket is created. An example Zone ID value for
|
8374
|
+
# an Availability Zone is `usw2-az1`.
|
8020
8375
|
#
|
8021
8376
|
# <note markdown="1"> This functionality is only supported by directory buckets.
|
8022
8377
|
#
|
@@ -8052,10 +8407,10 @@ module Aws::S3
|
|
8052
8407
|
#
|
8053
8408
|
# **Directory buckets** - When you use this operation with a directory
|
8054
8409
|
# bucket, you must use virtual-hosted-style requests in the format `
|
8055
|
-
#
|
8410
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
8056
8411
|
# requests are not supported. Directory bucket names must be unique in
|
8057
|
-
# the chosen Availability Zone. Bucket names must
|
8058
|
-
#
|
8412
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
8413
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
8059
8414
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
8060
8415
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
8061
8416
|
# *Amazon S3 User Guide*.
|
@@ -8137,7 +8492,9 @@ module Aws::S3
|
|
8137
8492
|
# providing object expiration information. The value of the `rule-id`
|
8138
8493
|
# is URL-encoded.
|
8139
8494
|
#
|
8140
|
-
# <note markdown="1">
|
8495
|
+
# <note markdown="1"> Object expiration information is not returned in directory buckets
|
8496
|
+
# and this header returns the value "`NotImplemented`" in all
|
8497
|
+
# responses for directory buckets.
|
8141
8498
|
#
|
8142
8499
|
# </note>
|
8143
8500
|
#
|
@@ -8526,10 +8883,10 @@ module Aws::S3
|
|
8526
8883
|
#
|
8527
8884
|
# **Directory buckets** - When you use this operation with a directory
|
8528
8885
|
# bucket, you must use virtual-hosted-style requests in the format `
|
8529
|
-
#
|
8886
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
8530
8887
|
# requests are not supported. Directory bucket names must be unique in
|
8531
|
-
# the chosen Availability Zone. Bucket names must
|
8532
|
-
#
|
8888
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
8889
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
8533
8890
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
8534
8891
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
8535
8892
|
# *Amazon S3 User Guide*.
|
@@ -9018,6 +9375,28 @@ module Aws::S3
|
|
9018
9375
|
include Aws::Structure
|
9019
9376
|
end
|
9020
9377
|
|
9378
|
+
# You may receive this error in multiple cases. Depending on the reason
|
9379
|
+
# for the error, you may receive one of the messages below:
|
9380
|
+
#
|
9381
|
+
# * Cannot specify both a write offset value and user-defined object
|
9382
|
+
# metadata for existing objects.
|
9383
|
+
#
|
9384
|
+
# * Checksum Type mismatch occurred, expected checksum Type: sha1,
|
9385
|
+
# actual checksum Type: crc32c.
|
9386
|
+
#
|
9387
|
+
# * Request body cannot be empty when 'write offset' is specified.
|
9388
|
+
#
|
9389
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/InvalidRequest AWS API Documentation
|
9390
|
+
#
|
9391
|
+
class InvalidRequest < Aws::EmptyStructure; end
|
9392
|
+
|
9393
|
+
# The write offset value that you specified does not match the current
|
9394
|
+
# object size.
|
9395
|
+
#
|
9396
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/InvalidWriteOffset AWS API Documentation
|
9397
|
+
#
|
9398
|
+
class InvalidWriteOffset < Aws::EmptyStructure; end
|
9399
|
+
|
9021
9400
|
# Specifies the inventory configuration for an Amazon S3 bucket. For
|
9022
9401
|
# more information, see [GET Bucket inventory][1] in the *Amazon S3 API
|
9023
9402
|
# Reference*.
|
@@ -9292,6 +9671,11 @@ module Aws::S3
|
|
9292
9671
|
# Indicates at what date the object is to be moved or deleted. The
|
9293
9672
|
# date value must conform to the ISO 8601 format. The time is always
|
9294
9673
|
# midnight UTC.
|
9674
|
+
#
|
9675
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9676
|
+
# supported for directory bucket lifecycle configurations.
|
9677
|
+
#
|
9678
|
+
# </note>
|
9295
9679
|
# @return [Time]
|
9296
9680
|
#
|
9297
9681
|
# @!attribute [rw] days
|
@@ -9304,6 +9688,11 @@ module Aws::S3
|
|
9304
9688
|
# noncurrent versions. If set to true, the delete marker will be
|
9305
9689
|
# expired; if set to false the policy takes no action. This cannot be
|
9306
9690
|
# specified with Days or Date in a Lifecycle Expiration Policy.
|
9691
|
+
#
|
9692
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9693
|
+
# supported for directory bucket lifecycle configurations.
|
9694
|
+
#
|
9695
|
+
# </note>
|
9307
9696
|
# @return [Boolean]
|
9308
9697
|
#
|
9309
9698
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LifecycleExpiration AWS API Documentation
|
@@ -9353,6 +9742,10 @@ module Aws::S3
|
|
9353
9742
|
# applies to. A `Filter` must have exactly one of `Prefix`, `Tag`, or
|
9354
9743
|
# `And` specified. `Filter` is required if the `LifecycleRule` does
|
9355
9744
|
# not contain a `Prefix` element.
|
9745
|
+
#
|
9746
|
+
# <note markdown="1"> `Tag` filters are not supported for directory buckets.
|
9747
|
+
#
|
9748
|
+
# </note>
|
9356
9749
|
# @return [Types::LifecycleRuleFilter]
|
9357
9750
|
#
|
9358
9751
|
# @!attribute [rw] status
|
@@ -9363,6 +9756,11 @@ module Aws::S3
|
|
9363
9756
|
# @!attribute [rw] transitions
|
9364
9757
|
# Specifies when an Amazon S3 object transitions to a specified
|
9365
9758
|
# storage class.
|
9759
|
+
#
|
9760
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9761
|
+
# supported for directory bucket lifecycle configurations.
|
9762
|
+
#
|
9763
|
+
# </note>
|
9366
9764
|
# @return [Array<Types::Transition>]
|
9367
9765
|
#
|
9368
9766
|
# @!attribute [rw] noncurrent_version_transitions
|
@@ -9372,6 +9770,11 @@ module Aws::S3
|
|
9372
9770
|
# can set this action to request that Amazon S3 transition noncurrent
|
9373
9771
|
# object versions to a specific storage class at a set period in the
|
9374
9772
|
# object's lifetime.
|
9773
|
+
#
|
9774
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9775
|
+
# supported for directory bucket lifecycle configurations.
|
9776
|
+
#
|
9777
|
+
# </note>
|
9375
9778
|
# @return [Array<Types::NoncurrentVersionTransition>]
|
9376
9779
|
#
|
9377
9780
|
# @!attribute [rw] noncurrent_version_expiration
|
@@ -9381,6 +9784,11 @@ module Aws::S3
|
|
9381
9784
|
# versioning enabled (or suspended) to request that Amazon S3 delete
|
9382
9785
|
# noncurrent object versions at a specific period in the object's
|
9383
9786
|
# lifetime.
|
9787
|
+
#
|
9788
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9789
|
+
# supported for directory bucket lifecycle configurations.
|
9790
|
+
#
|
9791
|
+
# </note>
|
9384
9792
|
# @return [Types::NoncurrentVersionExpiration]
|
9385
9793
|
#
|
9386
9794
|
# @!attribute [rw] abort_incomplete_multipart_upload
|
@@ -9464,6 +9872,11 @@ module Aws::S3
|
|
9464
9872
|
# @!attribute [rw] tag
|
9465
9873
|
# This tag must exist in the object's tag set in order for the rule
|
9466
9874
|
# to apply.
|
9875
|
+
#
|
9876
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
9877
|
+
# supported for directory bucket lifecycle configurations.
|
9878
|
+
#
|
9879
|
+
# </note>
|
9467
9880
|
# @return [Types::Tag]
|
9468
9881
|
#
|
9469
9882
|
# @!attribute [rw] object_size_greater_than
|
@@ -10004,10 +10417,10 @@ module Aws::S3
|
|
10004
10417
|
#
|
10005
10418
|
# **Directory buckets** - When you use this operation with a directory
|
10006
10419
|
# bucket, you must use virtual-hosted-style requests in the format `
|
10007
|
-
#
|
10420
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10008
10421
|
# requests are not supported. Directory bucket names must be unique in
|
10009
|
-
# the chosen Availability Zone. Bucket names must
|
10010
|
-
#
|
10422
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
10423
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
10011
10424
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
10012
10425
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
10013
10426
|
# *Amazon S3 User Guide*.
|
@@ -10526,10 +10939,10 @@ module Aws::S3
|
|
10526
10939
|
#
|
10527
10940
|
# **Directory buckets** - When you use this operation with a directory
|
10528
10941
|
# bucket, you must use virtual-hosted-style requests in the format `
|
10529
|
-
#
|
10942
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10530
10943
|
# requests are not supported. Directory bucket names must be unique in
|
10531
|
-
# the chosen Availability Zone. Bucket names must
|
10532
|
-
#
|
10944
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
10945
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
10533
10946
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
10534
10947
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
10535
10948
|
# *Amazon S3 User Guide*.
|
@@ -10797,10 +11210,10 @@ module Aws::S3
|
|
10797
11210
|
# @!attribute [rw] bucket
|
10798
11211
|
# **Directory buckets** - When you use this operation with a directory
|
10799
11212
|
# bucket, you must use virtual-hosted-style requests in the format `
|
10800
|
-
#
|
11213
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
10801
11214
|
# requests are not supported. Directory bucket names must be unique in
|
10802
|
-
# the chosen Availability Zone. Bucket names must
|
10803
|
-
#
|
11215
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11216
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
10804
11217
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
10805
11218
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
10806
11219
|
# *Amazon S3 User Guide*.
|
@@ -11108,10 +11521,10 @@ module Aws::S3
|
|
11108
11521
|
#
|
11109
11522
|
# **Directory buckets** - When you use this operation with a directory
|
11110
11523
|
# bucket, you must use virtual-hosted-style requests in the format `
|
11111
|
-
#
|
11524
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
11112
11525
|
# requests are not supported. Directory bucket names must be unique in
|
11113
|
-
# the chosen Availability Zone. Bucket names must
|
11114
|
-
#
|
11526
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
11527
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
11115
11528
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
11116
11529
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
11117
11530
|
# *Amazon S3 User Guide*.
|
@@ -11255,9 +11668,9 @@ module Aws::S3
|
|
11255
11668
|
|
11256
11669
|
# Specifies the location where the bucket will be created.
|
11257
11670
|
#
|
11258
|
-
# For directory buckets, the location type is Availability Zone
|
11259
|
-
# more information about directory buckets, see [Directory
|
11260
|
-
# in the *Amazon S3 User Guide*.
|
11671
|
+
# For directory buckets, the location type is Availability Zone or Local
|
11672
|
+
# Zone. For more information about directory buckets, see [Directory
|
11673
|
+
# buckets][1] in the *Amazon S3 User Guide*.
|
11261
11674
|
#
|
11262
11675
|
# <note markdown="1"> This functionality is only supported by directory buckets.
|
11263
11676
|
#
|
@@ -11274,9 +11687,9 @@ module Aws::S3
|
|
11274
11687
|
# @!attribute [rw] name
|
11275
11688
|
# The name of the location where the bucket will be created.
|
11276
11689
|
#
|
11277
|
-
# For directory buckets, the name of the location is the
|
11278
|
-
# Availability Zone
|
11279
|
-
# value is `usw2-az1`.
|
11690
|
+
# For directory buckets, the name of the location is the Zone ID of
|
11691
|
+
# the Availability Zone (AZ) or Local Zone (LZ) where the bucket will
|
11692
|
+
# be created. An example AZ ID value is `usw2-az1`.
|
11280
11693
|
# @return [String]
|
11281
11694
|
#
|
11282
11695
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LocationInfo AWS API Documentation
|
@@ -11359,6 +11772,46 @@ module Aws::S3
|
|
11359
11772
|
include Aws::Structure
|
11360
11773
|
end
|
11361
11774
|
|
11775
|
+
# The metadata table configuration for a general purpose bucket.
|
11776
|
+
#
|
11777
|
+
# @!attribute [rw] s3_tables_destination
|
11778
|
+
# The destination information for the metadata table configuration.
|
11779
|
+
# The destination table bucket must be in the same Region and Amazon
|
11780
|
+
# Web Services account as the general purpose bucket. The specified
|
11781
|
+
# metadata table name must be unique within the `aws_s3_metadata`
|
11782
|
+
# namespace in the destination table bucket.
|
11783
|
+
# @return [Types::S3TablesDestination]
|
11784
|
+
#
|
11785
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataTableConfiguration AWS API Documentation
|
11786
|
+
#
|
11787
|
+
class MetadataTableConfiguration < Struct.new(
|
11788
|
+
:s3_tables_destination)
|
11789
|
+
SENSITIVE = []
|
11790
|
+
include Aws::Structure
|
11791
|
+
end
|
11792
|
+
|
11793
|
+
# The metadata table configuration for a general purpose bucket. The
|
11794
|
+
# destination table bucket must be in the same Region and Amazon Web
|
11795
|
+
# Services account as the general purpose bucket. The specified metadata
|
11796
|
+
# table name must be unique within the `aws_s3_metadata` namespace in
|
11797
|
+
# the destination table bucket.
|
11798
|
+
#
|
11799
|
+
# @!attribute [rw] s3_tables_destination_result
|
11800
|
+
# The destination information for the metadata table configuration.
|
11801
|
+
# The destination table bucket must be in the same Region and Amazon
|
11802
|
+
# Web Services account as the general purpose bucket. The specified
|
11803
|
+
# metadata table name must be unique within the `aws_s3_metadata`
|
11804
|
+
# namespace in the destination table bucket.
|
11805
|
+
# @return [Types::S3TablesDestinationResult]
|
11806
|
+
#
|
11807
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataTableConfigurationResult AWS API Documentation
|
11808
|
+
#
|
11809
|
+
class MetadataTableConfigurationResult < Struct.new(
|
11810
|
+
:s3_tables_destination_result)
|
11811
|
+
SENSITIVE = []
|
11812
|
+
include Aws::Structure
|
11813
|
+
end
|
11814
|
+
|
11362
11815
|
# A container specifying replication metrics-related settings enabling
|
11363
11816
|
# replication metrics and events.
|
11364
11817
|
#
|
@@ -11559,6 +12012,11 @@ module Aws::S3
|
|
11559
12012
|
# enabled (or suspended) to request that Amazon S3 delete noncurrent
|
11560
12013
|
# object versions at a specific period in the object's lifetime.
|
11561
12014
|
#
|
12015
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
12016
|
+
# supported for directory bucket lifecycle configurations.
|
12017
|
+
#
|
12018
|
+
# </note>
|
12019
|
+
#
|
11562
12020
|
# @!attribute [rw] noncurrent_days
|
11563
12021
|
# Specifies the number of days an object is noncurrent before Amazon
|
11564
12022
|
# S3 can perform the associated action. The value must be a non-zero
|
@@ -11566,6 +12024,11 @@ module Aws::S3
|
|
11566
12024
|
# calculations, see [How Amazon S3 Calculates When an Object Became
|
11567
12025
|
# Noncurrent][1] in the *Amazon S3 User Guide*.
|
11568
12026
|
#
|
12027
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
12028
|
+
# supported for directory bucket lifecycle configurations.
|
12029
|
+
#
|
12030
|
+
# </note>
|
12031
|
+
#
|
11569
12032
|
#
|
11570
12033
|
#
|
11571
12034
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#non-current-days-calculations
|
@@ -11579,6 +12042,11 @@ module Aws::S3
|
|
11579
12042
|
# versions, see [Lifecycle configuration elements][1] in the *Amazon
|
11580
12043
|
# S3 User Guide*.
|
11581
12044
|
#
|
12045
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
12046
|
+
# supported for directory bucket lifecycle configurations.
|
12047
|
+
#
|
12048
|
+
# </note>
|
12049
|
+
#
|
11582
12050
|
#
|
11583
12051
|
#
|
11584
12052
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html
|
@@ -11849,11 +12317,43 @@ module Aws::S3
|
|
11849
12317
|
# </note>
|
11850
12318
|
# @return [String]
|
11851
12319
|
#
|
12320
|
+
# @!attribute [rw] etag
|
12321
|
+
# An entity tag (ETag) is an identifier assigned by a web server to a
|
12322
|
+
# specific version of a resource found at a URL. This header field
|
12323
|
+
# makes the request method conditional on `ETags`.
|
12324
|
+
#
|
12325
|
+
# <note markdown="1"> Entity tags (ETags) for S3 Express One Zone are random alphanumeric
|
12326
|
+
# strings unique to the object.
|
12327
|
+
#
|
12328
|
+
# </note>
|
12329
|
+
# @return [String]
|
12330
|
+
#
|
12331
|
+
# @!attribute [rw] last_modified_time
|
12332
|
+
# If present, the objects are deleted only if its modification times
|
12333
|
+
# matches the provided `Timestamp`.
|
12334
|
+
#
|
12335
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
12336
|
+
#
|
12337
|
+
# </note>
|
12338
|
+
# @return [Time]
|
12339
|
+
#
|
12340
|
+
# @!attribute [rw] size
|
12341
|
+
# If present, the objects are deleted only if its size matches the
|
12342
|
+
# provided size in bytes.
|
12343
|
+
#
|
12344
|
+
# <note markdown="1"> This functionality is only supported for directory buckets.
|
12345
|
+
#
|
12346
|
+
# </note>
|
12347
|
+
# @return [Integer]
|
12348
|
+
#
|
11852
12349
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectIdentifier AWS API Documentation
|
11853
12350
|
#
|
11854
12351
|
class ObjectIdentifier < Struct.new(
|
11855
12352
|
:key,
|
11856
|
-
:version_id
|
12353
|
+
:version_id,
|
12354
|
+
:etag,
|
12355
|
+
:last_modified_time,
|
12356
|
+
:size)
|
11857
12357
|
SENSITIVE = []
|
11858
12358
|
include Aws::Structure
|
11859
12359
|
end
|
@@ -12713,13 +13213,14 @@ module Aws::S3
|
|
12713
13213
|
#
|
12714
13214
|
# <b>Directory buckets </b> - When you use this operation with a
|
12715
13215
|
# directory bucket, you must use path-style requests in the format
|
12716
|
-
# `https://s3express-control.
|
13216
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
12717
13217
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
12718
|
-
# names must be unique in the chosen Availability Zone
|
12719
|
-
# must also follow the format `
|
12720
|
-
#
|
12721
|
-
#
|
12722
|
-
# rules][1] in the
|
13218
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
13219
|
+
# Zone). Bucket names must also follow the format `
|
13220
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
13221
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
13222
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
13223
|
+
# *Amazon S3 User Guide*
|
12723
13224
|
#
|
12724
13225
|
#
|
12725
13226
|
#
|
@@ -12849,6 +13350,11 @@ module Aws::S3
|
|
12849
13350
|
# Indicates which default minimum object size behavior is applied to
|
12850
13351
|
# the lifecycle configuration.
|
12851
13352
|
#
|
13353
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
13354
|
+
# supported for directory bucket lifecycle configurations.
|
13355
|
+
#
|
13356
|
+
# </note>
|
13357
|
+
#
|
12852
13358
|
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
12853
13359
|
# transition to any storage class by default.
|
12854
13360
|
#
|
@@ -12901,12 +13407,22 @@ module Aws::S3
|
|
12901
13407
|
# you provide does not match the actual owner of the bucket, the
|
12902
13408
|
# request fails with the HTTP status code `403 Forbidden` (access
|
12903
13409
|
# denied).
|
13410
|
+
#
|
13411
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
13412
|
+
# supported for directory bucket lifecycle configurations.
|
13413
|
+
#
|
13414
|
+
# </note>
|
12904
13415
|
# @return [String]
|
12905
13416
|
#
|
12906
13417
|
# @!attribute [rw] transition_default_minimum_object_size
|
12907
13418
|
# Indicates which default minimum object size behavior is applied to
|
12908
13419
|
# the lifecycle configuration.
|
12909
13420
|
#
|
13421
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
13422
|
+
# supported for directory bucket lifecycle configurations.
|
13423
|
+
#
|
13424
|
+
# </note>
|
13425
|
+
#
|
12910
13426
|
# * `all_storage_classes_128K` - Objects smaller than 128 KB will not
|
12911
13427
|
# transition to any storage class by default.
|
12912
13428
|
#
|
@@ -13191,13 +13707,14 @@ module Aws::S3
|
|
13191
13707
|
#
|
13192
13708
|
# <b>Directory buckets </b> - When you use this operation with a
|
13193
13709
|
# directory bucket, you must use path-style requests in the format
|
13194
|
-
# `https://s3express-control.
|
13710
|
+
# `https://s3express-control.region-code.amazonaws.com/bucket-name `.
|
13195
13711
|
# Virtual-hosted-style requests aren't supported. Directory bucket
|
13196
|
-
# names must be unique in the chosen Availability Zone
|
13197
|
-
# must also follow the format `
|
13198
|
-
#
|
13199
|
-
#
|
13200
|
-
# rules][1] in the
|
13712
|
+
# names must be unique in the chosen Zone (Availability Zone or Local
|
13713
|
+
# Zone). Bucket names must also follow the format `
|
13714
|
+
# bucket-base-name--zone-id--x-s3` (for example, `
|
13715
|
+
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
13716
|
+
# naming restrictions, see [Directory bucket naming rules][1] in the
|
13717
|
+
# *Amazon S3 User Guide*
|
13201
13718
|
#
|
13202
13719
|
#
|
13203
13720
|
#
|
@@ -14006,7 +14523,9 @@ module Aws::S3
|
|
14006
14523
|
# `rule-id` key-value pairs that provide information about object
|
14007
14524
|
# expiration. The value of the `rule-id` is URL-encoded.
|
14008
14525
|
#
|
14009
|
-
# <note markdown="1">
|
14526
|
+
# <note markdown="1"> Object expiration information is not returned in directory buckets
|
14527
|
+
# and this header returns the value "`NotImplemented`" in all
|
14528
|
+
# responses for directory buckets.
|
14010
14529
|
#
|
14011
14530
|
# </note>
|
14012
14531
|
#
|
@@ -14157,6 +14676,16 @@ module Aws::S3
|
|
14157
14676
|
# (SSE-KMS).
|
14158
14677
|
# @return [Boolean]
|
14159
14678
|
#
|
14679
|
+
# @!attribute [rw] size
|
14680
|
+
# The size of the object in bytes. This will only be present if you
|
14681
|
+
# append to an object.
|
14682
|
+
#
|
14683
|
+
# <note markdown="1"> This functionality is only supported for objects in the Amazon S3
|
14684
|
+
# Express One Zone storage class in directory buckets.
|
14685
|
+
#
|
14686
|
+
# </note>
|
14687
|
+
# @return [Integer]
|
14688
|
+
#
|
14160
14689
|
# @!attribute [rw] request_charged
|
14161
14690
|
# If present, indicates that the requester was successfully charged
|
14162
14691
|
# for the request.
|
@@ -14182,6 +14711,7 @@ module Aws::S3
|
|
14182
14711
|
:ssekms_key_id,
|
14183
14712
|
:ssekms_encryption_context,
|
14184
14713
|
:bucket_key_enabled,
|
14714
|
+
:size,
|
14185
14715
|
:request_charged)
|
14186
14716
|
SENSITIVE = [:ssekms_key_id, :ssekms_encryption_context]
|
14187
14717
|
include Aws::Structure
|
@@ -14235,10 +14765,10 @@ module Aws::S3
|
|
14235
14765
|
#
|
14236
14766
|
# **Directory buckets** - When you use this operation with a directory
|
14237
14767
|
# bucket, you must use virtual-hosted-style requests in the format `
|
14238
|
-
#
|
14768
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
14239
14769
|
# requests are not supported. Directory bucket names must be unique in
|
14240
|
-
# the chosen Availability Zone. Bucket names must
|
14241
|
-
#
|
14770
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
14771
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
14242
14772
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
14243
14773
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
14244
14774
|
# *Amazon S3 User Guide*.
|
@@ -14464,6 +14994,27 @@ module Aws::S3
|
|
14464
14994
|
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
14465
14995
|
# @return [Time]
|
14466
14996
|
#
|
14997
|
+
# @!attribute [rw] if_match
|
14998
|
+
# Uploads the object only if the ETag (entity tag) value provided
|
14999
|
+
# during the WRITE operation matches the ETag of the object in S3. If
|
15000
|
+
# the ETag values do not match, the operation returns a `412
|
15001
|
+
# Precondition Failed` error.
|
15002
|
+
#
|
15003
|
+
# If a conflicting operation occurs during the upload S3 returns a
|
15004
|
+
# `409 ConditionalRequestConflict` response. On a 409 failure you
|
15005
|
+
# should fetch the object's ETag and retry the upload.
|
15006
|
+
#
|
15007
|
+
# Expects the ETag value as a string.
|
15008
|
+
#
|
15009
|
+
# For more information about conditional requests, see [RFC 7232][1],
|
15010
|
+
# or [Conditional requests][2] in the *Amazon S3 User Guide*.
|
15011
|
+
#
|
15012
|
+
#
|
15013
|
+
#
|
15014
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
15015
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
15016
|
+
# @return [String]
|
15017
|
+
#
|
14467
15018
|
# @!attribute [rw] if_none_match
|
14468
15019
|
# Uploads the object only if the object key name does not already
|
14469
15020
|
# exist in the bucket specified. Otherwise, Amazon S3 returns a `412
|
@@ -14529,6 +15080,18 @@ module Aws::S3
|
|
14529
15080
|
# Object key for which the PUT action was initiated.
|
14530
15081
|
# @return [String]
|
14531
15082
|
#
|
15083
|
+
# @!attribute [rw] write_offset_bytes
|
15084
|
+
# Specifies the offset for appending data to existing objects in
|
15085
|
+
# bytes. The offset must be equal to the size of the existing object
|
15086
|
+
# being appended to. If no object exists, setting this header to 0
|
15087
|
+
# will create a new object.
|
15088
|
+
#
|
15089
|
+
# <note markdown="1"> This functionality is only supported for objects in the Amazon S3
|
15090
|
+
# Express One Zone storage class in directory buckets.
|
15091
|
+
#
|
15092
|
+
# </note>
|
15093
|
+
# @return [Integer]
|
15094
|
+
#
|
14532
15095
|
# @!attribute [rw] metadata
|
14533
15096
|
# A map of metadata to store with the object in S3.
|
14534
15097
|
# @return [Hash<String,String>]
|
@@ -14855,12 +15418,14 @@ module Aws::S3
|
|
14855
15418
|
:checksum_sha1,
|
14856
15419
|
:checksum_sha256,
|
14857
15420
|
:expires,
|
15421
|
+
:if_match,
|
14858
15422
|
:if_none_match,
|
14859
15423
|
:grant_full_control,
|
14860
15424
|
:grant_read,
|
14861
15425
|
:grant_read_acp,
|
14862
15426
|
:grant_write_acp,
|
14863
15427
|
:key,
|
15428
|
+
:write_offset_bytes,
|
14864
15429
|
:metadata,
|
14865
15430
|
:server_side_encryption,
|
14866
15431
|
:storage_class,
|
@@ -15822,7 +16387,15 @@ module Aws::S3
|
|
15822
16387
|
# @return [Types::GlacierJobParameters]
|
15823
16388
|
#
|
15824
16389
|
# @!attribute [rw] type
|
16390
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
16391
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
16392
|
+
# usual. [Learn more][1]
|
16393
|
+
#
|
15825
16394
|
# Type of restore request.
|
16395
|
+
#
|
16396
|
+
#
|
16397
|
+
#
|
16398
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15826
16399
|
# @return [String]
|
15827
16400
|
#
|
15828
16401
|
# @!attribute [rw] tier
|
@@ -15834,7 +16407,15 @@ module Aws::S3
|
|
15834
16407
|
# @return [String]
|
15835
16408
|
#
|
15836
16409
|
# @!attribute [rw] select_parameters
|
16410
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
16411
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
16412
|
+
# usual. [Learn more][1]
|
16413
|
+
#
|
15837
16414
|
# Describes the parameters for Select job types.
|
16415
|
+
#
|
16416
|
+
#
|
16417
|
+
#
|
16418
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15838
16419
|
# @return [Types::SelectParameters]
|
15839
16420
|
#
|
15840
16421
|
# @!attribute [rw] output_location
|
@@ -16002,6 +16583,11 @@ module Aws::S3
|
|
16002
16583
|
# versioning enabled (or suspended) to request that Amazon S3 delete
|
16003
16584
|
# noncurrent object versions at a specific period in the object's
|
16004
16585
|
# lifetime.
|
16586
|
+
#
|
16587
|
+
# <note markdown="1"> This parameter applies to general purpose buckets only. It is not
|
16588
|
+
# supported for directory bucket lifecycle configurations.
|
16589
|
+
#
|
16590
|
+
# </note>
|
16005
16591
|
# @return [Types::NoncurrentVersionExpiration]
|
16006
16592
|
#
|
16007
16593
|
# @!attribute [rw] abort_incomplete_multipart_upload
|
@@ -16097,6 +16683,78 @@ module Aws::S3
|
|
16097
16683
|
include Aws::Structure
|
16098
16684
|
end
|
16099
16685
|
|
16686
|
+
# The destination information for the metadata table configuration. The
|
16687
|
+
# destination table bucket must be in the same Region and Amazon Web
|
16688
|
+
# Services account as the general purpose bucket. The specified metadata
|
16689
|
+
# table name must be unique within the `aws_s3_metadata` namespace in
|
16690
|
+
# the destination table bucket.
|
16691
|
+
#
|
16692
|
+
# @!attribute [rw] table_bucket_arn
|
16693
|
+
# The Amazon Resource Name (ARN) for the table bucket that's
|
16694
|
+
# specified as the destination in the metadata table configuration.
|
16695
|
+
# The destination table bucket must be in the same Region and Amazon
|
16696
|
+
# Web Services account as the general purpose bucket.
|
16697
|
+
# @return [String]
|
16698
|
+
#
|
16699
|
+
# @!attribute [rw] table_name
|
16700
|
+
# The name for the metadata table in your metadata table
|
16701
|
+
# configuration. The specified metadata table name must be unique
|
16702
|
+
# within the `aws_s3_metadata` namespace in the destination table
|
16703
|
+
# bucket.
|
16704
|
+
# @return [String]
|
16705
|
+
#
|
16706
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/S3TablesDestination AWS API Documentation
|
16707
|
+
#
|
16708
|
+
class S3TablesDestination < Struct.new(
|
16709
|
+
:table_bucket_arn,
|
16710
|
+
:table_name)
|
16711
|
+
SENSITIVE = []
|
16712
|
+
include Aws::Structure
|
16713
|
+
end
|
16714
|
+
|
16715
|
+
# The destination information for the metadata table configuration. The
|
16716
|
+
# destination table bucket must be in the same Region and Amazon Web
|
16717
|
+
# Services account as the general purpose bucket. The specified metadata
|
16718
|
+
# table name must be unique within the `aws_s3_metadata` namespace in
|
16719
|
+
# the destination table bucket.
|
16720
|
+
#
|
16721
|
+
# @!attribute [rw] table_bucket_arn
|
16722
|
+
# The Amazon Resource Name (ARN) for the table bucket that's
|
16723
|
+
# specified as the destination in the metadata table configuration.
|
16724
|
+
# The destination table bucket must be in the same Region and Amazon
|
16725
|
+
# Web Services account as the general purpose bucket.
|
16726
|
+
# @return [String]
|
16727
|
+
#
|
16728
|
+
# @!attribute [rw] table_name
|
16729
|
+
# The name for the metadata table in your metadata table
|
16730
|
+
# configuration. The specified metadata table name must be unique
|
16731
|
+
# within the `aws_s3_metadata` namespace in the destination table
|
16732
|
+
# bucket.
|
16733
|
+
# @return [String]
|
16734
|
+
#
|
16735
|
+
# @!attribute [rw] table_arn
|
16736
|
+
# The Amazon Resource Name (ARN) for the metadata table in the
|
16737
|
+
# metadata table configuration. The specified metadata table name must
|
16738
|
+
# be unique within the `aws_s3_metadata` namespace in the destination
|
16739
|
+
# table bucket.
|
16740
|
+
# @return [String]
|
16741
|
+
#
|
16742
|
+
# @!attribute [rw] table_namespace
|
16743
|
+
# The table bucket namespace for the metadata table in your metadata
|
16744
|
+
# table configuration. This value is always `aws_s3_metadata`.
|
16745
|
+
# @return [String]
|
16746
|
+
#
|
16747
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/S3TablesDestinationResult AWS API Documentation
|
16748
|
+
#
|
16749
|
+
class S3TablesDestinationResult < Struct.new(
|
16750
|
+
:table_bucket_arn,
|
16751
|
+
:table_name,
|
16752
|
+
:table_arn,
|
16753
|
+
:table_namespace)
|
16754
|
+
SENSITIVE = []
|
16755
|
+
include Aws::Structure
|
16756
|
+
end
|
16757
|
+
|
16100
16758
|
# Specifies the use of SSE-KMS to encrypt delivered inventory reports.
|
16101
16759
|
#
|
16102
16760
|
# @!attribute [rw] key_id
|
@@ -16165,6 +16823,12 @@ module Aws::S3
|
|
16165
16823
|
include Aws::Structure
|
16166
16824
|
end
|
16167
16825
|
|
16826
|
+
# <note markdown="1"> Learn Amazon S3 Select is no longer available to new customers.
|
16827
|
+
# Existing customers of Amazon S3 Select can continue to use the feature
|
16828
|
+
# as usual. [Learn more][1]
|
16829
|
+
#
|
16830
|
+
# </note>
|
16831
|
+
#
|
16168
16832
|
# Request to filter the contents of an Amazon S3 object based on a
|
16169
16833
|
# simple Structured Query Language (SQL) statement. In the request,
|
16170
16834
|
# along with the SQL expression, you must specify a data serialization
|
@@ -16172,11 +16836,12 @@ module Aws::S3
|
|
16172
16836
|
# object data into records. It returns only records that match the
|
16173
16837
|
# specified SQL expression. You must also specify the data serialization
|
16174
16838
|
# format for the response. For more information, see [S3Select API
|
16175
|
-
# Documentation][
|
16839
|
+
# Documentation][2].
|
16176
16840
|
#
|
16177
16841
|
#
|
16178
16842
|
#
|
16179
|
-
# [1]:
|
16843
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
16844
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html
|
16180
16845
|
#
|
16181
16846
|
# @!attribute [rw] bucket
|
16182
16847
|
# The S3 bucket.
|
@@ -16288,8 +16953,21 @@ module Aws::S3
|
|
16288
16953
|
include Aws::Structure
|
16289
16954
|
end
|
16290
16955
|
|
16956
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
16957
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
16958
|
+
# usual. [Learn more][1]
|
16959
|
+
#
|
16291
16960
|
# Describes the parameters for Select job types.
|
16292
16961
|
#
|
16962
|
+
# Learn [How to optimize querying your data in Amazon S3][1] using
|
16963
|
+
# [Amazon Athena][2], [S3 Object Lambda][3], or client-side filtering.
|
16964
|
+
#
|
16965
|
+
#
|
16966
|
+
#
|
16967
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
16968
|
+
# [2]: https://docs.aws.amazon.com/athena/latest/ug/what-is.html
|
16969
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
|
16970
|
+
#
|
16293
16971
|
# @!attribute [rw] input_serialization
|
16294
16972
|
# Describes the serialization format of the object.
|
16295
16973
|
# @return [Types::InputSerialization]
|
@@ -16299,7 +16977,15 @@ module Aws::S3
|
|
16299
16977
|
# @return [String]
|
16300
16978
|
#
|
16301
16979
|
# @!attribute [rw] expression
|
16980
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
16981
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
16982
|
+
# usual. [Learn more][1]
|
16983
|
+
#
|
16302
16984
|
# The expression that is used to query the object.
|
16985
|
+
#
|
16986
|
+
#
|
16987
|
+
#
|
16988
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
16303
16989
|
# @return [String]
|
16304
16990
|
#
|
16305
16991
|
# @!attribute [rw] output_serialization
|
@@ -16797,6 +17483,15 @@ module Aws::S3
|
|
16797
17483
|
include Aws::Structure
|
16798
17484
|
end
|
16799
17485
|
|
17486
|
+
# You have attempted to add more parts than the maximum of 10000 that
|
17487
|
+
# are allowed for this object. You can use the CopyObject operation to
|
17488
|
+
# copy this object to another and then add more data to the newly copied
|
17489
|
+
# object.
|
17490
|
+
#
|
17491
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/TooManyParts AWS API Documentation
|
17492
|
+
#
|
17493
|
+
class TooManyParts < Aws::EmptyStructure; end
|
17494
|
+
|
16800
17495
|
# A container for specifying the configuration for publication of
|
16801
17496
|
# messages to an Amazon Simple Notification Service (Amazon SNS) topic
|
16802
17497
|
# when Amazon S3 detects specified events.
|
@@ -16998,14 +17693,22 @@ module Aws::S3
|
|
16998
17693
|
#
|
16999
17694
|
# **Directory buckets** - When you use this operation with a directory
|
17000
17695
|
# bucket, you must use virtual-hosted-style requests in the format `
|
17001
|
-
#
|
17696
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
17002
17697
|
# requests are not supported. Directory bucket names must be unique in
|
17003
|
-
# the chosen Availability Zone. Bucket names must
|
17004
|
-
#
|
17698
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
17699
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
17005
17700
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
17006
17701
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
17007
17702
|
# *Amazon S3 User Guide*.
|
17008
17703
|
#
|
17704
|
+
# <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
|
17705
|
+
# supported when the source or destination bucket is in Amazon Web
|
17706
|
+
# Services Local Zones. The source and destination buckets must have
|
17707
|
+
# the same parent Amazon Web Services Region. Otherwise, you get an
|
17708
|
+
# HTTP `400 Bad Request` error with the error code `InvalidRequest`.
|
17709
|
+
#
|
17710
|
+
# </note>
|
17711
|
+
#
|
17009
17712
|
# **Access points** - When you use this action with an access point,
|
17010
17713
|
# you must provide the alias of the access point in place of the
|
17011
17714
|
# bucket name or specify the access point ARN. When using the access
|
@@ -17451,10 +18154,10 @@ module Aws::S3
|
|
17451
18154
|
#
|
17452
18155
|
# **Directory buckets** - When you use this operation with a directory
|
17453
18156
|
# bucket, you must use virtual-hosted-style requests in the format `
|
17454
|
-
#
|
18157
|
+
# Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
|
17455
18158
|
# requests are not supported. Directory bucket names must be unique in
|
17456
|
-
# the chosen Availability Zone. Bucket names must
|
17457
|
-
#
|
18159
|
+
# the chosen Zone (Availability Zone or Local Zone). Bucket names must
|
18160
|
+
# follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
|
17458
18161
|
# DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
|
17459
18162
|
# naming restrictions, see [Directory bucket naming rules][1] in the
|
17460
18163
|
# *Amazon S3 User Guide*.
|