aws-sdk-s3 1.23.1 → 1.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3f8a30dfebf04be8862002eaee088ef026e5e9ae
-  data.tar.gz: 4a287e9a67f86f21a173180e8a21a9775e3c3d4a
+  metadata.gz: 97d1938cf5a4faa464529ea716f880937fa01890
+  data.tar.gz: 654d7b363813e905c20c4e3cf6c44d85cf6666e2
 SHA512:
-  metadata.gz: 05e578505d81fda9ebec96cd1be439c945df7bfbc6f2348f5e8d58c6e57c2fac946e3b35eacdeaf95c1962467e1bb769c3371acc821a971fa6124108551981f9
-  data.tar.gz: e5a3baec6bf4714a75af90a3e68e0d9c058fb9d69e46ea1ce86d7a95b2a0ef20a55e6226051228a1f83c2c643acbd865e760ef242830fefe942962bf524fbee5
+  metadata.gz: d6ea396990b609d2b334d75aa42e894eac9657b01f4d8a0f880b71858674aebf981470ec4ad018378df38acfb51f1ebd26fc93df79d1ede4fcaec9b2d6e1b6f0
+  data.tar.gz: a6e5e9f10c3879b499815419352bfd1d5f21867b8a09bf8994dd88d388692a1c2036292aaab22b8e08b0229e7be5bbb6381f9de1d314ff93168bc1f1f7dcf962

data/lib/aws-sdk-s3.rb

@@ -63,6 +63,6 @@ require_relative 'aws-sdk-s3/event_streams'
 # @service
 module Aws::S3
 
-  GEM_VERSION = '1.23.1'
+  GEM_VERSION = '1.24.0'
 
 end

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

@@ -395,7 +395,7 @@ module Aws::S3
     #   http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
     # @option options [String] :tagging
     #   The tag-set for the object. The tag-set must be encoded as URL Query
-    #   parameters
+    #   parameters. (For example, "Key1=Value1")
     # @return [Object]
     def put_object(options = {})
       options = options.merge(bucket: @name)

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

@@ -236,8 +236,9 @@ module Aws::S3
     #   })
     # @param [Hash] options ({})
     # @option options [required, Types::NotificationConfiguration] :notification_configuration
-    #   Container for specifying the notification configuration of the bucket.
-    #   If this element is empty, notifications are turned off on the bucket.
+    #   A container for specifying the notification configuration of the
+    #   bucket. If this element is empty, notifications are turned off for the
+    #   bucket.
     # @return [EmptyStructure]
     def put(options = {})
       options = options.merge(bucket: @bucket_name)

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

@@ -15,6 +15,7 @@ require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
 require 'aws-sdk-core/plugins/retry_errors.rb'
 require 'aws-sdk-core/plugins/global_configuration.rb'
 require 'aws-sdk-core/plugins/regional_endpoint.rb'
+require 'aws-sdk-core/plugins/endpoint_discovery.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
@@ -59,6 +60,7 @@ module Aws::S3
     add_plugin(Aws::Plugins::RetryErrors)
     add_plugin(Aws::Plugins::GlobalConfiguration)
     add_plugin(Aws::Plugins::RegionalEndpoint)
+    add_plugin(Aws::Plugins::EndpointDiscovery)
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
@@ -126,6 +128,10 @@ module Aws::S3
     #
     #   @option options [String] :access_key_id
     #
+    #   @option options [Boolean] :active_endpoint_cache (false)
+    #     When set to `true`, a thread polling for endpoints will be running in
+    #     the background every 60 secs (default). Defaults to `false`.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -157,6 +163,21 @@ module Aws::S3
     #     option. You should only configure an `:endpoint` when connecting
     #     to test endpoints. This should be avalid HTTP(S) URI.
     #
+    #   @option options [Integer] :endpoint_cache_max_entries (1000)
+    #     Used for the maximum size limit of the LRU cache storing endpoints data
+    #     for endpoint discovery enabled operations. Defaults to 1000.
+    #
+    #   @option options [Integer] :endpoint_cache_max_threads (10)
+    #     Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.
+    #
+    #   @option options [Integer] :endpoint_cache_poll_interval (60)
+    #     When :endpoint_discovery and :active_endpoint_cache is enabled,
+    #     Use this option to config the time interval in seconds for making
+    #     requests fetching endpoints information. Defaults to 60 sec.
+    #
+    #   @option options [Boolean] :endpoint_discovery (false)
+    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #
     #   @option options [Proc] :event_stream_handler
     #     When an EventStream or Proc object is provided, it will be used as callback for each chunk of event stream response received along the way.
     #
