RubyGems - aws-sdk-s3 - Versions diffs - 1.92.0 → 1.95.0 - Mend

aws-sdk-s3 1.92.0 → 1.95.0

Files changed (24) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +27 -0
data/VERSION +1 -1
data/lib/aws-sdk-s3.rb +1 -1
data/lib/aws-sdk-s3/arn/access_point_arn.rb +2 -4
data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +2 -4
data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +1 -3
data/lib/aws-sdk-s3/bucket.rb +11 -11
data/lib/aws-sdk-s3/bucket_acl.rb +4 -2
data/lib/aws-sdk-s3/bucket_logging.rb +1 -2
data/lib/aws-sdk-s3/client.rb +320 -287
data/lib/aws-sdk-s3/customizations/object.rb +30 -11
data/lib/aws-sdk-s3/file_uploader.rb +2 -2
data/lib/aws-sdk-s3/multipart_upload.rb +3 -3
data/lib/aws-sdk-s3/multipart_upload_part.rb +2 -2
data/lib/aws-sdk-s3/object.rb +104 -20
data/lib/aws-sdk-s3/object_acl.rb +5 -3
data/lib/aws-sdk-s3/object_summary.rb +17 -19
data/lib/aws-sdk-s3/object_version.rb +4 -4
data/lib/aws-sdk-s3/plugins/arn.rb +37 -21
data/lib/aws-sdk-s3/presigner.rb +12 -3
data/lib/aws-sdk-s3/resource.rb +4 -2
data/lib/aws-sdk-s3/types.rb +209 -195
metadata +5 -6

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d13f63eb47c682e1fc6f5e88e3da2183232c9b7a2914df446d2bf012ec788081
-  data.tar.gz: d264012bd441b374fd2447efd6125a7bc1644711f03c7580135b9ce76bdf7c86
+  metadata.gz: d19f73a2ffccaaa9cd15cac607af56e59943f884bb908408e5f56e28fc27bb5c
+  data.tar.gz: 6d78cc39d6200623982c9d96fd7983310da56009f004a4bde7d5a120e1dd67c2
 SHA512:
-  metadata.gz: 6dc046ad7ab6155ca64b8f5b0c322c7d2dd92ebeb3dd785b090d254d32f412af3b0438eac41ad60b69e6156ce6fcec4d87deac033ce0a01ae58131ee5b96ea9a
-  data.tar.gz: 2fa9031c44cfc32bb80e2d106ee0e2ea7ad0596e31d70970484574a4819731a6a0ebb47289052f90a4198a9f3eaeee8effdada5cc5833dcf9a4a7989248a8285
+  metadata.gz: a0c53f6f254417b8d01bd696c6a0ce64c0ba72299186f1bb8ef7b6ce108530cbe815a48d1dbd9be134da0a2bd4858bf966b122fb9c35b01b242a0a989f54ebf3
+  data.tar.gz: ac8e49b6dde30d3e0a5643cd827a63da27501ae2b0f9f85c0250de361b888448ea3421f683d7081cdee16341907cb15b58e782da6fb46c6b67d6934f5e6fbef0

data/CHANGELOG.md CHANGED Viewed

@@ -1,6 +1,33 @@
 Unreleased Changes
 ------------------
+1.95.0 (2021-05-21)
+------------------
+* Feature - Documentation updates for Amazon S3
+1.94.1 (2021-05-05)
+------------------
+* Issue - Expose presigned request status to the request handler stack #2513
+1.94.0 (2021-04-27)
+------------------
+* Feature - Allow S3 Presigner to sign non http verbs like (upload_part, multipart_upload_abort, etc.) #2511
+1.93.1 (2021-04-12)
+------------------
+* Issue - Fix FIPS and global endpoint behavior for S3 ARNs.
+* Issue - Increases `multipart_threshold` default from 15 megabytes to 100 megabytes.
+1.93.0 (2021-03-24)
+------------------
+* Feature - Documentation updates for Amazon S3
 1.92.0 (2021-03-18)
 ------------------

data/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 1.92.0
1	+ 1.95.0

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

@@ -69,6 +69,6 @@ require_relative 'aws-sdk-s3/event_streams'
 # @!group service
 module Aws::S3
-  GEM_VERSION = '1.92.0'
+  GEM_VERSION = '1.95.0'
 end

data/lib/aws-sdk-s3/arn/access_point_arn.rb CHANGED Viewed

@@ -9,8 +9,6 @@ module Aws
         @type, @access_point_name, @extra = @resource.split(/[:,\/]/)
       end
-      attr_reader :access_point_name
       def support_dualstack?
         true
       end
@@ -52,13 +50,13 @@ module Aws
         end
       end
