@aws-sdk/client-s3 3.697.0 → 3.698.0

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

@@ -27,24 +27,33 @@ declare const HeadBucketCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>You can use this operation to determine if a bucket exists and if you have permission to access it. The action returns a <code>200 OK</code> if the bucket exists and you have permission
- *          to access it.</p>
+ * <p>You can use this operation to determine if a bucket exists and if you have permission to
+ *          access it. The action returns a <code>200 OK</code> if the bucket exists and you have
+ *          permission to access it.</p>
  *          <note>
  *             <p>If the bucket does not exist or you do not have permission to access it, the
- *             <code>HEAD</code> request returns a generic <code>400 Bad Request</code>, <code>403
- *             Forbidden</code> or <code>404 Not Found</code> code. A message body is not included, so
- *          you cannot determine the exception beyond these HTTP response codes.</p>
+ *                <code>HEAD</code> request returns a generic <code>400 Bad Request</code>, <code>403
+ *                Forbidden</code> or <code>404 Not Found</code> code. A message body is not included,
+ *             so you cannot determine the exception beyond these HTTP response codes.</p>
  *          </note>
  *          <dl>
  *             <dt>Authentication and authorization</dt>
  *             <dd>
  *                <p>
- *                   <b>General purpose buckets</b> - Request to public buckets that grant the s3:ListBucket permission publicly do not need to be signed. All other <code>HeadBucket</code> requests must be authenticated and signed by using IAM credentials (access key ID and secret access key for the IAM identities). All headers with the <code>x-amz-</code> prefix, including
- *                         <code>x-amz-copy-source</code>, must be signed. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
+ *                   <b>General purpose buckets</b> - Request to public
+ *                   buckets that grant the s3:ListBucket permission publicly do not need to be signed.
+ *                   All other <code>HeadBucket</code> requests must be authenticated and signed by
+ *                   using IAM credentials (access key ID and secret access key for the IAM
+ *                   identities). All headers with the <code>x-amz-</code> prefix, including
+ *                      <code>x-amz-copy-source</code>, must be signed. For more information, see
+ *                      <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
  *                <p>
- *                   <b>Directory buckets</b> - You must use IAM credentials to authenticate and authorize your access to the <code>HeadBucket</code> API operation, instead of using the
- *                   temporary security credentials through the <code>CreateSession</code> API operation.</p>
- *                <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your behalf.</p>
+ *                   <b>Directory buckets</b> - You must use IAM
+ *                   credentials to authenticate and authorize your access to the
+ *                      <code>HeadBucket</code> API operation, instead of using the temporary security
+ *                   credentials through the <code>CreateSession</code> API operation.</p>
+ *                <p>Amazon Web Services CLI or SDKs handles authentication and authorization on your
+ *                   behalf.</p>
  *             </dd>
  *             <dt>Permissions</dt>
  *             <dd>
@@ -52,10 +61,13 @@ declare const HeadBucketCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - To use this operation, you must have permissions to perform the
- *                         <code>s3:ListBucket</code> action. The bucket owner has this permission by default and
- *                         can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
- *                            access permissions to your Amazon S3 resources</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                         <b>General purpose bucket permissions</b> - To
+ *                         use this operation, you must have permissions to perform the
+ *                            <code>s3:ListBucket</code> action. The bucket owner has this permission
+ *                         by default and can grant this permission to others. For more information
+ *                         about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing access
+ *                            permissions to your Amazon S3 resources</a> in the
+ *                            <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                   <li>
  *                      <p>
