@aws-sdk/client-s3 3.842.0 → 3.845.0

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

@@ -27,23 +27,22 @@ declare const GetBucketEncryptionCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets
- *          have a default encryption configuration that uses server-side encryption with Amazon S3 managed
- *          keys (SSE-S3). </p>
+ * <p>Returns the default encryption configuration for an Amazon S3 bucket. By default, all buckets have a
+ *       default encryption configuration that uses server-side encryption with Amazon S3 managed keys (SSE-S3). </p>
  *          <note>
  *             <ul>
  *                <li>
  *                   <p>
- *                      <b>General purpose buckets</b> - For information
- *                   about the bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default
- *                      Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                      <b>General purpose buckets</b> - For information about the bucket
+ *             default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default Encryption</a> in the
+ *               <i>Amazon S3 User Guide</i>.</p>
  *                </li>
  *                <li>
  *                   <p>
  *                      <b>Directory buckets</b> -
- *                   For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. For information about the default encryption
- *                   configuration in directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html">Setting
- *                      default server-side encryption behavior for directory buckets</a>.</p>
+ *             For directory buckets, there are only two supported options for server-side encryption: SSE-S3 and SSE-KMS. For information about the default encryption configuration in
+ *             directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-bucket-encryption.html">Setting default server-side
+ *               encryption behavior for directory buckets</a>.</p>
  *                </li>
  *             </ul>
  *          </note>
