@aws-sdk/client-s3 3.353.0 → 3.357.0

package/dist-es/runtimeConfig.js

@@ -11,7 +11,6 @@ import { loadConfig as loadNodeConfig } from "@aws-sdk/node-config-provider";
 import { NodeHttpHandler as RequestHandler, streamCollector } from "@aws-sdk/node-http-handler";
 import { calculateBodyLength } from "@aws-sdk/util-body-length-node";
 import { DEFAULT_RETRY_MODE } from "@aws-sdk/util-retry";
-import { getAwsChunkedEncodingStream, sdkStreamMixin } from "@aws-sdk/util-stream-node";
 import { defaultUserAgent } from "@aws-sdk/util-user-agent-node";
 import { getRuntimeConfig as getSharedRuntimeConfig } from "./runtimeConfig.shared";
 import { loadConfigsForDefaultMode } from "@aws-sdk/smithy-client";
@@ -32,7 +31,6 @@ export const getRuntimeConfig = (config) => {
         defaultUserAgentProvider: config?.defaultUserAgentProvider ??
             defaultUserAgent({ serviceId: clientSharedValues.serviceId, clientVersion: packageInfo.version }),
         eventStreamSerdeProvider: config?.eventStreamSerdeProvider ?? eventStreamSerdeProvider,
-        getAwsChunkedEncodingStream: config?.getAwsChunkedEncodingStream ?? getAwsChunkedEncodingStream,
         maxAttempts: config?.maxAttempts ?? loadNodeConfig(NODE_MAX_ATTEMPT_CONFIG_OPTIONS),
         md5: config?.md5 ?? Hash.bind(null, "md5"),
         region: config?.region ?? loadNodeConfig(NODE_REGION_CONFIG_OPTIONS, NODE_REGION_CONFIG_FILE_OPTIONS),
@@ -42,7 +40,6 @@ export const getRuntimeConfig = (config) => {
                 ...NODE_RETRY_MODE_CONFIG_OPTIONS,
                 default: async () => (await defaultConfigProvider()).retryMode || DEFAULT_RETRY_MODE,
             }),
-        sdkStreamMixin: config?.sdkStreamMixin ?? sdkStreamMixin,
         sha1: config?.sha1 ?? Hash.bind(null, "sha1"),
         sha256: config?.sha256 ?? Hash.bind(null, "sha256"),
         streamCollector: config?.streamCollector ?? streamCollector,

package/dist-es/runtimeConfig.shared.js

@@ -2,6 +2,7 @@ import { SignatureV4MultiRegion } from "@aws-sdk/signature-v4-multi-region";
 import { NoOpLogger } from "@aws-sdk/smithy-client";
 import { parseUrl } from "@aws-sdk/url-parser";
 import { fromBase64, toBase64 } from "@aws-sdk/util-base64";
