@nocobase/plugin-file-manager 1.6.0-beta.2 → 1.6.0-beta.4

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

@@ -1,155 +1,99 @@
-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 { EndpointParameterInstructions } from "@aws-sdk/middleware-endpoint";
+import { Command as $Command } from "@aws-sdk/smithy-client";
+import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
 import { CompleteMultipartUploadOutput, CompleteMultipartUploadRequest } from "../models/models_0";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
-/**
- * @public
- */
-export { __MetadataBearer, $Command };
-/**
- * @public
- *
- * The input for {@link CompleteMultipartUploadCommand}.
- */
 export interface CompleteMultipartUploadCommandInput extends CompleteMultipartUploadRequest {
 }
-/**
- * @public
- *
- * The output of {@link CompleteMultipartUploadCommand}.
- */
 export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartUploadOutput, __MetadataBearer {
 }
 /**
- * @public
  * <p>Completes a multipart upload by assembling previously uploaded parts.</p>
  *          <p>You first initiate the multipart upload and then upload all parts using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>
- *          operation or the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a>
  *          operation. After successfully uploading all relevant parts of an upload, you call this
- *          <code>CompleteMultipartUpload</code> operation to complete the upload. Upon receiving this request, Amazon S3 concatenates all the parts
- *          in ascending order by part number to create a new object. In the CompleteMultipartUpload
- *          request, you must provide the parts list and ensure that the parts list is complete.
- *          The CompleteMultipartUpload API operation concatenates the parts that you provide in the list. For each part in the list,
- *          you must provide the <code>PartNumber</code> value and the <code>ETag</code> value that are returned after that part
- *          was uploaded.</p>
- *          <p>The processing of a CompleteMultipartUpload request could take several minutes to
- *          finalize. After Amazon S3 begins processing the request, it sends an HTTP response header that
- *          specifies a <code>200 OK</code> response. While processing is in progress, Amazon S3 periodically sends white
- *          space characters to keep the connection from timing out. A request could fail after the
- *          initial <code>200 OK</code> response has been sent. This means that a <code>200 OK</code> response can
- *          contain either a success or an error. The error response might be embedded in the <code>200 OK</code> response.
- *          If you call this API operation directly, make sure to design
- *          your application to parse the contents of the response and handle it appropriately. If you
- *          use Amazon Web Services SDKs, SDKs handle this condition. The SDKs detect the embedded error and apply
- *          error handling per your configuration settings (including automatically retrying the
- *          request as appropriate). If the condition persists, the SDKs throw an exception (or, for
- *          the SDKs that don't use exceptions, they return an error). </p>
+ *          action to complete the upload. Upon receiving this request, Amazon S3 concatenates all
+ *          the parts in ascending order by part number to create a new object. In the Complete
+ *          Multipart Upload request, you must provide the parts list. You must ensure that the parts
+ *          list is complete. This action concatenates the parts that you provide in the list. For
+ *          each part in the list, you must provide the part number and the <code>ETag</code> value,
+ *          returned after that part was uploaded.</p>
+ *          <p>Processing of a Complete Multipart Upload request could take several minutes to
+ *          complete. After Amazon S3 begins processing the request, it sends an HTTP response header that
+ *          specifies a 200 OK response. While processing is in progress, Amazon S3 periodically sends white
+ *          space characters to keep the connection from timing out. Because a request could fail after
+ *          the initial 200 OK response has been sent, it is important that you check the response body
+ *          to determine whether the request succeeded.</p>
  *          <p>Note that if <code>CompleteMultipartUpload</code> fails, applications should be prepared
- *          to retry the failed requests. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html">Amazon S3 Error Best
- *          Practices</a>.</p>
+ *          to retry the failed requests. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ErrorBestPractices.html">Amazon S3 Error Best Practices</a>.</p>
  *          <important>
- *             <p>You can't use <code>Content-Type: application/x-www-form-urlencoded</code> for the
- *             CompleteMultipartUpload requests. Also, if you don't provide a
- *                <code>Content-Type</code> header, <code>CompleteMultipartUpload</code> can still return a <code>200
- *             OK</code> response.</p>
+ *             <p>You cannot use <code>Content-Type: application/x-www-form-urlencoded</code> with Complete
+ *             Multipart Upload requests. Also, if you do not provide a <code>Content-Type</code> header, <code>CompleteMultipartUpload</code> returns a 200 OK response.</p>
  *          </important>
  *          <p>For more information about 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>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
- *                </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
- *     <i>Amazon S3 User Guide</i>.</p>
- *          </note>
- *          <dl>
- *             <dt>Permissions</dt>
- *             <dd>
+ *             Upload</a>.</p>
+ *          <p>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>.</p>
+ *
+ *
+ *          <p>
+ *             <code>CompleteMultipartUpload</code> has the following special errors:</p>
+ *          <ul>
+ *             <li>
+ *                <p>Error code: <code>EntityTooSmall</code>
+ *                </p>
  *                <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>Description: Your proposed upload is smaller than the minimum allowed object
+ *                      size. Each part must be at least 5 MB in size, except the last part.</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>
+ *                      <p>400 Bad Request</p>
  *                   </li>
  *                </ul>
- *             </dd>
- *             <dt>Special errors</dt>
- *             <dd>
+ *             </li>
+ *             <li>
+ *                <p>Error code: <code>InvalidPart</code>
+ *                </p>
  *                <ul>
  *                   <li>
- *                      <p>Error Code: <code>EntityTooSmall</code>
- *                      </p>
- *                      <ul>
- *                         <li>
- *                            <p>Description: Your proposed upload is smaller than the minimum allowed object
- *                            size. Each part must be at least 5 MB in size, except the last part.</p>
- *                         </li>
- *                         <li>
- *                            <p>HTTP Status Code: 400 Bad Request</p>
- *                         </li>
- *                      </ul>
+ *                      <p>Description: One or more of the specified parts could not be found. The part
+ *                      might not have been uploaded, or the specified entity tag might not have
+ *                      matched the part's entity tag.</p>
  *                   </li>
  *                   <li>
- *                      <p>Error Code: <code>InvalidPart</code>
- *                      </p>
- *                      <ul>
- *                         <li>
- *                            <p>Description: One or more of the specified parts could not be found. The part
- *                            might not have been uploaded, or the specified ETag might not have
- *                            matched the uploaded part's ETag.</p>
- *                         </li>
- *                         <li>
- *                            <p>HTTP Status Code: 400 Bad Request</p>
- *                         </li>
- *                      </ul>
+ *                      <p>400 Bad Request</p>
  *                   </li>
+ *                </ul>
+ *             </li>
+ *             <li>
+ *                <p>Error code: <code>InvalidPartOrder</code>
+ *                </p>
+ *                <ul>
  *                   <li>
- *                      <p>Error Code: <code>InvalidPartOrder</code>
- *                      </p>
- *                      <ul>
- *                         <li>
- *                            <p>Description: The list of parts was not in ascending order. The parts list
- *                            must be specified in order by part number.</p>
- *                         </li>
- *                         <li>
- *                            <p>HTTP Status Code: 400 Bad Request</p>
- *                         </li>
- *                      </ul>
+ *                      <p>Description: The list of parts was not in ascending order. The parts list
+ *                      must be specified in order by part number.</p>
  *                   </li>
  *                   <li>
- *                      <p>Error Code: <code>NoSuchUpload</code>
- *                      </p>
- *                      <ul>
- *                         <li>
- *                            <p>Description: The specified multipart upload does not exist. The upload ID
- *                            might be invalid, or the multipart upload might have been aborted or
- *                            completed.</p>
- *                         </li>
- *                         <li>
- *                            <p>HTTP Status Code: 404 Not Found</p>
- *                         </li>
- *                      </ul>
+ *                      <p>400 Bad Request</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>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
- *             </dd>
- *          </dl>
+ *             </li>
+ *             <li>
+ *                <p>Error code: <code>NoSuchUpload</code>
+ *                </p>
+ *                <ul>
+ *                   <li>
+ *                      <p>Description: The specified multipart upload does not exist. The upload ID
+ *                      might be invalid, or the multipart upload might have been aborted or
+ *                      completed.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>404 Not Found</p>
+ *                   </li>
+ *                </ul>
+ *             </li>
+ *          </ul>
+ *
  *          <p>The following operations are related to <code>CompleteMultipartUpload</code>:</p>
  *          <ul>
  *             <li>
@@ -184,113 +128,23 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * import { S3Client, CompleteMultipartUploadCommand } from "@aws-sdk/client-s3"; // ES Modules import
  * // const { S3Client, CompleteMultipartUploadCommand } = require("@aws-sdk/client-s3"); // CommonJS import
  * const client = new S3Client(config);
- * const input = { // CompleteMultipartUploadRequest
- *   Bucket: "STRING_VALUE", // required
- *   Key: "STRING_VALUE", // required
- *   MultipartUpload: { // CompletedMultipartUpload
- *     Parts: [ // CompletedPartList
- *       { // CompletedPart
- *         ETag: "STRING_VALUE",
- *         ChecksumCRC32: "STRING_VALUE",
- *         ChecksumCRC32C: "STRING_VALUE",
- *         ChecksumSHA1: "STRING_VALUE",
- *         ChecksumSHA256: "STRING_VALUE",
- *         PartNumber: Number("int"),
- *       },
- *     ],
- *   },
- *   UploadId: "STRING_VALUE", // required
- *   ChecksumCRC32: "STRING_VALUE",
- *   ChecksumCRC32C: "STRING_VALUE",
- *   ChecksumSHA1: "STRING_VALUE",
- *   ChecksumSHA256: "STRING_VALUE",
- *   RequestPayer: "requester",
- *   ExpectedBucketOwner: "STRING_VALUE",
- *   SSECustomerAlgorithm: "STRING_VALUE",
- *   SSECustomerKey: "STRING_VALUE",
- *   SSECustomerKeyMD5: "STRING_VALUE",
- * };
  * const command = new CompleteMultipartUploadCommand(input);
  * const response = await client.send(command);
- * // { // CompleteMultipartUploadOutput
- * //   Location: "STRING_VALUE",
- * //   Bucket: "STRING_VALUE",
- * //   Key: "STRING_VALUE",
- * //   Expiration: "STRING_VALUE",
- * //   ETag: "STRING_VALUE",
- * //   ChecksumCRC32: "STRING_VALUE",
- * //   ChecksumCRC32C: "STRING_VALUE",
- * //   ChecksumSHA1: "STRING_VALUE",
- * //   ChecksumSHA256: "STRING_VALUE",
- * //   ServerSideEncryption: "AES256" || "aws:kms" || "aws:kms:dsse",
- * //   VersionId: "STRING_VALUE",
- * //   SSEKMSKeyId: "STRING_VALUE",
- * //   BucketKeyEnabled: true || false,
- * //   RequestCharged: "requester",
- * // };
- *
  * ```
  *
- * @param CompleteMultipartUploadCommandInput - {@link CompleteMultipartUploadCommandInput}
- * @returns {@link CompleteMultipartUploadCommandOutput}
  * @see {@link CompleteMultipartUploadCommandInput} for command's `input` shape.
  * @see {@link CompleteMultipartUploadCommandOutput} 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 complete multipart upload
- * ```javascript
- * // The following example completes a multipart upload.
- * const input = {
- *   "Bucket": "examplebucket",
- *   "Key": "bigobject",
- *   "MultipartUpload": {
- *     "Parts": [
- *       {
- *         "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
- *         "PartNumber": "1"
- *       },
- *       {
- *         "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
- *         "PartNumber": "2"
- *       }
- *     ]
- *   },
- *   "UploadId": "7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
- * };
- * const command = new CompleteMultipartUploadCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "Bucket": "acexamplebucket",
- *   "ETag": "\"4d9031c7644d8081c2829f4ea23c55f7-2\"",
- *   "Key": "bigobject",
- *   "Location": "https://examplebucket.s3.<Region>.amazonaws.com/bigobject"
- * }
- * *\/
- * // example id: to-complete-multipart-upload-1481851590483
- * ```
- *
  */
 export declare class CompleteMultipartUploadCommand extends $Command<CompleteMultipartUploadCommandInput, CompleteMultipartUploadCommandOutput, S3ClientResolvedConfig> {
     readonly input: CompleteMultipartUploadCommandInput;
     static getEndpointParameterInstructions(): EndpointParameterInstructions;
-    /**
-     * @public
-     */
     constructor(input: CompleteMultipartUploadCommandInput);
     /**
      * @internal
      */
     resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: S3ClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CompleteMultipartUploadCommandInput, CompleteMultipartUploadCommandOutput>;
-    /**
-     * @internal
-     */
     private serialize;
-    /**
-     * @internal
-     */
     private deserialize;
 }