-      def host_url(region, dualstack = false, custom_endpoint = nil)
+      def host_url(region, fips = false, dualstack = false, custom_endpoint = nil)
         pfx = "#{@access_point_name}-#{@account_id}"
         if custom_endpoint
           "#{pfx}.#{custom_endpoint}"
         else
           sfx = Aws::Partitions::EndpointProvider.dns_suffix_for(region)
-          "#{pfx}.s3-accesspoint#{'.dualstack' if dualstack}.#{region}.#{sfx}"
+          "#{pfx}.s3-accesspoint#{'-fips' if fips}#{'.dualstack' if dualstack}.#{region}.#{sfx}"
         end
       end
     end

data/lib/aws-sdk-s3/arn/object_lambda_arn.rb CHANGED Viewed

@@ -9,8 +9,6 @@ module Aws
         @type, @access_point_name, @extra = @resource.split(/[:,\/]/)
       end
-      attr_reader :access_point_name
       def support_dualstack?
         false
       end
@@ -52,13 +50,13 @@ module Aws
         end
       end
-      def host_url(region, _dualstack = false, custom_endpoint = nil)
+      def host_url(region, fips = false, _dualstack = false, custom_endpoint = nil)
         pfx = "#{@access_point_name}-#{@account_id}"
         if custom_endpoint
           "#{pfx}.#{custom_endpoint}"
         else
           sfx = Aws::Partitions::EndpointProvider.dns_suffix_for(region)
-          "#{pfx}.s3-object-lambda.#{region}.#{sfx}"
+          "#{pfx}.s3-object-lambda#{'-fips' if fips}.#{region}.#{sfx}"
         end
       end
     end

data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb CHANGED Viewed

@@ -10,8 +10,6 @@ module Aws
           @resource.split(/[:,\/]/)
       end
-      attr_reader :outpost_id, :access_point_name
       def support_dualstack?
         false
       end
@@ -62,7 +60,7 @@ module Aws
       end
       # Outpost ARNs currently do not support dualstack
-      def host_url(region, _dualstack = false, custom_endpoint = nil)
+      def host_url(region, _fips = false, _dualstack = false, custom_endpoint = nil)
         pfx = "#{@access_point_name}-#{@account_id}.#{@outpost_id}"
         if custom_endpoint
           "#{pfx}.#{custom_endpoint}"

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

@@ -245,8 +245,10 @@ module Aws::S3
     # @option options [String] :grant_read_acp
     #   Allows grantee to read the bucket ACL.
     # @option options [String] :grant_write
-    #   Allows grantee to create, overwrite, and delete any object in the
-    #   bucket.
+    #   Allows grantee to create new objects in the bucket.
+    #
+    #   For the bucket and object owners of existing objects, also allows
+    #   deletions and overwrites of those objects.
     # @option options [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
     # @option options [Boolean] :object_lock_enabled_for_bucket
@@ -306,7 +308,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -468,7 +470,7 @@ module Aws::S3
     #   and high availability. Depending on performance needs, you can specify
     #   a different Storage Class. Amazon S3 on Outposts only uses the
     #   OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
-    #   in the *Amazon S3 Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -515,14 +517,12 @@ module Aws::S3
     #   If `x-amz-server-side-encryption` is present and has the value of
     #   `aws:kms`, this header specifies the ID of the AWS Key Management
     #   Service (AWS KMS) symmetrical customer managed customer master key
-    #   (CMK) that was used for the object.
-    #
-    #   If the value of `x-amz-server-side-encryption` is `aws:kms`, this
-    #   header specifies the ID of the symmetric customer managed AWS KMS CMK
-    #   that will be used for the object. If you specify
+    #   (CMK) that was used for the object. If you specify
     #   `x-amz-server-side-encryption:aws:kms`, but do not provide`
     #   x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
-    #   managed CMK in AWS to protect the data.
+    #   managed CMK in AWS to protect the data. If the KMS key does not exist
+    #   in the same account issuing the command, you must use the full ARN and
+    #   not just the ID.
     # @option options [String] :ssekms_encryption_context
     #   Specifies the AWS KMS Encryption Context to use for object encryption.
     #   The value of this header is a base64-encoded UTF-8 string holding JSON
@@ -540,7 +540,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #

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

@@ -235,8 +235,10 @@ module Aws::S3
     # @option options [String] :grant_read_acp
     #   Allows grantee to read the bucket ACL.
     # @option options [String] :grant_write
-    #   Allows grantee to create, overwrite, and delete any object in the
-    #   bucket.
+    #   Allows grantee to create new objects in the bucket.
+    #
+    #   For the bucket and object owners of existing objects, also allows
+    #   deletions and overwrites of those objects.
     # @option options [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
     # @option options [String] :expected_bucket_owner

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

