@aws-sdk/client-s3 3.315.0 → 3.317.0

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

@@ -24,18 +24,16 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  *          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 action is not supported by 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>
  *          <p>
  *             <b>Access Permissions</b>
@@ -47,8 +45,7 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  *                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>
+ *                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>,
@@ -57,15 +54,14 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  *                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>
+ *                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>

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

@@ -31,16 +31,12 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * @public
  * <p>Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object
  *          to it.</p>
- *          <note>
- *             <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>
- *          </note>
+ *          <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
+ *          entire object to the bucket.</p>
  *          <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. 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>.</p>
+ *          simultaneously, it overwrites all but the last object written. Amazon S3 does not provide object
+ *          locking; if you need this, make sure to build it into your application layer or use
+ *          versioning instead.</p>
  *          <p>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, returns an error. Additionally,
@@ -50,63 +46,76 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  *             <ul>
  *                <li>
  *                   <p>To successfully complete the <code>PutObject</code> request, you must have the
- *                      <code>s3:PutObject</code> in your IAM permissions.</p>
+ *                <code>s3:PutObject</code> in your IAM permissions.</p>
  *                </li>
  *                <li>
  *                   <p>To successfully change the objects acl of your <code>PutObject</code> request,
- *                   you must have the <code>s3:PutObjectAcl</code> in your IAM permissions.</p>
- *                </li>
- *                <li>
- *                   <p>To successfully set the tag-set with your <code>PutObject</code> request, you
- *                   must have the <code>s3:PutObjectTagging</code> in your IAM permissions.</p>
+ *                you must have the <code>s3:PutObjectAcl</code> in your IAM permissions.</p>
  *                </li>
  *                <li>
- *                   <p> The <code>Content-MD5</code> 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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html">Amazon S3 Object Lock
- *                      Overview</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *                   <p> The <code>Content-MD5</code> 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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html">Amazon S3 Object Lock Overview</a>
+ *                   in the <i>Amazon S3 User Guide</i>. </p>
  *                </li>
  *             </ul>
  *          </note>
- *          <p>You have three mutually exclusive options to protect data using server-side encryption
- *          in Amazon S3, depending on how you choose to manage the encryption keys. Specifically, the
- *          encryption key options are Amazon S3 managed keys (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and
- *          customer-provided keys (SSE-C). Amazon S3 encrypts data with server-side encryption by using
- *          Amazon S3 managed keys (SSE-S3) by default. You can optionally tell Amazon S3 to encrypt data at by
- *          rest using server-side encryption with other key options. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using
- *             Server-Side Encryption</a>.</p>
- *          <p>When adding a new object, you can use headers to grant ACL-based permissions to
- *          individual Amazon Web Services accounts or to predefined groups defined by Amazon S3. These permissions are
- *          then added to the ACL on the object. By default, all objects are private. Only the owner
- *          has full access control. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a>
- *          and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html">Managing
- *             ACLs Using the REST API</a>. </p>
+ *          <p>
+ *             <b>Server-side Encryption</b>
+ *          </p>
+ *          <p>You can optionally request server-side encryption. With server-side encryption, Amazon S3 encrypts
+ *          your data as it writes it to disks in its data centers and decrypts the data
+ *          when you access it. You have the option to provide your own encryption key or use Amazon Web Services
+ *          managed encryption keys (SSE-S3 or SSE-KMS). For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using Server-Side
+ *             Encryption</a>.</p>
+ *          <p>If you request server-side encryption using Amazon Web Services Key Management Service (SSE-KMS), you can enable
+ *          an S3 Bucket Key at the object-level. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the
+ *          <i>Amazon S3 User Guide</i>.</p>
+ *          <p>
+ *             <b>Access Control List (ACL)-Specific Request
+ *          Headers</b>
+ *          </p>
+ *          <p>You can use headers to grant ACL- based permissions. By default, all objects are
+ *          private. Only the owner has full access control. When adding a new object, you can grant
+ *          permissions to individual Amazon Web Services accounts or to predefined groups defined by Amazon S3. These
+ *          permissions are then added to the ACL on the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List
+ *             (ACL) Overview</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html">Managing ACLs Using the REST
+ *             API</a>. </p>
  *          <p>If the bucket that you're uploading objects to uses the bucket owner enforced setting
  *          for S3 Object Ownership, ACLs are disabled and no longer affect permissions. Buckets that
  *          use this setting only accept PUT requests that don't specify an ACL or PUT requests that
- *          specify bucket owner full control ACLs, such as the <code>bucket-owner-full-control</code>
- *          canned ACL or an equivalent form of this ACL expressed in the XML format. PUT requests that
- *          contain other ACLs (for example, custom grants to certain Amazon Web Services accounts) fail and return a
- *             <code>400</code> error with the error code <code>AccessControlListNotSupported</code>.
- *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling ownership of
- *             objects and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          specify bucket owner full control ACLs, such as the <code>bucket-owner-full-control</code> canned
+ *          ACL or an equivalent form of this ACL expressed in the XML format. PUT requests that contain other
+ *          ACLs (for example, custom grants to certain Amazon Web Services accounts) fail and return a
+ *             <code>400</code> error with the error code
+ *          <code>AccessControlListNotSupported</code>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling ownership of
+ *          objects and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          <note>
- *             <p>If your bucket uses the bucket owner enforced setting for Object Ownership, 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,
+ *             all objects written to the bucket by any account will be owned by the bucket owner.</p>
  *          </note>
+ *          <p>
+ *             <b>Storage Class Options</b>
+ *          </p>
  *          <p>By default, Amazon S3 uses the STANDARD Storage Class to store newly created objects. The
  *          STANDARD storage class provides high durability 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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html">Storage Classes</a> in the
- *             <i>Amazon S3 User Guide</i>.</p>
+ *          <i>Amazon S3 User Guide</i>.</p>
+ *          <p>
+ *             <b>Versioning</b>
+ *          </p>
  *          <p>If you enable versioning for a bucket, Amazon S3 automatically generates a unique version ID
  *          for the object being stored. Amazon S3 returns this ID in the response. When you enable
  *          versioning for a bucket, if Amazon S3 receives multiple write requests for the same object
- *          simultaneously, it stores all of the objects. For more information about versioning, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding Objects to
+ *          simultaneously, it stores all of the objects.</p>
+ *          <p>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>. 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>
- *          <p>For more information about related Amazon S3 APIs, see the following:</p>
+ *          <p class="title">
+ *             <b>Related Resources</b>
+ *          </p>
  *          <ul>
  *             <li>
  *                <p>
@@ -151,7 +160,7 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  *     "<keys>": "STRING_VALUE",
  *   },
  *   ServerSideEncryption: "AES256" || "aws:kms",
