aws-sdk-s3 1.172.0 → 1.176.0

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

@@ -577,20 +577,24 @@ module Aws::S3
     # * **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][2] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][2] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][3] in the *Amazon
+    #   S3 User Guide*.
     #
     #  </note>
     #
     # Permissions
     # : * **General purpose bucket permissions** - For information about
     #     permissions required to use the multipart upload, see [Multipart
-    #     Upload and Permissions][3] in the *Amazon S3 User Guide*.
+    #     Upload and Permissions][4] in the *Amazon S3 User Guide*.
     #
     #   * **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
+    #     `CreateSession` ][5] 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
@@ -601,45 +605,46 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][4].
+    #     authorization, see [ `CreateSession` ][5].
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `AbortMultipartUpload`:
     #
-    # * [CreateMultipartUpload][5]
+    # * [CreateMultipartUpload][6]
     #
-    # * [UploadPart][6]
+    # * [UploadPart][7]
     #
-    # * [CompleteMultipartUpload][7]
+    # * [CompleteMultipartUpload][8]
     #
     # * [ListParts][1]
     #
-    # * [ListMultipartUploads][8]
+    # * [ListMultipartUploads][9]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [required, String] :bucket
     #   The bucket name to which the upload was taking place.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -703,6 +708,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 +747,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
@@ -792,19 +810,23 @@ module Aws::S3
     # <note markdown="1"> **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][5] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][5] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
     # Permissions
     # : * **General purpose bucket permissions** - For information about
     #     permissions required to use the multipart upload API, see
-    #     [Multipart Upload and Permissions][6] in the *Amazon S3 User
+    #     [Multipart Upload and Permissions][7] in the *Amazon S3 User
     #     Guide*.
     #
-    #     If you provide an [additional checksum value][7] in your
+    #     If you provide an [additional checksum value][8] in your
     #     `MultipartUpload` requests and the object is encrypted with Key
     #     Management Service, you must have permission to use the
     #     `kms:Decrypt` action for the `CompleteMultipartUpload` request to
@@ -812,7 +834,7 @@ module Aws::S3
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][8] API operation for session-based
+    #     `CreateSession` ][9] 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
@@ -823,7 +845,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][8].
+    #     authorization, see [ `CreateSession` ][9].
     #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -861,19 +883,19 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `CompleteMultipartUpload`:
     #
-    # * [CreateMultipartUpload][9]
+    # * [CreateMultipartUpload][10]
     #
     # * [UploadPart][1]
     #
-    # * [AbortMultipartUpload][10]
+    # * [AbortMultipartUpload][11]
     #
-    # * [ListParts][11]
+    # * [ListParts][12]
     #
-    # * [ListMultipartUploads][12]
+    # * [ListMultipartUploads][13]
     #
     #
     #
@@ -882,23 +904,24 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [required, String] :bucket
     #   Name of the bucket to which the multipart upload was initiated.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -1009,6 +1032,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
@@ -1144,6 +1188,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",
@@ -1197,9 +1242,13 @@ module Aws::S3
     # * <b>Directory buckets </b> - 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][2] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][2] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][3] in the *Amazon
+    #   S3 User Guide*.
     #
     # * VPC endpoints don't support cross-Region requests (including
     #   copies). If you're using VPC endpoints, your source and destination
@@ -1211,13 +1260,13 @@ module Aws::S3
     # Both the Region that you want to copy the object from and the Region
     # that you want to copy the object to must be enabled for your account.
     # For more information about how to enable a Region for your account,
-    # see [Enable or disable a Region for standalone accounts][3] in the
+    # see [Enable or disable a Region for standalone accounts][4] in the
     # *Amazon Web Services Account Management Guide*.
     #
     # Amazon S3 transfer acceleration does not support cross-Region copies.
     # If you request a cross-Region copy using a transfer acceleration
     # endpoint, you get a `400 Bad Request` error. For more information, see
-    # [Transfer Acceleration][4].
+    # [Transfer Acceleration][5].
     #
     # Authentication and authorization
     #
@@ -1225,7 +1274,7 @@ module Aws::S3
     #   IAM credentials (access key ID and secret access key for the IAM
     #   identities). All headers with the `x-amz-` prefix, including
     #   `x-amz-copy-source`, must be signed. For more information, see [REST
-    #   Authentication][5].
+    #   Authentication][6].
     #
     #   **Directory buckets** - You must use the IAM credentials to
     #   authenticate and authorize your access to the `CopyObject` API
@@ -1273,9 +1322,9 @@ module Aws::S3
     #     identity-based policies and KMS key policies for the KMS key.
     #
     #     For example policies, see [Example bucket policies for S3 Express
-    #     One Zone][6] and [Amazon Web Services Identity and Access
+    #     One Zone][7] and [Amazon Web Services Identity and Access
     #     Management (IAM) identity-based policies for S3 Express One
-    #     Zone][7] in the *Amazon S3 User Guide*.
+    #     Zone][8] in the *Amazon S3 User Guide*.
     #
     # Response and special errors
     #
@@ -1298,7 +1347,7 @@ module Aws::S3
     #       response is embedded in the `200 OK` response. For example, in a
     #       cross-region copy, you may encounter throttling and receive a
     #       `200 OK` response. For more information, see [Resolve the Error
-    #       200 response when copying objects to Amazon S3][8]. The `200 OK`
+    #       200 response when copying objects to Amazon S3][9]. The `200 OK`
     #       status code means the copy was accepted, but it doesn't mean
     #       the copy is complete. Another example is when you disconnect
     #       from Amazon S3 before the copy is complete, Amazon S3 might
@@ -1322,32 +1371,33 @@ module Aws::S3
     #   result in a data retrieval charge for the source if the source
     #   storage class bills for data retrieval. If the copy source is in a
     #   different region, the data transfer is billed to the copy source
-    #   account. For pricing information, see [Amazon S3 pricing][9].
+    #   account. For pricing information, see [Amazon S3 pricing][10].
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `CopyObject`:
     #
-    # * [PutObject][10]
+    # * [PutObject][11]
     #
-    # * [GetObject][11]
+    # * [GetObject][12]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjctsUsingRESTMPUapi.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [3]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
-    # [8]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
-    # [9]: http://aws.amazon.com/s3/pricing/
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [4]: https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html#manage-acct-regions-enable-standalone
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
+    # [9]: https://repost.aws/knowledge-center/s3-resolve-200-internalerror
+    # [10]: http://aws.amazon.com/s3/pricing/
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
     #
     # @option params [String] :acl
     #   The canned access control list (ACL) to apply to the object.
@@ -1387,14 +1437,22 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
+    #   <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
+    #   supported when the source or destination bucket is in Amazon Web
+    #   Services Local Zones. The source and destination buckets must have the
+    #   same parent Amazon Web Services Region. Otherwise, you get an HTTP
+    #   `400 Bad Request` error with the error code `InvalidRequest`.
+    #
+    #    </note>
+    #
     #   **Access points** - When you use this action with an access point, you
     #   must provide the alias of the access point in place of the bucket name
     #   or specify the access point ARN. When using the access point ARN, you
@@ -2247,10 +2305,13 @@ module Aws::S3
     # * <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 `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. For more
-    #   information, see [Regional and Zonal endpoints][4] in the *Amazon S3
-    #   User Guide*.
+    #   information about endpoints in Availability Zones, see [Regional and
+    #   Zonal endpoints for directory buckets in Availability Zones][4] in
+    #   the *Amazon S3 User Guide*. For more information about endpoints in
+    #   Local Zones, see [Available Local Zone for directory buckets][5] in
+    #   the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -2292,17 +2353,17 @@ module Aws::S3
     #       disabled. If you would like to share data with users outside of
     #       your account, you can use bucket policies as needed. For more
     #       information, see [Controlling ownership of objects and disabling
-    #       ACLs for your bucket ][5] and [Blocking public access to your
-    #       Amazon S3 storage ][6] in the *Amazon S3 User Guide*.
+    #       ACLs for your bucket ][6] and [Blocking public access to your
+    #       Amazon S3 storage ][7] in the *Amazon S3 User Guide*.
     #
     #     * **S3 Block Public Access** - If your specific use case requires
     #       granting public access to your S3 resources, you can disable
     #       Block Public Access. Specifically, you can create a new bucket
     #       with Block Public Access enabled, then separately call the [
-    #       `DeletePublicAccessBlock` ][7] API. To use this operation, you
+    #       `DeletePublicAccessBlock` ][8] API. To use this operation, you
     #       must have the `s3:PutBucketPublicAccessBlock` permission. For
     #       more information about S3 Block Public Access, see [Blocking
-    #       public access to your Amazon S3 storage ][6] in the *Amazon S3
+    #       public access to your Amazon S3 storage ][7] in the *Amazon S3
     #       User Guide*.
     #   * **Directory bucket permissions** - You must have the
     #     `s3express:CreateBucket` permission in an IAM identity-based
@@ -2311,7 +2372,7 @@ module Aws::S3
     #     performed by the Amazon Web Services account that owns the
     #     resource. For more information about directory bucket policies and
     #     permissions, see [Amazon Web Services Identity and Access
-    #     Management (IAM) for S3 Express One Zone][8] in the *Amazon S3
+    #     Management (IAM) for S3 Express One Zone][9] in the *Amazon S3
     #     User Guide*.
     #
     #     The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2321,21 +2382,21 @@ module Aws::S3
     #     enforced (ACLs disabled). These settings can't be modified.
     #
     #      For more information about permissions for creating and working
-    #     with directory buckets, see [Directory buckets][9] in the *Amazon
+    #     with directory buckets, see [Directory buckets][10] in the *Amazon
     #     S3 User Guide*. For more information about supported S3 features
-    #     for directory buckets, see [Features of S3 Express One Zone][10]
+    #     for directory buckets, see [Features of S3 Express One Zone][11]
     #     in the *Amazon S3 User Guide*.
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `CreateBucket`:
     #
-    # * [PutObject][11]
+    # * [PutObject][12]
     #
-    # * [DeleteBucket][12]
+    # * [DeleteBucket][13]
     #
     #
     #
@@ -2343,14 +2404,15 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
     #
     # @option params [String] :acl
     #   The canned ACL to apply to the bucket.