@@ -36,8 +36,7 @@ module Aws::S3
     # Describes where logs are stored and the prefix that Amazon S3 assigns
     # to all log object keys for a bucket. For more information, see [PUT
-    # Bucket logging][1] in the *Amazon Simple Storage Service API
-    # Reference*.
+    # Bucket logging][1] in the *Amazon S3 API Reference*.
     #
     #
     #

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

@@ -454,8 +454,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -464,7 +464,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -482,7 +482,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -640,7 +640,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -792,9 +792,9 @@ module Aws::S3
     # permissions, you can use the `s3:x-amz-metadata-directive` condition
     # key to enforce certain metadata behavior when objects are uploaded.
     # For more information, see [Specifying Conditions in a Policy][6] in
-    # the *Amazon S3 Developer Guide*. For a complete list of Amazon
-    # S3-specific condition keys, see [Actions, Resources, and Condition
-    # Keys for Amazon S3][7].
+    # the *Amazon S3 User Guide*. For a complete list of Amazon S3-specific
+    # condition keys, see [Actions, Resources, and Condition Keys for Amazon
+    # S3][7].
     #
     # <b> <code>x-amz-copy-source-if</code> Headers</b>
     #
@@ -863,7 +863,7 @@ module Aws::S3
     # You can use the `CopyObject` action to change the storage class of an
     # object that is already stored in Amazon S3 using the `StorageClass`
     # parameter. For more information, see [Storage Classes][12] in the
-    # *Amazon S3 Service Developer Guide*.
+    # *Amazon S3 User Guide*.
     #
     # **Versioning**
     #
@@ -925,8 +925,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -935,7 +935,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1067,7 +1067,7 @@ module Aws::S3
     #   and high availability. Depending on performance needs, you can specify
     #   a different Storage Class. Amazon S3 on Outposts only uses the
     #   OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
-    #   in the *Amazon S3 Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1099,8 +1099,8 @@ module Aws::S3
     #   PUT requests for an object protected by AWS KMS will fail if not made
     #   via SSL or using SigV4. For information about configuring using any of
     #   the officially supported AWS SDKs and AWS CLI, see [Specifying the
-    #   Signature Version in Request Authentication][1] in the *Amazon S3
-    #   Developer Guide*.
+    #   Signature Version in Request Authentication][1] in the *Amazon S3 User
+    #   Guide*.
     #
     #
     #
@@ -1139,7 +1139,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1280,7 +1280,7 @@ module Aws::S3
     # the bucket, you become the bucket owner.
     #
     # Not every string is an acceptable bucket name. For information about
-    # bucket naming restrictions, see [Working with Amazon S3 buckets][1].
+    # bucket naming restrictions, see [Bucket naming rules][1].
     #
     # If you want to create an Amazon S3 on Outposts bucket, see [Create
     # Bucket][2].
@@ -1374,7 +1374,7 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
     # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
@@ -1404,8 +1404,10 @@ module Aws::S3
     #   Allows grantee to read the bucket ACL.
     #
     # @option params [String] :grant_write
-    #   Allows grantee to create, overwrite, and delete any object in the
-    #   bucket.
+    #   Allows grantee to create new objects in the bucket.
+    #
+    #   For the bucket and object owners of existing objects, also allows
+    #   deletions and overwrites of those objects.
     #
     # @option params [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
@@ -1523,11 +1525,12 @@ module Aws::S3
     # `CreateMultipartUpload`.
     #
     # To perform a multipart upload with encryption using an AWS KMS CMK,
-    # the requester must have permission to the `kms:Encrypt`,
-    # `kms:Decrypt`, `kms:ReEncrypt*`, `kms:GenerateDataKey*`, and
-    # `kms:DescribeKey` actions on the key. These permissions are required
-    # because Amazon S3 must decrypt and read data from the encrypted file
-    # parts before it completes the multipart upload.
+    # the requester must have permission to the `kms:Decrypt` and
+    # `kms:GenerateDataKey*` actions on the key. These permissions are
+    # required because Amazon S3 must decrypt and read data from the
+    # encrypted file parts before it completes the multipart upload. For
+    # more information, see [Multipart upload API and permissions][7] in the
+    # *Amazon S3 User Guide*.
     #
     # If your AWS Identity and Access Management (IAM) user or role is in
     # the same AWS account as the AWS KMS CMK, then you must have these
@@ -1536,7 +1539,7 @@ module Aws::S3
     # both the key policy and your IAM user or role.
     #
     # For more information, see [Protecting Data Using Server-Side
-    # Encryption][7].
+    # Encryption][8].
     #
     # Access Permissions
     #