- *   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR",
+ *   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
  *   WebsiteRedirectLocation: "STRING_VALUE",
  *   SSECustomerAlgorithm: "STRING_VALUE",
  *   SSECustomerKey: "STRING_VALUE",

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

@@ -21,21 +21,22 @@ export interface PutObjectLockConfigurationCommandOutput extends PutObjectLockCo
  * @public
  * <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>
+ *          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>
+ *                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 only enable Object Lock for new buckets. If you want to turn on Object
- *                   Lock for an existing bucket, contact Amazon Web Services Support.</p>
+ *                   <p>You can only enable Object Lock for new buckets. If you want to turn on
+ *                Object Lock for an existing bucket, contact Amazon Web Services Support.</p>
  *                </li>
  *             </ul>
  *          </note>

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

@@ -20,9 +20,10 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
 /**
  * @public
  * <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>
+ *           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 action is not supported by 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

@@ -46,8 +46,7 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
  *                   <li>
  *                      <p>
  *                         <i>Cause: 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/dev/object-tagging.html">Object
- *                            Tagging</a>.</i>
+ *                         if the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object Tagging</a>.</i>
  *                      </p>
  *                   </li>
  *                </ul>
@@ -75,8 +74,8 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <i>Cause: A conflicting conditional action is currently in progress
- *                         against this resource. Please try again.</i>
+ *                         <i>Cause: A conflicting conditional action is currently in
+ *                         progress against this resource. Please try again.</i>
  *                      </p>
  *                   </li>
  *                </ul>

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

@@ -22,7 +22,7 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
  * <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>
+ *          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

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

@@ -34,13 +34,27 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *          </ul>
  *          <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>For more information about the <code>S3</code> structure in the request body, see the
- *          following:</p>
+ *          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>
+ *             <b>Querying Archives with Select Requests</b>
+ *          </p>
+ *          <p>You use a select type of request to perform SQL queries on archived objects. The
+ *          archived objects that are being queried by the select request must be formatted as
+ *          uncompressed comma-separated values (CSV) files. You can run queries and custom analytics
+ *          on your archived data without having to restore your data to a hotter Amazon S3 tier. For an
+ *          overview about select requests, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html">Querying Archived Objects</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>When making a select request, do the following:</p>
  *          <ul>
  *             <li>
+ *                <p>Define an output location for the select query's output. This must be an Amazon S3
+ *                bucket in the same Amazon Web Services Region as the bucket that contains the archive object that is
+ *                being queried. The Amazon Web Services account that initiates the job must have permissions to write
+ *                to the S3 bucket. You can specify the storage class and encryption for the output
+ *                objects stored in the bucket. For more information about output, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html">Querying Archived Objects</a>
+ *                in the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>For more information about the <code>S3</code> structure in the request body, see
+ *                the following:</p>
  *                <ul>
  *                   <li>
  *                      <p>
@@ -49,8 +63,8 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *                   </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>
@@ -94,6 +108,8 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *                </ul>
  *             </li>
  *          </ul>
+ *          <p>For more information about using SQL with S3 Glacier Select restore, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html">SQL Reference for Amazon S3 Select and
+ *             S3 Glacier Select</a> in the <i>Amazon S3 User Guide</i>. </p>
  *          <p>When making a select request, you can also do the following:</p>
  *          <ul>
  *             <li>
@@ -113,7 +129,7 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *             </li>
  *             <li>
  *                <p>You can issue more than one select request on the same Amazon S3 object. Amazon S3 doesn't
- *                duplicate requests, so avoid issuing duplicate requests.</p>
+ *                deduplicate requests, so avoid issuing duplicate requests.</p>
  *             </li>
  *             <li>
  *                <p> Amazon S3 accepts a select request even if the object has already been restored. A
@@ -123,69 +139,65 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *          <p>
  *             <b>Restoring objects</b>
  *          </p>
- *          <p>Objects that you archive to the S3 Glacier Flexible Retrieval or
+ *          <p>Objects that you archive to the S3 Glacier 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>
+ *          S3 Intelligent-Tiering Deep Archive tiers are not accessible in real time. For objects in
+ *          Archive Access or Deep Archive Access tiers you must first initiate a restore request, and
+ *          then wait until the object is moved into the Frequent Access tier. For objects in
+ *          S3 Glacier 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. To access an archived object, you must restore the object for the duration
+ *          (number of days) that you specify.</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>When restoring an archived object (or using a select request), 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 a subset of 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>
+ *                data stored in the S3 Glacier storage class or S3 Intelligent-Tiering Archive
+ *                tier when occasional urgent requests for a subset of 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
+ *                finish within 3–5 hours for objects stored in the S3 Glacier 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 are the lowest-cost retrieval option in
+ *                S3 Glacier, enabling you to retrieve large amounts, even petabytes, of data
+ *                inexpensively. Bulk retrievals typically finish within 5–12 hours for objects stored
+ *                in the S3 Glacier storage class or S3 Intelligent-Tiering Archive tier. They
+ *                typically finish within 48 hours for objects stored in the
+ *                S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. Bulk
+ *                retrievals are free for objects stored in S3 Intelligent-Tiering.</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>
+ *             <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
+ *          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>
+ *          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
@@ -195,13 +207,13 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *          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>
+ *          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>
  *             <b>Responses</b>
  *          </p>
- *          <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
@@ -283,6 +295,13 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketNotificationConfiguration.html">GetBucketNotificationConfiguration</a>
  *                </p>
  *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html">SQL Reference for
+ *                   Amazon S3 Select and S3 Glacier Select </a> in the
+ *                   <i>Amazon S3 User Guide</i>
+ *                </p>
+ *             </li>
  *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
@@ -370,7 +389,7 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *             Value: "STRING_VALUE",
  *           },
  *         ],
- *         StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR",
+ *         StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
  *       },
  *     },
  *   },

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

@@ -26,16 +26,19 @@ export interface SelectObjectContentCommandOutput extends SelectObjectContentOut
  *          specified SQL expression. You must also specify the data serialization format for the
  *          response.</p>
  *          <p>This action is not supported by 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>For more information about using SQL with Amazon S3 Select, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html"> SQL Reference for Amazon S3 Select
+ *             and S3 Glacier Select</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          <p></p>
  *          <p>
  *             <b>Permissions</b>
  *          </p>
  *          <p>You must have <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>
+ *          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></p>
  *          <p>
  *             <i>Object Data Formats</i>
@@ -66,13 +69,14 @@ export interface SelectObjectContentCommandOutput extends SelectObjectContentOut
  *                   <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
+ *                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
+ *                <p>For objects that are encrypted with Amazon S3 managed encryption 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>
@@ -99,8 +103,8 @@ export interface SelectObjectContentCommandOutput extends SelectObjectContentOut
  *             <li>
  *                <p>GLACIER, DEEP_ARCHIVE and REDUCED_REDUNDANCY storage classes: You cannot specify
  *                the GLACIER, DEEP_ARCHIVE, or <code>REDUCED_REDUNDANCY</code> storage classes. For
- *                more information, about storage classes see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro">Storage
- *                   Classes</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                more information, about storage classes see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro">Storage Classes</a>
+ *                in the <i>Amazon S3 User Guide</i>.</p>
  *             </li>
  *          </ul>
  *          <p></p>