aws-sdk-s3 1.157.0 → 1.158.0

data/lib/aws-sdk-s3/client_api.rb

@@ -334,6 +334,7 @@ module Aws::S3
     ListBucketMetricsConfigurationsOutput = Shapes::StructureShape.new(name: 'ListBucketMetricsConfigurationsOutput')
     ListBucketMetricsConfigurationsRequest = Shapes::StructureShape.new(name: 'ListBucketMetricsConfigurationsRequest')
     ListBucketsOutput = Shapes::StructureShape.new(name: 'ListBucketsOutput')
+    ListBucketsRequest = Shapes::StructureShape.new(name: 'ListBucketsRequest')
     ListDirectoryBucketsOutput = Shapes::StructureShape.new(name: 'ListDirectoryBucketsOutput')
     ListDirectoryBucketsRequest = Shapes::StructureShape.new(name: 'ListDirectoryBucketsRequest')
     ListMultipartUploadsOutput = Shapes::StructureShape.new(name: 'ListMultipartUploadsOutput')
@@ -357,6 +358,7 @@ module Aws::S3
     MFADeleteStatus = Shapes::StringShape.new(name: 'MFADeleteStatus')
     Marker = Shapes::StringShape.new(name: 'Marker')
     MaxAgeSeconds = Shapes::IntegerShape.new(name: 'MaxAgeSeconds')
+    MaxBuckets = Shapes::IntegerShape.new(name: 'MaxBuckets')
     MaxDirectoryBuckets = Shapes::IntegerShape.new(name: 'MaxDirectoryBuckets')
     MaxKeys = Shapes::IntegerShape.new(name: 'MaxKeys')
     MaxParts = Shapes::IntegerShape.new(name: 'MaxParts')
@@ -1707,8 +1709,13 @@ module Aws::S3
 
     ListBucketsOutput.add_member(:buckets, Shapes::ShapeRef.new(shape: Buckets, location_name: "Buckets"))
     ListBucketsOutput.add_member(:owner, Shapes::ShapeRef.new(shape: Owner, location_name: "Owner"))
+    ListBucketsOutput.add_member(:continuation_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "ContinuationToken"))
     ListBucketsOutput.struct_class = Types::ListBucketsOutput
 
+    ListBucketsRequest.add_member(:max_buckets, Shapes::ShapeRef.new(shape: MaxBuckets, location: "querystring", location_name: "max-buckets"))
+    ListBucketsRequest.add_member(:continuation_token, Shapes::ShapeRef.new(shape: Token, location: "querystring", location_name: "continuation-token"))
+    ListBucketsRequest.struct_class = Types::ListBucketsRequest
+
     ListDirectoryBucketsOutput.add_member(:buckets, Shapes::ShapeRef.new(shape: Buckets, location_name: "Buckets"))
     ListDirectoryBucketsOutput.add_member(:continuation_token, Shapes::ShapeRef.new(shape: DirectoryBucketToken, location_name: "ContinuationToken"))
     ListDirectoryBucketsOutput.struct_class = Types::ListDirectoryBucketsOutput
@@ -3291,8 +3298,14 @@ module Aws::S3
         o.name = "ListBuckets"
         o.http_method = "GET"
         o.http_request_uri = "/"
-        o.input = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.input = Shapes::ShapeRef.new(shape: ListBucketsRequest)
         o.output = Shapes::ShapeRef.new(shape: ListBucketsOutput)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_buckets",