@@ -1546,13 +1549,13 @@ module Aws::S3
     #   request headers:
     #
     #   * Specify a canned ACL with the `x-amz-acl` request header. For more
-    #     information, see [Canned ACL][8].
+    #     information, see [Canned ACL][9].
     #
     #   * Specify access permissions explicitly with the `x-amz-grant-read`,
     #     `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, and
     #     `x-amz-grant-full-control` headers. These parameters map to the
     #     set of permissions that Amazon S3 supports in an ACL. For more
-    #     information, see [Access Control List (ACL) Overview][9].
+    #     information, see [Access Control List (ACL) Overview][10].
     #
     #   You can use either a canned ACL or specify access permissions
     #   explicitly. You cannot do both.
@@ -1588,7 +1591,7 @@ module Aws::S3
     #
     #     For more information about server-side encryption with CMKs stored
     #     in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
-    #     Encryption with CMKs stored in AWS KMS][10].
+    #     Encryption with CMKs stored in AWS KMS][11].
     #
     #   * Use customer-provided encryption keys – If you want to manage your
     #     own encryption keys, provide all the following headers in the
@@ -1602,7 +1605,7 @@ module Aws::S3
     #
     #     For more information about server-side encryption with CMKs stored
     #     in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
-    #     Encryption with CMKs stored in AWS KMS][10].
+    #     Encryption with CMKs stored in AWS KMS][11].
     #
     # Access-Control-List (ACL)-Specific Request Headers
     #
@@ -1612,19 +1615,19 @@ module Aws::S3
     #   permissions to individual AWS accounts or to predefined groups
     #   defined by Amazon S3. These permissions are then added to the access
     #   control list (ACL) on the object. For more information, see [Using
-    #   ACLs][11]. With this operation, you can grant access permissions
+    #   ACLs][12]. With this operation, you can grant access permissions
     #   using one of the following two methods:
     #
     #   * Specify a canned ACL (`x-amz-acl`) — Amazon S3 supports a set of
     #     predefined ACLs, known as *canned ACLs*. Each canned ACL has a
     #     predefined set of grantees and permissions. For more information,
-    #     see [Canned ACL][8].
+    #     see [Canned ACL][9].
     #
     #   * Specify access permissions explicitly — To explicitly grant access
     #     permissions to specific AWS accounts or groups, use the following
     #     headers. Each header maps to specific permissions that Amazon S3
     #     supports in an ACL. For more information, see [Access Control List
-    #     (ACL) Overview][9]. In the header, you specify a list of grantees
+    #     (ACL) Overview][10]. In the header, you specify a list of grantees
     #     who get the specific permission. To grant permissions explicitly,
     #     use:
     #
@@ -1669,7 +1672,7 @@ module Aws::S3
     #       * South America (São Paulo)
     #
     #        For a list of all the Amazon S3 supported Regions and endpoints,
-    #       see [Regions and Endpoints][12] in the AWS General Reference.
+    #       see [Regions and Endpoints][13] in the AWS General Reference.
     #
     #        </note>
     #
@@ -1683,13 +1686,13 @@ module Aws::S3
     #
     # * [UploadPart][1]
     #
-    # * [CompleteMultipartUpload][13]
+    # * [CompleteMultipartUpload][14]
     #
-    # * [AbortMultipartUpload][14]
+    # * [AbortMultipartUpload][15]
     #
-    # * [ListParts][15]
+    # * [ListParts][16]
     #
-    # * [ListMultipartUploads][16]
+    # * [ListMultipartUploads][17]
     #
     #
     #
@@ -1699,16 +1702,17 @@ module Aws::S3
     # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
     # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
     # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
-    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
-    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
-    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
-    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
-    # [12]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
-    # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
-    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
-    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
-    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
+    # [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
+    # [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
+    # [13]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
+    # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
+    # [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
+    # [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
+    # [17]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
     #
     # @option params [String] :acl
     #   The canned ACL to apply to the object.
@@ -1723,8 +1727,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1733,7 +1737,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1797,7 +1801,7 @@ module Aws::S3
     #   and high availability. Depending on performance needs, you can specify
     #   a different Storage Class. Amazon S3 on Outposts only uses the
     #   OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
-    #   in the *Amazon S3 Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1830,7 +1834,7 @@ module Aws::S3
     #   protected by AWS KMS will fail if not made via SSL or using SigV4. For
     #   information about configuring using any of the officially supported
     #   AWS SDKs and AWS CLI, see [Specifying the Signature Version in Request
-    #   Authentication][1] in the *Amazon S3 Developer Guide*.
+    #   Authentication][1] in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -1855,7 +1859,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -2573,7 +2577,7 @@ module Aws::S3
     #  </note>
     #
     # For information about replication configuration, see [Replication][3]