+import { getAwsChunkedEncodingStream, sdkStreamMixin } from "@aws-sdk/util-stream";
 import { fromUtf8, toUtf8 } from "@aws-sdk/util-utf8";
 import { defaultEndpointResolver } from "./endpoint/endpointResolver";
 export const getRuntimeConfig = (config) => ({
@@ -10,7 +11,9 @@ export const getRuntimeConfig = (config) => ({
     base64Encoder: config?.base64Encoder ?? toBase64,
     disableHostPrefix: config?.disableHostPrefix ?? false,
     endpointProvider: config?.endpointProvider ?? defaultEndpointResolver,
+    getAwsChunkedEncodingStream: config?.getAwsChunkedEncodingStream ?? getAwsChunkedEncodingStream,
     logger: config?.logger ?? new NoOpLogger(),
+    sdkStreamMixin: config?.sdkStreamMixin ?? sdkStreamMixin,
     serviceId: config?.serviceId ?? "S3",
     signerConstructor: config?.signerConstructor ?? SignatureV4MultiRegion,
     signingEscapePath: config?.signingEscapePath ?? false,

package/dist-types/S3Client.d.ts

@@ -170,7 +170,7 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
      */
     runtime?: string;
     /**
-     * Disable dyanamically changing the endpoint of the client based on the hostPrefix
+     * Disable dynamically changing the endpoint of the client based on the hostPrefix
      * trait of an operation.
      */
     disableHostPrefix?: boolean;

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

@@ -65,8 +65,8 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *          <dl>
  *             <dt>Metadata</dt>
  *             <dd>
- *                <p>When copying an object, you can preserve all metadata (default) or specify new metadata.
- *                   However, the ACL is not preserved and is set to private for the user making the request. To
+ *                <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
@@ -147,40 +147,43 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *             <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 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 managed keys (SSE-S3). If the
- *                   destination bucket has a default encryption configuration that uses server-side encryption
- *                   with an Key Management Service (KMS) key (SSE-KMS), or a customer-provided encryption key (SSE-C),
- *                   Amazon S3 uses the corresponding KMS key, or a customer-provided key to encrypt the target
+ *                   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
+ *                   managed keys (SSE-S3). If the destination bucket has a default encryption
+ *                   configuration that uses server-side encryption with Key Management Service (KMS) keys
+ *                   (SSE-KMS), dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS), or
+ *                   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 CopyObject operation, if you want to use a different type
+ *                <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 it to disks in its data centers and decrypts the data when you access it. If the
+ *                   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>
+ *                <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>
+ *               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
- *                   defined by Amazon S3. These permissions are then added to the ACL on the object. For more
+ *                   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 PUT requests that don't specify an ACL or PUT requests that
+ *                   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
@@ -193,24 +196,24 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *             <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 may optionally specify a different
+ *                   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 using the <code>StorageClass</code> parameter. For more
+ *                   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>
+ *                  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> identifies the current version of an object
+ *                <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

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

@@ -38,134 +38,63 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  *             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 us-east-1 Region. Accordingly, the signature calculations in
- *             Signature Version 4 must use us-east-1 as the Region, even if the location constraint in
+ *             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>Access control lists (ACLs)</dt>
- *             <dd>
- *                <p>When creating a bucket using this operation, you can optionally configure the bucket ACL
- *                   to specify the accounts or groups that should be granted specific permissions on the
- *                   bucket.</p>
- *                <important>
- *                   <p>If your CreateBucket request sets bucket owner enforced for 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/about-object-ownership.html">Controlling object
- *                         ownership</a> in the <i>Amazon S3 User Guide</i>.</p>
- *                </important>
- *                <p>There are two ways to grant the appropriate permissions using the request
- *                   headers.</p>
- *                <ul>
- *                   <li>
- *                      <p>Specify a canned ACL using the <code>x-amz-acl</code> request header. Amazon S3
- *                         supports a set of predefined ACLs, known as <i>canned ACLs</i>. Each
- *                         canned ACL has a predefined set of grantees and permissions. 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 using the <code>x-amz-grant-read</code>,
- *                         <code>x-amz-grant-write</code>, <code>x-amz-grant-read-acp</code>,
- *                         <code>x-amz-grant-write-acp</code>, and <code>x-amz-grant-full-control</code>
- *                         headers. These headers map to the set of permissions Amazon S3 supports in an ACL. For
- *                         more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/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>
- *                         </li>
- *                         <li>
- *                            <p>
- *                               <code>uri</code> – if you are granting permissions to a predefined
- *                               group</p>
- *                         </li>
- *                         <li>
- *                            <p>
- *                               <code>emailAddress</code> – if the value specified is the email address of
- *                               an Amazon Web Services account</p>
- *                            <note>
- *                               <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
- *                               <ul>
- *                                  <li>
- *                                     <p>US East (N. Virginia)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p>US West (N. California)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p> US West (Oregon)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p> Asia Pacific (Singapore)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p>Asia Pacific (Sydney)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p>Asia Pacific (Tokyo)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p>Europe (Ireland)</p>
- *                                  </li>
- *                                  <li>
- *                                     <p>South America (São Paulo)</p>
- *                                  </li>
- *                               </ul>
- *                               <p>For a list of all the Amazon S3 supported Regions and endpoints, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a> in the Amazon Web Services General Reference.</p>
- *                            </note>
- *                         </li>
- *                      </ul>
- *                      <p>For example, the following <code>x-amz-grant-read</code> header grants the Amazon Web Services accounts identified by account IDs permissions to read object data and its metadata:</p>
- *                      <p>
- *                         <code>x-amz-grant-read: id="11112222333", id="444455556666" </code>
- *                      </p>
- *                   </li>
- *                </ul>
- *                <note>
- *                   <p>You can use either a canned ACL or specify access permissions explicitly. You cannot
- *                      do both.</p>
- *                </note>
- *             </dd>
  *             <dt>Permissions</dt>
  *             <dd>
  *                <p>In addition to <code>s3:CreateBucket</code>, the following permissions are required when
- *                   your CreateBucket includes specific headers:</p>
+ *                   your <code>CreateBucket</code> request includes specific headers:</p>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>ACLs</b> - If your <code>CreateBucket</code> request
- *                         specifies ACL permissions and the ACL is public-read, public-read-write,
+ *                         <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 the <code>CreateBucket</code> request is private or doesn't
+ *                         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>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>S3 Object Ownership</b> - If your CreateBucket
- *                         request includes the <code>x-amz-object-ownership</code> header,
- *                         <code>s3:PutBucketOwnershipControls</code> permission is required.</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">
+ *                            <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>
  *                   </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>
+ *          </important>
  *          <p>The following operations are related to <code>CreateBucket</code>:</p>
  *          <ul>
  *             <li>

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

@@ -29,7 +29,9 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  *          and can grant this permission to others. </p>
  *          <p>For information about <code>cors</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling Cross-Origin Resource Sharing</a> in
  *          the <i>Amazon S3 User Guide</i>.</p>
- *          <p>The following operations are related to <code>DeleteBucketCors</code>:</p>
+ *          <p class="title">
+ *             <b>Related Resources</b>
+ *          </p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -83,28 +83,28 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To delete an object (from a non-versioned bucket)
+ * @example To delete an object
  * ```javascript
- * // The following example deletes an object from a non-versioned bucket.
+ * // The following example deletes an object from an S3 bucket.
  * const input = {
- *   "Bucket": "ExampleBucket",
- *   "Key": "HappyFace.jpg"
+ *   "Bucket": "examplebucket",
+ *   "Key": "objectkey.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
+ * // example id: to-delete-an-object-1472850136595
  * ```
  *
- * @example To delete an object
+ * @example To delete an object (from a non-versioned bucket)
  * ```javascript
- * // The following example deletes an object from an S3 bucket.
+ * // The following example deletes an object from a non-versioned bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "Key": "objectkey.jpg"
+ *   "Bucket": "ExampleBucket",
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-1472850136595
+ * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
  * ```
  *
  */

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

@@ -130,20 +130,18 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To delete multiple object versions from a versioned bucket
+ * @example To delete multiple objects from a versioned bucket
  * ```javascript
- * // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
+ * // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "Delete": {
  *     "Objects": [
  *       {
- *         "Key": "HappyFace.jpg",
- *         "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *         "Key": "objectkey1"
  *       },
  *       {
- *         "Key": "HappyFace.jpg",
- *         "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *         "Key": "objectkey2"
  *       }
  *     ],
  *     "Quiet": false
@@ -155,31 +153,35 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * {
  *   "Deleted": [
  *     {
- *       "Key": "HappyFace.jpg",
- *       "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
+ *       "Key": "objectkey1"
  *     },
  *     {
- *       "Key": "HappyFace.jpg",
- *       "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
+ *       "Key": "objectkey2"
  *     }
  *   ]
  * }
  * *\/
- * // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
+ * // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
  * ```
  *
- * @example To delete multiple objects from a versioned bucket
+ * @example To delete multiple object versions from a versioned bucket
  * ```javascript
- * // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
+ * // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "Delete": {
  *     "Objects": [
  *       {
- *         "Key": "objectkey1"
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
  *       },
  *       {
- *         "Key": "objectkey2"
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
  *       }
  *     ],
  *     "Quiet": false
@@ -191,19 +193,17 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * {
  *   "Deleted": [
  *     {
- *       "DeleteMarker": "true",
- *       "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
- *       "Key": "objectkey1"
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
  *     },
  *     {
- *       "DeleteMarker": "true",
- *       "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
- *       "Key": "objectkey2"
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
  *     }
  *   ]
  * }
  * *\/
- * // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
+ * // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
  * ```
  *
  */

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

@@ -57,11 +57,13 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
  * const input = { // GetBucketAccelerateConfigurationRequest
  *   Bucket: "STRING_VALUE", // required
  *   ExpectedBucketOwner: "STRING_VALUE",
+ *   RequestPayer: "requester",
  * };
  * const command = new GetBucketAccelerateConfigurationCommand(input);
  * const response = await client.send(command);
  * // { // GetBucketAccelerateConfigurationOutput
  * //   Status: "Enabled" || "Suspended",
+ * //   RequestCharged: "requester",
  * // };
  *
  * ```

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

@@ -23,9 +23,9 @@ export interface GetBucketEncryptionCommandOutput extends GetBucketEncryptionOut
 }
 /**
  * @public
- * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets have a default encryption configuration that
- *          uses 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
+ * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets
+ *          have a default encryption configuration that uses 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 permission to perform the
  *             <code>s3:GetEncryptionConfiguration</code> action. The bucket owner has this permission