@aws-sdk/client-s3 3.606.0 → 3.609.0

package/dist-cjs/index.js

@@ -2058,6 +2058,12 @@ var se_HeadObjectCommand = /* @__PURE__ */ __name(async (input, context) => {
   b.p("Bucket", () => input.Bucket, "{Bucket}", false);
   b.p("Key", () => input.Key, "{Key+}", true);
   const query = (0, import_smithy_client.map)({
+    [_rcc]: [, input[_RCC]],
+    [_rcd]: [, input[_RCD]],
+    [_rce]: [, input[_RCE]],
+    [_rcl]: [, input[_RCL]],
+    [_rct]: [, input[_RCT]],
+    [_re]: [() => input.ResponseExpires !== void 0, () => (0, import_smithy_client.dateToUtcString)(input[_RE]).toString()],
     [_vI]: [, input[_VI]],
     [_pN]: [() => input.PartNumber !== void 0, () => input[_PN].toString()]
   });
@@ -2129,15 +2135,12 @@ var se_ListBucketMetricsConfigurationsCommand = /* @__PURE__ */ __name(async (in
 }, "se_ListBucketMetricsConfigurationsCommand");
 var se_ListBucketsCommand = /* @__PURE__ */ __name(async (input, context) => {
   const b = (0, import_core2.requestBuilder)(input, context);
-  const headers = {
-    "content-type": "application/xml"
-  };
+  const headers = {};
   b.bp("/");
   const query = (0, import_smithy_client.map)({
     [_xi]: [, "ListBuckets"]
   });
   let body;
-  body = "";
   b.m("GET").h(headers).q(query).b(body);
   return b.build();
 }, "se_ListBucketsCommand");

package/dist-es/protocols/Aws_restXml.js

@@ -942,6 +942,12 @@ export const se_HeadObjectCommand = async (input, context) => {
     b.p("Bucket", () => input.Bucket, "{Bucket}", false);
     b.p("Key", () => input.Key, "{Key+}", true);
     const query = map({
+        [_rcc]: [, input[_RCC]],
+        [_rcd]: [, input[_RCD]],
+        [_rce]: [, input[_RCE]],
+        [_rcl]: [, input[_RCL]],
+        [_rct]: [, input[_RCT]],
+        [_re]: [() => input.ResponseExpires !== void 0, () => __dateToUtcString(input[_RE]).toString()],
         [_vI]: [, input[_VI]],
         [_pN]: [() => input.PartNumber !== void 0, () => input[_PN].toString()],
     });
@@ -1013,15 +1019,12 @@ export const se_ListBucketMetricsConfigurationsCommand = async (input, context)
 };
 export const se_ListBucketsCommand = async (input, context) => {
     const b = rb(input, context);
-    const headers = {
-        "content-type": "application/xml",
-    };
+    const headers = {};
     b.bp("/");
     const query = map({
         [_xi]: [, "ListBuckets"],
     });
     let body;
-    body = "";
     b.m("GET").h(headers).q(query).b(body);
     return b.build();
 };

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

@@ -121,10 +121,10 @@ declare const CopyObjectCommand_base: {
  *             </dd>
  *             <dt>Response and special errors</dt>
  *             <dd>
- *                <p>When the request is an HTTP 1.1 request, the response is chunk encoded.
- *                   When the request is not an HTTP 1.1 request, the response would not contain the <code>Content-Length</code>.
- *                   You always need to read the entire response body to check if the copy succeeds.
- *                   to keep the connection alive while we copy the data. </p>
+ *                <p>When the request is an HTTP 1.1 request, the response is chunk encoded. When
+ *                   the request is not an HTTP 1.1 request, the response would not contain the
+ *                      <code>Content-Length</code>. You always need to read the entire response body
+ *                   to check if the copy succeeds. </p>
  *                <ul>
  *                   <li>
  *                      <p>If the copy is successful, you receive a response with information about the copied

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

@@ -216,39 +216,39 @@ declare const CreateBucketCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @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
  * ```
  *
- * @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
  * ```
  *
  */

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

@@ -161,28 +161,28 @@ declare const DeleteObjectCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @example To delete an object (from a non-versioned bucket)
+ * @example To delete an object
  * ```javascript
- * // The following example deletes an object from a non-versioned bucket.
+ * // The following example deletes an object from an S3 bucket.
  * const input = {
- *   "Bucket": "ExampleBucket",
- *   "Key": "HappyFace.jpg"
+ *   "Bucket": "examplebucket",
+ *   "Key": "objectkey.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
+ * // example id: to-delete-an-object-1472850136595
  * ```
  *
- * @example To delete an object
+ * @example To delete an object (from a non-versioned bucket)
  * ```javascript
- * // The following example deletes an object from an S3 bucket.
+ * // The following example deletes an object from a non-versioned bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "Key": "objectkey.jpg"
+ *   "Bucket": "ExampleBucket",
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-1472850136595
+ * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
  * ```
  *
  */

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

@@ -80,39 +80,39 @@ declare const DeleteObjectTaggingCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @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
  * ```
  *
- * @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
  * ```
  *
  */

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

@@ -86,7 +86,7 @@ declare const DeleteObjectsCommand_base: {
  *                            <p>
  *                               <b>
  *                                  <code>s3:DeleteObjectVersion</code>
- *                               </b> - To delete a specific version of an object from a versiong-enabled bucket, you must specify the <code>s3:DeleteObjectVersion</code> permission.</p>
+ *                               </b> - To delete a specific version of an object from a versioning-enabled bucket, you must specify the <code>s3:DeleteObjectVersion</code> permission.</p>
  *                         </li>
  *                      </ul>
  *                   </li>

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

@@ -276,53 +276,53 @@ declare const GetObjectCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @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
  * ```
  *
- * @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
  * ```
  *
  */

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

@@ -96,12 +96,13 @@ declare const GetObjectTaggingCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @example To retrieve tag set of an object
+ * @example To retrieve tag set of a specific object version
  * ```javascript
- * // The following example retrieves tag set of an object.
+ * // The following example retrieves tag set of an object. The request specifies object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "exampleobject",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * };
  * const command = new GetObjectTaggingCommand(input);
  * const response = await client.send(command);
@@ -109,27 +110,22 @@ declare const GetObjectTaggingCommand_base: {
  * {
  *   "TagSet": [
  *     {
- *       "Key": "Key4",
- *       "Value": "Value4"
- *     },
- *     {
- *       "Key": "Key3",
- *       "Value": "Value3"
+ *       "Key": "Key1",
+ *       "Value": "Value1"
  *     }
  *   ],
- *   "VersionId": "null"
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * }
  * *\/
- * // example id: to-retrieve-tag-set-of-an-object-1481833847896
+ * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
  * ```
  *
- * @example To retrieve tag set of a specific object version
+ * @example To retrieve tag set of an object
  * ```javascript
- * // The following example retrieves tag set of an object. The request specifies object version.
+ * // The following example retrieves tag set of an object.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new GetObjectTaggingCommand(input);
  * const response = await client.send(command);
@@ -137,14 +133,18 @@ declare const GetObjectTaggingCommand_base: {
  * {
  *   "TagSet": [
  *     {
- *       "Key": "Key1",
- *       "Value": "Value1"
+ *       "Key": "Key4",
+ *       "Value": "Value4"
+ *     },
+ *     {
+ *       "Key": "Key3",
+ *       "Value": "Value3"
  *     }
  *   ],
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
+ * // example id: to-retrieve-tag-set-of-an-object-1481833847896
  * ```
  *
  */

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

@@ -176,6 +176,12 @@ declare const HeadObjectCommand_base: {
  *   IfUnmodifiedSince: new Date("TIMESTAMP"),
  *   Key: "STRING_VALUE", // required
  *   Range: "STRING_VALUE",
+ *   ResponseCacheControl: "STRING_VALUE",
+ *   ResponseContentDisposition: "STRING_VALUE",
+ *   ResponseContentEncoding: "STRING_VALUE",
+ *   ResponseContentLanguage: "STRING_VALUE",
+ *   ResponseContentType: "STRING_VALUE",
+ *   ResponseExpires: new Date("TIMESTAMP"),
  *   VersionId: "STRING_VALUE",
  *   SSECustomerAlgorithm: "STRING_VALUE",
  *   SSECustomerKey: "STRING_VALUE",

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

@@ -234,56 +234,55 @@ declare const PutObjectCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @example To upload an object and specify server-side encryption and object tags
+ * @example To upload an object and specify canned ACL.
  * ```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.
+ * // 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.
  * const input = {
+ *   "ACL": "authenticated-read",
  *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
- *   "ServerSideEncryption": "AES256",
- *   "Tagging": "key1=value1&key2=value2"
+ *   "Key": "exampleobject"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
+ *   "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
+ * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
  * ```
  *
- * @example To create an object.
+ * @example To upload an object and specify optional tags
  * ```javascript
- * // The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+ * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
  * const input = {
- *   "Body": "filetoupload",
+ *   "Body": "c:\\HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "objectkey"
+ *   "Key": "HappyFace.jpg",
+ *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
+ *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
  * }
  * *\/
- * // example id: to-create-an-object-1483147613675
+ * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
  * ```
  *
- * @example To upload an object (specify optional headers)
+ * @example To upload an object and specify server-side encryption and object tags
  * ```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. 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.
  * const input = {
- *   "Body": "HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
+ *   "Key": "exampleobject",
  *   "ServerSideEncryption": "AES256",
- *   "StorageClass": "STANDARD_IA"
+ *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
@@ -291,92 +290,93 @@ declare const PutObjectCommand_base: {
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
  *   "ServerSideEncryption": "AES256",
- *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+ *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
  * }
  * *\/
- * // example id: to-upload-an-object-(specify-optional-headers)
+ * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
  * ```
  *
- * @example To upload an object and specify optional tags
+ * @example To upload an object
  * ```javascript
- * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
+ * // 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": "c:\\HappyFace.jpg",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "Tagging": "key1=value1&key2=value2"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
+ *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
+ * // example id: to-upload-an-object-1481760101010
  * ```
  *
- * @example To upload object and specify user-defined metadata
+ * @example To create an object.
  * ```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 creates an object. 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"
- *   }
+ *   "Key": "objectkey"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
+ *   "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
  * }
  * *\/
- * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
+ * // example id: to-create-an-object-1483147613675
  * ```
  *
- * @example To upload an object and specify canned ACL.
+ * @example To upload an object (specify optional headers)
  * ```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.
+ * // 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 = {
- *   "ACL": "authenticated-read",
- *   "Body": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject"
+ *   "Key": "HappyFace.jpg",
+ *   "ServerSideEncryption": "AES256",
+ *   "StorageClass": "STANDARD_IA"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
+ *   "ServerSideEncryption": "AES256",
+ *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
+ * // example id: to-upload-an-object-(specify-optional-headers)
  * ```
  *
- * @example To upload an object
+ * @example To upload object and specify user-defined metadata
  * ```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.
+ * // 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": "HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "exampleobject",
+ *   "Metadata": {
+ *     "metadata1": "value1",
+ *     "metadata2": "value2"
+ *   }
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
+ *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
  * }
  * *\/
- * // example id: to-upload-an-object-1481760101010
+ * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
  * ```
  *
  */

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

@@ -83,7 +83,7 @@ declare const UploadPartCopyCommand_base: {
  *                         </li>
  *                      </ul>
  *                      <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> in the
+ *                         <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/mpuoverview.html#mpuAndPermissions">Multipart upload API and permissions</a> in the
  *                         <i>Amazon S3 User Guide</i>.</p>
  *                   </li>
  *                   <li>
@@ -97,9 +97,11 @@ declare const UploadPartCopyCommand_base: {
  *                               directory bucket, you must have the <b>
  *                                  <code>s3express:CreateSession</code>
  *                               </b> permission in
- *                               the <code>Action</code> element of a policy to read the object
- *                               .
- *                               By default, the session is in the <code>ReadWrite</code> mode. If you want to restrict the access, you can explicitly set the <code>s3express:SessionMode</code> condition key to <code>ReadOnly</code> on the copy source bucket.</p>
+ *                               the <code>Action</code> element of a policy to read the object. By
+ *                               default, the session is in the <code>ReadWrite</code> mode. If you
+ *                               want to restrict the access, you can explicitly set the
+ *                                  <code>s3express:SessionMode</code> condition key to
+ *                                  <code>ReadOnly</code> on the copy source bucket.</p>
  *                         </li>
  *                         <li>
  *                            <p>If the copy destination is a directory bucket, you must have the
@@ -264,14 +266,15 @@ declare const UploadPartCopyCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @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);
@@ -279,23 +282,22 @@ declare const UploadPartCopyCommand_base: {
  * /* 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
  * ```
  *
- * @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);
@@ -303,12 +305,12 @@ declare const UploadPartCopyCommand_base: {
  * /* 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
  * ```
  *
  */

package/dist-types/models/models_0.d.ts

@@ -2621,7 +2621,7 @@ export interface SessionCredentials {
  */
 export interface CreateSessionOutput {
     /**
-     * <p>The established temporary security credentials  for the created session..</p>
+     * <p>The established temporary security credentials for the created session.</p>
      * @public
      */
     Credentials: SessionCredentials | undefined;
@@ -6315,9 +6315,9 @@ export interface NoncurrentVersionExpiration {
      */
     NoncurrentDays?: number;
     /**
-     * <p>Specifies how many newer noncurrent versions must exist before Amazon S3 can perform the
-     *          associated action on a given version. If there are this many more recent noncurrent
-     *          versions, Amazon S3 will take the associated action. For more information about noncurrent
+     * <p>Specifies how many noncurrent versions Amazon S3 will retain. You can specify up to 100
+     *          noncurrent versions to retain. Amazon S3 will permanently delete any additional noncurrent
+     *          versions beyond the specified number to retain. For more information about noncurrent
      *          versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
      *             elements</a> in the <i>Amazon S3 User Guide</i>.</p>
      * @public
@@ -6366,10 +6366,10 @@ export interface NoncurrentVersionTransition {
      */
     StorageClass?: TransitionStorageClass;
     /**
-     * <p>Specifies how many newer noncurrent versions must exist before Amazon S3 can perform the
-     *          associated action on a given version. If there are this many more recent noncurrent
-     *          versions, Amazon S3 will take the associated action. For more information about noncurrent
-     *          versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
+     * <p>Specifies how many noncurrent versions Amazon S3 will retain in the same storage class before
+     *          transitioning objects. You can specify up to 100 noncurrent versions to retain. Amazon S3 will
+     *          transition any additional noncurrent versions beyond the specified number to retain. For
+     *          more information about noncurrent versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
      *             elements</a> in the <i>Amazon S3 User Guide</i>.</p>
      * @public
      */
@@ -7959,10 +7959,11 @@ export interface ErrorDocument {
  */
 export interface IndexDocument {
     /**
-     * <p>A suffix that is appended to a request that is for a directory on the website endpoint
-     *          (for example,if the suffix is index.html and you make a request to samplebucket/images/ the
-     *          data that is returned will be for the object with the key name images/index.html) The
-     *          suffix must not be empty and must not include a slash character.</p>
+     * <p>A suffix that is appended to a request that is for a directory on the website endpoint.
+     *          (For example, if the suffix is <code>index.html</code> and you make a request to
+     *             <code>samplebucket/images/</code>, the data that is returned will be for the object with
+     *          the key name <code>images/index.html</code>.) The suffix must not be empty and must not
+     *          include a slash character.</p>
      *          <important>
      *             <p>Replacement must be made for object keys containing special characters (such as carriage returns) when using
      *          XML requests. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints">
@@ -10179,6 +10180,36 @@ export interface HeadObjectRequest {
      * @public
      */
     Range?: string;
+    /**
+     * <p>Sets the <code>Cache-Control</code> header of the response.</p>
+     * @public
+     */
+    ResponseCacheControl?: string;
+    /**
+     * <p>Sets the <code>Content-Disposition</code> header of the response.</p>
+     * @public
+     */
+    ResponseContentDisposition?: string;
+    /**
+     * <p>Sets the <code>Content-Encoding</code> header of the response.</p>
+     * @public
+     */
+    ResponseContentEncoding?: string;
+    /**
+     * <p>Sets the <code>Content-Language</code> header of the response.</p>
+     * @public
+     */
+    ResponseContentLanguage?: string;
+    /**
+     * <p>Sets the <code>Content-Type</code> header of the response.</p>
+     * @public
+     */
+    ResponseContentType?: string;
+    /**
+     * <p>Sets the <code>Expires</code> header of the response.</p>
+     * @public
+     */
+    ResponseExpires?: Date;
     /**
      * <p>Version ID used to reference a specific version of the object.</p>
      *          <note>
@@ -11101,7 +11132,8 @@ export interface ListObjectsOutput {
     /**
      * <p>Encoding type used by Amazon S3 to encode object keys in the response. If using
      *             <code>url</code>, non-ASCII characters used in an object's key name will be URL encoded.
-     *          For example, the object test_file(3).png will appear as test_file%283%29.png.</p>
+     *          For example, the object <code>test_file(3).png</code> will appear as
+     *             <code>test_file%283%29.png</code>.</p>
      * @public
      */
     EncodingType?: EncodingType;
@@ -11383,8 +11415,9 @@ export interface ListObjectsV2Request {
     Delimiter?: string;
     /**
      * <p>Encoding type used by Amazon S3 to encode object keys in the response. If using
-     *          <code>url</code>, non-ASCII characters used in an object's key name will be URL encoded.
-     *          For example, the object test_file(3).png will appear as test_file%283%29.png.</p>
+     *             <code>url</code>, non-ASCII characters used in an object's key name will be URL encoded.
+     *          For example, the object <code>test_file(3).png</code> will appear as
+     *             <code>test_file%283%29.png</code>.</p>
      * @public
      */
     EncodingType?: EncodingType;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -1670,6 +1670,12 @@ export interface HeadObjectRequest {
   IfUnmodifiedSince?: Date;
   Key: string | undefined;
   Range?: string;
+  ResponseCacheControl?: string;
+  ResponseContentDisposition?: string;
+  ResponseContentEncoding?: string;
+  ResponseContentLanguage?: string;
+  ResponseContentType?: string;
+  ResponseExpires?: Date;
   VersionId?: string;
   SSECustomerAlgorithm?: string;
   SSECustomerKey?: string;

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.606.0",
+  "version": "3.609.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-s3",
@@ -26,64 +26,64 @@
     "@aws-crypto/sha1-browser": "5.2.0",
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/client-sso-oidc": "3.606.0",
-    "@aws-sdk/client-sts": "3.606.0",
-    "@aws-sdk/core": "3.598.0",
-    "@aws-sdk/credential-provider-node": "3.600.0",
-    "@aws-sdk/middleware-bucket-endpoint": "3.598.0",
-    "@aws-sdk/middleware-expect-continue": "3.598.0",
-    "@aws-sdk/middleware-flexible-checksums": "3.598.0",
-    "@aws-sdk/middleware-host-header": "3.598.0",
-    "@aws-sdk/middleware-location-constraint": "3.598.0",
-    "@aws-sdk/middleware-logger": "3.598.0",
-    "@aws-sdk/middleware-recursion-detection": "3.598.0",
-    "@aws-sdk/middleware-sdk-s3": "3.598.0",
-    "@aws-sdk/middleware-signing": "3.598.0",
-    "@aws-sdk/middleware-ssec": "3.598.0",
-    "@aws-sdk/middleware-user-agent": "3.598.0",
-    "@aws-sdk/region-config-resolver": "3.598.0",
-    "@aws-sdk/signature-v4-multi-region": "3.598.0",
-    "@aws-sdk/types": "3.598.0",
-    "@aws-sdk/util-endpoints": "3.598.0",
-    "@aws-sdk/util-user-agent-browser": "3.598.0",
-    "@aws-sdk/util-user-agent-node": "3.598.0",
-    "@aws-sdk/xml-builder": "3.598.0",
-    "@smithy/config-resolver": "^3.0.2",
-    "@smithy/core": "^2.2.1",
-    "@smithy/eventstream-serde-browser": "^3.0.2",
-    "@smithy/eventstream-serde-config-resolver": "^3.0.1",
-    "@smithy/eventstream-serde-node": "^3.0.2",
-    "@smithy/fetch-http-handler": "^3.0.2",
-    "@smithy/hash-blob-browser": "^3.1.0",
-    "@smithy/hash-node": "^3.0.1",
-    "@smithy/hash-stream-node": "^3.1.0",
-    "@smithy/invalid-dependency": "^3.0.1",
-    "@smithy/md5-js": "^3.0.1",
-    "@smithy/middleware-content-length": "^3.0.1",
-    "@smithy/middleware-endpoint": "^3.0.2",
-    "@smithy/middleware-retry": "^3.0.4",
-    "@smithy/middleware-serde": "^3.0.1",
-    "@smithy/middleware-stack": "^3.0.1",
-    "@smithy/node-config-provider": "^3.1.1",
-    "@smithy/node-http-handler": "^3.0.1",
-    "@smithy/protocol-http": "^4.0.1",
-    "@smithy/smithy-client": "^3.1.2",
-    "@smithy/types": "^3.1.0",
-    "@smithy/url-parser": "^3.0.1",
+    "@aws-sdk/client-sso-oidc": "3.609.0",
+    "@aws-sdk/client-sts": "3.609.0",
+    "@aws-sdk/core": "3.609.0",
+    "@aws-sdk/credential-provider-node": "3.609.0",
+    "@aws-sdk/middleware-bucket-endpoint": "3.609.0",
+    "@aws-sdk/middleware-expect-continue": "3.609.0",
+    "@aws-sdk/middleware-flexible-checksums": "3.609.0",
+    "@aws-sdk/middleware-host-header": "3.609.0",
+    "@aws-sdk/middleware-location-constraint": "3.609.0",
+    "@aws-sdk/middleware-logger": "3.609.0",
+    "@aws-sdk/middleware-recursion-detection": "3.609.0",
+    "@aws-sdk/middleware-sdk-s3": "3.609.0",
+    "@aws-sdk/middleware-signing": "3.609.0",
+    "@aws-sdk/middleware-ssec": "3.609.0",
+    "@aws-sdk/middleware-user-agent": "3.609.0",
+    "@aws-sdk/region-config-resolver": "3.609.0",
+    "@aws-sdk/signature-v4-multi-region": "3.609.0",
+    "@aws-sdk/types": "3.609.0",
+    "@aws-sdk/util-endpoints": "3.609.0",
+    "@aws-sdk/util-user-agent-browser": "3.609.0",
+    "@aws-sdk/util-user-agent-node": "3.609.0",
+    "@aws-sdk/xml-builder": "3.609.0",
+    "@smithy/config-resolver": "^3.0.4",
+    "@smithy/core": "^2.2.4",
+    "@smithy/eventstream-serde-browser": "^3.0.4",
+    "@smithy/eventstream-serde-config-resolver": "^3.0.3",
+    "@smithy/eventstream-serde-node": "^3.0.4",
+    "@smithy/fetch-http-handler": "^3.2.0",
+    "@smithy/hash-blob-browser": "^3.1.2",
+    "@smithy/hash-node": "^3.0.3",
+    "@smithy/hash-stream-node": "^3.1.2",
+    "@smithy/invalid-dependency": "^3.0.3",
+    "@smithy/md5-js": "^3.0.3",
+    "@smithy/middleware-content-length": "^3.0.3",
+    "@smithy/middleware-endpoint": "^3.0.4",
+    "@smithy/middleware-retry": "^3.0.7",
+    "@smithy/middleware-serde": "^3.0.3",
+    "@smithy/middleware-stack": "^3.0.3",
+    "@smithy/node-config-provider": "^3.1.3",
+    "@smithy/node-http-handler": "^3.1.1",
+    "@smithy/protocol-http": "^4.0.3",
+    "@smithy/smithy-client": "^3.1.5",
+    "@smithy/types": "^3.3.0",
+    "@smithy/url-parser": "^3.0.3",
     "@smithy/util-base64": "^3.0.0",
     "@smithy/util-body-length-browser": "^3.0.0",
     "@smithy/util-body-length-node": "^3.0.0",
-    "@smithy/util-defaults-mode-browser": "^3.0.4",
-    "@smithy/util-defaults-mode-node": "^3.0.4",
-    "@smithy/util-endpoints": "^2.0.2",
-    "@smithy/util-retry": "^3.0.1",
-    "@smithy/util-stream": "^3.0.2",
+    "@smithy/util-defaults-mode-browser": "^3.0.7",
+    "@smithy/util-defaults-mode-node": "^3.0.7",
+    "@smithy/util-endpoints": "^2.0.4",
+    "@smithy/util-retry": "^3.0.3",
+    "@smithy/util-stream": "^3.0.5",
     "@smithy/util-utf8": "^3.0.0",
-    "@smithy/util-waiter": "^3.0.1",
+    "@smithy/util-waiter": "^3.1.2",
     "tslib": "^2.6.2"
   },
   "devDependencies": {
-    "@aws-sdk/signature-v4-crt": "3.598.0",
+    "@aws-sdk/signature-v4-crt": "3.609.0",
     "@tsconfig/node16": "16.1.3",
     "@types/chai": "^4.2.11",
     "@types/mocha": "^8.0.4",