aws-sdk-s3 1.156.0 → 1.159.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +15 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/access_grants_credentials_provider.rb +12 -3
- data/lib/aws-sdk-s3/bucket.rb +79 -16
- data/lib/aws-sdk-s3/client.rb +541 -312
- data/lib/aws-sdk-s3/client_api.rb +16 -1
- data/lib/aws-sdk-s3/multipart_upload.rb +20 -0
- data/lib/aws-sdk-s3/object.rb +36 -4
- data/lib/aws-sdk-s3/object_summary.rb +28 -0
- data/lib/aws-sdk-s3/object_version.rb +17 -4
- data/lib/aws-sdk-s3/plugins/access_grants.rb +68 -4
- data/lib/aws-sdk-s3/resource.rb +10 -8
- data/lib/aws-sdk-s3/types.rb +294 -47
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +1 -0
- data/sig/client.rbs +7 -1
- data/sig/multipart_upload.rbs +1 -0
- data/sig/object.rbs +1 -0
- data/sig/object_summary.rbs +1 -0
- data/sig/resource.rbs +2 -1
- data/sig/types.rbs +9 -0
- metadata +2 -2
data/lib/aws-sdk-s3/types.rb
CHANGED
@@ -1061,6 +1061,27 @@ module Aws::S3
|
|
1061
1061
|
# denied).
|
1062
1062
|
# @return [String]
|
1063
1063
|
#
|
1064
|
+
# @!attribute [rw] if_none_match
|
1065
|
+
# Uploads the object only if the object key name does not already
|
1066
|
+
# exist in the bucket specified. Otherwise, Amazon S3 returns a `412
|
1067
|
+
# Precondition Failed` error.
|
1068
|
+
#
|
1069
|
+
# If a conflicting operation occurs during the upload S3 returns a
|
1070
|
+
# `409 ConditionalRequestConflict` response. On a 409 failure you
|
1071
|
+
# should re-initiate the multipart upload with `CreateMultipartUpload`
|
1072
|
+
# and re-upload each part.
|
1073
|
+
#
|
1074
|
+
# Expects the '*' (asterisk) character.
|
1075
|
+
#
|
1076
|
+
# For more information about conditional requests, see [RFC 7232][1],
|
1077
|
+
# or [Conditional requests][2] in the *Amazon S3 User Guide*.
|
1078
|
+
#
|
1079
|
+
#
|
1080
|
+
#
|
1081
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
1082
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
1083
|
+
# @return [String]
|
1084
|
+
#
|
1064
1085
|
# @!attribute [rw] sse_customer_algorithm
|
1065
1086
|
# The server-side encryption (SSE) algorithm used to encrypt the
|
1066
1087
|
# object. This parameter is required only when the object was created
|
@@ -1120,6 +1141,7 @@ module Aws::S3
|
|
1120
1141
|
:checksum_sha256,
|
1121
1142
|
:request_payer,
|
1122
1143
|
:expected_bucket_owner,
|
1144
|
+
:if_none_match,
|
1123
1145
|
:sse_customer_algorithm,
|
1124
1146
|
:sse_customer_key,
|
1125
1147
|
:sse_customer_key_md5)
|
@@ -3333,8 +3355,9 @@ module Aws::S3
|
|
3333
3355
|
include Aws::Structure
|
3334
3356
|
end
|
3335
3357
|
|
3336
|
-
# The container element for specifying the default Object
|
3337
|
-
# settings for new objects placed in the specified
|
3358
|
+
# The container element for optionally specifying the default Object
|
3359
|
+
# Lock retention settings for new objects placed in the specified
|
3360
|
+
# bucket.
|
3338
3361
|
#
|
3339
3362
|
# <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
|
3340
3363
|
#
|
@@ -4390,6 +4413,14 @@ module Aws::S3
|
|
4390
4413
|
# Specifies encryption-related information for an Amazon S3 bucket that
|
4391
4414
|
# is a destination for replicated objects.
|
4392
4415
|
#
|
4416
|
+
# <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
|
4417
|
+
# fully qualified KMS key ARN. If you use a KMS key alias instead, then
|
4418
|
+
# KMS resolves the key within the requester’s account. This behavior can
|
4419
|
+
# result in data that's encrypted with a KMS key that belongs to the
|
4420
|
+
# requester, and not the bucket owner.
|
4421
|
+
#
|
4422
|
+
# </note>
|
4423
|
+
#
|
4393
4424
|
# @!attribute [rw] replica_kms_key_id
|
4394
4425
|
# Specifies the ID (Key ARN or Alias ARN) of the customer managed
|
4395
4426
|
# Amazon Web Services KMS key stored in Amazon Web Services Key
|
@@ -7381,6 +7412,15 @@ module Aws::S3
|
|
7381
7412
|
#
|
7382
7413
|
# @!attribute [rw] checksum_mode
|
7383
7414
|
# To retrieve the checksum, this mode must be enabled.
|
7415
|
+
#
|
7416
|
+
# In addition, if you enable checksum mode and the object is uploaded
|
7417
|
+
# with a [checksum][1] and encrypted with an Key Management Service
|
7418
|
+
# (KMS) key, you must have permission to use the `kms:Decrypt` action
|
7419
|
+
# to retrieve the checksum.
|
7420
|
+
#
|
7421
|
+
#
|
7422
|
+
#
|
7423
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
|
7384
7424
|
# @return [String]
|
7385
7425
|
#
|
7386
7426
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRequest AWS API Documentation
|
@@ -7802,17 +7842,13 @@ module Aws::S3
|
|
7802
7842
|
#
|
7803
7843
|
# @!attribute [rw] bucket_region
|
7804
7844
|
# The Region that the bucket is located.
|
7805
|
-
#
|
7806
|
-
# <note markdown="1"> This functionality is not supported for directory buckets.
|
7807
|
-
#
|
7808
|
-
# </note>
|
7809
7845
|
# @return [String]
|
7810
7846
|
#
|
7811
7847
|
# @!attribute [rw] access_point_alias
|
7812
7848
|
# Indicates whether the bucket name used in the request is an access
|
7813
7849
|
# point alias.
|
7814
7850
|
#
|
7815
|
-
# <note markdown="1">
|
7851
|
+
# <note markdown="1"> For directory buckets, the value of this field is `false`.
|
7816
7852
|
#
|
7817
7853
|
# </note>
|
7818
7854
|
# @return [Boolean]
|
@@ -8551,10 +8587,14 @@ module Aws::S3
|
|
8551
8587
|
# @!attribute [rw] checksum_mode
|
8552
8588
|
# To retrieve the checksum, this parameter must be enabled.
|
8553
8589
|
#
|
8554
|
-
# In addition, if you enable
|
8555
|
-
# encrypted with
|
8556
|
-
#
|
8557
|
-
#
|
8590
|
+
# In addition, if you enable checksum mode and the object is uploaded
|
8591
|
+
# with a [checksum][1] and encrypted with an Key Management Service
|
8592
|
+
# (KMS) key, you must have permission to use the `kms:Decrypt` action
|
8593
|
+
# to retrieve the checksum.
|
8594
|
+
#
|
8595
|
+
#
|
8596
|
+
#
|
8597
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
|
8558
8598
|
# @return [String]
|
8559
8599
|
#
|
8560
8600
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObjectRequest AWS API Documentation
|
@@ -9526,11 +9566,45 @@ module Aws::S3
|
|
9526
9566
|
# The owner of the buckets listed.
|
9527
9567
|
# @return [Types::Owner]
|
9528
9568
|
#
|
9569
|
+
# @!attribute [rw] continuation_token
|
9570
|
+
# `ContinuationToken` is included in the response when there are more
|
9571
|
+
# buckets that can be listed with pagination. The next `ListBuckets`
|
9572
|
+
# request to Amazon S3 can be continued with this `ContinuationToken`.
|
9573
|
+
# `ContinuationToken` is obfuscated and is not a real bucket.
|
9574
|
+
# @return [String]
|
9575
|
+
#
|
9529
9576
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsOutput AWS API Documentation
|
9530
9577
|
#
|
9531
9578
|
class ListBucketsOutput < Struct.new(
|
9532
9579
|
:buckets,
|
9533
|
-
:owner
|
9580
|
+
:owner,
|
9581
|
+
:continuation_token)
|
9582
|
+
SENSITIVE = []
|
9583
|
+
include Aws::Structure
|
9584
|
+
end
|
9585
|
+
|
9586
|
+
# @!attribute [rw] max_buckets
|
9587
|
+
# Maximum number of buckets to be returned in response. When the
|
9588
|
+
# number is more than the count of buckets that are owned by an Amazon
|
9589
|
+
# Web Services account, return all the buckets in response.
|
9590
|
+
# @return [Integer]
|
9591
|
+
#
|
9592
|
+
# @!attribute [rw] continuation_token
|
9593
|
+
# `ContinuationToken` indicates to Amazon S3 that the list is being
|
9594
|
+
# continued on this bucket with a token. `ContinuationToken` is
|
9595
|
+
# obfuscated and is not a real key. You can use this
|
9596
|
+
# `ContinuationToken` for pagination of the list results.
|
9597
|
+
#
|
9598
|
+
# Length Constraints: Minimum length of 0. Maximum length of 1024.
|
9599
|
+
#
|
9600
|
+
# Required: No.
|
9601
|
+
# @return [String]
|
9602
|
+
#
|
9603
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsRequest AWS API Documentation
|
9604
|
+
#
|
9605
|
+
class ListBucketsRequest < Struct.new(
|
9606
|
+
:max_buckets,
|
9607
|
+
:continuation_token)
|
9534
9608
|
SENSITIVE = []
|
9535
9609
|
include Aws::Structure
|
9536
9610
|
end
|
@@ -9556,9 +9630,10 @@ module Aws::S3
|
|
9556
9630
|
|
9557
9631
|
# @!attribute [rw] continuation_token
|
9558
9632
|
# `ContinuationToken` indicates to Amazon S3 that the list is being
|
9559
|
-
# continued on this
|
9560
|
-
# obfuscated and is not a real
|
9561
|
-
# `ContinuationToken` for pagination of the list
|
9633
|
+
# continued on buckets in this account with a token.
|
9634
|
+
# `ContinuationToken` is obfuscated and is not a real bucket name. You
|
9635
|
+
# can use this `ContinuationToken` for the pagination of the list
|
9636
|
+
# results.
|
9562
9637
|
# @return [String]
|
9563
9638
|
#
|
9564
9639
|
# @!attribute [rw] max_directory_buckets
|
@@ -9768,12 +9843,26 @@ module Aws::S3
|
|
9768
9843
|
# @return [String]
|
9769
9844
|
#
|
9770
9845
|
# @!attribute [rw] encoding_type
|
9771
|
-
#
|
9772
|
-
#
|
9773
|
-
# Unicode character
|
9774
|
-
# characters, such as characters with an ASCII value
|
9775
|
-
# characters that
|
9776
|
-
# parameter to request that Amazon S3 encode the keys in
|
9846
|
+
# Encoding type used by Amazon S3 to encode the [object keys][1] in
|
9847
|
+
# the response. Responses are encoded only in UTF-8. An object key can
|
9848
|
+
# contain any Unicode character. However, the XML 1.0 parser can't
|
9849
|
+
# parse certain characters, such as characters with an ASCII value
|
9850
|
+
# from 0 to 10. For characters that aren't supported in XML 1.0, you
|
9851
|
+
# can add this parameter to request that Amazon S3 encode the keys in
|
9852
|
+
# the response. For more information about characters to avoid in
|
9853
|
+
# object key names, see [Object key naming guidelines][2].
|
9854
|
+
#
|
9855
|
+
# <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
|
9856
|
+
# in an object's key name will be percent-encoded according to UTF-8
|
9857
|
+
# code values. For example, the object `test_file(3).png` will appear
|
9858
|
+
# as `test_file%283%29.png`.
|
9859
|
+
#
|
9860
|
+
# </note>
|
9861
|
+
#
|
9862
|
+
#
|
9863
|
+
#
|
9864
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
|
9865
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
|
9777
9866
|
# @return [String]
|
9778
9867
|
#
|
9779
9868
|
# @!attribute [rw] key_marker
|
@@ -9998,12 +10087,26 @@ module Aws::S3
|
|
9998
10087
|
# @return [String]
|
9999
10088
|
#
|
10000
10089
|
# @!attribute [rw] encoding_type
|
10001
|
-
#
|
10002
|
-
#
|
10003
|
-
# Unicode character
|
10004
|
-
# characters, such as characters with an ASCII value
|
10005
|
-
# characters that
|
10006
|
-
# parameter to request that Amazon S3 encode the keys in
|
10090
|
+
# Encoding type used by Amazon S3 to encode the [object keys][1] in
|
10091
|
+
# the response. Responses are encoded only in UTF-8. An object key can
|
10092
|
+
# contain any Unicode character. However, the XML 1.0 parser can't
|
10093
|
+
# parse certain characters, such as characters with an ASCII value
|
10094
|
+
# from 0 to 10. For characters that aren't supported in XML 1.0, you
|
10095
|
+
# can add this parameter to request that Amazon S3 encode the keys in
|
10096
|
+
# the response. For more information about characters to avoid in
|
10097
|
+
# object key names, see [Object key naming guidelines][2].
|
10098
|
+
#
|
10099
|
+
# <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
|
10100
|
+
# in an object's key name will be percent-encoded according to UTF-8
|
10101
|
+
# code values. For example, the object `test_file(3).png` will appear
|
10102
|
+
# as `test_file%283%29.png`.
|
10103
|
+
#
|
10104
|
+
# </note>
|
10105
|
+
#
|
10106
|
+
#
|
10107
|
+
#
|
10108
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
|
10109
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
|
10007
10110
|
# @return [String]
|
10008
10111
|
#
|
10009
10112
|
# @!attribute [rw] key_marker
|
@@ -10150,10 +10253,26 @@ module Aws::S3
|
|
10150
10253
|
# @return [Array<Types::CommonPrefix>]
|
10151
10254
|
#
|
10152
10255
|
# @!attribute [rw] encoding_type
|
10153
|
-
# Encoding type used by Amazon S3 to encode object keys in
|
10154
|
-
# response.
|
10155
|
-
#
|
10156
|
-
#
|
10256
|
+
# Encoding type used by Amazon S3 to encode the [object keys][1] in
|
10257
|
+
# the response. Responses are encoded only in UTF-8. An object key can
|
10258
|
+
# contain any Unicode character. However, the XML 1.0 parser can't
|
10259
|
+
# parse certain characters, such as characters with an ASCII value
|
10260
|
+
# from 0 to 10. For characters that aren't supported in XML 1.0, you
|
10261
|
+
# can add this parameter to request that Amazon S3 encode the keys in
|
10262
|
+
# the response. For more information about characters to avoid in
|
10263
|
+
# object key names, see [Object key naming guidelines][2].
|
10264
|
+
#
|
10265
|
+
# <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
|
10266
|
+
# in an object's key name will be percent-encoded according to UTF-8
|
10267
|
+
# code values. For example, the object `test_file(3).png` will appear
|
10268
|
+
# as `test_file%283%29.png`.
|
10269
|
+
#
|
10270
|
+
# </note>
|
10271
|
+
#
|
10272
|
+
#
|
10273
|
+
#
|
10274
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
|
10275
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
|
10157
10276
|
# @return [String]
|
10158
10277
|
#
|
10159
10278
|
# @!attribute [rw] request_charged
|
@@ -10233,12 +10352,26 @@ module Aws::S3
|
|
10233
10352
|
# @return [String]
|
10234
10353
|
#
|
10235
10354
|
# @!attribute [rw] encoding_type
|
10236
|
-
#
|
10237
|
-
#
|
10238
|
-
# Unicode character
|
10239
|
-
# characters, such as characters with an ASCII value
|
10240
|
-
# characters that
|
10241
|
-
# parameter to request that Amazon S3 encode the keys in
|
10355
|
+
# Encoding type used by Amazon S3 to encode the [object keys][1] in
|
10356
|
+
# the response. Responses are encoded only in UTF-8. An object key can
|
10357
|
+
# contain any Unicode character. However, the XML 1.0 parser can't
|
10358
|
+
# parse certain characters, such as characters with an ASCII value
|
10359
|
+
# from 0 to 10. For characters that aren't supported in XML 1.0, you
|
10360
|
+
# can add this parameter to request that Amazon S3 encode the keys in
|
10361
|
+
# the response. For more information about characters to avoid in
|
10362
|
+
# object key names, see [Object key naming guidelines][2].
|
10363
|
+
#
|
10364
|
+
# <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
|
10365
|
+
# in an object's key name will be percent-encoded according to UTF-8
|
10366
|
+
# code values. For example, the object `test_file(3).png` will appear
|
10367
|
+
# as `test_file%283%29.png`.
|
10368
|
+
#
|
10369
|
+
# </note>
|
10370
|
+
#
|
10371
|
+
#
|
10372
|
+
#
|
10373
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
|
10374
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
|
10242
10375
|
# @return [String]
|
10243
10376
|
#
|
10244
10377
|
# @!attribute [rw] marker
|
@@ -10506,10 +10639,26 @@ module Aws::S3
|
|
10506
10639
|
# @return [String]
|
10507
10640
|
#
|
10508
10641
|
# @!attribute [rw] encoding_type
|
10509
|
-
# Encoding type used by Amazon S3 to encode object keys in
|
10510
|
-
# response.
|
10511
|
-
#
|
10512
|
-
#
|
10642
|
+
# Encoding type used by Amazon S3 to encode the [object keys][1] in
|
10643
|
+
# the response. Responses are encoded only in UTF-8. An object key can
|
10644
|
+
# contain any Unicode character. However, the XML 1.0 parser can't
|
10645
|
+
# parse certain characters, such as characters with an ASCII value
|
10646
|
+
# from 0 to 10. For characters that aren't supported in XML 1.0, you
|
10647
|
+
# can add this parameter to request that Amazon S3 encode the keys in
|
10648
|
+
# the response. For more information about characters to avoid in
|
10649
|
+
# object key names, see [Object key naming guidelines][2].
|
10650
|
+
#
|
10651
|
+
# <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
|
10652
|
+
# in an object's key name will be percent-encoded according to UTF-8
|
10653
|
+
# code values. For example, the object `test_file(3).png` will appear
|
10654
|
+
# as `test_file%283%29.png`.
|
10655
|
+
#
|
10656
|
+
# </note>
|
10657
|
+
#
|
10658
|
+
#
|
10659
|
+
#
|
10660
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
|
10661
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
|
10513
10662
|
# @return [String]
|
10514
10663
|
#
|
10515
10664
|
# @!attribute [rw] max_keys
|
@@ -11963,7 +12112,15 @@ module Aws::S3
|
|
11963
12112
|
#
|
11964
12113
|
# @!attribute [rw] partition_date_source
|
11965
12114
|
# Specifies the partition date source for the partitioned prefix.
|
11966
|
-
# PartitionDateSource can be EventTime or DeliveryTime
|
12115
|
+
# `PartitionDateSource` can be `EventTime` or `DeliveryTime`.
|
12116
|
+
#
|
12117
|
+
# For `DeliveryTime`, the time in the log file names corresponds to
|
12118
|
+
# the delivery time for the log files.
|
12119
|
+
#
|
12120
|
+
# For `EventTime`, The logs delivered are for a specific day only. The
|
12121
|
+
# year, month, and day correspond to the day on which the event
|
12122
|
+
# occurred, and the hour, minutes and seconds are set to 00 in the
|
12123
|
+
# key.
|
11967
12124
|
# @return [String]
|
11968
12125
|
#
|
11969
12126
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PartitionedPrefix AWS API Documentation
|
@@ -12076,8 +12233,9 @@ module Aws::S3
|
|
12076
12233
|
# @!attribute [rw] restrict_public_buckets
|
12077
12234
|
# Specifies whether Amazon S3 should restrict public bucket policies
|
12078
12235
|
# for this bucket. Setting this element to `TRUE` restricts access to
|
12079
|
-
# this bucket to only Amazon Web
|
12080
|
-
# users within this account if the bucket has a public
|
12236
|
+
# this bucket to only Amazon Web Servicesservice principals and
|
12237
|
+
# authorized users within this account if the bucket has a public
|
12238
|
+
# policy.
|
12081
12239
|
#
|
12082
12240
|
# Enabling this setting doesn't affect previously stored bucket
|
12083
12241
|
# policies, except that public and cross-account access within any
|
@@ -14034,6 +14192,26 @@ module Aws::S3
|
|
14034
14192
|
# [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
|
14035
14193
|
# @return [Time]
|
14036
14194
|
#
|
14195
|
+
# @!attribute [rw] if_none_match
|
14196
|
+
# Uploads the object only if the object key name does not already
|
14197
|
+
# exist in the bucket specified. Otherwise, Amazon S3 returns a `412
|
14198
|
+
# Precondition Failed` error.
|
14199
|
+
#
|
14200
|
+
# If a conflicting operation occurs during the upload S3 returns a
|
14201
|
+
# `409 ConditionalRequestConflict` response. On a 409 failure you
|
14202
|
+
# should retry the upload.
|
14203
|
+
#
|
14204
|
+
# Expects the '*' (asterisk) character.
|
14205
|
+
#
|
14206
|
+
# For more information about conditional requests, see [RFC 7232][1],
|
14207
|
+
# or [Conditional requests][2] in the *Amazon S3 User Guide*.
|
14208
|
+
#
|
14209
|
+
#
|
14210
|
+
#
|
14211
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
14212
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
|
14213
|
+
# @return [String]
|
14214
|
+
#
|
14037
14215
|
# @!attribute [rw] grant_full_control
|
14038
14216
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
14039
14217
|
# object.
|
@@ -14320,6 +14498,7 @@ module Aws::S3
|
|
14320
14498
|
:checksum_sha1,
|
14321
14499
|
:checksum_sha256,
|
14322
14500
|
:expires,
|
14501
|
+
:if_none_match,
|
14323
14502
|
:grant_full_control,
|
14324
14503
|
:grant_read,
|
14325
14504
|
:grant_read_acp,
|
@@ -14730,7 +14909,15 @@ module Aws::S3
|
|
14730
14909
|
# The container for the records event.
|
14731
14910
|
#
|
14732
14911
|
# @!attribute [rw] payload
|
14733
|
-
# The byte array of partial, one or more result records.
|
14912
|
+
# The byte array of partial, one or more result records. S3 Select
|
14913
|
+
# doesn't guarantee that a record will be self-contained in one
|
14914
|
+
# record frame. To ensure continuous streaming of data, S3 Select
|
14915
|
+
# might split the same record across multiple record frames instead of
|
14916
|
+
# aggregating the results in memory. Some S3 clients (for example, the
|
14917
|
+
# SDK for Java) handle this behavior by creating a `ByteStream` out of
|
14918
|
+
# the response by default. Other clients might not handle this
|
14919
|
+
# behavior by default. In those cases, you must aggregate the results
|
14920
|
+
# on the client side and parse the response.
|
14734
14921
|
# @return [String]
|
14735
14922
|
#
|
14736
14923
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RecordsEvent AWS API Documentation
|
@@ -15274,7 +15461,15 @@ module Aws::S3
|
|
15274
15461
|
# @return [Types::GlacierJobParameters]
|
15275
15462
|
#
|
15276
15463
|
# @!attribute [rw] type
|
15464
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
15465
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
15466
|
+
# usual. [Learn more][1]
|
15467
|
+
#
|
15277
15468
|
# Type of restore request.
|
15469
|
+
#
|
15470
|
+
#
|
15471
|
+
#
|
15472
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15278
15473
|
# @return [String]
|
15279
15474
|
#
|
15280
15475
|
# @!attribute [rw] tier
|
@@ -15286,7 +15481,15 @@ module Aws::S3
|
|
15286
15481
|
# @return [String]
|
15287
15482
|
#
|
15288
15483
|
# @!attribute [rw] select_parameters
|
15484
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
15485
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
15486
|
+
# usual. [Learn more][1]
|
15487
|
+
#
|
15289
15488
|
# Describes the parameters for Select job types.
|
15489
|
+
#
|
15490
|
+
#
|
15491
|
+
#
|
15492
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15290
15493
|
# @return [Types::SelectParameters]
|
15291
15494
|
#
|
15292
15495
|
# @!attribute [rw] output_location
|
@@ -15617,6 +15820,12 @@ module Aws::S3
|
|
15617
15820
|
include Aws::Structure
|
15618
15821
|
end
|
15619
15822
|
|
15823
|
+
# <note markdown="1"> Learn Amazon S3 Select is no longer available to new customers.
|
15824
|
+
# Existing customers of Amazon S3 Select can continue to use the feature
|
15825
|
+
# as usual. [Learn more][1]
|
15826
|
+
#
|
15827
|
+
# </note>
|
15828
|
+
#
|
15620
15829
|
# Request to filter the contents of an Amazon S3 object based on a
|
15621
15830
|
# simple Structured Query Language (SQL) statement. In the request,
|
15622
15831
|
# along with the SQL expression, you must specify a data serialization
|
@@ -15624,11 +15833,12 @@ module Aws::S3
|
|
15624
15833
|
# object data into records. It returns only records that match the
|
15625
15834
|
# specified SQL expression. You must also specify the data serialization
|
15626
15835
|
# format for the response. For more information, see [S3Select API
|
15627
|
-
# Documentation][
|
15836
|
+
# Documentation][2].
|
15628
15837
|
#
|
15629
15838
|
#
|
15630
15839
|
#
|
15631
|
-
# [1]:
|
15840
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15841
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html
|
15632
15842
|
#
|
15633
15843
|
# @!attribute [rw] bucket
|
15634
15844
|
# The S3 bucket.
|
@@ -15740,8 +15950,21 @@ module Aws::S3
|
|
15740
15950
|
include Aws::Structure
|
15741
15951
|
end
|
15742
15952
|
|
15953
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
15954
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
15955
|
+
# usual. [Learn more][1]
|
15956
|
+
#
|
15743
15957
|
# Describes the parameters for Select job types.
|
15744
15958
|
#
|
15959
|
+
# Learn [How to optimize querying your data in Amazon S3][1] using
|
15960
|
+
# [Amazon Athena][2], [S3 Object Lambda][3], or client-side filtering.
|
15961
|
+
#
|
15962
|
+
#
|
15963
|
+
#
|
15964
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15965
|
+
# [2]: https://docs.aws.amazon.com/athena/latest/ug/what-is.html
|
15966
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
|
15967
|
+
#
|
15745
15968
|
# @!attribute [rw] input_serialization
|
15746
15969
|
# Describes the serialization format of the object.
|
15747
15970
|
# @return [Types::InputSerialization]
|
@@ -15751,7 +15974,15 @@ module Aws::S3
|
|
15751
15974
|
# @return [String]
|
15752
15975
|
#
|
15753
15976
|
# @!attribute [rw] expression
|
15977
|
+
# Amazon S3 Select is no longer available to new customers. Existing
|
15978
|
+
# customers of Amazon S3 Select can continue to use the feature as
|
15979
|
+
# usual. [Learn more][1]
|
15980
|
+
#
|
15754
15981
|
# The expression that is used to query the object.
|
15982
|
+
#
|
15983
|
+
#
|
15984
|
+
#
|
15985
|
+
# [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
|
15755
15986
|
# @return [String]
|
15756
15987
|
#
|
15757
15988
|
# @!attribute [rw] output_serialization
|
@@ -15779,6 +16010,14 @@ module Aws::S3
|
|
15779
16010
|
# SSE-KMS. For more information, see [PUT Bucket encryption][1] in the
|
15780
16011
|
# *Amazon S3 API Reference*.
|
15781
16012
|
#
|
16013
|
+
# <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
|
16014
|
+
# fully qualified KMS key ARN. If you use a KMS key alias instead, then
|
16015
|
+
# KMS resolves the key within the requester’s account. This behavior can
|
16016
|
+
# result in data that's encrypted with a KMS key that belongs to the
|
16017
|
+
# requester, and not the bucket owner.
|
16018
|
+
#
|
16019
|
+
# </note>
|
16020
|
+
#
|
15782
16021
|
#
|
15783
16022
|
#
|
15784
16023
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTencryption.html
|
@@ -15847,6 +16086,14 @@ module Aws::S3
|
|
15847
16086
|
|
15848
16087
|
# Specifies the default server-side encryption configuration.
|
15849
16088
|
#
|
16089
|
+
# <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
|
16090
|
+
# fully qualified KMS key ARN. If you use a KMS key alias instead, then
|
16091
|
+
# KMS resolves the key within the requester’s account. This behavior can
|
16092
|
+
# result in data that's encrypted with a KMS key that belongs to the
|
16093
|
+
# requester, and not the bucket owner.
|
16094
|
+
#
|
16095
|
+
# </note>
|
16096
|
+
#
|
15850
16097
|
# @!attribute [rw] apply_server_side_encryption_by_default
|
15851
16098
|
# Specifies the default server-side encryption to apply to new objects
|
15852
16099
|
# in the bucket. If a PUT Object request doesn't specify any
|
data/lib/aws-sdk-s3.rb
CHANGED
data/sig/bucket.rbs
CHANGED
data/sig/client.rbs
CHANGED
@@ -142,6 +142,7 @@ module Aws
|
|
142
142
|
?checksum_sha256: ::String,
|
143
143
|
?request_payer: ("requester"),
|
144
144
|
?expected_bucket_owner: ::String,
|
145
|
+
?if_none_match: ::String,
|
145
146
|
?sse_customer_algorithm: ::String,
|
146
147
|
?sse_customer_key: ::String,
|
147
148
|
?sse_customer_key_md5: ::String
|
@@ -1044,9 +1045,13 @@ module Aws
|
|
1044
1045
|
include ::Seahorse::Client::_ResponseSuccess[Types::ListBucketsOutput]
|
1045
1046
|
def buckets: () -> ::Array[Types::Bucket]
|
1046
1047
|
def owner: () -> Types::Owner
|
1048
|
+
def continuation_token: () -> ::String
|
1047
1049
|
end
|
1048
1050
|
# https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Client.html#list_buckets-instance_method
|
1049
|
-
def list_buckets: (
|
1051
|
+
def list_buckets: (
|
1052
|
+
?max_buckets: ::Integer,
|
1053
|
+
?continuation_token: ::String
|
1054
|
+
) -> _ListBucketsResponseSuccess
|
1050
1055
|
| (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListBucketsResponseSuccess
|
1051
1056
|
|
1052
1057
|
interface _ListDirectoryBucketsResponseSuccess
|
@@ -1882,6 +1887,7 @@ module Aws
|
|
1882
1887
|
?checksum_sha1: ::String,
|
1883
1888
|
?checksum_sha256: ::String,
|
1884
1889
|
?expires: ::Time,
|
1890
|
+
?if_none_match: ::String,
|
1885
1891
|
?grant_full_control: ::String,
|
1886
1892
|
?grant_read: ::String,
|
1887
1893
|
?grant_read_acp: ::String,
|
data/sig/multipart_upload.rbs
CHANGED
data/sig/object.rbs
CHANGED
data/sig/object_summary.rbs
CHANGED
data/sig/resource.rbs
CHANGED
@@ -120,7 +120,8 @@ module Aws
|
|
120
120
|
def bucket: (String name) -> Bucket
|
121
121
|
|
122
122
|
# https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Resource.html#buckets-instance_method
|
123
|
-
def buckets: (
|
123
|
+
def buckets: (
|
124
|
+
) -> Bucket::Collection
|
124
125
|
| (?Hash[Symbol, untyped]) -> Bucket::Collection
|
125
126
|
end
|
126
127
|
end
|
data/sig/types.rbs
CHANGED
@@ -190,6 +190,7 @@ module Aws::S3
|
|
190
190
|
attr_accessor checksum_sha256: ::String
|
191
191
|
attr_accessor request_payer: ("requester")
|
192
192
|
attr_accessor expected_bucket_owner: ::String
|
193
|
+
attr_accessor if_none_match: ::String
|
193
194
|
attr_accessor sse_customer_algorithm: ::String
|
194
195
|
attr_accessor sse_customer_key: ::String
|
195
196
|
attr_accessor sse_customer_key_md5: ::String
|
@@ -1358,6 +1359,13 @@ module Aws::S3
|
|
1358
1359
|
class ListBucketsOutput
|
1359
1360
|
attr_accessor buckets: ::Array[Types::Bucket]
|
1360
1361
|
attr_accessor owner: Types::Owner
|
1362
|
+
attr_accessor continuation_token: ::String
|
1363
|
+
SENSITIVE: []
|
1364
|
+
end
|
1365
|
+
|
1366
|
+
class ListBucketsRequest
|
1367
|
+
attr_accessor max_buckets: ::Integer
|
1368
|
+
attr_accessor continuation_token: ::String
|
1361
1369
|
SENSITIVE: []
|
1362
1370
|
end
|
1363
1371
|
|
@@ -2042,6 +2050,7 @@ module Aws::S3
|
|
2042
2050
|
attr_accessor checksum_sha1: ::String
|
2043
2051
|
attr_accessor checksum_sha256: ::String
|
2044
2052
|
attr_accessor expires: ::Time
|
2053
|
+
attr_accessor if_none_match: ::String
|
2045
2054
|
attr_accessor grant_full_control: ::String
|
2046
2055
|
attr_accessor grant_read: ::String
|
2047
2056
|
attr_accessor grant_read_acp: ::String
|