+          tokens: {
+            "continuation_token" => "continuation_token"
+          }
+        )
       end)
 
       api.add_operation(:list_directory_buckets, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-s3/resource.rb

@@ -193,18 +193,20 @@ module Aws::S3
     # @return [Bucket::Collection]
     def buckets(options = {})
       batches = Enumerator.new do |y|
-        batch = []
         resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
           @client.list_buckets(options)
         end
-        resp.data.buckets.each do |b|
-          batch << Bucket.new(
-            name: b.name,
-            data: b,
-            client: @client
-          )
+        resp.each_page do |page|
+          batch = []
+          page.data.buckets.each do |b|
+            batch << Bucket.new(
+              name: b.name,
+              data: b,
+              client: @client
+            )
+          end
+          y.yield(batch)
         end
-        y.yield(batch)
       end
       Bucket::Collection.new(batches)
     end

data/lib/aws-sdk-s3/types.rb

@@ -3333,8 +3333,9 @@ module Aws::S3
       include Aws::Structure
     end
 
-    # The container element for specifying the default Object Lock retention
-    # settings for new objects placed in the specified bucket.
+    # The container element for optionally specifying the default Object
+    # Lock retention settings for new objects placed in the specified
+    # bucket.
     #
     # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
     #
@@ -4390,6 +4391,14 @@ module Aws::S3
     # Specifies encryption-related information for an Amazon S3 bucket that
     # is a destination for replicated objects.
     #
+    # <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
+    # fully qualified KMS key ARN. If you use a KMS key alias instead, then
+    # KMS resolves the key within the requester’s account. This behavior can
+    # result in data that's encrypted with a KMS key that belongs to the
+    # requester, and not the bucket owner.
+    #
+    #  </note>
+    #
     # @!attribute [rw] replica_kms_key_id
     #   Specifies the ID (Key ARN or Alias ARN) of the customer managed
     #   Amazon Web Services KMS key stored in Amazon Web Services Key
@@ -7802,17 +7811,13 @@ module Aws::S3
     #
     # @!attribute [rw] bucket_region
     #   The Region that the bucket is located.
-    #
-    #   <note markdown="1"> This functionality is not supported for directory buckets.
-    #
-    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] access_point_alias
     #   Indicates whether the bucket name used in the request is an access
     #   point alias.
     #
-    #   <note markdown="1"> This functionality is not supported for directory buckets.
+    #   <note markdown="1"> For directory buckets, the value of this field is `false`.
     #
     #    </note>
     #   @return [Boolean]
@@ -9526,11 +9531,45 @@ module Aws::S3
     #   The owner of the buckets listed.
     #   @return [Types::Owner]
     #
+    # @!attribute [rw] continuation_token
+    #   `ContinuationToken` is included in the response when there are more
+    #   buckets that can be listed with pagination. The next `ListBuckets`
+    #   request to Amazon S3 can be continued with this `ContinuationToken`.
+    #   `ContinuationToken` is obfuscated and is not a real bucket.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsOutput AWS API Documentation
     #
     class ListBucketsOutput < Struct.new(
       :buckets,
-      :owner)
+      :owner,
+      :continuation_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] max_buckets
+    #   Maximum number of buckets to be returned in response. When the
+    #   number is more than the count of buckets that are owned by an Amazon
+    #   Web Services account, return all the buckets in response.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] continuation_token
+    #   `ContinuationToken` indicates to Amazon S3 that the list is being
+    #   continued on this bucket with a token. `ContinuationToken` is
+    #   obfuscated and is not a real key. You can use this
+    #   `ContinuationToken` for pagination of the list results.
+    #
+    #   Length Constraints: Minimum length of 0. Maximum length of 1024.
+    #
+    #   Required: No.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsRequest AWS API Documentation
+    #
+    class ListBucketsRequest < Struct.new(
+      :max_buckets,
+      :continuation_token)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9556,9 +9595,10 @@ module Aws::S3
 
     # @!attribute [rw] continuation_token
     #   `ContinuationToken` indicates to Amazon S3 that the list is being
-    #   continued on this bucket with a token. `ContinuationToken` is
-    #   obfuscated and is not a real key. You can use this
-    #   `ContinuationToken` for pagination of the list results.
+    #   continued on buckets in this account with a token.
+    #   `ContinuationToken` is obfuscated and is not a real bucket name. You
+    #   can use this `ContinuationToken` for the pagination of the list
+    #   results.
     #   @return [String]
     #
     # @!attribute [rw] max_directory_buckets