@@ -947,7 +968,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Deletes the cors configuration information set for the bucket.
+    # Deletes the CORS configuration information set for the bucket.
     #
     # @option params [required, String] :bucket
     #
@@ -1115,21 +1136,19 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Deletes the replication configuration from the bucket.
+    # Deletes the replication configuration from the bucket. For information
+    # about replication configuration, see [Cross-Region Replication (CRR)](
+    # https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the
+    # *Amazon S3 Developer Guide*.
     #
     # @option params [required, String] :bucket
-    #   Deletes the replication subresource associated with the specified
-    #   bucket.
+    #   The bucket name.
     #
-    #   <note markdown="1"> There is usually some time lag before replication configuration
-    #   deletion is fully propagated to all the Amazon S3 systems.
+    #   <note markdown="1"> It can take a while to propagate the deletion of a replication
+    #   configuration to all Amazon S3 systems.
     #
     #    </note>
     #
-    #   For more information, see [Cross-Region Replication (CRR)](
-    #   https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the
-    #   Amazon S3 Developer Guide.
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -1245,6 +1264,15 @@ 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.
@@ -1258,15 +1286,6 @@ 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({
@@ -1383,22 +1402,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, 
@@ -1409,30 +1426,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, 
@@ -1443,14 +1464,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", 
     #       }, 
     #     ], 
     #   }
@@ -1495,6 +1514,29 @@ module Aws::S3
       req.send_request(options)
     end
 
+    # Removes the Public Access Block configuration for an Amazon S3 bucket.
+    #
+    # @option params [required, String] :bucket
+    #   The Amazon S3 bucket whose Public Access Block configuration you want
+    #   to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_public_access_block({
+    #     bucket: "BucketName", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeletePublicAccessBlock AWS API Documentation
+    #
+    # @overload delete_public_access_block(params = {})
+    # @param [Hash] params ({})
+    def delete_public_access_block(params = {}, options = {})
+      req = build_request(:delete_public_access_block, params)
+      req.send_request(options)
+    end
+
     # Returns the accelerate configuration of a bucket.
     #
     # @option params [required, String] :bucket
@@ -1606,7 +1648,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Returns the cors configuration for the bucket.
+    # Returns the CORS configuration for the bucket.
     #
     # @option params [required, String] :bucket
     #
@@ -2198,8 +2240,44 @@ module Aws::S3
       req.send_request(options, &block)
     end
 
+    # Retrieves the policy status for an Amazon S3 bucket, indicating
+    # whether the bucket is public.
+    #
+    # @option params [required, String] :bucket
+    #   The name of the Amazon S3 bucket whose public-policy status you want
+    #   to retrieve.
+    #
+    # @return [Types::GetBucketPolicyStatusOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBucketPolicyStatusOutput#policy_status #policy_status} => Types::PolicyStatus
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_bucket_policy_status({
+    #     bucket: "BucketName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.policy_status.is_public #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicyStatus AWS API Documentation
+    #
+    # @overload get_bucket_policy_status(params = {})
+    # @param [Hash] params ({})
+    def get_bucket_policy_status(params = {}, options = {})
+      req = build_request(:get_bucket_policy_status, params)
+      req.send_request(options)
+    end
+
     # Returns the replication configuration of a bucket.
     #
+    # <note markdown="1"> It can take a while to propagate the put or delete a replication
+    # configuration to all Amazon S3 systems. Therefore, a get request soon
+    # after put or delete can return a wrong result.
+    #
+    #  </note>
+    #
     # @option params [required, String] :bucket
     #
     # @return [Types::GetBucketReplicationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -2964,6 +3042,39 @@ module Aws::S3
       req.send_request(options, &block)
     end
 
+    # Retrieves the Public Access Block configuration for an Amazon S3
+    # bucket.
+    #
+    # @option params [required, String] :bucket
+    #   The name of the Amazon S3 bucket whose Public Access Block
+    #   configuration you want to retrieve.
+    #
+    # @return [Types::GetPublicAccessBlockOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetPublicAccessBlockOutput#public_access_block_configuration #public_access_block_configuration} => Types::PublicAccessBlockConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_public_access_block({
+    #     bucket: "BucketName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.public_access_block_configuration.block_public_acls #=> Boolean
+    #   resp.public_access_block_configuration.ignore_public_acls #=> Boolean
+    #   resp.public_access_block_configuration.block_public_policy #=> Boolean
+    #   resp.public_access_block_configuration.restrict_public_buckets #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetPublicAccessBlock AWS API Documentation
+    #
+    # @overload get_public_access_block(params = {})
+    # @param [Hash] params ({})
+    def get_public_access_block(params = {}, options = {})
+      req = build_request(:get_public_access_block, params)
+      req.send_request(options)
+    end
+
     # This operation is useful to determine if a bucket exists and you have
     # permission to access it.
     #
@@ -4271,7 +4382,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Sets the cors configuration for a bucket.
+    # Sets the CORS configuration for a bucket.
     #
     # @option params [required, String] :bucket
     #
@@ -4782,8 +4893,9 @@ module Aws::S3
     # @option params [required, String] :bucket
     #
     # @option params [required, Types::NotificationConfiguration] :notification_configuration
-    #   Container for specifying the notification configuration of the bucket.
-    #   If this element is empty, notifications are turned off on the bucket.
+    #   A container for specifying the notification configuration of the
+    #   bucket. If this element is empty, notifications are turned off for the
+    #   bucket.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -4918,18 +5030,18 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Creates a new replication configuration (or replaces an existing one,
-    # if present). For more information, see [Cross-Region Replication
-    # (CRR)]( https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in
-    # the Amazon S3 Developer Guide.
+    # Creates a replication configuration or replaces an existing one. For
+    # more information, see [Cross-Region Replication (CRR)](
+    # https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the
+    # *Amazon S3 Developer Guide*.
     #
     # @option params [required, String] :bucket
     #
     # @option params [String] :content_md5
     #
     # @option params [required, Types::ReplicationConfiguration] :replication_configuration
-    #   Container for replication rules. You can add as many as 1,000 rules.
-    #   Total replication configuration size can be up to 2 MB.
+    #   A container for replication rules. You can add up to 1,000 rules. The
+    #   maximum size of a replication configuration is 2 MB.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5339,7 +5451,7 @@ module Aws::S3
     #
     # @option params [String] :tagging
     #   The tag-set for the object. The tag-set must be encoded as URL Query
-    #   parameters
+    #   parameters. (For example, "Key1=Value1")
     #
     # @return [Types::PutObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5369,42 +5481,43 @@ module Aws::S3
     #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
     #   }
     #
-    # @example Example: To upload an object (specify optional headers)
+    # @example Example: To upload object and specify user-defined metadata
     #
-    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
-    #   # storage class and use server-side encryption.
+    #   # 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: "HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     server_side_encryption: "AES256", 
-    #     storage_class: "STANDARD_IA", 
+    #     key: "exampleobject", 
+    #     metadata: {
+    #       "metadata1" => "value1", 
+    #       "metadata2" => "value2", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
-    # @example Example: To upload an object and specify canned ACL.
+    # @example Example: To upload an object and specify optional tags
     #
-    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
-    #   # access to authenticated users. 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({
-    #     acl: "authenticated-read", 
-    #     body: "filetoupload", 
+    #     body: "c:\\HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
+    #     key: "HappyFace.jpg", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
     #   }
     #
     # @example Example: To upload an object
@@ -5424,43 +5537,42 @@ module Aws::S3
     #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
     #   }
     #
-    # @example Example: To upload object and specify user-defined metadata
+    # @example Example: To upload an object and specify canned ACL.
     #
-    #   # 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 and object. The request specifies optional canned ACL (access control list) to all READ
+    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
+    #     acl: "authenticated-read", 
     #     body: "filetoupload", 
     #     bucket: "examplebucket", 
     #     key: "exampleobject", 
-    #     metadata: {
-    #       "metadata1" => "value1", 
-    #       "metadata2" => "value2", 
-    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
+    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
     #   }
     #
-    # @example Example: To upload an object and specify optional tags
+    # @example Example: To upload an object (specify optional headers)
     #
-    #   # 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 uploads an object. The request specifies optional request headers to directs S3 to use specific
+    #   # storage class and use server-side encryption.
     #
     #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     server_side_encryption: "AES256", 
+    #     storage_class: "STANDARD_IA", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
+    #     server_side_encryption: "AES256", 
+    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
     # @example Example: To upload an object and specify server-side encryption and object tags
@@ -5726,6 +5838,44 @@ module Aws::S3
       req.send_request(options)
     end
 
+    # Creates or modifies the Public Access Block configuration for an
+    # Amazon S3 bucket.
+    #
+    # @option params [required, String] :bucket
+    #   The name of the Amazon S3 bucket whose Public Access Block
+    #   configuration you want to set.
+    #
+    # @option params [String] :content_md5
+    #   The MD5 hash of the `PutPublicBlock` request body.
+    #
+    # @option params [required, Types::PublicAccessBlockConfiguration] :public_access_block_configuration
+    #   The Public Access Block configuration that you want to apply to this
+    #   Amazon S3 bucket.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_public_access_block({
+    #     bucket: "BucketName", # required
+    #     content_md5: "ContentMD5",
+    #     public_access_block_configuration: { # required
+    #       block_public_acls: false,
+    #       ignore_public_acls: false,
+    #       block_public_policy: false,
+    #       restrict_public_buckets: false,
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutPublicAccessBlock AWS API Documentation
+    #
+    # @overload put_public_access_block(params = {})
+    # @param [Hash] params ({})
+    def put_public_access_block(params = {}, options = {})
+      req = build_request(:put_public_access_block, params)
+      req.send_request(options)
+    end
+
     # Restores an archived copy of an object back into Amazon S3
     #
     # @option params [required, String] :bucket
@@ -5882,14 +6032,14 @@ module Aws::S3
     # serialization format for the response.
     #
     # @option params [required, String] :bucket
-    #   The S3 Bucket.
+    #   The S3 bucket.
     #
     # @option params [required, String] :key
-    #   The Object Key.
+    #   The object key.
     #
     # @option params [String] :sse_customer_algorithm
-    #   The SSE Algorithm used to encrypt the object. For more information, go
-    #   to [ Server-Side Encryption (Using Customer-Provided Encryption
+    #   The SSE Algorithm used to encrypt the object. For more information,
+    #   see [ Server-Side Encryption (Using Customer-Provided Encryption
     #   Keys][1].
     #
     #
@@ -5897,7 +6047,7 @@ module Aws::S3
     #   [1]: http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
     #
     # @option params [String] :sse_customer_key
-    #   The SSE Customer Key. For more information, go to [ Server-Side
+    #   The SSE Customer Key. For more information, see [ Server-Side
     #   Encryption (Using Customer-Provided Encryption Keys][1].
     #
     #
@@ -5905,7 +6055,7 @@ module Aws::S3
     #   [1]: http://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
     #
     # @option params [String] :sse_customer_key_md5
-    #   The SSE Customer Key MD5. For more information, go to [ Server-Side
+    #   The SSE Customer Key MD5. For more information, see [ Server-Side
     #   Encryption (Using Customer-Provided Encryption Keys][1].
     #
     #
@@ -5916,7 +6066,7 @@ module Aws::S3
     #   The expression that is used to query the object.
     #
     # @option params [required, String] :expression_type
-    #   The type of the provided expression (e.g., SQL).
+    #   The type of the provided expression (for example., SQL).
     #
     # @option params [Types::RequestProgress] :request_progress
     #   Specifies if periodic request progress information should be enabled.
@@ -6355,45 +6505,45 @@ module Aws::S3
     #   * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To upload a part by copying data from an existing object as data source
+    # @example Example: To upload a part by copying byte range from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
+    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
+    #   # data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket", 
     #     copy_source: "/bucketname/sourceobjectkey", 
+    #     copy_source_range: "bytes=1-100000", 
     #     key: "examplelargeobject", 
-    #     part_number: 1, 
+    #     part_number: 2, 
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"", 
-    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"), 
+    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"", 
+    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"), 
     #     }, 
     #   }
     #
-    # @example Example: To upload a part by copying byte range from an existing object as data source
+    # @example Example: To upload a part by copying data from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
-    #   # data source.
+    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket", 
     #     copy_source: "/bucketname/sourceobjectkey", 
-    #     copy_source_range: "bytes=1-100000", 
     #     key: "examplelargeobject", 
-    #     part_number: 2, 
+    #     part_number: 1, 
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"", 
-    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"), 
+    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"", 
+    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"), 
     #     }, 
     #   }
     #
@@ -6452,7 +6602,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.23.1'
+      context[:gem_version] = '1.24.0'
       Seahorse::Client::Request.new(handlers, context)
     end