aws-sdk-s3 1.178.0 → 1.186.1

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

@@ -7,55 +7,55 @@
 #
 # WARNING ABOUT GENERATED CODE
 
-require 'seahorse/client/plugins/content_length.rb'
-require 'aws-sdk-core/plugins/credentials_configuration.rb'
-require 'aws-sdk-core/plugins/logging.rb'
-require 'aws-sdk-core/plugins/param_converter.rb'
-require 'aws-sdk-core/plugins/param_validator.rb'
-require 'aws-sdk-core/plugins/user_agent.rb'
-require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
-require 'aws-sdk-core/plugins/retry_errors.rb'
-require 'aws-sdk-core/plugins/global_configuration.rb'
-require 'aws-sdk-core/plugins/regional_endpoint.rb'
-require 'aws-sdk-core/plugins/endpoint_discovery.rb'
-require 'aws-sdk-core/plugins/endpoint_pattern.rb'
-require 'aws-sdk-core/plugins/response_paging.rb'
-require 'aws-sdk-core/plugins/stub_responses.rb'
-require 'aws-sdk-core/plugins/idempotency_token.rb'
-require 'aws-sdk-core/plugins/invocation_id.rb'
-require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
-require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
-require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
-require 'aws-sdk-core/plugins/transfer_encoding.rb'
-require 'aws-sdk-core/plugins/http_checksum.rb'
-require 'aws-sdk-core/plugins/checksum_algorithm.rb'
-require 'aws-sdk-core/plugins/request_compression.rb'
-require 'aws-sdk-core/plugins/defaults_mode.rb'
-require 'aws-sdk-core/plugins/recursion_detection.rb'
-require 'aws-sdk-core/plugins/telemetry.rb'
-require 'aws-sdk-core/plugins/sign.rb'
-require 'aws-sdk-core/plugins/protocols/rest_xml.rb'
-require 'aws-sdk-s3/plugins/accelerate.rb'
-require 'aws-sdk-s3/plugins/access_grants.rb'
-require 'aws-sdk-s3/plugins/arn.rb'
-require 'aws-sdk-s3/plugins/bucket_dns.rb'
-require 'aws-sdk-s3/plugins/bucket_name_restrictions.rb'
-require 'aws-sdk-s3/plugins/checksum_algorithm.rb'
-require 'aws-sdk-s3/plugins/dualstack.rb'
-require 'aws-sdk-s3/plugins/expect_100_continue.rb'
-require 'aws-sdk-s3/plugins/express_session_auth.rb'
-require 'aws-sdk-s3/plugins/get_bucket_location_fix.rb'
-require 'aws-sdk-s3/plugins/http_200_errors.rb'
-require 'aws-sdk-s3/plugins/iad_regional_endpoint.rb'
-require 'aws-sdk-s3/plugins/location_constraint.rb'
-require 'aws-sdk-s3/plugins/md5s.rb'
-require 'aws-sdk-s3/plugins/redirects.rb'
-require 'aws-sdk-s3/plugins/s3_host_id.rb'
-require 'aws-sdk-s3/plugins/s3_signer.rb'
-require 'aws-sdk-s3/plugins/sse_cpk.rb'
-require 'aws-sdk-s3/plugins/streaming_retry.rb'
-require 'aws-sdk-s3/plugins/url_encoded_keys.rb'
-require 'aws-sdk-core/plugins/event_stream_configuration.rb'
+require 'seahorse/client/plugins/content_length'
+require 'aws-sdk-core/plugins/credentials_configuration'
+require 'aws-sdk-core/plugins/logging'
+require 'aws-sdk-core/plugins/param_converter'
+require 'aws-sdk-core/plugins/param_validator'
+require 'aws-sdk-core/plugins/user_agent'
+require 'aws-sdk-core/plugins/helpful_socket_errors'
+require 'aws-sdk-core/plugins/retry_errors'
+require 'aws-sdk-core/plugins/global_configuration'
+require 'aws-sdk-core/plugins/regional_endpoint'
+require 'aws-sdk-core/plugins/endpoint_discovery'
+require 'aws-sdk-core/plugins/endpoint_pattern'
+require 'aws-sdk-core/plugins/response_paging'
+require 'aws-sdk-core/plugins/stub_responses'
+require 'aws-sdk-core/plugins/idempotency_token'
+require 'aws-sdk-core/plugins/invocation_id'
+require 'aws-sdk-core/plugins/jsonvalue_converter'
+require 'aws-sdk-core/plugins/client_metrics_plugin'
+require 'aws-sdk-core/plugins/client_metrics_send_plugin'
+require 'aws-sdk-core/plugins/transfer_encoding'
+require 'aws-sdk-core/plugins/http_checksum'
+require 'aws-sdk-core/plugins/checksum_algorithm'
+require 'aws-sdk-core/plugins/request_compression'
+require 'aws-sdk-core/plugins/defaults_mode'
+require 'aws-sdk-core/plugins/recursion_detection'
+require 'aws-sdk-core/plugins/telemetry'
+require 'aws-sdk-core/plugins/sign'
+require 'aws-sdk-core/plugins/protocols/rest_xml'
+require 'aws-sdk-s3/plugins/accelerate'
+require 'aws-sdk-s3/plugins/access_grants'
+require 'aws-sdk-s3/plugins/arn'
+require 'aws-sdk-s3/plugins/bucket_dns'
+require 'aws-sdk-s3/plugins/bucket_name_restrictions'
+require 'aws-sdk-s3/plugins/checksum_algorithm'
+require 'aws-sdk-s3/plugins/dualstack'
+require 'aws-sdk-s3/plugins/expect_100_continue'
+require 'aws-sdk-s3/plugins/express_session_auth'
+require 'aws-sdk-s3/plugins/get_bucket_location_fix'
+require 'aws-sdk-s3/plugins/http_200_errors'
+require 'aws-sdk-s3/plugins/iad_regional_endpoint'
+require 'aws-sdk-s3/plugins/location_constraint'
+require 'aws-sdk-s3/plugins/md5s'
+require 'aws-sdk-s3/plugins/redirects'
+require 'aws-sdk-s3/plugins/s3_host_id'
+require 'aws-sdk-s3/plugins/s3_signer'
+require 'aws-sdk-s3/plugins/sse_cpk'
+require 'aws-sdk-s3/plugins/streaming_retry'
+require 'aws-sdk-s3/plugins/url_encoded_keys'
+require 'aws-sdk-core/plugins/event_stream_configuration'
 
 module Aws::S3
   # An API client for S3.  To construct a client, you need to configure a `:region` and `:credentials`.
@@ -256,8 +256,7 @@ module Aws::S3
     #     accepted modes and the configuration defaults that are included.
     #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
-    #     Set to true to disable SDK automatically adding host prefix
-    #     to default service endpoint when available.
+    #     When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
     #
     #   @option options [Boolean] :disable_request_compression (false)
     #     When set to 'true' the request body will not be compressed
@@ -597,13 +596,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][3] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -647,7 +646,7 @@ module Aws::S3
     #
     #
     # [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
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -665,34 +664,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -830,13 +830,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -923,7 +923,7 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
     # [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
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -942,34 +942,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -989,7 +990,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1000,7 +1001,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1011,10 +1012,10 @@ module Aws::S3
     # @option params [String] :checksum_crc64nvme
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
-    #   object. The `CRC-64NVME` checksum is always a full object checksum.
-    #   For more information, see [Checking object integrity in the Amazon S3
-    #   User Guide][1].
+    #   specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
+    #   object. The `CRC64NVME` checksum is always a full object checksum. For
+    #   more information, see [Checking object integrity in the Amazon S3 User
+    #   Guide][1].
     #
     #
     #
