aws-sdk-s3 1.166.0 → 1.174.0

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

@@ -571,7 +571,7 @@ module Aws::S3
     #   in-progress multipart uploads are aborted or completed. To delete
     #   these in-progress multipart uploads, use the `ListMultipartUploads`
     #   operation to list the in-progress multipart uploads in the bucket
-    #   and use the `AbortMultupartUpload` operation to abort all the
+    #   and use the `AbortMultipartUpload` operation to abort all the
     #   in-progress multipart uploads.
     #
     # * **Directory buckets** - For directory buckets, you must make
@@ -703,6 +703,18 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [Time,DateTime,Date,Integer,String] :if_match_initiated_time
+    #   If present, this header aborts an in progress multipart upload only if
+    #   it was initiated on the provided timestamp. If the initiated timestamp
+    #   of the multipart upload does not match the provided value, the
+    #   operation returns a `412 Precondition Failed` error. If the initiated
+    #   timestamp matches or if the multipart upload doesn’t exist, the
+    #   operation returns a `204 Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
     # @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AbortMultipartUploadOutput#request_charged #request_charged} => String
@@ -730,6 +742,7 @@ module Aws::S3
     #     upload_id: "MultipartUploadId", # required
     #     request_payer: "requester", # accepts requester
     #     expected_bucket_owner: "AccountId",
+    #     if_match_initiated_time: Time.now,
     #   })
     #
     # @example Response structure
@@ -837,7 +850,6 @@ module Aws::S3
     #       except the last part.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `InvalidPart`
     #
     #     * Description: One or more of the specified parts could not be
@@ -845,14 +857,12 @@ module Aws::S3
     #       ETag might not have matched the uploaded part's ETag.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `InvalidPartOrder`
     #
     #     * Description: The list of parts was not in ascending order. The
     #       parts list must be specified in order by part number.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `NoSuchUpload`
     #
     #     * Description: The specified multipart upload does not exist. The
@@ -949,9 +959,9 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32 checksum of the object. For
-    #   more information, see [Checking object integrity][1] in the *Amazon S3
-    #   User Guide*.
+    #   specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
+    #   For more information, see [Checking object integrity][1] in the
+    #   *Amazon S3 User Guide*.
     #
     #
     #
@@ -960,7 +970,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32C checksum of the object.
+    #   specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1012,6 +1022,27 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [String] :if_match
+    #   Uploads the object only if the ETag (entity tag) value provided during
+    #   the WRITE operation matches the ETag of the object in S3. If the ETag
+    #   values do not match, the operation returns a `412 Precondition Failed`
+    #   error.
+    #
+    #   If a conflicting operation occurs during the upload S3 returns a `409
+    #   ConditionalRequestConflict` response. On a 409 failure you should
+    #   fetch the object's ETag, re-initiate the multipart upload with
+    #   `CreateMultipartUpload`, and re-upload each part.
+    #
+    #   Expects the ETag value as a string.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1], or
+    #   [Conditional requests][2] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/rfc7232
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
+    #
     # @option params [String] :if_none_match
     #   Uploads the object only if the object key name does not already exist
     #   in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -1147,6 +1178,7 @@ module Aws::S3
     #     checksum_sha256: "ChecksumSHA256",
     #     request_payer: "requester", # accepts requester
     #     expected_bucket_owner: "AccountId",
+    #     if_match: "IfMatch",
     #     if_none_match: "IfNoneMatch",
     #     sse_customer_algorithm: "SSECustomerAlgorithm",
     #     sse_customer_key: "SSECustomerKey",
@@ -1254,7 +1286,6 @@ module Aws::S3
     #     * If the destination bucket is a general purpose bucket, you must
     #       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
     #     bucket policy or an IAM identity-based policy based on the source
     #     and destination bucket types in a `CopyObject` operation.
@@ -1272,7 +1303,6 @@ module Aws::S3
     #       `Action` element of a policy to write the object to the
     #       destination. The `s3express:SessionMode` condition key can't be
     #       set to `ReadOnly` on the copy destination bucket.
-    #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
     #     identity-based policies and KMS key policies for the KMS key.
@@ -1779,17 +1809,17 @@ module Aws::S3
     #   * To encrypt new object copies to a directory bucket with SSE-KMS, we
     #     recommend you specify SSE-KMS as the directory bucket's default
     #     encryption configuration with a KMS key (specifically, a [customer
-    #     managed key][4]). [Amazon Web Services managed key][5] (`aws/s3`)
-    #     isn't supported. Your SSE-KMS configuration can only support 1
-    #     [customer managed key][4] per directory bucket for the lifetime of
-    #     the bucket. After you specify a customer managed key for SSE-KMS,
-    #     you can't override the customer managed key for the bucket's
-    #     SSE-KMS configuration. Then, when you perform a `CopyObject`
-    #     operation and want to specify server-side encryption settings for
-    #     new object copies with SSE-KMS in the encryption-related request
-    #     headers, you must ensure the encryption key is the same customer
-    #     managed key that you specified for the directory bucket's default
-    #     encryption configuration.
+    #     managed key][4]). The [Amazon Web Services managed key][5]
+    #     (`aws/s3`) isn't supported. Your SSE-KMS configuration can only
+    #     support 1 [customer managed key][4] per directory bucket for the
+    #     lifetime of the bucket. After you specify a customer managed key for
+    #     SSE-KMS, you can't override the customer managed key for the
+    #     bucket's SSE-KMS configuration. Then, when you perform a
+    #     `CopyObject` operation and want to specify server-side encryption
+    #     settings for new object copies with SSE-KMS in the
+    #     encryption-related request headers, you must ensure the encryption
+    #     key is the same customer managed key that you specified for the
+    #     directory bucket's default encryption configuration.
     #
     #
     #
@@ -1903,14 +1933,19 @@ module Aws::S3
     #   Guide*.
     #
     #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, you must specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header with the ID (Key
-    #   ID or Key ARN) of the KMS symmetric encryption customer managed key to
-    #   use. Otherwise, you get an HTTP `400 Bad Request` error. Only use the
-    #   key ID or key ARN. The key alias format of the KMS key isn't
-    #   supported. Your SSE-KMS configuration can only support 1 [customer
-    #   managed key][2] per directory bucket for the lifetime of the bucket.
-    #   [Amazon Web Services managed key][3] (`aws/s3`) isn't supported.
+    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
+    #   header is implicitly assigned the ID of the KMS symmetric encryption
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. If you want to specify the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
+    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
+    #   Request` error. Only use the key ID or key ARN. The key alias format
+    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
+    #   support 1 [customer managed key][2] per directory bucket for the
+    #   lifetime of the bucket. The [Amazon Web Services managed key][3]
+    #   (`aws/s3`) isn't supported.
     #
     #
     #
@@ -2304,7 +2339,6 @@ module Aws::S3
     #       more information about S3 Block Public Access, see [Blocking
     #       public access to your Amazon S3 storage ][6] in the *Amazon S3
     #       User Guide*.
-    #
     #   * **Directory bucket permissions** - You must have the
     #     `s3express:CreateBucket` permission in an IAM identity-based
     #     policy instead of a bucket policy. Cross-account access to this
