@aws-sdk/client-s3 3.844.0 → 3.846.0

package/dist-types/commands/PutObjectAclCommand.d.ts

@@ -30,23 +30,22 @@ declare const PutObjectAclCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions
- *          for a new or existing object in an S3 bucket. You must have the <code>WRITE_ACP</code>
- *          permission to set the ACL of an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions">What
- *             permissions can I grant?</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions for a new or
+ *       existing object in an S3 bucket. You must have the <code>WRITE_ACP</code> permission to set the ACL of
+ *       an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions">What permissions can I grant?</a> in the
+ *         <i>Amazon S3 User Guide</i>.</p>
  *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
- *          <p>Depending on your application needs, you can choose to set the ACL on an object using
- *          either the request body or the headers. For example, 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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a>
- *          in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>Depending on your application needs, you can choose to set the ACL on an object using either the
+ *       request body or the headers. For example, 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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
+ *         Overview</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          <important>
- *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs
- *             are disabled and no longer affect permissions. You must use policies to grant access to
- *             your bucket and the objects in it. Requests to set ACLs or update ACLs fail and return
- *             the <code>AccessControlListNotSupported</code> error code. Requests to read ACLs are
- *             still supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object
- *                ownership</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs are disabled
+ *         and no longer affect permissions. You must use policies to grant access to your bucket and the objects
+ *         in it. Requests to set ACLs or update ACLs fail and return the
+ *           <code>AccessControlListNotSupported</code> error code. Requests to read ACLs are still supported.
+ *         For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object ownership</a> in
+ *         the <i>Amazon S3 User Guide</i>.</p>
  *          </important>
  *          <dl>
  *             <dt>Permissions</dt>
@@ -54,42 +53,37 @@ declare const PutObjectAclCommand_base: {
  *                <p>You can set access permissions using one of the following methods:</p>
  *                <ul>
  *                   <li>
- *                      <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3
- *                         supports a set of predefined ACLs, known as canned ACLs. Each canned ACL has
- *                         a predefined set of grantees and permissions. Specify the canned ACL name as
- *                         the value of <code>x-amz-ac</code>l. If you use this header, you cannot use
- *                         other access control-specific headers in your request. For more information,
- *                         see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
- *                         ACL</a>.</p>
+ *                      <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports a set
+ *                 of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set of grantees and
+ *                 permissions. Specify the canned ACL name as the value of <code>x-amz-ac</code>l. If you use
+ *                 this header, you cannot use other access control-specific headers in your request. For more
+ *                 information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned ACL</a>.</p>
  *                   </li>
  *                   <li>
- *                      <p>Specify access permissions explicitly with the
- *                            <code>x-amz-grant-read</code>, <code>x-amz-grant-read-acp</code>,
- *                            <code>x-amz-grant-write-acp</code>, and
- *                            <code>x-amz-grant-full-control</code> headers. When using these headers,
- *                         you specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3
- *                         groups) who will receive the permission. If you use these ACL-specific
- *                         headers, you cannot use <code>x-amz-acl</code> header to set a canned ACL.
- *                         These parameters map to the set of permissions that Amazon S3 supports in an ACL.
- *                         For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
- *                            Overview</a>.</p>
- *                      <p>You specify each grantee as a type=value pair, where the type is one of
- *                         the following:</p>
+ *                      <p>Specify access permissions explicitly with the <code>x-amz-grant-read</code>,
+ *                   <code>x-amz-grant-read-acp</code>, <code>x-amz-grant-write-acp</code>, and
+ *                   <code>x-amz-grant-full-control</code> headers. When using these headers, you specify
+ *                 explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3 groups) who will receive the
+ *                 permission. If you use these ACL-specific headers, you cannot use <code>x-amz-acl</code>
+ *                 header to set a canned ACL. These parameters map to the set of permissions that Amazon S3 supports
+ *                 in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
+ *                 Overview</a>.</p>
+ *                      <p>You specify each grantee as a type=value pair, where the type is one of the
+ *                 following:</p>
  *                      <ul>
  *                         <li>
  *                            <p>
- *                               <code>id</code> – if the value specified is the canonical user ID
- *                               of an Amazon Web Services account</p>
+ *                               <code>id</code> – if the value specified is the canonical user ID of an
+ *                     Amazon Web Services account</p>
  *                         </li>
  *                         <li>
  *                            <p>