@@ -1023,9 +1024,9 @@ module Aws::S3
     # @option params [String] :checksum_sha1
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
-    #   For more information, see [Checking object integrity][1] in the
-    #   *Amazon S3 User Guide*.
+    #   specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
+    #   more information, see [Checking object integrity][1] in the *Amazon S3
+    #   User Guide*.
     #
     #
     #
@@ -1034,7 +1035,7 @@ module Aws::S3
     # @option params [String] :checksum_sha256
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
+    #   specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1299,13 +1300,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][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
@@ -1431,9 +1432,15 @@ module Aws::S3
     #   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-zone-id.region-code.amazonaws.com`.
     #
-    # : <b>Directory buckets </b> - The HTTP Host header syntax is `
-    #   Bucket-name.s3express-zone-id.region-code.amazonaws.com`.
+    #   * **Amazon S3 on Outposts** - When you use this action with S3 on
+    #     Outposts through the REST API, you must direct requests to the S3
+    #     on Outposts hostname. The S3 on Outposts hostname takes the form `
+    #     AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
+    #     The hostname isn't required when you use the Amazon Web Services
+    #     CLI or SDKs.
     #
     # The following operations are related to `CopyObject`:
     #
@@ -1444,7 +1451,7 @@ module Aws::S3
     #
     #
     # [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
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -1498,7 +1505,7 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -1510,30 +1517,36 @@ module Aws::S3
     #
     #    </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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must use the Outpost bucket access point ARN or the access point alias
+    #   for the destination bucket. You can only copy objects within the same
+    #   Outpost bucket. It's not supported to copy objects across different
+    #   Amazon Web Services Outposts, between buckets on the same Outposts, or
+    #   between Outposts buckets and any other bucket types. For more
+    #   information about S3 on Outposts, see [What is S3 on Outposts?][3] in
+    #   the *S3 on Outposts guide*. When you use this action with S3 on
+    #   Outposts through the REST API, you must direct requests to the S3 on
+    #   Outposts hostname, in the format `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   The hostname isn't required when you use the Amazon Web Services CLI
+    #   or SDKs.
     #
     #
     #
@@ -1916,10 +1929,12 @@ module Aws::S3
     #   availability. Depending on performance needs, you can specify a
     #   different Storage Class.
     #
-    #   <note markdown="1"> * <b>Directory buckets </b> - For directory buckets, only the S3
-    #     Express One Zone storage class is supported to store newly created
-    #     objects. Unsupported storage class values won't write a destination
-    #     object and will respond with the HTTP status code `400 Bad Request`.
+    #   <note markdown="1"> * <b>Directory buckets </b> - Directory buckets only support
+    #     `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
+    #     Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
+    #     Access storage class) in Dedicated Local Zones. Unsupported storage
+    #     class values won't write a destination object and will respond with
+    #     the HTTP status code `400 Bad Request`.
     #
     #   * <b>Amazon S3 on Outposts </b> - S3 on Outposts only uses the
     #     `OUTPOSTS` Storage Class.
@@ -2012,20 +2027,17 @@ module Aws::S3
     #   Signature Version in Request Authentication][1] in the *Amazon S3 User
     #   Guide*.
     #
-    #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
-    #   header is implicitly assigned the ID of the KMS symmetric encryption
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. If you want to specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
-    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
-    #   Request` error. Only use the key ID or key ARN. The key alias format
-    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
-    #   support 1 [customer managed key][2] per directory bucket for the
-    #   lifetime of the bucket. The [Amazon Web Services managed key][3]
-    #   (`aws/s3`) isn't supported.
+    #   **Directory buckets** - To encrypt data using SSE-KMS, it's
+    #   recommended to specify the `x-amz-server-side-encryption` header to
+    #   `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
+    #   header implicitly uses the bucket's default KMS customer managed key
+    #   ID. If you want to explicitly set the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
+    #   bucket's default customer managed key (using key ID or ARN, not
+    #   alias). Your SSE-KMS configuration can only support 1 [customer
+    #   managed key][2] per directory bucket's lifetime. The [Amazon Web
+    #   Services managed key][3] (`aws/s3`) isn't supported. Incorrect key
+    #   specification results in an HTTP `400 Bad Request` error.
     #
     #
     #
@@ -2369,8 +2381,8 @@ module Aws::S3
     #   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*.
+    #   Local Zones, see [Concepts for directory buckets in Local Zones][5]
+    #   in the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -2462,7 +2474,7 @@ module Aws::S3
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
     # [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
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -2593,33 +2605,33 @@ module Aws::S3
     #   * {Types::CreateBucketOutput#location #location} => String
     #
     #
-    # @example Example: To create a bucket in a specific region
+    # @example Example: To create a bucket 
     #
-    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
+    #   # The following example creates a bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket", 
-    #     create_bucket_configuration: {
-    #       location_constraint: "eu-west-1", 
-    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/", 
+    #     location: "/examplebucket", 
     #   }
     #
-    # @example Example: To create a bucket 
+    # @example Example: To create a bucket in a specific region
     #
-    #   # The following example creates a bucket.
+    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket", 
+    #     create_bucket_configuration: {
+    #       location_constraint: "eu-west-1", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "/examplebucket", 
+    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -2628,7 +2640,7 @@ module Aws::S3
     #     acl: "private", # accepts private, public-read, public-read-write, authenticated-read
     #     bucket: "BucketName", # required
     #     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_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, ap-southeast-4, ap-southeast-5, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-central-2, eu-north-1, eu-south-1, eu-south-2, eu-west-1, eu-west-2, eu-west-3, il-central-1, me-central-1, 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, LocalZone
     #         name: "LocationNameAsString",
@@ -2775,13 +2787,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][5] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -2983,7 +2995,7 @@ module Aws::S3
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
     # [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
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -3035,34 +3047,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -3415,8 +3428,9 @@ module Aws::S3
     #   a different Storage Class. For more information, see [Storage
     #   Classes][1] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class is
-    #     supported to store newly created objects.
+    #   <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express One
+    #     Zone storage class) in Availability Zones and `ONEZONE_IA` (the S3
+    #     One Zone-Infrequent Access storage class) in Dedicated Local Zones.
     #
     #   * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
     #
@@ -3478,20 +3492,17 @@ module Aws::S3
     #   `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
     #   Amazon Web Services managed key (`aws/s3`) to protect the data.
     #
-    #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
-    #   header is implicitly assigned the ID of the KMS symmetric encryption
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. If you want to specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
-    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
-    #   Request` error. Only use the key ID or key ARN. The key alias format
-    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
-    #   support 1 [customer managed key][1] per directory bucket for the
-    #   lifetime of the bucket. The [Amazon Web Services managed key][2]
-    #   (`aws/s3`) isn't supported.
+    #   **Directory buckets** - To encrypt data using SSE-KMS, it's
+    #   recommended to specify the `x-amz-server-side-encryption` header to
+    #   `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
+    #   header implicitly uses the bucket's default KMS customer managed key
+    #   ID. If you want to explicitly set the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
+    #   bucket's default customer managed key (using key ID or ARN, not
+    #   alias). Your SSE-KMS configuration can only support 1 [customer
+    #   managed key][1] per directory bucket's lifetime. The [Amazon Web
+    #   Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
+    #   specification results in an HTTP `400 Bad Request` error.
     #
     #
     #
@@ -3748,8 +3759,8 @@ module Aws::S3
     #   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*.
+    #   see [Concepts for directory buckets in Local Zones][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
@@ -3855,7 +3866,7 @@ module Aws::S3
     #
     # [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
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
     # [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