@@ -2368,13 +2430,14 @@ module Aws::S3
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][2] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][2] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -2508,11 +2571,11 @@ module Aws::S3
     #     create_bucket_configuration: {
     #       location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-south-2, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
     #       location: {
-    #         type: "AvailabilityZone", # accepts AvailabilityZone
+    #         type: "AvailabilityZone", # accepts AvailabilityZone, LocalZone
     #         name: "LocationNameAsString",
     #       },
     #       bucket: {
-    #         data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone
+    #         data_redundancy: "SingleAvailabilityZone", # accepts SingleAvailabilityZone, SingleLocalZone
     #         type: "Directory", # accepts Directory
     #       },
     #     },
@@ -2538,6 +2601,90 @@ module Aws::S3
       req.send_request(options)
     end
 
+    # Creates a metadata table configuration for a general purpose bucket.
+    # For more information, see [Accelerating data discovery with S3
+    # Metadata][1] in the *Amazon S3 User Guide*.
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have the following permissions. For
+    #   more information, see [Setting up permissions for configuring
+    #   metadata tables][2] in the *Amazon S3 User Guide*.
+    #
+    #   If you also want to integrate your table bucket with Amazon Web
+    #   Services analytics services so that you can query your metadata
+    #   table, you need additional permissions. For more information, see [
+    #   Integrating Amazon S3 Tables with Amazon Web Services analytics
+    #   services][3] in the *Amazon S3 User Guide*.
+    #
+    #   * `s3:CreateBucketMetadataTableConfiguration`
+    #
+    #   * `s3tables:CreateNamespace`
+    #
+    #   * `s3tables:GetTable`
+    #
+    #   * `s3tables:CreateTable`
+    #
+    #   * `s3tables:PutTablePolicy`
+    #
+    # The following operations are related to
+    # `CreateBucketMetadataTableConfiguration`:
+    #
+    # * [DeleteBucketMetadataTableConfiguration][4]
+    #
+    # * [GetBucketMetadataTableConfiguration][5]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-integrating-aws.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
+    #
+    # @option params [required, String] :bucket
+    #   The general purpose bucket that you want to create the metadata table
+    #   configuration in.
+    #
+    # @option params [String] :content_md5
+    #   The `Content-MD5` header for the metadata table configuration.
+    #
+    # @option params [String] :checksum_algorithm
+    #   The checksum algorithm to use with your metadata table configuration.
+    #
+    # @option params [required, Types::MetadataTableConfiguration] :metadata_table_configuration
+    #   The contents of your metadata table configuration.
+    #
+    # @option params [String] :expected_bucket_owner
+    #   The expected owner of the general purpose bucket that contains your
+    #   metadata table configuration.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_bucket_metadata_table_configuration({
+    #     bucket: "BucketName", # required
+    #     content_md5: "ContentMD5",
+    #     checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
+    #     metadata_table_configuration: { # required
+    #       s3_tables_destination: { # required
+    #         table_bucket_arn: "S3TablesBucketArn", # required
+    #         table_name: "S3TablesName", # required
+    #       },
+    #     },
+    #     expected_bucket_owner: "AccountId",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketMetadataTableConfiguration AWS API Documentation
+    #
+    # @overload create_bucket_metadata_table_configuration(params = {})
+    # @param [Hash] params ({})
+    def create_bucket_metadata_table_configuration(params = {}, options = {})
+      req = build_request(:create_bucket_metadata_table_configuration, params)
+      req.send_request(options)
+    end
+
     # This action initiates a multipart upload and returns an upload ID.
     # This upload ID is used to associate all of the parts in the specific
     # multipart upload. You specify this upload ID in each of your
@@ -2569,9 +2716,13 @@ module Aws::S3
     # * <b>Directory buckets </b> - 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*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][4] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][5] in the *Amazon
+    #   S3 User Guide*.
     #
     #  </note>
     #
@@ -2583,7 +2734,7 @@ module Aws::S3
     #   sign each request individually. There is nothing special about
     #   signing multipart upload requests. For more information about
     #   signing, see [Authenticating Requests (Amazon Web Services Signature
-    #   Version 4)][5] in the *Amazon S3 User Guide*.
+    #   Version 4)][6] in the *Amazon S3 User Guide*.
     #
     # Permissions
     # : * **General purpose bucket permissions** - To perform a multipart
@@ -2596,13 +2747,13 @@ module Aws::S3
     #     `UploadPartCopy` APIs. These permissions are required because
     #     Amazon S3 must decrypt and read data from the encrypted file parts
     #     before it completes the multipart upload. For more information,
-    #     see [Multipart upload API and permissions][6] and [Protecting data
-    #     using server-side encryption with Amazon Web Services KMS][7] in
+    #     see [Multipart upload API and permissions][7] and [Protecting data
+    #     using server-side encryption with Amazon Web Services KMS][8] in
     #     the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][8] API operation for session-based
+    #     `CreateSession` ][9] 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
@@ -2613,7 +2764,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][8].
+    #     authorization, see [ `CreateSession` ][9].
     #
     # Encryption
     # : * **General purpose buckets** - Server-side encryption is for data
@@ -2640,7 +2791,7 @@ module Aws::S3
     #     the destination bucket, the encryption setting in your request
     #     takes precedence. If you choose to provide your own encryption
     #     key, the request headers you provide in [UploadPart][1] and
-    #     [UploadPartCopy][9] requests must match the headers you used in
+    #     [UploadPartCopy][10] requests must match the headers you used in
     #     the `CreateMultipartUpload` request.
     #
     #     * Use KMS keys (SSE-KMS) that include the Amazon Web Services
@@ -2665,9 +2816,9 @@ module Aws::S3
     #         actions on the key. These permissions are required because
     #         Amazon S3 must decrypt and read data from the encrypted file
     #         parts before it completes the multipart upload. For more
-    #         information, see [Multipart upload API and permissions][6] and
+    #         information, see [Multipart upload API and permissions][7] and
     #         [Protecting data using server-side encryption with Amazon Web
-    #         Services KMS][7] in the *Amazon S3 User Guide*.
+    #         Services KMS][8] in the *Amazon S3 User Guide*.
     #
     #       * If your Identity and Access Management (IAM) user or role is
     #         in the same Amazon Web Services account as the KMS key, then
@@ -2682,13 +2833,13 @@ module Aws::S3
     #         For information about configuring any of the officially
     #         supported Amazon Web Services SDKs and Amazon Web Services
     #         CLI, see [Specifying the Signature Version in Request
-    #         Authentication][10] in the *Amazon S3 User Guide*.
+    #         Authentication][11] in the *Amazon S3 User Guide*.
     #
     #        </note>
     #
     #       For more information about server-side encryption with KMS keys
     #       (SSE-KMS), see [Protecting Data Using Server-Side Encryption
-    #       with KMS keys][7] in the *Amazon S3 User Guide*.
+    #       with KMS keys][8] in the *Amazon S3 User Guide*.
     #
     #     * Use customer-provided encryption keys (SSE-C) – If you want to
     #       manage your own encryption keys, provide all the following
@@ -2702,7 +2853,7 @@ module Aws::S3
     #       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*.
+    #       keys (SSE-C)][12] 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
@@ -2712,13 +2863,13 @@ module Aws::S3
     #     default encryption in your `CreateSession` requests or `PUT`
     #     object requests. Then, new objects are automatically encrypted
     #     with the desired encryption settings. For more information, see
-    #     [Protecting data with server-side encryption][12] in the *Amazon
+    #     [Protecting data with server-side encryption][13] in the *Amazon
     #     S3 User Guide*. For more information about the encryption
     #     overriding behaviors in directory buckets, see [Specifying
-    #     server-side encryption with KMS for new object uploads][13].
+    #     server-side encryption with KMS for new object uploads][14].
     #
-    #     In the Zonal endpoint API calls (except [CopyObject][14] and
-    #     [UploadPartCopy][9]) using the REST API, the encryption request
+    #     In the Zonal endpoint API calls (except [CopyObject][15] and
+    #     [UploadPartCopy][10]) using the REST API, the encryption request
     #     headers must match the encryption settings that are specified in
     #     the `CreateSession` request. You can't override the values of the
     #     encryption settings (`x-amz-server-side-encryption`,
@@ -2738,7 +2889,7 @@ module Aws::S3
     #     configuration for the `CreateSession` request. It's not supported
     #     to override the encryption settings values in the `CreateSession`
     #     request. So in the Zonal endpoint API calls (except
-    #     [CopyObject][14] and [UploadPartCopy][9]), the encryption request
+    #     [CopyObject][15] and [UploadPartCopy][10]), the encryption request
     #     headers must match the default encryption configuration of the
     #     directory bucket.
     #
@@ -2754,19 +2905,19 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `CreateMultipartUpload`:
     #
     # * [UploadPart][1]
     #
-    # * [CompleteMultipartUpload][15]
+    # * [CompleteMultipartUpload][16]
     #
-    # * [AbortMultipartUpload][16]
+    # * [AbortMultipartUpload][17]
     #
-    # * [ListParts][17]
+    # * [ListParts][18]
     #
-    # * [ListMultipartUploads][18]
+    # * [ListMultipartUploads][19]
     #
     #
     #
@@ -2774,20 +2925,21 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [String] :acl
     #   The canned ACL to apply to the object. Amazon S3 supports a set of
@@ -2820,10 +2972,10 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -3520,23 +3672,27 @@ module Aws::S3
     #
     # <note markdown="1"> * 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`.
-    #   Path-style requests are not supported. For more information, see
-    #   [Regional and Zonal endpoints][3] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
+    #   Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][3] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][4] in the *Amazon
+    #   S3 User Guide*.
     #
     # * <b> <code>CopyObject</code> API operation</b> - Unlike other Zonal
     #   endpoint API operations, the `CopyObject` API operation doesn't use
     #   the temporary security credentials returned from the `CreateSession`
     #   API operation for authentication and authorization. For information
     #   about authentication and authorization of the `CopyObject` API
-    #   operation on directory buckets, see [CopyObject][4].
+    #   operation on directory buckets, see [CopyObject][5].
     #
     # * <b> <code>HeadBucket</code> API operation</b> - Unlike other Zonal
     #   endpoint API operations, the `HeadBucket` API operation doesn't use
     #   the temporary security credentials returned from the `CreateSession`
     #   API operation for authentication and authorization. For information
     #   about authentication and authorization of the `HeadBucket` API
