@nocobase/plugin-file-manager 1.6.0-beta.8 → 1.6.0

package/dist/node_modules/@aws-sdk/client-s3/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts

@@ -1,41 +1,57 @@
-import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
-import { Command as $Command } from "@aws-sdk/smithy-client";
-import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
 import { PutBucketAnalyticsConfigurationRequest } from "../models/models_0";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketAnalyticsConfigurationCommand}.
+ */
 export interface PutBucketAnalyticsConfigurationCommandInput extends PutBucketAnalyticsConfigurationRequest {
 }
+/**
+ * @public
+ *
+ * The output of {@link PutBucketAnalyticsConfigurationCommand}.
+ */
 export interface PutBucketAnalyticsConfigurationCommandOutput extends __MetadataBearer {
 }
+declare const PutBucketAnalyticsConfigurationCommand_base: {
+    new (input: PutBucketAnalyticsConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: PutBucketAnalyticsConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
 /**
- * <p>Sets an analytics configuration for the bucket (specified by the analytics configuration
+ * <note>
+ *             <p>This operation is not supported for 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.
  *          Reports are updated daily and are based on the object filters that you configure. When
  *          selecting data export, you specify a destination bucket and an optional destination prefix
  *          where the file is written. You can export the data to a destination bucket in a different
  *          account. However, the destination bucket must be in the same Region as the bucket that you
- *          are making the PUT analytics configuration to. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
- *             Analysis</a>. </p>
- *
+ *          are making the PUT analytics configuration to. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3
+ *             Analytics – Storage Class Analysis</a>. </p>
  *          <important>
  *             <p>You must create a bucket policy on the destination bucket where the exported file is
  *             written to grant permissions to Amazon S3 to write objects to the bucket. For an example
  *             policy, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9">Granting Permissions for Amazon S3 Inventory and Storage Class Analysis</a>.</p>
  *          </important>
- *
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutAnalyticsConfiguration</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 class="title">
- *             <b>Special Errors</b>
- *          </p>
+ *          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>
+ *             <code>PutBucketAnalyticsConfiguration</code> has the following special errors:</p>
  *          <ul>
  *             <li>
  *                <ul>
@@ -98,15 +114,8 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
  *                </ul>
  *             </li>
  *          </ul>
- *
- *
- *
- *
- *
- *
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <p>The following operations are related to
+ *          <code>PutBucketAnalyticsConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -130,23 +139,70 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
  * import { S3Client, PutBucketAnalyticsConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
  * // const { S3Client, PutBucketAnalyticsConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
  * const client = new S3Client(config);
+ * const input = { // PutBucketAnalyticsConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   Id: "STRING_VALUE", // required
+ *   AnalyticsConfiguration: { // AnalyticsConfiguration
+ *     Id: "STRING_VALUE", // required
+ *     Filter: { // AnalyticsFilter Union: only one key present
+ *       Prefix: "STRING_VALUE",
+ *       Tag: { // Tag
+ *         Key: "STRING_VALUE", // required
+ *         Value: "STRING_VALUE", // required
+ *       },
+ *       And: { // AnalyticsAndOperator
+ *         Prefix: "STRING_VALUE",
+ *         Tags: [ // TagSet
+ *           {
+ *             Key: "STRING_VALUE", // required
+ *             Value: "STRING_VALUE", // required
+ *           },
+ *         ],
+ *       },
+ *     },
+ *     StorageClassAnalysis: { // StorageClassAnalysis
+ *       DataExport: { // StorageClassAnalysisDataExport
+ *         OutputSchemaVersion: "V_1", // required
+ *         Destination: { // AnalyticsExportDestination
+ *           S3BucketDestination: { // AnalyticsS3BucketDestination
+ *             Format: "CSV", // required
+ *             BucketAccountId: "STRING_VALUE",
+ *             Bucket: "STRING_VALUE", // required
+ *             Prefix: "STRING_VALUE",
+ *           },
+ *         },
+ *       },
+ *     },
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
  * const command = new PutBucketAnalyticsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
+ * @param PutBucketAnalyticsConfigurationCommandInput - {@link PutBucketAnalyticsConfigurationCommandInput}
+ * @returns {@link PutBucketAnalyticsConfigurationCommandOutput}
  * @see {@link PutBucketAnalyticsConfigurationCommandInput} for command's `input` shape.
  * @see {@link PutBucketAnalyticsConfigurationCommandOutput} 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 PutBucketAnalyticsConfigurationCommand extends $Command<PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig> {
-    readonly input: PutBucketAnalyticsConfigurationCommandInput;
-    static getEndpointParameterInstructions(): EndpointParameterInstructions;
-    constructor(input: PutBucketAnalyticsConfigurationCommandInput);
-    /**
-     * @internal
-     */
-    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput>;
-    private serialize;
-    private deserialize;
+export declare class PutBucketAnalyticsConfigurationCommand extends PutBucketAnalyticsConfigurationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketAnalyticsConfigurationRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketAnalyticsConfigurationCommandInput;
+            output: PutBucketAnalyticsConfigurationCommandOutput;
+        };
+    };
 }