@@ -3895,7 +3906,7 @@ module Aws::S3
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
     #
     # @option params [String] :ssekms_key_id
     #   If you specify `x-amz-server-side-encryption` with `aws:kms`, you must
@@ -3908,8 +3919,8 @@ module Aws::S3
     #   the Key ID.
     #
     #   Your SSE-KMS configuration can only support 1 [customer managed
-    #   key][1] per directory bucket for the lifetime of the bucket. The
-    #   [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
+    #   key][1] per directory bucket's lifetime. The [Amazon Web Services
+    #   managed key][2] (`aws/s3`) isn't supported.
     #
     #
     #
@@ -4015,8 +4026,8 @@ module Aws::S3
     #   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*.
+    #   Local Zones, see [Concepts for directory buckets in Local Zones][2]
+    #   in the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -4047,7 +4058,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -4512,8 +4523,8 @@ module Aws::S3
     #     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*.
+    #     about endpoints in Local Zones, see [Concepts for directory
+    #     buckets in Local Zones][4] in the *Amazon S3 User Guide*.
     #
     #      </note>
     # ^
@@ -4536,7 +4547,7 @@ module Aws::S3
     #
     # [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
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -4763,7 +4774,7 @@ module Aws::S3
     # 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
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
     # *Amazon S3 User Guide*.
     #
     #  </note>
@@ -4820,7 +4831,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -5108,13 +5119,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][4] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -5187,7 +5198,7 @@ module Aws::S3
     #
     # [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
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -5204,34 +5215,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5306,7 +5318,7 @@ module Aws::S3
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
+    #   [1]: 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
@@ -5341,6 +5353,15 @@ module Aws::S3
     #   * {Types::DeleteObjectOutput#request_charged #request_charged} => String
     #
     #
+    # @example Example: To delete an object (from a non-versioned bucket)
+    #
+    #   # The following example deletes an object from a non-versioned bucket.
+    #
+    #   resp = client.delete_object({
+    #     bucket: "ExampleBucket", 
+    #     key: "HappyFace.jpg", 
+    #   })
+    #
     # @example Example: To delete an object
     #
     #   # The following example deletes an object from an S3 bucket.
@@ -5354,15 +5375,6 @@ module Aws::S3
     #   {
     #   }
     #
-    # @example Example: To delete an object (from a non-versioned bucket)
-    #
-    #   # The following example deletes an object from a non-versioned bucket.
-    #
-    #   resp = client.delete_object({
-    #     bucket: "ExampleBucket", 
-    #     key: "HappyFace.jpg", 
-    #   })
-    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_object({
@@ -5422,25 +5434,27 @@ module Aws::S3
     # @option params [required, String] :bucket
     #   The bucket name containing the objects from which to remove the tags.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][1] in the *Amazon S3 User Guide*.
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][2] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5522,13 +5536,14 @@ module Aws::S3
     # to delete, then this operation provides a suitable alternative to
     # sending individual delete requests, reducing per-request overhead.
     #
-    # The request can contain a list of up to 1000 keys that you want to
+    # The request can contain a list of up to 1,000 keys that you want to
     # delete. In the XML, you provide the object key names, and optionally,
     # version IDs if you want to delete a specific version of the object
     # from a versioning-enabled bucket. For each key, Amazon S3 performs a
     # delete operation and returns the result of that delete, success or
-    # failure, in the response. Note that if the object specified in the
-    # request is not found, Amazon S3 returns the result as deleted.
+    # failure, in the response. If the object specified in the request
+    # isn't found, Amazon S3 confirms the deletion by returning the result
+    # as deleted.
     #
     # <note markdown="1"> * **Directory buckets** - S3 Versioning isn't enabled and supported
     #   for directory buckets.
@@ -5536,13 +5551,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][2] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -5626,7 +5641,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -5645,34 +5660,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5748,15 +5764,15 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * `CRC-32`
+    #   * `CRC32`
     #
-    #   * `CRC-32C`
+    #   * `CRC32C`
     #
-    #   * `CRC-64NVME`
+    #   * `CRC64NVME`
     #
-    #   * `SHA-1`
+    #   * `SHA1`
     #
-    #   * `SHA-256`
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -6805,8 +6821,8 @@ module Aws::S3
     #     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*.
+    #     about endpoints in Local Zones, see [Concepts for directory
+    #     buckets in Local Zones][6] in the *Amazon S3 User Guide*.
     #
     #      </note>
     #
@@ -6840,7 +6856,7 @@ module Aws::S3
     # [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
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -7024,7 +7040,7 @@ module Aws::S3
     #
     # @example Response structure
     #
-    #   resp.location_constraint #=> String, one of "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"
+    #   resp.location_constraint #=> String, one of "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", "ap-southeast-4", "ap-southeast-5", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-central-2", "eu-north-1", "eu-south-1", "eu-south-2", "eu-west-1", "eu-west-2", "eu-west-3", "il-central-1", "me-central-1", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
     #
@@ -7556,7 +7572,7 @@ module Aws::S3
     # 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
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
     # *Amazon S3 User Guide*.
     #
     #  </note>
@@ -7620,7 +7636,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -7653,8 +7669,7 @@ module Aws::S3
     #   `InvalidAccessPointAliasError` is returned. For more information about
     #   `InvalidAccessPointAliasError`, see [List of Error Codes][2].
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
@@ -8239,7 +8254,7 @@ module Aws::S3
     # **Directory buckets** - Only virtual-hosted-style requests are
     # supported. For a virtual hosted-style request example, if you have the
     # object `photos/2006/February/sample.jpg` in the bucket named
-    # `examplebucket--use1-az5--x-s3`, specify the object key name as
+    # `amzn-s3-demo-bucket--usw2-az1--x-s3`, specify the object key name as
     # `/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
@@ -8248,8 +8263,8 @@ module Aws::S3
     # 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*.
+    # [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
+    # User Guide*.
     #
     # Permissions
     # : * **General purpose bucket permissions** - You must have the
@@ -8310,10 +8325,12 @@ module Aws::S3
     #   objects, see [Restoring Archived Objects][7] in the *Amazon S3 User
     #   Guide*.
     #
-    #   <b>Directory buckets </b> - For directory buckets, only the S3
-    #   Express One Zone storage class is supported to store newly created
-    #   objects. Unsupported storage class values won't write a destination
-    #   object and will respond with the HTTP status code `400 Bad Request`.
+    #   <b>Directory buckets </b> - Directory buckets only support
+    #   `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
+    #   Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
+    #   Access storage class) in Dedicated Local Zones. Unsupported storage
+    #   class values won't write a destination object and will respond with
+    #   the HTTP status code `400 Bad Request`.
     #
     # Encryption
     #
@@ -8385,7 +8402,7 @@ module Aws::S3
     #
     #
     # [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
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -8407,15 +8424,17 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -8428,19 +8447,18 @@ module Aws::S3
     #   takes the form
     #   *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -8690,15 +8708,6 @@ module Aws::S3
     # @option params [String] :checksum_mode
     #   To retrieve the checksum, this mode must be enabled.
     #
-    #   **General purpose buckets** - In addition, if you enable checksum mode
-    #   and the object is uploaded with a [checksum][1] and encrypted with an
-    #   Key Management Service (KMS) key, you must have permission to use the
-    #   `kms:Decrypt` action to retrieve the checksum.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
-    #
     # @return [Types::GetObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetObjectOutput#body #body} => IO
@@ -8742,49 +8751,49 @@ module Aws::S3
     #   * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
     #
     #
-    # @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", 
     #   }
     #
-    # @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", 
     #   }
     #