- *                               <code>uri</code> – if you are granting permissions to a predefined
- *                               group</p>
+ *                               <code>uri</code> – if you are granting permissions to a predefined group</p>
  *                         </li>
  *                         <li>
  *                            <p>
- *                               <code>emailAddress</code> – if the value specified is the email
- *                               address of an Amazon Web Services account</p>
+ *                               <code>emailAddress</code> – if the value specified is the email address of an
+ *                     Amazon Web Services account</p>
  *                            <note>
  *                               <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
  *                               <ul>
@@ -122,32 +116,30 @@ declare const PutObjectAclCommand_base: {
  *                            </note>
  *                         </li>
  *                      </ul>
- *                      <p>For example, the following <code>x-amz-grant-read</code> header grants
- *                         list objects permission to the two Amazon Web Services accounts identified by their email
- *                         addresses.</p>
+ *                      <p>For example, the following <code>x-amz-grant-read</code> header grants list objects
+ *                 permission to the two Amazon Web Services accounts identified by their email addresses.</p>
  *                      <p>
- *                         <code>x-amz-grant-read: emailAddress="xyz@amazon.com",
- *                            emailAddress="abc@amazon.com" </code>
+ *                         <code>x-amz-grant-read: emailAddress="xyz@amazon.com", emailAddress="abc@amazon.com"
+ *                 </code>
  *                      </p>
  *                   </li>
  *                </ul>
- *                <p>You can use either a canned ACL or specify access permissions explicitly. You
- *                   cannot do both.</p>
+ *                <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
+ *             both.</p>
  *             </dd>
  *             <dt>Grantee Values</dt>
  *             <dd>
- *                <p>You can specify the person (grantee) to whom you're assigning access rights
- *                  (using request elements) in the following ways. For examples of how to specify these
- *                  grantee values in JSON format, see the Amazon Web Services CLI example in <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html">
- *                    Enabling Amazon S3 server access logging</a> in the
- *                  <i>Amazon S3 User Guide</i>.</p>
+ *                <p>You can specify the person (grantee) to whom you're assigning access rights (using request
+ *             elements) in the following ways. For examples of how to specify these grantee values in JSON
+ *             format, see the Amazon Web Services CLI example in <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html"> Enabling Amazon S3 server
+ *               access logging</a> in the <i>Amazon S3 User Guide</i>.</p>
  *                <ul>
  *                   <li>
  *                      <p>By the person's ID:</p>
  *                      <p>
  *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                            xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
- *                            </Grantee></code>
+ *                   xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
+ *                   </Grantee></code>
  *                      </p>
  *                      <p>DisplayName is optional and ignored in the request.</p>
  *                   </li>
