@tachybase/module-file 0.23.8

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

@@ -0,0 +1,238 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { ListPartsOutput, ListPartsRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListPartsCommand}.
+ */
+export interface ListPartsCommandInput extends ListPartsRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListPartsCommand}.
+ */
+export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBearer {
+}
+declare const ListPartsCommand_base: {
+    new (input: ListPartsCommandInput): import("@smithy/smithy-client").CommandImpl<ListPartsCommandInput, ListPartsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: ListPartsCommandInput): import("@smithy/smithy-client").CommandImpl<ListPartsCommandInput, ListPartsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <p>Lists the parts that have been uploaded for a specific multipart upload.</p>
+ *          <p>To use this operation, you must provide the <code>upload ID</code> in the request. You
+ *          obtain this uploadID by sending the initiate multipart upload request through <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>.</p>
+ *          <p>The <code>ListParts</code> request returns a maximum of 1,000 uploaded parts. The limit
+ *          of 1,000 parts is also the default value. You can restrict the number of parts in a
+ *          response 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 <code>true</code>, and a <code>NextPartNumberMarker</code> element.
+ *          To list remaining uploaded parts, in subsequent <code>ListParts</code> requests, include
+ *          the <code>part-number-marker</code> query string parameter and set its value to the
+ *             <code>NextPartNumberMarker</code> field value from the previous response.</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> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <note>
+ *             <p>
+ *                <b>Directory buckets</b> -
+ *             For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com/<i>key-name</i>
+ *                </code>. Path-style requests are not 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>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <b>General purpose bucket permissions</b> - For
+ *                         information about 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> in the <i>Amazon S3 User Guide</i>.</p>
+ *                      <p>If the upload was created 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), you must have permission to the
+ *                            <code>kms:Decrypt</code> action for the <code>ListParts</code> request to
+ *                         succeed.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
+ * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a>.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>
+ *                      <i>Bucket-name</i>.s3express-<i>zone-id</i>.<i>region-code</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
+ *          <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" || "EXPRESS_ONEZONE",
+ * //   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>
+ *
+ * @public
+ * @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 ListPartsCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: ListPartsRequest;
+            output: ListPartsOutput;
+        };
+        sdk: {
+            input: ListPartsCommandInput;
+            output: ListPartsCommandOutput;
+        };
+    };
+}

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

@@ -0,0 +1,115 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { PutBucketAccelerateConfigurationRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketAccelerateConfigurationCommand}.
+ */
+export interface PutBucketAccelerateConfigurationCommandInput extends PutBucketAccelerateConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketAccelerateConfigurationCommand}.
+ */
+export interface PutBucketAccelerateConfigurationCommandOutput extends __MetadataBearer {
+}
+declare const PutBucketAccelerateConfigurationCommand_base: {
+    new (input: PutBucketAccelerateConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: PutBucketAccelerateConfigurationCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <note>
+ *             <p>This operation is not supported for directory buckets.</p>
+ *          </note>
+ *          <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>
+ *
+ * @public
+ */
+export declare class PutBucketAccelerateConfigurationCommand extends PutBucketAccelerateConfigurationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketAccelerateConfigurationRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketAccelerateConfigurationCommandInput;
+            output: PutBucketAccelerateConfigurationCommandOutput;
+        };
+    };
+}

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

@@ -0,0 +1,309 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import { PutBucketAclRequest } from "../models/models_0";
+import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutBucketAclCommand}.
+ */
+export interface PutBucketAclCommandInput extends PutBucketAclRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link PutBucketAclCommand}.
+ */
+export interface PutBucketAclCommandOutput extends __MetadataBearer {
+}
+declare const PutBucketAclCommand_base: {
+    new (input: PutBucketAclCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAclCommandInput, PutBucketAclCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (__0_0: PutBucketAclCommandInput): import("@smithy/smithy-client").CommandImpl<PutBucketAclCommandInput, PutBucketAclCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+/**
+ * <note>
+ *             <p>This operation is not supported for directory buckets.</p>
+ *          </note>
+ *          <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 the <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>
+ *
+ * @public
+ * @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 PutBucketAclCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutBucketAclRequest;
+            output: {};
+        };
+        sdk: {
+            input: PutBucketAclCommandInput;
+            output: PutBucketAclCommandOutput;
+        };
+    };
+}