@@ -8942,11 +8951,13 @@ module Aws::S3
     #   The bucket name that contains the object for which to get the ACL
     #   information.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -9090,13 +9101,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][2] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -9245,7 +9256,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -9271,34 +9282,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -9470,11 +9482,13 @@ module Aws::S3
     #   The bucket name containing the object whose legal hold status you want
     #   to retrieve.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -9565,11 +9579,13 @@ module Aws::S3
     # @option params [required, String] :bucket
     #   The bucket whose Object Lock configuration you want to retrieve.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -9636,11 +9652,13 @@ module Aws::S3
     #   The bucket name containing the object whose retention settings you
     #   want to retrieve.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -9748,25 +9766,27 @@ module Aws::S3
     #   The bucket name containing the object for which to get the tagging
     #   information.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][1] in the *Amazon S3 User Guide*.
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][2] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -9807,49 +9827,49 @@ module Aws::S3
     #   * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
     #
     #
-    # @example Example: To retrieve tag set of an object
+    # @example Example: To retrieve tag set of a specific object version
     #
-    #   # The following example retrieves tag set of an object.
+    #   # The following example retrieves tag set of an object. The request specifies object version.
     #
     #   resp = client.get_object_tagging({
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "exampleobject", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     tag_set: [
     #       {
-    #         key: "Key4", 
-    #         value: "Value4", 
-    #       }, 
-    #       {
-    #         key: "Key3", 
-    #         value: "Value3", 
+    #         key: "Key1", 
+    #         value: "Value1", 
     #       }, 
     #     ], 
-    #     version_id: "null", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   }
     #
-    # @example Example: To retrieve tag set of a specific object version
+    # @example Example: To retrieve tag set of an object
     #
-    #   # The following example retrieves tag set of an object. The request specifies object version.
+    #   # The following example retrieves tag set of an object.
     #
     #   resp = client.get_object_tagging({
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     tag_set: [
     #       {
-    #         key: "Key1", 
-    #         value: "Value1", 
+    #         key: "Key4", 
+    #         value: "Value4", 
+    #       }, 
+    #       {
+    #         key: "Key3", 
+    #         value: "Value3", 
     #       }, 
     #     ], 
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
+    #     version_id: "null", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -10119,8 +10139,8 @@ module Aws::S3
     #   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*.
+    #   see [Concepts for directory buckets in Local Zones][6] in the
+    #   *Amazon S3 User Guide*.
     #
     #    </note>
     #
@@ -10130,7 +10150,7 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
     # [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
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
     # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
     #
     # @option params [required, String] :bucket
@@ -10142,15 +10162,17 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -10164,19 +10186,18 @@ module Aws::S3
     #   `InvalidAccessPointAliasError` is returned. For more information about
     #   `InvalidAccessPointAliasError`, see [List of Error Codes][3].
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][4] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][4] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -10365,13 +10386,13 @@ module Aws::S3
     #   <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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][7] in the
+    #   *Amazon S3 User Guide*.
     #
     #    </note>
     #
@@ -10388,7 +10409,7 @@ module Aws::S3
     # [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-Regions-and-Zones.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -10402,34 +10423,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -10645,6 +10667,7 @@ module Aws::S3
     #   * {Types::HeadObjectOutput#content_encoding #content_encoding} => String
     #   * {Types::HeadObjectOutput#content_language #content_language} => String
     #   * {Types::HeadObjectOutput#content_type #content_type} => String
+    #   * {Types::HeadObjectOutput#content_range #content_range} => String
     #   * {Types::HeadObjectOutput#expires #expires} => Time
     #   * {Types::HeadObjectOutput#expires_string #expires_string} => String
     #   * {Types::HeadObjectOutput#website_redirect_location #website_redirect_location} => String
@@ -10733,6 +10756,7 @@ module Aws::S3
     #   resp.content_encoding #=> String
     #   resp.content_language #=> String
     #   resp.content_type #=> String
+    #   resp.content_range #=> String
     #   resp.expires #=> Time
     #   resp.expires_string #=> String
     #   resp.website_redirect_location #=> String
@@ -11314,7 +11338,7 @@ module Aws::S3
     # 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
+    # Zones, see [Concepts for directory buckets in Local Zones][3] in the
     # *Amazon S3 User Guide*.
     #
     #  </note>
@@ -11343,7 +11367,7 @@ 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
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
     #
@@ -11433,13 +11457,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][3] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -11500,7 +11524,7 @@ module Aws::S3
     #
     #
     # [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
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -11519,34 +11543,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -12117,34 +12142,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -12329,13 +12355,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][4] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -12393,7 +12419,7 @@ module Aws::S3
     #
     # [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
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -12410,34 +12436,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -12678,13 +12705,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][4] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -12738,7 +12765,7 @@ module Aws::S3
     #
     # [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
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -12757,34 +12784,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13045,7 +13073,7 @@ module Aws::S3
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13280,7 +13308,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13596,7 +13624,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13703,7 +13731,7 @@ module Aws::S3
     # 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
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
     # *Amazon S3 User Guide*.
     #
     #  </note>
@@ -13740,8 +13768,8 @@ module Aws::S3
     #     object uploads][5].
     #
     #   * Your SSE-KMS configuration can only support 1 [customer managed
-    #     key][6] per directory bucket for the lifetime of the bucket. The
-    #     [Amazon Web Services managed key][7] (`aws/s3`) isn't supported.
+    #     key][6] per directory bucket's lifetime. 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
@@ -13811,7 +13839,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -13861,7 +13889,7 @@ module Aws::S3
     #    </note>
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14285,7 +14313,7 @@ module Aws::S3
     #   automatically.
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14460,8 +14488,8 @@ module Aws::S3
     #     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*.
+    #     about endpoints in Local Zones, see [Concepts for directory
+    #     buckets in Local Zones][8] in the *Amazon S3 User Guide*.
     #
     #      </note>
     #
@@ -14483,7 +14511,7 @@ module Aws::S3
     # [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/userguide/s3-express-security-iam.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -14492,7 +14520,7 @@ module Aws::S3
     #   The name of the bucket for which to set the configuration.
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14745,7 +14773,7 @@ module Aws::S3
     #   automatically.
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14961,7 +14989,7 @@ module Aws::S3
     #   automatically.
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15288,7 +15316,7 @@ module Aws::S3
     # 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
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
     # *Amazon S3 User Guide*.
     #
     #  </note>
@@ -15352,7 +15380,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -15391,7 +15419,7 @@ module Aws::S3
     #    </note>
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -15401,15 +15429,15 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * `CRC-32`
+    #   * `CRC32`
     #
-    #   * `CRC-32C`
+    #   * `CRC32C`
     #
-    #   * `CRC-64NVME`
+    #   * `CRC64NVME`
     #
-    #   * `SHA-1`
+    #   * `SHA1`
     #
-    #   * `SHA-256`
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -15589,7 +15617,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15762,7 +15790,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -15899,7 +15927,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -16047,7 +16075,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -16208,7 +16236,7 @@ module Aws::S3
     #   [1]: http://www.ietf.org/rfc/rfc1864.txt
     #
     # @option params [String] :checksum_algorithm
-    #   Indicates the algorithm used to create the checksum for the object
+    #   Indicates the algorithm used to create the checksum for the request
     #   when you use the SDK. This header will not provide any additional
     #   functionality if you don't use the SDK. When you send this header,
     #   there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -16312,13 +16340,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-zone-id.region-code.amazonaws.com/key-name
+    #   `https://amzn-s3-demo-bucket.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*.
+    #   see [Concepts for directory buckets in Local Zones][2] in the
+    #   *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -16335,6 +16363,23 @@ module Aws::S3
     #
     #    </note>
     #
