aws-sdk-s3 1.143.0 → 1.156.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.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'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -34,6 +35,7 @@ require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/sign.rb'
 require 'aws-sdk-core/plugins/protocols/rest_xml.rb'
 require 'aws-sdk-s3/plugins/accelerate.rb'
+require 'aws-sdk-s3/plugins/access_grants.rb'
 require 'aws-sdk-s3/plugins/arn.rb'
 require 'aws-sdk-s3/plugins/bucket_dns.rb'
 require 'aws-sdk-s3/plugins/bucket_name_restrictions.rb'
@@ -92,6 +94,7 @@ module Aws::S3
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -104,6 +107,7 @@ module Aws::S3
     add_plugin(Aws::Plugins::Sign)
     add_plugin(Aws::Plugins::Protocols::RestXml)
     add_plugin(Aws::S3::Plugins::Accelerate)
+    add_plugin(Aws::S3::Plugins::AccessGrants)
     add_plugin(Aws::S3::Plugins::ARN)
     add_plugin(Aws::S3::Plugins::BucketDns)
     add_plugin(Aws::S3::Plugins::BucketNameRestrictions)
@@ -127,6 +131,11 @@ module Aws::S3
 
     # @overload initialize(options)
     #   @param [Hash] options
+    #
+    #   @option options [Array<Seahorse::Client::Plugin>] :plugins ([]])
+    #     A list of plugins to apply to the client. Each plugin is either a
+    #     class name or an instance of a plugin class.
+    #
     #   @option options [required, Aws::CredentialProvider] :credentials
     #     Your AWS credentials. This can be an instance of any one of the
     #     following classes:
@@ -184,6 +193,16 @@ module Aws::S3
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
     #
+    #   @option options [Boolean] :access_grants (false)
+    #     When `true`, the S3 client will use the S3 Access Grants feature to
+    #     authenticate requests. Bucket credentials will be fetched from S3
+    #     Control using the `get_data_access` API.
+    #
+    #   @option options [Aws::S3::AccessGrantsCredentialsProvider] :access_grants_credentials_provider
+    #     When `access_grants` is `true`, this option can be used to provide
+    #     additional options to the credentials provider, including a privilege
+    #     setting, caching, and fallback behavior.
+    #
     #   @option options [String] :access_key_id
     #
     #   @option options [Boolean] :active_endpoint_cache (false)
@@ -246,10 +265,16 @@ module Aws::S3
     #   @option options [Boolean] :disable_s3_express_session_auth
     #     Parameter to indicate whether S3Express session auth should be disabled
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -365,7 +390,6 @@ module Aws::S3
     #       throttling.  This is a provisional mode that may change behavior
     #       in the future.
     #
-    #
     #   @option options [Boolean] :s3_disable_multiregion_access_points (false)
     #     When set to `false` this will option will raise errors when multi-region
     #     access point ARNs are used.  Multi-region access points can potentially
@@ -382,13 +406,23 @@ module Aws::S3
     #
     #   @option options [String] :sdk_ua_app_id
     #     A unique and opaque application ID that is appended to the
-    #     User-Agent header as app/<sdk_ua_app_id>. It should have a
-    #     maximum length of 50.
+    #     User-Agent header as app/sdk_ua_app_id. It should have a
+    #     maximum length of 50. This variable is sourced from environment
+    #     variable AWS_SDK_UA_APP_ID or the shared config profile attribute sdk_ua_app_id.
     #
     #   @option options [String] :secret_access_key
     #
     #   @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
@@ -432,50 +466,65 @@ module Aws::S3
     #   @option options [Aws::S3::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::S3::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -561,7 +610,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -699,8 +748,8 @@ module Aws::S3
     # error).
     #
     # Note that if `CompleteMultipartUpload` fails, applications should be
-    # prepared to retry the failed requests. For more information, see
-    # [Amazon S3 Error Best Practices][3].
+    # prepared to retry any failed requests (including 500 error responses).
+    # For more information, see [Amazon S3 Error Best Practices][3].
     #
     # You can't use `Content-Type: application/x-www-form-urlencoded` for
     # the CompleteMultipartUpload requests. Also, if you don't provide a