-    # in the *Amazon S3 Developer Guide*.
+    # in the *Amazon S3 User Guide*.
     #
     # The following operations are related to `DeleteBucketReplication`\:
     #
@@ -2742,7 +2746,8 @@ module Aws::S3
     # Removes the null version (if there is one) of an object and inserts a
     # delete marker, which becomes the latest version of the object. If
-    # there isn't a null version, Amazon S3 does not remove any objects.
+    # there isn't a null version, Amazon S3 does not remove any objects but
+    # will still respond that the command was successful.
     #
     # To remove a specific version, you must be the bucket owner and you
     # must use the version Id subresource. Using this subresource
@@ -2786,8 +2791,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2796,7 +2801,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -2820,7 +2825,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -2922,8 +2927,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2932,7 +2937,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -3070,8 +3075,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -3080,7 +3085,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -3101,7 +3106,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5230,8 +5235,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5240,7 +5245,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5322,7 +5327,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5376,49 +5381,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",
     #   }
     #
@@ -5556,8 +5561,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5574,7 +5579,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5693,8 +5698,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5713,7 +5718,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5768,8 +5773,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5825,8 +5830,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5845,7 +5850,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5921,8 +5926,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5931,7 +5936,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -5954,7 +5959,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -6077,7 +6082,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -6230,8 +6235,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6240,7 +6245,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -6383,8 +6388,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6393,7 +6398,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -6457,7 +6462,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -7090,8 +7095,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7100,7 +7105,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -7325,6 +7330,9 @@ module Aws::S3
     # can also use request parameters as selection criteria to return
     # metadata about a subset of all the object versions.
     #
+    # To use this operation, you must have permissions to perform the
+    # `s3:ListBucketVersions` action. Be aware of the name difference.
+    #
     # <note markdown="1"> A 200 OK response can contain valid or invalid XML. Make sure to
     # design your application to parse the contents of the response and
     # handle it appropriately.
@@ -7552,8 +7560,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7562,7 +7570,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -7698,13 +7706,14 @@ module Aws::S3
       req.send_request(options)
     end
-    # Returns some or all (up to 1,000) of the objects in a bucket. You can
-    # use the request parameters as selection criteria to return a subset of
-    # the objects in a bucket. A `200 OK` response can contain valid or
-    # invalid XML. Make sure to design your application to parse the
-    # contents of the response and handle it appropriately. Objects are
-    # returned sorted in an ascending order of the respective key names in
-    # the list.
+    # Returns some or all (up to 1,000) of the objects in a bucket with each
+    # request. You can use the request parameters as selection criteria to
+    # return a subset of the objects in a bucket. A `200 OK` response can
+    # contain valid or invalid XML. Make sure to design your application to
+    # parse the contents of the response and handle it appropriately.
+    # Objects are returned sorted in an ascending order of the respective
+    # key names in the list. For more information about listing objects, see
+    # [Listing object keys programmatically][1]
     #
     # To use this operation, you must have READ access to the bucket.
     #
@@ -7712,33 +7721,34 @@ module Aws::S3
     # policy, you must have permissions to perform the `s3:ListBucket`
     # action. The bucket owner has this permission by default and can grant
     # this permission to others. For more information about permissions, see
-    # [Permissions Related to Bucket Subresource Operations][1] and
-    # [Managing Access Permissions to Your Amazon S3 Resources][2].
+    # [Permissions Related to Bucket Subresource Operations][2] and
+    # [Managing Access Permissions to Your Amazon S3 Resources][3].
     #
     # This section describes the latest revision of this action. We
     # recommend that you use this revised API for application development.
     # For backward compatibility, Amazon S3 continues to support the prior
-    # version of this API, [ListObjects][3].
+    # version of this API, [ListObjects][4].
     #
-    # To get a list of your buckets, see [ListBuckets][4].
+    # To get a list of your buckets, see [ListBuckets][5].
     #
     # The following operations are related to `ListObjectsV2`\:
     #
-    # * [GetObject][5]
+    # * [GetObject][6]
     #
-    # * [PutObject][6]
+    # * [PutObject][7]
     #
-    # * [CreateBucket][7]
+    # * [CreateBucket][8]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
     #
     # @option params [required, String] :bucket
     #   Bucket name to list.
@@ -7748,8 +7758,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7758,7 +7768,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -7954,8 +7964,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7964,7 +7974,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -7990,7 +8000,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -8370,8 +8380,10 @@ module Aws::S3
     #   Allows grantee to read the bucket ACL.
     #
     # @option params [String] :grant_write