@@ -2472,33 +2506,33 @@ module Aws::S3
     #   * {Types::CreateBucketOutput#location #location} => String
     #
     #
-    # @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 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 Request syntax with placeholder values
@@ -2655,7 +2689,6 @@ module Aws::S3
     #       * `x-amz-server-side-encryption-aws-kms-key-id`
     #
     #       * `x-amz-server-side-encryption-context`
-    #
     #       <note markdown="1"> * If you specify `x-amz-server-side-encryption:aws:kms`, but
     #         don't provide `x-amz-server-side-encryption-aws-kms-key-id`,
     #         Amazon S3 uses the Amazon Web Services managed key (`aws/s3`
@@ -2701,12 +2734,10 @@ module Aws::S3
     #       * `x-amz-server-side-encryption-customer-key`
     #
     #       * `x-amz-server-side-encryption-customer-key-MD5`
-    #
     #       For more information about server-side encryption with
     #       customer-provided encryption keys (SSE-C), see [ Protecting data
     #       using server-side encryption with customer-provided encryption
     #       keys (SSE-C)][11] in the *Amazon S3 User Guide*.
-    #
     #   * **Directory buckets** - For directory buckets, there are only two
     #     supported options for server-side encryption: server-side
     #     encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -3272,14 +3303,19 @@ module Aws::S3
     #   Amazon Web Services managed key (`aws/s3`) to protect the data.
     #
     #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, you must specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header with the ID (Key
-    #   ID or Key ARN) of the KMS symmetric encryption customer managed key to
-    #   use. Otherwise, you get an HTTP `400 Bad Request` error. Only use the
-    #   key ID or key ARN. The key alias format of the KMS key isn't
-    #   supported. Your SSE-KMS configuration can only support 1 [customer
-    #   managed key][1] per directory bucket for the lifetime of the bucket.
-    #   [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
+    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
+    #   header is implicitly assigned the ID of the KMS symmetric encryption
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. If you want to specify the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
+    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
+    #   Request` error. Only use the key ID or key ARN. The key alias format
+    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
+    #   support 1 [customer managed key][1] per directory bucket for the
+    #   lifetime of the bucket. The [Amazon Web Services managed key][2]
+    #   (`aws/s3`) isn't supported.
     #
     #
     #
@@ -3587,7 +3623,7 @@ module Aws::S3
     #   with SSE-KMS and S3 Bucket Keys during the session.
     #
     #   <note markdown="1"> Only 1 [customer managed key][14] is supported per directory bucket
-    #   for the lifetime of the bucket. [Amazon Web Services managed
+    #   for the lifetime of the bucket. The [Amazon Web Services managed
     #   key][15] (`aws/s3`) isn't supported. After you specify SSE-KMS as
     #   your bucket's default encryption configuration with a customer
     #   managed key, you can't change the customer managed key for the
@@ -3679,8 +3715,8 @@ module Aws::S3
     #   the Key ID.
     #
     #   Your SSE-KMS configuration can only support 1 [customer managed
-    #   key][1] per directory bucket for the lifetime of the bucket. [Amazon
-    #   Web Services managed key][2] (`aws/s3`) isn't supported.
+    #   key][1] per directory bucket for the lifetime of the bucket. The
+    #   [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
     #
     #
     #
@@ -3875,7 +3911,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -3941,7 +3977,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4105,7 +4141,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4172,7 +4208,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4237,38 +4273,71 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # Deletes the lifecycle configuration from the specified bucket. Amazon
     # S3 removes all the lifecycle configuration rules in the lifecycle
     # subresource associated with the bucket. Your objects never expire, and
     # Amazon S3 no longer automatically deletes any objects on the basis of
     # rules contained in the deleted lifecycle configuration.
     #
