@aws-sdk/client-s3 3.420.0 → 3.421.0

package/README.md

@@ -23,16 +23,16 @@ using your favorite package manager:
 
 The AWS SDK is modulized by clients and commands.
 To send a request, you only need to import the `S3Client` and
-the commands you need, for example `AbortMultipartUploadCommand`:
+the commands you need, for example `ListBucketsCommand`:
 
 ```js
 // ES5 example
-const { S3Client, AbortMultipartUploadCommand } = require("@aws-sdk/client-s3");
+const { S3Client, ListBucketsCommand } = require("@aws-sdk/client-s3");
 ```
 
 ```ts
 // ES6+ example
-import { S3Client, AbortMultipartUploadCommand } from "@aws-sdk/client-s3";
+import { S3Client, ListBucketsCommand } from "@aws-sdk/client-s3";
 ```
 
 ### Usage
@@ -51,7 +51,7 @@ const client = new S3Client({ region: "REGION" });
 const params = {
   /** input parameters */
 };
-const command = new AbortMultipartUploadCommand(params);
+const command = new ListBucketsCommand(params);
 ```
 
 #### Async/await
@@ -130,7 +130,7 @@ const client = new AWS.S3({ region: "REGION" });
 
 // async/await.
 try {
-  const data = await client.abortMultipartUpload(params);
+  const data = await client.listBuckets(params);
   // process data.
 } catch (error) {
   // error handling.
@@ -138,7 +138,7 @@ try {
 
 // Promises.
 client
-  .abortMultipartUpload(params)
+  .listBuckets(params)
   .then((data) => {
     // process data.
   })
@@ -147,7 +147,7 @@ client
   });
 
 // callbacks.
-client.abortMultipartUpload(params, (err, data) => {
+client.listBuckets(params, (err, data) => {
   // process err and data.
 });
 ```

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

@@ -181,39 +181,39 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To create a bucket in a specific region
+ * @example To create a bucket
  * ```javascript
- * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
+ * // The following example creates a bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "CreateBucketConfiguration": {
- *     "LocationConstraint": "eu-west-1"
- *   }
+ *   "Bucket": "examplebucket"
  * };
  * const command = new CreateBucketCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
+ *   "Location": "/examplebucket"
  * }
  * *\/
- * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
+ * // example id: to-create-a-bucket--1472851826060
  * ```
  *
- * @example To create a bucket
+ * @example To create a bucket in a specific region
  * ```javascript
- * // The following example creates a bucket.
+ * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
  * const input = {
- *   "Bucket": "examplebucket"
+ *   "Bucket": "examplebucket",
+ *   "CreateBucketConfiguration": {
+ *     "LocationConstraint": "eu-west-1"
+ *   }
  * };
  * const command = new CreateBucketCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "Location": "/examplebucket"
+ *   "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
  * }
  * *\/
- * // example id: to-create-a-bucket--1472851826060
+ * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
  * ```
  *
  */

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

@@ -72,39 +72,39 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To remove tag set from an object
+ * @example To remove tag set from an object version
  * ```javascript
- * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
+ * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "HappyFace.jpg",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "null"
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-1483145342862
+ * // example id: to-remove-tag-set-from-an-object-version-1483145285913
  * ```
  *
- * @example To remove tag set from an object version
+ * @example To remove tag set from an object
  * ```javascript
- * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
+ * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-version-1483145285913
+ * // example id: to-remove-tag-set-from-an-object-1483145342862
  * ```
  *
  */

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

@@ -287,53 +287,53 @@ export interface GetObjectCommandOutput extends Omit<GetObjectOutput, "Body">, _
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To retrieve an object
+ * @example To retrieve a byte range of an object
  * ```javascript
- * // The following example retrieves an object for an S3 bucket.
+ * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "SampleFile.txt",
+ *   "Range": "bytes=0-9"
  * };
  * const command = new GetObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "AcceptRanges": "bytes",
- *   "ContentLength": "3191",
- *   "ContentType": "image/jpeg",
- *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
+ *   "ContentLength": "10",
+ *   "ContentRange": "bytes 0-9/43",
+ *   "ContentType": "text/plain",
+ *   "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
+ *   "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
  *   "Metadata": {},
- *   "TagCount": 2,
  *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-an-object-1481827837012
+ * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
  * ```
  *
- * @example To retrieve a byte range of an object
+ * @example To retrieve an object
  * ```javascript
- * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
+ * // The following example retrieves an object for an S3 bucket.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "SampleFile.txt",
- *   "Range": "bytes=0-9"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new GetObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "AcceptRanges": "bytes",
- *   "ContentLength": "10",
- *   "ContentRange": "bytes 0-9/43",
- *   "ContentType": "text/plain",
- *   "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
- *   "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
+ *   "ContentLength": "3191",
+ *   "ContentType": "image/jpeg",
+ *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
+ *   "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
  *   "Metadata": {},
+ *   "TagCount": 2,
  *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
+ * // example id: to-retrieve-an-object-1481827837012
  * ```
  *
  */

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

