aws-sdk-s3 1.157.0 → 1.162.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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.162.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
@@ -64,6 +64,7 @@ module Aws
64
64
  ?session_token: String,
65
65
  ?sigv4a_signing_region_set: Array[String],
66
66
  ?stub_responses: untyped,
67
+ ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
67
68
  ?token_provider: untyped,
68
69
  ?use_accelerate_endpoint: bool,
69
70
  ?use_dualstack_endpoint: bool,
@@ -142,6 +143,7 @@ module Aws
142
143
  ?checksum_sha256: ::String,
143
144
  ?request_payer: ("requester"),
144
145
  ?expected_bucket_owner: ::String,
146
+ ?if_none_match: ::String,
145
147
  ?sse_customer_algorithm: ::String,
146
148
  ?sse_customer_key: ::String,
147
149
  ?sse_customer_key_md5: ::String
@@ -1044,9 +1046,13 @@ module Aws
1044
1046
  include ::Seahorse::Client::_ResponseSuccess[Types::ListBucketsOutput]
1045
1047
  def buckets: () -> ::Array[Types::Bucket]
1046
1048
  def owner: () -> Types::Owner
1049
+ def continuation_token: () -> ::String
1047
1050
  end
1048
1051
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Client.html#list_buckets-instance_method
1049
- def list_buckets: () -> _ListBucketsResponseSuccess
1052
+ def list_buckets: (
1053
+ ?max_buckets: ::Integer,
1054
+ ?continuation_token: ::String
1055
+ ) -> _ListBucketsResponseSuccess
1050
1056
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListBucketsResponseSuccess
1051
1057
 
1052
1058
  interface _ListDirectoryBucketsResponseSuccess
@@ -1882,6 +1888,7 @@ module Aws
1882
1888
  ?checksum_sha1: ::String,
1883
1889
  ?checksum_sha256: ::String,
1884
1890
  ?expires: ::Time,
1891
+ ?if_none_match: ::String,
1885
1892
  ?grant_full_control: ::String,
1886
1893
  ?grant_read: ::String,
1887
1894
  ?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
@@ -64,6 +64,7 @@ module Aws
64
64
  ?session_token: String,
65
65
  ?sigv4a_signing_region_set: Array[String],
66
66
  ?stub_responses: untyped,
67
+ ?telemetry_provider: Aws::Telemetry::TelemetryProviderBase,
67
68
  ?token_provider: untyped,
68
69
  ?use_accelerate_endpoint: bool,
69
70
  ?use_dualstack_endpoint: bool,
@@ -120,7 +121,8 @@ module Aws
120
121
  def bucket: (String name) -> Bucket
121
122
 
122
123
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Resource.html#buckets-instance_method
123
- def buckets: () -> Bucket::Collection
124
+ def buckets: (
125
+ ) -> Bucket::Collection
124
126
  | (?Hash[Symbol, untyped]) -> Bucket::Collection
125
127
  end
126
128
  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