-    # To use this operation, you must have permission to perform the
-    # `s3:PutLifecycleConfiguration` action. By default, the bucket owner
-    # has this permission and the bucket owner can grant this permission to
-    # others.
+    # Permissions
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:PutLifecycleConfiguration` permission.
+    #
+    #     For more information about permissions, see [Managing Access
+    #     Permissions to Your Amazon S3 Resources][1].
+    #   ^
+    #
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:PutLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][2]
+    #     in the *Amazon S3 User Guide*.
+    #
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][3] in the *Amazon
+    #     S3 User Guide*.
     #
-    # There is usually some time lag before lifecycle configuration deletion
-    # is fully propagated to all the Amazon S3 systems.
+    #      </note>
+    # ^
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
     # For more information about the object expiration, see [Elements to
-    # Describe Lifecycle Actions][1].
+    # Describe Lifecycle Actions][4].
     #
     # Related actions include:
     #
-    # * [PutBucketLifecycleConfiguration][2]
+    # * [PutBucketLifecycleConfiguration][5]
     #
-    # * [GetBucketLifecycleConfiguration][3]
+    # * [GetBucketLifecycleConfiguration][6]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.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/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The bucket name of the lifecycle to delete.
@@ -4278,6 +4347,11 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -4305,7 +4379,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4375,7 +4449,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4549,7 +4623,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4619,7 +4693,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4675,7 +4749,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4744,67 +4818,33 @@ module Aws::S3
     end
 
     # Removes an object from a bucket. The behavior depends on the bucket's
-    # versioning state:
-    #
-    # * 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
-    #   specify `null` to the `versionId` query parameter in the request.
-    #
-    # * **Directory buckets** - For directory buckets, you must make
-    #   requests for this API operation to the Zonal endpoint. These
-    #   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][3] in the *Amazon S3 User Guide*.
-    #
-    #  </note>
+    # versioning state. For more information, see [Best practices to
+    # consider before deleting an object][1].
     #
     # To remove a specific version, you must use the `versionId` query
     # parameter. Using this query parameter permanently deletes the version.
     # If the object deleted is a delete marker, Amazon S3 sets the response
-    # header `x-amz-delete-marker` to true.
-    #
-    # If the object you want to delete is in a bucket where the bucket
-    # 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][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.
+    # header `x-amz-delete-marker` to true. If the object you want to delete
+    # is in a bucket where the bucket 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 and to see example requests, see
+    # [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
+    # Guide*.
     #
-    #  </note>
+    # <note markdown="1"> * 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 specify `null` to the
+    #   `versionId` query parameter in the request.
     #
-    # You can delete objects by explicitly calling DELETE Object or calling
-    # ([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.
+    # * For directory buckets, you must make requests for this API operation
+    #   to the Zonal endpoint. These 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][4] in the *Amazon S3 User Guide*.
     #
-    # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
-    # buckets.
+    # * MFA delete is not supported by directory buckets.
     #
     #  </note>
     #
@@ -4816,24 +4856,22 @@ module Aws::S3
     #     * <b> <code>s3:DeleteObject</code> </b> - To delete an object from
     #       a bucket, you must always have the `s3:DeleteObject` permission.
     #
+    #       <note markdown="1"> You can also use PutBucketLifecycle to delete objects in Amazon
+    #       S3.
+    #
+    #        </note>
+    #
     #     * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
     #       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` ][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
-    #     `CreateSession` API call on the bucket to obtain a session token.
-    #     With the session token in your request header, you can make API
-    #     requests to this operation. After the session token expires, you
-    #     make another `CreateSession` API call to generate a new session
-    #     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` ][7].
+    #     * 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` permissions.
+    #   * **Directory buckets permissions** - To grant access to this API
+    #     operation on a directory bucket, we recommend that you use the
+    #     CreateSession API operation for session-based authorization.
     #
     # HTTP Host header syntax
     #
@@ -4842,20 +4880,17 @@ module Aws::S3
     #
     # The following action is related to `DeleteObject`:
     #
-    # * [PutObject][8]
+    # * [PutObject][5]
     #
     # ^
     #
     #
     #
-    # [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
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices
+    # [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/userguide/s3-express-Regions-and-Zones.html
+    # [5]: 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.
@@ -4953,6 +4988,49 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [String] :if_match
+    #   The `If-Match` header field makes the request method conditional on
+    #   ETags. If the ETag value does not match, the operation returns a `412
+    #   Precondition Failed` error. If the ETag matches or if the object
+    #   doesn't exist, the operation will return a `204 Success (No Content)
+    #   response`.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1].
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
+    #   If present, the object is deleted only if its modification times
+    #   matches the provided `Timestamp`. If the `Timestamp` values do not
+    #   match, the operation returns a `412 Precondition Failed` error. If the
+    #   `Timestamp` matches or if the object doesn’t exist, the operation
+    #   returns a `204 Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    # @option params [Integer] :if_match_size
+    #   If present, the object is deleted only if its size matches the
+    #   provided size in bytes. If the `Size` value does not match, the
+    #   operation returns a `412 Precondition Failed` error. If the `Size`
+    #   matches or if the object doesn’t exist, the operation returns a `204
+    #   Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    #   You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
+    #   `x-amz-if-match-size` conditional headers in conjunction with
+    #   each-other or individually.
+    #
     # @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteObjectOutput#delete_marker #delete_marker} => Boolean
@@ -4992,6 +5070,9 @@ module Aws::S3
     #     request_payer: "requester", # accepts requester
     #     bypass_governance_retention: false,
     #     expected_bucket_owner: "AccountId",
+    #     if_match: "IfMatch",
+    #     if_match_last_modified_time: Time.now,
+    #     if_match_size: 1,
     #   })
     #
     # @example Response structure
@@ -5009,7 +5090,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5192,7 +5273,6 @@ module Aws::S3
     #     * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
     #       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
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -5360,13 +5440,13 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * CRC32
+    #   * `CRC32`
     #
-    #   * CRC32C
+    #   * `CRC32C`
     #
-    #   * SHA1
+    #   * `SHA1`
     #
-    #   * SHA256
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -5472,6 +5552,9 @@ module Aws::S3
     #         {
     #           key: "ObjectKey", # required
     #           version_id: "ObjectVersionId",
+    #           etag: "ETag",
+    #           last_modified_time: Time.now,
+    #           size: 1,
     #         },
     #       ],
     #       quiet: false,
@@ -5506,7 +5589,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5563,7 +5646,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5659,7 +5742,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5755,7 +5838,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5841,7 +5924,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6074,7 +6157,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6158,7 +6241,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6247,7 +6330,7 @@ module Aws::S3
     # version of this topic. This topic is provided for backward
     # compatibility.
     #
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6359,34 +6442,65 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
+    # Returns the lifecycle configuration information set on the bucket. For
+    # information about lifecycle configuration, see [Object Lifecycle
+    # Management][1].
     #
-    # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
+    # Bucket lifecycle configuration now supports specifying a lifecycle
     # 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,
+    # the latest API, which is compatible with the new functionality. The
+    # previous version of the API supported filtering based only on an
+    # object key name prefix, which is supported for general purpose buckets
+    # for backward compatibility. For the related API description, see
+    # [GetBucketLifecycle][2].
+    #
+    # <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
+    # objects and cancelling multipart uploads. Expiring of versioned
+    # objects, transitions and tag filters are not supported.
     #
     #  </note>
     #
-    # Returns the lifecycle configuration information set on the bucket. For
-    # information about lifecycle configuration, see [Object Lifecycle
-    # Management][2].
+    # Permissions
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:GetLifecycleConfiguration` permission.
+    #
+    #     For more information about permissions, see [Managing Access
+    #     Permissions to Your Amazon S3 Resources][3].
+    #   ^
     #
-    # To use this operation, you must have permission to perform the
-    # `s3:GetLifecycleConfiguration` action. The bucket owner has this
-    # permission, by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][3] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][4].
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:GetLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][4]
+    #     in the *Amazon S3 User Guide*.
+    #
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][5] in the *Amazon
+    #     S3 User Guide*.
+    #
+    #      </note>
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
     # `GetBucketLifecycleConfiguration` has the following special error:
     #
@@ -6401,20 +6515,21 @@ module Aws::S3
     # The following operations are related to
     # `GetBucketLifecycleConfiguration`:
     #
-    # * [GetBucketLifecycle][1]
+    # * [GetBucketLifecycle][2]
     #
-    # * [PutBucketLifecycle][5]
+    # * [PutBucketLifecycle][6]
     #
-    # * [DeleteBucketLifecycle][6]
+    # * [DeleteBucketLifecycle][7]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which to get the lifecycle information.
@@ -6424,9 +6539,15 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     # @return [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array&lt;Types::LifecycleRule&gt;
+    #   * {Types::GetBucketLifecycleConfigurationOutput#transition_default_minimum_object_size #transition_default_minimum_object_size} => String
     #
     #
     # @example Example: To get lifecycle configuration on a bucket
@@ -6492,6 +6613,7 @@ module Aws::S3
     #   resp.rules[0].noncurrent_version_expiration.noncurrent_days #=> Integer
     #   resp.rules[0].noncurrent_version_expiration.newer_noncurrent_versions #=> Integer
     #   resp.rules[0].abort_incomplete_multipart_upload.days_after_initiation #=> Integer
+    #   resp.transition_default_minimum_object_size #=> String, one of "varies_by_storage_class", "all_storage_classes_128K"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfiguration AWS API Documentation
     #
@@ -6502,7 +6624,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6599,7 +6721,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6658,7 +6780,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6744,7 +6866,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6875,7 +6997,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6990,7 +7112,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7207,7 +7329,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7272,7 +7394,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7395,7 +7517,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7461,7 +7583,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7547,7 +7669,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7624,7 +7746,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7770,7 +7892,6 @@ module Aws::S3
     #
     #     * If you don’t have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Access Denied` error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][4] API operation for session-based
@@ -8246,7 +8367,7 @@ module Aws::S3
     #     content_length: 3191, 
     #     content_type: "image/jpeg", 
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"), 
+    #     last_modified: Time.parse("2016-12-15T01:19:41.000Z"), 
     #     metadata: {
     #     }, 
     #     tag_count: 2, 
@@ -8271,7 +8392,7 @@ module Aws::S3
     #     content_range: "bytes 0-9/43", 
     #     content_type: "text/plain", 
     #     etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"", 
-    #     last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"), 
+    #     last_modified: Time.parse("2014-10-09T22:57:28.000Z"), 
     #     metadata: {
     #     }, 
     #     version_id: "null", 