@@ -812,7 +861,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1094,11 +1143,14 @@ module Aws::S3
     #
     # Both the Region that you want to copy the object from and the Region
     # that you want to copy the object to must be enabled for your account.
+    # For more information about how to enable a Region for your account,
+    # see [Enable or disable a Region for standalone accounts][3] in the
+    # *Amazon Web Services Account Management Guide*.
     #
     # Amazon S3 transfer acceleration does not support cross-Region copies.
     # If you request a cross-Region copy using a transfer acceleration
     # endpoint, you get a `400 Bad Request` error. For more information, see
-    # [Transfer Acceleration][3].
+    # [Transfer Acceleration][4].
     #
     # Authentication and authorization
     #
@@ -1106,7 +1158,7 @@ module Aws::S3
     #   IAM credentials (access key ID and secret access key for the IAM
     #   identities). All headers with the `x-amz-` prefix, including
     #   `x-amz-copy-source`, must be signed. For more information, see [REST
-    #   Authentication][4].
+    #   Authentication][5].
     #
     #   **Directory buckets** - You must use the IAM credentials to
     #   authenticate and authorize your access to the `CopyObject` API
@@ -1130,7 +1182,7 @@ module Aws::S3
     #       source object that is being copied.
     #
     #     * If the destination bucket is a general purpose bucket, you must
-    #       have <b> <code>s3:PubObject</code> </b> permission to write the
+    #       have <b> <code>s3:PutObject</code> </b> permission to write the
     #       object copy to the destination bucket.
     #
     #   * **Directory bucket permissions** - You must have permissions in a
@@ -1152,17 +1204,16 @@ module Aws::S3
     #       set to `ReadOnly` on the copy destination bucket.
     #
     #     For example policies, see [Example bucket policies for S3 Express
-    #     One Zone][5] and [Amazon Web Services Identity and Access
+    #     One Zone][6] and [Amazon Web Services Identity and Access
     #     Management (IAM) identity-based policies for S3 Express One
-    #     Zone][6] in the *Amazon S3 User Guide*.
+    #     Zone][7] in the *Amazon S3 User Guide*.
     #
     # Response and special errors
     #
     # : 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.
@@ -1178,14 +1229,13 @@ module Aws::S3
     #       response is embedded in the `200 OK` response. For example, in a
     #       cross-region copy, you may encounter throttling and receive a
     #       `200 OK` response. For more information, see [Resolve the Error
-    #       200 response when copying objects to Amazon
-    #       S3](repost.aws/knowledge-center/s3-resolve-200-internalerror).
-    #       The `200 OK` status code means the copy was accepted, but it
-    #       doesn't mean the copy is complete. Another example is when you
-    #       disconnect from Amazon S3 before the copy is complete, Amazon S3
-    #       might cancel the copy and you may receive a `200 OK` response.
-    #       You must stay connected to Amazon S3 until the entire response
-    #       is successfully received and processed.
+    #       200 response when copying objects to Amazon S3][8]. The `200 OK`
+    #       status code means the copy was accepted, but it doesn't mean
+    #       the copy is complete. Another example is when you disconnect
+    #       from Amazon S3 before the copy is complete, Amazon S3 might
+    #       cancel the copy and you may receive a `200 OK` response. You
+    #       must stay connected to Amazon S3 until the entire response is
+    #       successfully received and processed.
     #
     #       If you call this API operation directly, make sure to design
     #       your application to parse the content of the response and handle
@@ -1201,8 +1251,9 @@ module Aws::S3
     # : The copy request charge is based on the storage class and Region
     #   that you specify for the destination object. The request can also
     #   result in a data retrieval charge for the source if the source
-    #   storage class bills for data retrieval. For pricing information, see
-    #   [Amazon S3 pricing][7].
+    #   storage class bills for data retrieval. If the copy source is in a
+    #   different region, the data transfer is billed to the copy source
+    #   account. For pricing information, see [Amazon S3 pricing][9].
     #
     # HTTP Host header syntax
     #