+    # * **If-None-Match** - Uploads the object only if the object key name
+    #   does not already exist in the specified bucket. Otherwise, Amazon S3
+    #   returns a `412 Precondition Failed` error. If a conflicting
+    #   operation occurs during the upload, S3 returns a `409
+    #   ConditionalRequestConflict` response. On a 409 failure, retry the
+    #   upload.
+    #
+    #   Expects the * character (asterisk).
+    #
+    #   For more information, see [Add preconditions to S3 operations with
+    #   conditional requests][4] in the *Amazon S3 User Guide* or [RFC
+    #   7232][5].
+    #
+    #   <note markdown="1"> This functionality is not supported for S3 on Outposts.
+    #
+    #    </note>
+    #
     # * **S3 Versioning** - When you enable versioning for a bucket, if
     #   Amazon S3 receives multiple write requests for the same object
     #   simultaneously, it stores all versions of the objects. For each
@@ -16342,9 +16387,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][4] in the *Amazon S3
+    #   [Adding Objects to Versioning-Enabled Buckets][6] in the *Amazon S3
     #   User Guide*. For information about returning the versioning state of
-    #   a bucket, see [GetBucketVersioning][5].
+    #   a bucket, see [GetBucketVersioning][7].
     #
     #   <note markdown="1"> This functionality is not supported for directory buckets.
     #
@@ -16368,7 +16413,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` ][6] API operation for session-based
+    #     `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
@@ -16379,7 +16424,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` ][8].
     #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
@@ -16404,20 +16449,22 @@ module Aws::S3
     #
     # For more information about related Amazon S3 APIs, see the following:
     #
-    # * [CopyObject][7]
+    # * [CopyObject][9]
     #
-    # * [DeleteObject][8]
+    # * [DeleteObject][10]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
+    # [5]: https://datatracker.ietf.org/doc/rfc7232/
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+    # [10]: 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
@@ -16469,34 +16516,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -16590,15 +16638,15 @@ module Aws::S3
     #   For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
     #   the supported algorithm from the following list:
     #
-    #   * `CRC-32`
+    #   * `CRC32`
     #
-    #   * `CRC-32C`
+    #   * `CRC32C`
     #
-    #   * `CRC-64NVME`
+    #   * `CRC64NVME`
     #
-    #   * `SHA-1`
+    #   * `SHA1`
     #
-    #   * `SHA-256`
+    #   * `SHA256`
     #
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
@@ -16627,7 +16675,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -16638,7 +16686,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -16649,10 +16697,10 @@ module Aws::S3
     # @option params [String] :checksum_crc64nvme
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
-    #   object. The `CRC-64NVME` checksum is always a full object checksum.
-    #   For more information, see [Checking object integrity in the Amazon S3
-    #   User Guide][1].
+    #   specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
+    #   object. The `CRC64NVME` checksum is always a full object checksum. For
+    #   more information, see [Checking object integrity in the Amazon S3 User
+    #   Guide][1].
     #
     #
     #
@@ -16661,9 +16709,9 @@ module Aws::S3
     # @option params [String] :checksum_sha1
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
-    #   For more information, see [Checking object integrity][1] in the
-    #   *Amazon S3 User Guide*.
+    #   specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
+    #   more information, see [Checking object integrity][1] in the *Amazon S3
+    #   User Guide*.
     #
     #
     #
@@ -16672,7 +16720,7 @@ module Aws::S3
     # @option params [String] :checksum_sha256
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
+    #   specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -16854,8 +16902,9 @@ module Aws::S3
     #   a different Storage Class. For more information, see [Storage
     #   Classes][1] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class is
-    #     supported to store newly created objects.
+    #   <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express One
+    #     Zone storage class) in Availability Zones and `ONEZONE_IA` (the S3
+    #     One Zone-Infrequent Access storage class) in Dedicated Local Zones.
     #
     #   * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
     #
@@ -16938,20 +16987,17 @@ module Aws::S3
     #   `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
     #   Amazon Web Services managed key (`aws/s3`) to protect the data.
     #
-    #   **Directory buckets** - If you specify `x-amz-server-side-encryption`
-    #   with `aws:kms`, the ` x-amz-server-side-encryption-aws-kms-key-id`
-    #   header is implicitly assigned the ID of the KMS symmetric encryption
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. If you want to specify the `
-    #   x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
-    #   can only specify it with the ID (Key ID or Key ARN) of the KMS
-    #   customer managed key that's configured for your directory bucket's
-    #   default encryption setting. Otherwise, you get an HTTP `400 Bad
-    #   Request` error. Only use the key ID or key ARN. The key alias format
-    #   of the KMS key isn't supported. Your SSE-KMS configuration can only
-    #   support 1 [customer managed key][1] per directory bucket for the
-    #   lifetime of the bucket. The [Amazon Web Services managed key][2]
-    #   (`aws/s3`) isn't supported.
+    #   **Directory buckets** - To encrypt data using SSE-KMS, it's
+    #   recommended to specify the `x-amz-server-side-encryption` header to
+    #   `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
+    #   header implicitly uses the bucket's default KMS customer managed key
+    #   ID. If you want to explicitly set the `
+    #   x-amz-server-side-encryption-aws-kms-key-id` header, it must match the
+    #   bucket's default customer managed key (using key ID or ARN, not
+    #   alias). Your SSE-KMS configuration can only support 1 [customer
+    #   managed key][1] per directory bucket's lifetime. The [Amazon Web
+    #   Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
+    #   specification results in an HTTP `400 Bad Request` error.
     #
     #
     #
@@ -17103,118 +17149,118 @@ module Aws::S3
     #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
     #   }
     #
-    # @example Example: To upload an object
+    # @example Example: To upload an object and specify optional tags
     #
-    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
-    #   # syntax. S3 returns VersionId of the newly created object.
+    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
+    #   # S3 returns version ID of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg", 
+    #     body: "c:\\HappyFace.jpg", 
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
+    #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
     #   }
     #
-    # @example Example: To upload an object and specify server-side encryption and object tags
+    # @example Example: To upload an object (specify optional headers)
     #
-    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
-    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
+    #   # storage class and use server-side encryption.
     #
     #   resp = client.put_object({
-    #     body: "filetoupload", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
+    #     key: "HappyFace.jpg", 
     #     server_side_encryption: "AES256", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     storage_class: "STANDARD_IA", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
     #     server_side_encryption: "AES256", 
-    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
+    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
-    # @example Example: To upload object and specify user-defined metadata
+    # @example Example: To upload an object and specify canned ACL.
     #
-    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
-    #   # enabled, S3 returns version ID in response.
+    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
+    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
+    #     acl: "authenticated-read", 
     #     body: "filetoupload", 
     #     bucket: "examplebucket", 
     #     key: "exampleobject", 
-    #     metadata: {
-    #       "metadata1" => "value1", 
-    #       "metadata2" => "value2", 
-    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
+    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
     #   }
     #
-    # @example Example: To upload an object and specify optional tags
+    # @example Example: To upload an object and specify server-side encryption and object tags
     #
-    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
-    #   # S3 returns version ID of the newly created object.
+    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
+    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "exampleobject", 
+    #     server_side_encryption: "AES256", 
     #     tagging: "key1=value1&key2=value2", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
+    #     server_side_encryption: "AES256", 
+    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
     #   }
     #
-    # @example Example: To upload an object (specify optional headers)
+    # @example Example: To upload object and specify user-defined metadata
     #