@@ -8382,7 +8503,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -8604,7 +8725,6 @@ module Aws::S3
     #     * If you don't have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Forbidden` ("access denied")
     #       error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -8691,7 +8811,6 @@ module Aws::S3
     #     * `If-Match` condition evaluates to `true`.
     #
     #     * `If-Unmodified-Since` condition evaluates to `false`.
-    #
     #     For more information about conditional requests, see [RFC
     #     7232][7].
     #
@@ -8702,7 +8821,6 @@ module Aws::S3
     #     * `If-None-Match` condition evaluates to `false`.
     #
     #     * `If-Modified-Since` condition evaluates to `true`.
-    #
     #     For more information about conditional requests, see [RFC
     #     7232][7].
     #
@@ -8928,7 +9046,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9024,7 +9142,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9094,7 +9212,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9191,7 +9309,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9360,7 +9478,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9461,7 +9579,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9737,7 +9855,11 @@ module Aws::S3
     #     have the `s3:GetObject` permission. You need the relevant read
     #     object (or version) permission for this operation. For more
     #     information, see [Actions, resources, and condition keys for
-    #     Amazon S3][2] in the *Amazon S3 User Guide*.
+    #     Amazon S3][2] in the *Amazon S3 User Guide*. For more information
+    #     about the permissions to S3 API operations by S3 resource types,
+    #     see [Required permissions for Amazon S3 API
+    #     operations](/AmazonS3/latest/userguide/using-with-s3-policy-actions.html)
+    #     in the *Amazon S3 User Guide*.
     #
     #     If the object you request doesn't exist, the error that Amazon S3
     #     returns depends on whether you also have the `s3:ListBucket`
@@ -9748,7 +9870,6 @@ module Aws::S3
     #
     #     * If you don’t have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Forbidden` error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -9820,7 +9941,7 @@ module Aws::S3
     #     a `405 Method Not Allowed` error and the `Last-Modified:
     #     timestamp` response header.
     #
-    #   <note markdown="1"> * **Directory buckets** - Delete marker is not supported by
+    #   <note markdown="1"> * **Directory buckets** - Delete marker is not supported for
     #     directory buckets.
     #
     #   * **Directory buckets** - S3 Versioning isn't enabled and supported
@@ -10145,7 +10266,7 @@ module Aws::S3
     #     content_length: 3191, 
     #     content_type: "image/jpeg", 
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"), 
+    #     last_modified: Time.parse("2016-12-15T01:19:41.000Z"), 
     #     metadata: {
     #     }, 
     #     version_id: "null", 
@@ -10231,7 +10352,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10332,7 +10453,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10424,7 +10545,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10526,7 +10647,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10628,17 +10749,26 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
     # Returns a list of all buckets owned by the authenticated sender of the
-    # request. To use this operation, you must have the
-    # `s3:ListAllMyBuckets` permission.
+    # request. To grant IAM permission to use this operation, you must add
+    # the `s3:ListAllMyBuckets` policy action.
     #
     # For information about Amazon S3 buckets, see [Creating, configuring,
     # and working with Amazon S3 buckets][1].
     #
+    # We strongly recommend using only paginated `ListBuckets` requests.
+    # Unpaginated `ListBuckets` requests are only supported for Amazon Web
+    # Services accounts set to the default general purpose bucket quota of
+    # 10,000. If you have an approved general purpose bucket quota above
+    # 10,000, you must send paginated `ListBuckets` requests to list your
+    # account’s buckets. All unpaginated `ListBuckets` requests will be
+    # rejected for Amazon Web Services accounts with a general purpose
+    # bucket quota greater than 10,000.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
@@ -10658,11 +10788,43 @@ module Aws::S3
     #
     #   Required: No.
     #
+    #   <note markdown="1"> If you specify the `bucket-region`, `prefix`, or `continuation-token`
+    #   query parameters without using `max-buckets` to set the maximum number
+    #   of buckets returned in the response, Amazon S3 applies a default page
+    #   size of 10,000 and provides a continuation token if there are more
+    #   buckets.
+    #
+    #    </note>
+    #
+    # @option params [String] :prefix
+    #   Limits the response to bucket names that begin with the specified
+    #   bucket name prefix.
+    #
+    # @option params [String] :bucket_region
+    #   Limits the response to buckets that are located in the specified
+    #   Amazon Web Services Region. The Amazon Web Services Region must be
+    #   expressed according to the Amazon Web Services Region code, such as
+    #   `us-west-2` for the US West (Oregon) Region. For a list of the valid
+    #   values for all of the Amazon Web Services Regions, see [Regions and
+    #   Endpoints][1].
+    #
+    #   <note markdown="1"> Requests made to a Regional endpoint that is different from the
+    #   `bucket-region` parameter are not supported. For example, if you want
+    #   to limit the response to your buckets in Region `us-west-2`, the
+    #   request must be made to an endpoint in Region `us-west-2`.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
+    #
     # @return [Types::ListBucketsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListBucketsOutput#buckets #buckets} => Array&lt;Types::Bucket&gt;
     #   * {Types::ListBucketsOutput#owner #owner} => Types::Owner
     #   * {Types::ListBucketsOutput#continuation_token #continuation_token} => String
+    #   * {Types::ListBucketsOutput#prefix #prefix} => String
     #
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
@@ -10701,6 +10863,8 @@ module Aws::S3
     #   resp = client.list_buckets({
     #     max_buckets: 1,
     #     continuation_token: "Token",
+    #     prefix: "Prefix",
+    #     bucket_region: "BucketRegion",
     #   })
     #
     # @example Response structure
@@ -10708,9 +10872,11 @@ module Aws::S3
     #   resp.buckets #=> Array
     #   resp.buckets[0].name #=> String
     #   resp.buckets[0].creation_date #=> Time
+    #   resp.buckets[0].bucket_region #=> String
     #   resp.owner.display_name #=> String
     #   resp.owner.id #=> String
     #   resp.continuation_token #=> String
+    #   resp.prefix #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBuckets AWS API Documentation
     #
@@ -10751,6 +10917,11 @@ module Aws::S3
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
     #   `s3express-control.region.amazonaws.com`.
     #
+    # <note markdown="1"> The `BucketRegion` response element is not part of the
+    # `ListDirectoryBuckets` Response Syntax.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
@@ -10787,6 +10958,7 @@ module Aws::S3
     #   resp.buckets #=> Array
     #   resp.buckets[0].name #=> String
     #   resp.buckets[0].creation_date #=> Time
+    #   resp.buckets[0].bucket_region #=> String
     #   resp.continuation_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListDirectoryBuckets AWS API Documentation
@@ -10808,7 +10980,7 @@ module Aws::S3
     # multipart uploads are aborted or completed. To delete these
     # in-progress multipart uploads, use the `ListMultipartUploads`
     # operation to list the in-progress multipart uploads in the bucket and
-    # use the `AbortMultupartUpload` operation to abort all the in-progress
+    # use the `AbortMultipartUpload` operation to abort all the in-progress
     # multipart uploads.
     #
     #  </note>