@@ -1211,21 +1262,23 @@ module Aws::S3
     #
     # The following operations are related to `CopyObject`:
     #
-    # * [PutObject][8]
+    # * [PutObject][10]
     #
-    # * [GetObject][9]
+    # * [GetObject][11]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
-    # [7]: http://aws.amazon.com/s3/pricing/
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
+    # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
+    # [9]: http://aws.amazon.com/s3/pricing/
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
     #
     # @option params [String] :acl
     #   The canned access control list (ACL) to apply to the object.
@@ -1269,7 +1322,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -2092,22 +2145,31 @@ module Aws::S3
     #       includes the `x-amz-object-ownership` header, then the
     #       `s3:PutBucketOwnershipControls` permission is required.
     #
-    #       If your `CreateBucket` request sets `BucketOwnerEnforced` for
-    #       Amazon S3 Object Ownership and specifies a bucket ACL that
-    #       provides access to an external Amazon Web Services account, your
-    #       request fails with a `400` error and returns the
-    #       `InvalidBucketAcLWithObjectOwnership` error code. For more
-    #       information, see [Setting Object Ownership on an existing bucket
-    #       ][5] in the *Amazon S3 User Guide*.
+    #       To set an ACL on a bucket as part of a `CreateBucket` request,
+    #       you must explicitly set S3 Object Ownership for the bucket to a
+    #       different value than the default, `BucketOwnerEnforced`.
+    #       Additionally, if your desired bucket ACL grants public access,
+    #       you must first create the bucket (without the bucket ACL) and
+    #       then explicitly disable Block Public Access on the bucket before
+    #       using `PutBucketAcl` to set the ACL. If you try to create a
+    #       bucket with a public ACL, the request will fail.
+    #
+    #        For the majority of modern use cases in S3, we recommend that
+    #       you keep all Block Public Access settings enabled and keep ACLs
+    #       disabled. If you would like to share data with users outside of
+    #       your account, you can use bucket policies as needed. For more
+    #       information, see [Controlling ownership of objects and disabling
+    #       ACLs for your bucket ][5] and [Blocking public access to your
+    #       Amazon S3 storage ][6] in the *Amazon S3 User Guide*.
     #
     #     * **S3 Block Public Access** - If your specific use case requires
     #       granting public access to your S3 resources, you can disable
     #       Block Public Access. Specifically, you can create a new bucket
     #       with Block Public Access enabled, then separately call the [
-    #       `DeletePublicAccessBlock` ][6] API. To use this operation, you
+    #       `DeletePublicAccessBlock` ][7] API. To use this operation, you
     #       must have the `s3:PutBucketPublicAccessBlock` permission. For
     #       more information about S3 Block Public Access, see [Blocking
-    #       public access to your Amazon S3 storage ][7] in the *Amazon S3
+    #       public access to your Amazon S3 storage ][6] in the *Amazon S3
     #       User Guide*.
     #
     #   * **Directory bucket permissions** - You must have the
@@ -2149,9 +2211,9 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-ownership-existing-bucket.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
     # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
     # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
     # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
@@ -2178,7 +2240,7 @@ module Aws::S3
     #   Virtual-hosted-style requests aren't supported. Directory bucket
     #   names must be unique in the chosen Availability Zone. Bucket names
     #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about
+    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
     #   bucket naming restrictions, see [Directory bucket naming rules][2] in
     #   the *Amazon S3 User Guide*
     #
@@ -2277,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
@@ -2588,7 +2650,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -3350,7 +3412,7 @@ module Aws::S3
     #   Virtual-hosted-style requests aren't supported. Directory bucket
     #   names must be unique in the chosen Availability Zone. Bucket names
     #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about
+    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
     #   bucket naming restrictions, see [Directory bucket naming rules][1] in
     #   the *Amazon S3 User Guide*
     #