-    #   Allows grantee to create, overwrite, and delete any object in the
-    #   bucket.
+    #   Allows grantee to create new objects in the bucket.
+    #
+    #   For the bucket and object owners of existing objects, also allows
+    #   deletions and overwrites of those objects.
     #
     # @option params [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
@@ -8770,7 +8782,7 @@ module Aws::S3
     #   with Amazon S3-managed keys (SSE-S3) or customer master keys stored in
     #   AWS KMS (SSE-KMS). For information about the Amazon S3 default
     #   encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -9203,8 +9215,7 @@ module Aws::S3
     # Creates a new lifecycle configuration for the bucket or replaces an
     # existing lifecycle configuration. For information about lifecycle
-    # configuration, see [Managing Access Permissions to Your Amazon S3
-    # Resources][1].
+    # configuration, see [Managing your storage lifecycle][1].
     #
     # <note markdown="1"> Bucket lifecycle configuration now supports specifying a lifecycle
     # rule using an object key name prefix, one or more object tags, or a
@@ -9261,25 +9272,26 @@ module Aws::S3
     # * s3:PutLifecycleConfiguration
     #
     # For more information about permissions, see [Managing Access
-    # Permissions to Your Amazon S3 Resources][1].
+    # Permissions to Your Amazon S3 Resources][5].
     #
     # The following are related to `PutBucketLifecycleConfiguration`\:
     #
-    # * [Examples of Lifecycle Configuration][5]
+    # * [Examples of Lifecycle Configuration][6]
     #
-    # * [GetBucketLifecycleConfiguration][6]
+    # * [GetBucketLifecycleConfiguration][7]
     #
-    # * [DeleteBucketLifecycle][7]
+    # * [DeleteBucketLifecycle][8]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
     # [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/dev/lifecycle-configuration-examples.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
-    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.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
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which to set the configuration.
@@ -10012,8 +10024,7 @@ module Aws::S3
     end
     # Creates a replication configuration or replaces an existing one. For
-    # more information, see [Replication][1] in the *Amazon S3 Developer
-    # Guide*.
+    # more information, see [Replication][1] in the *Amazon S3 User Guide*.
     #
     # <note markdown="1"> To perform this operation, the user or role performing the action must
     # have the [iam:PassRole][2] permission.
@@ -10729,8 +10740,7 @@ module Aws::S3
     # <note markdown="1"> The `Content-MD5` header is required for any request to upload an
     # object with a retention period configured using Amazon S3 Object Lock.
     # For more information about Amazon S3 Object Lock, see [Amazon S3
-    # Object Lock Overview][1] in the *Amazon Simple Storage Service
-    # Developer Guide*.
+    # Object Lock Overview][1] in the *Amazon S3 User Guide*.
     #
     #  </note>
     #
@@ -10765,7 +10775,7 @@ module Aws::S3
     # and high availability. Depending on performance needs, you can specify
     # a different Storage Class. Amazon S3 on Outposts only uses the
     # OUTPOSTS Storage Class. For more information, see [Storage Classes][6]
-    # in the *Amazon S3 Service Developer Guide*.
+    # in the *Amazon S3 User Guide*.
     #
     # **Versioning**
     #
@@ -10819,8 +10829,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -10829,7 +10839,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -10944,7 +10954,7 @@ module Aws::S3
     #   and high availability. Depending on performance needs, you can specify
     #   a different Storage Class. Amazon S3 on Outposts only uses the
     #   OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
-    #   in the *Amazon S3 Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -10996,14 +11006,12 @@ module Aws::S3
     #   If `x-amz-server-side-encryption` is present and has the value of
     #   `aws:kms`, this header specifies the ID of the AWS Key Management
     #   Service (AWS KMS) symmetrical customer managed customer master key
-    #   (CMK) that was used for the object.
-    #
-    #   If the value of `x-amz-server-side-encryption` is `aws:kms`, this
-    #   header specifies the ID of the symmetric customer managed AWS KMS CMK
-    #   that will be used for the object. If you specify
+    #   (CMK) that was used for the object. If you specify
     #   `x-amz-server-side-encryption:aws:kms`, but do not provide`
     #   x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
-    #   managed CMK in AWS to protect the data.
+    #   managed CMK in AWS to protect the data. If the KMS key does not exist
+    #   in the same account issuing the command, you must use the full ARN and
+    #   not just the ID.
     #
     # @option params [String] :ssekms_encryption_context
     #   Specifies the AWS KMS Encryption Context to use for object encryption.
@@ -11024,7 +11032,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11067,37 +11075,25 @@ module Aws::S3
     #   * {Types::PutObjectOutput#request_charged #request_charged} => String
     #
     #