@@ -10881,7 +11053,6 @@ module Aws::S3
     #       initiation time. Among uploads with the same key, the one that
     #       was initiated first will appear before the ones that were
     #       initiated later.
-    #
     #   * **Directory bucket** - In the `ListMultipartUploads` response, the
     #     multipart uploads aren't sorted lexicographically based on the
     #     object keys.
@@ -11238,7 +11409,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -11477,7 +11648,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12371,7 +12542,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12470,7 +12641,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12561,7 +12732,6 @@ module Aws::S3
     #       General Reference.
     #
     #        </note>
-    #
     #     For example, the following `x-amz-grant-write` header grants
     #     create, overwrite, and delete objects permission to LogDelivery
     #     group predefined by Amazon S3 and two Amazon Web Services accounts
@@ -12764,7 +12934,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12802,14 +12972,12 @@ module Aws::S3
     #   * *Code: InvalidArgument*
     #
     #   * *Cause: Invalid argument.*
-    #
     # * * *HTTP Error: HTTP 400 Bad Request*
     #
     #   * *Code: TooManyConfigurations*
     #
     #   * *Cause: You are attempting to create a new configuration but have
     #     already reached the 1,000-configuration limit.*
-    #
     # * * *HTTP Error: HTTP 403 Forbidden*
     #
     #   * *Code: AccessDenied*
@@ -12902,7 +13070,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13111,7 +13279,6 @@ module Aws::S3
     #     encryption][3] to SSE-KMS, you should verify that your KMS key ID
     #     is correct. Amazon S3 doesn't validate the KMS key ID provided in
     #     PutBucketEncryption requests.
-    #
     # * <b>Directory buckets </b> - You can optionally configure default
     #   encryption for a bucket by using server-side encryption with Key
     #   Management Service (KMS) keys (SSE-KMS).
@@ -13126,7 +13293,7 @@ module Aws::S3
     #     object uploads][4].
     #
     #   * Your SSE-KMS configuration can only support 1 [customer managed
-    #     key][5] per directory bucket for the lifetime of the bucket.
+    #     key][5] per directory bucket for the lifetime of the bucket. The
     #     [Amazon Web Services managed key][6] (`aws/s3`) isn't supported.
     #
     #   * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
@@ -13310,7 +13477,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13435,7 +13602,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13587,15 +13754,15 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # For an updated version of this API, see
     # [PutBucketLifecycleConfiguration][1]. This version has been
     # deprecated. Existing lifecycle configurations will work. For new
     # lifecycle configurations, use the updated API.
     #
+    # <note markdown="1"> This operation is not supported for directory buckets.
+    #
+    #  </note>
+    #
     # Creates a new lifecycle configuration for the bucket or replaces an
     # existing lifecycle configuration. For information about lifecycle
     # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
@@ -13738,10 +13905,6 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # Creates a new lifecycle configuration for the bucket or replaces an
     # existing lifecycle configuration. Keep in mind that this will
     # overwrite an existing lifecycle configuration, so if you want to
@@ -13749,23 +13912,30 @@ module Aws::S3
     # lifecycle configuration. For information about lifecycle
     # 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, 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>
-    #
     # Rules
+    # Permissions
+    # HTTP Host header syntax
     #
     # : You specify the lifecycle configuration in your request body. The
     #   lifecycle configuration is specified as XML consisting of one or
     #   more rules. An Amazon S3 Lifecycle configuration can have up to
-    #   1,000 rules. This limit is not adjustable. Each rule consists of the
-    #   following:
+    #   1,000 rules. This limit is not adjustable.
+    #
+    #   Bucket lifecycle configuration supports specifying a lifecycle 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 general purpose buckets.
+    #   For the related API description, see [PutBucketLifecycle][2].
+    #
+    #   <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
+    #   objects and cancelling multipart uploads. Expiring of versioned
+    #   objects,transitions and tag filters are not supported.
+    #
+    #    </note>
+    #
+    #   A lifecycle rule consists of the following:
     #
     #   * A filter identifying a subset of objects to which the rule
     #     applies. The filter can be based on a key name prefix, object
@@ -13783,40 +13953,61 @@ module Aws::S3
     #
     #   For more information, see [Object Lifecycle Management][3] and
     #   [Lifecycle Configuration Elements][4].
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:PutLifecycleConfiguration` permission.
     #
-    # Permissions
+    #     You can also explicitly deny permissions. An explicit deny also
+    #     supersedes any other permissions. If you want to block users or
+    #     accounts from removing or deleting objects from your bucket, you
+    #     must deny them permissions for the following actions:
     #
-    # : By default, all Amazon S3 resources are private, including buckets,
-    #   objects, and related subresources (for example, lifecycle
-    #   configuration and website configuration). Only the resource owner
-    #   (that is, the Amazon Web Services account that created it) can
-    #   access the resource. The resource owner can optionally grant access
-    #   permissions to others by writing an access policy. For this
-    #   operation, a user must get the `s3:PutLifecycleConfiguration`
-    #   permission.
+    #     * `s3:DeleteObject`
     #
-    #   You can also explicitly deny permissions. An explicit deny also
-    #   supersedes any other permissions. If you want to block users or
-    #   accounts from removing or deleting objects from your bucket, you
-    #   must deny them permissions for the following actions:
+    #     * `s3:DeleteObjectVersion`
     #
-    #   * `s3:DeleteObject`
+    #     * `s3:PutLifecycleConfiguration`
     #
-    #   * `s3:DeleteObjectVersion`
+    #       For more information about permissions, see [Managing Access
+    #       Permissions to Your Amazon S3 Resources][5].
+    #   ^
     #
-    #   * `s3:PutLifecycleConfiguration`
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:PutLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][6]
+    #     in the *Amazon S3 User Guide*.
     #
-    #   For more information about permissions, see [Managing Access
-    #   Permissions to Your Amazon S3 Resources][5].
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][7] in the *Amazon
+    #     S3 User Guide*.
     #
-    # The following operations are related to
-    # `PutBucketLifecycleConfiguration`:
+    #      </note>
     #
-    # * [Examples of Lifecycle Configuration][6]
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
-    # * [GetBucketLifecycleConfiguration][7]
+    #   The following operations are related to
+    #   `PutBucketLifecycleConfiguration`:
     #
-    # * [DeleteBucketLifecycle][8]
+    #   * [GetBucketLifecycleConfiguration][8]
+    #
+    #   * [DeleteBucketLifecycle][9]
     #
     #
     #
@@ -13825,9 +14016,10 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which to set the configuration.
@@ -13856,7 +14048,36 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
-    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
+    # @option params [String] :transition_default_minimum_object_size
+    #   Indicates which default minimum object size behavior is applied to the
+    #   lifecycle configuration.
+    #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
+    #   * `all_storage_classes_128K` - Objects smaller than 128 KB will not
+    #     transition to any storage class by default.
+    #
+    #   * `varies_by_storage_class` - Objects smaller than 128 KB will
+    #     transition to Glacier Flexible Retrieval or Glacier Deep Archive
+    #     storage classes. By default, all other storage classes will prevent
+    #     transitions smaller than 128 KB.
+    #
+    #   To customize the minimum object size for any transition you can add a
+    #   filter that specifies a custom `ObjectSizeGreaterThan` or
+    #   `ObjectSizeLessThan` in the body of your transition rule. Custom
+    #   filters always take precedence over the default transition behavior.
+    #
+    # @return [Types::PutBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutBucketLifecycleConfigurationOutput#transition_default_minimum_object_size #transition_default_minimum_object_size} => String
     #
     #
     # @example Example: Put bucket lifecycle
@@ -13948,8 +14169,13 @@ module Aws::S3
     #       ],
     #     },
     #     expected_bucket_owner: "AccountId",
+    #     transition_default_minimum_object_size: "varies_by_storage_class", # accepts varies_by_storage_class, all_storage_classes_128K
     #   })
     #
+    # @example Response structure
+    #
+    #   resp.transition_default_minimum_object_size #=> String, one of "varies_by_storage_class", "all_storage_classes_128K"
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfiguration AWS API Documentation
     #
     # @overload put_bucket_lifecycle_configuration(params = {})
@@ -13959,7 +14185,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14142,7 +14368,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14246,7 +14472,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14332,7 +14558,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14516,7 +14742,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14702,13 +14928,13 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * CRC32
+    #   * `CRC32`
     #
-    #   * CRC32C
+    #   * `CRC32C`
     #
-    #   * SHA1
+    #   * `SHA1`
     #
-    #   * SHA256
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -14785,7 +15011,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15023,7 +15249,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15120,7 +15346,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15271,15 +15497,17 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
     # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
-    # take a short amount of time for the change to be fully propagated. We
-    # recommend that you wait for 15 minutes after enabling versioning
-    # before issuing write operations (`PUT` or `DELETE`) on objects in the
-    # bucket.
+    # take a short amount of time for the change to be fully propagated.
+    # While this change is propagating, you may encounter intermittent `HTTP
+    # 404 NoSuchKey` errors for requests to objects created or updated after
+    # enabling versioning. We recommend that you wait for 15 minutes after
+    # enabling versioning before issuing write operations (`PUT` or
+    # `DELETE`) on objects in the bucket.
     #
     #  </note>
     #