-    #   operation on directory buckets, see [HeadBucket][5].
+    #   operation on directory buckets, see [HeadBucket][6].
     #
     #  </note>
     #
@@ -3548,10 +3704,10 @@ module Aws::S3
     #   can have the `s3express:SessionMode` condition key to control who
     #   can create a `ReadWrite` or `ReadOnly` session. For more information
     #   about `ReadWrite` or `ReadOnly` sessions, see [
-    #   `x-amz-create-session-mode` ][6]. For example policies, see [Example
-    #   bucket policies for S3 Express One Zone][7] and [Amazon Web Services
+    #   `x-amz-create-session-mode` ][7]. For example policies, see [Example
+    #   bucket policies for S3 Express One Zone][8] and [Amazon Web Services
     #   Identity and Access Management (IAM) identity-based policies for S3
-    #   Express One Zone][8] in the *Amazon S3 User Guide*.
+    #   Express One Zone][9] in the *Amazon S3 User Guide*.
     #
     #   To grant cross-account access to Zonal endpoint API operations, the
     #   bucket policy should also grant both accounts the
@@ -3572,32 +3728,32 @@ module Aws::S3
     #   requests or `PUT` object requests. Then, new objects are
     #   automatically encrypted with the desired encryption settings. For
     #   more information, see [Protecting data with server-side
-    #   encryption][9] in the *Amazon S3 User Guide*. For more information
+    #   encryption][10] in the *Amazon S3 User Guide*. For more information
     #   about the encryption overriding behaviors in directory buckets, see
     #   [Specifying server-side encryption with KMS for new object
-    #   uploads][10].
+    #   uploads][11].
     #
-    #   For [Zonal endpoint (object-level) API operations][11] except
-    #   [CopyObject][4] and [UploadPartCopy][12], you authenticate and
-    #   authorize requests through [CreateSession][13] for low latency. To
+    #   For [Zonal endpoint (object-level) API operations][12] except
+    #   [CopyObject][5] and [UploadPartCopy][13], you authenticate and
+    #   authorize requests through [CreateSession][14] for low latency. To
     #   encrypt new objects in a directory bucket with SSE-KMS, you must
     #   specify SSE-KMS as the directory bucket's default encryption
     #   configuration with a KMS key (specifically, a [customer managed
-    #   key][14]). Then, when a session is created for Zonal endpoint API
+    #   key][15]). Then, when a session is created for Zonal endpoint API
     #   operations, new objects are automatically encrypted and decrypted
     #   with SSE-KMS and S3 Bucket Keys during the session.
     #
-    #   <note markdown="1"> Only 1 [customer managed key][14] is supported per directory bucket
+    #   <note markdown="1"> Only 1 [customer managed key][15] is supported per directory bucket
     #   for the lifetime of the bucket. The [Amazon Web Services managed
-    #   key][15] (`aws/s3`) isn't supported. After you specify SSE-KMS as
+    #   key][16] (`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
     #   bucket's SSE-KMS configuration.
     #
     #    </note>
     #
-    #   In the Zonal endpoint API calls (except [CopyObject][4] and
-    #   [UploadPartCopy][12]) using the REST API, you can't override the
+    #   In the Zonal endpoint API calls (except [CopyObject][5] and
+    #   [UploadPartCopy][13]) using the REST API, you can't override the
     #   values of the encryption settings (`x-amz-server-side-encryption`,
     #   `x-amz-server-side-encryption-aws-kms-key-id`,
     #   `x-amz-server-side-encryption-context`, and
@@ -3613,8 +3769,8 @@ module Aws::S3
     #   Web Services SDKs use the bucket's default encryption configuration
     #   for the `CreateSession` request. It's not supported to override the
     #   encryption settings values in the `CreateSession` request. Also, in
-    #   the Zonal endpoint API calls (except [CopyObject][4] and
-    #   [UploadPartCopy][12]), it's not supported to override the values of
+    #   the Zonal endpoint API calls (except [CopyObject][5] and
+    #   [UploadPartCopy][13]), it's not supported to override the values of
     #   the encryption settings from the `CreateSession` request.
     #
     #    </note>
@@ -3622,25 +3778,26 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-APIs.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-optimizing-performance-guidelines-design-patterns.html#s3-express-optimizing-performance-session-authentication
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [14]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
-    # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html#API_CreateSession_RequestParameters
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-differences.html#s3-express-differences-api-operations
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [15]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
+    # [16]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
     #
     # @option params [String] :session_mode
     #   Specifies the mode of the session that will be created, either
@@ -3782,10 +3939,13 @@ module Aws::S3
     # * <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 `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. For more
-    #   information, see [Regional and Zonal endpoints][1] in the *Amazon S3
-    #   User Guide*.
+    #   information about endpoints in Availability Zones, see [Regional and
+    #   Zonal endpoints for directory buckets in Availability Zones][1] in
+    #   the *Amazon S3 User Guide*. For more information about endpoints in
+    #   Local Zones, see [Available Local Zone for directory buckets][2] in
+    #   the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -3800,39 +3960,41 @@ module Aws::S3
     #     performed by the Amazon Web Services account that owns the
     #     resource. For more information about directory bucket policies and
     #     permissions, see [Amazon Web Services Identity and Access
-    #     Management (IAM) for S3 Express One Zone][2] in the *Amazon S3
+    #     Management (IAM) for S3 Express One Zone][3] in the *Amazon S3
     #     User Guide*.
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `DeleteBucket`:
     #
-    # * [CreateBucket][3]
+    # * [CreateBucket][4]
     #
-    # * [DeleteObject][4]
+    # * [DeleteObject][5]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
     #
     # @option params [required, String] :bucket
     #   Specifies the bucket being deleted.
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -3876,7 +4038,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>
     #
@@ -3942,7 +4104,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>
     #
@@ -4041,7 +4203,7 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `DeleteBucketEncryption`:
     #
@@ -4065,13 +4227,14 @@ module Aws::S3
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -4106,7 +4269,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>
     #
@@ -4173,7 +4336,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>
     #
@@ -4238,38 +4401,75 @@ 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].
+    #   ^
     #
-    # There is usually some time lag before lifecycle configuration deletion
-    # is fully propagated to all the Amazon S3 systems.
+    #   * **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 about endpoints in Availability Zones, see [Regional
+    #     and Zonal endpoints for directory buckets in Availability
+    #     Zones][3] in the *Amazon S3 User Guide*. For more information
+    #     about endpoints in Local Zones, see [Available Local Zone for
+    #     directory buckets][4] 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`.
     #
     # For more information about the object expiration, see [Elements to
-    # Describe Lifecycle Actions][1].
+    # Describe Lifecycle Actions][5].
     #
     # Related actions include:
     #
-    # * [PutBucketLifecycleConfiguration][2]
+    # * [PutBucketLifecycleConfiguration][6]
     #
-    # * [GetBucketLifecycleConfiguration][3]
+    # * [GetBucketLifecycleConfiguration][7]
     #
     #
     #
-    # [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/userguide/s3-lzs-for-directory-buckets.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The bucket name of the lifecycle to delete.
@@ -4279,6 +4479,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}.
     #
     #
@@ -4306,7 +4511,58 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # Deletes a metadata table configuration from a general purpose bucket.
+    # For more information, see [Accelerating data discovery with S3
+    # Metadata][1] in the *Amazon S3 User Guide*.
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have the
+    #   `s3:DeleteBucketMetadataTableConfiguration` permission. For more
+    #   information, see [Setting up permissions for configuring metadata
+    #   tables][2] in the *Amazon S3 User Guide*.
+    #
+    # The following operations are related to
+    # `DeleteBucketMetadataTableConfiguration`:
+    #
+    # * [CreateBucketMetadataTableConfiguration][3]
+    #
+    # * [GetBucketMetadataTableConfiguration][4]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html
+    #
+    # @option params [required, String] :bucket
+    #   The general purpose bucket that you want to remove the metadata table
+    #   configuration from.
+    #
+    # @option params [String] :expected_bucket_owner
+    #   The expected bucket owner of the general purpose bucket that you want
+    #   to remove the metadata table configuration from.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_bucket_metadata_table_configuration({
+    #     bucket: "BucketName", # required
+    #     expected_bucket_owner: "AccountId",
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetadataTableConfiguration AWS API Documentation
+    #
+    # @overload delete_bucket_metadata_table_configuration(params = {})
+    # @param [Hash] params ({})
+    def delete_bucket_metadata_table_configuration(params = {}, options = {})
+      req = build_request(:delete_bucket_metadata_table_configuration, params)
+      req.send_request(options)
+    end
+
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4376,7 +4632,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>
     #
@@ -4431,9 +4687,13 @@ module Aws::S3
     # <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][1] in the *Amazon S3 User Guide*.
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Available Local Zone for directory buckets][2] in the
+    # *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -4463,7 +4723,7 @@ module Aws::S3
     #   * **General purpose bucket permissions** - The
     #     `s3:DeleteBucketPolicy` permission is required in a policy. For
     #     more information about general purpose buckets bucket policies,
-    #     see [Using Bucket Policies and User Policies][2] in the *Amazon S3
+    #     see [Using Bucket Policies and User Policies][3] in the *Amazon S3
     #     User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
@@ -4474,39 +4734,41 @@ module Aws::S3
     #     Services account that owns the resource. For more information
     #     about directory bucket policies and permissions, see [Amazon Web
     #     Services Identity and Access Management (IAM) for S3 Express One
-    #     Zone][3] in the *Amazon S3 User Guide*.
+    #     Zone][4] in the *Amazon S3 User Guide*.
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `DeleteBucketPolicy`
     #
-    # * [CreateBucket][4]
+    # * [CreateBucket][5]
     #
-    # * [DeleteObject][5]
+    # * [DeleteObject][6]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
     #
     # @option params [required, String] :bucket
     #   The bucket name.
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -4550,7 +4812,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>
     #
@@ -4620,7 +4882,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>
     #
@@ -4676,7 +4938,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>
     #
@@ -4745,33 +5007,71 @@ module Aws::S3
     end
 
     # Removes an object from a bucket. The behavior depends on the bucket's
