RubyGems - aws-sdk-s3 - Versions diffs - 1.169.0 → 1.174.0 - Mend

aws-sdk-s3 1.169.0 → 1.174.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (25) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +30 -0
data/VERSION +1 -1
data/lib/aws-sdk-s3/bucket.rb +34 -0
data/lib/aws-sdk-s3/bucket_lifecycle.rb +5 -0
data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +20 -0
data/lib/aws-sdk-s3/client.rb +522 -296
data/lib/aws-sdk-s3/client_api.rb +32 -0
data/lib/aws-sdk-s3/errors.rb +44 -0
data/lib/aws-sdk-s3/multipart_upload.rb +33 -0
data/lib/aws-sdk-s3/object.rb +74 -0
data/lib/aws-sdk-s3/object_summary.rb +74 -0
data/lib/aws-sdk-s3/object_version.rb +43 -0
data/lib/aws-sdk-s3/plugins/http_200_errors.rb +3 -3
data/lib/aws-sdk-s3/types.rb +300 -92
data/lib/aws-sdk-s3.rb +1 -1
data/sig/bucket.rbs +6 -1
data/sig/client.rbs +14 -3
data/sig/errors.rbs +8 -0
data/sig/multipart_upload.rbs +3 -1
data/sig/object.rbs +6 -1
data/sig/object_summary.rbs +6 -1
data/sig/object_version.rbs +4 -1
data/sig/types.rbs +23 -0
metadata +2 -2

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

@@ -571,7 +571,7 @@ module Aws::S3
     #   in-progress multipart uploads are aborted or completed. To delete
     #   these in-progress multipart uploads, use the `ListMultipartUploads`
     #   operation to list the in-progress multipart uploads in the bucket
-    #   and use the `AbortMultupartUpload` operation to abort all the
+    #   and use the `AbortMultipartUpload` operation to abort all the
     #   in-progress multipart uploads.
     #
     # * **Directory buckets** - For directory buckets, you must make
@@ -703,6 +703,18 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [Time,DateTime,Date,Integer,String] :if_match_initiated_time
+    #   If present, this header aborts an in progress multipart upload only if
+    #   it was initiated on the provided timestamp. If the initiated timestamp
+    #   of the multipart upload does not match the provided value, the
+    #   operation returns a `412 Precondition Failed` error. If the initiated
+    #   timestamp matches or if the multipart upload doesn’t exist, the
+    #   operation returns a `204 Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
     # @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::AbortMultipartUploadOutput#request_charged #request_charged} => String
@@ -730,6 +742,7 @@ module Aws::S3
     #     upload_id: "MultipartUploadId", # required
     #     request_payer: "requester", # accepts requester
     #     expected_bucket_owner: "AccountId",
+    #     if_match_initiated_time: Time.now,
     #   })
     #
     # @example Response structure
@@ -837,7 +850,6 @@ module Aws::S3
     #       except the last part.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `InvalidPart`
     #
     #     * Description: One or more of the specified parts could not be
@@ -845,14 +857,12 @@ module Aws::S3
     #       ETag might not have matched the uploaded part's ETag.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `InvalidPartOrder`
     #
     #     * Description: The list of parts was not in ascending order. The
     #       parts list must be specified in order by part number.
     #
     #     * HTTP Status Code: 400 Bad Request
-    #
     #   * Error Code: `NoSuchUpload`
     #
     #     * Description: The specified multipart upload does not exist. The
@@ -1012,6 +1022,27 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [String] :if_match
+    #   Uploads the object only if the ETag (entity tag) value provided during
+    #   the WRITE operation matches the ETag of the object in S3. If the ETag
+    #   values do not match, the operation returns a `412 Precondition Failed`
+    #   error.
+    #
+    #   If a conflicting operation occurs during the upload S3 returns a `409
+    #   ConditionalRequestConflict` response. On a 409 failure you should
+    #   fetch the object's ETag, re-initiate the multipart upload with
+    #   `CreateMultipartUpload`, and re-upload each part.
+    #
+    #   Expects the ETag value as a string.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1], or
+    #   [Conditional requests][2] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/rfc7232
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
+    #
     # @option params [String] :if_none_match
     #   Uploads the object only if the object key name does not already exist
     #   in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -1147,6 +1178,7 @@ module Aws::S3
     #     checksum_sha256: "ChecksumSHA256",
     #     request_payer: "requester", # accepts requester
     #     expected_bucket_owner: "AccountId",
+    #     if_match: "IfMatch",
     #     if_none_match: "IfNoneMatch",
     #     sse_customer_algorithm: "SSECustomerAlgorithm",
     #     sse_customer_key: "SSECustomerKey",
@@ -1254,7 +1286,6 @@ module Aws::S3
     #     * If the destination bucket is a general purpose bucket, you must
     #       have <b> <code>s3:PutObject</code> </b> permission to write the
     #       object copy to the destination bucket.
-    #
     #   * **Directory bucket permissions** - You must have permissions in a
     #     bucket policy or an IAM identity-based policy based on the source
     #     and destination bucket types in a `CopyObject` operation.
@@ -1272,7 +1303,6 @@ module Aws::S3
     #       `Action` element of a policy to write the object to the
     #       destination. The `s3express:SessionMode` condition key can't be
     #       set to `ReadOnly` on the copy destination bucket.