@@ -63,8 +75,12 @@ declare const HeadBucketCommand_base: {
  *                         You must have the <b>
  *                            <code>s3express:CreateSession</code>
  *                         </b> permission in the
- *                            <code>Action</code> element of a policy. By default, the session is in the <code>ReadWrite</code> mode. If you want to restrict the access, you can explicitly set the <code>s3express:SessionMode</code> condition key to <code>ReadOnly</code> on the bucket.</p>
- *                      <p>For more information about example bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html">Example bucket policies for S3 Express One Zone</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html">Amazon Web Services Identity and Access Management (IAM) identity-based policies for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                            <code>Action</code> element of a policy. By default, the session is in
+ *                         the <code>ReadWrite</code> mode. If you want to restrict the access, you can
+ *                         explicitly set the <code>s3express:SessionMode</code> condition key to
+ *                            <code>ReadOnly</code> on the bucket.</p>
+ *                      <p>For more information about example bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-example-bucket-policies.html">Example bucket policies for S3 Express One Zone</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam-identity-policies.html">Amazon Web Services Identity and Access Management (IAM) identity-based policies for
+ *                            S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                </ul>
  *             </dd>

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

@@ -28,17 +28,19 @@ declare const HeadObjectCommand_base: {
 };
 /**
  * <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>
+ *          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>
+ *             Request Headers</a>.</p>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
@@ -47,20 +49,25 @@ declare const HeadObjectCommand_base: {
  *                   <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>
+ *                         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>
@@ -72,9 +79,11 @@ 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>
@@ -82,16 +91,22 @@ declare const HeadObjectCommand_base: {
  *             <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>
+ *                      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>
+ *                   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>
@@ -109,12 +124,13 @@ 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
+ *                      <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
  *          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>
@@ -122,22 +138,28 @@ 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>
  *                   <ul>
  *                      <li>
  *                         <p>
- *                            <b>Directory buckets</b> - Delete marker is not supported by directory buckets.</p>
+ *                            <b>Directory buckets</b> -
+ *                            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>
+ *                            <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>
  *                      </li>
  *                   </ul>
  *                </note>

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

@@ -28,7 +28,7 @@ declare const ListBucketAnalyticsConfigurationsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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>

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

@@ -28,7 +28,7 @@ declare const ListBucketIntelligentTieringConfigurationsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
  *          <p>Lists the S3 Intelligent-Tiering configuration from the specified bucket.</p>
  *          <p>The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead. S3 Intelligent-Tiering delivers automatic cost savings in three low latency and high throughput access tiers. To get the lowest storage cost on data that can be accessed in minutes to hours, you can choose to activate additional archiving capabilities.</p>

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

@@ -28,7 +28,7 @@ declare const ListBucketInventoryConfigurationsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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>

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

@@ -28,7 +28,7 @@ declare const ListBucketMetricsConfigurationsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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.

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

@@ -28,17 +28,17 @@ declare const ListBucketsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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 use
- *          this operation, you must have the <code>s3:ListAllMyBuckets</code> permission. </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 requests. Unpaginated requests are only supported for
+ *             <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 requests to list your account’s buckets.
- *             All unpaginated ListBuckets requests will be rejected for Amazon Web Services accounts with a general purpose bucket quota
+ *             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

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

@@ -27,7 +27,8 @@ 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>
@@ -38,16 +39,21 @@ 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>
+ *             <p> The <code>BucketRegion</code> response element is not part of the
+ *                <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

@@ -27,39 +27,47 @@ declare const ListMultipartUploadsCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <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>
+ *             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>bucket_name</i>.s3express-<i>az_id</i>.<i>region</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>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
  *                </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
  *     <i>Amazon S3 User Guide</i>.</p>
  *          </note>
@@ -69,9 +77,10 @@ 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>
@@ -89,22 +98,30 @@ declare const ListMultipartUploadsCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket</b> - In the <code>ListMultipartUploads</code> response, the multipart uploads are sorted based on two criteria:</p>
+ *                         <b>General purpose bucket</b> - In the
+ *                            <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.
+ *                         <b>Directory bucket</b> - In the
+ *                            <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

@@ -28,7 +28,7 @@ declare const ListObjectVersionsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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

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

@@ -28,7 +28,7 @@ declare const ListObjectsCommand_base: {
 };
 /**
  * <note>
- *             <p>This operation is not supported by directory buckets.</p>
+ *             <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

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

@@ -31,24 +31,27 @@ declare const ListObjectsV2Command_base: {
  *          use the request parameters as selection criteria to return a subset of the objects in a
  *          bucket. 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.
- *
  *          For more information about listing objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html">Listing object keys
- *             programmatically</a> in the <i>Amazon S3 User Guide</i>. To get a list of your buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html">ListBuckets</a>.</p>
+ *             programmatically</a> in the <i>Amazon S3 User Guide</i>. To get a list of
+ *          your buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html">ListBuckets</a>.</p>
  *          <note>
  *             <ul>
  *                <li>
  *                   <p>
- *                      <b>General purpose bucket</b> - For general purpose buckets, <code>ListObjectsV2</code> doesn't return prefixes that are related only to in-progress multipart uploads.</p>
+ *                      <b>General purpose bucket</b> - For general purpose buckets,
+ *                      <code>ListObjectsV2</code> doesn't return prefixes that are related only to
+ *                   in-progress multipart uploads.</p>
  *                </li>
  *                <li>
  *                   <p>
- *                      <b>Directory buckets</b> -
- *                For directory buckets, <code>ListObjectsV2</code> response includes the prefixes that are related only to in-progress multipart uploads.
- *               </p>
+ *                      <b>Directory buckets</b> - For
+ *                   directory buckets, <code>ListObjectsV2</code> response includes the prefixes that
+ *                   are related only to in-progress multipart uploads. </p>
  *                </li>
  *                <li>
  *                   <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>bucket_name</i>.s3express-<i>az_id</i>.<i>region</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>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
  *                      </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
  *     <i>Amazon S3 User Guide</i>.</p>
  *                </li>
@@ -60,11 +63,13 @@ declare const ListObjectsV2Command_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - To use this operation, you must have READ access to the bucket. You must have permission to perform
- *                         the <code>s3:ListBucket</code> action. The bucket owner has this permission by default and
- *                         can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
- *                               Access Permissions to Your Amazon S3 Resources</a> in the
- *                         <i>Amazon S3 User Guide</i>.</p>
+ *                         <b>General purpose bucket permissions</b> - To
+ *                         use this operation, you must have READ access to the bucket. You must have
+ *                         permission to perform the <code>s3:ListBucket</code> action. The bucket
+ *                         owner has this permission by default and can grant this permission to
+ *                         others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
+ *                            Permissions to Your Amazon S3 Resources</a> in the
+ *                            <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                   <li>
  *                      <p>
@@ -82,11 +87,15 @@ declare const ListObjectsV2Command_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket</b> - For general purpose buckets, <code>ListObjectsV2</code> returns objects in lexicographical order based on their key names.</p>
+ *                         <b>General purpose bucket</b> - For
+ *                         general purpose buckets, <code>ListObjectsV2</code> returns objects in
+ *                         lexicographical order based on their key names.</p>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>Directory bucket</b> - For directory buckets, <code>ListObjectsV2</code> does not return objects in lexicographical order.</p>
+ *                         <b>Directory bucket</b> - For
+ *                         directory buckets, <code>ListObjectsV2</code> does not return objects in
+ *                         lexicographical order.</p>
  *                   </li>
  *                </ul>
  *             </dd>