-    # versioning state. For more information, see [Best practices to
-    # consider before deleting an object][1].
+    # 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-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][3] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][4] in the *Amazon
+    #   S3 User Guide*.
+    #
+    #  </note>
     #
     # 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 and to see example requests, see
-    # [Using MFA delete][2] and [Sample request][3] in the *Amazon S3 User
-    # Guide*.
+    # header `x-amz-delete-marker` to true.
     #
-    # <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.
+    # 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][5] in the *Amazon S3 User Guide*.
+    # To see sample requests that use versioning, see [Sample Request][6].
     #
-    # * 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** - MFA delete is not supported by directory
+    # buckets.
     #
-    # * MFA delete is not supported by directory buckets.
+    #  </note>
+    #
+    # You can delete objects by explicitly calling DELETE Object or calling
+    # ([PutBucketLifecycle][7]) 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.
+    #
+    # <note markdown="1"> **Directory buckets** - S3 Lifecycle is not supported by directory
+    # buckets.
     #
     #  </note>
     #
@@ -4783,51 +5083,56 @@ 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.
-    #
-    #     * 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.
+    #   * **Directory bucket permissions** - To grant access to this API
+    #     operation on a directory bucket, we recommend that you use the [
+    #     `CreateSession` ][8] 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` ][8].
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following action is related to `DeleteObject`:
     #
-    # * [PutObject][5]
+    # * [PutObject][9]
     #
     # ^
     #
     #
     #
-    # [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
+    # [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/userguide/s3-lzs-for-directory-buckets.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [9]: 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.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -4915,6 +5220,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
@@ -4922,28 +5270,28 @@ module Aws::S3
     #   * {Types::DeleteObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To delete an object (from a non-versioned bucket)
+    # @example Example: To delete an object
     #
-    #   # The following example deletes an object from a non-versioned bucket.
+    #   # The following example deletes an object from an S3 bucket.
     #
     #   resp = client.delete_object({
-    #     bucket: "ExampleBucket", 
-    #     key: "HappyFace.jpg", 
+    #     bucket: "examplebucket", 
+    #     key: "objectkey.jpg", 
     #   })
     #
-    # @example Example: To delete an object
+    #   resp.to_h outputs the following:
+    #   {
+    #   }
     #
-    #   # The following example deletes an object from an S3 bucket.
+    # @example Example: To delete an object (from a non-versioned bucket)
+    #
+    #   # The following example deletes an object from a non-versioned bucket.
     #
     #   resp = client.delete_object({