-    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
-    #   # storage class and use server-side encryption.
+    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
+    #   # enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     server_side_encryption: "AES256", 
-    #     storage_class: "STANDARD_IA", 
+    #     key: "exampleobject", 
+    #     metadata: {
+    #       "metadata1" => "value1", 
+    #       "metadata2" => "value2", 
+    #     }, 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
-    # @example Example: To upload an object and specify canned ACL.
+    # @example Example: To upload an object
     #
-    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
-    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
+    #   # syntax. S3 returns VersionId of the newly created object.
     #
     #   resp = client.put_object({
-    #     acl: "authenticated-read", 
-    #     body: "filetoupload", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
-    #     key: "exampleobject", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr", 
+    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk", 
     #   }
     #
     # @example Streaming a file from disk
@@ -17483,25 +17529,27 @@ module Aws::S3
     #   The bucket name that contains the object to which you want to attach
     #   the ACL.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][1] in the *Amazon S3 User Guide*.
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][2] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -17686,11 +17734,13 @@ module Aws::S3
     #   The bucket name containing the object that you want to place a legal
     #   hold on.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -17927,11 +17977,13 @@ module Aws::S3
     #   The bucket name that contains the object you want to apply this Object
     #   Retention configuration to.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
@@ -18092,25 +18144,27 @@ module Aws::S3
     # @option params [required, String] :bucket
     #   The bucket name containing the object.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][1] in the *Amazon S3 User Guide*.
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][2] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -18378,20 +18432,19 @@ module Aws::S3
     #
     # Restoring objects
     #
-    # : Objects that you archive to the S3 Glacier Flexible Retrieval
-    #   Flexible Retrieval or S3 Glacier Deep Archive storage class, and S3
-    #   Intelligent-Tiering Archive or S3 Intelligent-Tiering Deep Archive
-    #   tiers, are not accessible in real time. For objects in the S3
-    #   Glacier Flexible Retrieval Flexible Retrieval or S3 Glacier Deep
-    #   Archive storage classes, you must first initiate a restore request,
-    #   and then wait until a temporary copy of the object is available. If
-    #   you want a permanent copy of the object, create a copy of it in the
-    #   Amazon S3 Standard storage class in your S3 bucket. To access an
-    #   archived object, you must restore the object for the duration
-    #   (number of days) that you specify. For objects in the Archive Access
-    #   or Deep Archive Access tiers of S3 Intelligent-Tiering, you must
-    #   first initiate a restore request, and then wait until the object is
-    #   moved into the Frequent Access tier.
+    # : Objects that you archive to the S3 Glacier Flexible Retrieval or S3
+    #   Glacier Deep Archive storage class, and S3 Intelligent-Tiering
+    #   Archive or S3 Intelligent-Tiering Deep Archive tiers, are not
+    #   accessible in real time. For objects in the S3 Glacier Flexible
+    #   Retrieval or S3 Glacier Deep Archive storage classes, you must first
+    #   initiate a restore request, and then wait until a temporary copy of
+    #   the object is available. If you want a permanent copy of the object,
+    #   create a copy of it in the Amazon S3 Standard storage class in your
+    #   S3 bucket. To access an archived object, you must restore the object
+    #   for the duration (number of days) that you specify. For objects in
+    #   the Archive Access or Deep Archive Access tiers of S3
+    #   Intelligent-Tiering, you must first initiate a restore request, and
+    #   then wait until the object is moved into the Frequent Access tier.
     #
     #   To restore a specific object version, you can provide a version ID.
     #   If you don't provide a version ID, Amazon S3 restores the current
@@ -18402,38 +18455,37 @@ module Aws::S3
     #   request body:
     #
     #   * `Expedited` - Expedited retrievals allow you to quickly access
-    #     your data stored in the S3 Glacier Flexible Retrieval Flexible
-    #     Retrieval storage class or S3 Intelligent-Tiering Archive tier
-    #     when occasional urgent requests for restoring archives are
-    #     required. For all but the largest archived objects (250 MB+), data
-    #     accessed using Expedited retrievals is typically made available
-    #     within 1–5 minutes. Provisioned capacity ensures that retrieval
-    #     capacity for Expedited retrievals is available when you need it.
-    #     Expedited retrievals and provisioned capacity are not available
-    #     for objects stored in the S3 Glacier Deep Archive storage class or
-    #     S3 Intelligent-Tiering Deep Archive tier.
+    #     your data stored in the S3 Glacier Flexible Retrieval storage
+    #     class or S3 Intelligent-Tiering Archive tier when occasional
+    #     urgent requests for restoring archives are required. For all but
+    #     the largest archived objects (250 MB+), data accessed using
+    #     Expedited retrievals is typically made available within 1–5
+    #     minutes. Provisioned capacity ensures that retrieval capacity for
+    #     Expedited retrievals is available when you need it. Expedited
+    #     retrievals and provisioned capacity are not available for objects
+    #     stored in the S3 Glacier Deep Archive storage class or S3
+    #     Intelligent-Tiering Deep Archive tier.
     #
     #   * `Standard` - Standard retrievals allow you to access any of your
     #     archived objects within several hours. This is the default option
     #     for retrieval requests that do not specify the retrieval option.
     #     Standard retrievals typically finish within 3–5 hours for objects
-    #     stored in the S3 Glacier Flexible Retrieval Flexible Retrieval
-    #     storage class or S3 Intelligent-Tiering Archive tier. They
-    #     typically finish within 12 hours for objects stored in the S3
-    #     Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep
-    #     Archive tier. Standard retrievals are free for objects stored in
-    #     S3 Intelligent-Tiering.
+    #     stored in the S3 Glacier Flexible Retrieval storage class or S3
+    #     Intelligent-Tiering Archive tier. They typically finish within 12
+    #     hours for objects stored in the S3 Glacier Deep Archive storage
+    #     class or S3 Intelligent-Tiering Deep Archive tier. Standard
+    #     retrievals are free for objects stored in S3 Intelligent-Tiering.
     #
     #   * `Bulk` - Bulk retrievals free for objects stored in the S3 Glacier
     #     Flexible Retrieval and S3 Intelligent-Tiering storage classes,
     #     enabling you to retrieve large amounts, even petabytes, of data at
     #     no cost. Bulk retrievals typically finish within 5–12 hours for
-    #     objects stored in the S3 Glacier Flexible Retrieval Flexible
-    #     Retrieval storage class or S3 Intelligent-Tiering Archive tier.
-    #     Bulk retrievals are also the lowest-cost retrieval option when
-    #     restoring objects from S3 Glacier Deep Archive. They typically
-    #     finish within 48 hours for objects stored in the S3 Glacier Deep
-    #     Archive storage class or S3 Intelligent-Tiering Deep Archive tier.
+    #     objects stored in the S3 Glacier Flexible Retrieval storage class
+    #     or S3 Intelligent-Tiering Archive tier. Bulk retrievals are also
+    #     the lowest-cost retrieval option when restoring objects from S3
+    #     Glacier Deep Archive. They typically finish within 48 hours for
+    #     objects stored in the S3 Glacier Deep Archive storage class or S3
+    #     Intelligent-Tiering Deep Archive tier.
     #
     #   For more information about archive retrieval options and provisioned
     #   capacity for `Expedited` data access, see [Restoring Archived
@@ -18524,25 +18576,27 @@ module Aws::S3
     # @option params [required, String] :bucket
     #   The bucket name containing the object to restore.
     #
-    #   **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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][1] in the *Amazon S3 User Guide*.
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][2] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -18925,122 +18979,128 @@ module Aws::S3
     #
     # @example EventStream Operation Example
     #