package/dist/node_modules/@aws-sdk/client-s3/dist-types/commands/PutBucketCorsCommand.d.ts

@@ -1,14 +1,36 @@
-import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
-import { Command as $Command } from "@aws-sdk/smithy-client";
-import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { PutBucketCorsRequest } from "../models/models_0";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { PutBucketCorsRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketCorsCommand}.
+ */
 export interface PutBucketCorsCommandInput extends PutBucketCorsRequest {
 }
+/**
+ * @public
+ *
+ * The output of {@link PutBucketCorsCommand}.
+ */
 export interface PutBucketCorsCommandOutput extends __MetadataBearer {
 }
+declare const PutBucketCorsCommand_base: {
+    new (input: PutBucketCorsCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketCorsCommandInput, PutBucketCorsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: PutBucketCorsCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketCorsCommandInput, PutBucketCorsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
 /**
- * <p>Sets the <code>cors</code> configuration for your bucket. If the configuration exists,
+ * <note>
+ *             <p>This operation is not supported for 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>
@@ -42,12 +64,9 @@ export interface PutBucketCorsCommandOutput extends __MetadataBearer {
  *             </p>
  *             </li>
  *          </ul>
- *          <p> For more information about CORS, go to <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling
- *             Cross-Origin Resource Sharing</a> in the <i>Amazon S3 User Guide</i>.</p>
- *
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <p> For more information about CORS, go to <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling Cross-Origin Resource Sharing</a> in
+ *          the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>The following operations are related to <code>PutBucketCors</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -71,23 +90,104 @@ export interface PutBucketCorsCommandOutput extends __MetadataBearer {
  * import { S3Client, PutBucketCorsCommand } from "@aws-sdk/client-s3"; // ES Modules import
  * // const { S3Client, PutBucketCorsCommand } = require("@aws-sdk/client-s3"); // CommonJS import
  * const client = new S3Client(config);
+ * const input = { // PutBucketCorsRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   CORSConfiguration: { // CORSConfiguration
+ *     CORSRules: [ // CORSRules // required
+ *       { // CORSRule
+ *         ID: "STRING_VALUE",
+ *         AllowedHeaders: [ // AllowedHeaders
+ *           "STRING_VALUE",
+ *         ],
+ *         AllowedMethods: [ // AllowedMethods // required
+ *           "STRING_VALUE",
+ *         ],
+ *         AllowedOrigins: [ // AllowedOrigins // required
+ *           "STRING_VALUE",
+ *         ],
+ *         ExposeHeaders: [ // ExposeHeaders
+ *           "STRING_VALUE",
+ *         ],
+ *         MaxAgeSeconds: Number("int"),
+ *       },
+ *     ],
+ *   },
+ *   ContentMD5: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
  * const command = new PutBucketCorsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
+ * @param PutBucketCorsCommandInput - {@link PutBucketCorsCommandInput}
+ * @returns {@link PutBucketCorsCommandOutput}
  * @see {@link PutBucketCorsCommandInput} for command's `input` shape.
  * @see {@link PutBucketCorsCommandOutput} 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
+ * @example To set cors configuration on a bucket.
+ * ```javascript
+ * // The following example enables PUT, POST, and DELETE requests from www.example.com, and enables GET requests from any domain.
+ * const input = {
+ *   "Bucket": "",
+ *   "CORSConfiguration": {
+ *     "CORSRules": [
+ *       {
+ *         "AllowedHeaders": [
+ *           "*"
+ *         ],
+ *         "AllowedMethods": [
+ *           "PUT",
+ *           "POST",
+ *           "DELETE"
+ *         ],
+ *         "AllowedOrigins": [
+ *           "http://www.example.com"
+ *         ],
+ *         "ExposeHeaders": [
+ *           "x-amz-server-side-encryption"
+ *         ],
+ *         "MaxAgeSeconds": 3000
+ *       },
+ *       {
+ *         "AllowedHeaders": [
+ *           "Authorization"
+ *         ],
+ *         "AllowedMethods": [
+ *           "GET"
+ *         ],
+ *         "AllowedOrigins": [
+ *           "*"
+ *         ],
+ *         "MaxAgeSeconds": 3000
+ *       }
+ *     ]
+ *   },
+ *   "ContentMD5": ""
+ * };
+ * const command = new PutBucketCorsCommand(input);
+ * await client.send(command);
+ * // example id: to-set-cors-configuration-on-a-bucket-1483037818805
+ * ```
+ *
  */
-export declare class PutBucketCorsCommand extends $Command<PutBucketCorsCommandInput, PutBucketCorsCommandOutput, S3ClientResolvedConfig> {
-    readonly input: PutBucketCorsCommandInput;
-    static getEndpointParameterInstructions(): EndpointParameterInstructions;
-    constructor(input: PutBucketCorsCommandInput);
-    /**
-     * @internal
-     */
-    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketCorsCommandInput, PutBucketCorsCommandOutput>;
-    private serialize;
-    private deserialize;
+export declare class PutBucketCorsCommand extends PutBucketCorsCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketCorsRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketCorsCommandInput;
+            output: PutBucketCorsCommandOutput;
+        };
+    };
 }