-    # @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
-    #   # syntax. S3 returns VersionId of the newly created object.
-    #
-    #   resp = client.put_object({
-    #     body: "HappyFace.jpg",
-    #     bucket: "examplebucket",
-    #     key: "HappyFace.jpg",
-    #   })
-    #
-    #   resp.to_h outputs the following:
-    #   {
-    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
-    #   }
-    #
-    # @example Example: To create an object.
+    # @example Example: To upload object and specify user-defined metadata
     #
-    #   # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
+    #   # enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
     #     body: "filetoupload",
     #     bucket: "examplebucket",
-    #     key: "objectkey",
+    #     key: "exampleobject",
+    #     metadata: {
+    #       "metadata1" => "value1",
+    #       "metadata2" => "value2",
+    #     },
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
+    #     version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
     #   }
     #
     # @example Example: To upload an object (specify optional headers)
@@ -11120,43 +11116,41 @@ module Aws::S3
     #     version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
     #   }
     #
-    # @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 and specify canned ACL.
+    # @example Example: To upload an object and specify server-side encryption and object tags
     #
-    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
-    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
+    #   # The following example uploads and 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({
-    #     acl: "authenticated-read",
     #     body: "filetoupload",
     #     bucket: "examplebucket",
     #     key: "exampleobject",
+    #     server_side_encryption: "AES256",
+    #     tagging: "key1=value1&key2=value2",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
+    #     server_side_encryption: "AES256",
+    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
     #   }
     #
     # @example Example: To upload an object and specify optional tags
@@ -11177,24 +11171,38 @@ module Aws::S3
     #     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 and 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: "objectkey",
+    #   })
+    #
+    #   resp.to_h outputs the following:
+    #   {
+    #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
+    #     version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
+    #   }
+    #
+    # @example Example: To upload an object and specify canned ACL.
+    #
+    #   # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
+    #   # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
     #
     #   resp = client.put_object({
+    #     acl: "authenticated-read",
     #     body: "filetoupload",
     #     bucket: "examplebucket",
     #     key: "exampleobject",
-    #     server_side_encryption: "AES256",
-    #     tagging: "key1=value1&key2=value2",
     #   })
     #
     #   resp.to_h outputs the following:
     #   {
     #     etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
-    #     server_side_encryption: "AES256",
-    #     version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
+    #     version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
     #   }
     #
     # @example Streaming a file from disk
@@ -11277,7 +11285,7 @@ module Aws::S3
     # if you have an existing application that updates a bucket ACL using
     # the request body, you can continue to use that approach. For more
     # information, see [Access Control List (ACL) Overview][2] in the
-    # *Amazon S3 Developer Guide*.
+    # *Amazon S3 User Guide*.
     #
     # **Access Permissions**
     #
@@ -11437,8 +11445,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11474,8 +11482,10 @@ module Aws::S3
     #   This action is not supported by Amazon S3 on Outposts.
     #
     # @option params [String] :grant_write
-    #   Allows grantee to create, overwrite, and delete any object in the
-    #   bucket.
+    #   Allows grantee to create new objects in the bucket.
+    #
+    #   For the bucket and object owners of existing objects, also allows
+    #   deletions and overwrites of those objects.
     #
     # @option params [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
@@ -11490,8 +11500,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11500,7 +11510,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11512,7 +11522,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11597,16 +11607,11 @@ module Aws::S3
       req.send_request(options)
     end
-    # Applies a Legal Hold configuration to the specified object.
+    # Applies a Legal Hold configuration to the specified object. For more
+    # information, see [Locking Objects][1].
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # **Related Resources**
-    #
-    # * [Locking Objects][1]
-    #
-    # ^
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11620,8 +11625,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11639,7 +11644,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11692,18 +11697,19 @@ module Aws::S3
     # Places an Object Lock configuration on the specified bucket. The rule
     # specified in the Object Lock configuration will be applied by default
-    # to every new object placed in the specified bucket.
+    # to every new object placed in the specified bucket. For more
+    # information, see [Locking Objects][1].
     #
-    # <note markdown="1"> `DefaultRetention` requires either Days or Years. You can't specify
-    # both at the same time.
+    # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
     #
-    #  </note>
-    #
-    # **Related Resources**
+    # * The `DefaultRetention` period can be either `Days` or `Years` but
+    #   you must select one. You cannot specify `Days` and `Years` at the
+    #   same time.
     #
-    # * [Locking Objects][1]
+    # * You can only enable Object Lock for new buckets. If you want to turn
+    #   on Object Lock for an existing bucket, contact AWS Support.
     #
-    # ^
+    #  </note>
     #
     #
     #
@@ -11722,7 +11728,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11779,16 +11785,11 @@ module Aws::S3
       req.send_request(options)
     end
