@aws-sdk/client-s3 3.369.0 → 3.373.0

package/dist-cjs/models/models_0.js

@@ -143,6 +143,7 @@ exports.BucketLocationConstraint = {
     ap_northeast_2: "ap-northeast-2",
     ap_northeast_3: "ap-northeast-3",
     ap_south_1: "ap-south-1",
+    ap_south_2: "ap-south-2",
     ap_southeast_1: "ap-southeast-1",
     ap_southeast_2: "ap-southeast-2",
     ap_southeast_3: "ap-southeast-3",
@@ -152,6 +153,7 @@ exports.BucketLocationConstraint = {
     eu_central_1: "eu-central-1",
     eu_north_1: "eu-north-1",
     eu_south_1: "eu-south-1",
+    eu_south_2: "eu-south-2",
     eu_west_1: "eu-west-1",
     eu_west_2: "eu-west-2",
     eu_west_3: "eu-west-3",
@@ -211,9 +213,11 @@ exports.InventoryOptionalField = {
     IntelligentTieringAccessTier: "IntelligentTieringAccessTier",
     IsMultipartUploaded: "IsMultipartUploaded",
     LastModifiedDate: "LastModifiedDate",
+    ObjectAccessControlList: "ObjectAccessControlList",
     ObjectLockLegalHoldStatus: "ObjectLockLegalHoldStatus",
     ObjectLockMode: "ObjectLockMode",
     ObjectLockRetainUntilDate: "ObjectLockRetainUntilDate",
+    ObjectOwner: "ObjectOwner",
     ReplicationStatus: "ReplicationStatus",
     Size: "Size",
     StorageClass: "StorageClass",

package/dist-cjs/runtimeConfig.browser.js

@@ -5,13 +5,13 @@ const tslib_1 = require("tslib");
 const package_json_1 = tslib_1.__importDefault(require("../package.json"));
 const sha1_browser_1 = require("@aws-crypto/sha1-browser");
 const sha256_browser_1 = require("@aws-crypto/sha256-browser");
-const hash_blob_browser_1 = require("@aws-sdk/hash-blob-browser");
-const md5_js_1 = require("@aws-sdk/md5-js");
 const util_user_agent_browser_1 = require("@aws-sdk/util-user-agent-browser");
 const config_resolver_1 = require("@smithy/config-resolver");
 const eventstream_serde_browser_1 = require("@smithy/eventstream-serde-browser");
 const fetch_http_handler_1 = require("@smithy/fetch-http-handler");
+const hash_blob_browser_1 = require("@smithy/hash-blob-browser");
 const invalid_dependency_1 = require("@smithy/invalid-dependency");
+const md5_js_1 = require("@smithy/md5-js");
 const util_body_length_browser_1 = require("@smithy/util-body-length-browser");
 const util_retry_1 = require("@smithy/util-retry");
 const runtimeConfig_shared_1 = require("./runtimeConfig.shared");

package/dist-es/models/models_0.js

@@ -135,6 +135,7 @@ export const BucketLocationConstraint = {
     ap_northeast_2: "ap-northeast-2",
     ap_northeast_3: "ap-northeast-3",
     ap_south_1: "ap-south-1",
+    ap_south_2: "ap-south-2",
     ap_southeast_1: "ap-southeast-1",
     ap_southeast_2: "ap-southeast-2",
     ap_southeast_3: "ap-southeast-3",
@@ -144,6 +145,7 @@ export const BucketLocationConstraint = {
     eu_central_1: "eu-central-1",
     eu_north_1: "eu-north-1",
     eu_south_1: "eu-south-1",
+    eu_south_2: "eu-south-2",
     eu_west_1: "eu-west-1",
     eu_west_2: "eu-west-2",
     eu_west_3: "eu-west-3",
@@ -203,9 +205,11 @@ export const InventoryOptionalField = {
     IntelligentTieringAccessTier: "IntelligentTieringAccessTier",
     IsMultipartUploaded: "IsMultipartUploaded",
     LastModifiedDate: "LastModifiedDate",
+    ObjectAccessControlList: "ObjectAccessControlList",
     ObjectLockLegalHoldStatus: "ObjectLockLegalHoldStatus",
     ObjectLockMode: "ObjectLockMode",
     ObjectLockRetainUntilDate: "ObjectLockRetainUntilDate",
+    ObjectOwner: "ObjectOwner",
     ReplicationStatus: "ReplicationStatus",
     Size: "Size",
     StorageClass: "StorageClass",

package/dist-es/runtimeConfig.browser.js

@@ -1,13 +1,13 @@
 import packageInfo from "../package.json";
 import { Sha1 } from "@aws-crypto/sha1-browser";
 import { Sha256 } from "@aws-crypto/sha256-browser";
-import { blobHasher as streamHasher } from "@aws-sdk/hash-blob-browser";
-import { Md5 } from "@aws-sdk/md5-js";
 import { defaultUserAgent } from "@aws-sdk/util-user-agent-browser";
 import { DEFAULT_USE_DUALSTACK_ENDPOINT, DEFAULT_USE_FIPS_ENDPOINT } from "@smithy/config-resolver";
 import { eventStreamSerdeProvider } from "@smithy/eventstream-serde-browser";
 import { FetchHttpHandler as RequestHandler, streamCollector } from "@smithy/fetch-http-handler";
+import { blobHasher as streamHasher } from "@smithy/hash-blob-browser";
 import { invalidProvider } from "@smithy/invalid-dependency";
+import { Md5 } from "@smithy/md5-js";
 import { calculateBodyLength } from "@smithy/util-body-length-browser";
 import { DEFAULT_MAX_ATTEMPTS, DEFAULT_RETRY_MODE } from "@smithy/util-retry";
 import { getRuntimeConfig as getSharedRuntimeConfig } from "./runtimeConfig.shared";

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

@@ -55,7 +55,9 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *             body.</p>
  *          </note>
  *          <p>The copy request charge is based on the storage class and Region that you specify for
- *          the destination object. For pricing information, see <a href="http://aws.amazon.com/s3/pricing/">Amazon S3 pricing</a>.</p>
+ *          the destination object. The request can also result in a data retrieval charge for the
+ *          source if the source storage class bills for data retrieval. For pricing information, see
+ *             <a href="http://aws.amazon.com/s3/pricing/">Amazon S3 pricing</a>.</p>
  *          <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

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

@@ -118,7 +118,7 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  *   ACL: "private" || "public-read" || "public-read-write" || "authenticated-read",
  *   Bucket: "STRING_VALUE", // required
  *   CreateBucketConfiguration: { // CreateBucketConfiguration
- *     LocationConstraint: "af-south-1" || "ap-east-1" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "ap-south-1" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "EU" || "eu-central-1" || "eu-north-1" || "eu-south-1" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "me-south-1" || "sa-east-1" || "us-east-2" || "us-gov-east-1" || "us-gov-west-1" || "us-west-1" || "us-west-2",
+ *     LocationConstraint: "af-south-1" || "ap-east-1" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "ap-south-1" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "EU" || "eu-central-1" || "eu-north-1" || "eu-south-1" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "me-south-1" || "sa-east-1" || "us-east-2" || "us-gov-east-1" || "us-gov-west-1" || "us-west-1" || "us-west-2" || "ap-south-2" || "eu-south-2",
  *   },
  *   GrantFullControl: "STRING_VALUE",
  *   GrantRead: "STRING_VALUE",
@@ -155,39 +155,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
+ * @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

@@ -83,28 +83,28 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @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
  * ```
  *
- * @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
  * ```
  *
  */

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 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/GetBucketInventoryConfigurationCommand.d.ts

@@ -86,7 +86,7 @@ export interface GetBucketInventoryConfigurationCommandOutput extends GetBucketI
  * //     Id: "STRING_VALUE", // required
  * //     IncludedObjectVersions: "All" || "Current", // required
  * //     OptionalFields: [ // InventoryOptionalFields
- * //       "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm",
+ * //       "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm" || "ObjectAccessControlList" || "ObjectOwner",
  * //     ],
  * //     Schedule: { // InventorySchedule
  * //       Frequency: "Daily" || "Weekly", // required

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

@@ -62,7 +62,7 @@ export interface GetBucketLocationCommandOutput extends GetBucketLocationOutput,
  * const command = new GetBucketLocationCommand(input);
  * const response = await client.send(command);
  * // { // GetBucketLocationOutput
- * //   LocationConstraint: "af-south-1" || "ap-east-1" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "ap-south-1" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "EU" || "eu-central-1" || "eu-north-1" || "eu-south-1" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "me-south-1" || "sa-east-1" || "us-east-2" || "us-gov-east-1" || "us-gov-west-1" || "us-west-1" || "us-west-2",
+ * //   LocationConstraint: "af-south-1" || "ap-east-1" || "ap-northeast-1" || "ap-northeast-2" || "ap-northeast-3" || "ap-south-1" || "ap-southeast-1" || "ap-southeast-2" || "ap-southeast-3" || "ca-central-1" || "cn-north-1" || "cn-northwest-1" || "EU" || "eu-central-1" || "eu-north-1" || "eu-south-1" || "eu-west-1" || "eu-west-2" || "eu-west-3" || "me-south-1" || "sa-east-1" || "us-east-2" || "us-gov-east-1" || "us-gov-west-1" || "us-west-1" || "us-west-2" || "ap-south-2" || "eu-south-2",
  * // };
  *
  * ```

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

@@ -96,7 +96,7 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  * //       Id: "STRING_VALUE", // required
  * //       IncludedObjectVersions: "All" || "Current", // required
  * //       OptionalFields: [ // InventoryOptionalFields
- * //         "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm",
+ * //         "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm" || "ObjectAccessControlList" || "ObjectOwner",
  * //       ],
  * //       Schedule: { // InventorySchedule
  * //         Frequency: "Daily" || "Weekly", // required

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

@@ -138,7 +138,7 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
  *     Id: "STRING_VALUE", // required
  *     IncludedObjectVersions: "All" || "Current", // required
  *     OptionalFields: [ // InventoryOptionalFields
- *       "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm",
+ *       "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm" || "ObjectAccessControlList" || "ObjectOwner",
  *     ],
  *     Schedule: { // InventorySchedule
  *       Frequency: "Daily" || "Weekly", // required

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

@@ -198,68 +198,65 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @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 (specify optional headers)
+ * @example To upload object and specify user-defined metadata
  * ```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 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",
- *   "ServerSideEncryption": "AES256",
- *   "StorageClass": "STANDARD_IA"
+ *   "Key": "exampleobject",
+ *   "Metadata": {
+ *     "metadata1": "value1",
+ *     "metadata2": "value2"
+ *   }
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+ *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
  * }
  * *\/
- * // example id: to-upload-an-object-(specify-optional-headers)
+ * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
  * ```
  *
- * @example To create an object.
+ * @example To upload an object
  * ```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 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": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "objectkey"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
+ *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
  * }
  * *\/
- * // example id: to-create-an-object-1483147613675
+ * // example id: to-upload-an-object-1481760101010
  * ```
  *
  * @example To upload an object and specify canned ACL.
@@ -282,33 +279,35 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
  * ```
  *
- * @example To upload an object
+ * @example To upload an object (specify optional headers)
  * ```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 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": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "HappyFace.jpg",
+ *   "ServerSideEncryption": "AES256",
+ *   "StorageClass": "STANDARD_IA"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
+ *   "ServerSideEncryption": "AES256",
+ *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
  * }
  * *\/
- * // example id: to-upload-an-object-1481760101010
+ * // example id: to-upload-an-object-(specify-optional-headers)
  * ```
  *
- * @example To upload an object and specify server-side encryption and object tags
+ * @example To upload an object and specify optional 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.
+ * // 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": "exampleobject",
- *   "ServerSideEncryption": "AES256",
+ *   "Key": "HappyFace.jpg",
  *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
@@ -316,20 +315,20 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
+ *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
+ * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
  * ```
  *
- * @example To upload an object and specify optional tags
+ * @example To upload an object and specify server-side encryption and object tags
  * ```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. 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": "c:\\HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
+ *   "Key": "exampleobject",
+ *   "ServerSideEncryption": "AES256",
  *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
@@ -337,10 +336,11 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
+ *   "ServerSideEncryption": "AES256",
+ *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
+ * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
  * ```
  *
  */

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

@@ -250,14 +250,15 @@ 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 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);
@@ -265,23 +266,22 @@ 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
  * ```
  *
- * @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);
@@ -289,12 +289,12 @@ 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
  * ```
  *
  */

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

@@ -1056,6 +1056,7 @@ export declare const BucketLocationConstraint: {
     readonly ap_northeast_2: "ap-northeast-2";
     readonly ap_northeast_3: "ap-northeast-3";
     readonly ap_south_1: "ap-south-1";
+    readonly ap_south_2: "ap-south-2";
     readonly ap_southeast_1: "ap-southeast-1";
     readonly ap_southeast_2: "ap-southeast-2";
     readonly ap_southeast_3: "ap-southeast-3";
@@ -1065,6 +1066,7 @@ export declare const BucketLocationConstraint: {
     readonly eu_central_1: "eu-central-1";
     readonly eu_north_1: "eu-north-1";
     readonly eu_south_1: "eu-south-1";
+    readonly eu_south_2: "eu-south-2";
     readonly eu_west_1: "eu-west-1";
     readonly eu_west_2: "eu-west-2";
     readonly eu_west_3: "eu-west-3";
@@ -4470,9 +4472,11 @@ export declare const InventoryOptionalField: {
     readonly IntelligentTieringAccessTier: "IntelligentTieringAccessTier";
     readonly IsMultipartUploaded: "IsMultipartUploaded";
     readonly LastModifiedDate: "LastModifiedDate";
+    readonly ObjectAccessControlList: "ObjectAccessControlList";
     readonly ObjectLockLegalHoldStatus: "ObjectLockLegalHoldStatus";
     readonly ObjectLockMode: "ObjectLockMode";
     readonly ObjectLockRetainUntilDate: "ObjectLockRetainUntilDate";
+    readonly ObjectOwner: "ObjectOwner";
     readonly ReplicationStatus: "ReplicationStatus";
     readonly Size: "Size";
     readonly StorageClass: "StorageClass";

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

@@ -286,6 +286,7 @@ export declare const BucketLocationConstraint: {
   readonly ap_northeast_2: "ap-northeast-2";
   readonly ap_northeast_3: "ap-northeast-3";
   readonly ap_south_1: "ap-south-1";
+  readonly ap_south_2: "ap-south-2";
   readonly ap_southeast_1: "ap-southeast-1";
   readonly ap_southeast_2: "ap-southeast-2";
   readonly ap_southeast_3: "ap-southeast-3";
@@ -295,6 +296,7 @@ export declare const BucketLocationConstraint: {
   readonly eu_central_1: "eu-central-1";
   readonly eu_north_1: "eu-north-1";
   readonly eu_south_1: "eu-south-1";
+  readonly eu_south_2: "eu-south-2";
   readonly eu_west_1: "eu-west-1";
   readonly eu_west_2: "eu-west-2";
   readonly eu_west_3: "eu-west-3";
@@ -708,9 +710,11 @@ export declare const InventoryOptionalField: {
   readonly IntelligentTieringAccessTier: "IntelligentTieringAccessTier";
   readonly IsMultipartUploaded: "IsMultipartUploaded";
   readonly LastModifiedDate: "LastModifiedDate";
+  readonly ObjectAccessControlList: "ObjectAccessControlList";
   readonly ObjectLockLegalHoldStatus: "ObjectLockLegalHoldStatus";
   readonly ObjectLockMode: "ObjectLockMode";
   readonly ObjectLockRetainUntilDate: "ObjectLockRetainUntilDate";
+  readonly ObjectOwner: "ObjectOwner";
   readonly ReplicationStatus: "ReplicationStatus";
   readonly Size: "Size";
   readonly StorageClass: "StorageClass";

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.369.0",
+  "version": "3.373.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -25,43 +25,43 @@
     "@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.369.0",
-    "@aws-sdk/credential-provider-node": "3.369.0",
-    "@aws-sdk/hash-blob-browser": "3.369.0",
-    "@aws-sdk/hash-stream-node": "3.369.0",
-    "@aws-sdk/md5-js": "3.369.0",
-    "@aws-sdk/middleware-bucket-endpoint": "3.369.0",
-    "@aws-sdk/middleware-expect-continue": "3.369.0",
-    "@aws-sdk/middleware-flexible-checksums": "3.369.0",
-    "@aws-sdk/middleware-host-header": "3.369.0",
-    "@aws-sdk/middleware-location-constraint": "3.369.0",
-    "@aws-sdk/middleware-logger": "3.369.0",
-    "@aws-sdk/middleware-recursion-detection": "3.369.0",
-    "@aws-sdk/middleware-sdk-s3": "3.369.0",
-    "@aws-sdk/middleware-signing": "3.369.0",
-    "@aws-sdk/middleware-ssec": "3.369.0",
-    "@aws-sdk/middleware-user-agent": "3.369.0",
-    "@aws-sdk/signature-v4-multi-region": "3.369.0",
-    "@aws-sdk/types": "3.369.0",
-    "@aws-sdk/util-endpoints": "3.369.0",
-    "@aws-sdk/util-user-agent-browser": "3.369.0",
-    "@aws-sdk/util-user-agent-node": "3.369.0",
+    "@aws-sdk/client-sts": "3.370.0",
+    "@aws-sdk/credential-provider-node": "3.370.0",
+    "@aws-sdk/hash-stream-node": "3.370.0",
+    "@aws-sdk/middleware-bucket-endpoint": "3.370.0",
+    "@aws-sdk/middleware-expect-continue": "3.370.0",
+    "@aws-sdk/middleware-flexible-checksums": "3.370.0",
+    "@aws-sdk/middleware-host-header": "3.370.0",
+    "@aws-sdk/middleware-location-constraint": "3.370.0",
+    "@aws-sdk/middleware-logger": "3.370.0",
+    "@aws-sdk/middleware-recursion-detection": "3.370.0",
+    "@aws-sdk/middleware-sdk-s3": "3.370.0",
+    "@aws-sdk/middleware-signing": "3.370.0",
+    "@aws-sdk/middleware-ssec": "3.370.0",
+    "@aws-sdk/middleware-user-agent": "3.370.0",
+    "@aws-sdk/signature-v4-multi-region": "3.370.0",
+    "@aws-sdk/types": "3.370.0",
+    "@aws-sdk/util-endpoints": "3.370.0",
+    "@aws-sdk/util-user-agent-browser": "3.370.0",
+    "@aws-sdk/util-user-agent-node": "3.370.0",
     "@aws-sdk/xml-builder": "3.310.0",
     "@smithy/config-resolver": "^1.0.1",
     "@smithy/eventstream-serde-browser": "^1.0.1",
     "@smithy/eventstream-serde-config-resolver": "^1.0.1",
     "@smithy/eventstream-serde-node": "^1.0.1",
     "@smithy/fetch-http-handler": "^1.0.1",
+    "@smithy/hash-blob-browser": "^1.0.1",
     "@smithy/hash-node": "^1.0.1",
     "@smithy/invalid-dependency": "^1.0.1",
+    "@smithy/md5-js": "^1.0.1",
     "@smithy/middleware-content-length": "^1.0.1",
-    "@smithy/middleware-endpoint": "^1.0.1",
-    "@smithy/middleware-retry": "^1.0.2",
+    "@smithy/middleware-endpoint": "^1.0.2",
+    "@smithy/middleware-retry": "^1.0.3",
     "@smithy/middleware-serde": "^1.0.1",
     "@smithy/middleware-stack": "^1.0.1",
     "@smithy/node-config-provider": "^1.0.1",
     "@smithy/node-http-handler": "^1.0.2",
-    "@smithy/protocol-http": "^1.0.1",
+    "@smithy/protocol-http": "^1.1.0",
     "@smithy/smithy-client": "^1.0.3",
     "@smithy/types": "^1.1.0",
     "@smithy/url-parser": "^1.0.1",
@@ -70,7 +70,7 @@
     "@smithy/util-body-length-node": "^1.0.1",
     "@smithy/util-defaults-mode-browser": "^1.0.1",
     "@smithy/util-defaults-mode-node": "^1.0.1",
-    "@smithy/util-retry": "^1.0.2",
+    "@smithy/util-retry": "^1.0.3",
     "@smithy/util-stream": "^1.0.1",
     "@smithy/util-utf8": "^1.0.1",
     "@smithy/util-waiter": "^1.0.1",
@@ -78,7 +78,6 @@
     "tslib": "^2.5.0"
   },
   "devDependencies": {
-    "@aws-sdk/service-client-documentation-generator": "3.310.0",
     "@smithy/service-client-documentation-generator": "^1.0.1",
     "@tsconfig/node14": "1.0.3",
     "@types/chai": "^4.2.11",