-    #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
     #     identity-based policies and KMS key policies for the KMS key.
@@ -2309,7 +2339,6 @@ module Aws::S3
     #       more information about S3 Block Public Access, see [Blocking
     #       public access to your Amazon S3 storage ][6] in the *Amazon S3
     #       User Guide*.
-    #
     #   * **Directory bucket permissions** - You must have the
     #     `s3express:CreateBucket` permission in an IAM identity-based
     #     policy instead of a bucket policy. Cross-account access to this
@@ -2477,33 +2506,33 @@ module Aws::S3
     #   * {Types::CreateBucketOutput#location #location} => String
     #
     #
-    # @example Example: To create a bucket in a specific region
+    # @example Example: To create a bucket
     #
-    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
+    #   # The following example creates a bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket",
-    #     create_bucket_configuration: {
-    #       location_constraint: "eu-west-1",
-    #     },
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/",
+    #     location: "/examplebucket",
     #   }
     #
-    # @example Example: To create a bucket
+    # @example Example: To create a bucket in a specific region
     #
-    #   # The following example creates a bucket.
+    #   # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
     #
     #   resp = client.create_bucket({
     #     bucket: "examplebucket",
+    #     create_bucket_configuration: {
+    #       location_constraint: "eu-west-1",
+    #     },
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     location: "/examplebucket",
+    #     location: "http://examplebucket.<Region>.s3.amazonaws.com/",
     #   }
     #
     # @example Request syntax with placeholder values
@@ -2660,7 +2689,6 @@ module Aws::S3
     #       * `x-amz-server-side-encryption-aws-kms-key-id`
     #
     #       * `x-amz-server-side-encryption-context`
-    #
     #       <note markdown="1"> * If you specify `x-amz-server-side-encryption:aws:kms`, but
     #         don't provide `x-amz-server-side-encryption-aws-kms-key-id`,
     #         Amazon S3 uses the Amazon Web Services managed key (`aws/s3`
@@ -2706,12 +2734,10 @@ module Aws::S3
     #       * `x-amz-server-side-encryption-customer-key`
     #
     #       * `x-amz-server-side-encryption-customer-key-MD5`
-    #
     #       For more information about server-side encryption with
     #       customer-provided encryption keys (SSE-C), see [ Protecting data
     #       using server-side encryption with customer-provided encryption
     #       keys (SSE-C)][11] in the *Amazon S3 User Guide*.
-    #
     #   * **Directory buckets** - For directory buckets, there are only two
     #     supported options for server-side encryption: server-side
     #     encryption with Amazon S3 managed keys (SSE-S3) (`AES256`) and
@@ -3885,7 +3911,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -3951,7 +3977,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4115,7 +4141,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4182,7 +4208,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4247,38 +4273,71 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # Deletes the lifecycle configuration from the specified bucket. Amazon
     # S3 removes all the lifecycle configuration rules in the lifecycle
     # subresource associated with the bucket. Your objects never expire, and
     # Amazon S3 no longer automatically deletes any objects on the basis of
     # rules contained in the deleted lifecycle configuration.
     #
-    # To use this operation, you must have permission to perform the
-    # `s3:PutLifecycleConfiguration` action. By default, the bucket owner
-    # has this permission and the bucket owner can grant this permission to
-    # others.
+    # Permissions
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:PutLifecycleConfiguration` permission.
+    #
+    #     For more information about permissions, see [Managing Access
+    #     Permissions to Your Amazon S3 Resources][1].
+    #   ^
     #
-    # There is usually some time lag before lifecycle configuration deletion
-    # is fully propagated to all the Amazon S3 systems.
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:PutLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][2]
+    #     in the *Amazon S3 User Guide*.
+    #
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][3] in the *Amazon
+    #     S3 User Guide*.
+    #
+    #      </note>
+    # ^
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
     # For more information about the object expiration, see [Elements to
-    # Describe Lifecycle Actions][1].
+    # Describe Lifecycle Actions][4].
     #
     # Related actions include:
     #
-    # * [PutBucketLifecycleConfiguration][2]
+    # * [PutBucketLifecycleConfiguration][5]
     #
-    # * [GetBucketLifecycleConfiguration][3]
+    # * [GetBucketLifecycleConfiguration][6]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The bucket name of the lifecycle to delete.
@@ -4288,6 +4347,11 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     #
@@ -4315,7 +4379,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4385,7 +4449,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4559,7 +4623,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4629,7 +4693,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4685,7 +4749,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -4805,7 +4869,6 @@ module Aws::S3
     #       objects from your bucket, you must deny them the
     #       `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
     #       `s3:PutLifeCycleConfiguration` permissions.
-    #
     #   * **Directory buckets permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the
     #     CreateSession API operation for session-based authorization.