-    #     bucket: "examplebucket", 
-    #     key: "objectkey.jpg", 
+    #     bucket: "ExampleBucket", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
-    #   resp.to_h outputs the following:
-    #   {
-    #   }
-    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_object({
@@ -4954,6 +5302,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
@@ -4971,7 +5322,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>
     #
@@ -5114,9 +5465,13 @@ module Aws::S3
     # * **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][1] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][1] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][2] in the *Amazon
+    #   S3 User Guide*.
     #
     #  </note>
     #
@@ -5134,7 +5489,7 @@ module Aws::S3
     # if there are non-versioned objects you are trying to delete. If you
     # provide an invalid token, whether there are versioned keys in the
     # request or not, the entire Multi-Object Delete request will fail. For
-    # information about MFA Delete, see [MFA Delete][2] in the *Amazon S3
+    # information about MFA Delete, see [MFA Delete][3] in the *Amazon S3
     # User Guide*.
     #
     # <note markdown="1"> **Directory buckets** - MFA delete is not supported by directory
@@ -5156,7 +5511,7 @@ module Aws::S3
     #       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
+    #     `CreateSession` ][4] 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
@@ -5167,7 +5522,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][3].
+    #     authorization, see [ `CreateSession` ][4].
     #
     # Content-MD5 request header
     # : * **General purpose bucket** - The Content-MD5 request header is
@@ -5184,40 +5539,41 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `DeleteObjects`:
     #
-    # * [CreateMultipartUpload][4]
+    # * [CreateMultipartUpload][5]
     #
-    # * [UploadPart][5]
+    # * [UploadPart][6]
     #
-    # * [CompleteMultipartUpload][6]
+    # * [CompleteMultipartUpload][7]
     #
-    # * [ListParts][7]
+    # * [ListParts][8]
     #
-    # * [AbortMultipartUpload][8]
+    # * [AbortMultipartUpload][9]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
     #
     # @option params [required, String] :bucket
     #   The bucket name containing the objects to delete.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -5433,6 +5789,9 @@ module Aws::S3
     #         {
     #           key: "ObjectKey", # required
     #           version_id: "ObjectVersionId",
+    #           etag: "ETag",
+    #           last_modified_time: Time.now,
+    #           size: 1,
     #         },
     #       ],
     #       quiet: false,
@@ -5467,7 +5826,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>
     #
@@ -5524,7 +5883,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>
     #
@@ -5620,7 +5979,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>
     #
@@ -5716,7 +6075,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>
     #
@@ -5802,7 +6161,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>
     #
@@ -5961,7 +6320,7 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `GetBucketEncryption`:
     #
@@ -5985,13 +6344,14 @@ module Aws::S3
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -6035,7 +6395,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>
     #
@@ -6119,7 +6479,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>
     #
@@ -6208,7 +6568,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>
     #
@@ -6320,34 +6680,68 @@ 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 about endpoints in Availability Zones, see [Regional
+    #     and Zonal endpoints for directory buckets in Availability
+    #     Zones][5] in the *Amazon S3 User Guide*. For more information
+    #     about endpoints in Local Zones, see [Available Local Zone for
+    #     directory buckets][6] 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:
     #
@@ -6362,20 +6756,22 @@ module Aws::S3
     # The following operations are related to
     # `GetBucketLifecycleConfiguration`:
     #
-    # * [GetBucketLifecycle][1]
+    # * [GetBucketLifecycle][2]
     #
-    # * [PutBucketLifecycle][5]
+    # * [PutBucketLifecycle][7]
     #
-    # * [DeleteBucketLifecycle][6]
+    # * [DeleteBucketLifecycle][8]
     #
     #
     #
-    # [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/userguide/s3-lzs-for-directory-buckets.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
+    # [8]: 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.
@@ -6385,6 +6781,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 [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array&lt;Types::LifecycleRule&gt;
@@ -6465,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>
     #
@@ -6562,7 +6963,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>
     #
@@ -6621,7 +7022,70 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # Retrieves the metadata table configuration for a general purpose
+    # bucket. For more information, see [Accelerating data discovery with S3
+    # Metadata][1] in the *Amazon S3 User Guide*.
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have the
+    #   `s3:GetBucketMetadataTableConfiguration` permission. For more
+    #   information, see [Setting up permissions for configuring metadata
+    #   tables][2] in the *Amazon S3 User Guide*.
+    #
+    # The following operations are related to
+    # `GetBucketMetadataTableConfiguration`:
+    #
+    # * [CreateBucketMetadataTableConfiguration][3]
+    #
+    # * [DeleteBucketMetadataTableConfiguration][4]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataTableConfiguration.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataTableConfiguration.html
+    #
+    # @option params [required, String] :bucket
+    #   The general purpose bucket that contains the metadata table
+    #   configuration that you want to retrieve.
+    #
+    # @option params [String] :expected_bucket_owner
+    #   The expected owner of the general purpose bucket that you want to
+    #   retrieve the metadata table configuration from.
+    #
+    # @return [Types::GetBucketMetadataTableConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetBucketMetadataTableConfigurationOutput#get_bucket_metadata_table_configuration_result #get_bucket_metadata_table_configuration_result} => Types::GetBucketMetadataTableConfigurationResult
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_bucket_metadata_table_configuration({
+    #     bucket: "BucketName", # required
+    #     expected_bucket_owner: "AccountId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_bucket_arn #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_name #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_arn #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.metadata_table_configuration_result.s3_tables_destination_result.table_namespace #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.status #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.error.error_code #=> String
+    #   resp.get_bucket_metadata_table_configuration_result.error.error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetadataTableConfiguration AWS API Documentation
+    #
+    # @overload get_bucket_metadata_table_configuration(params = {})
+    # @param [Hash] params ({})
+    def get_bucket_metadata_table_configuration(params = {}, options = {})
+      req = build_request(:get_bucket_metadata_table_configuration, params)
+      req.send_request(options)
+    end
+
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6707,7 +7171,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>
     #
@@ -6838,7 +7302,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>
     #
@@ -6953,7 +7417,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>
     #
@@ -7015,9 +7479,13 @@ module Aws::S3
     # <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][1] in the *Amazon S3 User Guide*.
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Available Local Zone for directory buckets][2] in the
+    # *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -7047,7 +7515,7 @@ module Aws::S3
     #   * **General purpose bucket permissions** - The `s3:GetBucketPolicy`
     #     permission is required in a policy. For more information about
     #     general purpose buckets bucket policies, see [Using Bucket
-    #     Policies and User Policies][2] in the *Amazon S3 User Guide*.
+    #     Policies and User Policies][3] in the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation, you must have the `s3express:GetBucketPolicy`
@@ -7057,48 +7525,50 @@ module Aws::S3
     #     Services account that owns the resource. For more information
     #     about directory bucket policies and permissions, see [Amazon Web
     #     Services Identity and Access Management (IAM) for S3 Express One
-    #     Zone][3] in the *Amazon S3 User Guide*.
+    #     Zone][4] in the *Amazon S3 User Guide*.
     #
     # Example bucket policies
     #
     # : **General purpose buckets example bucket policies** - See [Bucket
-    #   policy examples][4] in the *Amazon S3 User Guide*.
+    #   policy examples][5] in the *Amazon S3 User Guide*.
     #
     #   **Directory bucket example bucket policies** - See [Example bucket
-    #   policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
+    #   policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following action is related to `GetBucketPolicy`:
     #
-    # * [GetObject][6]
+    # * [GetObject][7]
     #
     # ^
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
     #
     # @option params [required, String] :bucket
     #   The bucket name to get the bucket policy for.
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #   **Access points** - When you use this API operation with an access
     #   point, provide the alias of the access point in place of the bucket
@@ -7170,7 +7640,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>
     #
@@ -7235,7 +7705,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>
     #
@@ -7358,7 +7828,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>
     #
@@ -7424,7 +7894,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>
     #
@@ -7510,7 +7980,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>
     #
@@ -7587,7 +8057,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>
     #
@@ -7701,9 +8171,13 @@ module Aws::S3
     # `/photos/2006/February/sample.jpg`. Also, when you make requests to
     # this API operation, your requests are sent 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][2] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][2] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
+    # Guide*.
     #
     # Permissions
     # : * **General purpose bucket permissions** - You must have the
@@ -7711,7 +8185,7 @@ module Aws::S3
     #     have the `READ` access to the object (or version). If you grant
     #     `READ` access to the anonymous user, the `GetObject` operation
     #     returns the object without using an authorization header. For more
-    #     information, see [Specifying permissions in a policy][3] in the
+    #     information, see [Specifying permissions in a policy][4] in the
     #     *Amazon S3 User Guide*.
     #
     #     If you include a `versionId` in your request header, you must have
@@ -7735,7 +8209,7 @@ module Aws::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
+    #     `CreateSession` ][5] 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
@@ -7746,7 +8220,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][4].
+    #     authorization, see [ `CreateSession` ][5].
     #
     #     If the object is encrypted using SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -7759,9 +8233,9 @@ module Aws::S3
     #   storage class, the S3 Intelligent-Tiering Archive Access tier, or
     #   the S3 Intelligent-Tiering Deep Archive Access tier, before you can
     #   retrieve the object you must first restore a copy using
-    #   [RestoreObject][5]. Otherwise, this operation returns an
+    #   [RestoreObject][6]. Otherwise, this operation returns an
     #   `InvalidObjectState` error. For information about restoring archived
-    #   objects, see [Restoring Archived Objects][6] in the *Amazon S3 User
+    #   objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
     #   Guide*.
     #
     #   <b>Directory buckets </b> - For directory buckets, only the S3
@@ -7783,7 +8257,7 @@ module Aws::S3
     #   **Directory buckets** - For directory buckets, there are only two
     #   supported options for server-side encryption: SSE-S3 and SSE-KMS.
     #   SSE-C isn't supported. For more information, see [Protecting data
-    #   with server-side encryption][7] in the *Amazon S3 User Guide*.
+    #   with server-side encryption][8] in the *Amazon S3 User Guide*.
     #
     # Overriding response header values through the request
     #
@@ -7828,25 +8302,26 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `GetObject`:
     #
-    # * [ListBuckets][8]
+    # * [ListBuckets][9]
     #
-    # * [GetObjectAcl][9]
+    # * [GetObjectAcl][10]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.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_CreateSession.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.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_CreateSession.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
     #
     # @option params [String, IO] :response_target
     #   Where to write response data, file path, or IO object.
@@ -7856,10 +8331,10 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -8193,49 +8668,49 @@ module Aws::S3
     #   * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
     #
     #
-    # @example Example: To retrieve an object
+    # @example Example: To retrieve a byte range of an object 
     #
-    #   # The following example retrieves an object for an S3 bucket.
+    #   # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
+    #   # specific byte range.
     #
     #   resp = client.get_object({
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "SampleFile.txt", 
+    #     range: "bytes=0-9", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     accept_ranges: "bytes", 
-    #     content_length: 3191, 
-    #     content_type: "image/jpeg", 
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     last_modified: Time.parse("2016-12-15T01:19:41.000Z"), 
+    #     content_length: 10, 
+    #     content_range: "bytes 0-9/43", 
+    #     content_type: "text/plain", 
+    #     etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"", 
+    #     last_modified: Time.parse("2014-10-09T22:57:28.000Z"), 
     #     metadata: {
     #     }, 
-    #     tag_count: 2, 
     #     version_id: "null", 
     #   }
     #
-    # @example Example: To retrieve a byte range of an object 
+    # @example Example: To retrieve an object
     #
-    #   # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
-    #   # specific byte range.
+    #   # The following example retrieves an object for an S3 bucket.
     #
     #   resp = client.get_object({
     #     bucket: "examplebucket", 
-    #     key: "SampleFile.txt", 
-    #     range: "bytes=0-9", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     accept_ranges: "bytes", 
-    #     content_length: 10, 
-    #     content_range: "bytes 0-9/43", 
-    #     content_type: "text/plain", 
-    #     etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"", 
-    #     last_modified: Time.parse("2014-10-09T22:57:28.000Z"), 
+    #     content_length: 3191, 
+    #     content_type: "image/jpeg", 
+    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
+    #     last_modified: Time.parse("2016-12-15T01:19:41.000Z"), 
     #     metadata: {
     #     }, 
+    #     tag_count: 2, 
     #     version_id: "null", 
     #   }
     #
@@ -8344,7 +8819,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>
     #
@@ -8539,9 +9014,13 @@ module Aws::S3
     # <note markdown="1"> **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][1] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][1] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][2] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
@@ -8554,7 +9033,7 @@ module Aws::S3
     #     `s3:GetObjectVersionAttributes` permissions for this operation. If
     #     the bucket is not versioned, you need the `s3:GetObject` and
     #     `s3:GetObjectAttributes` permissions. For more information, see
-    #     [Specifying Permissions in a Policy][2] in the *Amazon S3 User
+    #     [Specifying Permissions in a Policy][3] in the *Amazon S3 User
     #     Guide*. If the object that you request does not exist, the error
     #     Amazon S3 returns depends on whether you also have the
     #     `s3:ListBucket` permission.
@@ -8568,7 +9047,7 @@ module Aws::S3
     #       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
+    #     `CreateSession` ][4] 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
@@ -8579,7 +9058,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][3].
+    #     authorization, see [ `CreateSession` ][4].
     #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -8615,7 +9094,7 @@ module Aws::S3
     #   * `x-amz-server-side-encryption-customer-key-MD5`
     #
     #   For more information about SSE-C, see [Server-Side Encryption (Using
-    #   Customer-Provided Encryption Keys)][4] in the *Amazon S3 User
+    #   Customer-Provided Encryption Keys)][5] in the *Amazon S3 User
     #   Guide*.
     #
     #   <note markdown="1"> **Directory bucket permissions** - For directory buckets, there are
@@ -8627,10 +9106,10 @@ module Aws::S3
     #   encryption in your `CreateSession` requests or `PUT` object
     #   requests. Then, new objects are automatically encrypted with the
     #   desired encryption settings. For more information, see [Protecting
-    #   data with server-side encryption][5] in the *Amazon S3 User Guide*.
+    #   data with server-side encryption][6] in the *Amazon S3 User Guide*.
     #   For more information about the encryption overriding behaviors in
     #   directory buckets, see [Specifying server-side encryption with KMS
-    #   for new object uploads][6].
+    #   for new object uploads][7].
     #
     #    </note>
     #
@@ -8653,7 +9132,7 @@ module Aws::S3
     #
     #     * `If-Unmodified-Since` condition evaluates to `false`.
     #     For more information about conditional requests, see [RFC
-    #     7232][7].
+    #     7232][8].
     #
     #   * If both of the `If-None-Match` and `If-Modified-Since` headers are
     #     present in the request as follows, then Amazon S3 returns the HTTP
@@ -8663,58 +9142,59 @@ module Aws::S3
     #
     #     * `If-Modified-Since` condition evaluates to `true`.
     #     For more information about conditional requests, see [RFC
-    #     7232][7].
+    #     7232][8].
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following actions are related to `GetObjectAttributes`:
     #
-    # * [GetObject][8]
+    # * [GetObject][9]
     #
-    # * [GetObjectAcl][9]
+    # * [GetObjectAcl][10]
     #
-    # * [GetObjectLegalHold][10]
+    # * [GetObjectLegalHold][11]
     #
-    # * [GetObjectLockConfiguration][11]
+    # * [GetObjectLockConfiguration][12]
     #
-    # * [GetObjectRetention][12]
+    # * [GetObjectRetention][13]
     #
-    # * [GetObjectTagging][13]
+    # * [GetObjectTagging][14]
     #
-    # * [HeadObject][14]
+    # * [HeadObject][15]
     #
-    # * [ListParts][15]
+    # * [ListParts][16]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
-    # [7]: https://tools.ietf.org/html/rfc7232
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.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_CreateSession.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
+    # [8]: https://tools.ietf.org/html/rfc7232
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLegalHold.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectLockConfiguration.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectRetention.html
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket that contains the object.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -8887,7 +9367,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>
     #
@@ -8983,7 +9463,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>
     #
@@ -9053,7 +9533,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>
     #
@@ -9150,7 +9630,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>
     #
@@ -9319,7 +9799,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>
     #
@@ -9420,7 +9900,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>
     #
@@ -9551,13 +10031,17 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     #   <note markdown="1"> 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`.
-    #   Path-style requests are not supported. For more information, see
-    #   [Regional and Zonal endpoints][5] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com`.
+    #   Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][5] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][6] in the *Amazon
+    #   S3 User Guide*.
     #
     #    </note>
     #
@@ -9568,16 +10052,17 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
     #
     # @option params [required, String] :bucket
     #   The bucket name.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -9651,7 +10136,7 @@ module Aws::S3
     #
     # @example Response structure
     #
-    #   resp.bucket_location_type #=> String, one of "AvailabilityZone"
+    #   resp.bucket_location_type #=> String, one of "AvailabilityZone", "LocalZone"
     #   resp.bucket_location_name #=> String
     #   resp.bucket_region #=> String
     #   resp.access_point_alias #=> Boolean
@@ -9782,7 +10267,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
@@ -9796,22 +10281,26 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     #   <note markdown="1"> 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][6] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][6] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][7] in the *Amazon
+    #   S3 User Guide*.
     #
     #    </note>
     #
     # The following actions are related to `HeadObject`:
     #
-    # * [GetObject][7]
+    # * [GetObject][8]
     #
-    # * [GetObjectAttributes][8]
+    # * [GetObjectAttributes][9]
     #
     #
     #
@@ -9821,18 +10310,19 @@ module Aws::S3
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
     # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket that contains the object.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -10193,7 +10683,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>
     #
@@ -10294,7 +10784,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>
     #
@@ -10386,7 +10876,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>
     #
@@ -10488,7 +10978,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>
     #
@@ -10590,24 +11080,25 @@ 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 requests. Unpaginated
-    # 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 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.
+    # 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.
     #
     #
     #
@@ -10735,9 +11226,13 @@ module Aws::S3
     # <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][2] in the *Amazon S3 User Guide*.
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][2] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Available Local Zone for directory buckets][3] in the
+    # *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -10749,7 +11244,7 @@ module Aws::S3
     #   operation can only be performed by the Amazon Web Services account
     #   that owns the resource. For more information about directory bucket
     #   policies and permissions, see [Amazon Web Services Identity and