@@ -15410,7 +15638,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15660,7 +15888,6 @@ module Aws::S3
     #     * <b> <code>s3:PutObjectTagging</code> </b> - To successfully set
     #       the tag-set with your `PutObject` request, you must have the
     #       `s3:PutObjectTagging`.
-    #
     #   * **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
@@ -15847,10 +16074,11 @@ module Aws::S3
     #   information about REST request authentication, see [REST
     #   Authentication][1].
     #
-    #   <note markdown="1"> The `Content-MD5` header is required for any request to upload an
-    #   object with a retention period configured using Amazon S3 Object Lock.
-    #   For more information about Amazon S3 Object Lock, see [Amazon S3
-    #   Object Lock Overview][2] in the *Amazon S3 User Guide*.
+    #   <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
+    #   for any request to upload an object with a retention period configured
+    #   using Amazon S3 Object Lock. For more information, see [Uploading
+    #   objects to an Object Lock enabled bucket ][2] in the *Amazon S3 User
+    #   Guide*.
     #
     #    </note>
     #
@@ -15861,7 +16089,7 @@ module Aws::S3
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
-    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
     #
     # @option params [String] :content_type
     #   A standard MIME type describing the format of the contents. For more
@@ -15883,13 +16111,13 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * CRC32
+    #   * `CRC32`
     #
-    #   * CRC32C
+    #   * `CRC32C`
     #
-    #   * SHA1
+    #   * `SHA1`
     #
-    #   * SHA256
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -15900,21 +16128,28 @@ module Aws::S3
     #   provided `ChecksumAlgorithm` parameter and uses the checksum algorithm
     #   that matches the provided value in `x-amz-checksum-algorithm `.
     #
-    #   <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
-    #   is the default checksum algorithm that's used for performance.
+    #   <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is required
+    #   for any request to upload an object with a retention period configured
+    #   using Amazon S3 Object Lock. For more information, see [Uploading
+    #   objects to an Object Lock enabled bucket ][2] in the *Amazon S3 User
+    #   Guide*.
     #
     #    </note>
     #
+    #   For directory buckets, when you use Amazon Web Services SDKs, `CRC32`
+    #   is the default checksum algorithm that's used for performance.
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
     #
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32 checksum of the object. For
-    #   more information, see [Checking object integrity][1] in the *Amazon S3
-    #   User Guide*.
+    #   specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
+    #   For more information, see [Checking object integrity][1] in the
+    #   *Amazon S3 User Guide*.
     #
     #
     #
@@ -15923,7 +16158,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32C checksum of the object.
+    #   specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -15962,6 +16197,26 @@ module Aws::S3
     #
     #   [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
     #
+    # @option params [String] :if_match
+    #   Uploads the object only if the ETag (entity tag) value provided during
+    #   the WRITE operation matches the ETag of the object in S3. If the ETag
+    #   values do not match, the operation returns a `412 Precondition Failed`
+    #   error.
+    #
+    #   If a conflicting operation occurs during the upload S3 returns a `409
+    #   ConditionalRequestConflict` response. On a 409 failure you should
+    #   fetch the object's ETag and retry the upload.
+    #
+    #   Expects the ETag value as a string.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1], or
+    #   [Conditional requests][2] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/rfc7232
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
+    #
     # @option params [String] :if_none_match
     #   Uploads the object only if the object key name does not already exist
     #   in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -16021,6 +16276,17 @@ module Aws::S3
     # @option params [required, String] :key
     #   Object key for which the PUT action was initiated.
     #
+    # @option params [Integer] :write_offset_bytes
+    #   Specifies the offset for appending data to existing objects in bytes.
+    #   The offset must be equal to the size of the existing object being
+    #   appended to. If no object exists, setting this header to 0 will create
+    #   a new object.
+    #
+    #   <note markdown="1"> This functionality is only supported for objects in the Amazon S3
+    #   Express One Zone storage class in directory buckets.
+    #
+    #    </note>
+    #
     # @option params [Hash<String,String>] :metadata
     #   A map of metadata to store with the object in S3.
     #
@@ -16181,14 +16447,19 @@ module Aws::S3
     #   Amazon Web Services managed key (`aws/s3`) to protect the data.
     #
     #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, you must specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header with the ID (Key
-    #   ID or Key ARN) of the KMS symmetric encryption customer managed key to
-    #   use. Otherwise, you get an HTTP `400 Bad Request` error. Only use the
-    #   key ID or key ARN. The key alias format of the KMS key isn't
-    #   supported. Your SSE-KMS configuration can only support 1 [customer
-    #   managed key][1] per directory bucket for the lifetime of the bucket.
-    #   [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
+    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
+    #   header is implicitly assigned the ID of the KMS symmetric encryption
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. If you want to specify the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
+    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
+    #   customer managed key that's configured for your directory bucket's
+    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
+    #   Request` error. Only use the key ID or key ARN. The key alias format
+    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
+    #   support 1 [customer managed key][1] per directory bucket for the
+    #   lifetime of the bucket. The [Amazon Web Services managed key][2]
+    #   (`aws/s3`) isn't supported.
     #
     #
     #