@@ -4925,6 +4988,49 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    # @option params [String] :if_match
+    #   The `If-Match` header field makes the request method conditional on
+    #   ETags. If the ETag value does not match, the operation returns a `412
+    #   Precondition Failed` error. If the ETag matches or if the object
+    #   doesn't exist, the operation will return a `204 Success (No Content)
+    #   response`.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1].
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
+    #
+    # @option params [Time,DateTime,Date,Integer,String] :if_match_last_modified_time
+    #   If present, the object is deleted only if its modification times
+    #   matches the provided `Timestamp`. If the `Timestamp` values do not
+    #   match, the operation returns a `412 Precondition Failed` error. If the
+    #   `Timestamp` matches or if the object doesn’t exist, the operation
+    #   returns a `204 Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    # @option params [Integer] :if_match_size
+    #   If present, the object is deleted only if its size matches the
+    #   provided size in bytes. If the `Size` value does not match, the
+    #   operation returns a `412 Precondition Failed` error. If the `Size`
+    #   matches or if the object doesn’t exist, the operation returns a `204
+    #   Success (No Content)` response.
+    #
+    #   <note markdown="1"> This functionality is only supported for directory buckets.
+    #
+    #    </note>
+    #
+    #   You can use the `If-Match`, `x-amz-if-match-last-modified-time` and
+    #   `x-amz-if-match-size` conditional headers in conjunction with
+    #   each-other or individually.
+    #
     # @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteObjectOutput#delete_marker #delete_marker} => Boolean
@@ -4964,6 +5070,9 @@ module Aws::S3
     #     request_payer: "requester", # accepts requester
     #     bypass_governance_retention: false,
     #     expected_bucket_owner: "AccountId",
+    #     if_match: "IfMatch",
+    #     if_match_last_modified_time: Time.now,
+    #     if_match_size: 1,
     #   })
     #
     # @example Response structure
@@ -4981,7 +5090,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5164,7 +5273,6 @@ module Aws::S3
     #     * <b> <code>s3:DeleteObjectVersion</code> </b> - To delete a
     #       specific version of an object from a versioning-enabled bucket,
     #       you must specify the `s3:DeleteObjectVersion` permission.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -5363,20 +5471,22 @@ module Aws::S3
     #   * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
     #
     #
-    # @example Example: To delete multiple objects from a versioned bucket
+    # @example Example: To delete multiple object versions from a versioned bucket
     #
-    #   # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
-    #   # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
+    #   # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
+    #   # versions and returns the key and versions of deleted objects in the response.
     #
     #   resp = client.delete_objects({
     #     bucket: "examplebucket",
     #     delete: {
     #       objects: [
     #         {
-    #           key: "objectkey1",
+    #           key: "HappyFace.jpg",
+    #           version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
     #         },
     #         {
-    #           key: "objectkey2",
+    #           key: "HappyFace.jpg",
+    #           version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
     #         },
     #       ],
     #       quiet: false,
@@ -5387,34 +5497,30 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         delete_marker: true,
-    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
-    #         key: "objectkey1",
+    #         key: "HappyFace.jpg",
+    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
     #       },
     #       {
-    #         delete_marker: true,
-    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
-    #         key: "objectkey2",
+    #         key: "HappyFace.jpg",
+    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
     #       },
     #     ],
     #   }
     #
-    # @example Example: To delete multiple object versions from a versioned bucket
+    # @example Example: To delete multiple objects from a versioned bucket
     #
-    #   # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
-    #   # versions and returns the key and versions of deleted objects in the response.
+    #   # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
+    #   # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
     #
     #   resp = client.delete_objects({
     #     bucket: "examplebucket",
     #     delete: {
     #       objects: [
     #         {
-    #           key: "HappyFace.jpg",
-    #           version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
+    #           key: "objectkey1",
     #         },
     #         {
-    #           key: "HappyFace.jpg",
-    #           version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
+    #           key: "objectkey2",
     #         },
     #       ],
     #       quiet: false,
@@ -5425,12 +5531,14 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         key: "HappyFace.jpg",
-    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
+    #         delete_marker: true,
+    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
+    #         key: "objectkey1",
     #       },
     #       {
-    #         key: "HappyFace.jpg",
-    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
+    #         delete_marker: true,
+    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
+    #         key: "objectkey2",
     #       },
     #     ],
     #   }
@@ -5444,6 +5552,9 @@ module Aws::S3
     #         {
     #           key: "ObjectKey", # required
     #           version_id: "ObjectVersionId",
+    #           etag: "ETag",
+    #           last_modified_time: Time.now,
+    #           size: 1,
     #         },
     #       ],
     #       quiet: false,
@@ -5478,7 +5589,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5535,7 +5646,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5631,7 +5742,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5727,7 +5838,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -5813,7 +5924,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6046,7 +6157,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6130,7 +6241,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6219,7 +6330,7 @@ module Aws::S3
     # version of this topic. This topic is provided for backward
     # compatibility.
     #
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6331,34 +6442,65 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
+    # Returns the lifecycle configuration information set on the bucket. For
+    # information about lifecycle configuration, see [Object Lifecycle
+    # Management][1].
     #
-    # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
+    # Bucket lifecycle configuration now supports specifying a lifecycle
     # rule using an object key name prefix, one or more object tags, object
     # size, or any combination of these. Accordingly, this section describes
-    # the latest API. The previous version of the API supported filtering
-    # based only on an object key name prefix, which is supported for
-    # backward compatibility. For the related API description, see
-    # [GetBucketLifecycle][1]. Accordingly, this section describes the
-    # latest API. The response describes the new filter element that you can
-    # use to specify a filter to select a subset of objects to which the
-    # rule applies. If you are using a previous version of the lifecycle
-    # configuration, it still works. For the earlier action,
+    # the latest API, which is compatible with the new functionality. The
+    # previous version of the API supported filtering based only on an
+    # object key name prefix, which is supported for general purpose buckets
+    # for backward compatibility. For the related API description, see
+    # [GetBucketLifecycle][2].
+    #
+    # <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
+    # objects and cancelling multipart uploads. Expiring of versioned
+    # objects, transitions and tag filters are not supported.
     #
     #  </note>
     #