-    #   Access Management (IAM) for S3 Express One Zone][3] in the *Amazon
+    #   Access Management (IAM) for S3 Express One Zone][4] in the *Amazon
     #   S3 User Guide*.
     #
     # HTTP Host header syntax
@@ -10766,7 +11261,8 @@ module Aws::S3
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
     #
     # @option params [String] :continuation_token
     #   `ContinuationToken` indicates to Amazon S3 that the list is being
@@ -10854,21 +11350,25 @@ module Aws::S3
     # <note markdown="1"> **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][2] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][2] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][3] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
     # Permissions
     # : * **General purpose bucket permissions** - For information about
     #     permissions required to use the multipart upload API, see
-    #     [Multipart Upload and Permissions][3] in the *Amazon S3 User
+    #     [Multipart Upload and Permissions][4] in the *Amazon S3 User
     #     Guide*.
     #
     #   * **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
+    #     `CreateSession` ][5] 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
@@ -10879,7 +11379,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][4].
+    #     authorization, see [ `CreateSession` ][5].
     #
     # Sorting of multipart uploads in response
     # : * **General purpose bucket** - In the `ListMultipartUploads`
@@ -10900,41 +11400,42 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `ListMultipartUploads`:
     #
-    # * [CreateMultipartUpload][5]
+    # * [CreateMultipartUpload][6]
     #
-    # * [UploadPart][6]
+    # * [UploadPart][7]
     #
-    # * [CompleteMultipartUpload][7]
+    # * [CompleteMultipartUpload][8]
     #
-    # * [ListParts][8]
+    # * [ListParts][9]
     #
-    # * [AbortMultipartUpload][9]
+    # * [AbortMultipartUpload][10]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket to which the multipart upload was initiated.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -11105,97 +11606,97 @@ module Aws::S3
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     #
-    # @example Example: List next set of multipart uploads when previous result is truncated
+    # @example Example: To list in-progress multipart uploads on a bucket
     #
-    #   # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
-    #   # setup of multipart uploads.
+    #   # The following example lists in-progress multipart uploads on a specific bucket.
     #
     #   resp = client.list_multipart_uploads({
     #     bucket: "examplebucket", 
-    #     key_marker: "nextkeyfrompreviousresponse", 
-    #     max_uploads: 2, 
-    #     upload_id_marker: "valuefrompreviousresponse", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     bucket: "acl1", 
-    #     is_truncated: true, 
-    #     key_marker: "", 
-    #     max_uploads: 2, 
-    #     next_key_marker: "someobjectkey", 
-    #     next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
-    #     upload_id_marker: "", 
     #     uploads: [
     #       {
     #         initiated: Time.parse("2014-05-01T05:40:58.000Z"), 
     #         initiator: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "mohanataws", 
-    #           id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
+    #           display_name: "display-name", 
+    #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
+    #         upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
     #       }, 
     #       {
     #         initiated: Time.parse("2014-05-01T05:41:27.000Z"), 
     #         initiator: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #         upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
     #       }, 
     #     ], 
     #   }
     #
-    # @example Example: To list in-progress multipart uploads on a bucket
+    # @example Example: List next set of multipart uploads when previous result is truncated
     #
-    #   # The following example lists in-progress multipart uploads on a specific bucket.
+    #   # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
+    #   # setup of multipart uploads.
     #
     #   resp = client.list_multipart_uploads({
     #     bucket: "examplebucket", 
+    #     key_marker: "nextkeyfrompreviousresponse", 
+    #     max_uploads: 2, 
+    #     upload_id_marker: "valuefrompreviousresponse", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
+    #     bucket: "acl1", 
+    #     is_truncated: true, 
+    #     key_marker: "", 
+    #     max_uploads: 2, 
+    #     next_key_marker: "someobjectkey", 
+    #     next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #     upload_id_marker: "", 
     #     uploads: [
     #       {
     #         initiated: Time.parse("2014-05-01T05:40:58.000Z"), 
     #         initiator: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "display-name", 
-    #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
+    #           display_name: "mohanataws", 
+    #           id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
+    #         upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
     #       }, 
     #       {
     #         initiated: Time.parse("2014-05-01T05:41:27.000Z"), 
     #         initiator: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #         upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
     #       }, 
     #     ], 
     #   }
@@ -11249,7 +11750,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>
     #
@@ -11488,7 +11989,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>
     #
@@ -11527,10 +12028,10 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -11742,9 +12243,13 @@ module Aws::S3
     # * **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*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][3] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][4] in the *Amazon
+    #   S3 User Guide*.
     #
     #  </note>
     #
@@ -11754,12 +12259,12 @@ module Aws::S3
     #     to perform the `s3:ListBucket` 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][4] and [Managing Access Permissions
-    #     to Your Amazon S3 Resources][5] in the *Amazon S3 User Guide*.
+    #     Bucket Subresource Operations][5] and [Managing Access Permissions
+    #     to Your Amazon S3 Resources][6] in the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][6] API operation for session-based
+    #     `CreateSession` ][7] API operation for session-based
     #     authorization. Specifically, you grant the
     #     `s3express:CreateSession` permission to the directory bucket in a
     #     bucket policy or an IAM identity-based policy. Then, you make the
@@ -11770,7 +12275,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][6].
+    #     authorization, see [ `CreateSession` ][7].
     #
     # Sorting order of returned objects
     # : * **General purpose bucket** - For general purpose buckets,
@@ -11783,41 +12288,42 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # This section describes the latest revision of this action. We
     # recommend that you use this revised API operation for application
     # development. For backward compatibility, Amazon S3 continues to
-    # support the prior version of this API operation, [ListObjects][7].
+    # support the prior version of this API operation, [ListObjects][8].
     #
     # The following operations are related to `ListObjectsV2`:
     #
-    # * [GetObject][8]
+    # * [GetObject][9]
     #
-    # * [PutObject][9]
+    # * [PutObject][10]
     #
-    # * [CreateBucket][10]
+    # * [CreateBucket][11]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.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/API/API_CreateSession.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.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/API/API_CreateSession.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
     #
     # @option params [required, String] :bucket
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -12085,16 +12591,20 @@ module Aws::S3
     # <note markdown="1"> **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*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][3] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][4] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
     # Permissions
     # : * **General purpose bucket permissions** - For information about
     #     permissions required to use the multipart upload API, see
-    #     [Multipart Upload and Permissions][4] in the *Amazon S3 User
+    #     [Multipart Upload and Permissions][5] in the *Amazon S3 User
     #     Guide*.
     #
     #     If the upload was created using server-side encryption with Key
@@ -12105,7 +12615,7 @@ module Aws::S3
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][5] API operation for session-based
+    #     `CreateSession` ][6] 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
@@ -12116,49 +12626,50 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][5].
+    #     authorization, see [ `CreateSession` ][6].
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `ListParts`:
     #
     # * [CreateMultipartUpload][1]
     #
-    # * [UploadPart][6]
+    # * [UploadPart][7]
     #
-    # * [CompleteMultipartUpload][7]
+    # * [CompleteMultipartUpload][8]
     #
-    # * [AbortMultipartUpload][8]
+    # * [AbortMultipartUpload][9]
     #
-    # * [GetObjectAttributes][9]
+    # * [GetObjectAttributes][10]
     #
-    # * [ListMultipartUploads][10]
+    # * [ListMultipartUploads][11]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.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/mpuAndPermissions.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket to which the parts are being uploaded.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -12382,7 +12893,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>
     #
@@ -12481,7 +12992,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>
     #
@@ -12774,7 +13285,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>
     #
@@ -12910,7 +13421,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>
     #
@@ -13095,9 +13606,13 @@ module Aws::S3
     # <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][1] in the *Amazon S3 User Guide*.
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Available Local Zone for directory buckets][2] in the
+    # *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -13111,12 +13626,12 @@ module Aws::S3
     #     keys (SSE-KMS) or dual-layer server-side encryption with Amazon
     #     Web Services KMS keys (DSSE-KMS). If you specify default
     #     encryption by using SSE-KMS, you can also configure [Amazon S3
-    #     Bucket Keys][2]. For information about the bucket default
-    #     encryption feature, see [Amazon S3 Bucket Default Encryption][3]
+    #     Bucket Keys][3]. For information about the bucket default
+    #     encryption feature, see [Amazon S3 Bucket Default Encryption][4]
     #     in the *Amazon S3 User Guide*.
     #
     #   * If you use PutBucketEncryption to set your [default bucket
-    #     encryption][3] to SSE-KMS, you should verify that your KMS key ID
+    #     encryption][4] 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
@@ -13130,28 +13645,28 @@ module Aws::S3
     #     encrypted with the desired encryption settings. For more
     #     information about the encryption overriding behaviors in directory
     #     buckets, see [Specifying server-side encryption with KMS for new
-    #     object uploads][4].
+    #     object uploads][5].
     #
     #   * Your SSE-KMS configuration can only support 1 [customer managed
-    #     key][5] per directory bucket for the lifetime of the bucket. The
-    #     [Amazon Web Services managed key][6] (`aws/s3`) isn't supported.
+    #     key][6] per directory bucket for the lifetime of the bucket. The
+    #     [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
     #
     #   * S3 Bucket Keys are always enabled for `GET` and `PUT` operations
     #     in a directory bucket and can’t be disabled. S3 Bucket Keys
     #     aren't supported, when you copy SSE-KMS encrypted objects from
     #     general purpose buckets to directory buckets, from directory
     #     buckets to general purpose buckets, or between directory buckets,