@@ -3979,7 +4041,7 @@ module Aws::S3
     #   Virtual-hosted-style requests aren't supported. Directory bucket
     #   names must be unique in the chosen Availability Zone. Bucket names
     #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about
+    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
     #   bucket naming restrictions, see [Directory bucket naming rules][1] in
     #   the *Amazon S3 User Guide*
     #
@@ -4222,15 +4284,26 @@ module Aws::S3
     # Removes an object from a bucket. The behavior depends on the bucket's
     # versioning state:
     #
-    # * If versioning is enabled, the operation removes the null version (if
-    #   there is one) of an object and inserts a delete marker, which
-    #   becomes the latest version of the object. If there isn't a null
-    #   version, Amazon S3 does not remove any objects but will still
-    #   respond that the command was successful.
-    #
-    # * If versioning is suspended or not enabled, the operation permanently
+    # * If bucket versioning is not enabled, the operation permanently
     #   deletes the object.
     #
+    # * If bucket versioning is enabled, the operation inserts a delete
+    #   marker, which becomes the current version of the object. To
+    #   permanently delete an object in a versioned bucket, you must include
+    #   the object’s `versionId` in the request. For more information about
+    #   versioning-enabled buckets, see [Deleting object versions from a
+    #   versioning-enabled bucket][1].
+    #
+    # * If bucket versioning is suspended, the operation removes the object
+    #   that has a null `versionId`, if there is one, and inserts a delete
+    #   marker that becomes the current version of the object. If there
+    #   isn't an object with a null `versionId`, and all versions of the
+    #   object have a `versionId`, Amazon S3 does not remove the object and
+    #   only inserts a delete marker. To permanently delete an object that
+    #   has a `versionId`, you must include the object’s `versionId` in the
+    #   request. For more information about versioning-suspended buckets,
+    #   see [Deleting objects from versioning-suspended buckets][2].
+    #
     # <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
     #   for directory buckets. For this API operation, only the `null` value
     #   of the version ID is supported by directory buckets. You can only
@@ -4241,7 +4314,7 @@ module Aws::S3
     #   endpoints support virtual-hosted-style requests in the format
     #   `https://bucket_name.s3express-az_id.region.amazonaws.com/key-name
     #   `. Path-style requests are not supported. For more information, see
-    #   [Regional and Zonal endpoints][1] in the *Amazon S3 User Guide*.
+    #   [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -4254,8 +4327,8 @@ module Aws::S3
     # versioning configuration is MFA Delete enabled, you must include the
     # `x-amz-mfa` request header in the DELETE `versionId` request. Requests
     # that include `x-amz-mfa` must use HTTPS. For more information about
-    # MFA Delete, see [Using MFA Delete][2] in the *Amazon S3 User Guide*.
-    # To see sample requests that use versioning, see [Sample Request][3].
+    # MFA Delete, see [Using MFA Delete][4] in the *Amazon S3 User Guide*.
+    # To see sample requests that use versioning, see [Sample Request][5].
     #
     # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
     # buckets.
@@ -4263,7 +4336,7 @@ module Aws::S3
     #  </note>
     #
     # You can delete objects by explicitly calling DELETE Object or calling
-    # ([PutBucketLifecycle][4]) to enable Amazon S3 to remove them for you.
+    # ([PutBucketLifecycle][6]) to enable Amazon S3 to remove them for you.
     # If you want to block users or accounts from removing or deleting
     # objects from your bucket, you must deny them the `s3:DeleteObject`,
     # `s3:DeleteObjectVersion`, and `s3:PutLifeCycleConfiguration` actions.
@@ -4282,12 +4355,12 @@ module Aws::S3
     #       a bucket, you must always have the `s3:DeleteObject` 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 have the `s3:DeleteObjectVersion` permission.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][5] API operation for session-based
+    #     `CreateSession` ][7] API operation for session-based
     #     authorization. Specifically, you grant the
     #     `s3express:CreateSession` permission to the directory bucket in a
     #     bucket policy or an IAM identity-based policy. Then, you make the
