aws-sdk-s3 1.118.0 → 1.119.2

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

@@ -469,7 +469,7 @@ module Aws::S3
     # For information about permissions required to use the multipart
     # upload, see [Multipart Upload and Permissions][2].
     #
-    # The following operations are related to `AbortMultipartUpload`\:
+    # The following operations are related to `AbortMultipartUpload`:
     #
     # * [CreateMultipartUpload][3]
     #
@@ -649,7 +649,7 @@ module Aws::S3
     #
     #   * 404 Not Found
     #
-    # The following operations are related to `CompleteMultipartUpload`\:
+    # The following operations are related to `CompleteMultipartUpload`:
     #
     # * [CreateMultipartUpload][5]
     #
@@ -1075,7 +1075,7 @@ module Aws::S3
     # copy of this object before you can use it as a source object for the
     # copy operation. For more information, see [RestoreObject][14].
     #
-    # The following operations are related to `CopyObject`\:
+    # The following operations are related to `CopyObject`:
     #
     # * [PutObject][15]
     #
@@ -1162,7 +1162,7 @@ module Aws::S3
     # @option params [required, String] :copy_source
     #   Specifies the source object for the copy operation. You specify the
     #   value in one of two formats, depending on whether you want to access
-    #   the source object through an [access point][1]\:
+    #   the source object through an [access point][1]:
     #
     #   * For objects not accessed through an access point, specify the name
     #     of the source bucket and the key of the source object, separated by
@@ -1605,7 +1605,7 @@ module Aws::S3
     #   the `x-amz-object-ownership` header, `s3:PutBucketOwnershipControls`
     #   permission is required.
     #
-    # The following operations are related to `CreateBucket`\:
+    # The following operations are related to `CreateBucket`:
     #
     # * [PutObject][9]
     #
@@ -1945,7 +1945,7 @@ module Aws::S3
     #
     #     `x-amz-grant-read: id="11112222333", id="444455556666" `
     #
-    # The following operations are related to `CreateMultipartUpload`\:
+    # The following operations are related to `CreateMultipartUpload`:
     #
     # * [UploadPart][1]
     #
@@ -2317,7 +2317,7 @@ module Aws::S3
     # Analytics – Storage Class Analysis][3].
     #
     # The following operations are related to
-    # `DeleteBucketAnalyticsConfiguration`\:
+    # `DeleteBucketAnalyticsConfiguration`:
     #
     # * [GetBucketAnalyticsConfiguration][4]
     #
@@ -2678,7 +2678,7 @@ module Aws::S3
     # [Monitoring Metrics with Amazon CloudWatch][3].
     #
     # The following operations are related to
-    # `DeleteBucketMetricsConfiguration`\:
+    # `DeleteBucketMetricsConfiguration`:
     #
     # * [GetBucketMetricsConfiguration][4]
     #
@@ -2736,7 +2736,7 @@ module Aws::S3
     # Ownership][2].
     #
     # The following operations are related to
-    # `DeleteBucketOwnershipControls`\:
+    # `DeleteBucketOwnershipControls`:
     #
     # * GetBucketOwnershipControls
     #
@@ -2857,7 +2857,7 @@ module Aws::S3
     # For information about replication configuration, see [Replication][3]
     # in the *Amazon S3 User Guide*.
     #
-    # The following operations are related to `DeleteBucketReplication`\:
+    # The following operations are related to `DeleteBucketReplication`:
     #
     # * [PutBucketReplication][4]
     #
@@ -2912,7 +2912,7 @@ module Aws::S3
     # `s3:PutBucketTagging` action. By default, the bucket owner has this
     # permission and can grant this permission to others.
     #
-    # The following operations are related to `DeleteBucketTagging`\:
+    # The following operations are related to `DeleteBucketTagging`:
     #
     # * [GetBucketTagging][1]
     #
@@ -2974,7 +2974,7 @@ module Aws::S3
     # For more information about hosting websites, see [Hosting Websites on
     # Amazon S3][1].
     #
