@aws-sdk/client-s3 3.844.0 → 3.846.0

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

@@ -27,53 +27,47 @@ declare const RenameObjectCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Renames an existing object in a directory bucket that uses the S3 Express One Zone
- *          storage class. You can use <code>RenameObject</code> by specifying an existing object’s
- *          name as the source and the new name of the object as the destination within the same
- *          directory bucket.</p>
+ * <p>Renames an existing object in a directory bucket that uses the S3 Express One Zone storage class.
+ *       You can use <code>RenameObject</code> by specifying an existing object’s name as the source and the new
+ *       name of the object as the destination within the same directory bucket.</p>
  *          <note>
  *             <p>
- *                <code>RenameObject</code> is only supported for objects stored in the S3 Express One Zone
- *          storage class.</p>
+ *                <code>RenameObject</code> is only supported for objects stored in the S3 Express One Zone storage
+ *         class.</p>
  *          </note>
- *          <p> To prevent overwriting an object, you can use the <code>If-None-Match</code> conditional header.</p>
+ *          <p> To prevent overwriting an object, you can use the <code>If-None-Match</code> conditional
+ *       header.</p>
  *          <ul>
  *             <li>
  *                <p>
- *                   <b>If-None-Match</b> - Renames the object only if
- *                an object with the specified name does not already exist in the directory bucket. If
- *                you don't want to overwrite an existing object, you can add the
- *                   <code>If-None-Match</code> conditional header with the value <code>‘*’</code> in
- *                the <code>RenameObject</code> request. Amazon S3 then returns a <code>412 Precondition
- *                   Failed</code> error if the object with the specified name already exists.
- *                For more information, see <a href="https://datatracker.ietf.org/doc/rfc7232/">RFC 7232</a>.</p>
+ *                   <b>If-None-Match</b> - Renames the object only if an object
+ *           with the specified name does not already exist in the directory bucket. If you don't want to
+ *           overwrite an existing object, you can add the <code>If-None-Match</code> conditional header with the
+ *           value <code>‘*’</code> in the <code>RenameObject</code> request. Amazon S3 then returns a <code>412
+ *             Precondition Failed</code> error if the object with the specified name already exists. For more
+ *           information, see <a href="https://datatracker.ietf.org/doc/rfc7232/">RFC 7232</a>.</p>
  *             </li>
  *          </ul>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p> To grant access to the <code>RenameObject</code> operation on a directory
- *                   bucket, we recommend that you use the <code>CreateSession</code> operation for
- *                   session-based authorization. Specifically, you grant the
- *                      <code>s3express:CreateSession</code> permission to the directory bucket in a
- *                   bucket policy or an IAM identity-based policy. Then, you make the
- *                      <code>CreateSession</code> API call on the directory bucket to obtain a session
- *                   token. With the session token in your request header, you can make API requests to
- *                   this operation. After the session token expires, you make another
- *                      <code>CreateSession</code> API call to generate a new session token for use.
- *                   The Amazon Web Services CLI and SDKs will create and manage your session including refreshing
- *                   the session token automatically to avoid service interruptions when a session
- *                   expires. In your bucket policy, you can specify the
- *                      <code>s3express:SessionMode</code> condition key to control who can create a
- *                      <code>ReadWrite</code> or <code>ReadOnly</code> session. A
- *                      <code>ReadWrite</code> session is required for executing all the Zonal endpoint
- *                   API operations, including <code>RenameObject</code>. For more information about
- *                   authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                <p> To grant access to the <code>RenameObject</code> operation on a directory bucket, we
+ *             recommend that you use the <code>CreateSession</code> operation for session-based authorization.
+ *             Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory
+ *             bucket in a bucket policy or an IAM identity-based policy. Then, you make the
+ *               <code>CreateSession</code> API call on the directory bucket to obtain a session token. With the
+ *             session token in your request header, you can make API requests to this operation. After the
+ *             session token expires, you make another <code>CreateSession</code> API call to generate a new
+ *             session token for use. The Amazon Web Services CLI and SDKs will create and manage your session including
+ *             refreshing the session token automatically to avoid service interruptions when a session expires.
+ *             In your bucket policy, you can specify the <code>s3express:SessionMode</code> condition key to
+ *             control who can create a <code>ReadWrite</code> or <code>ReadOnly</code> session. A
+ *               <code>ReadWrite</code> session is required for executing all the Zonal endpoint API operations,
+ *             including <code>RenameObject</code>. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
  *                      <code>CreateSession</code>