@@ -4298,7 +4371,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][5].
+    #     authorization, see [ `CreateSession` ][7].
     #
     # HTTP Host header syntax
     #
@@ -4307,18 +4380,20 @@ module Aws::S3
     #
     # The following action is related to `DeleteObject`:
     #
-    # * [PutObject][6]
+    # * [PutObject][8]
     #
     # ^
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
     #
     # @option params [required, String] :bucket
     #   The bucket name of the bucket containing the object.
@@ -4329,7 +4404,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -4423,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.
@@ -4445,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({
@@ -4653,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
@@ -4720,7 +4795,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -4854,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, 
@@ -4880,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, 
@@ -4914,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", 
     #       }, 
     #     ], 
     #   }
@@ -5781,13 +5856,16 @@ module Aws::S3
     #  </note>
     #
     # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
-    # rule using an object key name prefix, one or more object tags, or a
-    # combination of both. Accordingly, this section describes the latest
-    # API. The response describes the new filter element that you can use to
-    # specify a filter to select a subset of objects to which the rule
-    # applies. If you are using a previous version of the lifecycle
-    # configuration, it still works. For the earlier action, see
-    # [GetBucketLifecycle][1].
+    # rule using an object key name prefix, one or more object tags, object
+    # size, or any combination of these. Accordingly, this section describes
+    # the latest API. The previous version of the API supported filtering
+    # based only on an object key name prefix, which is supported for
+    # backward compatibility. For the related API description, see
+    # [GetBucketLifecycle][1]. Accordingly, this section describes the
+    # latest API. The response describes the new filter element that you can
+    # use to specify a filter to select a subset of objects to which the
+    # rule applies. If you are using a previous version of the lifecycle
+    # configuration, it still works. For the earlier action,
     #
     #  </note>
     #
@@ -6547,7 +6625,7 @@ module Aws::S3
     #   Virtual-hosted-style requests aren't supported. Directory bucket
     #   names must be unique in the chosen Availability Zone. Bucket names
     #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about
+    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
     #   bucket naming restrictions, see [Directory bucket naming rules][1] in
     #   the *Amazon S3 User Guide*
     #
@@ -7302,7 +7380,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -8135,7 +8213,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -8668,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
@@ -8922,7 +9000,7 @@ module Aws::S3
     # If the bucket does not exist or you do not have permission to access
     # it, the `HEAD` request returns a generic `400 Bad Request`, `403
     # Forbidden` or `404 Not Found` code. A message body is not included, so
-    # you cannot determine the exception beyond these error codes.
+    # you cannot determine the exception beyond these HTTP response codes.
     #
     # <note markdown="1"> <b>Directory buckets </b> - You must make requests for this API
     # operation to the Zonal endpoint. These endpoints support
@@ -8995,7 +9073,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -9236,7 +9314,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -9356,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.
     #
@@ -9498,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",
@@ -10225,7 +10327,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -10650,9 +10752,7 @@ module Aws::S3
     #
     # @example Example: To list object versions
     #
-    #   # The following example return versions of an object with specific key name prefix. The request limits the number of items
-    #   # returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify
-    #   # this token value in your next request to fetch next set of object versions.
+    #   # The following example returns versions of an object with specific key name prefix.
     #
     #   resp = client.list_object_versions({
     #     bucket: "examplebucket", 
@@ -10795,7 +10895,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -11060,7 +11160,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -11116,6 +11216,9 @@ 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`.
     #
     # @option params [Integer] :max_keys
     #   Sets the maximum number of keys returned in the response. By default,
@@ -11382,7 +11485,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -12879,11 +12982,11 @@ module Aws::S3
     # configuration, see [Managing your storage lifecycle][1].
     #
     # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
-    # rule using an object key name prefix, one or more object tags, or a
-    # combination of both. Accordingly, this section describes the latest
-    # API. The previous version of the API supported filtering based only on
-    # an object key name prefix, which is supported for backward
-    # compatibility. For the related API description, see
+    # rule using an object key name prefix, one or more object tags, object
+    # size, or any combination of these. Accordingly, this section describes
+    # the latest API. The previous version of the API supported filtering
+    # based only on an object key name prefix, which is supported for
+    # backward compatibility. For the related API description, see
     # [PutBucketLifecycle][2].
     #
     #  </note>
@@ -12898,7 +13001,7 @@ module Aws::S3
     #
     #   * A filter identifying a subset of objects to which the rule
     #     applies. The filter can be based on a key name prefix, object
-    #     tags, or a combination of both.
+    #     tags, object size, or any combination of these.
     #
     #   * A status indicating whether the rule is in effect.
     #
@@ -13801,7 +13904,7 @@ module Aws::S3
     #   Virtual-hosted-style requests aren't supported. Directory bucket
     #   names must be unique in the chosen Availability Zone. Bucket names
     #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about
+    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
     #   bucket naming restrictions, see [Directory bucket naming rules][1] in
     #   the *Amazon S3 User Guide*
     #
@@ -14880,7 +14983,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -15342,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)
@@ -15398,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.
@@ -15455,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
@@ -16602,10 +16705,10 @@ module Aws::S3
     #
     # This action performs the following types of requests:
     #
-    # * `select` - Perform a select query on an archived object
-    #
     # * `restore an archive` - Restore an archived object
     #
+    # ^
+    #
     # For more information about the `S3` structure in the request body, see
     # the following:
     #
@@ -16616,51 +16719,6 @@ module Aws::S3
     # * [Protecting Data Using Server-Side Encryption][3] in the *Amazon S3
     #   User Guide*
     #
-    # Define the SQL expression for the `SELECT` type of restoration for
-    # your query in the request body's `SelectParameters` structure. You
-    # can use expressions like the following examples.
-    #
-    # * The following expression returns all records from the specified
-    #   object.
-    #
-    #   `SELECT * FROM Object`
-    #
-    # * Assuming that you are not using any headers for data stored in the
-    #   object, you can specify columns with positional headers.
-    #
-    #   `SELECT s._1, s._2 FROM Object s WHERE s._3 > 100`
-    #
-    # * If you have headers and you set the `fileHeaderInfo` in the `CSV`
-    #   structure in the request body to `USE`, you can specify headers in
-    #   the query. (If you set the `fileHeaderInfo` field to `IGNORE`, the
-    #   first row is skipped for the query.) You cannot mix ordinal
-    #   positions with header column names.
-    #
-    #   `SELECT s.Id, s.FirstName, s.SSN FROM S3Object s`
-    #
-    # When making a select request, you can also do the following:
-    #
-    # * To expedite your queries, specify the `Expedited` tier. For more
-    #   information about tiers, see "Restoring Archives," later in this
-    #   topic.
-    #
-    # * Specify details about the data serialization format of both the
-    #   input object that is being queried and the serialization of the
-    #   CSV-encoded query results.
-    #
-    # The following are additional important facts about the select feature:
-    #
-    # * The output results are new Amazon S3 objects. Unlike archive
-    #   retrievals, they are stored until explicitly deleted-manually or
-    #   through a lifecycle configuration.
-    #
-    # * You can issue more than one select request on the same Amazon S3
-    #   object. Amazon S3 doesn't duplicate requests, so avoid issuing
-    #   duplicate requests.
-    #
-    # * Amazon S3 accepts a select request even if the object has already
-    #   been restored. A select request doesn’t return error response `409`.
-    #
     # Permissions
     #
     # : To use this operation, you must have permissions to perform the
@@ -16778,8 +16836,7 @@ module Aws::S3
     #
     #     * *Code: RestoreAlreadyInProgress*
     #
-    #     * *Cause: Object restore is already in progress. (This error does
-    #       not apply to SELECT type requests.)*
+    #     * *Cause: Object restore is already in progress.*
     #
     #     * *HTTP Status Code: 409 Conflict*
     #
@@ -17221,22 +17278,22 @@ module Aws::S3
     #
     # @example EventStream Operation Example
     #
-    #   You can process event once it arrives immediately, or wait until
-    #   full response complete and iterate through eventstream enumerator.
+    #   You can process the event once it arrives immediately, or wait until the
+    #   full response is complete and iterate through the eventstream enumerator.
     #
     #   To interact with event immediately, you need to register #select_object_content
-    #   with callbacks, callbacks can be register for specifc events or for all events,
-    #   callback for errors in the event stream is also available for register.
+    #   with callbacks. Callbacks can be registered for specific events or for all
+    #   events, including error events.
     #
-    #   Callbacks can be passed in by `:event_stream_handler` option or within block
-    #   statement attached to #select_object_content call directly. Hybrid pattern of both
-    #   is also supported.
+    #   Callbacks can be passed into the `:event_stream_handler` option or within a
+    #   block statement attached to the #select_object_content call directly. Hybrid
+    #   pattern of both is also supported.
     #
-    #   `:event_stream_handler` option takes in either Proc object or
+    #   `:event_stream_handler` option takes in either a Proc object or
     #   Aws::S3::EventStreams::SelectObjectContentEventStream object.
     #
-    #   Usage pattern a): callbacks with a block attached to #select_object_content
-    #     Example for registering callbacks for all event types and error event
+    #   Usage pattern a): Callbacks with a block attached to #select_object_content
+    #     Example for registering callbacks for all event types and an error event
     #
     #     client.select_object_content( # params input# ) do |stream|
     #       stream.on_error_event do |event|
@@ -17256,9 +17313,9 @@ module Aws::S3
     #
     #     end
     #
-    #   Usage pattern b): pass in `:event_stream_handler` for #select_object_content
+    #   Usage pattern b): Pass in `:event_stream_handler` for #select_object_content
     #
-    #     1) create a Aws::S3::EventStreams::SelectObjectContentEventStream object
+    #     1) Create a Aws::S3::EventStreams::SelectObjectContentEventStream object
     #     Example for registering callbacks with specific events
     #
     #       handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
@@ -17280,7 +17337,7 @@ module Aws::S3
     #
     #     client.select_object_content( # params input #, event_stream_handler: handler)
     #
-    #     2) use a Ruby Proc object
+    #     2) Use a Ruby Proc object
     #     Example for registering callbacks with specific events
     #
     #     handler = Proc.new do |stream|
@@ -17303,7 +17360,7 @@ module Aws::S3
     #
     #     client.select_object_content( # params input #, event_stream_handler: handler)
     #
-    #   Usage pattern c): hybird pattern of a) and b)
+    #   Usage pattern c): Hybrid pattern of a) and b)
     #
     #       handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
     #       handler.on_records_event do |event|
@@ -17333,8 +17390,7 @@ module Aws::S3
     #       end
     #     end
     #
-    #   Besides above usage patterns for process events when they arrive immediately, you can also
-    #   iterate through events after response complete.
+    #   You can also iterate through events after the response complete.
     #
     #   Events are available at resp.payload # => Enumerator
     #   For parameter input example, please refer to following request syntax
@@ -17619,7 +17675,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -17935,11 +17991,11 @@ module Aws::S3
     #       the source object that is being copied.
     #
     #     * If the destination bucket is a general purpose bucket, you must
-    #       have the <b> <code>s3:PubObject</code> </b> permission to write
+    #       have the <b> <code>s3:PutObject</code> </b> permission to write
     #       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
@@ -17949,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
@@ -18018,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
@@ -18037,7 +18093,7 @@ module Aws::S3
     #   are not supported. Directory bucket names must be unique in the chosen
     #   Availability Zone. Bucket names must follow the format `
     #   bucket_base_name--az-id--x-s3` (for example, `
-    #   DOC-EXAMPLE-BUCKET--usw2-az2--x-s3`). For information about bucket
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -18807,7 +18863,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.143.0'
+      context[:gem_version] = '1.156.0'
       Seahorse::Client::Request.new(handlers, context)
     end