npm - @aws-sdk/client-s3 - Versions diffs - 3.303.0 → 3.304.0 - Mend

@aws-sdk/client-s3 3.303.0 → 3.304.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (91) hide show

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

@@ -24,16 +24,18 @@ 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>
@@ -45,7 +47,8 @@ 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>,
@@ -54,14 +57,15 @@ 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 CHANGED Viewed

@@ -31,12 +31,16 @@ 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>
- *          <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
- *          entire object to the bucket.</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 is a distributed system. If it receives multiple write requests for the same object
- *          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>
+ *          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>
  *          <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,
@@ -46,76 +50,63 @@ 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>
+ *                   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>
  *                </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>
- *             <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>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>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>.</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>
+ *          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>
  *          <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>
- *          <p>
- *             <b>Versioning</b>
- *          </p>
+ *             <i>Amazon S3 User Guide</i>.</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.</p>
- *          <p>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. 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 class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <p>For more information about related Amazon S3 APIs, see the following:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -21,22 +21,21 @@ 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 CHANGED Viewed

@@ -20,10 +20,9 @@ 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 CHANGED Viewed

@@ -46,7 +46,8 @@ 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>
@@ -74,8 +75,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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -34,27 +34,13 @@ 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>
- *             <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>
+ *          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>
  *          <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>
@@ -63,8 +49,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>
@@ -108,8 +94,6 @@ 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>
@@ -129,7 +113,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
- *                deduplicate requests, so avoid issuing duplicate requests.</p>
+ *                duplicate 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
@@ -139,65 +123,69 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *          <p>
  *             <b>Restoring objects</b>
  *          </p>
- *          <p>Objects that you archive to the S3 Glacier or
+ *          <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
- *          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>
+ *          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 (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>
+ *          <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 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 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>
  *             </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 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 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 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>
+ *                   <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>
+ *             <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
@@ -207,13 +195,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
@@ -295,13 +283,6 @@ 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.

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

@@ -26,19 +26,16 @@ 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 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>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>
  *          <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>
@@ -69,14 +66,13 @@ 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 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
+ *                <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>
@@ -103,8 +99,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>