@@ -9768,12 +9808,26 @@ module Aws::S3
     #   @return [String]
     #
     # @!attribute [rw] encoding_type
-    #   Requests Amazon S3 to encode the object keys in the response and
-    #   specifies the encoding method to use. An object key can contain any
-    #   Unicode character; however, the XML 1.0 parser cannot parse some
-    #   characters, such as characters with an ASCII value from 0 to 10. For
-    #   characters that are not supported in XML 1.0, you can add this
-    #   parameter to request that Amazon S3 encode the keys in the response.
+    #   Encoding type used by Amazon S3 to encode the [object keys][1] in
+    #   the response. Responses are encoded only in UTF-8. An object key can
+    #   contain any Unicode character. However, the XML 1.0 parser can't
+    #   parse certain characters, such as characters with an ASCII value
+    #   from 0 to 10. For characters that aren't supported in XML 1.0, you
+    #   can add this parameter to request that Amazon S3 encode the keys in
+    #   the response. For more information about characters to avoid in
+    #   object key names, see [Object key naming guidelines][2].
+    #
+    #   <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
+    #   in an object's key name will be percent-encoded according to UTF-8
+    #   code values. For example, the object `test_file(3).png` will appear
+    #   as `test_file%283%29.png`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
     #   @return [String]
     #
     # @!attribute [rw] key_marker
@@ -9998,12 +10052,26 @@ module Aws::S3
     #   @return [String]
     #
     # @!attribute [rw] encoding_type
-    #   Requests Amazon S3 to encode the object keys in the response and
-    #   specifies the encoding method to use. An object key can contain any
-    #   Unicode character; however, the XML 1.0 parser cannot parse some
-    #   characters, such as characters with an ASCII value from 0 to 10. For
-    #   characters that are not supported in XML 1.0, you can add this
-    #   parameter to request that Amazon S3 encode the keys in the response.
+    #   Encoding type used by Amazon S3 to encode the [object keys][1] in
+    #   the response. Responses are encoded only in UTF-8. An object key can
+    #   contain any Unicode character. However, the XML 1.0 parser can't
+    #   parse certain characters, such as characters with an ASCII value
+    #   from 0 to 10. For characters that aren't supported in XML 1.0, you
+    #   can add this parameter to request that Amazon S3 encode the keys in
+    #   the response. For more information about characters to avoid in
+    #   object key names, see [Object key naming guidelines][2].
+    #
+    #   <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
+    #   in an object's key name will be percent-encoded according to UTF-8
+    #   code values. For example, the object `test_file(3).png` will appear
+    #   as `test_file%283%29.png`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
     #   @return [String]
     #
     # @!attribute [rw] key_marker
@@ -10150,10 +10218,26 @@ module Aws::S3
     #   @return [Array<Types::CommonPrefix>]
     #
     # @!attribute [rw] encoding_type
-    #   Encoding type used by Amazon S3 to encode object keys in the
-    #   response. If using `url`, non-ASCII characters used in an object's
-    #   key name will be URL encoded. For example, the object
-    #   `test_file(3).png` will appear as `test_file%283%29.png`.
+    #   Encoding type used by Amazon S3 to encode the [object keys][1] in
+    #   the response. Responses are encoded only in UTF-8. An object key can
+    #   contain any Unicode character. However, the XML 1.0 parser can't
+    #   parse certain characters, such as characters with an ASCII value
+    #   from 0 to 10. For characters that aren't supported in XML 1.0, you
+    #   can add this parameter to request that Amazon S3 encode the keys in
+    #   the response. For more information about characters to avoid in
+    #   object key names, see [Object key naming guidelines][2].
+    #
+    #   <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
+    #   in an object's key name will be percent-encoded according to UTF-8
+    #   code values. For example, the object `test_file(3).png` will appear
+    #   as `test_file%283%29.png`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
     #   @return [String]
     #
     # @!attribute [rw] request_charged