@@ -16318,99 +16589,84 @@ module Aws::S3
     #   * {Types::PutObjectOutput#ssekms_key_id #ssekms_key_id} => String
     #   * {Types::PutObjectOutput#ssekms_encryption_context #ssekms_encryption_context} => String
     #   * {Types::PutObjectOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
+    #   * {Types::PutObjectOutput#size #size} => Integer
     #   * {Types::PutObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To upload an object and specify optional tags
-    #
-    #   # 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: "c:\\HappyFace.jpg", 
-    #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     tagging: "key1=value1&key2=value2", 
-    #   })
-    #
-    #   resp.to_h outputs the following:
-    #   {
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
-    #   }
-    #
-    # @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 object and specify user-defined metadata
+    # @example Example: To upload an 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.
+    #   # 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", 
-    #     metadata: {
-    #       "metadata1" => "value1", 
-    #       "metadata2" => "value2", 
-    #     }, 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
+    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
     #   }
     #
-    # @example Example: To upload an object
+    # @example Example: To upload an object and specify optional tags
     #
-    #   # 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 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: "HappyFace.jpg", 
+    #     body: "c:\\HappyFace.jpg", 
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
     #   }
     #
-    # @example Example: To upload an object and specify server-side encryption and object tags
+    # @example Example: To upload object and specify user-defined metadata
     #
-    #   # 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 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: "filetoupload", 
     #     bucket: "examplebucket", 
     #     key: "exampleobject", 
-    #     server_side_encryption: "AES256", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     metadata: {
+    #       "metadata1" => "value1", 
+    #       "metadata2" => "value2", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
     # @example Example: To upload an object and specify canned ACL.
@@ -16451,6 +16707,22 @@ module Aws::S3
     #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
+    # @example Example: To create an object.
+    #
+    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+    #
+    #   resp = client.put_object({
+    #     body: "filetoupload", 
+    #     bucket: "examplebucket", 
+    #     key: "objectkey", 
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
+    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
+    #   }
+    #
     # @example Streaming a file from disk
     #   # upload file from disk in a single request, may not exceed 5GB
     #   File.open('/source/file/path', 'rb') do |file|
@@ -16476,12 +16748,14 @@ module Aws::S3
     #     checksum_sha1: "ChecksumSHA1",
     #     checksum_sha256: "ChecksumSHA256",
     #     expires: Time.now,
+    #     if_match: "IfMatch",
     #     if_none_match: "IfNoneMatch",
     #     grant_full_control: "GrantFullControl",
     #     grant_read: "GrantRead",
     #     grant_read_acp: "GrantReadACP",
     #     grant_write_acp: "GrantWriteACP",
     #     key: "ObjectKey", # required
+    #     write_offset_bytes: 1,
     #     metadata: {
     #       "MetadataKey" => "MetadataValue",
     #     },
@@ -16517,6 +16791,7 @@ module Aws::S3
     #   resp.ssekms_key_id #=> String
     #   resp.ssekms_encryption_context #=> String
     #   resp.bucket_key_enabled #=> Boolean
+    #   resp.size #=> Integer
     #   resp.request_charged #=> String, one of "requester"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject AWS API Documentation
@@ -16528,7 +16803,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -16612,7 +16887,6 @@ module Aws::S3
     #       General Reference.
     #
     #        </note>
-    #
     #     For example, the following `x-amz-grant-read` header grants list
     #     objects permission to the two Amazon Web Services accounts
     #     identified by their email addresses.
@@ -16898,7 +17172,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17017,7 +17291,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17136,7 +17410,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17265,7 +17539,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17464,7 +17738,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17572,14 +17846,10 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
-    # The `SELECT` job type for the RestoreObject operation is no longer
-    # available to new customers. Existing customers of Amazon S3 Select can
-    # continue to use the feature as usual. [Learn more][1]
-    #
     # Restores an archived copy of an object back into Amazon S3
     #
     # This functionality is not supported for Amazon S3 on Outposts.
@@ -17593,11 +17863,11 @@ module Aws::S3
     # For more information about the `S3` structure in the request body, see
     # the following:
     #
-    # * [PutObject][2]
+    # * [PutObject][1]
     #
-    # * [Managing Access with ACLs][3] in the *Amazon S3 User Guide*
+    # * [Managing Access with ACLs][2] in the *Amazon S3 User Guide*
     #
-    # * [Protecting Data Using Server-Side Encryption][4] in the *Amazon S3
+    # * [Protecting Data Using Server-Side Encryption][3] in the *Amazon S3
     #   User Guide*
     #
     # Permissions
@@ -17606,8 +17876,8 @@ module Aws::S3
     #   `s3:RestoreObject` action. The bucket owner has this permission by
     #   default and can grant this permission to others. For more
     #   information about permissions, see [Permissions Related to Bucket
-    #   Subresource Operations][5] and [Managing Access Permissions to Your
-    #   Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
+    #   Subresource Operations][4] and [Managing Access Permissions to Your
+    #   Amazon S3 Resources][5] in the *Amazon S3 User Guide*.
     #
     # Restoring objects
     #
@@ -17670,11 +17940,11 @@ module Aws::S3
     #
     #   For more information about archive retrieval options and provisioned
     #   capacity for `Expedited` data access, see [Restoring Archived
-    #   Objects][7] in the *Amazon S3 User Guide*.
+    #   Objects][6] in the *Amazon S3 User Guide*.
     #
     #   You can use Amazon S3 restore speed upgrade to change the restore
     #   speed to a faster speed while it is in progress. For more
-    #   information, see [ Upgrading the speed of an in-progress restore][8]
+    #   information, see [ Upgrading the speed of an in-progress restore][7]
     #   in the *Amazon S3 User Guide*.
     #
     #   To get the status of object restoration, you can send a `HEAD`
@@ -17682,7 +17952,7 @@ module Aws::S3
     #   provides information about the restoration status, in the response.
     #   You can use Amazon S3 event notifications to notify you when a
     #   restore is initiated or completed. For more information, see
-    #   [Configuring Amazon S3 Event Notifications][9] in the *Amazon S3
+    #   [Configuring Amazon S3 Event Notifications][8] in the *Amazon S3
     #   User Guide*.
     #
     #   After restoring an archived object, you can update the restoration
@@ -17698,8 +17968,8 @@ module Aws::S3
     #   restore an object copy for 10 days, but the object is scheduled to
     #   expire in 3 days, Amazon S3 deletes the object in 3 days. For more
     #   information about lifecycle configuration, see
-    #   [PutBucketLifecycleConfiguration][10] and [Object Lifecycle
-    #   Management][11] in *Amazon S3 User Guide*.
+    #   [PutBucketLifecycleConfiguration][9] and [Object Lifecycle
+    #   Management][10] in *Amazon S3 User Guide*.
     #
     # Responses
     #
@@ -17722,7 +17992,6 @@ module Aws::S3
     #     * *HTTP Status Code: 409 Conflict*
     #
     #     * *SOAP Fault Code Prefix: Client*
-    #
     #   * * *Code: GlacierExpeditedRetrievalNotAvailable*
     #
     #     * *Cause: expedited retrievals are currently not available. Try
