@aws-sdk/client-s3 3.325.0 → 3.327.0

package/dist-types/commands/AbortMultipartUploadCommand.d.ts

@@ -28,8 +28,8 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  *          <p>To verify that all parts have been removed, so you don't get charged for the part
  *          storage, you should call the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html">ListParts</a> action and ensure that
  *          the parts list is empty.</p>
- *          <p>For information about permissions required to use the multipart upload, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
- *          Permissions</a>.</p>
+ *          <p>For information about permissions required to use the multipart upload, 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>AbortMultipartUpload</code>:</p>
  *          <ul>
  *             <li>
@@ -73,6 +73,10 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  * };
  * const command = new AbortMultipartUploadCommand(input);
  * const response = await client.send(command);
+ * // { // AbortMultipartUploadOutput
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param AbortMultipartUploadCommandInput - {@link AbortMultipartUploadCommandInput}
@@ -84,6 +88,8 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  * @throws {@link NoSuchUpload} (client fault)
  *  <p>The specified multipart upload does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To abort a multipart upload
  * ```javascript

package/dist-types/commands/CompleteMultipartUploadCommand.d.ts

@@ -22,28 +22,36 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * <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. After successfully uploading all relevant parts of an upload, you call this
- *          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>
+ *          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>
+ *          space characters to keep the connection from timing out. A request could fail after the
+ *          initial 200 OK response has been sent. This means that a <code>200 OK</code> response can
+ *          contain either a success or an error. If you call the S3 API 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 throws an exception (or, for
+ *          the SDKs that don't use exceptions, they return the error). </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 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>
+ *             <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>.</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>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>
@@ -164,6 +172,23 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * };
  * 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",
+ * //   VersionId: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param CompleteMultipartUploadCommandInput - {@link CompleteMultipartUploadCommandInput}
@@ -172,6 +197,8 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * @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

package/dist-types/commands/CopyObjectCommand.d.ts

@@ -29,15 +29,20 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *          </note>
  *          <p>All copy requests must be authenticated. Additionally, you must have
  *             <i>read</i> access to the source object and <i>write</i>
- *          access to the destination bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>. Both the Region
- *          that you want to copy the object from and the Region that you want to copy the object to
- *          must be enabled for your account.</p>
+ *          access to the destination bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>. Both the
+ *          Region that you want to copy the object from and the Region that you want to copy the
+ *          object to must be enabled for your account.</p>
  *          <p>A copy request might return an error when Amazon S3 receives the copy request or while Amazon S3
  *          is copying the files. If the error occurs before the copy action starts, you receive a
  *          standard Amazon S3 error. If the error occurs during the copy operation, the error response is
  *          embedded in the <code>200 OK</code> response. This means that a <code>200 OK</code>
- *          response can contain either a success or an error. Design your application to parse the
- *          contents of the response and handle it appropriately.</p>
+ *          response can contain either a success or an error. If you call the S3 API 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
+ *          throws an exception (or, for the SDKs that don't use exceptions, they return the
+ *          error).</p>
  *          <p>If the copy is successful, you receive a response with information about the copied
  *          object.</p>
  *          <note>
@@ -50,144 +55,168 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *          <important>
  *             <p>Amazon S3 transfer acceleration does not support cross-Region copies. If you request a
  *             cross-Region copy using a transfer acceleration endpoint, you get a 400 <code>Bad
- *                Request</code> error. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a>.</p>
+ *                Request</code> error. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer
+ *             Acceleration</a>.</p>
  *          </important>
- *          <p>
- *             <b>Metadata</b>
- *          </p>
- *          <p>When copying an object, you can preserve all metadata (default) or specify new metadata.
- *          However, the ACL is not preserved and is set to private for the user making the request. To
- *          override the default ACL setting, specify a new ACL when generating a copy request. For
- *          more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. </p>
- *          <p>To specify whether you want the object metadata copied from the source object or
- *          replaced with metadata provided in the request, you can optionally add the
- *             <code>x-amz-metadata-directive</code> header. When you grant permissions, you can use
- *          the <code>s3:x-amz-metadata-directive</code> condition key to enforce certain metadata
- *          behavior when objects are uploaded. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html">Specifying Conditions in a
- *             Policy</a> in the <i>Amazon S3 User Guide</i>. For a complete list of
- *          Amazon S3-specific condition keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, Resources, and Condition Keys for
- *             Amazon S3</a>.</p>
- *          <p>
- *             <b>x-amz-copy-source-if Headers</b>
- *          </p>
- *          <p>To only copy an object under certain conditions, such as whether the <code>Etag</code>
- *          matches or whether the object was modified before or after a specified date, use the
- *          following request parameters:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-match</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-none-match</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-unmodified-since</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-modified-since</code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p> If both the <code>x-amz-copy-source-if-match</code> and
- *             <code>x-amz-copy-source-if-unmodified-since</code> headers are present in the request
- *          and evaluate as follows, Amazon S3 returns <code>200 OK</code> and copies the data:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-match</code> condition evaluates to true</p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-unmodified-since</code> condition evaluates to
- *                false</p>
- *             </li>
- *          </ul>
- *          <p>If both the <code>x-amz-copy-source-if-none-match</code> and
- *             <code>x-amz-copy-source-if-modified-since</code> headers are present in the request and
- *          evaluate as follows, Amazon S3 returns the <code>412 Precondition Failed</code> response
- *          code:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-none-match</code> condition evaluates to false</p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>x-amz-copy-source-if-modified-since</code> condition evaluates to
- *                true</p>
- *             </li>
- *          </ul>
- *          <note>
- *             <p>All headers with the <code>x-amz-</code> prefix, including
- *                <code>x-amz-copy-source</code>, must be signed.</p>
- *          </note>
- *          <p>
- *             <b>Server-side encryption</b>
- *          </p>
- *          <p>When you perform a CopyObject operation, you can optionally use the appropriate encryption-related
- *          headers to encrypt the object using server-side encryption with Amazon Web Services managed encryption keys
- *          (SSE-S3 or SSE-KMS) or a customer-provided encryption key. With server-side encryption, Amazon S3
- *          encrypts your data as it writes it to disks in its data centers and decrypts the data when
- *          you access it. For more information about server-side encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Using
- *          Server-Side Encryption</a>.</p>
- *          <p>If a target object uses SSE-KMS, you can enable an S3 Bucket Key for the object. For more
- *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p>
- *             <b>Access Control List (ACL)-Specific Request
- *          Headers</b>
- *          </p>
- *          <p>When copying an object, you can optionally use headers to grant ACL-based permissions.
- *          By default, all objects are private. Only the owner has full access control. When adding a
- *          new object, you can grant permissions to individual Amazon Web Services accounts or to predefined groups
- *          defined by Amazon S3. These permissions are then added to the ACL on the object. For more
- *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html">Managing ACLs Using the REST
- *             API</a>. </p>
- *          <p>If the bucket that you're copying objects to uses the bucket owner enforced setting for
- *          S3 Object Ownership, ACLs are disabled and no longer affect permissions. Buckets that
- *          use this setting only accept PUT requests that don't specify an ACL or PUT requests that
- *          specify bucket owner full control ACLs, such as the <code>bucket-owner-full-control</code> canned
- *          ACL or an equivalent form of this ACL expressed in the XML format.</p>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling ownership of
- *          objects and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <note>
- *             <p>If your bucket uses the bucket owner enforced setting for Object Ownership,
- *             all objects written to the bucket by any account will be owned by the bucket owner.</p>
- *          </note>
- *          <p>
- *             <b>Checksums</b>
- *          </p>
- *          <p>When copying an object, if it has a checksum, that checksum will be copied to the new object
- *            by default. When you copy the object over, you may optionally specify a different checksum
- *            algorithm to use with the <code>x-amz-checksum-algorithm</code> header.</p>
- *          <p>
- *             <b>Storage Class Options</b>
- *          </p>
- *          <p>You can use the <code>CopyObject</code> action to change the storage class of an
- *          object that is already stored in Amazon S3 using the <code>StorageClass</code> parameter. For
- *          more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html">Storage
- *             Classes</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p>
- *             <b>Versioning</b>
- *          </p>
- *          <p>By default, <code>x-amz-copy-source</code> identifies the current version of an object
- *          to copy. If the current version is a delete marker, Amazon S3 behaves as if the object was
- *          deleted. To copy a different version, use the <code>versionId</code> subresource.</p>
- *          <p>If you enable versioning on the target bucket, Amazon S3 generates a unique version ID for
- *          the object being copied. This version ID is different from the version ID of the source
- *          object. Amazon S3 returns the version ID of the copied object in the
- *             <code>x-amz-version-id</code> response header in the response.</p>
- *          <p>If you do not enable versioning or suspend it on the target bucket, the version ID that
- *          Amazon S3 generates is always null.</p>
- *          <p>If the source object's storage class is GLACIER, you must restore a copy of this object
- *          before you can use it as a source object for the copy operation. For more information, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>.</p>
+ *          <dl>
+ *             <dt>Metadata</dt>
+ *             <dd>
+ *                <p>When copying an object, you can preserve all metadata (default) or specify new metadata.
+ *                   However, the ACL is not preserved and is set to private for the user making the request. To
+ *                   override the default ACL setting, specify a new ACL when generating a copy request. For
+ *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. </p>
+ *                <p>To specify whether you want the object metadata copied from the source object or
+ *                      replaced with metadata provided in the request, you can optionally add the
+ *                      <code>x-amz-metadata-directive</code> header. When you grant permissions, you can use
+ *                      the <code>s3:x-amz-metadata-directive</code> condition key to enforce certain metadata
+ *                      behavior when objects are uploaded. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/amazon-s3-policy-keys.html">Specifying Conditions in a
+ *                         Policy</a> in the <i>Amazon S3 User Guide</i>. For a complete list of
+ *                      Amazon S3-specific condition keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, Resources, and Condition Keys for
+ *                         Amazon S3</a>.</p>
+ *                <note>
+ *                   <p>
+ *                      <code>x-amz-website-redirect-location</code> is unique to each object and must be
+ *                         specified in the request headers to copy the value.</p>
+ *                </note>
+ *             </dd>
+ *             <dt>x-amz-copy-source-if Headers</dt>
+ *             <dd>
+ *                <p>To only copy an object under certain conditions, such as whether the <code>Etag</code>
+ *                   matches or whether the object was modified before or after a specified date, use the
+ *                   following request parameters:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-match</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-none-match</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-unmodified-since</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-modified-since</code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *                <p> If both the <code>x-amz-copy-source-if-match</code> and
+ *                   <code>x-amz-copy-source-if-unmodified-since</code> headers are present in the request
+ *                   and evaluate as follows, Amazon S3 returns <code>200 OK</code> and copies the data:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-match</code> condition evaluates to true</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-unmodified-since</code> condition evaluates to
+ *                         false</p>
+ *                   </li>
+ *                </ul>
+ *                <p>If both the <code>x-amz-copy-source-if-none-match</code> and
+ *                   <code>x-amz-copy-source-if-modified-since</code> headers are present in the request and
+ *                   evaluate as follows, Amazon S3 returns the <code>412 Precondition Failed</code> response
+ *                   code:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-none-match</code> condition evaluates to false</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>x-amz-copy-source-if-modified-since</code> condition evaluates to
+ *                         true</p>
+ *                   </li>
+ *                </ul>
+ *                <note>
+ *                   <p>All headers with the <code>x-amz-</code> prefix, including
+ *                      <code>x-amz-copy-source</code>, must be signed.</p>
+ *                </note>
+ *             </dd>
+ *             <dt>Server-side encryption</dt>
+ *             <dd>
+ *                <p>Amazon S3 automatically encrypts all new objects that are copied to an S3 bucket. When
+ *                   copying an object, if you don't specify encryption information in your copy request, the
+ *                   encryption setting of the target object is set to the default encryption configuration of
+ *                   the destination bucket. By default, all buckets have a base level of encryption
+ *                   configuration that uses server-side encryption with Amazon S3 managed keys (SSE-S3). If the
+ *                   destination bucket has a default encryption configuration that uses server-side encryption
+ *                   with an Key Management Service (KMS) key (SSE-KMS), or a customer-provided encryption key (SSE-C),
+ *                   Amazon S3 uses the corresponding KMS key, or a customer-provided key to encrypt the target
+ *                   object copy.</p>
+ *                <p>When you perform a CopyObject operation, if you want to use a different type
+ *                   of encryption setting for the target object, you can use other appropriate
+ *                   encryption-related headers to encrypt the target object with a KMS key, an Amazon S3 managed
+ *                   key, or a customer-provided key. With server-side encryption, Amazon S3 encrypts your data as it
+ *                   writes it to disks in its data centers and decrypts the data when you access it. If the
+ *                   encryption setting in your request is different from the default encryption configuration
+ *                   of the destination bucket, the encryption setting in your request takes precedence. If the
+ *                   source object for the copy is stored in Amazon S3 using SSE-C, you must provide the necessary
+ *                   encryption information in your request so that Amazon S3 can decrypt the object for copying. For
+ *                   more information about server-side encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html">Using Server-Side
+ *                      Encryption</a>.</p>
+ *                <p>If a target object uses SSE-KMS, you can enable an S3 Bucket Key for the object. For
+ *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *             </dd>
+ *             <dt>Access Control List (ACL)-Specific Request
+ *                Headers</dt>
+ *             <dd>
+ *                <p>When copying an object, you can optionally use headers to grant ACL-based permissions.
+ *                   By default, all objects are private. Only the owner has full access control. When adding a
+ *                   new object, you can grant permissions to individual Amazon Web Services accounts or to predefined groups
+ *                   defined by Amazon S3. These permissions are then added to the ACL on the object. For more
+ *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html">Managing ACLs Using the REST
+ *                         API</a>. </p>
+ *                <p>If the bucket that you're copying objects to uses the bucket owner enforced setting for
+ *                   S3 Object Ownership, ACLs are disabled and no longer affect permissions. Buckets that use
+ *                   this setting only accept PUT requests that don't specify an ACL or PUT requests that
+ *                   specify bucket owner full control ACLs, such as the <code>bucket-owner-full-control</code>
+ *                   canned ACL or an equivalent form of this ACL expressed in the XML format.</p>
+ *                <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling ownership of
+ *                   objects and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <note>
+ *                   <p>If your bucket uses the bucket owner enforced setting for Object Ownership, all
+ *                      objects written to the bucket by any account will be owned by the bucket owner.</p>
+ *                </note>
+ *             </dd>
+ *             <dt>Checksums</dt>
+ *             <dd>
+ *                <p>When copying an object, if it has a checksum, that checksum will be copied to the new
+ *                   object by default. When you copy the object over, you may optionally specify a different
+ *                   checksum algorithm to use with the <code>x-amz-checksum-algorithm</code> header.</p>
+ *             </dd>
+ *             <dt>Storage Class Options</dt>
+ *             <dd>
+ *                <p>You can use the <code>CopyObject</code> action to change the storage class of an object
+ *                   that is already stored in Amazon S3 using the <code>StorageClass</code> parameter. For more
+ *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html">Storage Classes</a> in the
+ *                   <i>Amazon S3 User Guide</i>.</p>
+ *                <p>If the source object's storage class is GLACIER, you must restore a copy of
+ *                   this object before you can use it as a source object for the copy operation. For
+ *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. For
+ *                   more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html">Copying
+ *                   Objects</a>.</p>
+ *             </dd>
+ *             <dt>Versioning</dt>
+ *             <dd>
+ *                <p>By default, <code>x-amz-copy-source</code> identifies the current version of an object
+ *                   to copy. If the current version is a delete marker, Amazon S3 behaves as if the object was
+ *                   deleted. To copy a different version, use the <code>versionId</code> subresource.</p>
+ *                <p>If you enable versioning on the target bucket, Amazon S3 generates a unique version ID for
+ *                   the object being copied. This version ID is different from the version ID of the source
+ *                   object. Amazon S3 returns the version ID of the copied object in the
+ *                   <code>x-amz-version-id</code> response header in the response.</p>
+ *                <p>If you do not enable versioning or suspend it on the target bucket, the version ID that
+ *                   Amazon S3 generates is always null.</p>
+ *             </dd>
+ *          </dl>
  *          <p>The following operations are related to <code>CopyObject</code>:</p>
  *          <ul>
  *             <li>
@@ -201,8 +230,6 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *                </p>
  *             </li>
  *          </ul>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html">Copying
- *             Objects</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -256,6 +283,27 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  * };
  * const command = new CopyObjectCommand(input);
  * const response = await client.send(command);
+ * // { // CopyObjectOutput
+ * //   CopyObjectResult: { // CopyObjectResult
+ * //     ETag: "STRING_VALUE",
+ * //     LastModified: new Date("TIMESTAMP"),
+ * //     ChecksumCRC32: "STRING_VALUE",
+ * //     ChecksumCRC32C: "STRING_VALUE",
+ * //     ChecksumSHA1: "STRING_VALUE",
+ * //     ChecksumSHA256: "STRING_VALUE",
+ * //   },
+ * //   Expiration: "STRING_VALUE",
+ * //   CopySourceVersionId: "STRING_VALUE",
+ * //   VersionId: "STRING_VALUE",
+ * //   ServerSideEncryption: "AES256" || "aws:kms",
+ * //   SSECustomerAlgorithm: "STRING_VALUE",
+ * //   SSECustomerKeyMD5: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   SSEKMSEncryptionContext: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param CopyObjectCommandInput - {@link CopyObjectCommandInput}
@@ -268,6 +316,8 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *  <p>The source object of the COPY action is not in the active tier and is only stored in
  *          Amazon S3 Glacier.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To copy an object
  * ```javascript