@@ -10233,12 +10317,26 @@ module Aws::S3
     #   @return [String]
     #
     # @!attribute [rw] encoding_type
-    #   Requests Amazon S3 to encode the object keys in the response and
-    #   specifies the encoding method to use. An object key can contain any
-    #   Unicode character; however, the XML 1.0 parser cannot parse some
-    #   characters, such as characters with an ASCII value from 0 to 10. For
-    #   characters that are not supported in XML 1.0, you can add this
-    #   parameter to request that Amazon S3 encode the keys in the response.
+    #   Encoding type used by Amazon S3 to encode the [object keys][1] in
+    #   the response. Responses are encoded only in UTF-8. An object key can
+    #   contain any Unicode character. However, the XML 1.0 parser can't
+    #   parse certain characters, such as characters with an ASCII value
+    #   from 0 to 10. For characters that aren't supported in XML 1.0, you
+    #   can add this parameter to request that Amazon S3 encode the keys in
+    #   the response. For more information about characters to avoid in
+    #   object key names, see [Object key naming guidelines][2].
+    #
+    #   <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
+    #   in an object's key name will be percent-encoded according to UTF-8
+    #   code values. For example, the object `test_file(3).png` will appear
+    #   as `test_file%283%29.png`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
     #   @return [String]
     #
     # @!attribute [rw] marker
@@ -10506,10 +10604,26 @@ module Aws::S3
     #   @return [String]
     #
     # @!attribute [rw] encoding_type
-    #   Encoding type used by Amazon S3 to encode object keys in the
-    #   response. If using `url`, non-ASCII characters used in an object's
-    #   key name will be URL encoded. For example, the object
-    #   `test_file(3).png` will appear as `test_file%283%29.png`.
+    #   Encoding type used by Amazon S3 to encode the [object keys][1] in
+    #   the response. Responses are encoded only in UTF-8. An object key can
+    #   contain any Unicode character. However, the XML 1.0 parser can't
+    #   parse certain characters, such as characters with an ASCII value
+    #   from 0 to 10. For characters that aren't supported in XML 1.0, you
+    #   can add this parameter to request that Amazon S3 encode the keys in
+    #   the response. For more information about characters to avoid in
+    #   object key names, see [Object key naming guidelines][2].
+    #
+    #   <note markdown="1"> When using the URL encoding type, non-ASCII characters that are used
+    #   in an object's key name will be percent-encoded according to UTF-8
+    #   code values. For example, the object `test_file(3).png` will appear
+    #   as `test_file%283%29.png`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-guidelines
     #   @return [String]
     #
     # @!attribute [rw] max_keys
@@ -11963,7 +12077,15 @@ module Aws::S3
     #
     # @!attribute [rw] partition_date_source
     #   Specifies the partition date source for the partitioned prefix.
-    #   PartitionDateSource can be EventTime or DeliveryTime.
+    #   `PartitionDateSource` can be `EventTime` or `DeliveryTime`.
+    #
+    #   For `DeliveryTime`, the time in the log file names corresponds to
+    #   the delivery time for the log files.
+    #
+    #   For `EventTime`, The logs delivered are for a specific day only. The
+    #   year, month, and day correspond to the day on which the event
+    #   occurred, and the hour, minutes and seconds are set to 00 in the
+    #   key.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PartitionedPrefix AWS API Documentation
@@ -12076,8 +12198,9 @@ module Aws::S3
     # @!attribute [rw] restrict_public_buckets
     #   Specifies whether Amazon S3 should restrict public bucket policies
     #   for this bucket. Setting this element to `TRUE` restricts access to
-    #   this bucket to only Amazon Web Service principals and authorized
-    #   users within this account if the bucket has a public policy.
+    #   this bucket to only Amazon Web Servicesservice principals and
+    #   authorized users within this account if the bucket has a public
+    #   policy.
     #
     #   Enabling this setting doesn't affect previously stored bucket
     #   policies, except that public and cross-account access within any
