aws-sdk-s3 1.157.0 → 1.159.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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 Lock retention
3337
- # settings for new objects placed in the specified bucket.
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"> This functionality is not supported for directory buckets.
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 `ChecksumMode` and the object is
8555
- # encrypted with Amazon Web Services Key Management Service (Amazon
8556
- # Web Services KMS), you must have permission to use the `kms:Decrypt`
8557
- # action for the request to succeed.
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 bucket with a token. `ContinuationToken` is
9560
- # obfuscated and is not a real key. You can use this
9561
- # `ContinuationToken` for pagination of the list results.
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
- # Requests Amazon S3 to encode the object keys in the response and
9772
- # specifies the encoding method to use. An object key can contain any
9773
- # Unicode character; however, the XML 1.0 parser cannot parse some
9774
- # characters, such as characters with an ASCII value from 0 to 10. For
9775
- # characters that are not supported in XML 1.0, you can add this
9776
- # parameter to request that Amazon S3 encode the keys in the response.
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
- # Requests Amazon S3 to encode the object keys in the response and
10002
- # specifies the encoding method to use. An object key can contain any
10003
- # Unicode character; however, the XML 1.0 parser cannot parse some
10004
- # characters, such as characters with an ASCII value from 0 to 10. For
10005
- # characters that are not supported in XML 1.0, you can add this
10006
- # parameter to request that Amazon S3 encode the keys in the response.
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 the
10154
- # response. If using `url`, non-ASCII characters used in an object's
10155
- # key name will be URL encoded. For example, the object
10156
- # `test_file(3).png` will appear as `test_file%283%29.png`.
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
- # Requests Amazon S3 to encode the object keys in the response and
10237
- # specifies the encoding method to use. An object key can contain any
10238
- # Unicode character; however, the XML 1.0 parser cannot parse some
10239
- # characters, such as characters with an ASCII value from 0 to 10. For
10240
- # characters that are not supported in XML 1.0, you can add this
10241
- # parameter to request that Amazon S3 encode the keys in the response.
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 the
10510
- # response. If using `url`, non-ASCII characters used in an object's
10511
- # key name will be URL encoded. For example, the object
10512
- # `test_file(3).png` will appear as `test_file%283%29.png`.
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 Service principals and authorized
12080
- # users within this account if the bucket has a public policy.
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][1].
15836
+ # Documentation][2].
15628
15837
  #
15629
15838
  #
15630
15839
  #
15631
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html
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
@@ -73,6 +73,6 @@ require_relative 'aws-sdk-s3/event_streams'
73
73
  # @!group service
74
74
  module Aws::S3
75
75
 
76
- GEM_VERSION = '1.157.0'
76
+ GEM_VERSION = '1.159.0'
77
77
 
78
78
  end
data/sig/bucket.rbs CHANGED
@@ -107,6 +107,7 @@ module Aws
107
107
  ?checksum_sha1: ::String,
108
108
  ?checksum_sha256: ::String,
109
109
  ?expires: ::Time,
110
+ ?if_none_match: ::String,
110
111
  ?grant_full_control: ::String,
111
112
  ?grant_read: ::String,
112
113
  ?grant_read_acp: ::String,
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: () -> _ListBucketsResponseSuccess
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,
@@ -81,6 +81,7 @@ module Aws
81
81
  ?checksum_sha256: ::String,
82
82
  ?request_payer: ("requester"),
83
83
  ?expected_bucket_owner: ::String,
84
+ ?if_none_match: ::String,
84
85
  ?sse_customer_algorithm: ::String,
85
86
  ?sse_customer_key: ::String,
86
87
  ?sse_customer_key_md5: ::String
data/sig/object.rbs CHANGED
@@ -277,6 +277,7 @@ module Aws
277
277
  ?checksum_sha1: ::String,
278
278
  ?checksum_sha256: ::String,
279
279
  ?expires: ::Time,
280
+ ?if_none_match: ::String,
280
281
  ?grant_full_control: ::String,
281
282
  ?grant_read: ::String,
282
283
  ?grant_read_acp: ::String,
@@ -190,6 +190,7 @@ module Aws
190
190
  ?checksum_sha1: ::String,
191
191
  ?checksum_sha256: ::String,
192
192
  ?expires: ::Time,
193
+ ?if_none_match: ::String,
193
194
  ?grant_full_control: ::String,
194
195
  ?grant_read: ::String,
195
196
  ?grant_read_acp: ::String,
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: () -> Bucket::Collection
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