-    # Returns the lifecycle configuration information set on the bucket. For
-    # information about lifecycle configuration, see [Object Lifecycle
-    # Management][2].
+    # Permissions
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:GetLifecycleConfiguration` permission.
+    #
+    #     For more information about permissions, see [Managing Access
+    #     Permissions to Your Amazon S3 Resources][3].
+    #   ^
     #
-    # To use this operation, you must have permission to perform the
-    # `s3:GetLifecycleConfiguration` action. The bucket owner has this
-    # permission, by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][3] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][4].
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:GetLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][4]
+    #     in the *Amazon S3 User Guide*.
+    #
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][5] in the *Amazon
+    #     S3 User Guide*.
+    #
+    #      </note>
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
     # `GetBucketLifecycleConfiguration` has the following special error:
     #
@@ -6373,20 +6515,21 @@ module Aws::S3
     # The following operations are related to
     # `GetBucketLifecycleConfiguration`:
     #
-    # * [GetBucketLifecycle][1]
+    # * [GetBucketLifecycle][2]
     #
-    # * [PutBucketLifecycle][5]
+    # * [PutBucketLifecycle][6]
     #
-    # * [DeleteBucketLifecycle][6]
+    # * [DeleteBucketLifecycle][7]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which to get the lifecycle information.
@@ -6396,6 +6539,11 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     # @return [Types::GetBucketLifecycleConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetBucketLifecycleConfigurationOutput#rules #rules} => Array&lt;Types::LifecycleRule&gt;
@@ -6476,7 +6624,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6573,7 +6721,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6632,7 +6780,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6718,7 +6866,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6849,7 +6997,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -6964,7 +7112,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7181,7 +7329,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7246,7 +7394,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7369,7 +7517,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7435,7 +7583,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7521,7 +7669,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7598,7 +7746,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -7744,7 +7892,6 @@ module Aws::S3
     #
     #     * If you don’t have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Access Denied` error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][4] API operation for session-based
@@ -8205,49 +8352,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("Thu, 09 Oct 2014 22:57:28 GMT"),
+    #     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("Thu, 15 Dec 2016 01:19:41 GMT"),
+    #     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",
     #   }
     #
@@ -8356,7 +8503,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -8578,7 +8725,6 @@ module Aws::S3
     #     * If you don't have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Forbidden` ("access denied")
     #       error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -8665,7 +8811,6 @@ module Aws::S3
     #     * `If-Match` condition evaluates to `true`.
     #
     #     * `If-Unmodified-Since` condition evaluates to `false`.
-    #
     #     For more information about conditional requests, see [RFC
     #     7232][7].
     #
@@ -8676,7 +8821,6 @@ module Aws::S3
     #     * `If-None-Match` condition evaluates to `false`.
     #
     #     * `If-Modified-Since` condition evaluates to `true`.
-    #
     #     For more information about conditional requests, see [RFC
     #     7232][7].
     #
@@ -8902,7 +9046,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -8998,7 +9142,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9068,7 +9212,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9165,7 +9309,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9334,7 +9478,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9435,7 +9579,7 @@ module Aws::S3
       req.send_request(options, &block)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -9726,7 +9870,6 @@ module Aws::S3
     #
     #     * If you don’t have the `s3:ListBucket` permission, Amazon S3
     #       returns an HTTP status code `403 Forbidden` error.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][3] API operation for session-based
@@ -9798,7 +9941,7 @@ module Aws::S3
     #     a `405 Method Not Allowed` error and the `Last-Modified:
     #     timestamp` response header.
     #
-    #   <note markdown="1"> * **Directory buckets** - Delete marker is not supported by
+    #   <note markdown="1"> * **Directory buckets** - Delete marker is not supported for
     #     directory buckets.
     #
     #   * **Directory buckets** - S3 Versioning isn't enabled and supported
@@ -10123,7 +10266,7 @@ module Aws::S3
     #     content_length: 3191,
     #     content_type: "image/jpeg",
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
+    #     last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
     #     metadata: {
     #     },
     #     version_id: "null",
@@ -10209,7 +10352,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10310,7 +10453,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10402,7 +10545,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10504,7 +10647,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -10606,17 +10749,26 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
     # Returns a list of all buckets owned by the authenticated sender of the
-    # request. To use this operation, you must have the
-    # `s3:ListAllMyBuckets` permission.
+    # request. To grant IAM permission to use this operation, you must add
+    # the `s3:ListAllMyBuckets` policy action.
     #
     # For information about Amazon S3 buckets, see [Creating, configuring,
     # and working with Amazon S3 buckets][1].
     #
