aws-sdk-s3 1.155.0 → 1.157.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3606dfbffaeffc74941a386fe43f36d526d066641492a25bc9ae8585779f268a
-  data.tar.gz: 9323c9858e64987530d19b91e93df3b87fe396928e97aa98be258fa5e9394c07
+  metadata.gz: 39a77f1b089e257fe94bc26a0ca7309479a61cff7f46326243f2d1b002ce2bac
+  data.tar.gz: e2dbcc9f6ea92e1097d84130a2cd1c3e1caae305bdeb8b450056872edd2b4f74
 SHA512:
-  metadata.gz: 26d9df1ebb04928ca8773d34bad9db95a9ad2a94fc53082901eaf5eef52f79859d29b262ac8572444694838aaf778a29275058cdc4c9fb0d42bccfda47815ff5
-  data.tar.gz: ccd122366faa5eba5dcb5b2f144b900528e595479e2996c444e72f13948ba7ad0f252f3647d482d8d46f857dbd98701d5fca2888e5e4b1ba74857719915a8985
+  metadata.gz: e34240198a44e4e678e0be7ef836318ff899ec61edc29bc2866d432eb6af834a7f81b801ea85ec35e26deec1e59705c1829b22e66093e6591d84dbc966f76e0e
+  data.tar.gz: 362065ca01c2d4a9e33cc9beb43afce43fbcb8c593db5785a32c623bbc99fe63471a41d767a1ae91343b94aba7df0e80360c0310c1f07aa052c76d63d07fda09

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.157.0 (2024-08-01)
+------------------
+
+* Feature - Support `head_bucket`, `get_object_attributes`, `delete_objects`, and `copy_object` for Access Grants.
+
+1.156.0 (2024-07-02)
+------------------
+
+* Feature - Added response overrides to Head Object requests.
+
 1.155.0 (2024-06-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.155.0
+1.157.0

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

@@ -47,6 +47,8 @@ module Aws
         @caching = options.delete(:caching) != false
         @s3_control_clients = {}
         @bucket_region_cache = Aws::S3.bucket_region_cache
+        @head_bucket_mutex = Mutex.new
+        @head_bucket_call = false
         return unless @caching
 
         @credentials_cache = Aws::S3.access_grants_credentials_cache
@@ -195,9 +197,16 @@ module Aws
       end
 
       def new_bucket_region_for(bucket)
-        @s3_client.head_bucket(bucket: bucket).bucket_region
-      rescue Aws::S3::Errors::Http301Error => e
-        e.data.region
+        @head_bucket_mutex.synchronize do
+          begin
+            @head_bucket_call = true
+            @s3_client.head_bucket(bucket: bucket).bucket_region
+          rescue Aws::S3::Errors::Http301Error => e
+            e.data.region
+          ensure
+            @head_bucket_call = false
+          end
+        end
       end
 
       # returns the account id for the configured credentials

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

@@ -1254,8 +1254,8 @@ module Aws::S3
     # @option options [String] :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.
+    #   will be URL encoded. For example, the object `test_file(3).png` will
+    #   appear as `test_file%283%29.png`.
     # @option options [String] :prefix
     #   Limits the response to keys that begin with the specified prefix.
     #

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

@@ -414,6 +414,15 @@ module Aws::S3
     #
     #   @option options [String] :session_token
     #
+    #   @option options [Array] :sigv4a_signing_region_set
+    #     A list of regions that should be signed with SigV4a signing. When
+    #     not passed, a default `:sigv4a_signing_region_set` is searched for
+    #     in the following locations:
+    #
+    #     * `Aws.config[:sigv4a_signing_region_set]`
+    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
+    #     * `~/.aws/config`
+    #
     #   @option options [Boolean] :stub_responses (false)
     #     Causes the client to return stubbed responses. By default
     #     fake responses are generated and returned. You can specify
@@ -1204,8 +1213,7 @@ module Aws::S3
     # : When the request is an HTTP 1.1 request, the response is chunk
     #   encoded. When the request is not an HTTP 1.1 request, the response
     #   would not contain the `Content-Length`. You always need to read the
-    #   entire response body to check if the copy succeeds. to keep the
-    #   connection alive while we copy the data.
+    #   entire response body to check if the copy succeeds.
     #
     #   * If the copy is successful, you receive a response with information
     #     about the copied object.
@@ -2331,33 +2339,33 @@ module Aws::S3
     #   * {Types::CreateBucketOutput#location #location} => String
     #
     #
-    # @example Example: To create a bucket 
+    # @example Example: To create a bucket in a specific region
     #
-    #   # The following example creates a bucket.
+    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket", 
+    #     create_bucket_configuration: {
+    #       location_constraint: "eu-west-1", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "/examplebucket", 
+    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/", 
     #   }
     #
-    # @example Example: To create a bucket in a specific region
+    # @example Example: To create a bucket 
     #
-    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
+    #   # The following example creates a bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket", 
-    #     create_bucket_configuration: {
-    #       location_constraint: "eu-west-1", 
-    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/", 
+    #     location: "/examplebucket", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -4490,15 +4498,6 @@ module Aws::S3
     #   * {Types::DeleteObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To delete an object (from a non-versioned bucket)
-    #
-    #   # The following example deletes an object from a non-versioned bucket.
-    #
-    #   resp = client.delete_object({
-    #     bucket: "ExampleBucket", 
-    #     key: "HappyFace.jpg", 
-    #   })
-    #
     # @example Example: To delete an object
     #
     #   # The following example deletes an object from an S3 bucket.
@@ -4512,6 +4511,15 @@ module Aws::S3
     #   {
     #   }
     #
+    # @example Example: To delete an object (from a non-versioned bucket)
+    #
+    #   # The following example deletes an object from a non-versioned bucket.
+    #
+    #   resp = client.delete_object({
+    #     bucket: "ExampleBucket", 
+    #     key: "HappyFace.jpg", 
+    #   })
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_object({
@@ -4720,7 +4728,7 @@ module Aws::S3
     #       permission.
     #
     #     * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
-    #       specific version of an object from a versiong-enabled bucket,
+    #       specific version of an object from a versioning-enabled bucket,
     #       you must specify the `s3:DeleteObjectVersion` permission.
     #
     #   * **Directory bucket permissions** - To grant access to this API
@@ -4921,22 +4929,20 @@ module Aws::S3
     #   * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
     #
     #
-    # @example Example: To delete multiple object versions from a versioned bucket
+    # @example Example: To delete multiple objects from a versioned bucket
     #
-    #   # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
-    #   # versions and returns the key and versions of deleted objects in the response.
+    #   # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
+    #   # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
     #
     #   resp = client.delete_objects({
     #     bucket: "examplebucket", 
     #     delete: {
     #       objects: [
     #         {
-    #           key: "HappyFace.jpg", 
-    #           version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
+    #           key: "objectkey1", 
     #         }, 
     #         {
-    #           key: "HappyFace.jpg", 
-    #           version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
+    #           key: "objectkey2", 
     #         }, 
     #       ], 
     #       quiet: false, 
@@ -4947,30 +4953,34 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         key: "HappyFace.jpg", 
-    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
+    #         delete_marker: true, 
+    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F", 
+    #         key: "objectkey1", 
     #       }, 
     #       {
-    #         key: "HappyFace.jpg", 
-    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
+    #         delete_marker: true, 
+    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt", 
+    #         key: "objectkey2", 
     #       }, 
     #     ], 
     #   }
     #
-    # @example Example: To delete multiple objects from a versioned bucket
+    # @example Example: To delete multiple object versions from a versioned bucket
     #
-    #   # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
-    #   # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
+    #   # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
+    #   # versions and returns the key and versions of deleted objects in the response.
     #
     #   resp = client.delete_objects({
     #     bucket: "examplebucket", 
     #     delete: {
     #       objects: [
     #         {
-    #           key: "objectkey1", 
+    #           key: "HappyFace.jpg", 
+    #           version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
     #         }, 
     #         {
-    #           key: "objectkey2", 
+    #           key: "HappyFace.jpg", 
+    #           version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
     #         }, 
     #       ], 
     #       quiet: false, 
@@ -4981,14 +4991,12 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         delete_marker: true, 
-    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F", 
-    #         key: "objectkey1", 
+    #         key: "HappyFace.jpg", 
+    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
     #       }, 
     #       {
-    #         delete_marker: true, 
-    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt", 
-    #         key: "objectkey2", 
+    #         key: "HappyFace.jpg", 
+    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
     #       }, 
     #     ], 
     #   }
@@ -8738,49 +8746,49 @@ module Aws::S3
     #   * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
     #
     #
-    # @example Example: To retrieve tag set of an object
+    # @example Example: To retrieve tag set of a specific object version
     #
-    #   # The following example retrieves tag set of an object.
+    #   # The following example retrieves tag set of an object. The request specifies object version.
     #
     #   resp = client.get_object_tagging({
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "exampleobject", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     tag_set: [
     #       {
-    #         key: "Key4", 
-    #         value: "Value4", 
-    #       }, 
-    #       {
-    #         key: "Key3", 
-    #         value: "Value3", 
+    #         key: "Key1", 
+    #         value: "Value1", 
     #       }, 
     #     ], 
-    #     version_id: "null", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   }
     #
-    # @example Example: To retrieve tag set of a specific object version
+    # @example Example: To retrieve tag set of an object
     #
-    #   # The following example retrieves tag set of an object. The request specifies object version.
+    #   # The following example retrieves tag set of an object.
     #
     #   resp = client.get_object_tagging({
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     tag_set: [
     #       {
-    #         key: "Key1", 
-    #         value: "Value1", 
+    #         key: "Key4", 
+    #         value: "Value4", 
+    #       }, 
+    #       {
+    #         key: "Key3", 
+    #         value: "Value3", 
     #       }, 
     #     ], 
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
+    #     version_id: "null", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -9426,6 +9434,24 @@ module Aws::S3
     #   the Range is not satisfiable, S3 returns a `416 - Requested Range Not
     #   Satisfiable` error.
     #
+    # @option params [String] :response_cache_control
+    #   Sets the `Cache-Control` header of the response.
+    #
+    # @option params [String] :response_content_disposition
+    #   Sets the `Content-Disposition` header of the response.
+    #
+    # @option params [String] :response_content_encoding
+    #   Sets the `Content-Encoding` header of the response.
+    #
+    # @option params [String] :response_content_language
+    #   Sets the `Content-Language` header of the response.
+    #
+    # @option params [String] :response_content_type
+    #   Sets the `Content-Type` header of the response.
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :response_expires
+    #   Sets the `Expires` header of the response.
+    #
     # @option params [String] :version_id
     #   Version ID used to reference a specific version of the object.
     #
@@ -9568,6 +9594,12 @@ module Aws::S3
     #     if_unmodified_since: Time.now,
     #     key: "ObjectKey", # required
     #     range: "Range",
+    #     response_cache_control: "ResponseCacheControl",
+    #     response_content_disposition: "ResponseContentDisposition",
+    #     response_content_encoding: "ResponseContentEncoding",
+    #     response_content_language: "ResponseContentLanguage",
+    #     response_content_type: "ResponseContentType",
+    #     response_expires: Time.now,
     #     version_id: "ObjectVersionId",
     #     sse_customer_algorithm: "SSECustomerAlgorithm",
     #     sse_customer_key: "SSECustomerKey",
@@ -11185,8 +11217,8 @@ module Aws::S3
     # @option params [String] :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.
+    #   will be URL encoded. For example, the object `test_file(3).png` will
+    #   appear as `test_file%283%29.png`.
     #
     # @option params [Integer] :max_keys
     #   Sets the maximum number of keys returned in the response. By default,
@@ -15413,40 +15445,41 @@ module Aws::S3
     #   * {Types::PutObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To upload an object and specify server-side encryption and object tags
+    # @example Example: To upload an object
     #
-    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
-    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
+    #   # syntax. S3 returns VersionId of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "filetoupload", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
-    #     server_side_encryption: "AES256", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
+    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
     #   }
     #
-    # @example Example: To create an object.
+    # @example Example: To upload an object and specify server-side encryption and object tags
     #
-    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
+    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
     #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "objectkey", 
+    #     key: "exampleobject", 
+    #     server_side_encryption: "AES256", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
+    #     server_side_encryption: "AES256", 
+    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
     #   }
     #
     # @example Example: To upload an object (specify optional headers)
@@ -15469,43 +15502,43 @@ module Aws::S3
     #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
-    # @example Example: To upload an object and specify optional tags
+    # @example Example: To upload object and specify user-defined metadata
     #
-    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
-    #   # S3 returns version ID of the newly created object.
+    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
+    #   # enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     key: "exampleobject", 
+    #     metadata: {
+    #       "metadata1" => "value1", 
+    #       "metadata2" => "value2", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
-    # @example Example: To upload object and specify user-defined metadata
+    # @example Example: To upload an object and specify optional tags
     #
-    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
-    #   # enabled, S3 returns version ID in response.
+    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
+    #   # S3 returns version ID of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "filetoupload", 
+    #     body: "c:\\HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
-    #     metadata: {
-    #       "metadata1" => "value1", 
-    #       "metadata2" => "value2", 
-    #     }, 
+    #     key: "HappyFace.jpg", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
     #   }
     #
     # @example Example: To upload an object and specify canned ACL.
@@ -15526,21 +15559,20 @@ module Aws::S3
     #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
     #   }
     #
-    # @example Example: To upload an object
+    # @example Example: To create an object.
     #
-    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
-    #   # syntax. S3 returns VersionId of the newly created object.
+    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "objectkey", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
+    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
     #   }
     #
     # @example Streaming a file from disk
@@ -17963,7 +17995,7 @@ module Aws::S3
     #       the object copy to the destination bucket.
     #
     #     For information about permissions required to use the multipart
-    #     upload API, see [Multipart Upload and Permissions][7] in the
+    #     upload API, see [Multipart upload API and permissions][7] in the
     #     *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - You must have permissions in a
@@ -17973,9 +18005,9 @@ module Aws::S3
     #     * If the source object that you want to copy is in a directory
     #       bucket, you must have the <b>
     #       <code>s3express:CreateSession</code> </b> permission in the
-    #       `Action` element of a policy to read the object . By default,
-    #       the session is in the `ReadWrite` mode. If you want to restrict
-    #       the access, you can explicitly set the `s3express:SessionMode`
+    #       `Action` element of a policy to read the object. By default, the
+    #       session is in the `ReadWrite` mode. If you want to restrict the
+    #       access, you can explicitly set the `s3express:SessionMode`
     #       condition key to `ReadOnly` on the copy source bucket.
     #
     #     * If the copy destination is a directory bucket, you must have the
@@ -18042,7 +18074,7 @@ module Aws::S3
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
     # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
     # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
     # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
     # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
@@ -18831,7 +18863,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.155.0'
+      context[:gem_version] = '1.157.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1531,6 +1531,12 @@ module Aws::S3
     HeadObjectRequest.add_member(:if_unmodified_since, Shapes::ShapeRef.new(shape: IfUnmodifiedSince, location: "header", location_name: "If-Unmodified-Since"))
     HeadObjectRequest.add_member(:key, Shapes::ShapeRef.new(shape: ObjectKey, required: true, location: "uri", location_name: "Key", metadata: {"contextParam"=>{"name"=>"Key"}}))
     HeadObjectRequest.add_member(:range, Shapes::ShapeRef.new(shape: Range, location: "header", location_name: "Range"))
+    HeadObjectRequest.add_member(:response_cache_control, Shapes::ShapeRef.new(shape: ResponseCacheControl, location: "querystring", location_name: "response-cache-control"))
+    HeadObjectRequest.add_member(:response_content_disposition, Shapes::ShapeRef.new(shape: ResponseContentDisposition, location: "querystring", location_name: "response-content-disposition"))
+    HeadObjectRequest.add_member(:response_content_encoding, Shapes::ShapeRef.new(shape: ResponseContentEncoding, location: "querystring", location_name: "response-content-encoding"))
+    HeadObjectRequest.add_member(:response_content_language, Shapes::ShapeRef.new(shape: ResponseContentLanguage, location: "querystring", location_name: "response-content-language"))
+    HeadObjectRequest.add_member(:response_content_type, Shapes::ShapeRef.new(shape: ResponseContentType, location: "querystring", location_name: "response-content-type"))
+    HeadObjectRequest.add_member(:response_expires, Shapes::ShapeRef.new(shape: ResponseExpires, location: "querystring", location_name: "response-expires"))
     HeadObjectRequest.add_member(:version_id, Shapes::ShapeRef.new(shape: ObjectVersionId, location: "querystring", location_name: "versionId"))
     HeadObjectRequest.add_member(:sse_customer_algorithm, Shapes::ShapeRef.new(shape: SSECustomerAlgorithm, location: "header", location_name: "x-amz-server-side-encryption-customer-algorithm"))
     HeadObjectRequest.add_member(:sse_customer_key, Shapes::ShapeRef.new(shape: SSECustomerKey, location: "header", location_name: "x-amz-server-side-encryption-customer-key"))
@@ -3830,6 +3836,7 @@ module Aws::S3
         o.http_method = "POST"
         o.http_request_uri = "/WriteGetObjectResponse"
         o['authtype'] = "v4-unsigned-body"
+        o['unsignedPayload'] = true
         o.endpoint_pattern = {
           "hostPrefix" => "{RequestRoute}.",
         }

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

@@ -2779,6 +2779,12 @@ module Aws::S3
     #     if_none_match: "IfNoneMatch",
     #     if_unmodified_since: Time.now,
     #     range: "Range",
+    #     response_cache_control: "ResponseCacheControl",
+    #     response_content_disposition: "ResponseContentDisposition",
+    #     response_content_encoding: "ResponseContentEncoding",
+    #     response_content_language: "ResponseContentLanguage",
+    #     response_content_type: "ResponseContentType",
+    #     response_expires: Time.now,
     #     version_id: "ObjectVersionId",
     #     sse_customer_algorithm: "SSECustomerAlgorithm",
     #     sse_customer_key: "SSECustomerKey",
@@ -2866,6 +2872,18 @@ module Aws::S3
     #   satisfiable, only the `ContentLength` is affected in the response. If
     #   the Range is not satisfiable, S3 returns a `416 - Requested Range Not
     #   Satisfiable` error.
+    # @option options [String] :response_cache_control
+    #   Sets the `Cache-Control` header of the response.
+    # @option options [String] :response_content_disposition
+    #   Sets the `Content-Disposition` header of the response.
+    # @option options [String] :response_content_encoding
+    #   Sets the `Content-Encoding` header of the response.
+    # @option options [String] :response_content_language
+    #   Sets the `Content-Language` header of the response.
+    # @option options [String] :response_content_type
+    #   Sets the `Content-Type` header of the response.
+    # @option options [Time,DateTime,Date,Integer,String] :response_expires
+    #   Sets the `Expires` header of the response.
     # @option options [String] :version_id
     #   Version ID used to reference a specific version of the object.
     #

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

@@ -544,6 +544,12 @@ module Aws::S3
     #     if_none_match: "IfNoneMatch",
     #     if_unmodified_since: Time.now,
     #     range: "Range",
+    #     response_cache_control: "ResponseCacheControl",
+    #     response_content_disposition: "ResponseContentDisposition",
+    #     response_content_encoding: "ResponseContentEncoding",
+    #     response_content_language: "ResponseContentLanguage",
+    #     response_content_type: "ResponseContentType",
+    #     response_expires: Time.now,
     #     sse_customer_algorithm: "SSECustomerAlgorithm",
     #     sse_customer_key: "SSECustomerKey",
     #     sse_customer_key_md5: "SSECustomerKeyMD5",
@@ -630,6 +636,18 @@ module Aws::S3
     #   satisfiable, only the `ContentLength` is affected in the response. If
     #   the Range is not satisfiable, S3 returns a `416 - Requested Range Not
     #   Satisfiable` error.
+    # @option options [String] :response_cache_control
+    #   Sets the `Cache-Control` header of the response.
+    # @option options [String] :response_content_disposition
+    #   Sets the `Content-Disposition` header of the response.
+    # @option options [String] :response_content_encoding
+    #   Sets the `Content-Encoding` header of the response.
+    # @option options [String] :response_content_language
+    #   Sets the `Content-Language` header of the response.
+    # @option options [String] :response_content_type
+    #   Sets the `Content-Type` header of the response.
+    # @option options [Time,DateTime,Date,Integer,String] :response_expires
+    #   Sets the `Expires` header of the response.
     # @option options [String] :sse_customer_algorithm
     #   Specifies the algorithm to use when encrypting the object (for
     #   example, AES256).

data/lib/aws-sdk-s3/plugins/access_grants.rb

@@ -44,25 +44,47 @@ setting, caching, and fallback behavior.
             list_objects_v2: 'READ',
             list_object_versions: 'READ',
             list_parts: 'READ',
+            head_bucket: 'READ',
+            get_object_attributes: 'READ',
             put_object: 'WRITE',
             put_object_acl: 'WRITE',
             delete_object: 'WRITE',
             abort_multipart_upload: 'WRITE',
             create_multipart_upload: 'WRITE',
             upload_part: 'WRITE',
-            complete_multipart_upload: 'WRITE'
+            complete_multipart_upload: 'WRITE',
+            delete_objects: 'WRITE',
+            copy_object: 'READWRITE'
           }.freeze
 
           def call(context)
+            provider = context.config.access_grants_credentials_provider
+
             if access_grants_operation?(context) &&
-               !s3_express_endpoint?(context)
+               !s3_express_endpoint?(context) &&
+               !credentials_head_bucket_call?(provider)
               params = context[:endpoint_params]
               permission = PERMISSION_MAP[context.operation_name]
 
-              provider = context.config.access_grants_credentials_provider
+              key =
+                case context.operation_name
+                when :delete_objects
+                  delete_params = context.params[:delete]
+                  common_prefixes(delete_params[:objects].map { |o| o[:key] })
+                when :copy_object
+                  source_bucket, source_key = params[:copy_source].split('/', 2)
+                  if params[:bucket] != source_bucket
+                    raise ArgumentError,
+                          'source and destination bucket must be the same'
+                  end
+                  common_prefixes([params[:key], source_key])
+                else
+                  params[:key]
+                end
+
               credentials = provider.access_grants_credentials_for(
                 bucket: params[:bucket],
-                key: params[:key],
+                key: key,
                 prefix: params[:prefix],
                 permission: permission
               )
@@ -80,6 +102,12 @@ setting, caching, and fallback behavior.
             Aws::Plugins::UserAgent.metric('S3_ACCESS_GRANTS', &block)
           end
 
+          # HeadBucket is a supported call. When fetching credentials,
+          # this plugin is executed again, and becomes recursive.
+          def credentials_head_bucket_call?(provider)
+            provider.instance_variable_get(:@head_bucket_call)
+          end
+
           def access_grants_operation?(context)
             params = context[:endpoint_params]
             params[:bucket] && PERMISSION_MAP[context.operation_name]
@@ -88,6 +116,42 @@ setting, caching, and fallback behavior.
           def s3_express_endpoint?(context)
             context[:endpoint_properties]['backend'] == 'S3Express'
           end
+
+          # Return the common prefix of the keys, regardless of the delimiter.
+          # For example, given keys ['foo/bar', 'foo/baz'], the common prefix
+          # is 'foo/ba'.
+          def common_prefixes(keys)
+            return '' if keys.empty?
+
+            first_key = keys[0]
+            common_ancestor = first_key
+            last_prefix = ''
+            keys.each do |k|
+              until common_ancestor.empty?
+                break if k.start_with?(common_ancestor)
+
+                last_index = common_ancestor.rindex('/')
+                return '' if last_index.nil?
+
+                last_prefix = common_ancestor[(last_index + 1)..-1]
+                common_ancestor = common_ancestor[0...last_index]
+              end
+            end
+            new_common_ancestor = "#{common_ancestor}/#{last_prefix}"
+            keys.each do |k|
+              until last_prefix.empty?
+                break if k.start_with?(new_common_ancestor)
+
+                last_prefix = last_prefix[0...-1]
+                new_common_ancestor = "#{common_ancestor}/#{last_prefix}"
+              end
+            end
+            if new_common_ancestor == "#{first_key}/"
+              first_key
+            else
+              new_common_ancestor
+            end
+          end
         end
 
         def add_handlers(handlers, config)

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

@@ -3299,7 +3299,7 @@ module Aws::S3
 
     # @!attribute [rw] credentials
     #   The established temporary security credentials for the created
-    #   session..
+    #   session.
     #   @return [Types::SessionCredentials]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateSessionOutput AWS API Documentation
@@ -8452,6 +8452,30 @@ module Aws::S3
     #   Not Satisfiable` error.
     #   @return [String]
     #
+    # @!attribute [rw] response_cache_control
+    #   Sets the `Cache-Control` header of the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] response_content_disposition
+    #   Sets the `Content-Disposition` header of the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] response_content_encoding
+    #   Sets the `Content-Encoding` header of the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] response_content_language
+    #   Sets the `Content-Language` header of the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] response_content_type
+    #   Sets the `Content-Type` header of the response.
+    #   @return [String]
+    #
+    # @!attribute [rw] response_expires
+    #   Sets the `Expires` header of the response.
+    #   @return [Time]
+    #
     # @!attribute [rw] version_id
     #   Version ID used to reference a specific version of the object.
     #
@@ -8543,6 +8567,12 @@ module Aws::S3
       :if_unmodified_since,
       :key,
       :range,
+      :response_cache_control,
+      :response_content_disposition,
+      :response_content_encoding,
+      :response_content_language,
+      :response_content_type,
+      :response_expires,
       :version_id,
       :sse_customer_algorithm,
       :sse_customer_key,
@@ -8559,10 +8589,11 @@ module Aws::S3
     #
     # @!attribute [rw] suffix
     #   A suffix that is appended to a request that is for a directory on
-    #   the website endpoint (for example,if the suffix is index.html and
-    #   you make a request to samplebucket/images/ the data that is returned
-    #   will be for the object with the key name images/index.html) The
-    #   suffix must not be empty and must not include a slash character.
+    #   the website endpoint. (For example, if the suffix is `index.html`
+    #   and you make a request to `samplebucket/images/`, the data that is
+    #   returned will be for the object with the key name
+    #   `images/index.html`.) The suffix must not be empty and must not
+    #   include a slash character.
     #
     #   Replacement must be made for object keys containing special
     #   characters (such as carriage returns) when using XML requests. For
@@ -10122,7 +10153,7 @@ module Aws::S3
     #   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.
+    #   `test_file(3).png` will appear as `test_file%283%29.png`.
     #   @return [String]
     #
     # @!attribute [rw] request_charged
@@ -10478,7 +10509,7 @@ module Aws::S3
     #   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.
+    #   `test_file(3).png` will appear as `test_file%283%29.png`.
     #   @return [String]
     #
     # @!attribute [rw] max_keys
@@ -11173,10 +11204,10 @@ module Aws::S3
     #   @return [Integer]
     #
     # @!attribute [rw] newer_noncurrent_versions
-    #   Specifies how many newer noncurrent versions must exist before
-    #   Amazon S3 can perform the associated action on a given version. If
-    #   there are this many more recent noncurrent versions, Amazon S3 will
-    #   take the associated action. For more information about noncurrent
+    #   Specifies how many noncurrent versions Amazon S3 will retain. You
+    #   can specify up to 100 noncurrent versions to retain. Amazon S3 will
+    #   permanently delete any additional noncurrent versions beyond the
+    #   specified number to retain. For more information about noncurrent
     #   versions, see [Lifecycle configuration elements][1] in the *Amazon
     #   S3 User Guide*.
     #
@@ -11220,12 +11251,12 @@ module Aws::S3
     #   @return [String]
     #
     # @!attribute [rw] newer_noncurrent_versions
-    #   Specifies how many newer noncurrent versions must exist before
-    #   Amazon S3 can perform the associated action on a given version. If
-    #   there are this many more recent noncurrent versions, Amazon S3 will
-    #   take the associated action. For more information about noncurrent
-    #   versions, see [Lifecycle configuration elements][1] in the *Amazon
-    #   S3 User Guide*.
+    #   Specifies how many noncurrent versions Amazon S3 will retain in the
+    #   same storage class before transitioning objects. You can specify up
+    #   to 100 noncurrent versions to retain. Amazon S3 will transition any
+    #   additional noncurrent versions beyond the specified number to
+    #   retain. For more information about noncurrent versions, see
+    #   [Lifecycle configuration elements][1] in the *Amazon S3 User Guide*.
     #
     #
     #

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.155.0'
+  GEM_VERSION = '1.157.0'
 
 end

data/sig/client.rbs

@@ -62,6 +62,7 @@ module Aws
                       ?sdk_ua_app_id: String,
                       ?secret_access_key: String,
                       ?session_token: String,
+                      ?sigv4a_signing_region_set: Array[String],
                       ?stub_responses: untyped,
                       ?token_provider: untyped,
                       ?use_accelerate_endpoint: bool,
@@ -963,6 +964,12 @@ module Aws
                          ?if_unmodified_since: ::Time,
                          key: ::String,
                          ?range: ::String,
+                         ?response_cache_control: ::String,
+                         ?response_content_disposition: ::String,
+                         ?response_content_encoding: ::String,
+                         ?response_content_language: ::String,
+                         ?response_content_type: ::String,
+                         ?response_expires: ::Time,
                          ?version_id: ::String,
                          ?sse_customer_algorithm: ::String,
                          ?sse_customer_key: ::String,
@@ -2328,6 +2335,12 @@ module Aws
                     ?if_unmodified_since: ::Time,
                     key: ::String,
                     ?range: ::String,
+                    ?response_cache_control: ::String,
+                    ?response_content_disposition: ::String,
+                    ?response_content_encoding: ::String,
+                    ?response_content_language: ::String,
+                    ?response_content_type: ::String,
+                    ?response_expires: ::Time,
                     ?version_id: ::String,
                     ?sse_customer_algorithm: ::String,
                     ?sse_customer_key: ::String,
@@ -2346,6 +2359,12 @@ module Aws
                     ?if_unmodified_since: ::Time,
                     key: ::String,
                     ?range: ::String,
+                    ?response_cache_control: ::String,
+                    ?response_content_disposition: ::String,
+                    ?response_content_encoding: ::String,
+                    ?response_content_language: ::String,
+                    ?response_content_type: ::String,
+                    ?response_expires: ::Time,
                     ?version_id: ::String,
                     ?sse_customer_algorithm: ::String,
                     ?sse_customer_key: ::String,

data/sig/object.rbs

@@ -397,6 +397,12 @@ module Aws
                   ?if_none_match: ::String,
                   ?if_unmodified_since: ::Time,
                   ?range: ::String,
+                  ?response_cache_control: ::String,
+                  ?response_content_disposition: ::String,
+                  ?response_content_encoding: ::String,
+                  ?response_content_language: ::String,
+                  ?response_content_type: ::String,
+                  ?response_expires: ::Time,
                   ?version_id: ::String,
                   ?sse_customer_algorithm: ::String,
                   ?sse_customer_key: ::String,

data/sig/object_version.rbs

@@ -102,6 +102,12 @@ module Aws
                   ?if_none_match: ::String,
                   ?if_unmodified_since: ::Time,
                   ?range: ::String,
+                  ?response_cache_control: ::String,
+                  ?response_content_disposition: ::String,
+                  ?response_content_encoding: ::String,
+                  ?response_content_language: ::String,
+                  ?response_content_type: ::String,
+                  ?response_expires: ::Time,
                   ?sse_customer_algorithm: ::String,
                   ?sse_customer_key: ::String,
                   ?sse_customer_key_md5: ::String,

data/sig/resource.rbs

@@ -62,6 +62,7 @@ module Aws
                         ?sdk_ua_app_id: String,
                         ?secret_access_key: String,
                         ?session_token: String,
+                        ?sigv4a_signing_region_set: Array[String],
                         ?stub_responses: untyped,
                         ?token_provider: untyped,
                         ?use_accelerate_endpoint: bool,

data/sig/types.rbs

@@ -1132,6 +1132,12 @@ module Aws::S3
       attr_accessor if_unmodified_since: ::Time
       attr_accessor key: ::String
       attr_accessor range: ::String
+      attr_accessor response_cache_control: ::String
+      attr_accessor response_content_disposition: ::String
+      attr_accessor response_content_encoding: ::String
+      attr_accessor response_content_language: ::String
+      attr_accessor response_content_type: ::String
+      attr_accessor response_expires: ::Time
       attr_accessor version_id: ::String
       attr_accessor sse_customer_algorithm: ::String
       attr_accessor sse_customer_key: ::String

data/sig/waiters.rbs

@@ -43,6 +43,12 @@ module Aws
                     ?if_unmodified_since: ::Time,
                     key: ::String,
                     ?range: ::String,
+                    ?response_cache_control: ::String,
+                    ?response_content_disposition: ::String,
+                    ?response_content_encoding: ::String,
+                    ?response_content_language: ::String,
+                    ?response_content_type: ::String,
+                    ?response_expires: ::Time,
                     ?version_id: ::String,
                     ?sse_customer_algorithm: ::String,
                     ?sse_customer_key: ::String,
@@ -67,6 +73,12 @@ module Aws
                     ?if_unmodified_since: ::Time,
                     key: ::String,
                     ?range: ::String,
+                    ?response_cache_control: ::String,
+                    ?response_content_disposition: ::String,
+                    ?response_content_encoding: ::String,
+                    ?response_content_language: ::String,
+                    ?response_content_type: ::String,
+                    ?response_expires: ::Time,
                     ?version_id: ::String,
                     ?sse_customer_algorithm: ::String,
                     ?sse_customer_key: ::String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3
 version: !ruby/object:Gem::Version
-  version: 1.155.0
+  version: 1.157.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-28 00:00:00.000000000 Z
+date: 2024-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-kms
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.8'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
   requirement: !ruby/object:Gem::Requirement
@@ -47,7 +47,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,7 +57,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.199.0
+        version: 3.201.0
 description: Official AWS Ruby gem for Amazon Simple Storage Service (Amazon S3).
   This gem is part of the AWS SDK for Ruby.
 email: