@aws-sdk/client-s3 3.458.0 → 3.461.0

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

@@ -23,24 +23,92 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
 }
 /**
  * @public
- * <p>This action lists in-progress multipart uploads. An in-progress multipart upload is a
- *          multipart upload that has been initiated using the Initiate Multipart Upload request, but
+ * <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 action returns at most 1,000 multipart uploads in the response. 1,000 multipart
- *          uploads is the maximum number of uploads a response can include, which is also the default
+ *          <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.
+ *             </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> parameter in the response. If additional multipart uploads
- *          satisfy the list criteria, the response will contain an <code>IsTruncated</code> element
- *          with the value true. To list the additional multipart uploads, use the
- *             <code>key-marker</code> and <code>upload-id-marker</code> request parameters.</p>
- *          <p>In the response, the uploads are sorted by key. If your application has initiated more
- *          than one multipart upload using the same object key, then uploads in the response are first
- *          sorted by key. Additionally, uploads are sorted in ascending order within each key by the
- *          upload initiation time.</p>
- *          <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
- *             Upload</a>.</p>
- *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
- *             and Permissions</a>.</p>
+ *          <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>
+ *          </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>
+ *          <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>
+ *                </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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <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>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
+ * 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>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>Sorting of multipart uploads in response</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <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>
+ *                         </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>
+ *                         </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.
+ *
+ *                         </p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>
+ *                      <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
  *          <p>The following operations are related to <code>ListMultipartUploads</code>:</p>
  *          <ul>
  *             <li>
@@ -103,7 +171,7 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
  * //       UploadId: "STRING_VALUE",
  * //       Key: "STRING_VALUE",
  * //       Initiated: new Date("TIMESTAMP"),
- * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  * //       Owner: { // Owner
  * //         DisplayName: "STRING_VALUE",
  * //         ID: "STRING_VALUE",

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

@@ -23,7 +23,10 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
 }
 /**
  * @public
- * <p>Returns metadata about all versions of the objects in a bucket. You can also use request
+ * <note>
+ *             <p>This operation is not supported by 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>
  *          <important>

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

@@ -23,7 +23,10 @@ export interface ListObjectsCommandOutput extends ListObjectsOutput, __MetadataB
 }
 /**
  * @public
- * <p>Returns some or all (up to 1,000) of the objects in a bucket. You can use the request
+ * <note>
+ *             <p>This operation is not supported by 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>
@@ -93,7 +96,7 @@ export interface ListObjectsCommandOutput extends ListObjectsOutput, __MetadataB
  * //         "CRC32" || "CRC32C" || "SHA1" || "SHA256",
  * //       ],
  * //       Size: Number("long"),
- * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  * //       Owner: { // Owner
  * //         DisplayName: "STRING_VALUE",
  * //         ID: "STRING_VALUE",

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

@@ -27,21 +27,63 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  *          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.
- *          Objects are returned sorted in an ascending order of the respective key names in the list.
+ *
  *          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>.</p>
- *          <p>To use this operation, you must have READ access to the bucket.</p>
- *          <p>To use this action in an Identity and Access Management (IAM) policy, 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>
+ *             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>
+ *             <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>
+ *                </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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <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>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
+ * 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>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>Sorting order of returned objects</dt>
+ *             <dd>
+ *                <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>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket</b> - For directory buckets, <code>ListObjectsV2</code> does not return objects in lexicographical order.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>
+ *                      <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
  *          <important>
  *             <p>This section describes the latest revision of this action. We recommend that you use
  *             this revised API operation for application development. For backward compatibility, Amazon S3
  *             continues to support the prior version of this API operation, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html">ListObjects</a>.</p>
  *          </important>
- *          <p>To get a list of your buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html">ListBuckets</a>.</p>
  *          <p>The following operations are related to <code>ListObjectsV2</code>:</p>
  *          <ul>
  *             <li>
@@ -94,7 +136,7 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  * //         "CRC32" || "CRC32C" || "SHA1" || "SHA256",
  * //       ],
  * //       Size: Number("long"),
- * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //       StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  * //       Owner: { // Owner
  * //         DisplayName: "STRING_VALUE",
  * //         ID: "STRING_VALUE",

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

@@ -23,22 +23,55 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
 }
 /**
  * @public
- * <p>Lists the parts that have been uploaded for a specific multipart upload. This operation
- *          must include the upload ID, which you obtain by sending the initiate multipart upload
- *          request (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>).
- *          This request returns a maximum of 1,000 uploaded parts. The default number of parts
- *          returned is 1,000 parts. You can restrict the number of parts returned by specifying the
+ * <p>Lists the parts that have been uploaded for a specific multipart upload.</p>
+ *          <p>To use this operation, you must provide the <code>upload ID</code> in the request. You obtain this uploadID by sending the initiate multipart upload
+ *          request through <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>.</p>
+ *          <p>The <code>ListParts</code> request returns a maximum of 1,000 uploaded parts. The limit of 1,000 parts is also the default value. You can restrict the number of parts in a response by specifying the
  *             <code>max-parts</code> request parameter. If your multipart upload consists of more than
- *          1,000 parts, the response returns an <code>IsTruncated</code> field with the value of true,
- *          and a <code>NextPartNumberMarker</code> element. In subsequent <code>ListParts</code>
- *          requests you can include the part-number-marker query string parameter and set its value to
+ *          1,000 parts, the response returns an <code>IsTruncated</code> field with the value of <code>true</code>,
+ *          and a <code>NextPartNumberMarker</code> element. To list remaining uploaded parts, in subsequent <code>ListParts</code>
+ *          requests, include the <code>part-number-marker</code> query string parameter and set its value to
  *          the <code>NextPartNumberMarker</code> field value from the previous response.</p>
- *          <p>If the upload was created using a checksum algorithm, you will need to have permission
- *          to the <code>kms:Decrypt</code> action for the request to succeed. </p>
  *          <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
- *             Upload</a>.</p>
- *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
- *             and Permissions</a>.</p>
+ *          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>
+ *                </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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <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>
+ *                      <p>If the upload was created using server-side encryption with Key Management Service (KMS) keys
+ *                         (SSE-KMS) or dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS), you must have permission
+ *                         to the <code>kms:Decrypt</code> action for the <code>ListParts</code> request to succeed.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
+ * 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>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>
+ *                      <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
  *          <p>The following operations are related to <code>ListParts</code>:</p>
  *          <ul>
  *             <li>
@@ -122,7 +155,7 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
  * //     DisplayName: "STRING_VALUE",
  * //     ID: "STRING_VALUE",
  * //   },
- * //   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  * //   RequestCharged: "requester",
  * //   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
  * // };

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

@@ -23,7 +23,10 @@ export interface PutBucketAccelerateConfigurationCommandOutput extends __Metadat
 }
 /**
  * @public
- * <p>Sets the accelerate configuration of an existing bucket. Amazon S3 Transfer Acceleration is a
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the accelerate configuration of an existing bucket. Amazon S3 Transfer Acceleration is a
  *          bucket-level feature that enables you to perform faster data transfers to Amazon S3.</p>
  *          <p> To use this operation, you must have permission to perform the
  *             <code>s3:PutAccelerateConfiguration</code> action. The bucket owner has this permission

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

@@ -23,9 +23,12 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the permissions on an existing bucket using access control lists (ACL). For more
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the permissions on an existing bucket using access control lists (ACL). For more
  *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. To set the ACL of a
- *          bucket, you must have <code>WRITE_ACP</code> permission.</p>
+ *          bucket, you must have the <code>WRITE_ACP</code> permission.</p>
  *          <p>You can use one of the following two ways to set a bucket's permissions:</p>
  *          <ul>
  *             <li>

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

@@ -23,7 +23,10 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
 }
 /**
  * @public
- * <p>Sets an analytics configuration for the bucket (specified by the analytics configuration
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets an analytics configuration for the bucket (specified by the analytics configuration
  *          ID). You can have up to 1,000 analytics configurations per bucket.</p>
  *          <p>You can choose to have storage class analysis export analysis reports sent to a
  *          comma-separated values (CSV) flat file. See the <code>DataExport</code> request element.

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

@@ -23,7 +23,10 @@ export interface PutBucketCorsCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the <code>cors</code> configuration for your bucket. If the configuration exists,
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the <code>cors</code> configuration for your bucket. If the configuration exists,
  *          Amazon S3 replaces it.</p>
  *          <p>To use this operation, you must be allowed to perform the <code>s3:PutBucketCORS</code>
  *          action. By default, the bucket owner has this permission and can grant it to others.</p>

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

@@ -23,7 +23,10 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>This action uses the <code>encryption</code> subresource to configure default encryption
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>This action uses the <code>encryption</code> subresource to configure default encryption
  *          and Amazon S3 Bucket Keys for an existing bucket.</p>
  *          <p>By default, all buckets have a default encryption configuration that uses server-side
  *          encryption with Amazon S3 managed keys (SSE-S3). You can optionally configure default encryption

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

@@ -23,7 +23,10 @@ export interface PutBucketIntelligentTieringConfigurationCommandOutput extends _
 }
 /**
  * @public
- * <p>Puts a S3 Intelligent-Tiering configuration to the specified bucket. You can have up to
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Puts a S3 Intelligent-Tiering configuration to the specified bucket. You can have up to
  *          1,000 S3 Intelligent-Tiering configurations per 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>
  *          <p>The S3 Intelligent-Tiering storage class is  the ideal storage class for data with unknown, changing, or unpredictable access patterns, independent of object size or retention period. If the size of an object is less than 128 KB, it is not monitored and not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the Frequent Access tier rates in the S3 Intelligent-Tiering storage class.</p>

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

@@ -23,7 +23,10 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
 }
 /**
  * @public
- * <p>This implementation of the <code>PUT</code> action adds an inventory configuration
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>This implementation of the <code>PUT</code> action adds an inventory configuration
  *          (identified by the inventory ID) to the bucket. You can have up to 1,000 inventory
  *          configurations per bucket. </p>
  *          <p>Amazon S3 inventory generates inventories of the objects in the bucket on a daily or weekly

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

@@ -23,7 +23,10 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
 }
 /**
  * @public
- * <p>Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle
  *          configuration. Keep in mind that this will overwrite an existing lifecycle configuration,
  *          so if you want to retain any configuration details, they must be included in the new
  *          lifecycle configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing

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

@@ -23,7 +23,10 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Set the logging parameters for a bucket and to specify permissions for who can view and
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Set the logging parameters for a bucket and to specify permissions for who can view and
  *          modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as
  *          the source bucket. To set the logging status of a bucket, you must be the bucket
  *          owner.</p>

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

@@ -23,7 +23,10 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
 }
 /**
  * @public
- * <p>Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets a metrics configuration (specified by the metrics configuration ID) for the bucket.
  *          You can have up to 1,000 metrics configurations per bucket. If you're updating an existing
  *          metrics configuration, note that this is a full replacement of the existing metrics
  *          configuration. If you don't include the elements you want to keep, they are erased.</p>

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

@@ -23,7 +23,10 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
 }
 /**
  * @public
- * <p>Enables notifications of specified events for a bucket. For more information about event
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Enables notifications of specified events for a bucket. For more information about event
  *          notifications, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Event
  *          Notifications</a>.</p>
  *          <p>Using this API, you can replace an existing notification configuration. The

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

@@ -23,7 +23,10 @@ export interface PutBucketOwnershipControlsCommandOutput extends __MetadataBeare
 }
 /**
  * @public
- * <p>Creates or modifies <code>OwnershipControls</code> for an Amazon S3 bucket. To use this
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Creates or modifies <code>OwnershipControls</code> for an Amazon S3 bucket. To use this
  *          operation, you must have the <code>s3:PutBucketOwnershipControls</code> permission. For
  *          more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html">Specifying permissions in a
  *             policy</a>. </p>

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

@@ -23,25 +23,60 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are using an identity other than
- *          the root user of the Amazon Web Services account that owns the bucket, the calling identity must have the
- *             <code>PutBucketPolicy</code> permissions on the specified bucket and belong to the
- *          bucket owner's account in order to use this operation.</p>
- *          <p>If you don't have <code>PutBucketPolicy</code> permissions, Amazon S3 returns a <code>403
- *             Access Denied</code> error. If you have the correct permissions, but you're not using an
- *          identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
- *             Allowed</code> error.</p>
- *          <important>
- *             <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
- *             buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
- *                <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
- *                <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
- *             denies the root principal's access. Bucket owner root principals can only be blocked
- *             from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
- *             policies.</p>
- *          </important>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy
- *             examples</a>.</p>
+ * <p>Applies an Amazon S3 bucket policy to an Amazon S3 bucket.</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>
+ *                </code>. Virtual-hosted-style requests aren't 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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>If you are using an identity other than the
+ *                   root user of the Amazon Web Services account that owns the bucket, the calling identity must both have the
+ *                   <code>PutBucketPolicy</code> permissions on the specified bucket and belong to the
+ *                   bucket owner's account in order to use this operation.</p>
+ *                <p>If you don't have <code>PutBucketPolicy</code> permissions, Amazon S3 returns a <code>403
+ *                   Access Denied</code> error. If you have the correct permissions, but you're not using an
+ *                   identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
+ *                      Allowed</code> error.</p>
+ *                <important>
+ *                   <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
+ *                      buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
+ *                      <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
+ *                      <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
+ *                      denies the root principal's access. Bucket owner root principals can only be blocked
+ *                      from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
+ *                      policies.</p>
+ *                </important>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <b>General purpose bucket permissions</b> - The <code>s3:PutBucketPolicy</code> permission is required in a policy.
+ *                         For more information about general purpose buckets bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
+ *                            Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation, you must have the <code>s3express:PutBucketPolicy</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>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>Example bucket policies</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>General purpose buckets example bucket policies</b> - See <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy examples</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>
+ *                   <b>Directory bucket example bucket policies</b> - 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> 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>
+ *             </dd>
+ *          </dl>
  *          <p>The following operations are related to <code>PutBucketPolicy</code>:</p>
  *          <ul>
  *             <li>