+    # We strongly recommend using only paginated `ListBuckets` requests.
+    # Unpaginated `ListBuckets` requests are only supported for Amazon Web
+    # Services accounts set to the default general purpose bucket quota of
+    # 10,000. If you have an approved general purpose bucket quota above
+    # 10,000, you must send paginated `ListBuckets` requests to list your
+    # account’s buckets. All unpaginated `ListBuckets` requests will be
+    # rejected for Amazon Web Services accounts with a general purpose
+    # bucket quota greater than 10,000.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
@@ -10636,6 +10788,14 @@ module Aws::S3
     #
     #   Required: No.
     #
+    #   <note markdown="1"> If you specify the `bucket-region`, `prefix`, or `continuation-token`
+    #   query parameters without using `max-buckets` to set the maximum number
+    #   of buckets returned in the response, Amazon S3 applies a default page
+    #   size of 10,000 and provides a continuation token if there are more
+    #   buckets.
+    #
+    #    </note>
+    #
     # @option params [String] :prefix
     #   Limits the response to bucket names that begin with the specified
     #   bucket name prefix.
@@ -10757,6 +10917,11 @@ module Aws::S3
     # : <b>Directory buckets </b> - The HTTP Host header syntax is
     #   `s3express-control.region.amazonaws.com`.
     #
+    # <note markdown="1"> The `BucketRegion` response element is not part of the
+    # `ListDirectoryBuckets` Response Syntax.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
@@ -10815,7 +10980,7 @@ module Aws::S3
     # multipart uploads are aborted or completed. To delete these
     # in-progress multipart uploads, use the `ListMultipartUploads`
     # operation to list the in-progress multipart uploads in the bucket and
-    # use the `AbortMultupartUpload` operation to abort all the in-progress
+    # use the `AbortMultipartUpload` operation to abort all the in-progress
     # multipart uploads.
     #
     #  </note>
@@ -10888,7 +11053,6 @@ module Aws::S3
     #       initiation time. Among uploads with the same key, the one that
     #       was initiated first will appear before the ones that were
     #       initiated later.
-    #
     #   * **Directory bucket** - In the `ListMultipartUploads` response, the
     #     multipart uploads aren't sorted lexicographically based on the
     #     object keys.
@@ -11245,7 +11409,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -11484,7 +11648,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12378,7 +12542,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12477,7 +12641,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12568,7 +12732,6 @@ module Aws::S3
     #       General Reference.
     #
     #        </note>
-    #
     #     For example, the following `x-amz-grant-write` header grants
     #     create, overwrite, and delete objects permission to LogDelivery
     #     group predefined by Amazon S3 and two Amazon Web Services accounts
@@ -12771,7 +12934,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -12809,14 +12972,12 @@ module Aws::S3
     #   * *Code: InvalidArgument*
     #
     #   * *Cause: Invalid argument.*
-    #
     # * * *HTTP Error: HTTP 400 Bad Request*
     #
     #   * *Code: TooManyConfigurations*
     #
     #   * *Cause: You are attempting to create a new configuration but have
     #     already reached the 1,000-configuration limit.*
-    #
     # * * *HTTP Error: HTTP 403 Forbidden*
     #
     #   * *Code: AccessDenied*
@@ -12909,7 +13070,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13118,7 +13279,6 @@ module Aws::S3
     #     encryption][3] to SSE-KMS, you should verify that your KMS key ID
     #     is correct. Amazon S3 doesn't validate the KMS key ID provided in
     #     PutBucketEncryption requests.
-    #
     # * <b>Directory buckets </b> - You can optionally configure default
     #   encryption for a bucket by using server-side encryption with Key
     #   Management Service (KMS) keys (SSE-KMS).
@@ -13317,7 +13477,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13442,7 +13602,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -13594,15 +13754,15 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # For an updated version of this API, see
     # [PutBucketLifecycleConfiguration][1]. This version has been
     # deprecated. Existing lifecycle configurations will work. For new
     # lifecycle configurations, use the updated API.
     #
+    # <note markdown="1"> This operation is not supported for directory buckets.
+    #
+    #  </note>
+    #
     # Creates a new lifecycle configuration for the bucket or replaces an
     # existing lifecycle configuration. For information about lifecycle
     # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
@@ -13745,10 +13905,6 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
-    #
-    #  </note>
-    #
     # Creates a new lifecycle configuration for the bucket or replaces an
     # existing lifecycle configuration. Keep in mind that this will
     # overwrite an existing lifecycle configuration, so if you want to
@@ -13757,6 +13913,8 @@ module Aws::S3
     # configuration, see [Managing your storage lifecycle][1].
     #
     # Rules
+    # Permissions
+    # HTTP Host header syntax
     #
     # : You specify the lifecycle configuration in your request body. The
     #   lifecycle configuration is specified as XML consisting of one or
@@ -13768,8 +13926,14 @@ module Aws::S3
     #   size, or any combination of these. Accordingly, this section
     #   describes the latest API. The previous version of the API supported
     #   filtering based only on an object key name prefix, which is
-    #   supported for backward compatibility. For the related API
-    #   description, see [PutBucketLifecycle][2].
+    #   supported for backward compatibility for general purpose buckets.
+    #   For the related API description, see [PutBucketLifecycle][2].
+    #
+    #   <note markdown="1"> Lifecyle configurations for directory buckets only support expiring
+    #   objects and cancelling multipart uploads. Expiring of versioned
+    #   objects,transitions and tag filters are not supported.
+    #
+    #    </note>
     #
     #   A lifecycle rule consists of the following:
     #