-    #   You can process the event once it arrives immediately, or wait until the
-    #   full response is complete and iterate through the eventstream enumerator.
-    #
-    #   To interact with event immediately, you need to register #select_object_content
-    #   with callbacks. Callbacks can be registered for specific events or for all
-    #   events, including error events.
-    #
-    #   Callbacks can be passed into the `:event_stream_handler` option or within a
-    #   block statement attached to the #select_object_content call directly. Hybrid
-    #   pattern of both is also supported.
-    #
-    #   `:event_stream_handler` option takes in either a Proc object or
-    #   Aws::S3::EventStreams::SelectObjectContentEventStream object.
-    #
-    #   Usage pattern a): Callbacks with a block attached to #select_object_content
-    #     Example for registering callbacks for all event types and an error event
-    #
-    #     client.select_object_content( # params input# ) do |stream|
-    #       stream.on_error_event do |event|
-    #         # catch unmodeled error event in the stream
-    #         raise event
-    #         # => Aws::Errors::EventError
-    #         # event.event_type => :error
-    #         # event.error_code => String
-    #         # event.error_message => String
-    #       end
-    #
-    #       stream.on_event do |event|
-    #         # process all events arrive
-    #         puts event.event_type
-    #         ...
-    #       end
-    #
+    #   # You can process the event once it arrives immediately, or wait until the
+    #   # full response is complete and iterate through the eventstream enumerator.
+    #
+    #   # To interact with event immediately, you need to register select_object_content
+    #   # with callbacks. Callbacks can be registered for specific events or for all
+    #   # events, including error events.
+    #
+    #   # Callbacks can be passed into the `:event_stream_handler` option or within a
+    #   # block statement attached to the #select_object_content call directly. Hybrid
+    #   # pattern of both is also supported.
+    #
+    #   # `:event_stream_handler` option takes in either a Proc object or
+    #   # Aws::S3::EventStreams::SelectObjectContentEventStream object.
+    #
+    #   # Usage pattern a): Callbacks with a block attached to #select_object_content
+    #   # Example for registering callbacks for all event types and an error event
+    #   client.select_object_content(
+    #     # params input
+    #   ) do |stream|
+    #     stream.on_error_event do |event|
+    #       # catch unmodeled error event in the stream
+    #       raise event
+    #       # => Aws::Errors::EventError
+    #       # event.event_type => :error
+    #       # event.error_code => String
+    #       # event.error_message => String
     #     end
     #
-    #   Usage pattern b): Pass in `:event_stream_handler` for #select_object_content
+    #     stream.on_event do |event|
+    #       # process all events arrive
+    #       puts event.event_type
+    #       # ...
+    #     end
+    #   end
     #
-    #     1) Create a Aws::S3::EventStreams::SelectObjectContentEventStream object
-    #     Example for registering callbacks with specific events
+    #   # Usage pattern b): Pass in `:event_stream_handler` for #select_object_content
+    #   #  1) Create a Aws::S3::EventStreams::SelectObjectContentEventStream object
+    #   #  Example for registering callbacks with specific events
     #
-    #       handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
-    #       handler.on_records_event do |event|
-    #         event # => Aws::S3::Types::Records
-    #       end
-    #       handler.on_stats_event do |event|
-    #         event # => Aws::S3::Types::Stats
-    #       end
-    #       handler.on_progress_event do |event|
-    #         event # => Aws::S3::Types::Progress
-    #       end
-    #       handler.on_cont_event do |event|
-    #         event # => Aws::S3::Types::Cont
-    #       end
-    #       handler.on_end_event do |event|
-    #         event # => Aws::S3::Types::End
-    #       end
-    #
-    #     client.select_object_content( # params input #, event_stream_handler: handler)
+    #   handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
+    #   handler.on_records_event do |event|
+    #     event # => Aws::S3::Types::Records
+    #   end
+    #   handler.on_stats_event do |event|
+    #     event # => Aws::S3::Types::Stats
+    #   end
+    #   handler.on_progress_event do |event|
+    #     event # => Aws::S3::Types::Progress
+    #   end
+    #   handler.on_cont_event do |event|
+    #     event # => Aws::S3::Types::Cont
+    #   end
+    #   handler.on_end_event do |event|
+    #     event # => Aws::S3::Types::End
+    #   end
     #
-    #     2) Use a Ruby Proc object
-    #     Example for registering callbacks with specific events
+    #   client.select_object_content(
+    #     # params inputs
+    #     event_stream_handler: handler
+    #   )
     #
-    #     handler = Proc.new do |stream|
-    #       stream.on_records_event do |event|
-    #         event # => Aws::S3::Types::Records
-    #       end
-    #       stream.on_stats_event do |event|
-    #         event # => Aws::S3::Types::Stats
-    #       end
-    #       stream.on_progress_event do |event|
-    #         event # => Aws::S3::Types::Progress
-    #       end
-    #       stream.on_cont_event do |event|
-    #         event # => Aws::S3::Types::Cont
-    #       end
-    #       stream.on_end_event do |event|
-    #         event # => Aws::S3::Types::End
-    #       end
+    #   #  2) Use a Ruby Proc object
+    #   #  Example for registering callbacks with specific events
+    #   handler = Proc.new do |stream|
+    #     stream.on_records_event do |event|
+    #       event # => Aws::S3::Types::Records
     #     end
+    #     stream.on_stats_event do |event|
+    #       event # => Aws::S3::Types::Stats
+    #     end
+    #     stream.on_progress_event do |event|
+    #       event # => Aws::S3::Types::Progress
+    #     end
+    #     stream.on_cont_event do |event|
+    #       event # => Aws::S3::Types::Cont
+    #     end
+    #     stream.on_end_event do |event|
+    #       event # => Aws::S3::Types::End
+    #     end
+    #   end
     #
-    #     client.select_object_content( # params input #, event_stream_handler: handler)
-    #
-    #   Usage pattern c): Hybrid pattern of a) and b)
+    #   client.select_object_content(
+    #     # params inputs
+    #     event_stream_handler: handler
+    #   )
     #
-    #       handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
-    #       handler.on_records_event do |event|
-    #         event # => Aws::S3::Types::Records
-    #       end
-    #       handler.on_stats_event do |event|
-    #         event # => Aws::S3::Types::Stats
-    #       end
-    #       handler.on_progress_event do |event|
-    #         event # => Aws::S3::Types::Progress
-    #       end
-    #       handler.on_cont_event do |event|
-    #         event # => Aws::S3::Types::Cont
-    #       end
-    #       handler.on_end_event do |event|
-    #         event # => Aws::S3::Types::End
-    #       end
+    #   #  Usage pattern c): Hybrid pattern of a) and b)
+    #   handler = Aws::S3::EventStreams::SelectObjectContentEventStream.new
+    #   handler.on_records_event do |event|
+    #     event # => Aws::S3::Types::Records
+    #   end
+    #   handler.on_stats_event do |event|
+    #     event # => Aws::S3::Types::Stats
+    #   end
+    #   handler.on_progress_event do |event|
+    #     event # => Aws::S3::Types::Progress
+    #   end
+    #   handler.on_cont_event do |event|
+    #     event # => Aws::S3::Types::Cont
+    #   end
+    #   handler.on_end_event do |event|
+    #     event # => Aws::S3::Types::End
+    #   end
     #
-    #     client.select_object_content( # params input #, event_stream_handler: handler) do |stream|
-    #       stream.on_error_event do |event|
-    #         # catch unmodeled error event in the stream
-    #         raise event
-    #         # => Aws::Errors::EventError
-    #         # event.event_type => :error
-    #         # event.error_code => String
-    #         # event.error_message => String
-    #       end
+    #   client.select_object_content(
+    #     # params input
+    #     event_stream_handler: handler
+    #   ) do |stream|
+    #     stream.on_error_event do |event|
+    #       # catch unmodeled error event in the stream
+    #       raise event
+    #       # => Aws::Errors::EventError
+    #       # event.event_type => :error
+    #       # event.error_code => String
+    #       # event.error_message => String
     #     end
