@aws-sdk/client-s3 3.844.0 → 3.845.0

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

@@ -27,20 +27,17 @@ declare const HeadObjectCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>The <code>HEAD</code> operation retrieves metadata from an object without returning the
- *          object itself. This operation is useful if you're interested only in an object's
- *          metadata.</p>
+ * <p>The <code>HEAD</code> operation retrieves metadata from an object without returning the object
+ *       itself. This operation is useful if you're interested only in an object's metadata.</p>
  *          <note>
- *             <p>A <code>HEAD</code> request has the same options as a <code>GET</code> operation on
- *             an object. The response is identical to the <code>GET</code> response except that there
- *             is no response body. Because of this, if the <code>HEAD</code> request generates an
- *             error, it returns a generic code, such as <code>400 Bad Request</code>, <code>403
- *                Forbidden</code>, <code>404 Not Found</code>, <code>405 Method Not Allowed</code>,
- *                <code>412 Precondition Failed</code>, or <code>304 Not Modified</code>. It's not
- *             possible to retrieve the exact exception of these error codes.</p>
+ *             <p>A <code>HEAD</code> request has the same options as a <code>GET</code> operation on an object. The
+ *         response is identical to the <code>GET</code> response except that there is no response body. Because
+ *         of this, if the <code>HEAD</code> request generates an error, it returns a generic code, such as
+ *           <code>400 Bad Request</code>, <code>403 Forbidden</code>, <code>404 Not Found</code>, <code>405
+ *           Method Not Allowed</code>, <code>412 Precondition Failed</code>, or <code>304 Not Modified</code>.
+ *         It's not possible to retrieve the exact exception of these error codes.</p>
  *          </note>
- *          <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common
- *             Request Headers</a>.</p>
+ *          <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common Request Headers</a>.</p>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
@@ -48,26 +45,23 @@ declare const HeadObjectCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - To
- *                         use <code>HEAD</code>, you must have the <code>s3:GetObject</code>
- *                         permission. You need the relevant read object (or version) permission for
- *                         this operation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, resources, and
- *                            condition keys for Amazon S3</a> in the <i>Amazon S3 User
- *                            Guide</i>. For more information about the permissions to S3 API
- *                         operations by S3 resource types, see <a href="/AmazonS3/latest/userguide/using-with-s3-policy-actions.html">Required permissions for Amazon S3 API operations</a> in the
- *                            <i>Amazon S3 User Guide</i>.</p>
- *                      <p>If the object you request doesn't exist, the error that Amazon S3 returns
- *                         depends on whether you also have the <code>s3:ListBucket</code>
- *                         permission.</p>
+ *                         <b>General purpose bucket permissions</b> - To use
+ *                   <code>HEAD</code>, you must have the <code>s3:GetObject</code> permission. You need the
+ *                 relevant read object (or version) permission for this operation. For more information, see
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, resources,
+ *                   and condition keys for Amazon S3</a> in the <i>Amazon S3 User Guide</i>. For more
+ *                 information about the permissions to S3 API operations by S3 resource types, see <a href="/AmazonS3/latest/userguide/using-with-s3-policy-actions.html">Required permissions for
+ *                   Amazon S3 API operations</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                      <p>If the object you request doesn't exist, the error that Amazon S3 returns depends on whether
+ *                 you also have the <code>s3:ListBucket</code> permission.</p>
  *                      <ul>
  *                         <li>
- *                            <p>If you have the <code>s3:ListBucket</code> permission on the
- *                               bucket, Amazon S3 returns an HTTP status code <code>404 Not Found</code>
- *                               error.</p>
+ *                            <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 returns an
+ *                     HTTP status code <code>404 Not Found</code> error.</p>
  *                         </li>
  *                         <li>
- *                            <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3
- *                               returns an HTTP status code <code>403 Forbidden</code> error.</p>
+ *                            <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 returns an HTTP
+ *                     status code <code>403 Forbidden</code> error.</p>
  *                         </li>
  *                      </ul>
  *                   </li>