-    # The following operations are related to `DeleteBucketWebsite`\:
+    # The following operations are related to `DeleteBucketWebsite`:
     #
     # * [GetBucketWebsite][2]
     #
@@ -3048,7 +3048,7 @@ module Aws::S3
     # `s3:DeleteObject`, `s3:DeleteObjectVersion`, and
     # `s3:PutLifeCycleConfiguration` actions.
     #
-    # The following action is related to `DeleteObject`\:
+    # The following action is related to `DeleteObject`:
     #
     # * [PutObject][4]
     #
@@ -3126,6 +3126,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.
@@ -3139,15 +3148,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({
@@ -3186,7 +3186,7 @@ module Aws::S3
     # `s3:DeleteObjectVersionTagging` action.
     #
     # The following operations are related to
-    # `DeleteBucketMetricsConfiguration`\:
+    # `DeleteBucketMetricsConfiguration`:
     #
     # * [PutObjectTagging][2]
     #
@@ -3240,35 +3240,35 @@ module Aws::S3
     #   * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
     #
     #
-    # @example Example: To remove tag set from an object version
+    # @example Example: To remove tag set from an object
     #
-    #   # The following example removes tag set associated with the specified object version. The request specifies both the
-    #   # object key and object version.
+    #   # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
+    #   # operation removes tag set from the latest object version.
     #
     #   resp = client.delete_object_tagging({
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
+    #     version_id: "null", 
     #   }
     #
-    # @example Example: To remove tag set from an object
+    # @example Example: To remove tag set from an object version
     #
-    #   # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
-    #   # operation removes tag set from the latest object version.
+    #   # The following example removes tag set associated with the specified object version. The request specifies both the
+    #   # object key and object version.
     #
     #   resp = client.delete_object_tagging({
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     version_id: "null", 
+    #     version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI", 
     #   }
     #
     # @example Request syntax with placeholder values
@@ -3325,7 +3325,7 @@ module Aws::S3
     # Delete requests. Amazon S3 uses the header value to ensure that your
     # request body has not been altered in transit.
     #
-    # The following operations are related to `DeleteObjects`\:
+    # The following operations are related to `DeleteObjects`:
     #
     # * [CreateMultipartUpload][2]
     #
@@ -3427,22 +3427,20 @@ module Aws::S3
     #   * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
     #
     #
-    # @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, 
@@ -3453,30 +3451,34 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         key: "HappyFace.jpg", 
-    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
+    #         delete_marker: true, 
+    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F", 
+    #         key: "objectkey1", 
     #       }, 
     #       {
-    #         key: "HappyFace.jpg", 
-    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
+    #         delete_marker: true, 
+    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt", 
+    #         key: "objectkey2", 
     #       }, 
     #     ], 
     #   }
     #
-    # @example Example: To delete multiple objects from a versioned bucket
+    # @example Example: To delete multiple object versions from a versioned bucket
     #
-    #   # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
-    #   # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
+    #   # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
+    #   # versions and returns the key and versions of deleted objects in the response.
     #
     #   resp = client.delete_objects({
     #     bucket: "examplebucket", 
     #     delete: {
     #       objects: [
     #         {
-    #           key: "objectkey1", 
+    #           key: "HappyFace.jpg", 
+    #           version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
     #         }, 
     #         {
-    #           key: "objectkey2", 
+    #           key: "HappyFace.jpg", 
+    #           version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
     #         }, 
     #       ], 
     #       quiet: false, 
@@ -3487,14 +3489,12 @@ module Aws::S3
     #   {
     #     deleted: [
     #       {
-    #         delete_marker: true, 
-    #         delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F", 
-    #         key: "objectkey1", 
+    #         key: "HappyFace.jpg", 
+    #         version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd", 
     #       }, 
     #       {
-    #         delete_marker: true, 
-    #         delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt", 
-    #         key: "objectkey2", 
+    #         key: "HappyFace.jpg", 
+    #         version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b", 
     #       }, 
     #     ], 
     #   }
@@ -3549,7 +3549,7 @@ module Aws::S3
     # Operations][1] and [Managing Access Permissions to Your Amazon S3
     # Resources][2].
     #
-    # The following operations are related to `DeletePublicAccessBlock`\:
+    # The following operations are related to `DeletePublicAccessBlock`:
     #
     # * [Using Amazon S3 Block Public Access][3]
     #
@@ -3824,7 +3824,7 @@ module Aws::S3
     # For more information about CORS, see [ Enabling Cross-Origin Resource
     # Sharing][1].
     #
-    # The following operations are related to `GetBucketCors`\:
+    # The following operations are related to `GetBucketCors`:
     #
     # * [PutBucketCors][2]
     #
@@ -3920,7 +3920,7 @@ module Aws::S3
     # Related to Bucket Subresource Operations][2] and [Managing Access
     # Permissions to Your Amazon S3 Resources][3].
     #
-    # The following operations are related to `GetBucketEncryption`\:
+    # The following operations are related to `GetBucketEncryption`:
     #
     # * [PutBucketEncryption][4]
     #
@@ -4064,7 +4064,7 @@ module Aws::S3
     # Inventory][3].
     #
     # The following operations are related to
-    # `GetBucketInventoryConfiguration`\:
+    # `GetBucketInventoryConfiguration`:
     #
     # * [DeleteBucketInventoryConfiguration][4]
     #
@@ -4156,7 +4156,7 @@ module Aws::S3
     #
     #   * SOAP Fault Code Prefix: Client
     #
-    # The following operations are related to `GetBucketLifecycle`\:
+    # The following operations are related to `GetBucketLifecycle`:
     #
     # * [GetBucketLifecycleConfiguration][1]
     #
@@ -4276,7 +4276,7 @@ module Aws::S3
     #   * SOAP Fault Code Prefix: Client
     #
     # The following operations are related to
-    # `GetBucketLifecycleConfiguration`\:
+    # `GetBucketLifecycleConfiguration`:
     #
     # * [GetBucketLifecycle][1]
     #
@@ -4389,7 +4389,7 @@ module Aws::S3
     # To use this API against an access point, provide the alias of the
     # access point in place of the bucket name.
     #
-    # The following operations are related to `GetBucketLocation`\:
+    # The following operations are related to `GetBucketLocation`:
     #
     # * [GetObject][2]
     #
@@ -4450,7 +4450,7 @@ module Aws::S3
     # to view and modify that status. To use GET, you must be the bucket
     # owner.
     #
-    # The following operations are related to `GetBucketLogging`\:
+    # The following operations are related to `GetBucketLogging`:
     #
     # * [CreateBucket][1]
     #
@@ -4516,7 +4516,7 @@ module Aws::S3
     # [Monitoring Metrics with Amazon CloudWatch][3].
     #
     # The following operations are related to
-    # `GetBucketMetricsConfiguration`\:
+    # `GetBucketMetricsConfiguration`:
     #
     # * [PutBucketMetricsConfiguration][4]
     #
@@ -4709,7 +4709,7 @@ module Aws::S3
     # Events][1]. For more information about bucket policies, see [Using
     # Bucket Policies][2].
     #
-    # The following action is related to `GetBucketNotification`\:
+    # The following action is related to `GetBucketNotification`:
     #
     # * [PutBucketNotification][3]
     #
@@ -4788,7 +4788,7 @@ module Aws::S3
     # For information about Amazon S3 Object Ownership, see [Using Object
     # Ownership][2].
     #
-    # The following operations are related to `GetBucketOwnershipControls`\:
+    # The following operations are related to `GetBucketOwnershipControls`:
     #
     # * PutBucketOwnershipControls
     #
@@ -4852,7 +4852,7 @@ module Aws::S3
     # For more information about bucket policies, see [Using Bucket Policies
     # and User Policies][1].
     #
-    # The following action is related to `GetBucketPolicy`\:
+    # The following action is related to `GetBucketPolicy`:
     #
     # * [GetObject][2]
     #
@@ -4918,7 +4918,7 @@ module Aws::S3
     # For more information about when Amazon S3 considers a bucket public,
     # see [The Meaning of "Public"][2].
     #
-    # The following operations are related to `GetBucketPolicyStatus`\:
+    # The following operations are related to `GetBucketPolicyStatus`:
     #
     # * [Using Amazon S3 Block Public Access][3]
     #
@@ -4992,7 +4992,7 @@ module Aws::S3
     # For information about `GetBucketReplication` errors, see [List of
     # replication-related error codes][3]
     #
-    # The following operations are related to `GetBucketReplication`\:
+    # The following operations are related to `GetBucketReplication`:
     #
     # * [PutBucketReplication][4]
     #
@@ -5093,7 +5093,7 @@ module Aws::S3
     # version of the operation, you must be the bucket owner. For more
     # information, see [Requester Pays Buckets][1].
     #
-    # The following operations are related to `GetBucketRequestPayment`\:
+    # The following operations are related to `GetBucketRequestPayment`:
     #
     # * [ListObjects][2]
     #
@@ -5165,7 +5165,7 @@ module Aws::S3
     #
     #   ^
     #
-    # The following operations are related to `GetBucketTagging`\:
+    # The following operations are related to `GetBucketTagging`:
     #
     # * [PutBucketTagging][1]
     #
@@ -5243,7 +5243,7 @@ module Aws::S3
     # owner must use an authentication device to change the versioning state
     # of the bucket.
     #
-    # The following operations are related to `GetBucketVersioning`\:
+    # The following operations are related to `GetBucketVersioning`:
     #
     # * [GetObject][1]
     #
@@ -5317,7 +5317,7 @@ module Aws::S3
     # the website configuration by writing a bucket policy granting them the
     # `S3:GetBucketWebsite` permission.
     #
-    # The following operations are related to `DeleteBucketWebsite`\:
+    # The following operations are related to `DeleteBucketWebsite`:
     #
     # * [DeleteBucketWebsite][2]
     #
@@ -5532,7 +5532,7 @@ module Aws::S3
     #
     # For more information about conditional requests, see [RFC 7232][9].
     #
-    # The following operations are related to `GetObject`\:
+    # The following operations are related to `GetObject`:
     #
     # * [ListBuckets][10]
     #
@@ -5718,49 +5718,49 @@ module Aws::S3
     #   * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
     #
     #
-    # @example Example: To retrieve an object
+    # @example Example: To retrieve a byte range of an object 
     #
-    #   # The following example retrieves an object for an S3 bucket.
+    #   # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
+    #   # specific byte range.
     #
     #   resp = client.get_object({
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
+    #     key: "SampleFile.txt", 
+    #     range: "bytes=0-9", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     accept_ranges: "bytes", 
-    #     content_length: 3191, 
-    #     content_type: "image/jpeg", 
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     last_modified: Time.parse("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("Thu, 09 Oct 2014 22:57:28 GMT"), 
     #     metadata: {
     #     }, 
-    #     tag_count: 2, 
     #     version_id: "null", 
     #   }
     #
-    # @example Example: To retrieve a byte range of an object 
+    # @example Example: To retrieve an object
     #
-    #   # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
-    #   # specific byte range.
+    #   # The following example retrieves an object for an S3 bucket.
     #
     #   resp = client.get_object({
     #     bucket: "examplebucket", 
-    #     key: "SampleFile.txt", 
-    #     range: "bytes=0-9", 
+    #     key: "HappyFace.jpg", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     accept_ranges: "bytes", 
-    #     content_length: 10, 
-    #     content_range: "bytes 0-9/43", 
-    #     content_type: "text/plain", 
-    #     etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"", 
-    #     last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"), 
+    #     content_length: 3191, 
+    #     content_type: "image/jpeg", 
+    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
+    #     last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"), 
     #     metadata: {
     #     }, 
+    #     tag_count: 2, 
     #     version_id: "null", 
     #   }
     #
@@ -5891,7 +5891,7 @@ module Aws::S3
     #
     #  </note>
     #
-    # The following operations are related to `GetObjectAcl`\:
+    # The following operations are related to `GetObjectAcl`:
     #
     # * [GetObject][3]
     #
@@ -6088,7 +6088,7 @@ module Aws::S3
     #
     # * If both of the `If-None-Match` and `If-Modified-Since` headers are
     #   present in the request as follows, then Amazon S3 returns the HTTP
-    #   status code `304 Not Modified`\:
+    #   status code `304 Not Modified`:
     #
     #   * `If-None-Match` condition evaluates to `false`.
     #
@@ -6114,7 +6114,7 @@ module Aws::S3
     # * If you don't have the `s3:ListBucket` permission, Amazon S3 returns
     #   an HTTP status code `403 Forbidden` ("access denied") error.
     #
-    # The following actions are related to `GetObjectAttributes`\:
+    # The following actions are related to `GetObjectAttributes`:
     #
     # * [GetObject][4]
     #
@@ -6289,7 +6289,7 @@ module Aws::S3
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # The following action is related to `GetObjectLegalHold`\:
+    # The following action is related to `GetObjectLegalHold`:
     #
     # * [GetObjectAttributes][2]
     #
@@ -6372,7 +6372,7 @@ module Aws::S3
     # object placed in the specified bucket. For more information, see
     # [Locking Objects][1].
     #
-    # The following action is related to `GetObjectLockConfiguration`\:
+    # The following action is related to `GetObjectLockConfiguration`:
     #
     # * [GetObjectAttributes][2]
     #
@@ -6435,7 +6435,7 @@ module Aws::S3
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # The following action is related to `GetObjectRetention`\:
+    # The following action is related to `GetObjectRetention`:
     #
     # * [GetObjectAttributes][2]
     #
@@ -6530,7 +6530,7 @@ module Aws::S3
     # For information about the Amazon S3 object tagging feature, see
     # [Object Tagging][1].
     #
-    # The following actions are related to `GetObjectTagging`\:
+    # The following actions are related to `GetObjectTagging`:
     #
     # * [DeleteObjectTagging][2]
     #
@@ -6599,49 +6599,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
@@ -6684,7 +6684,7 @@ module Aws::S3
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # The following action is related to `GetObjectTorrent`\:
+    # The following action is related to `GetObjectTorrent`:
     #
     # * [GetObject][2]
     #
@@ -6779,7 +6779,7 @@ module Aws::S3
     # For more information about when Amazon S3 considers a bucket or an
     # object public, see [The Meaning of "Public"][2].
     #
-    # The following operations are related to `GetPublicAccessBlock`\:
+    # The following operations are related to `GetPublicAccessBlock`:
     #
     # * [Using Amazon S3 Block Public Access][3]
     #
@@ -7003,7 +7003,7 @@ module Aws::S3
     # * If you don’t have the `s3:ListBucket` permission, Amazon S3 returns
     #   an HTTP status code 403 ("access denied") error.
     #
-    # The following actions are related to `HeadObject`\:
+    # The following actions are related to `HeadObject`:
     #
     # * [GetObject][5]
     #
@@ -7272,7 +7272,7 @@ module Aws::S3
     # Analytics – Storage Class Analysis][3].
     #
     # The following operations are related to
-    # `ListBucketAnalyticsConfigurations`\:
+    # `ListBucketAnalyticsConfigurations`:
     #
     # * [GetBucketAnalyticsConfiguration][4]
     #
@@ -7457,7 +7457,7 @@ module Aws::S3
     # Inventory][3]
     #
     # The following operations are related to
-    # `ListBucketInventoryConfigurations`\:
+    # `ListBucketInventoryConfigurations`:
     #
     # * [GetBucketInventoryConfiguration][4]
     #
@@ -7557,7 +7557,7 @@ module Aws::S3
     # request metrics, see [Monitoring Metrics with Amazon CloudWatch][3].
     #
     # The following operations are related to
-    # `ListBucketMetricsConfigurations`\:
+    # `ListBucketMetricsConfigurations`:
     #
     # * [PutBucketMetricsConfiguration][4]
     #
@@ -7714,7 +7714,7 @@ module Aws::S3
     # For information on permissions required to use the multipart upload
     # API, see [Multipart Upload and Permissions][2].
     #
-    # The following operations are related to `ListMultipartUploads`\:
+    # The following operations are related to `ListMultipartUploads`:
     #
     # * [CreateMultipartUpload][3]
     #
@@ -7834,97 +7834,97 @@ module Aws::S3
     # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
     #
     #
-    # @example Example: List next set of multipart uploads when previous result is truncated
+    # @example Example: To list in-progress multipart uploads on a bucket
     #
-    #   # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
-    #   # setup of multipart uploads.
+    #   # The following example lists in-progress multipart uploads on a specific bucket.
     #
     #   resp = client.list_multipart_uploads({
     #     bucket: "examplebucket", 
-    #     key_marker: "nextkeyfrompreviousresponse", 
-    #     max_uploads: 2, 
-    #     upload_id_marker: "valuefrompreviousresponse", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
-    #     bucket: "acl1", 
-    #     is_truncated: true, 
-    #     key_marker: "", 
-    #     max_uploads: 2, 
-    #     next_key_marker: "someobjectkey", 
-    #     next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
-    #     upload_id_marker: "", 
     #     uploads: [
     #       {
     #         initiated: Time.parse("2014-05-01T05:40:58.000Z"), 
     #         initiator: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "mohanataws", 
-    #           id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
+    #           display_name: "display-name", 
+    #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
+    #         upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
     #       }, 
     #       {
     #         initiated: Time.parse("2014-05-01T05:41:27.000Z"), 
     #         initiator: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "ownder-display-name", 
+    #           display_name: "display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #         upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
     #       }, 
     #     ], 
     #   }
     #
-    # @example Example: To list in-progress multipart uploads on a bucket
+    # @example Example: List next set of multipart uploads when previous result is truncated
     #
-    #   # The following example lists in-progress multipart uploads on a specific bucket.
+    #   # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
+    #   # setup of multipart uploads.
     #
     #   resp = client.list_multipart_uploads({
     #     bucket: "examplebucket", 
+    #     key_marker: "nextkeyfrompreviousresponse", 
+    #     max_uploads: 2, 
+    #     upload_id_marker: "valuefrompreviousresponse", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
+    #     bucket: "acl1", 
+    #     is_truncated: true, 
+    #     key_marker: "", 
+    #     max_uploads: 2, 
+    #     next_key_marker: "someobjectkey", 
+    #     next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #     upload_id_marker: "", 
     #     uploads: [
     #       {
     #         initiated: Time.parse("2014-05-01T05:40:58.000Z"), 
     #         initiator: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "display-name", 
-    #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
+    #           display_name: "mohanataws", 
+    #           id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
+    #         upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--", 
     #       }, 
     #       {
     #         initiated: Time.parse("2014-05-01T05:41:27.000Z"), 
     #         initiator: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         key: "JavaFile", 
     #         owner: {
-    #           display_name: "display-name", 
+    #           display_name: "ownder-display-name", 
     #           id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc", 
     #         }, 
     #         storage_class: "STANDARD", 
-    #         upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
+    #         upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--", 
     #       }, 
     #     ], 
     #   }
@@ -7993,7 +7993,7 @@ module Aws::S3
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # The following operations are related to `ListObjectVersions`\:
+    # The following operations are related to `ListObjectVersions`:
     #
     # * [ListObjectsV2][1]
     #
@@ -8184,7 +8184,7 @@ module Aws::S3
     # version, [ListObjectsV2][1], when developing applications. For
     # backward compatibility, Amazon S3 continues to support `ListObjects`.
     #
-    # The following operations are related to `ListObjects`\:
+    # The following operations are related to `ListObjects`:
     #
     # * [ListObjectsV2][1]
     #
@@ -8387,7 +8387,7 @@ module Aws::S3
     #
     # To get a list of your buckets, see [ListBuckets][5].
     #
-    # The following operations are related to `ListObjectsV2`\:
+    # The following operations are related to `ListObjectsV2`:
     #
     # * [GetObject][6]
     #
@@ -8596,7 +8596,7 @@ module Aws::S3
     # For information on permissions required to use the multipart upload
     # API, see [Multipart Upload and Permissions][3].
     #
-    # The following operations are related to `ListParts`\:
+    # The following operations are related to `ListParts`:
     #
     # * [CreateMultipartUpload][1]
     #
@@ -8848,7 +8848,7 @@ module Aws::S3
     # Acceleration][4].
     #
     # The following operations are related to
-    # `PutBucketAccelerateConfiguration`\:
+    # `PutBucketAccelerateConfiguration`:
     #
     # * [GetBucketAccelerateConfiguration][3]
     #
@@ -10090,7 +10090,7 @@ module Aws::S3
     # For more information about permissions, see [Managing Access
     # Permissions to Your Amazon S3 Resources][5].
     #
-    # The following are related to `PutBucketLifecycleConfiguration`\:
+    # The following are related to `PutBucketLifecycleConfiguration`:
     #
     # * [Examples of Lifecycle Configuration][6]
     #
@@ -10295,7 +10295,7 @@ module Aws::S3
     # For more information about returning the logging status of a bucket,
     # see [GetBucketLogging][4].
     #
-    # The following operations are related to `PutBucketLogging`\:
+    # The following operations are related to `PutBucketLogging`:
     #
     # * [PutObject][5]
     #
@@ -10429,7 +10429,7 @@ module Aws::S3
     # [Monitoring Metrics with Amazon CloudWatch][3].
     #
     # The following operations are related to
-    # `PutBucketMetricsConfiguration`\:
+    # `PutBucketMetricsConfiguration`:
     #
     # * [DeleteBucketMetricsConfiguration][4]
     #
@@ -10651,7 +10651,7 @@ module Aws::S3
     # ID of the test notification sent to the topic.
     #
     # The following action is related to
-    # `PutBucketNotificationConfiguration`\:
+    # `PutBucketNotificationConfiguration`:
     #
     # * [GetBucketNotificationConfiguration][3]
     #
@@ -10781,7 +10781,7 @@ module Aws::S3
     # For information about Amazon S3 Object Ownership, see [Using object
     # ownership][2].
     #
-    # The following operations are related to `PutBucketOwnershipControls`\:
+    # The following operations are related to `PutBucketOwnershipControls`:
     #
     # * GetBucketOwnershipControls
     #
@@ -10856,7 +10856,7 @@ module Aws::S3
     #
     # For more information, see [Bucket policy examples][1].
     #
-    # The following operations are related to `PutBucketPolicy`\:
+    # The following operations are related to `PutBucketPolicy`:
     #
     # * [CreateBucket][2]
     #
@@ -10999,7 +10999,7 @@ module Aws::S3
     #
     #  </note>
     #
-    # The following operations are related to `PutBucketReplication`\:
+    # The following operations are related to `PutBucketReplication`:
     #
     # * [GetBucketReplication][9]
     #
@@ -11175,7 +11175,7 @@ module Aws::S3
     # requesting the download will be charged for the download. For more
     # information, see [Requester Pays Buckets][1].
     #
-    # The following operations are related to `PutBucketRequestPayment`\:
+    # The following operations are related to `PutBucketRequestPayment`:
     #
     # * [CreateBucket][2]
     #
@@ -11320,7 +11320,7 @@ module Aws::S3
     #
     #   ^
     #
-    # The following operations are related to `PutBucketTagging`\:
+    # The following operations are related to `PutBucketTagging`:
     #
     # * [GetBucketTagging][7]
     #
@@ -12180,22 +12180,6 @@ module Aws::S3
     #   * {Types::PutObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @example Example: To create an object.
-    #
-    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
-    #
-    #   resp = client.put_object({
-    #     body: "filetoupload", 
-    #     bucket: "examplebucket", 
-    #     key: "objectkey", 
-    #   })
-    #
-    #   resp.to_h outputs the following:
-    #   {
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
-    #   }
-    #
     # @example Example: To upload an object
     #
     #   # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
@@ -12234,42 +12218,40 @@ module Aws::S3
     #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0", 
     #   }
     #
-    # @example Example: To upload an object and specify optional tags
+    # @example Example: To upload an object (specify optional headers)
     #
-    #   # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
-    #   # S3 returns version ID of the newly created object.
+    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
+    #   # storage class and use server-side encryption.
     #
     #   resp = client.put_object({
-    #     body: "c:\\HappyFace.jpg", 
+    #     body: "HappyFace.jpg", 
     #     bucket: "examplebucket", 
     #     key: "HappyFace.jpg", 
-    #     tagging: "key1=value1&key2=value2", 
+    #     server_side_encryption: "AES256", 
+    #     storage_class: "STANDARD_IA", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a", 
+    #     server_side_encryption: "AES256", 
+    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
     #   }
     #
-    # @example Example: To upload an object (specify optional headers)
+    # @example Example: To create an object.
     #
-    #   # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
-    #   # storage class and use server-side encryption.
+    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
-    #     body: "HappyFace.jpg", 
+    #     body: "filetoupload", 
     #     bucket: "examplebucket", 
-    #     key: "HappyFace.jpg", 
-    #     server_side_encryption: "AES256", 
-    #     storage_class: "STANDARD_IA", 
+    #     key: "objectkey", 
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"", 
-    #     server_side_encryption: "AES256", 
-    #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp", 
+    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ", 
     #   }
     #
     # @example Example: To upload an object and specify server-side encryption and object tags
@@ -12292,6 +12274,24 @@ module Aws::S3
     #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt", 
     #   }
     #
+    # @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 canned ACL.
     #
     #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
@@ -13890,7 +13890,7 @@ module Aws::S3
     # The `SelectObjectContent` action does not support the following
     # `GetObject` functionality. For more information, see [GetObject][5].
     #
-    # * `Range`\: Although you can specify a scan range for an Amazon S3
+    # * `Range`: Although you can specify a scan range for an Amazon S3
     #   Select request (see [SelectObjectContentRequest - ScanRange][9] in
     #   the request parameters), you cannot specify the range of bytes of an
     #   object to return.
@@ -14608,7 +14608,7 @@ module Aws::S3
     # Note the following additional considerations about the request headers
     # `x-amz-copy-source-if-match`, `x-amz-copy-source-if-none-match`,
     # `x-amz-copy-source-if-unmodified-since`, and
-    # `x-amz-copy-source-if-modified-since`\:
+    # `x-amz-copy-source-if-modified-since`:
     #
     #
     #
@@ -14726,7 +14726,7 @@ module Aws::S3
     # @option params [required, String] :copy_source
     #   Specifies the source object for the copy operation. You specify the
     #   value in one of two formats, depending on whether you want to access
-    #   the source object through an [access point][1]\:
+    #   the source object through an [access point][1]:
     #
     #   * For objects not accessed through an access point, specify the name
     #     of the source bucket and key of the source object, separated by a
@@ -14866,45 +14866,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"), 
     #     }, 
     #   }
     #
@@ -15354,7 +15354,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.118.0'
+      context[:gem_version] = '1.119.2'
       Seahorse::Client::Request.new(handlers, context)
     end