+    #   end
     #
-    #   You can also iterate through events after the response complete.
-    #
-    #   Events are available at resp.payload # => Enumerator
-    #   For parameter input example, please refer to following request syntax
+    #   # You can also iterate through events after the response complete.
+    #   # Events are available at
+    #   resp.payload # => Enumerator
+    #   # For parameter input example, please refer to following request syntax.
     #
     # @example Request syntax with placeholder values
     #
@@ -19093,26 +19153,26 @@ module Aws::S3
     #
     # @example Response structure
     #
-    #   All events are available at resp.payload:
+    #   # All events are available at resp.payload:
     #   resp.payload #=> Enumerator
     #   resp.payload.event_types #=> [:records, :stats, :progress, :cont, :end]
     #
-    #   For :records event available at #on_records_event callback and response eventstream enumerator:
+    #   # For :records event available at #on_records_event callback and response eventstream enumerator:
     #   event.payload #=> IO
     #
-    #   For :stats event available at #on_stats_event callback and response eventstream enumerator:
+    #   # For :stats event available at #on_stats_event callback and response eventstream enumerator:
     #   event.details.bytes_scanned #=> Integer
     #   event.details.bytes_processed #=> Integer
     #   event.details.bytes_returned #=> Integer
     #
-    #   For :progress event available at #on_progress_event callback and response eventstream enumerator:
+    #   # For :progress event available at #on_progress_event callback and response eventstream enumerator:
     #   event.details.bytes_scanned #=> Integer
     #   event.details.bytes_processed #=> Integer
     #   event.details.bytes_returned #=> Integer
     #
-    #   For :cont event available at #on_cont_event callback and response eventstream enumerator:
+    #   # For :cont event available at #on_cont_event callback and response eventstream enumerator:
     #    #=> EmptyStruct
-    #   For :end event available at #on_end_event callback and response eventstream enumerator:
+    #   # For :end event available at #on_end_event callback and response eventstream enumerator:
     #    #=> EmptyStruct
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContent AWS API Documentation
@@ -19181,13 +19241,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -19321,7 +19381,7 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
     # [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
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -19346,34 +19406,35 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-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 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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -19416,7 +19477,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -19427,7 +19488,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object.
+    #   specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -19438,8 +19499,8 @@ module Aws::S3
     # @option params [String] :checksum_crc64nvme
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
-    #   part. For more information, see [Checking object integrity][1] in the
+    #   specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
+    #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
     #
@@ -19449,9 +19510,9 @@ module Aws::S3
     # @option params [String] :checksum_sha1
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
-    #   For more information, see [Checking object integrity][1] in the
-    #   *Amazon S3 User Guide*.
+    #   specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
+    #   more information, see [Checking object integrity][1] in the *Amazon S3
+    #   User Guide*.
     #
     #
     #
@@ -19460,7 +19521,7 @@ module Aws::S3
     # @option params [String] :checksum_sha256
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 256-bit `SHA-256` digest of the object.
+    #   specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
     #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -19640,13 +19701,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-zone-id.region-code.amazonaws.com/key-name
+    # `https://amzn-s3-demo-bucket.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*.
+    # [Concepts for directory buckets in Local Zones][6] in the *Amazon S3
+    # User Guide*.
     #
     #  </note>
     #
@@ -19791,7 +19852,7 @@ module Aws::S3
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
     # [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
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.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
@@ -19817,7 +19878,7 @@ module Aws::S3
     #   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
+    #   amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
     #   naming restrictions, see [Directory bucket naming rules][1] in the
     #   *Amazon S3 User Guide*.
     #
@@ -19829,30 +19890,31 @@ module Aws::S3
     #
     #    </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
-    #   must direct requests to the access point hostname. The access point
-    #   hostname takes the form
+    #   **Access points** - When you use this action with an access point for
+    #   general purpose buckets, you must provide the alias of the access
+    #   point in place of the bucket name or specify the access point ARN.
+    #   When you use this action with an access point for directory buckets,
+    #   you must provide the access point name in place of the bucket name.
+    #   When using the access point ARN, you must direct requests to the
+    #   access point hostname. The access point hostname takes the form
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the Amazon Web
     #   Services SDKs, you provide the access point ARN in place of the bucket
     #   name. For more information about access point ARNs, see [Using access
     #   points][2] in the *Amazon S3 User Guide*.
     #
-    #   <note markdown="1"> Access points and Object Lambda access points are not supported by
-    #   directory buckets.
+    #   <note markdown="1"> Object Lambda access points are not supported by directory buckets.
     #
     #    </note>
     #
-    #   **S3 on Outposts** - When you use this action with Amazon S3 on
-    #   Outposts, you must direct requests to the S3 on Outposts hostname. The
-    #   S3 on Outposts hostname takes the form `
+    #   **S3 on Outposts** - When you use this action with S3 on Outposts, you
+    #   must direct requests to the S3 on Outposts hostname. The S3 on
+    #   Outposts hostname takes the form `
     #   AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
-    #   When you use this action with S3 on Outposts through the Amazon Web
-    #   Services SDKs, you provide the Outposts access point ARN in place of
-    #   the bucket name. For more information about S3 on Outposts ARNs, see
-    #   [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
+    #   When you use this action with S3 on Outposts, the destination bucket
+    #   must be the Outposts access point ARN or the access point alias. For
+    #   more information about S3 on Outposts, see [What is S3 on
+    #   Outposts?][3] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -20100,45 +20162,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"), 
     #     }, 
     #   }
     #
@@ -20338,7 +20400,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object
+    #   specifies the Base64 encoded, 32-bit `CRC32` checksum of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -20358,7 +20420,7 @@ module Aws::S3
     # @option params [String] :checksum_crc32c
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object
+    #   specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -20376,8 +20438,8 @@ module Aws::S3
     # @option params [String] :checksum_crc64nvme
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This header
-    #   specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
-    #   part. For more information, see [Checking object integrity][1] in the
+    #   specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
+    #   For more information, see [Checking object integrity][1] in the
     #   *Amazon S3 User Guide*.
     #
     #
@@ -20387,7 +20449,7 @@ module Aws::S3
     # @option params [String] :checksum_sha1
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the Base64 encoded, 160-bit `SHA-1` digest of the object
+    #   specifies the Base64 encoded, 160-bit `SHA1` digest of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -20405,7 +20467,7 @@ module Aws::S3
     # @option params [String] :checksum_sha256
     #   This header can be used as a data integrity check to verify that the
     #   data received is the same data that was originally sent. This
-    #   specifies the Base64 encoded, 256-bit `SHA-256` digest of the object
+    #   specifies the Base64 encoded, 256-bit `SHA256` digest of the object
     #   returned by the Object Lambda function. This may not match the
     #   checksum for the object stored in Amazon S3. Amazon S3 will perform
     #   validation of the checksum values only when the original `GetObject`
@@ -20422,7 +20484,12 @@ module Aws::S3
     #
     # @option params [Boolean] :delete_marker
     #   Specifies whether an object stored in Amazon S3 is (`true`) or is not
-    #   (`false`) a delete marker.
+    #   (`false`) a delete marker. To learn more about delete markers, see
+    #   [Working with delete markers][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
     #
     # @option params [String] :etag
     #   An opaque identifier assigned by a web server to a specific version of
@@ -20613,7 +20680,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.178.0'
+      context[:gem_version] = '1.186.1'
       Seahorse::Client::Request.new(handlers, context)
     end