@@ -79,34 +73,31 @@ declare const HeadObjectCommand_base: {
  * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
  *                            <code>CreateSession</code>
  *                         </a>.</p>
- *                      <p>If you enable <code>x-amz-checksum-mode</code> in the request and the
- *                         object is encrypted with Amazon Web Services Key Management Service (Amazon Web Services KMS), you must
- *                         also have the <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code>
- *                         permissions in IAM identity-based policies and KMS key policies for the
- *                         KMS key to retrieve the checksum of the object.</p>
+ *                      <p>If you enable <code>x-amz-checksum-mode</code> in the request and the object is encrypted
+ *                 with Amazon Web Services Key Management Service (Amazon Web Services KMS), you must also have the
+ *                   <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM
+ *                 identity-based policies and KMS key policies for the KMS key to retrieve the checksum of
+ *                 the object.</p>
  *                   </li>
  *                </ul>
  *             </dd>
  *             <dt>Encryption</dt>
  *             <dd>
  *                <note>
- *                   <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>,
- *                      should not be sent for <code>HEAD</code> requests if your object 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 Amazon S3 managed encryption keys (SSE-S3). The
- *                         <code>x-amz-server-side-encryption</code> header is used when you
- *                         <code>PUT</code> an object to S3 and want to specify the encryption method.
- *                      If you include this header in a <code>HEAD</code> request for an object that
- *                      uses these types of keys, you’ll get an HTTP <code>400 Bad Request</code>
- *                      error. It's because the encryption method can't be changed when you retrieve
- *                      the object.</p>
+ *                   <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>, should not be
+ *               sent for <code>HEAD</code> requests if your object 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 Amazon S3 managed encryption keys (SSE-S3). The
+ *                 <code>x-amz-server-side-encryption</code> header is used when you <code>PUT</code> an object
+ *               to S3 and want to specify the encryption method. If you include this header in a
+ *                 <code>HEAD</code> request for an object that uses these types of keys, you’ll get an HTTP
+ *                 <code>400 Bad Request</code> error. It's because the encryption method can't be changed when
+ *               you retrieve the object.</p>
  *                </note>
- *                <p>If you encrypt an object by using server-side encryption with customer-provided
- *                   encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve
- *                   the metadata from the object, you must use the following headers to provide the
- *                   encryption key for the server to be able to retrieve the object's metadata. The
- *                   headers are: </p>
+ *                <p>If you encrypt an object by using server-side encryption with customer-provided encryption
+ *             keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the metadata from the
+ *             object, you must use the following headers to provide the encryption key for the server to be able
+ *             to retrieve the object's metadata. The headers are: </p>
  *                <ul>
  *                   <li>
  *                      <p>
@@ -124,13 +115,12 @@ declare const HeadObjectCommand_base: {
  *                      </p>
  *                   </li>
  *                </ul>
- *                <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side
- *                      Encryption (Using Customer-Provided Encryption Keys)</a> in the
- *                      <i>Amazon S3 User Guide</i>.</p>
+ *                <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption (Using
+ *               Customer-Provided Encryption Keys)</a> in the <i>Amazon S3 User Guide</i>.</p>
  *                <note>
  *                   <p>
  *                      <b>Directory bucket </b> -
- *                      For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. SSE-C isn't supported. For more
+ *               For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. SSE-C isn't supported. For more
  *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html">Protecting data with server-side encryption</a> in the <i>Amazon S3 User Guide</i>. </p>
  *                </note>
  *             </dd>
@@ -138,14 +128,12 @@ declare const HeadObjectCommand_base: {
  *             <dd>
  *                <ul>
  *                   <li>
- *                      <p>If the current version of the object is a delete marker, Amazon S3 behaves as
- *                         if the object was deleted and includes <code>x-amz-delete-marker:
- *                            true</code> in the response.</p>
+ *                      <p>If the current version of the object is a delete marker, Amazon S3 behaves as if the object was
+ *                 deleted and includes <code>x-amz-delete-marker: true</code> in the response.</p>
  *                   </li>
  *                   <li>
- *                      <p>If the specified version is a delete marker, the response returns a
- *                            <code>405 Method Not Allowed</code> error and the <code>Last-Modified:
- *                            timestamp</code> response header.</p>
+ *                      <p>If the specified version is a delete marker, the response returns a <code>405 Method Not
+ *                   Allowed</code> error and the <code>Last-Modified: timestamp</code> response header.</p>
  *                   </li>
  *                </ul>
  *                <note>
@@ -153,13 +141,13 @@ declare const HeadObjectCommand_base: {
  *                      <li>
  *                         <p>
  *                            <b>Directory buckets</b> -
- *                            Delete marker is not supported for directory buckets.</p>
+ *                   Delete marker is not supported for directory buckets.</p>
  *                      </li>
  *                      <li>
  *                         <p>
  *                            <b>Directory buckets</b> -
- *                            S3 Versioning isn't enabled and supported for directory buckets. For this API operation, only the <code>null</code> value of the version ID is supported by directory buckets. You can only specify <code>null</code>
- *                            to the <code>versionId</code> query parameter in the request.</p>
+ *                   S3 Versioning isn't enabled and supported for directory buckets. For this API operation, only the <code>null</code> value of the version ID is supported by directory buckets. You can only specify <code>null</code> to the
+ *                     <code>versionId</code> query parameter in the request.</p>
  *                      </li>
  *                   </ul>
  *                </note>

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

@@ -30,25 +30,22 @@ declare const ListBucketAnalyticsConfigurationsCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Lists the analytics configurations for the bucket. You can have up to 1,000 analytics
- *          configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations at
- *          a time. You should always check the <code>IsTruncated</code> element in the response. If
- *          there are no more configurations to list, <code>IsTruncated</code> is set to false. If
- *          there are more configurations to list, <code>IsTruncated</code> is set to true, and there
- *          will be a value in <code>NextContinuationToken</code>. You use the
- *             <code>NextContinuationToken</code> value to continue the pagination of the list by
- *          passing the value in continuation-token in the request to <code>GET</code> the next
- *          page.</p>
+ *          <p>Lists the analytics configurations for the bucket. You can have up to 1,000 analytics configurations
+ *       per bucket.</p>
+ *          <p>This action supports list pagination and does not return more than 100 configurations at a time. You
+ *       should always check the <code>IsTruncated</code> element in the response. If there are no more
+ *       configurations to list, <code>IsTruncated</code> is set to false. If there are more configurations to
+ *       list, <code>IsTruncated</code> is set to true, and there will be a value in
+ *         <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value to continue
+ *       the pagination of the list by passing the value in continuation-token in the request to <code>GET</code>
+ *       the next page.</p>
  *          <p>To use this operation, you must have permissions to perform the
- *             <code>s3:GetAnalyticsConfiguration</code> action. The bucket owner has this permission
- *          by default. The bucket owner can grant this permission to others. For more information
- *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
- *             Access Permissions to Your Amazon S3 Resources</a>.</p>
+ *         <code>s3:GetAnalyticsConfiguration</code> action. The bucket owner has this permission by default. The
+ *       bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
+ *         Resources</a>.</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>. </p>
- *          <p>The following operations are related to
- *          <code>ListBucketAnalyticsConfigurations</code>:</p>
+ *       Analysis</a>. </p>
+ *          <p>The following operations are related to <code>ListBucketAnalyticsConfigurations</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -30,24 +30,21 @@ declare const ListBucketInventoryConfigurationsCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns a list of inventory configurations for the bucket. You can have up to 1,000
- *          analytics configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations at
- *          a time. Always check the <code>IsTruncated</code> element in the response. If there are no
- *          more configurations to list, <code>IsTruncated</code> is set to false. If there are more
- *          configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
- *             <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
- *          to continue the pagination of the list by passing the value in continuation-token in the
- *          request to <code>GET</code> the next page.</p>
+ *          <p>Returns a list of S3 Inventory configurations for the bucket. You can have up to 1,000 analytics
+ *       configurations per bucket.</p>
+ *          <p>This action supports list pagination and does not return more than 100 configurations at a time.
+ *       Always check the <code>IsTruncated</code> element in the response. If there are no more configurations
+ *       to list, <code>IsTruncated</code> is set to false. If there are more configurations to list,
+ *         <code>IsTruncated</code> is set to true, and there is a value in <code>NextContinuationToken</code>.
+ *       You use the <code>NextContinuationToken</code> value to continue the pagination of the list by passing
+ *       the value in continuation-token in the request to <code>GET</code> the next page.</p>
  *          <p> To use this operation, you must have permissions to perform the
- *             <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission
- *          by default. The bucket owner can grant this permission to others. For more information
- *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
- *             Access Permissions to Your Amazon S3 Resources</a>.</p>
+ *         <code>s3:GetInventoryConfiguration</code> action. The bucket owner has this permission by default. The
+ *       bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
+ *         Resources</a>.</p>
  *          <p>For information about the Amazon S3 inventory feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a>
  *          </p>
- *          <p>The following operations are related to
- *          <code>ListBucketInventoryConfigurations</code>:</p>
+ *          <p>The following operations are related to <code>ListBucketInventoryConfigurations</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -30,25 +30,22 @@ declare const ListBucketMetricsConfigurationsCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Lists the metrics configurations for the bucket. The metrics configurations are only for
- *          the request metrics of the bucket and do not provide information on daily storage metrics.
- *          You can have up to 1,000 configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations at
- *          a time. Always check the <code>IsTruncated</code> element in the response. If there are no
- *          more configurations to list, <code>IsTruncated</code> is set to false. If there are more
- *          configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
- *             <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
- *          to continue the pagination of the list by passing the value in
- *             <code>continuation-token</code> in the request to <code>GET</code> the next page.</p>
+ *          <p>Lists the metrics configurations for the bucket. The metrics configurations are only for the request
+ *       metrics of the bucket and do not provide information on daily storage metrics. You can have up to 1,000
+ *       configurations per bucket.</p>
+ *          <p>This action supports list pagination and does not return more than 100 configurations at a time.
+ *       Always check the <code>IsTruncated</code> element in the response. If there are no more configurations
+ *       to list, <code>IsTruncated</code> is set to false. If there are more configurations to list,
+ *         <code>IsTruncated</code> is set to true, and there is a value in <code>NextContinuationToken</code>.
+ *       You use the <code>NextContinuationToken</code> value to continue the pagination of the list by passing
+ *       the value in <code>continuation-token</code> in the request to <code>GET</code> the next page.</p>
  *          <p>To use this operation, you must have permissions to perform the
- *             <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by
- *          default. The bucket owner can grant this permission to others. For more information about
- *          permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
- *             Access Permissions to Your Amazon S3 Resources</a>.</p>
- *          <p>For more information about metrics configurations and CloudWatch request metrics, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>.</p>
- *          <p>The following operations are related to
- *          <code>ListBucketMetricsConfigurations</code>:</p>
+ *         <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by default. The
+ *       bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
+ *         Resources</a>.</p>
+ *          <p>For more information about metrics configurations and CloudWatch request metrics, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
+ *         Amazon CloudWatch</a>.</p>
+ *          <p>The following operations are related to <code>ListBucketMetricsConfigurations</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -37,16 +37,17 @@ declare const ListBucketsCommand_base: {
  *          <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns a list of all buckets owned by the authenticated sender of the request. To grant IAM permission to use
- *          this operation, you must add the <code>s3:ListAllMyBuckets</code> policy action. </p>
- *          <p>For information about Amazon S3 buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and
- *             working with Amazon S3 buckets</a>.</p>
+ *          <p>Returns a list of all buckets owned by the authenticated sender of the request. To grant IAM
+ *       permission to use this operation, you must add the <code>s3:ListAllMyBuckets</code> policy action. </p>
+ *          <p>For information about Amazon S3 buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and working with Amazon S3
+ *         buckets</a>.</p>
  *          <important>
- *             <p>We strongly recommend using only paginated <code>ListBuckets</code> requests. Unpaginated <code>ListBuckets</code> requests are only supported for
- *             Amazon Web Services accounts set to the default general purpose bucket quota of 10,000. If you have an approved
- *             general purpose bucket quota above 10,000, you must send paginated <code>ListBuckets</code> requests to list your account’s buckets.
- *             All unpaginated <code>ListBuckets</code> requests will be rejected for Amazon Web Services accounts with a general purpose bucket quota
- *             greater than 10,000. </p>
+ *             <p>We strongly recommend using only paginated <code>ListBuckets</code> requests. Unpaginated
+ *           <code>ListBuckets</code> requests are only supported for Amazon Web Services accounts set to the default general
+ *         purpose bucket quota of 10,000. If you have an approved general purpose bucket quota above 10,000, you
+ *         must send paginated <code>ListBuckets</code> requests to list your account’s buckets. All unpaginated
+ *           <code>ListBuckets</code> requests will be rejected for Amazon Web Services accounts with a general purpose bucket
+ *         quota greater than 10,000. </p>
  *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -27,8 +27,9 @@ declare const ListDirectoryBucketsCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a list of all Amazon S3 directory buckets owned by the authenticated sender of the
- *          request. For more information about directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html">Directory buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
+ * <p>Returns a list of all Amazon S3 directory buckets owned by the authenticated sender of the request. For
+ *       more information about directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html">Directory buckets</a> in the
+ *         <i>Amazon S3 User Guide</i>.</p>
  *          <note>
  *             <p>
  *                <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
@@ -40,21 +41,20 @@ declare const ListDirectoryBucketsCommand_base: {
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>You must have the <code>s3express:ListAllMyDirectoryBuckets</code> permission
- *                   in an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
- *                   For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>You must have the <code>s3express:ListAllMyDirectoryBuckets</code> permission in
+ *             an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
+ *             For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
  *             </dd>
  *             <dt>HTTP Host header syntax</dt>
  *             <dd>
  *                <p>
- *                   <b>Directory buckets </b> - The HTTP Host
- *                   header syntax is
- *                      <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is
+ *                 <code>s3express-control.<i>region</i>.amazonaws.com</code>.</p>
  *             </dd>
  *          </dl>
  *          <note>
  *             <p> The <code>BucketRegion</code> response element is not part of the
- *                <code>ListDirectoryBuckets</code> Response Syntax.</p>
+ *           <code>ListDirectoryBuckets</code> Response Syntax.</p>
  *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -34,47 +34,41 @@ declare const ListMultipartUploadsCommand_base: {
  *             <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
  *  Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.</p>
  *          </important>
- *          <p>This operation lists in-progress multipart uploads in a bucket. An in-progress multipart
- *          upload is a multipart upload that has been initiated by the
- *             <code>CreateMultipartUpload</code> request, but has not yet been completed or
- *          aborted.</p>
+ *          <p>This operation lists in-progress multipart uploads in a bucket. An in-progress multipart upload is a
+ *       multipart upload that has been initiated by the <code>CreateMultipartUpload</code> request, but has not
+ *       yet been completed or aborted.</p>
  *          <note>
  *             <p>
- *                <b>Directory buckets</b> - If multipart uploads in
- *             a directory bucket are in progress, you can't delete the bucket until all the
- *             in-progress multipart uploads are aborted or completed. To delete these in-progress
- *             multipart uploads, use the <code>ListMultipartUploads</code> operation to list the
- *             in-progress multipart uploads in the bucket and use the
- *                <code>AbortMultipartUpload</code> operation to abort all the in-progress multipart
- *             uploads. </p>
+ *                <b>Directory buckets</b> - If multipart uploads in a
+ *         directory bucket are in progress, you can't delete the bucket until all the in-progress multipart
+ *         uploads are aborted or completed. To delete these in-progress multipart uploads, use the
+ *           <code>ListMultipartUploads</code> operation to list the in-progress multipart uploads in the bucket
+ *         and use the <code>AbortMultipartUpload</code> operation to abort all the in-progress multipart
+ *         uploads. </p>
  *          </note>
- *          <p>The <code>ListMultipartUploads</code> operation returns a maximum of 1,000 multipart
- *          uploads in the response. The limit of 1,000 multipart uploads is also the default value.
- *          You can further limit the number of uploads in a response by specifying the
- *             <code>max-uploads</code> request parameter. If there are more than 1,000 multipart
- *          uploads that satisfy your <code>ListMultipartUploads</code> request, the response returns
- *          an <code>IsTruncated</code> element with the value of <code>true</code>, a
- *             <code>NextKeyMarker</code> element, and a <code>NextUploadIdMarker</code> element. To
- *          list the remaining multipart uploads, you need to make subsequent
- *             <code>ListMultipartUploads</code> requests. In these requests, include two query
- *          parameters: <code>key-marker</code> and <code>upload-id-marker</code>. Set the value of
- *             <code>key-marker</code> to the <code>NextKeyMarker</code> value from the previous
- *          response. Similarly, set the value of <code>upload-id-marker</code> to the
- *             <code>NextUploadIdMarker</code> value from the previous response.</p>
+ *          <p>The <code>ListMultipartUploads</code> operation returns a maximum of 1,000 multipart uploads in the
+ *       response. The limit of 1,000 multipart uploads is also the default value. You can further limit the
+ *       number of uploads in a response by specifying the <code>max-uploads</code> request parameter. If there
+ *       are more than 1,000 multipart uploads that satisfy your <code>ListMultipartUploads</code> request, the
+ *       response returns an <code>IsTruncated</code> element with the value of <code>true</code>, a
+ *         <code>NextKeyMarker</code> element, and a <code>NextUploadIdMarker</code> element. To list the
+ *       remaining multipart uploads, you need to make subsequent <code>ListMultipartUploads</code> requests. In
+ *       these requests, include two query parameters: <code>key-marker</code> and <code>upload-id-marker</code>.
+ *       Set the value of <code>key-marker</code> to the <code>NextKeyMarker</code> value from the previous
+ *       response. Similarly, set the value of <code>upload-id-marker</code> to the
+ *         <code>NextUploadIdMarker</code> value from the previous response.</p>
  *          <note>
  *             <p>
- *                <b>Directory buckets</b> - The
- *                <code>upload-id-marker</code> element and the <code>NextUploadIdMarker</code> element
- *             aren't supported by directory buckets. To list the additional multipart uploads, you
- *             only need to set the value of <code>key-marker</code> to the <code>NextKeyMarker</code>
- *             value from the previous response. </p>
+ *                <b>Directory buckets</b> - The <code>upload-id-marker</code>
+ *         element and the <code>NextUploadIdMarker</code> element aren't supported by directory buckets. To
+ *         list the additional multipart uploads, you only need to set the value of <code>key-marker</code> to
+ *         the <code>NextKeyMarker</code> value from the previous response. </p>
  *          </note>
- *          <p>For more information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
- *             Upload</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>For more information about multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart Upload</a> in
+ *       the <i>Amazon S3 User Guide</i>.</p>
  *          <note>
  *             <p>
- *                <b>Directory buckets</b> -
- *             For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
+ *                <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>amzn-s3-demo-bucket</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
  *                </code>. Path-style requests are not supported. For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
  *     <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
  *     <i>Amazon S3 User Guide</i>.</p>
@@ -85,10 +79,9 @@ declare const ListMultipartUploadsCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - For
- *                         information about 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> in the <i>Amazon S3 User Guide</i>.</p>
+ *                         <b>General purpose bucket permissions</b> - For information
+ *                 about 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> in
+ *                 the <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                   <li>
  *                      <p>
@@ -107,29 +100,28 @@ declare const ListMultipartUploadsCommand_base: {
  *                   <li>
  *                      <p>
  *                         <b>General purpose bucket</b> - In the
- *                            <code>ListMultipartUploads</code> response, the multipart uploads are
- *                         sorted based on two criteria:</p>
+ *                   <code>ListMultipartUploads</code> response, the multipart uploads are sorted based on two
+ *                 criteria:</p>
  *                      <ul>
  *                         <li>
- *                            <p>Key-based sorting - Multipart uploads are initially sorted
- *                               in ascending order based on their object keys.</p>
+ *                            <p>Key-based sorting - Multipart uploads are initially sorted in ascending order
+ *                     based on their object keys.</p>
  *                         </li>
  *                         <li>
- *                            <p>Time-based sorting - For uploads that share the same object
- *                               key, they are further sorted in ascending order based on the upload
- *                               initiation time. Among uploads with the same key, the one that was
- *                               initiated first will appear before the ones that were initiated
- *                               later.</p>
+ *                            <p>Time-based sorting - For uploads that share the same object key, they are
+ *                     further sorted in ascending order based on the upload initiation time. Among uploads with
+ *                     the same key, the one that was initiated first will appear before the ones that were
+ *                     initiated later.</p>
  *                         </li>
  *                      </ul>
  *                   </li>
  *                   <li>
  *                      <p>
  *                         <b>Directory bucket</b> - In the
- *                            <code>ListMultipartUploads</code> response, the multipart uploads aren't
- *                         sorted lexicographically based on the object keys.
+ *                   <code>ListMultipartUploads</code> response, the multipart uploads aren't sorted
+ *                 lexicographically based on the object keys.
  *
- *                      </p>
+ *               </p>
  *                   </li>
  *                </ul>
  *             </dd>

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { ListObjectVersionsOutput, ListObjectVersionsRequest } from "../models/models_0";
+import { ListObjectVersionsOutput, ListObjectVersionsRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -37,17 +37,15 @@ declare const ListObjectVersionsCommand_base: {
  *          <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns metadata about all versions of the objects in a bucket. You can also use request
- *          parameters as selection criteria to return metadata about a subset of all the object
- *          versions.</p>
+ *          <p>Returns metadata about all versions of the objects in a bucket. You can also use request parameters
+ *       as selection criteria to return metadata about a subset of all the object versions.</p>
  *          <important>
- *             <p> To use this operation, you must have permission to perform the
- *                <code>s3:ListBucketVersions</code> action. Be aware of the name difference. </p>
+ *             <p> To use this operation, you must have permission to perform the <code>s3:ListBucketVersions</code>
+ *         action. Be aware of the name difference. </p>
  *          </important>
  *          <note>
- *             <p> A <code>200 OK</code> response can contain valid or invalid XML. Make sure to design
- *             your application to parse the contents of the response and handle it
- *             appropriately.</p>
+ *             <p> A <code>200 OK</code> response can contain valid or invalid XML. Make sure to design your
+ *         application to parse the contents of the response and handle it appropriately.</p>
  *          </note>
  *          <p>To use this operation, you must have READ access to the bucket.</p>
  *          <p>The following operations are related to <code>ListObjectVersions</code>:</p>

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/smithy-client";
 import { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import { ListObjectsOutput, ListObjectsRequest } from "../models/models_0";
+import { ListObjectsOutput, ListObjectsRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -37,13 +37,14 @@ declare const ListObjectsCommand_base: {
  *          <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns some or all (up to 1,000) of the objects in a bucket. You can use the request
- *          parameters as selection criteria to return a subset of the objects in a bucket. A 200 OK
- *          response can contain valid or invalid XML. Be sure to design your application to parse the
- *          contents of the response and handle it appropriately.</p>
+ *          <p>Returns some or all (up to 1,000) of the objects in a bucket. You can use the request parameters as
+ *       selection criteria to return a subset of the objects in a bucket. A 200 OK response can contain valid or
+ *       invalid XML. Be sure to design your application to parse the contents of the response and handle it
+ *       appropriately.</p>
  *          <important>
- *             <p>This action has been revised. We recommend that you use the newer version, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html">ListObjectsV2</a>, when developing applications. For backward compatibility,
- *             Amazon S3 continues to support <code>ListObjects</code>.</p>
+ *             <p>This action has been revised. We recommend that you use the newer version, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html">ListObjectsV2</a>, when
+ *         developing applications. For backward compatibility, Amazon S3 continues to support
+ *           <code>ListObjects</code>.</p>
  *          </important>
  *          <p>The following operations are related to <code>ListObjects</code>:</p>
  *          <ul>