-    #     through [CopyObject][7], [UploadPartCopy][8], [the Copy operation
-    #     in Batch Operations][9], or [the import jobs][10]. In this case,
+    #     through [CopyObject][8], [UploadPartCopy][9], [the Copy operation
+    #     in Batch Operations][10], or [the import jobs][11]. In this case,
     #     Amazon S3 makes a call to KMS every time a copy request is made
     #     for a KMS-encrypted object.
     #
-    #   * When you specify an [KMS customer managed key][5] for encryption
+    #   * When you specify an [KMS customer managed key][6] for encryption
     #     in your directory bucket, only use the key ID or key ARN. The key
     #     alias format of the KMS key isn't supported.
     #
     #   * For directory buckets, if you use PutBucketEncryption to set your
-    #     [default bucket encryption][3] to SSE-KMS, Amazon S3 validates the
+    #     [default bucket encryption][4] to SSE-KMS, Amazon S3 validates the
     #     KMS key ID provided in PutBucketEncryption requests.
     #
     #  </note>
@@ -13164,7 +13679,7 @@ module Aws::S3
     #
     #  Also, this action requires Amazon Web Services Signature Version 4.
     # For more information, see [ Authenticating Requests (Amazon Web
-    # Services Signature Version 4)][11].
+    # Services Signature Version 4)][12].
     #
     # Permissions
     # : * **General purpose bucket permissions** - The
@@ -13172,8 +13687,8 @@ module Aws::S3
     #     policy. 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
-    #     Operations][12] and [Managing Access Permissions to Your Amazon S3
-    #     Resources][13] in the *Amazon S3 User Guide*.
+    #     Operations][13] and [Managing Access Permissions to Your Amazon S3
+    #     Resources][14] in the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation, you must have the
@@ -13183,7 +13698,7 @@ module Aws::S3
     #     only be performed by the Amazon Web Services account that owns the
     #     resource. For more information about directory bucket policies and
     #     permissions, see [Amazon Web Services Identity and Access
-    #     Management (IAM) for S3 Express One Zone][14] in the *Amazon S3
+    #     Management (IAM) for S3 Express One Zone][15] in the *Amazon S3
     #     User Guide*.
     #
     #     To set a directory bucket default encryption with SSE-KMS, you
@@ -13194,32 +13709,33 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `PutBucketEncryption`:
     #
-    # * [GetBucketEncryption][15]
+    # * [GetBucketEncryption][16]
     #
-    # * [DeleteBucketEncryption][16]
+    # * [DeleteBucketEncryption][17]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
-    # [5]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
-    # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
-    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html
+    # [6]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk
+    # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
+    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
     #
     # @option params [required, String] :bucket
     #   Specifies default encryption for a bucket using server-side encryption
@@ -13227,13 +13743,14 @@ module Aws::S3
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -13317,7 +13834,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>
     #
@@ -13442,7 +13959,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>
     #
@@ -13594,15 +14111,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
@@ -13745,10 +14262,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
@@ -13756,7 +14269,19 @@ 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
@@ -13768,8 +14293,14 @@ module Aws::S3
     #   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].
+    #   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:
     #
@@ -13789,40 +14320,64 @@ 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 about endpoints in Availability Zones, see [Regional
+    #     and Zonal endpoints for directory buckets in Availability
+    #     Zones][7] in the *Amazon S3 User Guide*. For more information
+    #     about endpoints in Local Zones, see [Available Local Zone for
+    #     directory buckets][8] 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][9]
+    #
+    #   * [DeleteBucketLifecycle][10]
     #
     #
     #
@@ -13831,9 +14386,11 @@ 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/userguide/s3-lzs-for-directory-buckets.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [10]: 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.
@@ -13862,10 +14419,20 @@ 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>
+    #
     # @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.
     #
@@ -13989,7 +14556,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>
     #
@@ -14172,7 +14739,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>
     #
@@ -14276,7 +14843,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>
     #
@@ -14362,7 +14929,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>
     #
@@ -14546,7 +15113,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>
     #
@@ -14620,9 +15187,13 @@ module Aws::S3
     # <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][1] in the *Amazon S3 User Guide*.
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Available Local Zone for directory buckets][2] in the
+    # *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -14652,7 +15223,7 @@ module Aws::S3
     #   * **General purpose bucket permissions** - The `s3:PutBucketPolicy`
     #     permission is required in a policy. For more information about
     #     general purpose buckets bucket policies, see [Using Bucket
-    #     Policies and User Policies][2] in the *Amazon S3 User Guide*.
+    #     Policies and User Policies][3] in the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation, you must have the `s3express:PutBucketPolicy`
@@ -14662,49 +15233,51 @@ module Aws::S3
     #     Services account that owns the resource. For more information
     #     about directory bucket policies and permissions, see [Amazon Web
     #     Services Identity and Access Management (IAM) for S3 Express One
-    #     Zone][3] in the *Amazon S3 User Guide*.
+    #     Zone][4] in the *Amazon S3 User Guide*.
     #
     # Example bucket policies
     #
     # : **General purpose buckets example bucket policies** - See [Bucket
-    #   policy examples][4] in the *Amazon S3 User Guide*.
+    #   policy examples][5] in the *Amazon S3 User Guide*.
     #
     #   **Directory bucket example bucket policies** - See [Example bucket
-    #   policies for S3 Express One Zone][5] in the *Amazon S3 User Guide*.
+    #   policies for S3 Express One Zone][6] in the *Amazon S3 User Guide*.
     #
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
-    #   `s3express-control.region.amazonaws.com`.
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # The following operations are related to `PutBucketPolicy`:
     #
-    # * [CreateBucket][6]
+    # * [CreateBucket][7]
     #
-    # * [DeleteBucket][7]
+    # * [DeleteBucket][8]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket.
     #
     #   <b>Directory buckets </b> - When you use this operation with a
     #   directory bucket, you must use path-style requests in the format
-    #   `https://s3express-control.region_code.amazonaws.com/bucket-name `.
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
     #   Virtual-hosted-style requests aren't supported. Directory bucket
-    #   names must be unique in the chosen Availability Zone. Bucket names
-    #   must also follow the format ` bucket_base_name--az_id--x-s3` (for
-    #   example, ` DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about
-    #   bucket naming restrictions, see [Directory bucket naming rules][1] in
-    #   the *Amazon S3 User Guide*
+    #   names must be unique in the chosen Zone (Availability Zone or Local
+    #   Zone). Bucket names must also follow the format `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
     #
     #
     #
@@ -14815,7 +15388,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>
     #
@@ -15053,7 +15626,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>
     #
@@ -15150,7 +15723,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>
     #
@@ -15301,15 +15874,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>
     #
@@ -15440,7 +16015,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>
     #
@@ -15640,9 +16215,13 @@ module Aws::S3
     # * **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][1] in the *Amazon S3 User Guide*.
+    #   `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    #   `. Path-style requests are not supported. For more information about
+    #   endpoints in Availability Zones, see [Regional and Zonal endpoints
+    #   for directory buckets in Availability Zones][1] in the *Amazon S3
+    #   User Guide*. For more information about endpoints in Local Zones,
+    #   see [Available Local Zone for directory buckets][2] in the *Amazon
+    #   S3 User Guide*.
     #
     #  </note>
     #
@@ -15652,7 +16231,7 @@ module Aws::S3
     # modify this behavior:
     #
     # * **S3 Object Lock** - To prevent objects from being deleted or
-    #   overwritten, you can use [Amazon S3 Object Lock][2] in the *Amazon
+    #   overwritten, you can use [Amazon S3 Object Lock][3] in the *Amazon
     #   S3 User Guide*.
     #
     #   <note markdown="1"> This functionality is not supported for directory buckets.
@@ -15666,9 +16245,9 @@ module Aws::S3
     #   automatically generates a unique version ID of that object being
     #   stored in Amazon S3. You can retrieve, replace, or delete any
     #   version of the object. For more information about versioning, see
-    #   [Adding Objects to Versioning-Enabled Buckets][3] in the *Amazon S3
+    #   [Adding Objects to Versioning-Enabled Buckets][4] in the *Amazon S3
     #   User Guide*. For information about returning the versioning state of
-    #   a bucket, see [GetBucketVersioning][4].
+    #   a bucket, see [GetBucketVersioning][5].
     #
     #   <note markdown="1"> This functionality is not supported for directory buckets.
     #
@@ -15692,7 +16271,7 @@ module Aws::S3
     #       `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
+    #     `CreateSession` ][6] 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
@@ -15703,7 +16282,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][5].
+    #     authorization, see [ `CreateSession` ][6].
     #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -15724,23 +16303,24 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # For more information about related Amazon S3 APIs, see the following:
     #
-    # * [CopyObject][6]
+    # * [CopyObject][7]
     #
-    # * [DeleteObject][7]
+    # * [DeleteObject][8]
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
     #
     # @option params [String] :acl
     #   The canned ACL to apply to the object. For more information, see
@@ -15788,10 +16368,10 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -15999,6 +16579,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
@@ -16058,6 +16658,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.
     #
@@ -16360,43 +16971,28 @@ 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
+    # @example Example: To upload an object (specify optional headers)
     #
-    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
-    #   # S3 returns version ID of the newly created object.
+    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
+    #   # storage class and use server-side encryption.
     #
     #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
-    #     tagging: "key1=value1&key2=value2", 
-    #   })
-    #
-    #   resp.to_h outputs the following:
-    #   {
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
-    #   }
-    #
-    # @example Example: To upload an object and specify canned ACL.
-    #
-    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
-    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
-    #
-    #   resp = client.put_object({
-    #     acl: "authenticated-read", 
-    #     body: "filetoupload", 
-    #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
+    #     server_side_encryption: "AES256", 
+    #     storage_class: "STANDARD_IA", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
+    #     server_side_encryption: "AES256", 
+    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
     # @example Example: To upload an object and specify server-side encryption and object tags
@@ -16440,40 +17036,40 @@ module Aws::S3
     #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
-    # @example Example: To upload an object (specify optional headers)
+    # @example Example: To upload an object and specify canned ACL.
     #
-    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
-    #   # storage class and use server-side encryption.
+    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
+    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg", 
+    #     acl: "authenticated-read", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     server_side_encryption: "AES256", 
-    #     storage_class: "STANDARD_IA", 
+    #     key: "exampleobject", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
+    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
     #   }
     #