- *                   </a>. To learn more about Zonal endpoint API
- *                   operations, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-create-session.html">Authorizing
- *                      Zonal endpoint API operations with CreateSession</a> in the <i>Amazon S3
- *                      User Guide</i>. </p>
+ *                   </a>. To learn more about Zonal endpoint API operations, see
+ *               <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-create-session.html">Authorizing Zonal endpoint API operations with CreateSession</a> in the <i>Amazon S3 User
+ *               Guide</i>. </p>
  *             </dd>
  *             <dt>HTTP Host header syntax</dt>
  *             <dd>
@@ -115,12 +109,12 @@ declare const RenameObjectCommand_base: {
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
  * @throws {@link IdempotencyParameterMismatch} (client fault)
- *  <p>Parameters on this idempotent request are inconsistent with parameters used in previous request(s).
- *          </p>
- *          <p>For a list of error codes and more information on Amazon S3 errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">Error
- *             codes</a>.</p>
+ *  <p>Parameters on this idempotent request are inconsistent with parameters used in previous request(s). </p>
+ *          <p>For a list of error codes and more information on Amazon S3 errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">Error codes</a>.</p>
  *          <note>
- *             <p>Idempotency ensures that an API request completes no more than one time. With an idempotent request, if the original request completes successfully, any subsequent retries complete successfully without performing any further actions.</p>
+ *             <p>Idempotency ensures that an API request completes no more than one time. With an idempotent
+ *         request, if the original request completes successfully, any subsequent retries complete successfully
+ *         without performing any further actions.</p>
  *          </note>
  *
  * @throws {@link S3ServiceException}

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

@@ -40,7 +40,7 @@ declare const RestoreObjectCommand_base: {
  *             </li>
  *          </ul>
  *          <p>For more information about the <code>S3</code> structure in the request body, see the
- *          following:</p>
+ *       following:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -49,117 +49,108 @@ declare const RestoreObjectCommand_base: {
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Managing Access with ACLs</a> in the
- *                <i>Amazon S3 User Guide</i>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Managing Access
+ *             with ACLs</a> in the <i>Amazon S3 User Guide</i>
  *                </p>
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting Data Using Server-Side Encryption</a> in the
- *                   <i>Amazon S3 User Guide</i>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting Data
+ *             Using Server-Side Encryption</a> in the <i>Amazon S3 User Guide</i>
  *                </p>
  *             </li>
  *          </ul>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>To use this operation, you must have permissions to perform the
- *                      <code>s3:RestoreObject</code> action. The bucket owner has this permission by
- *                   default and can grant this permission to others. For more information about
- *                   permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3 Resources</a> in the
- *                      <i>Amazon S3 User Guide</i>.</p>
+ *                <p>To use this operation, you must have permissions to perform the <code>s3:RestoreObject</code>
+ *             action. The bucket owner has this permission by default and can grant this permission to others.
+ *             For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
+ *               Resources</a> in the <i>Amazon S3 User Guide</i>.</p>
  *             </dd>
  *             <dt>Restoring objects</dt>
  *             <dd>
- *                <p>Objects that you archive to the S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage class, and S3 Intelligent-Tiering Archive or
- *                   S3 Intelligent-Tiering Deep Archive tiers, are not accessible in real time. For objects in the
- *                   S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive
- *                   storage classes, you must first initiate a restore request, and then wait until a
- *                   temporary copy of the object is available. If you want a permanent copy of the
- *                   object, create a copy of it in the Amazon S3 Standard storage class in your S3 bucket.
- *                   To access an archived object, you must restore the object for the duration (number
- *                   of days) that you specify. For objects in the Archive Access or Deep Archive
- *                   Access tiers of S3 Intelligent-Tiering, you must first initiate a restore request,
- *                   and then wait until the object is moved into the Frequent Access tier.</p>
- *                <p>To restore a specific object version, you can provide a version ID. If you
- *                   don't provide a version ID, Amazon S3 restores the current version.</p>
- *                <p>When restoring an archived object, you can specify one of the following data
- *                   access tier options in the <code>Tier</code> element of the request body: </p>
+ *                <p>Objects that you archive to the S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive
+ *             storage class, and S3 Intelligent-Tiering Archive or S3 Intelligent-Tiering Deep Archive tiers, are not accessible in
+ *             real time. For objects in the S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive
+ *             storage classes, you must first initiate a restore request, and then wait until a temporary copy
+ *             of the object is available. If you want a permanent copy of the object, create a copy of it in the
+ *             Amazon S3 Standard storage class in your S3 bucket. To access an archived object, you must restore the
+ *             object for the duration (number of days) that you specify. For objects in the Archive Access or
+ *             Deep Archive Access tiers of S3 Intelligent-Tiering, you must first initiate a restore request, and
+ *             then wait until the object is moved into the Frequent Access tier.</p>
+ *                <p>To restore a specific object version, you can provide a version ID. If you don't provide a
+ *             version ID, Amazon S3 restores the current version.</p>
+ *                <p>When restoring an archived object, you can specify one of the following data access tier
+ *             options in the <code>Tier</code> element of the request body: </p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <code>Expedited</code> - Expedited retrievals allow you to quickly access
- *                         your data stored in the S3 Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier when occasional urgent requests
- *                         for restoring archives are required. For all but the largest archived
- *                         objects (250 MB+), data accessed using Expedited retrievals is typically
- *                         made available within 1–5 minutes. Provisioned capacity ensures that
- *                         retrieval capacity for Expedited retrievals is available when you need it.
- *                         Expedited retrievals and provisioned capacity are not available for objects
- *                         stored in the S3 Glacier Deep Archive storage class or
- *                         S3 Intelligent-Tiering Deep Archive tier.</p>
+ *                         <code>Expedited</code> - Expedited retrievals allow you to quickly access your data stored
+ *                 in the S3 Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier when occasional
+ *                 urgent requests for restoring archives are required. For all but the largest archived objects
+ *                 (250 MB+), data accessed using Expedited retrievals is typically made available within 1–5
+ *                 minutes. Provisioned capacity ensures that retrieval capacity for Expedited retrievals is
+ *                 available when you need it. Expedited retrievals and provisioned capacity are not available
+ *                 for objects stored in the S3 Glacier Deep Archive storage class or
+ *                 S3 Intelligent-Tiering Deep Archive tier.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <code>Standard</code> - Standard retrievals allow you to access any of
- *                         your archived objects within several hours. This is the default option for
- *                         retrieval requests that do not specify the retrieval option. Standard
- *                         retrievals typically finish within 3–5 hours for objects stored in the
- *                         S3 Glacier Flexible Retrieval storage class or
- *                         S3 Intelligent-Tiering Archive tier. They typically finish within 12 hours for
- *                         objects stored in the S3 Glacier Deep Archive storage class or
- *                         S3 Intelligent-Tiering Deep Archive tier. Standard retrievals are free for objects stored
- *                         in S3 Intelligent-Tiering.</p>
+ *                         <code>Standard</code> - Standard retrievals allow you to access any of your archived
+ *                 objects within several hours. This is the default option for retrieval requests that do not
+ *                 specify the retrieval option. Standard retrievals typically finish within 3–5 hours for
+ *                 objects stored in the S3 Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier.
+ *                 They typically finish within 12 hours for objects stored in the
+ *                 S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. Standard
+ *                 retrievals are free for objects stored in S3 Intelligent-Tiering.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <code>Bulk</code> - Bulk retrievals free for objects stored in the
- *                         S3 Glacier Flexible Retrieval and S3 Intelligent-Tiering storage classes,
- *                         enabling you to retrieve large amounts, even petabytes, of data at no cost.
- *                         Bulk retrievals typically finish within 5–12 hours for objects stored in the
- *                         S3 Glacier Flexible Retrieval storage class or
- *                         S3 Intelligent-Tiering Archive tier. Bulk retrievals are also the lowest-cost
- *                         retrieval option when restoring objects from
- *                         S3 Glacier Deep Archive. They typically finish within 48 hours for
- *                         objects stored in the S3 Glacier Deep Archive storage class or
- *                         S3 Intelligent-Tiering Deep Archive tier. </p>
+ *                         <code>Bulk</code> - Bulk retrievals free for objects stored in the S3 Glacier Flexible
+ *                 Retrieval and S3 Intelligent-Tiering storage classes, enabling you to retrieve large amounts,
+ *                 even petabytes, of data at no cost. Bulk retrievals typically finish within 5–12 hours for
+ *                 objects stored in the S3 Glacier Flexible Retrieval storage class or S3 Intelligent-Tiering Archive tier.
+ *                 Bulk retrievals are also the lowest-cost retrieval option when restoring objects from
+ *                 S3 Glacier Deep Archive. They typically finish within 48 hours for objects stored in
+ *                 the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. </p>
  *                   </li>
  *                </ul>
- *                <p>For more information about archive retrieval options and provisioned capacity
- *                   for <code>Expedited</code> data access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring Archived
- *                      Objects</a> in the <i>Amazon S3 User Guide</i>. </p>
- *                <p>You can use Amazon S3 restore speed upgrade to change the restore speed to a faster
- *                   speed while it is in progress. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html"> Upgrading the speed of an in-progress restore</a> in the
- *                      <i>Amazon S3 User Guide</i>. </p>
- *                <p>To get the status of object restoration, you can send a <code>HEAD</code>
- *                   request. Operations return the <code>x-amz-restore</code> header, which provides
- *                   information about the restoration status, in the response. You can use Amazon S3 event
- *                   notifications to notify you when a restore is initiated or completed. For more
- *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Amazon S3 Event
- *                      Notifications</a> in the <i>Amazon S3 User Guide</i>.</p>
- *                <p>After restoring an archived object, you can update the restoration period by
- *                   reissuing the request with a new period. Amazon S3 updates the restoration period
- *                   relative to the current time and charges only for the request-there are no
- *                   data transfer charges. You cannot update the restoration period when Amazon S3 is
- *                   actively processing your current restore request for the object.</p>
- *                <p>If your bucket has a lifecycle configuration with a rule that includes an
- *                   expiration action, the object expiration overrides the life span that you specify
- *                   in a restore request. For example, if you restore an object copy for 10 days, but
- *                   the object is scheduled to expire in 3 days, Amazon S3 deletes the object in 3 days.
- *                   For more information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html">PutBucketLifecycleConfiguration</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
- *                      Management</a> in <i>Amazon S3 User Guide</i>.</p>
+ *                <p>For more information about archive retrieval options and provisioned capacity for
+ *               <code>Expedited</code> data access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring Archived Objects</a> in the
+ *               <i>Amazon S3 User Guide</i>. </p>
+ *                <p>You can use Amazon S3 restore speed upgrade to change the restore speed to a faster speed while it
+ *             is in progress. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html#restoring-objects-upgrade-tier.title.html">
+ *               Upgrading the speed of an in-progress restore</a> in the
+ *               <i>Amazon S3 User Guide</i>. </p>
+ *                <p>To get the status of object restoration, you can send a <code>HEAD</code> request. Operations
+ *             return the <code>x-amz-restore</code> header, which provides information about the restoration
+ *             status, in the response. You can use Amazon S3 event notifications to notify you when a restore is
+ *             initiated or completed. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Amazon S3 Event Notifications</a> in
+ *             the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>After restoring an archived object, you can update the restoration period by reissuing the
+ *             request with a new period. Amazon S3 updates the restoration period relative to the current time and
+ *             charges only for the request-there are no data transfer charges. You cannot update the
+ *             restoration period when Amazon S3 is actively processing your current restore request for the
+ *             object.</p>
+ *                <p>If your bucket has a lifecycle configuration with a rule that includes an expiration action,
+ *             the object expiration overrides the life span that you specify in a restore request. For example,
+ *             if you restore an object copy for 10 days, but the object is scheduled to expire in 3 days, Amazon S3
+ *             deletes the object in 3 days. For more information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html">PutBucketLifecycleConfiguration</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle Management</a> in
+ *               <i>Amazon S3 User Guide</i>.</p>
  *             </dd>
  *             <dt>Responses</dt>
  *             <dd>
- *                <p>A successful action returns either the <code>200 OK</code> or <code>202
- *                      Accepted</code> status code. </p>
+ *                <p>A successful action returns either the <code>200 OK</code> or <code>202 Accepted</code> status
+ *             code. </p>
  *                <ul>
  *                   <li>
- *                      <p>If the object is not previously restored, then Amazon S3 returns <code>202
- *                            Accepted</code> in the response. </p>
+ *                      <p>If the object is not previously restored, then Amazon S3 returns <code>202 Accepted</code> in
+ *                 the response. </p>
  *                   </li>
  *                   <li>
- *                      <p>If the object is previously restored, Amazon S3 returns <code>200 OK</code> in
- *                         the response. </p>
+ *                      <p>If the object is previously restored, Amazon S3 returns <code>200 OK</code> in the response.
+ *               </p>
  *                   </li>
  *                </ul>
  *                <ul>
@@ -197,10 +188,10 @@ declare const RestoreObjectCommand_base: {
  *                         </li>
  *                         <li>
  *                            <p>
- *                               <i>Cause: expedited retrievals are currently not available.
- *                                  Try again later. (Returned if there is insufficient capacity to
- *                                  process the Expedited request. This error applies only to Expedited
- *                                  retrievals and not to S3 Standard or Bulk retrievals.)</i>
+ *                               <i>Cause: expedited retrievals are currently not available. Try again later.
+ *                       (Returned if there is insufficient capacity to process the Expedited request. This error
+ *                       applies only to Expedited retrievals and not to S3 Standard or Bulk
+ *                       retrievals.)</i>
  *                            </p>
  *                         </li>
  *                         <li>

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

@@ -30,104 +30,95 @@ declare const SelectObjectContentCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>This action filters the contents of an Amazon S3 object based on a simple structured query
- *          language (SQL) statement. In the request, along with the SQL expression, you must also
- *          specify a data serialization format (JSON, CSV, or Apache Parquet) of the object. Amazon S3 uses
- *          this format to parse object data into records, and returns only records that match the
- *          specified SQL expression. You must also specify the data serialization format for the
- *          response.</p>
+ *          <p>This action filters the contents of an Amazon S3 object based on a simple structured query language (SQL)
+ *       statement. In the request, along with the SQL expression, you must also specify a data serialization
+ *       format (JSON, CSV, or Apache Parquet) of the object. Amazon S3 uses this format to parse object data into
+ *       records, and returns only records that match the specified SQL expression. You must also specify the
+ *       data serialization format for the response.</p>
  *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
- *          <p>For more information about Amazon S3 Select, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html">Selecting Content from
- *             Objects</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html">SELECT
- *             Command</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>For more information about Amazon S3 Select, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html">Selecting Content from Objects</a>
+ *       and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html">SELECT Command</a> in
+ *       the <i>Amazon S3 User Guide</i>.</p>
  *          <p></p>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>You must have the <code>s3:GetObject</code> permission for this operation. Amazon S3
- *                   Select does not support anonymous access. For more information about permissions,
- *                   see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in
- *                      a Policy</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>You must have the <code>s3:GetObject</code> permission for this operation. Amazon S3 Select does
+ *             not support anonymous access. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
+ *               in a Policy</a> in the <i>Amazon S3 User Guide</i>.</p>
  *             </dd>
  *             <dt>Object Data Formats</dt>
  *             <dd>
- *                <p>You can use Amazon S3 Select to query objects that have the following format
- *                   properties:</p>
+ *                <p>You can use Amazon S3 Select to query objects that have the following format properties:</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <i>CSV, JSON, and Parquet</i> - Objects must be in CSV,
- *                         JSON, or Parquet format.</p>
+ *                         <i>CSV, JSON, and Parquet</i> - Objects must be in CSV, JSON, or Parquet
+ *                 format.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <i>UTF-8</i> - UTF-8 is the only encoding type Amazon S3 Select
- *                         supports.</p>
+ *                         <i>UTF-8</i> - UTF-8 is the only encoding type Amazon S3 Select supports.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <i>GZIP or BZIP2</i> - CSV and JSON files can be compressed
- *                         using GZIP or BZIP2. GZIP and BZIP2 are the only compression formats that
- *                         Amazon S3 Select supports for CSV and JSON files. Amazon S3 Select supports columnar
- *                         compression for Parquet using GZIP or Snappy. Amazon S3 Select does not support
- *                         whole-object compression for Parquet objects.</p>
+ *                         <i>GZIP or BZIP2</i> - CSV and JSON files can be compressed using GZIP or
+ *                 BZIP2. GZIP and BZIP2 are the only compression formats that Amazon S3 Select supports for CSV and
+ *                 JSON files. Amazon S3 Select supports columnar compression for Parquet using GZIP or Snappy. Amazon S3
+ *                 Select does not support whole-object compression for Parquet objects.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <i>Server-side encryption</i> - Amazon S3 Select supports
- *                         querying objects that are protected with server-side encryption.</p>
- *                      <p>For objects that are encrypted with customer-provided encryption keys
- *                         (SSE-C), you must use HTTPS, and you must use the headers that are
- *                         documented in the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html">GetObject</a>. For more
- *                         information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption (Using Customer-Provided Encryption Keys)</a>
- *                         in the <i>Amazon S3 User Guide</i>.</p>
- *                      <p>For objects that are encrypted with Amazon S3 managed keys (SSE-S3) and
- *                         Amazon Web Services KMS keys (SSE-KMS), server-side encryption is handled transparently,
- *                         so you don't need to specify anything. For more information about
- *                         server-side encryption, including SSE-S3 and SSE-KMS, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting Data Using Server-Side Encryption</a> in the
- *                            <i>Amazon S3 User Guide</i>.</p>
+ *                         <i>Server-side encryption</i> - Amazon S3 Select supports querying objects that
+ *                 are protected with server-side encryption.</p>
+ *                      <p>For objects that are encrypted with customer-provided encryption keys (SSE-C), you must
+ *                 use HTTPS, and you must use the headers that are documented in the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html">GetObject</a>. For more information about
+ *                 SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
+ *                   (Using Customer-Provided Encryption Keys)</a> in the
+ *                   <i>Amazon S3 User Guide</i>.</p>
+ *                      <p>For objects that are encrypted with Amazon S3 managed keys (SSE-S3) and Amazon Web Services KMS keys
+ *                 (SSE-KMS), server-side encryption is handled transparently, so you don't need to specify
+ *                 anything. For more information about server-side encryption, including SSE-S3 and SSE-KMS, see
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Protecting
+ *                   Data Using Server-Side Encryption</a> in the
+ *                 <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                </ul>
  *             </dd>
  *             <dt>Working with the Response Body</dt>
  *             <dd>
- *                <p>Given the response size is unknown, Amazon S3 Select streams the response as a
- *                   series of messages and includes a <code>Transfer-Encoding</code> header with
- *                      <code>chunked</code> as its value in the response. For more information, see
- *                      <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html">Appendix:
- *                      SelectObjectContent
- *                   Response</a>.</p>
+ *                <p>Given the response size is unknown, Amazon S3 Select streams the response as a series of messages
+ *             and includes a <code>Transfer-Encoding</code> header with <code>chunked</code> as its value in the
+ *             response. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html">Appendix: SelectObjectContent
+ *               Response</a>.</p>
  *             </dd>
  *             <dt>GetObject Support</dt>
  *             <dd>
  *                <p>The <code>SelectObjectContent</code> action does not support the following
- *                      <code>GetObject</code> functionality. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html">GetObject</a>.</p>
+ *               <code>GetObject</code> functionality. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html">GetObject</a>.</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <code>Range</code>: Although you can specify a scan range for an Amazon S3 Select
- *                         request (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange">SelectObjectContentRequest - ScanRange</a> in the request
- *                         parameters), you cannot specify the range of bytes of an object to return.
- *                      </p>
+ *                         <code>Range</code>: Although you can specify a scan range for an Amazon S3 Select request (see
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange">SelectObjectContentRequest - ScanRange</a> in the request parameters), you
+ *                 cannot specify the range of bytes of an object to return. </p>
  *                   </li>
  *                   <li>
- *                      <p>The <code>GLACIER</code>, <code>DEEP_ARCHIVE</code>, and
- *                            <code>REDUCED_REDUNDANCY</code> storage classes, or the
- *                            <code>ARCHIVE_ACCESS</code> and <code>DEEP_ARCHIVE_ACCESS</code> access
- *                         tiers of the <code>INTELLIGENT_TIERING</code> storage class: You cannot
- *                         query objects in the <code>GLACIER</code>, <code>DEEP_ARCHIVE</code>, or
- *                            <code>REDUCED_REDUNDANCY</code> storage classes, nor objects in the
- *                            <code>ARCHIVE_ACCESS</code> or <code>DEEP_ARCHIVE_ACCESS</code> access
- *                         tiers of the <code>INTELLIGENT_TIERING</code> storage class. For more
- *                         information about storage classes, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html">Using Amazon S3
- *                            storage classes</a> in the
- *                         <i>Amazon S3 User Guide</i>.</p>
+ *                      <p>The <code>GLACIER</code>, <code>DEEP_ARCHIVE</code>, and <code>REDUCED_REDUNDANCY</code>
+ *                 storage classes, or the <code>ARCHIVE_ACCESS</code> and <code>DEEP_ARCHIVE_ACCESS</code>
+ *                 access tiers of the <code>INTELLIGENT_TIERING</code> storage class: You cannot query objects
+ *                 in the <code>GLACIER</code>, <code>DEEP_ARCHIVE</code>, or <code>REDUCED_REDUNDANCY</code>
+ *                 storage classes, nor objects in the <code>ARCHIVE_ACCESS</code> or
+ *                   <code>DEEP_ARCHIVE_ACCESS</code> access tiers of the <code>INTELLIGENT_TIERING</code>
+ *                 storage class. For more information about storage classes, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html">Using Amazon S3 storage classes</a>
+ *                 in the <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                </ul>
  *             </dd>
  *             <dt>Special Errors</dt>
  *             <dd>
- *                <p>For a list of special errors for this operation, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList">List of SELECT Object Content Error Codes</a>
+ *                <p>For a list of special errors for this operation, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList">List of SELECT
+ *               Object Content Error Codes</a>
  *                </p>
  *             </dd>
  *          </dl>