@nocobase/plugin-file-manager 0.11.1-alpha.5 → 0.12.0-alpha.2

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

@@ -0,0 +1,184 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
+import { PutBucketInventoryConfigurationRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketInventoryConfigurationCommand}.
+ */
+export interface PutBucketInventoryConfigurationCommandInput extends PutBucketInventoryConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketInventoryConfigurationCommand}.
+ */
+export interface PutBucketInventoryConfigurationCommandOutput extends __MetadataBearer {
+}
+/**
+ * @public
+ * <p>This implementation of the <code>PUT</code> action adds an inventory configuration
+ *          (identified by the inventory ID) to the bucket. You can have up to 1,000 inventory
+ *          configurations per bucket. </p>
+ *          <p>Amazon S3 inventory generates inventories of the objects in the bucket on a daily or weekly
+ *          basis, and the results are published to a flat file. The bucket that is inventoried is
+ *          called the <i>source</i> bucket, and the bucket where the inventory flat file
+ *          is stored is called the <i>destination</i> bucket. The
+ *             <i>destination</i> bucket must be in the same Amazon Web Services Region as the
+ *             <i>source</i> bucket. </p>
+ *          <p>When you configure an inventory for a <i>source</i> bucket, you specify
+ *          the <i>destination</i> bucket where you want the inventory to be stored, and
+ *          whether to generate the inventory daily or weekly. You can also configure what object
+ *          metadata to include and whether to inventory all object versions or only current versions.
+ *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a> in the
+ *          Amazon S3 User Guide.</p>
+ *          <important>
+ *             <p>You must create a bucket policy on the <i>destination</i> bucket to
+ *             grant permissions to Amazon S3 to write objects to the bucket in the defined location. 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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>To use this operation, you must have permission to perform the
+ *                   <code>s3:PutInventoryConfiguration</code> action. The bucket owner has this permission
+ *                   by default and can grant this permission to others. </p>
+ *                <p>The <code>s3:PutInventoryConfiguration</code> permission allows a user to create an
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html">S3
+ *                      Inventory</a> report that includes all object metadata fields available and to
+ *                   specify the destination bucket to store the inventory. A user with read access to objects
+ *                   in the destination bucket can also access all object metadata fields that are available in
+ *                   the inventory report. </p>
+ *                <p>To restrict access to an inventory report, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html#example-bucket-policies-use-case-10">Restricting access to an Amazon S3 Inventory report</a> in the
+ *                   <i>Amazon S3 User Guide</i>. For more information about the metadata fields
+ *                   available in S3 Inventory, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html#storage-inventory-contents">Amazon S3
+ *                      Inventory lists</a> in the <i>Amazon S3 User Guide</i>. 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">Identity and
+ *                         access management in Amazon S3</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *             </dd>
+ *          </dl>
+ *          <p>
+ *             <code>PutBucketInventoryConfiguration</code> has the following special errors:</p>
+ *          <dl>
+ *             <dt>HTTP 400 Bad Request Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Code:</i> InvalidArgument</p>
+ *                <p>
+ *                   <i>Cause:</i> Invalid Argument</p>
+ *             </dd>
+ *             <dt>HTTP 400 Bad Request Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Code:</i> TooManyConfigurations</p>
+ *                <p>
+ *                   <i>Cause:</i> You are attempting to create a new configuration
+ *                         but have already reached the 1,000-configuration limit. </p>
+ *             </dd>
+ *             <dt>HTTP 403 Forbidden Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Cause:</i> You are not the owner of the specified bucket,
+ *                            or you do not have the <code>s3:PutInventoryConfiguration</code> bucket
+ *                            permission to set the configuration on the bucket. </p>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketInventoryConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html">GetBucketInventoryConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html">DeleteBucketInventoryConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html">ListBucketInventoryConfigurations</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutBucketInventoryConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutBucketInventoryConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // PutBucketInventoryConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   Id: "STRING_VALUE", // required
+ *   InventoryConfiguration: { // InventoryConfiguration
+ *     Destination: { // InventoryDestination
+ *       S3BucketDestination: { // InventoryS3BucketDestination
+ *         AccountId: "STRING_VALUE",
+ *         Bucket: "STRING_VALUE", // required
+ *         Format: "CSV" || "ORC" || "Parquet", // required
+ *         Prefix: "STRING_VALUE",
+ *         Encryption: { // InventoryEncryption
+ *           SSES3: {},
+ *           SSEKMS: { // SSEKMS
+ *             KeyId: "STRING_VALUE", // required
+ *           },
+ *         },
+ *       },
+ *     },
+ *     IsEnabled: true || false, // required
+ *     Filter: { // InventoryFilter
+ *       Prefix: "STRING_VALUE", // required
+ *     },
+ *     Id: "STRING_VALUE", // required
+ *     IncludedObjectVersions: "All" || "Current", // required
+ *     OptionalFields: [ // InventoryOptionalFields
+ *       "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm",
+ *     ],
+ *     Schedule: { // InventorySchedule
+ *       Frequency: "Daily" || "Weekly", // required
+ *     },
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new PutBucketInventoryConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param PutBucketInventoryConfigurationCommandInput - {@link PutBucketInventoryConfigurationCommandInput}
+ * @returns {@link PutBucketInventoryConfigurationCommandOutput}
+ * @see {@link PutBucketInventoryConfigurationCommandInput} for command's `input` shape.
+ * @see {@link PutBucketInventoryConfigurationCommandOutput} 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>
+ *
+ */
+export declare class PutBucketInventoryConfigurationCommand extends $Command<PutBucketInventoryConfigurationCommandInput, PutBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {
+    readonly input: PutBucketInventoryConfigurationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutBucketInventoryConfigurationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketInventoryConfigurationCommandInput, PutBucketInventoryConfigurationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,248 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
+import { PutBucketLifecycleConfigurationRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketLifecycleConfigurationCommand}.
+ */
+export interface PutBucketLifecycleConfigurationCommandInput extends PutBucketLifecycleConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketLifecycleConfigurationCommand}.
+ */
+export interface PutBucketLifecycleConfigurationCommandOutput extends __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle
+ *          configuration. Keep in mind that this will overwrite an existing lifecycle configuration,
+ *          so if you want to retain any configuration details, they must be included in the new
+ *          lifecycle configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing
+ *             your storage lifecycle</a>.</p>
+ *          <note>
+ *             <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an
+ *             object key name prefix, one or more object tags, or a combination of both. Accordingly,
+ *             this section describes the latest API. The previous version of the API supported
+ *             filtering based only on an object key name prefix, which is supported for backward
+ *             compatibility. For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>.</p>
+ *          </note>
+ *          <dl>
+ *             <dt>Rules</dt>
+ *             <dd>
+ *                <p>You specify the lifecycle configuration in your request body. The lifecycle
+ *                   configuration is specified as XML consisting of one or more rules. An Amazon S3 Lifecycle
+ *                   configuration can have up to 1,000 rules. This limit is not adjustable. Each rule consists
+ *                   of the following:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>A filter identifying a subset of objects to which the rule applies. The filter can
+ *                         be based on a key name prefix, object tags, or a combination of both.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>A status indicating whether the rule is in effect.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>One or more lifecycle transition and expiration actions that you want Amazon S3 to
+ *                         perform on the objects identified by the filter. If the state of your bucket is
+ *                         versioning-enabled or versioning-suspended, you can have many versions of the same
+ *                         object (one current version and zero or more noncurrent versions). Amazon S3 provides
+ *                         predefined actions that you can specify for current and noncurrent object
+ *                         versions.</p>
+ *                   </li>
+ *                </ul>
+ *                <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle Management</a>
+ *                   and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html">Lifecycle Configuration Elements</a>.</p>
+ *             </dd>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>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 get the <code>s3:PutLifecycleConfiguration</code>
+ *                   permission.</p>
+ *                <p>You can also explicitly deny permissions. An explicit deny also supersedes any other
+ *                   permissions. If you want to block users or accounts from removing or deleting objects from
+ *                   your bucket, you must deny them permissions for the following actions:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:DeleteObject</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:DeleteObjectVersion</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:PutLifecycleConfiguration</code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *                <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>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketLifecycleConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/lifecycle-configuration-examples.html">Examples of
+ *                   Lifecycle Configuration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html">GetBucketLifecycleConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html">DeleteBucketLifecycle</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutBucketLifecycleConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutBucketLifecycleConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // PutBucketLifecycleConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ *   LifecycleConfiguration: { // BucketLifecycleConfiguration
+ *     Rules: [ // LifecycleRules // required
+ *       { // LifecycleRule
+ *         Expiration: { // LifecycleExpiration
+ *           Date: new Date("TIMESTAMP"),
+ *           Days: Number("int"),
+ *           ExpiredObjectDeleteMarker: true || false,
+ *         },
+ *         ID: "STRING_VALUE",
+ *         Prefix: "STRING_VALUE",
+ *         Filter: { // LifecycleRuleFilter Union: only one key present
+ *           Prefix: "STRING_VALUE",
+ *           Tag: { // Tag
+ *             Key: "STRING_VALUE", // required
+ *             Value: "STRING_VALUE", // required
+ *           },
+ *           ObjectSizeGreaterThan: Number("long"),
+ *           ObjectSizeLessThan: Number("long"),
+ *           And: { // LifecycleRuleAndOperator
+ *             Prefix: "STRING_VALUE",
+ *             Tags: [ // TagSet
+ *               {
+ *                 Key: "STRING_VALUE", // required
+ *                 Value: "STRING_VALUE", // required
+ *               },
+ *             ],
+ *             ObjectSizeGreaterThan: Number("long"),
+ *             ObjectSizeLessThan: Number("long"),
+ *           },
+ *         },
+ *         Status: "Enabled" || "Disabled", // required
+ *         Transitions: [ // TransitionList
+ *           { // Transition
+ *             Date: new Date("TIMESTAMP"),
+ *             Days: Number("int"),
+ *             StorageClass: "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "GLACIER_IR",
+ *           },
+ *         ],
+ *         NoncurrentVersionTransitions: [ // NoncurrentVersionTransitionList
+ *           { // NoncurrentVersionTransition
+ *             NoncurrentDays: Number("int"),
+ *             StorageClass: "GLACIER" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "DEEP_ARCHIVE" || "GLACIER_IR",
+ *             NewerNoncurrentVersions: Number("int"),
+ *           },
+ *         ],
+ *         NoncurrentVersionExpiration: { // NoncurrentVersionExpiration
+ *           NoncurrentDays: Number("int"),
+ *           NewerNoncurrentVersions: Number("int"),
+ *         },
+ *         AbortIncompleteMultipartUpload: { // AbortIncompleteMultipartUpload
+ *           DaysAfterInitiation: Number("int"),
+ *         },
+ *       },
+ *     ],
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new PutBucketLifecycleConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param PutBucketLifecycleConfigurationCommandInput - {@link PutBucketLifecycleConfigurationCommandInput}
+ * @returns {@link PutBucketLifecycleConfigurationCommandOutput}
+ * @see {@link PutBucketLifecycleConfigurationCommandInput} for command's `input` shape.
+ * @see {@link PutBucketLifecycleConfigurationCommandOutput} 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>
+ *
+ * @example Put bucket lifecycle
+ * ```javascript
+ * // The following example replaces existing lifecycle configuration, if any, on the specified bucket.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "LifecycleConfiguration": {
+ *     "Rules": [
+ *       {
+ *         "Expiration": {
+ *           "Days": 3650
+ *         },
+ *         "Filter": {
+ *           "Prefix": "documents/"
+ *         },
+ *         "ID": "TestOnly",
+ *         "Status": "Enabled",
+ *         "Transitions": [
+ *           {
+ *             "Days": 365,
+ *             "StorageClass": "GLACIER"
+ *           }
+ *         ]
+ *       }
+ *     ]
+ *   }
+ * };
+ * const command = new PutBucketLifecycleConfigurationCommand(input);
+ * await client.send(command);
+ * // example id: put-bucket-lifecycle-1482264533092
+ * ```
+ *
+ */
+export declare class PutBucketLifecycleConfigurationCommand extends $Command<PutBucketLifecycleConfigurationCommandInput, PutBucketLifecycleConfigurationCommandOutput, S3ClientResolvedConfig> {
+    readonly input: PutBucketLifecycleConfigurationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutBucketLifecycleConfigurationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketLifecycleConfigurationCommandInput, PutBucketLifecycleConfigurationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,200 @@
+import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
+import { Command as $Command } from "@smithy/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
+import { PutBucketLoggingRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketLoggingCommand}.
+ */
+export interface PutBucketLoggingCommandInput extends PutBucketLoggingRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketLoggingCommand}.
+ */
+export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Set the logging parameters for a bucket and to specify permissions for who can view and
+ *          modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as
+ *          the source bucket. To set the logging status of a bucket, you must be the bucket
+ *          owner.</p>
+ *          <p>The bucket owner is automatically granted FULL_CONTROL to all logs. You use the
+ *             <code>Grantee</code> request element to grant access to other people. The
+ *             <code>Permissions</code> request element specifies the kind of access the grantee has to
+ *          the logs.</p>
+ *          <important>
+ *             <p>If the target bucket for log delivery uses the bucket owner enforced setting for S3
+ *             Object Ownership, you can't use the <code>Grantee</code> request element to grant access
+ *             to others. Permissions can only be granted using policies. For more information, see
+ *                <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general">Permissions for server access log delivery</a> in the
+ *                <i>Amazon S3 User Guide</i>.</p>
+ *          </important>
+ *          <dl>
+ *             <dt>Grantee Values</dt>
+ *             <dd>
+ *                <p>You can specify the person (grantee) to whom you're assigning access rights (by using
+ *                   request elements) in the following ways:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>By the person's ID:</p>
+ *                      <p>
+ *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
+ *                         </Grantee></code>
+ *                      </p>
+ *                      <p>
+ *                         <code>DisplayName</code> is optional and ignored in the request.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>By Email address:</p>
+ *                      <p>
+ *                         <code> <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
+ *                      </p>
+ *                      <p>The grantee is resolved to the <code>CanonicalUser</code> and, in a response to a <code>GETObjectAcl</code>
+ *                          request, appears as the CanonicalUser.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>By URI:</p>
+ *                      <p>
+ *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *          </dl>
+ *          <p>To enable logging, you use <code>LoggingEnabled</code> and its children request elements. To disable
+ *          logging, you use an empty <code>BucketLoggingStatus</code> request element:</p>
+ *          <p>
+ *             <code><BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01"
+ *             /></code>
+ *          </p>
+ *          <p>For more information about server access logging, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html">Server Access Logging</a> in the
+ *             <i>Amazon S3 User Guide</i>. </p>
+ *          <p>For more information about creating a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>. For more
+ *          information about returning the logging status of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html">GetBucketLogging</a>.</p>
+ *          <p>The following operations are related to <code>PutBucketLogging</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html">PutObject</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html">DeleteBucket</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html">GetBucketLogging</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutBucketLoggingCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutBucketLoggingCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // PutBucketLoggingRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   BucketLoggingStatus: { // BucketLoggingStatus
+ *     LoggingEnabled: { // LoggingEnabled
+ *       TargetBucket: "STRING_VALUE", // required
+ *       TargetGrants: [ // TargetGrants
+ *         { // TargetGrant
+ *           Grantee: { // Grantee
+ *             DisplayName: "STRING_VALUE",
+ *             EmailAddress: "STRING_VALUE",
+ *             ID: "STRING_VALUE",
+ *             URI: "STRING_VALUE",
+ *             Type: "CanonicalUser" || "AmazonCustomerByEmail" || "Group", // required
+ *           },
+ *           Permission: "FULL_CONTROL" || "READ" || "WRITE",
+ *         },
+ *       ],
+ *       TargetPrefix: "STRING_VALUE", // required
+ *     },
+ *   },
+ *   ContentMD5: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new PutBucketLoggingCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param PutBucketLoggingCommandInput - {@link PutBucketLoggingCommandInput}
+ * @returns {@link PutBucketLoggingCommandOutput}
+ * @see {@link PutBucketLoggingCommandInput} for command's `input` shape.
+ * @see {@link PutBucketLoggingCommandOutput} 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>
+ *
+ * @example Set logging configuration for a bucket
+ * ```javascript
+ * // The following example sets logging policy on a bucket. For the Log Delivery group to deliver logs to the destination bucket, it needs permission for the READ_ACP action which the policy grants.
+ * const input = {
+ *   "Bucket": "sourcebucket",
+ *   "BucketLoggingStatus": {
+ *     "LoggingEnabled": {
+ *       "TargetBucket": "targetbucket",
+ *       "TargetGrants": [
+ *         {
+ *           "Grantee": {
+ *             "Type": "Group",
+ *             "URI": "http://acs.amazonaws.com/groups/global/AllUsers"
+ *           },
+ *           "Permission": "READ"
+ *         }
+ *       ],
+ *       "TargetPrefix": "MyBucketLogs/"
+ *     }
+ *   }
+ * };
+ * const command = new PutBucketLoggingCommand(input);
+ * await client.send(command);
+ * // example id: set-logging-configuration-for-a-bucket-1482269119909
+ * ```
+ *
+ */
+export declare class PutBucketLoggingCommand extends $Command<PutBucketLoggingCommandInput, PutBucketLoggingCommandOutput, S3ClientResolvedConfig> {
+    readonly input: PutBucketLoggingCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutBucketLoggingCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketLoggingCommandInput, PutBucketLoggingCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}