@@ -14730,7 +14853,15 @@ module Aws::S3
     # The container for the records event.
     #
     # @!attribute [rw] payload
-    #   The byte array of partial, one or more result records.
+    #   The byte array of partial, one or more result records. S3 Select
+    #   doesn't guarantee that a record will be self-contained in one
+    #   record frame. To ensure continuous streaming of data, S3 Select
+    #   might split the same record across multiple record frames instead of
+    #   aggregating the results in memory. Some S3 clients (for example, the
+    #   SDK for Java) handle this behavior by creating a `ByteStream` out of
+    #   the response by default. Other clients might not handle this
+    #   behavior by default. In those cases, you must aggregate the results
+    #   on the client side and parse the response.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RecordsEvent AWS API Documentation
@@ -15779,6 +15910,14 @@ module Aws::S3
     # SSE-KMS. For more information, see [PUT Bucket encryption][1] in the
     # *Amazon S3 API Reference*.
     #
+    # <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
+    # fully qualified KMS key ARN. If you use a KMS key alias instead, then
+    # KMS resolves the key within the requester’s account. This behavior can
+    # result in data that's encrypted with a KMS key that belongs to the
+    # requester, and not the bucket owner.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTencryption.html
@@ -15847,6 +15986,14 @@ module Aws::S3
 
     # Specifies the default server-side encryption configuration.
     #
+    # <note markdown="1"> If you're specifying a customer managed KMS key, we recommend using a
+    # fully qualified KMS key ARN. If you use a KMS key alias instead, then
+    # KMS resolves the key within the requester’s account. This behavior can
+    # result in data that's encrypted with a KMS key that belongs to the
+    # requester, and not the bucket owner.
+    #
+    #  </note>
+    #
     # @!attribute [rw] apply_server_side_encryption_by_default
     #   Specifies the default server-side encryption to apply to new objects
     #   in the bucket. If a PUT Object request doesn't specify any

data/lib/aws-sdk-s3.rb

@@ -73,6 +73,6 @@ require_relative 'aws-sdk-s3/event_streams'
 # @!group service
 module Aws::S3
 
-  GEM_VERSION = '1.157.0'
+  GEM_VERSION = '1.158.0'
 
 end

data/sig/client.rbs

@@ -1044,9 +1044,13 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::ListBucketsOutput]
         def buckets: () -> ::Array[Types::Bucket]
         def owner: () -> Types::Owner
+        def continuation_token: () -> ::String
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Client.html#list_buckets-instance_method
-      def list_buckets: () -> _ListBucketsResponseSuccess
+      def list_buckets: (
+                          ?max_buckets: ::Integer,
+                          ?continuation_token: ::String
+                        ) -> _ListBucketsResponseSuccess
                       | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListBucketsResponseSuccess
 
       interface _ListDirectoryBucketsResponseSuccess

data/sig/resource.rbs

@@ -120,7 +120,8 @@ module Aws
       def bucket: (String name) -> Bucket
 
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/S3/Resource.html#buckets-instance_method
-      def buckets: () -> Bucket::Collection
+      def buckets: (
+                   ) -> Bucket::Collection
                  | (?Hash[Symbol, untyped]) -> Bucket::Collection
     end
   end

data/sig/types.rbs

@@ -1358,6 +1358,13 @@ module Aws::S3
     class ListBucketsOutput
       attr_accessor buckets: ::Array[Types::Bucket]
       attr_accessor owner: Types::Owner
+      attr_accessor continuation_token: ::String
+      SENSITIVE: []
+    end
+
+    class ListBucketsRequest
+      attr_accessor max_buckets: ::Integer
+      attr_accessor continuation_token: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3
 version: !ruby/object:Gem::Version
-  version: 1.157.0
+  version: 1.158.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-08-01 00:00:00.000000000 Z
+date: 2024-08-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-kms