@@ -54,19 +53,17 @@ declare const GetBucketEncryptionCommand_base: {
  *                   <li>
  *                      <p>
  *                         <b>General purpose bucket permissions</b> - The
- *                            <code>s3:GetEncryptionConfiguration</code> permission is required in a
- *                         policy. 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 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:GetEncryptionConfiguration</code> permission is required in a policy. 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 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>
  *                   </li>
  *                   <li>
  *                      <p>
- *                         <b>Directory bucket permissions</b> -
- *                         To grant access to this API operation, you must have the
- *                            <code>s3express:GetEncryptionConfiguration</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>
+ *                         <b>Directory bucket permissions</b> - To grant access to
+ *                 this API operation, you must have the <code>s3express:GetEncryptionConfiguration</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>

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

@@ -30,16 +30,14 @@ declare const GetBucketInventoryConfigurationCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns an inventory configuration (identified by the inventory configuration ID) from
- *          the bucket.</p>
+ *          <p>Returns an S3 Inventory configuration (identified by the inventory configuration ID) from the
+ *       bucket.</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 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>.</p>
+ *         <code>s3:GetInventoryConfiguration</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>.</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>GetBucketInventoryConfiguration</code>:</p>
+ *          <p>The following operations are related to <code>GetBucketInventoryConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -27,19 +27,17 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns the lifecycle configuration information set on the bucket. For information about
- *          lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
- *          Management</a>.</p>
- *          <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an object
- *          key name prefix, one or more object tags, object size, or any combination of these.
- *          Accordingly, this section describes the latest API, which is compatible with the new
- *          functionality. The previous version of the API supported filtering based only on an object
- *          key name prefix, which is supported for general purpose buckets for backward compatibility.
- *          For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>.</p>
+ * <p>Returns the lifecycle configuration information set on the bucket. For information about lifecycle
+ *       configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle Management</a>.</p>
+ *          <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an object key name
+ *       prefix, one or more object tags, object size, or any combination of these. Accordingly, this section
+ *       describes the latest API, which is compatible with the new functionality. The previous version of the
+ *       API supported filtering based only on an object key name prefix, which is supported for general purpose
+ *       buckets for backward compatibility. For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html">GetBucketLifecycle</a>.</p>
  *          <note>
- *             <p>Lifecyle configurations for directory buckets only support expiring objects and
- *             cancelling multipart uploads. Expiring of versioned objects, transitions and tag filters
- *             are not supported.</p>
+ *             <p>Lifecyle configurations for directory buckets only support expiring objects and cancelling
+ *         multipart uploads. Expiring of versioned objects, transitions and tag filters are not
+ *         supported.</p>
  *          </note>
  *          <dl>
  *             <dt>Permissions</dt>
@@ -47,31 +45,26 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>General purpose bucket permissions</b> - By
- *                         default, all Amazon S3 resources are private, including buckets, objects, and
- *                         related subresources (for example, lifecycle configuration and website
- *                         configuration). Only the resource owner (that is, the Amazon Web Services account that
- *                         created it) can access the resource. The resource owner can optionally grant
- *                         access permissions to others by writing an access policy. For this
- *                         operation, a user must have the <code>s3:GetLifecycleConfiguration</code>
- *                         permission.</p>
- *                      <p>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>.</p>
+ *                         <b>General purpose bucket permissions</b> - By default, all Amazon S3
+ *                 resources are private, including buckets, objects, and related subresources (for example,
+ *                 lifecycle configuration and website configuration). Only the resource owner (that is, the
+ *                 Amazon Web Services account that created it) can access the resource. The resource owner can optionally
+ *                 grant access permissions to others by writing an access policy. For this operation, a user
+ *                 must have the <code>s3:GetLifecycleConfiguration</code> permission.</p>
+ *                      <p>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>.</p>
  *                   </li>
  *                </ul>
  *                <ul>
  *                   <li>
  *                      <p>
- *                         <b>Directory bucket permissions</b> -
- *                         You must have the <code>s3express:GetLifecycleConfiguration</code>
- *                         permission in an IAM identity-based policy to use this operation.
- *                         Cross-account access to this API operation isn't supported. The resource
- *                         owner can optionally grant access permissions to others by creating a role
- *                         or user for them as long as they are within the same account as the owner
- *                         and resource.</p>
- *                      <p>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">Authorizing Regional endpoint APIs with IAM</a> in the
- *                            <i>Amazon S3 User Guide</i>.</p>
+ *                         <b>Directory bucket permissions</b> - You must have the
+ *                   <code>s3express:GetLifecycleConfiguration</code> permission in an IAM identity-based policy
+ *                 to use this operation. Cross-account access to this API operation isn't supported. The
+ *                 resource owner can optionally grant access permissions to others by creating a role or user
+ *                 for them as long as they are within the same account as the owner and resource.</p>
+ *                      <p>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">Authorizing Regional endpoint APIs with IAM</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>
@@ -86,9 +79,8 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
  *             <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>
  *          <p>
@@ -110,8 +102,7 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
  *                </ul>
  *             </li>
  *          </ul>
- *          <p>The following operations are related to
- *          <code>GetBucketLifecycleConfiguration</code>:</p>
+ *          <p>The following operations are related to <code>GetBucketLifecycleConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -31,17 +31,16 @@ declare const GetBucketLocationCommand_base: {
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
  *          <p>Returns the Region the bucket resides in. You set the bucket's Region using the
- *             <code>LocationConstraint</code> request parameter in a <code>CreateBucket</code>
- *          request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>.</p>
+ *         <code>LocationConstraint</code> request parameter in a <code>CreateBucket</code> request. For more
+ *       information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>.</p>
  *          <p>When you use this API operation with an access point, provide the alias of the access point in place of the bucket name.</p>
  *          <p>When you use this API operation with an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
  * If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
  * For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
  *             Error Codes</a>.</p>
  *          <note>
- *             <p>We recommend that you use <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html">HeadBucket</a> to return the Region
- *             that a bucket resides in. For backward compatibility, Amazon S3 continues to support
- *             GetBucketLocation.</p>
+ *             <p>We recommend that you use <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html">HeadBucket</a> to return the Region that a bucket
+ *         resides in. For backward compatibility, Amazon S3 continues to support GetBucketLocation.</p>
  *          </note>
  *          <p>The following operations are related to <code>GetBucketLocation</code>:</p>
  *          <ul>

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

@@ -37,8 +37,8 @@ declare const GetBucketLoggingCommand_base: {
  *          <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Returns the logging status of a bucket and the permissions users have to view and modify
- *          that status.</p>
+ *          <p>Returns the logging status of a bucket and the permissions users have to view and modify that
+ *       status.</p>
  *          <p>The following operations are related to <code>GetBucketLogging</code>:</p>
  *          <ul>
  *             <li>

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

@@ -0,0 +1,146 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { GetBucketMetadataConfigurationOutput, GetBucketMetadataConfigurationRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link GetBucketMetadataConfigurationCommand}.
+ */
+export interface GetBucketMetadataConfigurationCommandInput extends GetBucketMetadataConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link GetBucketMetadataConfigurationCommand}.
+ */
+export interface GetBucketMetadataConfigurationCommandOutput extends GetBucketMetadataConfigurationOutput, __MetadataBearer {
+}
+declare const GetBucketMetadataConfigurationCommand_base: {
+    new (input: GetBucketMetadataConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<GetBucketMetadataConfigurationCommandInput, GetBucketMetadataConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: GetBucketMetadataConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<GetBucketMetadataConfigurationCommandInput, GetBucketMetadataConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Retrieves the S3 Metadata configuration for a general purpose bucket. For more information, see
+ *       <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html">Accelerating
+ *         data discovery with S3 Metadata</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *          <note>
+ *             <p>You can use the V2 <code>GetBucketMetadataConfiguration</code> API operation with V1 or V2
+ *             metadata configurations. However, if you try to use the V1
+ *             <code>GetBucketMetadataTableConfiguration</code> API operation with V2 configurations, you
+ *             will receive an HTTP <code>405 Method Not Allowed</code> error.</p>
+ *          </note>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>To use this operation, you must have the <code>s3:GetBucketMetadataTableConfiguration</code>
+ *             permission. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html">Setting up permissions for
+ *               configuring metadata tables</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *                <note>
+ *                   <p>The IAM policy action name is the same for the V1 and V2 API operations.</p>
+ *                </note>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>GetBucketMetadataConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html">CreateBucketMetadataConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetadataConfiguration.html">DeleteBucketMetadataConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataInventoryTableConfiguration.html">UpdateBucketMetadataInventoryTableConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UpdateBucketMetadataJournalTableConfiguration.html">UpdateBucketMetadataJournalTableConfiguration</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, GetBucketMetadataConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, GetBucketMetadataConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // GetBucketMetadataConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new GetBucketMetadataConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // { // GetBucketMetadataConfigurationOutput
+ * //   GetBucketMetadataConfigurationResult: { // GetBucketMetadataConfigurationResult
+ * //     MetadataConfigurationResult: { // MetadataConfigurationResult
+ * //       DestinationResult: { // DestinationResult
+ * //         TableBucketType: "aws" || "customer",
+ * //         TableBucketArn: "STRING_VALUE",
+ * //         TableNamespace: "STRING_VALUE",
+ * //       },
+ * //       JournalTableConfigurationResult: { // JournalTableConfigurationResult
+ * //         TableStatus: "STRING_VALUE", // required
+ * //         Error: { // ErrorDetails
+ * //           ErrorCode: "STRING_VALUE",
+ * //           ErrorMessage: "STRING_VALUE",
+ * //         },
+ * //         TableName: "STRING_VALUE", // required
+ * //         TableArn: "STRING_VALUE",
+ * //         RecordExpiration: { // RecordExpiration
+ * //           Expiration: "ENABLED" || "DISABLED", // required
+ * //           Days: Number("int"),
+ * //         },
+ * //       },
+ * //       InventoryTableConfigurationResult: { // InventoryTableConfigurationResult
+ * //         ConfigurationState: "ENABLED" || "DISABLED", // required
+ * //         TableStatus: "STRING_VALUE",
+ * //         Error: {
+ * //           ErrorCode: "STRING_VALUE",
+ * //           ErrorMessage: "STRING_VALUE",
+ * //         },
+ * //         TableName: "STRING_VALUE",
+ * //         TableArn: "STRING_VALUE",
+ * //       },
+ * //     },
+ * //   },
+ * // };
+ *
+ * ```
+ *
+ * @param GetBucketMetadataConfigurationCommandInput - {@link GetBucketMetadataConfigurationCommandInput}
+ * @returns {@link GetBucketMetadataConfigurationCommandOutput}
+ * @see {@link GetBucketMetadataConfigurationCommandInput} for command's `input` shape.
+ * @see {@link GetBucketMetadataConfigurationCommandOutput} for command's `response` shape.
+ * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
+ *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
+ *
+ *
+ * @public
+ */
+export declare class GetBucketMetadataConfigurationCommand extends GetBucketMetadataConfigurationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: GetBucketMetadataConfigurationRequest;
+            output: GetBucketMetadataConfigurationOutput;
+        };
+        sdk: {
+            input: GetBucketMetadataConfigurationCommandInput;
+            output: GetBucketMetadataConfigurationCommandOutput;
+        };
+    };
+}

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

@@ -27,17 +27,34 @@ declare const GetBucketMetadataTableConfigurationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>
- *          Retrieves the metadata table configuration for a general purpose bucket. For more
- *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html">Accelerating data
- *             discovery with S3 Metadata</a> in the <i>Amazon S3 User Guide</i>. </p>
+ * <important>
+ *             <p>
+ *         We recommend that you retrieve your S3 Metadata configurations by using the V2
+ *         <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataTableConfiguration.html">GetBucketMetadataTableConfiguration</a> API operation. We no longer recommend using the V1
+ *         <code>GetBucketMetadataTableConfiguration</code> API operation.
+ *       </p>
+ *             <p>If you created your S3 Metadata configuration before July 15, 2025, we recommend that you delete
+ *         and re-create your configuration by using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html">CreateBucketMetadataConfiguration</a> so that you can expire journal table records and create
+ *         a live inventory table.</p>
+ *          </important>
+ *          <p> Retrieves the V1 S3 Metadata configuration for a general purpose bucket. For more information, see
+ *         <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-overview.html">Accelerating
+ *         data discovery with S3 Metadata</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *          <note>
+ *             <p>You can use the V2 <code>GetBucketMetadataConfiguration</code> API operation with V1 or V2
+ *             metadata table configurations. However, if you try to use the V1
+ *             <code>GetBucketMetadataTableConfiguration</code> API operation with V2 configurations, you
+ *             will receive an HTTP <code>405 Method Not Allowed</code> error.</p>
+ *             <p>Make sure that you update your processes to use the new V2 API operations
+ *             (<code>CreateBucketMetadataConfiguration</code>, <code>GetBucketMetadataConfiguration</code>, and
+ *             <code>DeleteBucketMetadataConfiguration</code>) instead of the V1 API operations. </p>
+ *          </note>
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>To use this operation, you must have the <code>s3:GetBucketMetadataTableConfiguration</code> permission. For more
- *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html">Setting up
- *                      permissions for configuring metadata tables</a> in the
- *                   <i>Amazon S3 User Guide</i>. </p>
+ *                <p>To use this operation, you must have the <code>s3:GetBucketMetadataTableConfiguration</code>
+ *             permission. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/metadata-tables-permissions.html">Setting up permissions for
+ *               configuring metadata tables</a> in the <i>Amazon S3 User Guide</i>. </p>
  *             </dd>
  *          </dl>
  *          <p>The following operations are related to <code>GetBucketMetadataTableConfiguration</code>:</p>

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

@@ -30,17 +30,15 @@ declare const GetBucketMetricsConfigurationCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Gets a metrics configuration (specified by the metrics configuration ID) from the
- *          bucket. Note that this doesn't include the daily storage metrics.</p>
+ *          <p>Gets a metrics configuration (specified by the metrics configuration ID) from the bucket. Note that
+ *       this doesn't include the daily storage metrics.</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 information about CloudWatch request metrics for Amazon S3, 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>GetBucketMetricsConfiguration</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 information about CloudWatch request metrics for Amazon S3, 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>GetBucketMetricsConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -59,7 +57,8 @@ declare const GetBucketMetricsConfigurationCommand_base: {
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring
+ *             Metrics with Amazon CloudWatch</a>
  *                </p>
  *             </li>
  *          </ul>

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

@@ -32,19 +32,18 @@ declare const GetBucketNotificationConfigurationCommand_base: {
  *          </note>
  *          <p>Returns the notification configuration of a bucket.</p>
  *          <p>If notifications are not enabled on the bucket, the action returns an empty
- *             <code>NotificationConfiguration</code> element.</p>
- *          <p>By default, you must be the bucket owner to read the notification configuration of a
- *          bucket. However, the bucket owner can use a bucket policy to grant permission to other
- *          users to read this configuration with the <code>s3:GetBucketNotification</code>
- *          permission.</p>
+ *         <code>NotificationConfiguration</code> element.</p>
+ *          <p>By default, you must be the bucket owner to read the notification configuration of a bucket.
+ *       However, the bucket owner can use a bucket policy to grant permission to other users to read this
+ *       configuration with the <code>s3:GetBucketNotification</code> permission.</p>
  *          <p>When you use this API operation with an access point, provide the alias of the access point in place of the bucket name.</p>
  *          <p>When you use this API operation with an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
  * If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
  * For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
  *             Error Codes</a>.</p>
- *          <p>For more information about setting and reading the notification configuration on a
- *          bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of Bucket Events</a>. For more information about bucket
- *          policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
+ *          <p>For more information about setting and reading the notification configuration on a bucket, see
+ *         <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification
+ *         of Bucket Events</a>. For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
  *          <p>The following action is related to <code>GetBucketNotification</code>:</p>
  *          <ul>
  *             <li>

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

@@ -30,24 +30,25 @@ declare const GetBucketOwnershipControlsCommand_base: {
  * <note>
  *             <p>This operation is not supported for directory buckets.</p>
  *          </note>
- *          <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
- *          must have the <code>s3:GetBucketOwnershipControls</code> permission. For more information
- *          about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying permissions in a
- *             policy</a>. </p>
+ *          <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you must have
+ *       the <code>s3:GetBucketOwnershipControls</code> permission. For more information about Amazon S3 permissions,
+ *       see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying
+ *         permissions in a policy</a>. </p>
  *          <note>
  *             <p>A bucket doesn't have <code>OwnershipControls</code> settings in the following cases:</p>
  *             <ul>
  *                <li>
- *                   <p>The bucket was created before the <code>BucketOwnerEnforced</code> ownership setting was introduced and you've never explicitly applied this value</p>
+ *                   <p>The bucket was created before the <code>BucketOwnerEnforced</code> ownership setting was
+ *             introduced and you've never explicitly applied this value</p>
  *                </li>
  *                <li>
- *                   <p>You've manually deleted the bucket ownership control value using the <code>DeleteBucketOwnershipControls</code> API operation.</p>
+ *                   <p>You've manually deleted the bucket ownership control value using the
+ *               <code>DeleteBucketOwnershipControls</code> API operation.</p>
  *                </li>
  *             </ul>
  *             <p>By default, Amazon S3 sets <code>OwnershipControls</code> for all newly created buckets.</p>
  *          </note>
- *          <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object
- *             Ownership</a>. </p>
+ *          <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object Ownership</a>. </p>
  *          <p>The following operations are related to <code>GetBucketOwnershipControls</code>:</p>
  *          <ul>
  *             <li>