@@ -13789,40 +13953,61 @@ module Aws::S3
     #
     #   For more information, see [Object Lifecycle Management][3] and
     #   [Lifecycle Configuration Elements][4].
+    # : * **General purpose bucket permissions** - By default, all Amazon S3
+    #     resources are private, including buckets, objects, and related
+    #     subresources (for example, lifecycle configuration and website
+    #     configuration). Only the resource owner (that is, the Amazon Web
+    #     Services account that created it) can access the resource. The
+    #     resource owner can optionally grant access permissions to others
+    #     by writing an access policy. For this operation, a user must have
+    #     the `s3:PutLifecycleConfiguration` permission.
     #
-    # Permissions
+    #     You can also explicitly deny permissions. An explicit deny also
+    #     supersedes any other permissions. If you want to block users or
+    #     accounts from removing or deleting objects from your bucket, you
+    #     must deny them permissions for the following actions:
+    #
+    #     * `s3:DeleteObject`
     #
-    # : By default, all Amazon S3 resources are private, including buckets,
-    #   objects, and related subresources (for example, lifecycle
-    #   configuration and website configuration). Only the resource owner
-    #   (that is, the Amazon Web Services account that created it) can
-    #   access the resource. The resource owner can optionally grant access
-    #   permissions to others by writing an access policy. For this
-    #   operation, a user must get the `s3:PutLifecycleConfiguration`
-    #   permission.
+    #     * `s3:DeleteObjectVersion`
     #
-    #   You can also explicitly deny permissions. An explicit deny also
-    #   supersedes any other permissions. If you want to block users or
-    #   accounts from removing or deleting objects from your bucket, you
-    #   must deny them permissions for the following actions:
+    #     * `s3:PutLifecycleConfiguration`
     #
-    #   * `s3:DeleteObject`
+    #       For more information about permissions, see [Managing Access
+    #       Permissions to Your Amazon S3 Resources][5].
+    #   ^
     #
-    #   * `s3:DeleteObjectVersion`
+    #   * **Directory bucket permissions** - You must have the
+    #     `s3express:PutLifecycleConfiguration` permission in an IAM
+    #     identity-based policy to use this operation. Cross-account access
+    #     to this API operation isn't supported. The resource owner can
+    #     optionally grant access permissions to others by creating a role
+    #     or user for them as long as they are within the same account as
+    #     the owner and resource.
+    #
+    #     For more information about directory bucket policies and
+    #     permissions, see [Authorizing Regional endpoint APIs with IAM][6]
+    #     in the *Amazon S3 User Guide*.
     #
-    #   * `s3:PutLifecycleConfiguration`
+    #     <note markdown="1"> <b>Directory buckets </b> - For directory buckets, you must make
+    #     requests for this API operation to the Regional endpoint. These
+    #     endpoints support path-style requests in the format
+    #     `https://s3express-control.region_code.amazonaws.com/bucket-name
+    #     `. Virtual-hosted-style requests aren't supported. For more
+    #     information, see [Regional and Zonal endpoints][7] in the *Amazon
+    #     S3 User Guide*.
     #
-    #   For more information about permissions, see [Managing Access
-    #   Permissions to Your Amazon S3 Resources][5].
+    #      </note>
     #
-    # The following operations are related to
-    # `PutBucketLifecycleConfiguration`:
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region.amazonaws.com`.
     #
-    # * [Examples of Lifecycle Configuration][6]
+    #   The following operations are related to
+    #   `PutBucketLifecycleConfiguration`:
     #
-    # * [GetBucketLifecycleConfiguration][7]
+    #   * [GetBucketLifecycleConfiguration][8]
     #
-    # * [DeleteBucketLifecycle][8]
+    #   * [DeleteBucketLifecycle][9]
     #
     #
     #
@@ -13831,9 +14016,10 @@ module Aws::S3
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which to set the configuration.
@@ -13862,10 +14048,20 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     # @option params [String] :transition_default_minimum_object_size
     #   Indicates which default minimum object size behavior is applied to the
     #   lifecycle configuration.
     #
+    #   <note markdown="1"> This parameter applies to general purpose buckets only. It is not
+    #   supported for directory bucket lifecycle configurations.
+    #
+    #    </note>
+    #
     #   * `all_storage_classes_128K` - Objects smaller than 128 KB will not
     #     transition to any storage class by default.
     #
@@ -13989,7 +14185,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14172,7 +14368,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14276,7 +14472,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14362,7 +14558,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14546,7 +14742,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -14815,7 +15011,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15053,7 +15249,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15150,7 +15346,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15301,15 +15497,17 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
     # <note markdown="1"> When you enable versioning on a bucket for the first time, it might
-    # take a short amount of time for the change to be fully propagated. We
-    # recommend that you wait for 15 minutes after enabling versioning
-    # before issuing write operations (`PUT` or `DELETE`) on objects in the
-    # bucket.
+    # take a short amount of time for the change to be fully propagated.
+    # While this change is propagating, you may encounter intermittent `HTTP
+    # 404 NoSuchKey` errors for requests to objects created or updated after
+    # enabling versioning. We recommend that you wait for 15 minutes after
+    # enabling versioning before issuing write operations (`PUT` or
+    # `DELETE`) on objects in the bucket.
     #
     #  </note>
     #
