@aws-sdk/client-s3 3.352.0 → 3.354.0

package/dist-cjs/protocols/Aws_restXml.js

@@ -684,6 +684,7 @@ const se_GetBucketAccelerateConfigurationCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = (0, smithy_client_1.map)({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = (0, smithy_client_1.resolvedPath)(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -1588,6 +1589,7 @@ const se_ListMultipartUploadsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = (0, smithy_client_1.map)({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = (0, smithy_client_1.resolvedPath)(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -1676,6 +1678,7 @@ const se_ListObjectVersionsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = (0, smithy_client_1.map)({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = (0, smithy_client_1.resolvedPath)(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -3649,6 +3652,7 @@ const de_GetBucketAccelerateConfigurationCommand = async (output, context) => {
     }
     const contents = (0, smithy_client_1.map)({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
     if (data["Status"] !== undefined) {
@@ -4892,6 +4896,7 @@ const de_ListMultipartUploadsCommand = async (output, context) => {
     }
     const contents = (0, smithy_client_1.map)({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
     if (data["Bucket"] !== undefined) {
@@ -4958,6 +4963,7 @@ const de_ListObjectsCommand = async (output, context) => {
     }
     const contents = (0, smithy_client_1.map)({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {
@@ -5024,6 +5030,7 @@ const de_ListObjectsV2Command = async (output, context) => {
     }
     const contents = (0, smithy_client_1.map)({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {
@@ -5096,6 +5103,7 @@ const de_ListObjectVersionsCommand = async (output, context) => {
     }
     const contents = (0, smithy_client_1.map)({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = (0, smithy_client_1.expectNonNull)((0, smithy_client_1.expectObject)(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {

package/dist-es/protocols/Aws_restXml.js

@@ -656,6 +656,7 @@ export const se_GetBucketAccelerateConfigurationCommand = async (input, context)
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = map({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = __resolvedPath(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -1524,6 +1525,7 @@ export const se_ListMultipartUploadsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = map({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = __resolvedPath(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -1609,6 +1611,7 @@ export const se_ListObjectVersionsCommand = async (input, context) => {
     const { hostname, protocol = "https", port, path: basePath } = await context.endpoint();
     const headers = map({}, isSerializableHeaderValue, {
         "x-amz-expected-bucket-owner": input.ExpectedBucketOwner,
+        "x-amz-request-payer": input.RequestPayer,
     });
     let resolvedPath = `${basePath?.endsWith("/") ? basePath.slice(0, -1) : basePath || ""}` + "/";
     resolvedPath = __resolvedPath(resolvedPath, input, "Bucket", () => input.Bucket, "{Bucket}", false);
@@ -3528,6 +3531,7 @@ export const de_GetBucketAccelerateConfigurationCommand = async (output, context
     }
     const contents = map({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     if (data["Status"] !== undefined) {
@@ -4735,6 +4739,7 @@ export const de_ListMultipartUploadsCommand = async (output, context) => {
     }
     const contents = map({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     if (data["Bucket"] !== undefined) {
@@ -4800,6 +4805,7 @@ export const de_ListObjectsCommand = async (output, context) => {
     }
     const contents = map({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {
@@ -4865,6 +4871,7 @@ export const de_ListObjectsV2Command = async (output, context) => {
     }
     const contents = map({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {
@@ -4936,6 +4943,7 @@ export const de_ListObjectVersionsCommand = async (output, context) => {
     }
     const contents = map({
         $metadata: deserializeMetadata(output),
+        RequestCharged: [, output.headers["x-amz-request-charged"]],
     });
     const data = __expectNonNull(__expectObject(await parseBody(output.body, context)), "body");
     if (data.CommonPrefixes === "") {

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 CreateBucket
- *                         request includes the <code>x-amz-object-ownership</code> header,
- *                         <code>s3:PutBucketOwnershipControls</code> permission is required.</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">
+ *                            <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>
@@ -226,39 +155,39 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To create a bucket
+ * @example To create a bucket in a specific region
  * ```javascript
- * // The following example creates a bucket.
+ * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
  * const input = {
- *   "Bucket": "examplebucket"
+ *   "Bucket": "examplebucket",
+ *   "CreateBucketConfiguration": {
+ *     "LocationConstraint": "eu-west-1"
+ *   }
  * };
  * const command = new CreateBucketCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "Location": "/examplebucket"
+ *   "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
  * }
  * *\/
- * // example id: to-create-a-bucket--1472851826060
+ * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
  * ```
  *
- * @example To create a bucket in a specific region
+ * @example To create a bucket
  * ```javascript
- * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
+ * // The following example creates a bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "CreateBucketConfiguration": {
- *     "LocationConstraint": "eu-west-1"
- *   }
+ *   "Bucket": "examplebucket"
  * };
  * const command = new CreateBucketCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
+ *   "Location": "/examplebucket"
  * }
  * *\/
- * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
+ * // example id: to-create-a-bucket--1472851826060
  * ```
  *
  */

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/DeleteObjectTaggingCommand.d.ts

@@ -72,39 +72,39 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To remove tag set from an object version
+ * @example To remove tag set from an object
  * ```javascript
- * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
+ * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-version-1483145285913
+ * // example id: to-remove-tag-set-from-an-object-1483145342862
  * ```
  *
- * @example To remove tag set from an object
+ * @example To remove tag set from an object version
  * ```javascript
- * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
+ * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "HappyFace.jpg",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "null"
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-1483145342862
+ * // example id: to-remove-tag-set-from-an-object-version-1483145285913
  * ```
  *
  */

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",
  * // };
  *
  * ```