package/dist/node_modules/@aws-sdk/client-s3/dist-types/commands/PutBucketEncryptionCommand.d.ts

@@ -1,36 +1,147 @@
-import { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
-import { Command as $Command } from "@aws-sdk/smithy-client";
-import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { PutBucketEncryptionRequest } from "../models/models_0";
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { PutBucketEncryptionRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketEncryptionCommand}.
+ */
 export interface PutBucketEncryptionCommandInput extends PutBucketEncryptionRequest {
 }
+/**
+ * @public
+ *
+ * The output of {@link PutBucketEncryptionCommand}.
+ */
 export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
 }
+declare const PutBucketEncryptionCommand_base: {
+    new (input: PutBucketEncryptionCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: PutBucketEncryptionCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
 /**
- * <p>This action uses the <code>encryption</code> subresource to configure default
- *          encryption and Amazon S3 Bucket Key for an existing bucket.</p>
- *          <p>Default encryption for a bucket can use server-side encryption with Amazon S3-managed keys
- *          (SSE-S3) or customer managed keys (SSE-KMS). If you specify default encryption
- *          using SSE-KMS, you can also configure Amazon S3 Bucket Key. When the default encryption is SSE-KMS, if
- *          you upload an object to the bucket and do not specify the KMS key to use for encryption, Amazon S3
- *          uses the default Amazon Web Services managed KMS key for your account. For information about default
- *          encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 default bucket encryption</a>
- *          in the <i>Amazon S3 User Guide</i>. For more information about S3 Bucket Keys,
- *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
+ * <p>This operation configures default encryption and Amazon S3 Bucket Keys for an existing
+ *          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 about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
+ *     <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
+ *     <i>Amazon S3 User Guide</i>.</p>
+ *          </note>
+ *          <p>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>
+ *                   </p>
+ *                   <ul>
+ *                      <li>
+ *                         <p>You can optionally configure default encryption for a bucket by 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). If you specify
+ *                         default encryption by using SSE-KMS, you can also configure <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3
+ *                            Bucket Keys</a>. 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>If you use PutBucketEncryption to set your <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">default bucket
+ *                            encryption</a> to SSE-KMS, you should verify that your KMS key ID
+ *                         is correct. Amazon S3 doesn't validate the KMS key ID provided in
+ *                         PutBucketEncryption requests.</p>
+ *                      </li>
+ *                   </ul>
+ *                </li>
+ *                <li>
+ *                   <p>
+ *                      <b>Directory buckets </b> - You can
+ *                   optionally configure default encryption for a bucket by using server-side
+ *                   encryption with Key Management Service (KMS) keys (SSE-KMS).</p>
+ *                   <ul>
+ *                      <li>
+ *                         <p>We recommend that the bucket's default encryption uses the desired
+ *                         encryption configuration and you don't override the bucket default
+ *                         encryption in your <code>CreateSession</code> requests or <code>PUT</code>
+ *                         object requests. Then, new objects are automatically encrypted with the
+ *                         desired encryption settings.
+ *                         For more information about the encryption overriding behaviors in directory buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-specifying-kms-encryption.html">Specifying server-side encryption with KMS for new object uploads</a>.</p>
+ *                      </li>
+ *                      <li>
+ *                         <p>Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket's lifetime.
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
+ * </p>
+ *                      </li>
+ *                      <li>
+ *                         <p>S3 Bucket Keys are always enabled for <code>GET</code> and <code>PUT</code> operations in a directory bucket and can’t be disabled. S3 Bucket Keys aren't supported, when you copy SSE-KMS encrypted objects from general purpose buckets
+ * to directory buckets, from directory buckets to general purpose buckets, or between directory buckets, through <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html">CopyObject</a>, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a>, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-objects-Batch-Ops">the Copy operation in Batch Operations</a>, or
+ *                             <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job">the import jobs</a>. In this case, Amazon S3 makes a call to KMS every time a copy request is made for a KMS-encrypted object.</p>
+ *                      </li>
+ *                      <li>
+ *                         <p>When you specify an <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">KMS customer managed key</a> for encryption in your directory bucket, only use the key ID or key ARN. The key alias format of the KMS key isn't supported.</p>
+ *                      </li>
+ *                      <li>
+ *                         <p>For directory buckets, if you use PutBucketEncryption to set your <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">default bucket encryption</a> to SSE-KMS, Amazon S3 validates the
+ *                         KMS key ID provided in PutBucketEncryption requests.</p>
+ *                      </li>
+ *                   </ul>
+ *                </li>
+ *             </ul>
+ *          </note>
  *          <important>
- *             <p>This action requires Amazon Web Services Signature Version 4. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html"> Authenticating Requests (Amazon Web Services Signature
- *                Version 4)</a>. </p>
+ *             <p>If you're specifying a customer managed KMS key, we recommend using a fully
+ *             qualified KMS key ARN. If you use a KMS key alias instead, then KMS resolves the
+ *             key within the requester’s account. This behavior can result in data that's encrypted
+ *             with a KMS key that belongs to the requester, and not the bucket owner.</p>
+ *             <p>Also, this action requires Amazon Web Services Signature Version 4. For more information, see
+ *                <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html"> Authenticating
+ *                Requests (Amazon Web Services Signature Version 4)</a>. </p>
  *          </important>
- *          <p>To use this operation, you must have permissions to perform the
- *             <code>s3:PutEncryptionConfiguration</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> in the Amazon S3 User Guide. </p>
- *
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <b>General purpose bucket permissions</b> - The
+ *                            <code>s3:PutEncryptionConfiguration</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> 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:PutEncryptionConfiguration</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>To set a directory bucket default encryption with SSE-KMS, you must also
+ *                         have the <code>kms:GenerateDataKey</code> and the <code>kms:Decrypt</code>
+ *                         permissions in IAM identity-based policies and KMS key policies for the
+ *                         target KMS key.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketEncryption</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -49,23 +160,50 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
  * import { S3Client, PutBucketEncryptionCommand } from "@aws-sdk/client-s3"; // ES Modules import
  * // const { S3Client, PutBucketEncryptionCommand } = require("@aws-sdk/client-s3"); // CommonJS import
  * const client = new S3Client(config);
+ * const input = { // PutBucketEncryptionRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   ContentMD5: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME",
+ *   ServerSideEncryptionConfiguration: { // ServerSideEncryptionConfiguration
+ *     Rules: [ // ServerSideEncryptionRules // required
+ *       { // ServerSideEncryptionRule
+ *         ApplyServerSideEncryptionByDefault: { // ServerSideEncryptionByDefault
+ *           SSEAlgorithm: "AES256" || "aws:kms" || "aws:kms:dsse", // required
+ *           KMSMasterKeyID: "STRING_VALUE",
+ *         },
+ *         BucketKeyEnabled: true || false,
+ *       },
+ *     ],
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
  * const command = new PutBucketEncryptionCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
+ * @param PutBucketEncryptionCommandInput - {@link PutBucketEncryptionCommandInput}
+ * @returns {@link PutBucketEncryptionCommandOutput}
  * @see {@link PutBucketEncryptionCommandInput} for command's `input` shape.
  * @see {@link PutBucketEncryptionCommandOutput} 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 PutBucketEncryptionCommand extends $Command<PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, S3ClientResolvedConfig> {
-    readonly input: PutBucketEncryptionCommandInput;
-    static getEndpointParameterInstructions(): EndpointParameterInstructions;
-    constructor(input: PutBucketEncryptionCommandInput);
-    /**
-     * @internal
-     */
-    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput>;
-    private serialize;
-    private deserialize;
+export declare class PutBucketEncryptionCommand extends PutBucketEncryptionCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketEncryptionRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketEncryptionCommandInput;
+            output: PutBucketEncryptionCommandOutput;
+        };
+    };
 }