@@ -15440,7 +15638,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -15690,7 +15888,6 @@ module Aws::S3
     #     * <b> <code>s3:PutObjectTagging</code> </b> - To successfully set
     #       the tag-set with your `PutObject` request, you must have the
     #       `s3:PutObjectTagging`.
-    #
     #   * **Directory bucket permissions** - To grant access to this API
     #     operation on a directory bucket, we recommend that you use the [
     #     `CreateSession` ][5] API operation for session-based
@@ -16000,6 +16197,26 @@ module Aws::S3
     #
     #   [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
     #
+    # @option params [String] :if_match
+    #   Uploads the object only if the ETag (entity tag) value provided during
+    #   the WRITE operation matches the ETag of the object in S3. If the ETag
+    #   values do not match, the operation returns a `412 Precondition Failed`
+    #   error.
+    #
+    #   If a conflicting operation occurs during the upload S3 returns a `409
+    #   ConditionalRequestConflict` response. On a 409 failure you should
+    #   fetch the object's ETag and retry the upload.
+    #
+    #   Expects the ETag value as a string.
+    #
+    #   For more information about conditional requests, see [RFC 7232][1], or
+    #   [Conditional requests][2] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://tools.ietf.org/html/rfc7232
+    #   [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html
+    #
     # @option params [String] :if_none_match
     #   Uploads the object only if the object key name does not already exist
     #   in the bucket specified. Otherwise, Amazon S3 returns a `412
@@ -16059,6 +16276,17 @@ module Aws::S3
     # @option params [required, String] :key
     #   Object key for which the PUT action was initiated.
     #
+    # @option params [Integer] :write_offset_bytes
+    #   Specifies the offset for appending data to existing objects in bytes.
+    #   The offset must be equal to the size of the existing object being
+    #   appended to. If no object exists, setting this header to 0 will create
+    #   a new object.
+    #
+    #   <note markdown="1"> This functionality is only supported for objects in the Amazon S3
+    #   Express One Zone storage class in directory buckets.
+    #
+    #    </note>
+    #
     # @option params [Hash<String,String>] :metadata
     #   A map of metadata to store with the object in S3.
     #
@@ -16361,61 +16589,84 @@ module Aws::S3
     #   * {Types::PutObjectOutput#ssekms_key_id #ssekms_key_id} => String
     #   * {Types::PutObjectOutput#ssekms_encryption_context #ssekms_encryption_context} => String
     #   * {Types::PutObjectOutput#bucket_key_enabled #bucket_key_enabled} => Boolean
+    #   * {Types::PutObjectOutput#size #size} => Integer
     #   * {Types::PutObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To create an object.
+    # @example Example: To upload an object and specify server-side encryption and object tags
     #
-    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
+    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
     #     body: "filetoupload",
     #     bucket: "examplebucket",
-    #     key: "objectkey",
+    #     key: "exampleobject",
+    #     server_side_encryption: "AES256",
+    #     tagging: "key1=value1&key2=value2",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
+    #     server_side_encryption: "AES256",
+    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
     #   }
     #
-    # @example Example: To upload object and specify user-defined metadata
+    # @example Example: To upload an object
     #
-    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
-    #   # enabled, S3 returns version ID in response.
+    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
+    #   # syntax. S3 returns VersionId of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "filetoupload",
+    #     body: "HappyFace.jpg",
     #     bucket: "examplebucket",
-    #     key: "exampleobject",
-    #     metadata: {
-    #       "metadata1" => "value1",
-    #       "metadata2" => "value2",
-    #     },
+    #     key: "HappyFace.jpg",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
+    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
     #   }
     #
-    # @example Example: To upload an object
+    # @example Example: To upload an object and specify optional tags
     #
-    #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
-    #   # syntax. S3 returns VersionId of the newly created object.
+    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
+    #   # S3 returns version ID of the newly created object.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg",
+    #     body: "c:\\HappyFace.jpg",
     #     bucket: "examplebucket",
     #     key: "HappyFace.jpg",
+    #     tagging: "key1=value1&key2=value2",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
+    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
+    #   }
+    #
+    # @example Example: To upload object and specify user-defined metadata
+    #
+    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
+    #   # enabled, S3 returns version ID in response.
+    #
+    #   resp = client.put_object({
+    #     body: "filetoupload",
+    #     bucket: "examplebucket",
+    #     key: "exampleobject",
+    #     metadata: {
+    #       "metadata1" => "value1",
+    #       "metadata2" => "value2",
+    #     },
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
     #   }
     #
     # @example Example: To upload an object and specify canned ACL.
@@ -16456,42 +16707,20 @@ module Aws::S3
     #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
     #   }
     #
-    # @example Example: To upload an object and specify optional tags
-    #
-    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
-    #   # S3 returns version ID of the newly created object.
-    #
-    #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg",
-    #     bucket: "examplebucket",
-    #     key: "HappyFace.jpg",
-    #     tagging: "key1=value1&key2=value2",
-    #   })
-    #
-    #   resp.to_h outputs the following:
-    #   {
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
-    #   }
-    #
-    # @example Example: To upload an object and specify server-side encryption and object tags
+    # @example Example: To create an object.
     #
-    #   # The following example uploads an object. The request specifies the optional server-side encryption option. The request
-    #   # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
     #     body: "filetoupload",
     #     bucket: "examplebucket",