@@ -135,104 +135,104 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example List next set of multipart uploads when previous result is truncated
+ * @example To list in-progress multipart uploads on a bucket
  * ```javascript
- * // The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next setup of multipart uploads.
+ * // The following example lists in-progress multipart uploads on a specific bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "KeyMarker": "nextkeyfrompreviousresponse",
- *   "MaxUploads": "2",
- *   "UploadIdMarker": "valuefrompreviousresponse"
+ *   "Bucket": "examplebucket"
  * };
  * const command = new ListMultipartUploadsCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "Bucket": "acl1",
- *   "IsTruncated": true,
- *   "KeyMarker": "",
- *   "MaxUploads": "2",
- *   "NextKeyMarker": "someobjectkey",
- *   "NextUploadIdMarker": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
- *   "UploadIdMarker": "",
  *   "Uploads": [
  *     {
  *       "Initiated": "2014-05-01T05:40:58.000Z",
  *       "Initiator": {
- *         "DisplayName": "ownder-display-name",
+ *         "DisplayName": "display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "Key": "JavaFile",
  *       "Owner": {
- *         "DisplayName": "mohanataws",
- *         "ID": "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
+ *         "DisplayName": "display-name",
+ *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "StorageClass": "STANDARD",
- *       "UploadId": "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
+ *       "UploadId": "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
  *     },
  *     {
  *       "Initiated": "2014-05-01T05:41:27.000Z",
  *       "Initiator": {
- *         "DisplayName": "ownder-display-name",
+ *         "DisplayName": "display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "Key": "JavaFile",
  *       "Owner": {
- *         "DisplayName": "ownder-display-name",
+ *         "DisplayName": "display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "StorageClass": "STANDARD",
- *       "UploadId": "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
+ *       "UploadId": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
  *     }
  *   ]
  * }
  * *\/
- * // example id: list-next-set-of-multipart-uploads-when-previous-result-is-truncated-1482428106748
+ * // example id: to-list-in-progress-multipart-uploads-on-a-bucket-1481852775260
  * ```
  *
- * @example To list in-progress multipart uploads on a bucket
+ * @example List next set of multipart uploads when previous result is truncated
  * ```javascript
- * // The following example lists in-progress multipart uploads on a specific bucket.
+ * // The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next setup of multipart uploads.
  * const input = {
- *   "Bucket": "examplebucket"
+ *   "Bucket": "examplebucket",
+ *   "KeyMarker": "nextkeyfrompreviousresponse",
+ *   "MaxUploads": "2",
+ *   "UploadIdMarker": "valuefrompreviousresponse"
  * };
  * const command = new ListMultipartUploadsCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
+ *   "Bucket": "acl1",
+ *   "IsTruncated": true,
+ *   "KeyMarker": "",
+ *   "MaxUploads": "2",
+ *   "NextKeyMarker": "someobjectkey",
+ *   "NextUploadIdMarker": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
+ *   "UploadIdMarker": "",
  *   "Uploads": [
  *     {
  *       "Initiated": "2014-05-01T05:40:58.000Z",
  *       "Initiator": {
- *         "DisplayName": "display-name",
+ *         "DisplayName": "ownder-display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "Key": "JavaFile",
  *       "Owner": {
- *         "DisplayName": "display-name",
- *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
+ *         "DisplayName": "mohanataws",
+ *         "ID": "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "StorageClass": "STANDARD",
- *       "UploadId": "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
+ *       "UploadId": "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
  *     },
  *     {
  *       "Initiated": "2014-05-01T05:41:27.000Z",
  *       "Initiator": {
- *         "DisplayName": "display-name",
+ *         "DisplayName": "ownder-display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "Key": "JavaFile",
  *       "Owner": {
- *         "DisplayName": "display-name",
+ *         "DisplayName": "ownder-display-name",
  *         "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
  *       },
  *       "StorageClass": "STANDARD",
- *       "UploadId": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
+ *       "UploadId": "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
  *     }
  *   ]
  * }
  * *\/
- * // example id: to-list-in-progress-multipart-uploads-on-a-bucket-1481852775260
+ * // example id: list-next-set-of-multipart-uploads-when-previous-result-is-truncated-1482428106748
  * ```
  *
  */

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