@@ -17737,24 +18006,23 @@ module Aws::S3
     #
     # The following operations are related to `RestoreObject`:
     #
-    # * [PutBucketLifecycleConfiguration][10]
+    # * [PutBucketLifecycleConfiguration][9]
     #
-    # * [GetBucketNotificationConfiguration][12]
+    # * [GetBucketNotificationConfiguration][11]
     #
     #
     #
-    # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The bucket name containing the object to restore.
@@ -17962,14 +18230,10 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
-    # The SelectObjectContent operation is no longer available to new
-    # customers. Existing customers of Amazon S3 Select can continue to use
-    # the operation as usual. [Learn more][1]
-    #
     # This action filters the contents of an Amazon S3 object based on a
     # simple structured query language (SQL) statement. In the request,
     # along with the SQL expression, you must also specify a data
@@ -17981,7 +18245,7 @@ module Aws::S3
     # This functionality is not supported for Amazon S3 on Outposts.
     #
     # For more information about Amazon S3 Select, see [Selecting Content
-    # from Objects][2] and [SELECT Command][3] in the *Amazon S3 User
+    # from Objects][1] and [SELECT Command][2] in the *Amazon S3 User
     # Guide*.
     #
     #
@@ -17991,7 +18255,7 @@ module Aws::S3
     # : You must have the `s3:GetObject` permission for this
     #   operation. Amazon S3 Select does not support anonymous access. For
     #   more information about permissions, see [Specifying Permissions in a
-    #   Policy][4] in the *Amazon S3 User Guide*.
+    #   Policy][3] in the *Amazon S3 User Guide*.
     #
     # Object Data Formats
     #
@@ -18016,31 +18280,31 @@ module Aws::S3
     #
     #     For objects that are encrypted with customer-provided encryption
     #     keys (SSE-C), you must use HTTPS, and you must use the headers
-    #     that are documented in the [GetObject][5]. For more information
+    #     that are documented in the [GetObject][4]. For more information
     #     about SSE-C, see [Server-Side Encryption (Using Customer-Provided
-    #     Encryption Keys)][6] in the *Amazon S3 User Guide*.
+    #     Encryption Keys)][5] in the *Amazon S3 User Guide*.
     #
     #     For objects that are encrypted with Amazon S3 managed keys
     #     (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS), server-side
     #     encryption is handled transparently, so you don't need to specify
     #     anything. For more information about server-side encryption,
     #     including SSE-S3 and SSE-KMS, see [Protecting Data Using
-    #     Server-Side Encryption][7] in the *Amazon S3 User Guide*.
+    #     Server-Side Encryption][6] in the *Amazon S3 User Guide*.
     #
     # Working with the Response Body
     #
     # : Given the response size is unknown, Amazon S3 Select streams the
     #   response as a series of messages and includes a `Transfer-Encoding`
     #   header with `chunked` as its value in the response. For more
-    #   information, see [Appendix: SelectObjectContent Response][8].
+    #   information, see [Appendix: SelectObjectContent Response][7].
     #
     # GetObject Support
     #
     # : The `SelectObjectContent` action does not support the following
-    #   `GetObject` functionality. For more information, see [GetObject][5].
+    #   `GetObject` functionality. For more information, see [GetObject][4].
     #
     #   * `Range`: Although you can specify a scan range for an Amazon S3
-    #     Select request (see [SelectObjectContentRequest - ScanRange][9] in
+    #     Select request (see [SelectObjectContentRequest - ScanRange][8] in
     #     the request parameters), you cannot specify the range of bytes of
     #     an object to return.
     #
@@ -18051,37 +18315,36 @@ module Aws::S3
     #     storage classes, nor objects in the `ARCHIVE_ACCESS` or
     #     `DEEP_ARCHIVE_ACCESS` access tiers of the `INTELLIGENT_TIERING`
     #     storage class. For more information about storage classes, see
-    #     [Using Amazon S3 storage classes][10] in the *Amazon S3 User
+    #     [Using Amazon S3 storage classes][9] in the *Amazon S3 User
     #     Guide*.
     #
     # Special Errors
     #
     # : For a list of special errors for this operation, see [List of SELECT
-    #   Object Content Error Codes][11]
+    #   Object Content Error Codes][10]
     #
     # The following operations are related to `SelectObjectContent`:
     #
-    # * [GetObject][5]
+    # * [GetObject][4]
     #
-    # * [GetBucketLifecycleConfiguration][12]
+    # * [GetBucketLifecycleConfiguration][11]
     #
-    # * [PutBucketLifecycleConfiguration][13]
+    # * [PutBucketLifecycleConfiguration][12]
     #
     #
     #
-    # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The S3 bucket.
@@ -18515,7 +18778,6 @@ module Aws::S3
     #     * x-amz-server-side-encryption-customer-key
     #
     #     * x-amz-server-side-encryption-customer-key-MD5
-    #
     #     For more information, see [Using Server-Side Encryption][11] in
     #     the *Amazon S3 User Guide*.
     #
@@ -18652,9 +18914,9 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32 checksum of the object. For
-    #   more information, see [Checking object integrity][1] in the *Amazon S3
-    #   User Guide*.
+    #   specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
+    #   For more information, see [Checking object integrity][1] in the
+    #   *Amazon S3 User Guide*.
     #
     #
     #
@@ -18663,7 +18925,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the base64-encoded, 32-bit CRC32C checksum of the object.
+    #   specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -18916,7 +19178,6 @@ module Aws::S3
     #       permissions required to use the multipart upload API, see
     #       [Multipart upload and permissions][8] and [Multipart upload API
     #       and permissions][9] in the *Amazon S3 User Guide*.
-    #
     #   * **Directory bucket permissions** - You must have permissions in a
     #     bucket policy or an IAM identity-based policy based on the source
     #     and destination bucket types in an `UploadPartCopy` operation.
@@ -18934,7 +19195,6 @@ module Aws::S3
     #       `Action` element of a policy to write the object to the
     #       destination. The `s3express:SessionMode` condition key cannot be
     #       set to `ReadOnly` on the copy destination.
-    #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
     #     identity-based policies and KMS key policies for the KMS key.
@@ -18979,7 +19239,6 @@ module Aws::S3
     #       been aborted or completed.
     #
     #     * HTTP Status Code: 404 Not Found
-    #
     #   * Error Code: `InvalidRequest`
     #
     #     * Description: The specified copy source is not supported as a
@@ -19312,45 +19571,45 @@ module Aws::S3
     #   * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
     #
     #
-    # @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"), 
     #     }, 
     #   }
     #
-    # @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"), 
     #     }, 
     #   }
     #
@@ -19403,7 +19662,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -19549,7 +19808,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the base64-encoded, 32-bit CRC32 checksum of the object
+    #   specifies the base64-encoded, 32-bit CRC-32 checksum of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -19569,7 +19828,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the base64-encoded, 32-bit CRC32C checksum of the object
+    #   specifies the base64-encoded, 32-bit CRC-32C checksum of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -19812,7 +20071,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.166.0'
+      context[:gem_version] = '1.174.0'
       Seahorse::Client::Request.new(handlers, context)
     end