-    #     key: "exampleobject",
-    #     server_side_encryption: "AES256",
-    #     tagging: "key1=value1&key2=value2",
+    #     key: "objectkey",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     server_side_encryption: "AES256",
-    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
+    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
     #   }
     #
     # @example Streaming a file from disk
@@ -16519,12 +16748,14 @@ module Aws::S3
     #     checksum_sha1: "ChecksumSHA1",
     #     checksum_sha256: "ChecksumSHA256",
     #     expires: Time.now,
+    #     if_match: "IfMatch",
     #     if_none_match: "IfNoneMatch",
     #     grant_full_control: "GrantFullControl",
     #     grant_read: "GrantRead",
     #     grant_read_acp: "GrantReadACP",
     #     grant_write_acp: "GrantWriteACP",
     #     key: "ObjectKey", # required
+    #     write_offset_bytes: 1,
     #     metadata: {
     #       "MetadataKey" => "MetadataValue",
     #     },
@@ -16560,6 +16791,7 @@ module Aws::S3
     #   resp.ssekms_key_id #=> String
     #   resp.ssekms_encryption_context #=> String
     #   resp.bucket_key_enabled #=> Boolean
+    #   resp.size #=> Integer
     #   resp.request_charged #=> String, one of "requester"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObject AWS API Documentation
@@ -16571,7 +16803,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -16655,7 +16887,6 @@ module Aws::S3
     #       General Reference.
     #
     #        </note>
-    #
     #     For example, the following `x-amz-grant-read` header grants list
     #     objects permission to the two Amazon Web Services accounts
     #     identified by their email addresses.
@@ -16941,7 +17172,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17060,7 +17291,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17179,7 +17410,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17308,7 +17539,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17507,7 +17738,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17615,7 +17846,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -17761,7 +17992,6 @@ module Aws::S3
     #     * *HTTP Status Code: 409 Conflict*
     #
     #     * *SOAP Fault Code Prefix: Client*
-    #
     #   * * *Code: GlacierExpeditedRetrievalNotAvailable*
     #
     #     * *Cause: expedited retrievals are currently not available. Try
@@ -18000,7 +18230,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -18548,7 +18778,6 @@ module Aws::S3
     #     * x-amz-server-side-encryption-customer-key
     #
     #     * x-amz-server-side-encryption-customer-key-MD5
-    #
     #     For more information, see [Using Server-Side Encryption][11] in
     #     the *Amazon S3 User Guide*.
     #
@@ -18949,7 +19178,6 @@ module Aws::S3
     #       permissions required to use the multipart upload API, see
     #       [Multipart upload and permissions][8] and [Multipart upload API
     #       and permissions][9] in the *Amazon S3 User Guide*.
-    #
     #   * **Directory bucket permissions** - You must have permissions in a
     #     bucket policy or an IAM identity-based policy based on the source
     #     and destination bucket types in an `UploadPartCopy` operation.
@@ -18967,7 +19195,6 @@ module Aws::S3
     #       `Action` element of a policy to write the object to the
     #       destination. The `s3express:SessionMode` condition key cannot be
     #       set to `ReadOnly` on the copy destination.
-    #
     #     If the object is encrypted with SSE-KMS, you must also have the
     #     `kms:GenerateDataKey` and `kms:Decrypt` permissions in IAM
     #     identity-based policies and KMS key policies for the KMS key.
@@ -19012,7 +19239,6 @@ module Aws::S3
     #       been aborted or completed.
     #
     #     * HTTP Status Code: 404 Not Found
-    #
     #   * Error Code: `InvalidRequest`
     #
     #     * Description: The specified copy source is not supported as a
@@ -19345,45 +19571,45 @@ module Aws::S3
     #   * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To upload a part by copying byte range from an existing object as data source
+    # @example Example: To upload a part by copying data from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
-    #   # data source.
+    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket",
     #     copy_source: "/bucketname/sourceobjectkey",
-    #     copy_source_range: "bytes=1-100000",
     #     key: "examplelargeobject",
-    #     part_number: 2,
+    #     part_number: 1,
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"",
-    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
+    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
+    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
     #     },
     #   }
     #
-    # @example Example: To upload a part by copying data from an existing object as data source
+    # @example Example: To upload a part by copying byte range from an existing object as data source
     #
-    #   # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
+    #   # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
+    #   # data source.
     #
     #   resp = client.upload_part_copy({
     #     bucket: "examplebucket",
     #     copy_source: "/bucketname/sourceobjectkey",
+    #     copy_source_range: "bytes=1-100000",
     #     key: "examplelargeobject",
-    #     part_number: 1,
+    #     part_number: 2,
     #     upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     copy_part_result: {
-    #       etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
-    #       last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
+    #       etag: "\"65d16d19e65a7508a51f043180edcc36\"",
+    #       last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
     #     },
     #   }
     #
@@ -19436,7 +19662,7 @@ module Aws::S3
       req.send_request(options)
     end
-    # <note markdown="1"> This operation is not supported by directory buckets.
+    # <note markdown="1"> This operation is not supported for directory buckets.
     #
     #  </note>
     #
@@ -19845,7 +20071,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.169.0'
+      context[:gem_version] = '1.174.0'
       Seahorse::Client::Request.new(handlers, context)
     end