@@ -192,25 +192,6 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To upload an object
- * ```javascript
- * // The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.
- * const input = {
- *   "Body": "HappyFace.jpg",
- *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
- * };
- * const command = new PutObjectCommand(input);
- * const response = await client.send(command);
- * /* response ==
- * {
- *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
- * }
- * *\/
- * // example id: to-upload-an-object-1481760101010
- * ```
- *
  * @example To upload an object and specify server-side encryption and object tags
  * ```javascript
  * // The following example uploads an object. The request specifies the optional server-side encryption option. The request also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
@@ -252,27 +233,26 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * // example id: to-create-an-object-1483147613675
  * ```
  *
- * @example To upload object and specify user-defined metadata
+ * @example To upload an object (specify optional headers)
  * ```javascript
- * // The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.
+ * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
  * const input = {
- *   "Body": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
- *   "Metadata": {
- *     "metadata1": "value1",
- *     "metadata2": "value2"
- *   }
+ *   "Key": "HappyFace.jpg",
+ *   "ServerSideEncryption": "AES256",
+ *   "StorageClass": "STANDARD_IA"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
+ *   "ServerSideEncryption": "AES256",
+ *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
  * }
  * *\/
- * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
+ * // example id: to-upload-an-object-(specify-optional-headers)
  * ```
  *
  * @example To upload an object and specify optional tags
@@ -295,6 +275,29 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
  * ```
  *
+ * @example To upload object and specify user-defined metadata
+ * ```javascript
+ * // The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.
+ * const input = {
+ *   "Body": "filetoupload",
+ *   "Bucket": "examplebucket",
+ *   "Key": "exampleobject",
+ *   "Metadata": {
+ *     "metadata1": "value1",
+ *     "metadata2": "value2"
+ *   }
+ * };
+ * const command = new PutObjectCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
+ *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
+ * }
+ * *\/
+ * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
+ * ```
+ *
  * @example To upload an object and specify canned ACL.
  * ```javascript
  * // The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
@@ -315,26 +318,23 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
  * ```
  *
- * @example To upload an object (specify optional headers)
+ * @example To upload an object
  * ```javascript
- * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
+ * // The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.
  * const input = {
  *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "ServerSideEncryption": "AES256",
- *   "StorageClass": "STANDARD_IA"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+ *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
  * }
  * *\/
- * // example id: to-upload-an-object-(specify-optional-headers)
+ * // example id: to-upload-an-object-1481760101010
  * ```
  *
  */

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

@@ -252,15 +252,14 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To upload a part by copying byte range from an existing object as data source
+ * @example To upload a part by copying data from an existing object as data source
  * ```javascript
- * // The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.
+ * // The following example uploads a part of a multipart upload by copying data from an existing object as data source.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "CopySource": "/bucketname/sourceobjectkey",
- *   "CopySourceRange": "bytes=1-100000",
  *   "Key": "examplelargeobject",
- *   "PartNumber": "2",
+ *   "PartNumber": "1",
  *   "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
  * };
  * const command = new UploadPartCopyCommand(input);
@@ -268,22 +267,23 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
  * /* response ==
  * {
  *   "CopyPartResult": {
- *     "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
- *     "LastModified": "2016-12-29T21:44:28.000Z"
+ *     "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
+ *     "LastModified": "2016-12-29T21:24:43.000Z"
  *   }
  * }
  * *\/
- * // example id: to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594
+ * // example id: to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348
  * ```
  *
- * @example To upload a part by copying data from an existing object as data source
+ * @example To upload a part by copying byte range from an existing object as data source
  * ```javascript
- * // The following example uploads a part of a multipart upload by copying data from an existing object as data source.
+ * // The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "CopySource": "/bucketname/sourceobjectkey",
+ *   "CopySourceRange": "bytes=1-100000",
  *   "Key": "examplelargeobject",
- *   "PartNumber": "1",
+ *   "PartNumber": "2",
  *   "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
  * };
  * const command = new UploadPartCopyCommand(input);
@@ -291,12 +291,12 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
  * /* response ==
  * {
  *   "CopyPartResult": {
- *     "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
- *     "LastModified": "2016-12-29T21:24:43.000Z"
+ *     "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
+ *     "LastModified": "2016-12-29T21:44:28.000Z"
  *   }
  * }
  * *\/
- * // example id: to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348
+ * // example id: to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594
  * ```
  *
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-s3",
   "description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native",
-  "version": "3.420.0",
+  "version": "3.421.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -25,8 +25,8 @@
     "@aws-crypto/sha1-browser": "3.0.0",
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.418.0",
-    "@aws-sdk/credential-provider-node": "3.418.0",
+    "@aws-sdk/client-sts": "3.421.0",
+    "@aws-sdk/credential-provider-node": "3.421.0",
     "@aws-sdk/middleware-bucket-endpoint": "3.418.0",
     "@aws-sdk/middleware-expect-continue": "3.418.0",
     "@aws-sdk/middleware-flexible-checksums": "3.418.0",