@tachybase/module-file 0.23.8

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

@@ -0,0 +1,208 @@
+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;
+};
+/**
+ * <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>
+ *          <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>
+ *             <code>PutBucketAnalyticsConfiguration</code> has the following special errors:</p>
+ *          <ul>
+ *             <li>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <i>HTTP Error: HTTP 400 Bad Request</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Code: InvalidArgument</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Cause: Invalid argument.</i>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *             <li>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <i>HTTP Error: HTTP 400 Bad Request</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Code: TooManyConfigurations</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Cause: You are attempting to create a new configuration but have
+ *                         already reached the 1,000-configuration limit.</i>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *             <li>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <i>HTTP Error: HTTP 403 Forbidden</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Code: AccessDenied</i>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <i>Cause: You are not the owner of the specified bucket, or you do
+ *                         not have the s3:PutAnalyticsConfiguration bucket permission to set the
+ *                         configuration on the bucket.</i>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *          </ul>
+ *          <p>The following operations are related to
+ *          <code>PutBucketAnalyticsConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html">GetBucketAnalyticsConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html">DeleteBucketAnalyticsConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html">ListBucketAnalyticsConfigurations</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * 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 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

@@ -0,0 +1,193 @@
+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;
+};
+/**
+ * <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>
+ *          <p>You set this configuration on a bucket so that the bucket can service cross-origin
+ *          requests. For example, you might want to enable a request whose origin is
+ *             <code>http://www.example.com</code> to access your Amazon S3 bucket at
+ *             <code>my.example.bucket.com</code> by using the browser's <code>XMLHttpRequest</code>
+ *          capability.</p>
+ *          <p>To enable cross-origin resource sharing (CORS) on a bucket, you add the
+ *             <code>cors</code> subresource to the bucket. The <code>cors</code> subresource is an XML
+ *          document in which you configure rules that identify origins and the HTTP methods that can
+ *          be executed on your bucket. The document is limited to 64 KB in size. </p>
+ *          <p>When Amazon S3 receives a cross-origin request (or a pre-flight OPTIONS request) against a
+ *          bucket, it evaluates the <code>cors</code> configuration on the bucket and uses the first
+ *             <code>CORSRule</code> rule that matches the incoming browser request to enable a
+ *          cross-origin request. For a rule to match, the following conditions must be met:</p>
+ *          <ul>
+ *             <li>
+ *                <p>The request's <code>Origin</code> header must match <code>AllowedOrigin</code>
+ *                elements.</p>
+ *             </li>
+ *             <li>
+ *                <p>The request method (for example, GET, PUT, HEAD, and so on) or the
+ *                   <code>Access-Control-Request-Method</code> header in case of a pre-flight
+ *                   <code>OPTIONS</code> request must be one of the <code>AllowedMethod</code>
+ *                elements. </p>
+ *             </li>
+ *             <li>
+ *                <p>Every header specified in the <code>Access-Control-Request-Headers</code> request
+ *                header of a pre-flight request must match an <code>AllowedHeader</code> element.
+ *             </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>The following operations are related to <code>PutBucketCors</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html">GetBucketCors</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html">DeleteBucketCors</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html">RESTOPTIONSobject</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * 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",
+ *   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 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

@@ -0,0 +1,209 @@
+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 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/s3-express-Regions-and-Zones.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">Available Local Zone for directory buckets</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 for the lifetime of the bucket.
+ * 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>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>
+ *          <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>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html">GetBucketEncryption</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html">DeleteBucketEncryption</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * 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",
+ *   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 PutBucketEncryptionCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketEncryptionRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketEncryptionCommandInput;
+            output: PutBucketEncryptionCommandOutput;
+        };
+    };
+}