@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/ListPartsCommand.d.ts

@@ -0,0 +1,201 @@
+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 { ListPartsOutput, ListPartsRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListPartsCommand}.
+ */
+export interface ListPartsCommandInput extends ListPartsRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListPartsCommand}.
+ */
+export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Lists the parts that have been uploaded for a specific multipart upload. This operation
+ *          must include the upload ID, which you obtain by sending the initiate multipart upload
+ *          request (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>).
+ *          This request returns a maximum of 1,000 uploaded parts. The default number of parts
+ *          returned is 1,000 parts. You can restrict the number of parts returned by specifying the
+ *             <code>max-parts</code> request parameter. If your multipart upload consists of more than
+ *          1,000 parts, the response returns an <code>IsTruncated</code> field with the value of true,
+ *          and a <code>NextPartNumberMarker</code> element. In subsequent <code>ListParts</code>
+ *          requests you can include the part-number-marker query string parameter and set its value to
+ *          the <code>NextPartNumberMarker</code> field value from the previous response.</p>
+ *          <p>If the upload was created using a checksum algorithm, you will need to have permission
+ *          to the <code>kms:Decrypt</code> action for the request to succeed. </p>
+ *          <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
+ *             Upload</a>.</p>
+ *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
+ *             and Permissions</a>.</p>
+ *          <p>The following operations are related to <code>ListParts</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html">CompleteMultipartUpload</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html">AbortMultipartUpload</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html">GetObjectAttributes</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html">ListMultipartUploads</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, ListPartsCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, ListPartsCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // ListPartsRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   Key: "STRING_VALUE", // required
+ *   MaxParts: Number("int"),
+ *   PartNumberMarker: "STRING_VALUE",
+ *   UploadId: "STRING_VALUE", // required
+ *   RequestPayer: "requester",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ *   SSECustomerAlgorithm: "STRING_VALUE",
+ *   SSECustomerKey: "STRING_VALUE",
+ *   SSECustomerKeyMD5: "STRING_VALUE",
+ * };
+ * const command = new ListPartsCommand(input);
+ * const response = await client.send(command);
+ * // { // ListPartsOutput
+ * //   AbortDate: new Date("TIMESTAMP"),
+ * //   AbortRuleId: "STRING_VALUE",
+ * //   Bucket: "STRING_VALUE",
+ * //   Key: "STRING_VALUE",
+ * //   UploadId: "STRING_VALUE",
+ * //   PartNumberMarker: "STRING_VALUE",
+ * //   NextPartNumberMarker: "STRING_VALUE",
+ * //   MaxParts: Number("int"),
+ * //   IsTruncated: true || false,
+ * //   Parts: [ // Parts
+ * //     { // Part
+ * //       PartNumber: Number("int"),
+ * //       LastModified: new Date("TIMESTAMP"),
+ * //       ETag: "STRING_VALUE",
+ * //       Size: Number("long"),
+ * //       ChecksumCRC32: "STRING_VALUE",
+ * //       ChecksumCRC32C: "STRING_VALUE",
+ * //       ChecksumSHA1: "STRING_VALUE",
+ * //       ChecksumSHA256: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   Initiator: { // Initiator
+ * //     ID: "STRING_VALUE",
+ * //     DisplayName: "STRING_VALUE",
+ * //   },
+ * //   Owner: { // Owner
+ * //     DisplayName: "STRING_VALUE",
+ * //     ID: "STRING_VALUE",
+ * //   },
+ * //   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //   RequestCharged: "requester",
+ * //   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ * // };
+ *
+ * ```
+ *
+ * @param ListPartsCommandInput - {@link ListPartsCommandInput}
+ * @returns {@link ListPartsCommandOutput}
+ * @see {@link ListPartsCommandInput} for command's `input` shape.
+ * @see {@link ListPartsCommandOutput} 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 To list parts of a multipart upload.
+ * ```javascript
+ * // The following example lists parts uploaded for a specific multipart upload.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "bigobject",
+ *   "UploadId": "example7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
+ * };
+ * const command = new ListPartsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Initiator": {
+ *     "DisplayName": "owner-display-name",
+ *     "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
+ *   },
+ *   "Owner": {
+ *     "DisplayName": "owner-display-name",
+ *     "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
+ *   },
+ *   "Parts": [
+ *     {
+ *       "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
+ *       "LastModified": "2016-12-16T00:11:42.000Z",
+ *       "PartNumber": "1",
+ *       "Size": 26246026
+ *     },
+ *     {
+ *       "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
+ *       "LastModified": "2016-12-16T00:15:01.000Z",
+ *       "PartNumber": "2",
+ *       "Size": 26246026
+ *     }
+ *   ],
+ *   "StorageClass": "STANDARD"
+ * }
+ * *\/
+ * // example id: to-list-parts-of-a-multipart-upload-1481852006923
+ * ```
+ *
+ */
+export declare class ListPartsCommand extends $Command<ListPartsCommandInput, ListPartsCommandOutput, S3ClientResolvedConfig> {
+    readonly input: ListPartsCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: ListPartsCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<ListPartsCommandInput, ListPartsCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,114 @@
+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 { PutBucketAccelerateConfigurationRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketAccelerateConfigurationCommand}.
+ */
+export interface PutBucketAccelerateConfigurationCommandInput extends PutBucketAccelerateConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketAccelerateConfigurationCommand}.
+ */
+export interface PutBucketAccelerateConfigurationCommandOutput extends __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Sets the accelerate configuration of an existing bucket. Amazon S3 Transfer Acceleration is a
+ *          bucket-level feature that enables you to perform faster data transfers to Amazon S3.</p>
+ *          <p> To use this operation, you must have permission to perform the
+ *             <code>s3:PutAccelerateConfiguration</code> action. The bucket owner has this permission
+ *          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> The Transfer Acceleration state of a bucket can be set to one of the following two
+ *          values:</p>
+ *          <ul>
+ *             <li>
+ *                <p> Enabled – Enables accelerated data transfers to the bucket.</p>
+ *             </li>
+ *             <li>
+ *                <p> Suspended – Disables accelerated data transfers to the bucket.</p>
+ *             </li>
+ *          </ul>
+ *          <p>The <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a> action returns the transfer acceleration state
+ *          of a bucket.</p>
+ *          <p>After setting the Transfer Acceleration state of a bucket to Enabled, it might take up
+ *          to thirty minutes before the data transfer rates to the bucket increase.</p>
+ *          <p> The name of the bucket used for Transfer Acceleration must be DNS-compliant and must
+ *          not contain periods (".").</p>
+ *          <p> For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer
+ *          Acceleration</a>.</p>
+ *          <p>The following operations are related to
+ *          <code>PutBucketAccelerateConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutBucketAccelerateConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutBucketAccelerateConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // PutBucketAccelerateConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   AccelerateConfiguration: { // AccelerateConfiguration
+ *     Status: "Enabled" || "Suspended",
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ * };
+ * const command = new PutBucketAccelerateConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param PutBucketAccelerateConfigurationCommandInput - {@link PutBucketAccelerateConfigurationCommandInput}
+ * @returns {@link PutBucketAccelerateConfigurationCommandOutput}
+ * @see {@link PutBucketAccelerateConfigurationCommandInput} for command's `input` shape.
+ * @see {@link PutBucketAccelerateConfigurationCommandOutput} 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 PutBucketAccelerateConfigurationCommand extends $Command<PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig> {
+    readonly input: PutBucketAccelerateConfigurationCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutBucketAccelerateConfigurationCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}

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

@@ -0,0 +1,302 @@
+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 { PutBucketAclRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export { __MetadataBearer, $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketAclCommand}.
+ */
+export interface PutBucketAclCommandInput extends PutBucketAclRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketAclCommand}.
+ */
+export interface PutBucketAclCommandOutput extends __MetadataBearer {
+}
+/**
+ * @public
+ * <p>Sets the permissions on an existing bucket using access control lists (ACL). For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. To set the ACL of a
+ *          bucket, you must have <code>WRITE_ACP</code> permission.</p>
+ *          <p>You can use one of the following two ways to set a bucket's permissions:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Specify the ACL in the request body</p>
+ *             </li>
+ *             <li>
+ *                <p>Specify permissions using request headers</p>
+ *             </li>
+ *          </ul>
+ *          <note>
+ *             <p>You cannot specify access permission using both the body and the request
+ *             headers.</p>
+ *          </note>
+ *          <p>Depending on your application needs, you may choose to set the ACL on a bucket using
+ *          either the request body or the headers. For example, if you have an existing application
+ *          that updates a bucket ACL using the request body, then you can continue to use that
+ *          approach.</p>
+ *          <important>
+ *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs
+ *             are disabled and no longer affect permissions. You must use policies to grant access to
+ *             your bucket and the objects in it. Requests to set ACLs or update ACLs fail and return
+ *             the <code>AccessControlListNotSupported</code> error code. Requests to read ACLs are
+ *             still supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object
+ *                ownership</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          </important>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You can set access permissions by using one of the following methods:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports
+ *                         a set of predefined ACLs, known as <i>canned ACLs</i>. Each canned ACL
+ *                         has a predefined set of grantees and permissions. Specify the canned ACL name as the
+ *                         value of <code>x-amz-acl</code>. If you use this header, you cannot use other access
+ *                         control-specific headers in your request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
+ *                            ACL</a>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>Specify access permissions explicitly with the <code>x-amz-grant-read</code>,
+ *                         <code>x-amz-grant-read-acp</code>, <code>x-amz-grant-write-acp</code>, and
+ *                         <code>x-amz-grant-full-control</code> headers. When using these headers, you
+ *                         specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3 groups) who
+ *                         will receive the permission. If you use these ACL-specific headers, you cannot use
+ *                         the <code>x-amz-acl</code> header to set a canned ACL. These parameters map to the
+ *                         set of permissions that Amazon S3 supports in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control
+ *                            List (ACL) Overview</a>.</p>
+ *                      <p>You specify each grantee as a type=value pair, where the type is one of the
+ *                         following:</p>
+ *                      <ul>
+ *                         <li>
+ *                            <p>
+ *                               <code>id</code> – if the value specified is the canonical user ID of an
+ *                               Amazon Web Services account</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <code>uri</code> – if you are granting permissions to a predefined
+ *                               group</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <code>emailAddress</code> – if the value specified is the email address of
+ *                               an Amazon Web Services account</p>
+ *                            <note>
+ *                               <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
+ *                               <ul>
+ *                                  <li>
+ *                                     <p>US East (N. Virginia)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>US West (N. California)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p> US West (Oregon)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p> Asia Pacific (Singapore)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Asia Pacific (Sydney)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Asia Pacific (Tokyo)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Europe (Ireland)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>South America (São Paulo)</p>
+ *                                  </li>
+ *                               </ul>
+ *                               <p>For a list of all the Amazon S3 supported Regions and endpoints, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a> in the Amazon Web Services General Reference.</p>
+ *                            </note>
+ *                         </li>
+ *                      </ul>
+ *                      <p>For example, the following <code>x-amz-grant-write</code> header grants create,
+ *                         overwrite, and delete objects permission to LogDelivery group predefined by Amazon S3 and
+ *                         two Amazon Web Services accounts identified by their email addresses.</p>
+ *                      <p>
+ *                         <code>x-amz-grant-write: uri="http://acs.amazonaws.com/groups/s3/LogDelivery",
+ *                         id="111122223333", id="555566667777" </code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *                <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
+ *                   both.</p>
+ *             </dd>
+ *             <dt>Grantee Values</dt>
+ *             <dd>
+ *                <p>You can specify the person (grantee) to whom you're assigning access rights (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>DisplayName is optional and ignored in the request</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>
+ *                   <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 CanonicalUser and, in a response to a GET Object
+ *                         acl request, appears as the CanonicalUser. </p>
+ *                      <note>
+ *                         <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
+ *                         <ul>
+ *                            <li>
+ *                               <p>US East (N. Virginia)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p>US West (N. California)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p> US West (Oregon)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p> Asia Pacific (Singapore)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p>Asia Pacific (Sydney)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p>Asia Pacific (Tokyo)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p>Europe (Ireland)</p>
+ *                            </li>
+ *                            <li>
+ *                               <p>South America (São Paulo)</p>
+ *                            </li>
+ *                         </ul>
+ *                         <p>For a list of all the Amazon S3 supported Regions and endpoints, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a> in the Amazon Web Services General Reference.</p>
+ *                      </note>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketAcl</code>:</p>
+ *          <ul>
+ *             <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_DeleteBucket.html">DeleteBucket</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html">GetObjectAcl</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutBucketAclCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutBucketAclCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * const client = new S3Client(config);
+ * const input = { // PutBucketAclRequest
+ *   ACL: "private" || "public-read" || "public-read-write" || "authenticated-read",
+ *   AccessControlPolicy: { // AccessControlPolicy
+ *     Grants: [ // Grants
+ *       { // Grant
+ *         Grantee: { // Grantee
+ *           DisplayName: "STRING_VALUE",
+ *           EmailAddress: "STRING_VALUE",
+ *           ID: "STRING_VALUE",
+ *           URI: "STRING_VALUE",
+ *           Type: "CanonicalUser" || "AmazonCustomerByEmail" || "Group", // required
+ *         },
+ *         Permission: "FULL_CONTROL" || "WRITE" || "WRITE_ACP" || "READ" || "READ_ACP",
+ *       },
+ *     ],
+ *     Owner: { // Owner
+ *       DisplayName: "STRING_VALUE",
+ *       ID: "STRING_VALUE",
+ *     },
+ *   },
+ *   Bucket: "STRING_VALUE", // required
+ *   ContentMD5: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ *   GrantFullControl: "STRING_VALUE",
+ *   GrantRead: "STRING_VALUE",
+ *   GrantReadACP: "STRING_VALUE",
+ *   GrantWrite: "STRING_VALUE",
+ *   GrantWriteACP: "STRING_VALUE",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new PutBucketAclCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param PutBucketAclCommandInput - {@link PutBucketAclCommandInput}
+ * @returns {@link PutBucketAclCommandOutput}
+ * @see {@link PutBucketAclCommandInput} for command's `input` shape.
+ * @see {@link PutBucketAclCommandOutput} 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 acl
+ * ```javascript
+ * // The following example replaces existing ACL on a bucket. The ACL grants the bucket owner (specified using the owner ID) and write permission to the LogDelivery group. Because this is a replace operation, you must specify all the grants in your request. To incrementally add or remove ACL grants, you might use the console.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "GrantFullControl": "id=examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484",
+ *   "GrantWrite": "uri=http://acs.amazonaws.com/groups/s3/LogDelivery"
+ * };
+ * const command = new PutBucketAclCommand(input);
+ * await client.send(command);
+ * // example id: put-bucket-acl-1482260397033
+ * ```
+ *
+ */
+export declare class PutBucketAclCommand extends $Command<PutBucketAclCommandInput, PutBucketAclCommandOutput, S3ClientResolvedConfig> {
+    readonly input: PutBucketAclCommandInput;
+    static getEndpointParameterInstructions(): EndpointParameterInstructions;
+    /**
+     * @public
+     */
+    constructor(input: PutBucketAclCommandInput);
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<PutBucketAclCommandInput, PutBucketAclCommandOutput>;
+    /**
+     * @internal
+     */
+    private serialize;
+    /**
+     * @internal
+     */
+    private deserialize;
+}