-    # @example Example: To create an object.
+    # @example Example: To upload an object and specify optional 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 optional object tags. The bucket is versioned, therefore
+    #   # S3 returns version ID of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "filetoupload", 
+    #     body: "c:\\HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "objectkey", 
+    #     key: "HappyFace.jpg", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
     #   }
     #
     # @example Example: To upload an object
@@ -16493,6 +17089,22 @@ module Aws::S3
     #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
     #   }
     #
+    # @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|
@@ -16518,12 +17130,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",
     #     },
@@ -16559,6 +17173,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
@@ -16570,7 +17185,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>
     #
@@ -16939,7 +17554,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>
     #
@@ -17058,7 +17673,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>
     #
@@ -17177,7 +17792,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>
     #
@@ -17306,7 +17921,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>
     #
@@ -17505,7 +18120,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>
     #
@@ -17613,7 +18228,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>
     #
@@ -17997,7 +18612,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>
     #
@@ -18451,9 +19066,13 @@ module Aws::S3
     # <note markdown="1"> **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][5] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][5] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
@@ -18470,15 +19089,15 @@ module Aws::S3
     #     These permissions are required because Amazon S3 must decrypt and
     #     read data from the encrypted file parts before it completes the
     #     multipart upload. For more information about KMS permissions, see
-    #     [Protecting data using server-side encryption with KMS][6] in the
+    #     [Protecting data using server-side encryption with KMS][7] in the
     #     *Amazon S3 User Guide*. For information about the permissions
     #     required to use the multipart upload API, see [Multipart upload
-    #     and permissions][7] and [Multipart upload API and permissions][8]
+    #     and permissions][8] and [Multipart upload API and permissions][9]
     #     in the *Amazon S3 User Guide*.
     #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
-    #     `CreateSession` ][9] API operation for session-based
+    #     `CreateSession` ][10] 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
@@ -18489,7 +19108,7 @@ module Aws::S3
     #     token for use. Amazon Web Services CLI or SDKs create session and
     #     refresh the session token automatically to avoid service
     #     interruptions when a session expires. For more information about
-    #     authorization, see [ `CreateSession` ][9].
+    #     authorization, see [ `CreateSession` ][10].
     #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -18505,7 +19124,7 @@ module Aws::S3
     #   then Amazon Web Services S3 uses the `x-amz-content-sha256` header
     #   as a checksum instead of `Content-MD5`. For more information see
     #   [Authenticating Requests: Using the Authorization Header (Amazon Web
-    #   Services Signature Version 4)][10].
+    #   Services Signature Version 4)][11].
     #
     #   <note markdown="1"> **Directory buckets** - MD5 is not supported by directory buckets.
     #   You can use checksum algorithms to check object integrity.
@@ -18545,7 +19164,7 @@ 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
+    #     For more information, see [Using Server-Side Encryption][12] in
     #     the *Amazon S3 User Guide*.
     #
     #   * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18567,19 +19186,19 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `UploadPart`:
     #
     # * [CreateMultipartUpload][2]
     #
-    # * [CompleteMultipartUpload][12]
+    # * [CompleteMultipartUpload][13]
     #
-    # * [AbortMultipartUpload][13]
+    # * [AbortMultipartUpload][14]
     #
-    # * [ListParts][14]
+    # * [ListParts][15]
     #
-    # * [ListMultipartUploads][15]
+    # * [ListMultipartUploads][16]
     #
     #
     #
@@ -18588,16 +19207,17 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [String, StringIO, File] :body
     #   Object data.
@@ -18607,10 +19227,10 @@ module Aws::S3
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
@@ -18891,9 +19511,13 @@ module Aws::S3
     # <note markdown="1"> **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][5] in the *Amazon S3 User Guide*.
+    # `https://bucket-name.s3express-zone-id.region-code.amazonaws.com/key-name
+    # `. Path-style requests are not supported. For more information about
+    # endpoints in Availability Zones, see [Regional and Zonal endpoints for
+    # directory buckets in Availability Zones][5] in the *Amazon S3 User
+    # Guide*. For more information about endpoints in Local Zones, see
+    # [Available Local Zone for directory buckets][6] in the *Amazon S3 User
+    # Guide*.
     #
     #  </note>
     #
@@ -18903,7 +19527,7 @@ module Aws::S3
     #   using IAM credentials (access key ID and secret access key for the
     #   IAM identities). All headers with the `x-amz-` prefix, including
     #   `x-amz-copy-source`, must be signed. For more information, see [REST
-    #   Authentication][6].
+    #   Authentication][7].
     #
     #   **Directory buckets** - You must use IAM credentials to authenticate
     #   and authorize your access to the `UploadPartCopy` API operation,
@@ -18940,11 +19564,11 @@ module Aws::S3
     #       permissions are required because Amazon S3 must decrypt and read
     #       data from the encrypted file parts before it completes the
     #       multipart upload. For more information about KMS permissions,
-    #       see [Protecting data using server-side encryption with KMS][7]
+    #       see [Protecting data using server-side encryption with KMS][8]
     #       in the *Amazon S3 User Guide*. For information about the
     #       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*.
+    #       [Multipart upload and permissions][9] and [Multipart upload API
+    #       and permissions][10] 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.
@@ -18967,14 +19591,14 @@ module Aws::S3
     #     identity-based policies and KMS key policies for the KMS key.
     #
     #     For example policies, see [Example bucket policies for S3 Express
-    #     One Zone][10] and [Amazon Web Services Identity and Access
+    #     One Zone][11] and [Amazon Web Services Identity and Access
     #     Management (IAM) identity-based policies for S3 Express One
-    #     Zone][11] in the *Amazon S3 User Guide*.
+    #     Zone][12] in the *Amazon S3 User Guide*.
     #
     # Encryption
     # : * <b>General purpose buckets </b> - For information about using
     #     server-side encryption with customer-provided encryption keys with
-    #     the `UploadPartCopy` operation, see [CopyObject][12] and
+    #     the `UploadPartCopy` operation, see [CopyObject][13] and
     #     [UploadPart][2].
     #
     #   * <b>Directory buckets </b> - For directory buckets, there are only
@@ -18982,7 +19606,7 @@ module Aws::S3
     #     encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
     #     server-side encryption with KMS keys (SSE-KMS) (`aws:kms`). For
     #     more information, see [Protecting data with server-side
-    #     encryption][13] in the *Amazon S3 User Guide*.
+    #     encryption][14] in the *Amazon S3 User Guide*.
     #
     #     <note markdown="1"> For directory buckets, when you perform a `CreateMultipartUpload`
     #     operation and an `UploadPartCopy` operation, the request headers
@@ -18994,7 +19618,7 @@ module Aws::S3
     #     S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted
     #     objects from general purpose buckets to directory buckets, from
     #     directory buckets to general purpose buckets, or between directory
-    #     buckets, through [UploadPartCopy][14]. In this case, Amazon S3
+    #     buckets, through [UploadPartCopy][15]. In this case, Amazon S3
     #     makes a call to KMS every time a copy request is made for a
     #     KMS-encrypted object.
     #
@@ -19016,21 +19640,21 @@ module Aws::S3
     # HTTP Host header syntax
     #
     # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`.
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
     #
     # The following operations are related to `UploadPartCopy`:
     #
-    # * [CreateMultipartUpload][15]
+    # * [CreateMultipartUpload][16]
     #
     # * [UploadPart][2]
     #
-    # * [CompleteMultipartUpload][16]
+    # * [CompleteMultipartUpload][17]
     #
-    # * [AbortMultipartUpload][17]
+    # * [AbortMultipartUpload][18]
     #
-    # * [ListParts][18]
+    # * [ListParts][19]
     #
-    # * [ListMultipartUploads][19]
+    # * [ListMultipartUploads][20]
     #
     #
     #
@@ -19039,34 +19663,43 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
-    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
-    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html
+    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
+    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [20]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [required, String] :bucket
     #   The bucket name.
     #
     #   **Directory buckets** - When you use this operation with a directory
     #   bucket, you must use virtual-hosted-style requests in the format `
-    #   Bucket_name.s3express-az_id.region.amazonaws.com`. Path-style requests
-    #   are not supported. Directory bucket names must be unique in the chosen
-    #   Availability Zone. Bucket names must follow the format `
-    #   bucket_base_name--az-id--x-s3` (for example, `
+    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`. Path-style
+    #   requests are not supported. Directory bucket names must be unique in
+    #   the chosen Zone (Availability Zone or Local Zone). Bucket names must
+    #   follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
     #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
+    #   <note markdown="1"> Copying objects across different Amazon Web Services Regions isn't
+    #   supported when the source or destination bucket is in Amazon Web
+    #   Services Local Zones. The source and destination buckets must have the
+    #   same parent Amazon Web Services Region. Otherwise, you get an HTTP
+    #   `400 Bad Request` error with the error code `InvalidRequest`.
+    #
+    #    </note>
+    #
     #   **Access points** - When you use this action with an access point, you
     #   must provide the alias of the access point in place of the bucket name
     #   or specify the access point ARN. When using the access point ARN, you
@@ -19338,45 +19971,45 @@ module Aws::S3
     #   * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To upload a part by copying data from an existing object as data source
+    # @example Example: To upload a part by copying byte range from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
+    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
+    #   # data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket", 
     #     copy_source: "/bucketname/sourceobjectkey", 
+    #     copy_source_range: "bytes=1-100000", 
     #     key: "examplelargeobject", 
-    #     part_number: 1, 
+    #     part_number: 2, 
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"", 
-    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"), 
+    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"", 
+    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"), 
     #     }, 
     #   }
     #
-    # @example Example: To upload a part by copying byte range from an existing object as data source
+    # @example Example: To upload a part by copying data from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
-    #   # data source.
+    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket", 
     #     copy_source: "/bucketname/sourceobjectkey", 
-    #     copy_source_range: "bytes=1-100000", 
     #     key: "examplelargeobject", 
-    #     part_number: 2, 
+    #     part_number: 1, 
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"", 
-    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"), 
+    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"", 
+    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"), 
     #     }, 
     #   }
     #
@@ -19429,7 +20062,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>
     #
@@ -19838,7 +20471,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.172.0'
+      context[:gem_version] = '1.176.0'
       Seahorse::Client::Request.new(handlers, context)
     end