@@ -155,17 +147,17 @@ declare const PutObjectAclCommand_base: {
  *                      <p>By URI:</p>
  *                      <p>
  *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                            xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
+ *                   xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
  *                      </p>
  *                   </li>
  *                   <li>
  *                      <p>By Email address:</p>
  *                      <p>
  *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                            xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee></code>
+ *                   xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee></code>
  *                      </p>
- *                      <p>The grantee is resolved to the CanonicalUser and, in a response to a GET
- *                         Object acl request, appears as the CanonicalUser.</p>
+ *                      <p>The grantee is resolved to the CanonicalUser and, in a response to a GET Object acl
+ *                 request, appears as the CanonicalUser.</p>
  *                      <note>
  *                         <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
  *                         <ul>
@@ -201,9 +193,9 @@ declare const PutObjectAclCommand_base: {
  *             </dd>
  *             <dt>Versioning</dt>
  *             <dd>
- *                <p>The ACL of an object is set at the object version level. By default, PUT sets
- *                   the ACL of the current version of an object. To set the ACL of a different
- *                   version, use the <code>versionId</code> subresource.</p>
+ *                <p>The ACL of an object is set at the object version level. By default, PUT sets the ACL of the
+ *             current version of an object. To set the ACL of a different version, use the
+ *               <code>versionId</code> subresource.</p>
  *             </dd>
  *          </dl>
  *          <p>The following operations are related to <code>PutObjectAcl</code>:</p>

package/dist-types/commands/PutObjectCommand.d.ts

@@ -40,20 +40,19 @@ declare const PutObjectCommand_base: {
  *          <note>
  *             <ul>
  *                <li>
- *                   <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added
- *                   the entire object to the bucket. You cannot use <code>PutObject</code> to only
- *                   update a single piece of metadata for an existing object. You must put the entire
- *                   object with updated metadata if you want to update some values.</p>
+ *                   <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the entire
+ *             object to the bucket. You cannot use <code>PutObject</code> to only update a single piece of
+ *             metadata for an existing object. You must put the entire object with updated metadata if you want
+ *             to update some values.</p>
  *                </li>
  *                <li>
- *                   <p>If your bucket uses the bucket owner enforced setting for Object Ownership,
- *                   ACLs are disabled and no longer affect permissions. All objects written to the
- *                   bucket by any account will be owned by the bucket owner.</p>
+ *                   <p>If your bucket uses the bucket owner enforced setting for Object Ownership, ACLs are disabled
+ *             and no longer affect permissions. All objects written to the bucket by any account will be owned
+ *             by the bucket owner.</p>
  *                </li>
  *                <li>
  *                   <p>
- *                      <b>Directory buckets</b> -
- *                   For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
+ *                      <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
  *                      </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
  *     <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
  *     <i>Amazon S3 User Guide</i>.</p>
@@ -61,39 +60,39 @@ declare const PutObjectCommand_base: {
  *             </ul>
  *          </note>
  *          <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
- *          simultaneously, it overwrites all but the last object written. However, Amazon S3 provides
- *          features that can modify this behavior:</p>
+ *       simultaneously, it overwrites all but the last object written. However, Amazon S3 provides features that can
+ *       modify this behavior:</p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <b>S3 Object Lock</b> - To prevent objects from
- *                being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
- *                   Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                   <b>S3 Object Lock</b> - To prevent objects from being deleted
+ *           or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
  *                <note>
  *                   <p>This functionality is not supported for directory buckets.</p>
  *                </note>
  *             </li>
  *             <li>
  *                <p>
- *                   <b>If-None-Match</b> - Uploads the object only if the object key name does not already exist in the specified bucket. Otherwise, Amazon S3 returns a <code>412 Precondition Failed</code> error. If a conflicting operation occurs during the upload, S3 returns a <code>409 ConditionalRequestConflict</code> response. On a 409 failure, retry the upload.</p>
+ *                   <b>If-None-Match</b> - Uploads the object only if the object
+ *           key name does not already exist in the specified bucket. Otherwise, Amazon S3 returns a <code>412
+ *             Precondition Failed</code> error. If a conflicting operation occurs during the upload, S3 returns
+ *           a <code>409 ConditionalRequestConflict</code> response. On a 409 failure, retry the upload.</p>
  *                <p>Expects the * character (asterisk).</p>
- *                <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html">Add preconditions to S3 operations with conditional requests</a> in the <i>Amazon S3 User Guide</i> or <a href="https://datatracker.ietf.org/doc/rfc7232/">RFC 7232</a>.
- *             </p>
+ *                <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/conditional-requests.html">Add preconditions to S3 operations with
+ *             conditional requests</a> in the <i>Amazon S3 User Guide</i> or <a href="https://datatracker.ietf.org/doc/rfc7232/">RFC 7232</a>. </p>
  *                <note>
  *                   <p>This functionality is not supported for S3 on Outposts.</p>
  *                </note>
  *             </li>
  *             <li>
  *                <p>
- *                   <b>S3 Versioning</b> - When you enable versioning
- *                for a bucket, if Amazon S3 receives multiple write requests for the same object
- *                simultaneously, it stores all versions of the objects. For each write request that is
- *                made to the same object, Amazon S3 automatically generates a unique version ID of that
- *                object being stored in Amazon S3. You can retrieve, replace, or delete any version of the
- *                object. For more information about versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding
- *                   Objects to Versioning-Enabled Buckets</a> in the <i>Amazon S3 User
- *                   Guide</i>. For information about returning the versioning state of a
- *                bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
+ *                   <b>S3 Versioning</b> - When you enable versioning for a bucket,
+ *           if Amazon S3 receives multiple write requests for the same object simultaneously, it stores all versions
+ *           of the objects. For each write request that is made to the same object, Amazon S3 automatically generates
+ *           a unique version ID of that object being stored in Amazon S3. You can retrieve, replace, or delete any
+ *           version of the object. For more information about versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding Objects to
+ *             Versioning-Enabled Buckets</a> in the <i>Amazon S3 User Guide</i>. For information
+ *           about returning the versioning state of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
  *                <note>
  *                   <p>This functionality is not supported for directory buckets.</p>
  *                </note>
@@ -105,34 +104,31 @@ declare const PutObjectCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - The
- *                         following permissions are required in your policies when your
- *                            <code>PutObject</code> request includes specific headers.</p>
+ *                         <b>General purpose bucket permissions</b> - The following
+ *                 permissions are required in your policies when your <code>PutObject</code> request includes
+ *                 specific headers.</p>
  *                      <ul>
  *                         <li>
  *                            <p>
  *                               <b>
  *                                  <code>s3:PutObject</code>
- *                               </b> -
- *                               To successfully complete the <code>PutObject</code> request, you must
- *                               always have the <code>s3:PutObject</code> permission on a bucket to
- *                               add an object to it.</p>
+ *                               </b> - To successfully
+ *                     complete the <code>PutObject</code> request, you must always have the
+ *                       <code>s3:PutObject</code> permission on a bucket to add an object to it.</p>
  *                         </li>
  *                         <li>
  *                            <p>
  *                               <b>
  *                                  <code>s3:PutObjectAcl</code>
- *                               </b> - To successfully change the objects ACL of your
- *                                  <code>PutObject</code> request, you must have the
- *                                  <code>s3:PutObjectAcl</code>.</p>
+ *                               </b> - To successfully change the objects ACL of your <code>PutObject</code>
+ *                     request, you must have the <code>s3:PutObjectAcl</code>.</p>
  *                         </li>
  *                         <li>
  *                            <p>
  *                               <b>
  *                                  <code>s3:PutObjectTagging</code>
- *                               </b> - To successfully set the tag-set with your
- *                                  <code>PutObject</code> request, you must have the
- *                                  <code>s3:PutObjectTagging</code>.</p>
+ *                               </b> - To successfully set the tag-set with your <code>PutObject</code>
+ *                     request, you must have the <code>s3:PutObjectTagging</code>.</p>
  *                         </li>
  *                      </ul>
  *                   </li>
@@ -145,9 +141,8 @@ declare const PutObjectCommand_base: {
  *                            <code>CreateSession</code>
  *                         </a>.</p>
  *                      <p>If the object is encrypted with SSE-KMS, you must also have the
- *                            <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
- *                         in IAM identity-based policies and KMS key policies for the KMS
- *                         key.</p>
+ *                   <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM
+ *                 identity-based policies and KMS key policies for the KMS key.</p>
  *                   </li>
  *                </ul>
  *             </dd>
@@ -156,18 +151,17 @@ declare const PutObjectCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket</b> - To ensure that
- *                         data is not corrupted traversing the network, use the
- *                            <code>Content-MD5</code> header. When you use this header, Amazon S3 checks
- *                         the object against the provided MD5 value and, if they do not match, Amazon S3
- *                         returns an error. Alternatively, when the object's ETag is its MD5 digest,
- *                         you can calculate the MD5 while putting the object to Amazon S3 and compare the
- *                         returned ETag to the calculated MD5 value.</p>
+ *                         <b>General purpose bucket</b> - To ensure that data is not
+ *                 corrupted traversing the network, use the <code>Content-MD5</code> header. When you use this
+ *                 header, Amazon S3 checks the object against the provided MD5 value and, if they do not match, Amazon S3
+ *                 returns an error. Alternatively, when the object's ETag is its MD5 digest, you can calculate
+ *                 the MD5 while putting the object to Amazon S3 and compare the returned ETag to the calculated MD5
+ *                 value.</p>
  *                   </li>
  *                   <li>
  *                      <p>
  *                         <b>Directory bucket</b> -
- *                         This functionality is not supported for directory buckets.</p>
+ *                 This functionality is not supported for directory buckets.</p>
  *                   </li>
  *                </ul>
  *             </dd>
@@ -273,20 +267,20 @@ declare const PutObjectCommand_base: {
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
  * @throws {@link EncryptionTypeMismatch} (client fault)
- *  <p>
- *          The existing object was created with a different encryption type.
- *          Subsequent write requests must include the appropriate encryption
- *          parameters in the request or while creating the session.
- *       </p>
+ *  <p> The existing object was created with a different encryption type. Subsequent write requests must
+ *       include the appropriate encryption parameters in the request or while creating the session. </p>
  *
  * @throws {@link InvalidRequest} (client fault)
- *  <p>You may receive this error in multiple cases. Depending on the reason for the error, you may receive one of the messages below:</p>
+ *  <p>You may receive this error in multiple cases. Depending on the reason for the error, you may receive
+ *       one of the messages below:</p>
  *          <ul>
  *             <li>
- *                <p>Cannot specify both a write offset value and user-defined object metadata for existing objects.</p>
+ *                <p>Cannot specify both a write offset value and user-defined object metadata for existing
+ *           objects.</p>
  *             </li>
  *             <li>
- *                <p>Checksum Type mismatch occurred, expected checksum Type: sha1, actual checksum Type: crc32c.</p>
+ *                <p>Checksum Type mismatch occurred, expected checksum Type: sha1, actual checksum Type:
+ *           crc32c.</p>
  *             </li>
  *             <li>
  *                <p>Request body cannot be empty when 'write offset' is specified.</p>
@@ -294,16 +288,12 @@ declare const PutObjectCommand_base: {
  *          </ul>
  *
  * @throws {@link InvalidWriteOffset} (client fault)
- *  <p>
- *          The write offset value that you specified does not match the current object size.
- *       </p>
+ *  <p> The write offset value that you specified does not match the current object size. </p>
  *
  * @throws {@link TooManyParts} (client fault)
- *  <p>
- *          You have attempted to add more parts than the maximum of 10000
- *          that are allowed for this object. You can use the CopyObject operation
- *          to copy this object to another and then add more data to the newly copied object.
- *       </p>
+ *  <p> You have attempted to add more parts than the maximum of 10000 that are allowed for this object.
+ *       You can use the CopyObject operation to copy this object to another and then add more data to the newly
+ *       copied object. </p>
  *
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>

package/dist-types/commands/PutObjectLegalHoldCommand.d.ts

@@ -30,9 +30,7 @@ declare const PutObjectLegalHoldCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Applies a legal hold configuration to the specified object. For more information, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
- *             Objects</a>.</p>
+ *          <p>Applies a legal hold configuration to the specified object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.</p>
  *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts

@@ -30,24 +30,23 @@ declare const PutObjectLockConfigurationCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>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. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>. </p>
+ *          <p>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. For more
+ *       information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
+ *         Objects</a>. </p>
  *          <note>
  *             <ul>
  *                <li>
- *                   <p>The <code>DefaultRetention</code> settings require both a mode and a
- *                   period.</p>
+ *                   <p>The <code>DefaultRetention</code> settings require both a mode and a period.</p>
  *                </li>
  *                <li>
- *                   <p>The <code>DefaultRetention</code> period can be either <code>Days</code> or
- *                      <code>Years</code> but you must select one. You cannot specify
- *                      <code>Days</code> and <code>Years</code> at the same time.</p>
+ *                   <p>The <code>DefaultRetention</code> period can be either <code>Days</code> or <code>Years</code>
+ *             but you must select one. You cannot specify <code>Days</code> and <code>Years</code> at the same
+ *             time.</p>
  *                </li>
  *                <li>
- *                   <p>You can enable Object Lock for new or existing buckets. For more information,
- *                   see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html">Configuring Object
- *                      Lock</a>.</p>
+ *                   <p>You can enable Object Lock for new or existing buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html">Configuring
+ *               Object Lock</a>.</p>
  *                </li>
  *             </ul>
  *          </note>

package/dist-types/commands/PutObjectRetentionCommand.d.ts

@@ -30,10 +30,10 @@ declare const PutObjectRetentionCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.
- *          Users or accounts require the <code>s3:PutObjectRetention</code> permission in order to
- *          place an Object Retention configuration on objects. Bypassing a Governance Retention
- *          configuration requires the <code>s3:BypassGovernanceRetention</code> permission. </p>
+ *          <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>. Users or
+ *       accounts require the <code>s3:PutObjectRetention</code> permission in order to place an Object Retention
+ *       configuration on objects. Bypassing a Governance Retention configuration requires the
+ *         <code>s3:BypassGovernanceRetention</code> permission. </p>
  *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/PutObjectTaggingCommand.d.ts

@@ -30,44 +30,38 @@ declare const PutObjectTaggingCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
- *          key-value pair. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
- *          <p>You can associate tags with an object by sending a PUT request against the tagging
- *          subresource that is associated with the object. You can retrieve tags by sending a GET
- *          request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a>.</p>
+ *          <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a key-value pair.
+ *       For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
+ *          <p>You can associate tags with an object by sending a PUT request against the tagging subresource that
+ *       is associated with the object. You can retrieve tags by sending a GET request. For more information, see
+ *         <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a>.</p>
  *          <p>For tagging-related restrictions related to characters and encodings, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html">Tag
- *             Restrictions</a>. Note that Amazon S3 limits the maximum number of tags to 10 tags per
- *          object.</p>
- *          <p>To use this operation, you must have permission to perform the
- *             <code>s3:PutObjectTagging</code> action. By default, the bucket owner has this
- *          permission and can grant this permission to others.</p>
- *          <p>To put tags of any other version, use the <code>versionId</code> query parameter. You
- *          also need permission for the <code>s3:PutObjectVersionTagging</code> action.</p>
+ *         Restrictions</a>. Note that Amazon S3 limits the maximum number of tags to 10 tags per object.</p>
+ *          <p>To use this operation, you must have permission to perform the <code>s3:PutObjectTagging</code>
+ *       action. By default, the bucket owner has this permission and can grant this permission to others.</p>
+ *          <p>To put tags of any other version, use the <code>versionId</code> query parameter. You also need
+ *       permission for the <code>s3:PutObjectVersionTagging</code> action.</p>
  *          <p>
- *             <code>PutObjectTagging</code> has the following special errors. For more Amazon S3 errors
- *          see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">Error
- *             Responses</a>.</p>
+ *             <code>PutObjectTagging</code> has the following special errors. For more Amazon S3 errors see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">Error Responses</a>.</p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <code>InvalidTag</code> - The tag provided was not a valid tag. This error
- *                can occur if the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object
- *                   Tagging</a>.</p>
+ *                   <code>InvalidTag</code> - The tag provided was not a valid tag. This error can occur if
+ *           the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <code>MalformedXML</code> - The XML provided does not match the
- *                schema.</p>
+ *                   <code>MalformedXML</code> - The XML provided does not match the schema.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <code>OperationAborted</code> - A conflicting conditional action is
- *                currently in progress against this resource. Please try again.</p>
+ *                   <code>OperationAborted</code> - A conflicting conditional action is currently in progress
+ *           against this resource. Please try again.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <code>InternalError</code> - The service was unable to apply the provided
- *                tag to the object.</p>
+ *                   <code>InternalError</code> - The service was unable to apply the provided tag to the
+ *           object.</p>
  *             </li>
  *          </ul>
  *          <p>The following operations are related to <code>PutObjectTagging</code>:</p>

package/dist-types/commands/PutPublicAccessBlockCommand.d.ts

@@ -30,17 +30,16 @@ declare const PutPublicAccessBlockCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket.
- *          To use this operation, you must have the <code>s3:PutBucketPublicAccessBlock</code>
- *          permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
- *             Policy</a>.</p>
+ *          <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use this
+ *       operation, you must have the <code>s3:PutBucketPublicAccessBlock</code> permission. For more information
+ *       about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
+ *       Policy</a>.</p>
  *          <important>
- *             <p>When Amazon S3 evaluates the <code>PublicAccessBlock</code> configuration for a bucket or
- *             an object, it checks the <code>PublicAccessBlock</code> configuration for both the
- *             bucket (or the bucket that contains the object) and the bucket owner's account. If the
- *                <code>PublicAccessBlock</code> configurations are different between the bucket and
- *             the account, Amazon S3 uses the most restrictive combination of the bucket-level and
- *             account-level settings.</p>
+ *             <p>When Amazon S3 evaluates the <code>PublicAccessBlock</code> configuration for a bucket or an object, it
+ *         checks the <code>PublicAccessBlock</code> configuration for both the bucket (or the bucket that
+ *         contains the object) and the bucket owner's account. If the <code>PublicAccessBlock</code>
+ *         configurations are different between the bucket and the account, Amazon S3 uses the most restrictive
+ *         combination of the bucket-level and account-level settings.</p>
  *          </important>
  *          <p>For more information about when Amazon S3 considers a bucket or an object public, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status">The Meaning of "Public"</a>.</p>
  *          <p>The following operations are related to <code>PutPublicAccessBlock</code>:</p>
@@ -62,8 +61,7 @@ declare const PutPublicAccessBlockCommand_base: {
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html">Using Amazon S3 Block
- *                   Public Access</a>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html">Using Amazon S3 Block Public Access</a>
  *                </p>
  *             </li>
  *          </ul>