-    # Places an Object Retention configuration on an object.
+    # Places an Object Retention configuration on an object. For more
+    # information, see [Locking Objects][1].
     #
     # This action is not supported by Amazon S3 on Outposts.
     #
-    # **Related Resources**
-    #
-    # * [Locking Objects][1]
-    #
-    # ^
-    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11802,8 +11803,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11821,7 +11822,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11944,8 +11945,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11954,7 +11955,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -11986,7 +11987,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -12105,7 +12106,7 @@ module Aws::S3
     #   Amazon S3 bucket. You can enable the configuration options in any
     #   combination. For more information about when Amazon S3 considers a
     #   bucket or object public, see [The Meaning of "Public"][1] in the
-    #   *Amazon Simple Storage Service Developer Guide*.
+    #   *Amazon S3 User Guide*.
     #
     #
     #
@@ -12388,8 +12389,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -12398,7 +12399,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -12419,7 +12420,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13092,8 +13093,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13102,7 +13103,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13152,7 +13153,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13366,8 +13367,8 @@ module Aws::S3
     #   *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
     #   When using this action with an access point through the AWS SDKs, you
     #   provide the access point ARN in place of the bucket name. For more
-    #   information about access point ARNs, see [Using Access Points][1] in
-    #   the *Amazon Simple Storage Service Developer Guide*.
+    #   information about access point ARNs, see [Using access points][1] in
+    #   the *Amazon S3 User Guide*.
     #
     #   When using this action with Amazon S3 on Outposts, you must direct
     #   requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13376,7 +13377,7 @@ module Aws::S3
     #   When using this action using S3 on Outposts through the AWS SDKs, you
     #   provide the Outposts bucket ARN in place of the bucket name. For more
     #   information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
-    #   in the *Amazon Simple Storage Service Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13497,7 +13498,7 @@ module Aws::S3
     #   request. Bucket owners need not specify this parameter in their
     #   requests. For information about downloading objects from requester
     #   pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
-    #   in the *Amazon S3 Developer Guide*.
+    #   in the *Amazon S3 User Guide*.
     #
     #
     #
@@ -13525,45 +13526,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"),
     #     },
     #   }
     #
@@ -13627,10 +13628,40 @@ module Aws::S3
     # function, the metadata returned to the end user `GetObject` call might
     # differ from what Amazon S3 would normally return.
     #
+    # AWS provides some prebuilt Lambda functions that you can use with S3
+    # Object Lambda to detect and redact personally identifiable information
+    # (PII) and decompress S3 objects. These Lambda functions are available
+    # in the AWS Serverless Application Repository, and can be selected
+    # through the AWS Management Console when you create your Object Lambda
+    # Access Point.
+    #
+    # Example 1: PII Access Control - This Lambda function uses Amazon
+    # Comprehend, a natural language processing (NLP) service using machine
+    # learning to find insights and relationships in text. It automatically
+    # detects personally identifiable information (PII) such as names,
+    # addresses, dates, credit card numbers, and social security numbers
+    # from documents in your Amazon S3 bucket.
+    #
+    # Example 2: PII Redaction - This Lambda function uses Amazon
+    # Comprehend, a natural language processing (NLP) service using machine
+    # learning to find insights and relationships in text. It automatically
+    # redacts personally identifiable information (PII) such as names,
+    # addresses, dates, credit card numbers, and social security numbers
+    # from documents in your Amazon S3 bucket.
+    #
+    # Example 3: Decompression - The Lambda function
+    # S3ObjectLambdaDecompression, is equipped to decompress objects stored
+    # in S3 in one of six compressed file formats including bzip2, gzip,
+    # snappy, zlib, zstandard and ZIP.
+    #
+    # For information on how to view and use these functions, see [Using AWS
+    # built Lambda functions][3] in the *Amazon S3 User Guide*.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
     # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html
     #
     # @option params [required, String] :request_route
     #   Route prefix to the HTTP URL generated.
@@ -13680,7 +13711,9 @@ module Aws::S3
     #   A string that uniquely identifies an error condition. Returned in the
     #   &lt;Code&gt; tag of the error XML response for a corresponding
     #   `GetObject` call. Cannot be used with a successful `StatusCode` header
-    #   or when the transformed object is provided in the body.
+    #   or when the transformed object is provided in the body. All error
+    #   codes from S3 are sentence-cased. Regex value is
+    #   "^\[A-Z\]\[a-zA-Z\]+$".
     #
     # @option params [String] :error_message
     #   Contains a generic description of the error condition. Returned in the
@@ -13884,7 +13917,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.92.0'
+      context[:gem_version] = '1.95.0'
       Seahorse::Client::Request.new(handlers, context)
     end