aws-sdk-s3 1.157.0 → 1.159.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- 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/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
         |