npm - @aws-sdk/client-s3 - Versions diffs - 3.413.0 → 3.417.0 - Mend

@aws-sdk/client-s3 3.413.0 → 3.417.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 (39) hide show

package/dist-cjs/runtimeExtensions.js CHANGED Viewed

@@ -1,17 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveRuntimeExtensions = void 0;
+const region_config_resolver_1 = require("@aws-sdk/region-config-resolver");
 const protocol_http_1 = require("@smithy/protocol-http");
 const smithy_client_1 = require("@smithy/smithy-client");
 const asPartial = (t) => t;
 const resolveRuntimeExtensions = (runtimeConfig, extensions) => {
     const extensionConfiguration = {
+        ...asPartial((0, region_config_resolver_1.getAwsRegionExtensionConfiguration)(runtimeConfig)),
         ...asPartial((0, smithy_client_1.getDefaultExtensionConfiguration)(runtimeConfig)),
         ...asPartial((0, protocol_http_1.getHttpHandlerExtensionConfiguration)(runtimeConfig)),
     };
     extensions.forEach((extension) => extension.configure(extensionConfiguration));
     return {
         ...runtimeConfig,
+        ...(0, region_config_resolver_1.resolveAwsRegionExtensionConfiguration)(extensionConfiguration),
         ...(0, smithy_client_1.resolveDefaultRuntimeConfig)(extensionConfiguration),
         ...(0, protocol_http_1.resolveHttpHandlerRuntimeConfig)(extensionConfiguration),
     };

package/dist-es/runtimeExtensions.js CHANGED Viewed

@@ -1,14 +1,17 @@
+import { getAwsRegionExtensionConfiguration, resolveAwsRegionExtensionConfiguration, } from "@aws-sdk/region-config-resolver";
 import { getHttpHandlerExtensionConfiguration, resolveHttpHandlerRuntimeConfig } from "@smithy/protocol-http";
 import { getDefaultExtensionConfiguration, resolveDefaultRuntimeConfig } from "@smithy/smithy-client";
 const asPartial = (t) => t;
 export const resolveRuntimeExtensions = (runtimeConfig, extensions) => {
     const extensionConfiguration = {
+        ...asPartial(getAwsRegionExtensionConfiguration(runtimeConfig)),
         ...asPartial(getDefaultExtensionConfiguration(runtimeConfig)),
         ...asPartial(getHttpHandlerExtensionConfiguration(runtimeConfig)),
     };
     extensions.forEach((extension) => extension.configure(extensionConfiguration));
     return {
         ...runtimeConfig,
+        ...resolveAwsRegionExtensionConfiguration(extensionConfiguration),
         ...resolveDefaultRuntimeConfig(extensionConfiguration),
         ...resolveHttpHandlerRuntimeConfig(extensionConfiguration),
     };

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

@@ -26,12 +26,12 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * <p>Completes a multipart upload by assembling previously uploaded parts.</p>
  *          <p>You first initiate the multipart upload and then upload all parts using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>
  *          operation. After successfully uploading all relevant parts of an upload, you call this
- *          action to complete the upload. Upon receiving this request, Amazon S3 concatenates all the
- *          parts in ascending order by part number to create a new object. In the Complete Multipart
- *          Upload request, you must provide the parts list. You must ensure that the parts list is
- *          complete. This action concatenates the parts that you provide in the list. For each part in
- *          the list, you must provide the part number and the <code>ETag</code> value, returned after
- *          that part was uploaded.</p>
+ *          action to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts
+ *          in ascending order by part number to create a new object. In the Complete Multipart Upload
+ *          request, you must provide the parts list. You must ensure that the parts list is complete.
+ *          This action concatenates the parts that you provide in the list. For each part in the list,
+ *          you must provide the part number and the <code>ETag</code> value, returned after that part
+ *          was uploaded.</p>
  *          <p>Processing of a Complete Multipart Upload request could take several minutes to
  *          complete. After Amazon S3 begins processing the request, it sends an HTTP response header that
  *          specifies a 200 OK response. While processing is in progress, Amazon S3 periodically sends white

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

@@ -67,29 +67,31 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *          <dl>
  *             <dt>Metadata</dt>
  *             <dd>
- *                <p>When copying an object, you can preserve all metadata (the default) or specify new metadata.
- *                   However, the access control list (ACL) is not preserved and is set to private for the user making the request. To
- *                   override the default ACL setting, specify a new ACL when generating a copy request. For
- *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. </p>
- *                <p>To specify whether you want the object metadata copied from the source object or
- *                      replaced with metadata provided in the request, you can optionally add the
- *                      <code>x-amz-metadata-directive</code> header. When you grant permissions, you can use
- *                      the <code>s3:x-amz-metadata-directive</code> condition key to enforce certain metadata
- *                      behavior when objects are uploaded. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html">Specifying Conditions in a
- *                         Policy</a> in the <i>Amazon S3 User Guide</i>. For a complete list of
- *                      Amazon S3-specific condition keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, Resources, and Condition Keys for
- *                         Amazon S3</a>.</p>
+ *                <p>When copying an object, you can preserve all metadata (the default) or specify
+ *                   new metadata. However, the access control list (ACL) is not preserved and is set
+ *                   to private for the user making the request. To override the default ACL setting,
+ *                   specify a new ACL when generating a copy request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using
+ *                      ACLs</a>. </p>
+ *                <p>To specify whether you want the object metadata copied from the source object
+ *                   or replaced with metadata provided in the request, you can optionally add the
+ *                      <code>x-amz-metadata-directive</code> header. When you grant permissions, you
+ *                   can use the <code>s3:x-amz-metadata-directive</code> condition key to enforce
+ *                   certain metadata behavior when objects are uploaded. For more information, see
+ *                      <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html">Specifying Conditions in a
+ *                      Policy</a> in the <i>Amazon S3 User Guide</i>. For a complete list
+ *                   of Amazon S3-specific condition keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, Resources, and Condition
+ *                      Keys for Amazon S3</a>.</p>
  *                <note>
  *                   <p>
- *                      <code>x-amz-website-redirect-location</code> is unique to each object and must be
- *                         specified in the request headers to copy the value.</p>
+ *                      <code>x-amz-website-redirect-location</code> is unique to each object and
+ *                      must be specified in the request headers to copy the value.</p>
  *                </note>
  *             </dd>
  *             <dt>x-amz-copy-source-if Headers</dt>
  *             <dd>
- *                <p>To only copy an object under certain conditions, such as whether the <code>Etag</code>
- *                   matches or whether the object was modified before or after a specified date, use the
- *                   following request parameters:</p>
+ *                <p>To only copy an object under certain conditions, such as whether the
+ *                      <code>Etag</code> matches or whether the object was modified before or after a
+ *                   specified date, use the following request parameters:</p>
  *                <ul>
  *                   <li>
  *                      <p>
@@ -113,12 +115,14 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *                   </li>
  *                </ul>
  *                <p> If both the <code>x-amz-copy-source-if-match</code> and
- *                   <code>x-amz-copy-source-if-unmodified-since</code> headers are present in the request
- *                   and evaluate as follows, Amazon S3 returns <code>200 OK</code> and copies the data:</p>
+ *                      <code>x-amz-copy-source-if-unmodified-since</code> headers are present in the
+ *                   request and evaluate as follows, Amazon S3 returns <code>200 OK</code> and copies the
+ *                   data:</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <code>x-amz-copy-source-if-match</code> condition evaluates to true</p>
+ *                         <code>x-amz-copy-source-if-match</code> condition evaluates to
+ *                         true</p>
  *                   </li>
  *                   <li>
  *                      <p>
@@ -127,13 +131,14 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *                   </li>
  *                </ul>
  *                <p>If both the <code>x-amz-copy-source-if-none-match</code> and
- *                   <code>x-amz-copy-source-if-modified-since</code> headers are present in the request and
- *                   evaluate as follows, Amazon S3 returns the <code>412 Precondition Failed</code> response
- *                   code:</p>
+ *                      <code>x-amz-copy-source-if-modified-since</code> headers are present in the
+ *                   request and evaluate as follows, Amazon S3 returns the <code>412 Precondition
+ *                      Failed</code> response code:</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <code>x-amz-copy-source-if-none-match</code> condition evaluates to false</p>
+ *                         <code>x-amz-copy-source-if-none-match</code> condition evaluates to
+ *                         false</p>
  *                   </li>
  *                   <li>
  *                      <p>
@@ -143,13 +148,13 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *                </ul>
  *                <note>
  *                   <p>All headers with the <code>x-amz-</code> prefix, including
- *                      <code>x-amz-copy-source</code>, must be signed.</p>
+ *                         <code>x-amz-copy-source</code>, must be signed.</p>
  *                </note>
  *             </dd>
  *             <dt>Server-side encryption</dt>
  *             <dd>
- *                <p>Amazon S3 automatically encrypts all new objects that are copied to an S3 bucket. When
- *                   copying an object, if you don't specify encryption information in your copy
+ *                <p>Amazon S3 automatically encrypts all new objects that are copied to an S3 bucket.
+ *                   When copying an object, if you don't specify encryption information in your copy
  *                   request, the encryption setting of the target object is set to the default
  *                   encryption configuration of the destination bucket. By default, all buckets have a
  *                   base level of encryption configuration that uses server-side encryption with Amazon S3
@@ -159,71 +164,80 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *                   server-side encryption with customer-provided encryption keys (SSE-C), Amazon S3 uses
  *                   the corresponding KMS key, or a customer-provided key to encrypt the target
  *                   object copy.</p>
- *                <p>When you perform a <code>CopyObject</code> operation, if you want to use a different type
- *                   of encryption setting for the target object, you can use other appropriate
- *                   encryption-related headers to encrypt the target object with a KMS key, an Amazon S3 managed
- *                   key, or a customer-provided key. With server-side encryption, Amazon S3 encrypts your data as it
- *                   writes your data to disks in its data centers and decrypts the data when you access it. If the
- *                   encryption setting in your request is different from the default encryption configuration
- *                   of the destination bucket, the encryption setting in your request takes precedence. If the
- *                   source object for the copy is stored in Amazon S3 using SSE-C, you must provide the necessary
- *                   encryption information in your request so that Amazon S3 can decrypt the object for copying. For
- *                   more information about server-side encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Using Server-Side
- *                      Encryption</a>.</p>
+ *                <p>When you perform a <code>CopyObject</code> operation, if you want to use a
+ *                   different type of encryption setting for the target object, you can use other
+ *                   appropriate encryption-related headers to encrypt the target object with a
+ *                   KMS key, an Amazon S3 managed key, or a customer-provided key. With server-side
+ *                   encryption, Amazon S3 encrypts your data as it writes your data to disks in its data
+ *                   centers and decrypts the data when you access it. If the encryption setting in
+ *                   your request is different from the default encryption configuration of the
+ *                   destination bucket, the encryption setting in your request takes precedence. If
+ *                   the source object for the copy is stored in Amazon S3 using SSE-C, you must provide the
+ *                   necessary encryption information in your request so that Amazon S3 can decrypt the
+ *                   object for copying. For more information about server-side encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Using
+ *                      Server-Side Encryption</a>.</p>
  *                <p>If a target object uses SSE-KMS, you can enable an S3 Bucket Key for the
  *                   object. 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>
  *             </dd>
- *             <dt>Access Control List (ACL)-Specific Request
- *               Headers</dt>
+ *             <dt>Access Control List (ACL)-Specific Request Headers</dt>
  *             <dd>
- *                <p>When copying an object, you can optionally 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
- *                   that are 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 copying 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 <code>PUT</code> requests that don't specify an ACL or <code>PUT</code> 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.</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>
+ *                <p>When copying an object, you can optionally 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 that are 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 copying 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 <code>PUT</code> requests
+ *                   that don't specify an ACL or <code>PUT</code> 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.</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>
  *             </dd>
  *             <dt>Checksums</dt>
  *             <dd>
- *                <p>When copying an object, if it has a checksum, that checksum will be copied to the new
- *                   object by default. When you copy the object over, you can optionally specify a different
- *                   checksum algorithm to use with the <code>x-amz-checksum-algorithm</code> header.</p>
+ *                <p>When copying an object, if it has a checksum, that checksum will be copied to
+ *                   the new object by default. When you copy the object over, you can optionally
+ *                   specify a different checksum algorithm to use with the
+ *                      <code>x-amz-checksum-algorithm</code> header.</p>
  *             </dd>
  *             <dt>Storage Class Options</dt>
  *             <dd>
- *                <p>You can use the <code>CopyObject</code> action to change the storage class of an object
- *                   that is already stored in Amazon S3 by using the <code>StorageClass</code> parameter. 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>If the source object's storage class is GLACIER, you must restore a copy of
- *                  this object before you can use it as a source object for the copy operation. For
- *                  more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. For
- *                  more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html">Copying
- *                     Objects</a>.</p>
+ *                <p>You can use the <code>CopyObject</code> action to change the storage class of
+ *                   an object that is already stored in Amazon S3 by using the <code>StorageClass</code>
+ *                   parameter. 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>If the source object's storage class is GLACIER or
+ *                      DEEP_ARCHIVE, or the object's storage class is
+ *                      INTELLIGENT_TIERING and it's <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intelligent-tiering-overview.html#intel-tiering-tier-definition"> S3 Intelligent-Tiering access tier</a> is
+ *                   Archive Access or Deep Archive Access, you must restore a copy of this object
+ *                   before you can use it as a source object for the copy operation. For more
+ *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. For
+ *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html">Copying
+ *                   Objects</a>.</p>
  *             </dd>
  *             <dt>Versioning</dt>
  *             <dd>
- *                <p>By default, <code>x-amz-copy-source</code> header identifies the current version of an object
- *                   to copy. If the current version is a delete marker, Amazon S3 behaves as if the object was
- *                   deleted. To copy a different version, use the <code>versionId</code> subresource.</p>
- *                <p>If you enable versioning on the target bucket, Amazon S3 generates a unique version ID for
- *                   the object being copied. This version ID is different from the version ID of the source
- *                   object. Amazon S3 returns the version ID of the copied object in the
- *                   <code>x-amz-version-id</code> response header in the response.</p>
- *                <p>If you do not enable versioning or suspend it on the target bucket, the version ID that
- *                   Amazon S3 generates is always null.</p>
+ *                <p>By default, <code>x-amz-copy-source</code> header identifies the current
+ *                   version of an object to copy. If the current version is a delete marker, Amazon S3
+ *                   behaves as if the object was deleted. To copy a different version, use the
+ *                      <code>versionId</code> subresource.</p>
+ *                <p>If you enable versioning on the target bucket, Amazon S3 generates a unique version
+ *                   ID for the object being copied. This version ID is different from the version ID
+ *                   of the source object. Amazon S3 returns the version ID of the copied object in the
+ *                      <code>x-amz-version-id</code> response header in the response.</p>
+ *                <p>If you do not enable versioning or suspend it on the target bucket, the version
+ *                   ID that Amazon S3 generates is always null.</p>
  *             </dd>
  *          </dl>
  *          <p>The following operations are related to <code>CopyObject</code>:</p>

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

@@ -31,69 +31,95 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  *          rules</a>.</p>
  *          <p>If you want to create an Amazon S3 on Outposts bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html">Create Bucket</a>. </p>
  *          <p>By default, the bucket is created in the US East (N. Virginia) Region. You can
- *          optionally specify a Region in the request body. You might choose a Region to optimize
- *          latency, minimize costs, or address regulatory requirements. For example, if you reside in
- *          Europe, you will probably find it advantageous to create buckets in the Europe (Ireland)
- *          Region. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro">Accessing a
+ *          optionally specify a Region in the request body. To constrain the bucket creation to a
+ *          specific Region, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketConfiguration.html">
+ *                <code>LocationConstraint</code>
+ *             </a> condition key. You might choose a Region to
+ *          optimize latency, minimize costs, or address regulatory requirements. For example, if you
+ *          reside in Europe, you will probably find it advantageous to create buckets in the Europe
+ *          (Ireland) Region. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro">Accessing a
  *             bucket</a>.</p>
  *          <note>
  *             <p>If you send your create bucket request to the <code>s3.amazonaws.com</code> endpoint,
- *             the request goes to the <code>us-east-1</code> Region. Accordingly, the signature calculations in
- *             Signature Version 4 must use <code>us-east-1</code> as the Region, even if the location constraint in
- *             the request specifies another Region where the bucket is to be created. If you create a
- *             bucket in a Region other than US East (N. Virginia), your application must be able to
- *             handle 307 redirect. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html">Virtual hosting of
- *             buckets</a>.</p>
+ *             the request goes to the <code>us-east-1</code> Region. Accordingly, the signature
+ *             calculations in Signature Version 4 must use <code>us-east-1</code> as the Region, even
+ *             if the location constraint in the request specifies another Region where the bucket is
+ *             to be created. If you create a bucket in a Region other than US East (N. Virginia), your
+ *             application must be able to handle 307 redirect. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html">Virtual hosting of
+ *                buckets</a>.</p>
  *          </note>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>In addition to <code>s3:CreateBucket</code>, the following permissions are required when
- *                   your <code>CreateBucket</code> request includes specific headers:</p>
+ *                <p>In addition to <code>s3:CreateBucket</code>, the following permissions are
+ *                   required when your <code>CreateBucket</code> request includes specific
+ *                   headers:</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>Access control lists (ACLs)</b> - If your <code>CreateBucket</code> request
- *                         specifies access control list (ACL) permissions and the ACL is public-read, public-read-write,
- *                         authenticated-read, or if you specify access permissions explicitly through any other
- *                         ACL, both <code>s3:CreateBucket</code> and <code>s3:PutBucketAcl</code> permissions
- *                         are needed. If the ACL for the <code>CreateBucket</code> request is private or if the request doesn't
- *                         specify any ACLs, only <code>s3:CreateBucket</code> permission is needed. </p>
+ *                         <b>Access control lists (ACLs)</b> - If your
+ *                            <code>CreateBucket</code> request specifies access control list (ACL)
+ *                         permissions and the ACL is public-read, public-read-write,
+ *                         authenticated-read, or if you specify access permissions explicitly through
+ *                         any other ACL, both <code>s3:CreateBucket</code> and
+ *                            <code>s3:PutBucketAcl</code> permissions are needed. If the ACL for the
+ *                            <code>CreateBucket</code> request is private or if the request doesn't
+ *                         specify any ACLs, only <code>s3:CreateBucket</code> permission is needed.
+ *                      </p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>Object Lock</b> - If <code>ObjectLockEnabledForBucket</code> is set to true in your
- *                          <code>CreateBucket</code> request,
- *                          <code>s3:PutBucketObjectLockConfiguration</code> and
- *                          <code>s3:PutBucketVersioning</code> permissions are required.</p>
+ *                         <b>Object Lock</b> - If
+ *                            <code>ObjectLockEnabledForBucket</code> is set to true in your
+ *                            <code>CreateBucket</code> request,
+ *                            <code>s3:PutBucketObjectLockConfiguration</code> and
+ *                            <code>s3:PutBucketVersioning</code> permissions are required.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>S3 Object Ownership</b> - If your <code>CreateBucket</code> request includes the <code>x-amz-object-ownership</code> header, then the
- *                         <code>s3:PutBucketOwnershipControls</code> permission is required. By default, <code>ObjectOwnership</code> is set to <code>BucketOWnerEnforced</code> and ACLs are disabled. We recommend keeping
- *                      ACLs disabled, except in uncommon use cases where you must control access for each object individually. If you want to change the <code>ObjectOwnership</code> setting, you can use the
- *                      <code>x-amz-object-ownership</code> header in your <code>CreateBucket</code> request to set the <code>ObjectOwnership</code> setting of your choice.
- *                         For more information about S3 Object Ownership, 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>
+ *                         <b>S3 Object Ownership</b> - If your
+ *                            <code>CreateBucket</code> request includes the
+ *                            <code>x-amz-object-ownership</code> header, then the
+ *                            <code>s3:PutBucketOwnershipControls</code> permission is required. By
+ *                         default, <code>ObjectOwnership</code> is set to
+ *                            <code>BucketOWnerEnforced</code> and ACLs are disabled. We recommend
+ *                         keeping ACLs disabled, except in uncommon use cases where you must control
+ *                         access for each object individually. If you want to change the
+ *                            <code>ObjectOwnership</code> setting, you can use the
+ *                            <code>x-amz-object-ownership</code> header in your
+ *                            <code>CreateBucket</code> request to set the <code>ObjectOwnership</code>
+ *                         setting of your choice. For more information about S3 Object Ownership, 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>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>S3 Block Public Access</b> - If your specific use case requires granting public access to your S3 resources, you can disable Block Public Access. You can create a new bucket with Block Public Access enabled, then separately call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html">
+ *                         <b>S3 Block Public Access</b> - If your
+ *                         specific use case requires granting public access to your S3 resources, you
+ *                         can disable Block Public Access. You can create a new bucket with Block
+ *                         Public Access enabled, then separately call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html">
  *                            <code>DeletePublicAccessBlock</code>
  *                         </a> API. To use this operation, you must have the
- *                         <code>s3:PutBucketPublicAccessBlock</code> permission. By default, all Block
- *                         Public Access settings are enabled for new buckets. To avoid inadvertent exposure of
- *                         your resources, we recommend keeping the S3 Block Public Access settings enabled. For more information about S3 Block Public Access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Blocking public
- *                            access to your Amazon S3 storage </a> in the <i>Amazon S3 User Guide</i>. </p>
+ *                            <code>s3:PutBucketPublicAccessBlock</code> permission. By default, all
+ *                         Block Public Access settings are enabled for new buckets. To avoid
+ *                         inadvertent exposure of your resources, we recommend keeping the S3 Block
+ *                         Public Access settings enabled. For more information about S3 Block Public
+ *                         Access, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Blocking
+ *                            public access to your Amazon S3 storage </a> in the
+ *                            <i>Amazon S3 User Guide</i>. </p>
  *                   </li>
  *                </ul>
  *             </dd>
  *          </dl>
  *          <important>
- *             <p> If your <code>CreateBucket</code> request sets <code>BucketOwnerEnforced</code> for Amazon S3 Object Ownership
- *          and specifies a bucket ACL that provides access to an external Amazon Web Services account, your request fails with a <code>400</code> error and returns the <code>InvalidBucketAcLWithObjectOwnership</code> error code. For more information,
- *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-ownership-existing-bucket.html">Setting Object
- *             Ownership on an existing bucket </a> in the <i>Amazon S3 User Guide</i>. </p>
+ *             <p> If your <code>CreateBucket</code> request sets <code>BucketOwnerEnforced</code> for
+ *             Amazon S3 Object Ownership and specifies a bucket ACL that provides access to an external
+ *             Amazon Web Services account, your request fails with a <code>400</code> error and returns the
+ *                <code>InvalidBucketAcLWithObjectOwnership</code> error code. For more information,
+ *             see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-ownership-existing-bucket.html">Setting Object
+ *                Ownership on an existing bucket </a> in the <i>Amazon S3 User Guide</i>.
+ *          </p>
  *          </important>
  *          <p>The following operations are related to <code>CreateBucket</code>:</p>
  *          <ul>

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

@@ -32,7 +32,8 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  *          <p>If you have configured a lifecycle rule to abort incomplete multipart uploads, the
  *          upload must complete within the number of days specified in the bucket lifecycle
  *          configuration. Otherwise, the incomplete multipart upload becomes eligible for an abort
- *          action and Amazon S3 aborts the multipart upload. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config">Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle Configuration</a>.</p>
+ *          action and Amazon S3 aborts the multipart upload. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config">Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle
+ *          Configuration</a>.</p>
  *          <p>For information about the permissions required to use the multipart upload API, see
  *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart
  *             Upload and Permissions</a>.</p>
@@ -107,19 +108,19 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  *             </dd>
  *             <dt>Server-Side- Encryption-Specific Request Headers</dt>
  *             <dd>
- *                <p>Amazon S3 encrypts data
- *                   by using server-side encryption with an Amazon S3 managed key (SSE-S3) by default. Server-side encryption is for data encryption at rest. Amazon S3 encrypts
- *                   your data as it writes it to disks in its data centers and decrypts it when you
- *                   access it. You can request that Amazon S3 encrypts
- *                   data at rest by using server-side encryption with other key options. The option you use depends on
+ *                <p>Amazon S3 encrypts data by using server-side encryption with an Amazon S3 managed key
+ *                   (SSE-S3) by default. Server-side encryption is for data encryption at rest. Amazon S3
+ *                   encrypts your data as it writes it to disks in its data centers and decrypts it
+ *                   when you access it. You can request that Amazon S3 encrypts data at rest by using
+ *                   server-side encryption with other key options. The option you use depends on
  *                   whether you want to use KMS keys (SSE-KMS) or provide your own encryption keys
  *                   (SSE-C).</p>
  *                <ul>
  *                   <li>
  *                      <p>Use KMS keys (SSE-KMS) that include the Amazon Web Services managed key
- *                         (<code>aws/s3</code>) and KMS customer managed keys stored in Key Management Service (KMS) – If you
- *                         want Amazon Web Services to manage the keys used to encrypt data, specify the following
- *                         headers in the request.</p>
+ *                            (<code>aws/s3</code>) and KMS customer managed keys stored in Key Management Service (KMS) –
+ *                         If you want Amazon Web Services to manage the keys used to encrypt data, specify the
+ *                         following headers in the request.</p>
  *                      <ul>
  *                         <li>
  *                            <p>
@@ -144,9 +145,10 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  *                            protect the data.</p>
  *                      </note>
  *                      <important>
- *                         <p>All <code>GET</code> and <code>PUT</code> requests for an object protected
- *                            by KMS fail if you don't make them by using Secure Sockets Layer (SSL),
- *                            Transport Layer Security (TLS), or Signature Version 4.</p>
+ *                         <p>All <code>GET</code> and <code>PUT</code> requests for an object
+ *                            protected by KMS fail if you don't make them by using Secure Sockets
+ *                            Layer (SSL), Transport Layer Security (TLS), or Signature Version
+ *                            4.</p>
  *                      </important>
  *                      <p>For more information about server-side encryption with KMS keys
  *                         (SSE-KMS), see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingKMSEncryption.html">Protecting Data

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

@@ -23,9 +23,9 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>This implementation of the DELETE action resets the default encryption for the
- *          bucket as server-side encryption with Amazon S3 managed keys (SSE-S3). For information about the
- *          bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default Encryption</a>
+ * <p>This implementation of the DELETE action resets the default encryption for the bucket as
+ *          server-side encryption with Amazon S3 managed keys (SSE-S3). For information about the bucket
+ *          default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default Encryption</a>
  *          in the <i>Amazon S3 User Guide</i>.</p>
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutEncryptionConfiguration</code> action. The bucket owner has this permission

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

@@ -37,8 +37,9 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  *             buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
  *                <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
  *                <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
- *             denies the root principal's access. Bucket owner root principals can only be blocked from performing
- *             these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
+ *             denies the root principal's access. Bucket owner root principals can only be blocked
+ *             from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
+ *             policies.</p>
  *          </important>
  *          <p>For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and
  *             UserPolicies</a>. </p>

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

@@ -44,7 +44,8 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  *          provide an invalid token, whether there are versioned keys in the request or not, the
  *          entire Multi-Object Delete request will fail. For information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete"> MFA
  *             Delete</a>.</p>
- *          <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon S3 uses the header value to ensure that your request body has not been altered in
+ *          <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon S3
+ *          uses the header value to ensure that your request body has not been altered in
  *          transit.</p>
  *          <p>The following operations are related to <code>DeleteObjects</code>:</p>
  *          <ul>

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

@@ -40,7 +40,8 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
  *          has never been set on the bucket. </p>
  *          <p>For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a> in
  *          the Amazon S3 User Guide.</p>
- *          <p>The following operations are related to <code>GetBucketAccelerateConfiguration</code>:</p>
+ *          <p>The following operations are related to
+ *          <code>GetBucketAccelerateConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -33,7 +33,8 @@ export interface GetBucketAnalyticsConfigurationCommandOutput extends GetBucketA
  *             <i>Amazon S3 User Guide</i>. </p>
  *          <p>For information about Amazon S3 analytics feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
  *             Analysis</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p>The following operations are related to <code>GetBucketAnalyticsConfiguration</code>:</p>
+ *          <p>The following operations are related to
+ *          <code>GetBucketAnalyticsConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -34,10 +34,11 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
  *          <important>
  *             <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
  *             buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
- *             <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
- *             <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
- *             denies the root principal's access. Bucket owner root principals can only be blocked from performing
- *             these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
+ *                <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
+ *                <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
+ *             denies the root principal's access. Bucket owner root principals can only be blocked
+ *             from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
+ *             policies.</p>
  *          </important>
  *          <p>To use this API operation against an access point, provide the alias of the access point in place of the bucket name.</p>
  *          <p>To use this API operation against an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.