@aws-sdk/client-s3 3.614.0 → 3.616.0

package/dist-es/commands/ListObjectVersionsCommand.js

@@ -1,3 +1,4 @@
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class ListObjectVersionsCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
     ];
 })
     .s("AmazonS3", "ListObjectVersions", {})

package/dist-es/commands/ListObjectsCommand.js

@@ -1,3 +1,4 @@
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class ListObjectsCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
     ];
 })
     .s("AmazonS3", "ListObjects", {})

package/dist-es/commands/ListObjectsV2Command.js

@@ -1,3 +1,4 @@
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class ListObjectsV2Command extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
     ];
 })
     .s("AmazonS3", "ListObjectsV2", {})

package/dist-es/commands/ListPartsCommand.js

@@ -1,3 +1,4 @@
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getSsecPlugin } from "@aws-sdk/middleware-ssec";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
@@ -17,6 +18,7 @@ export class ListPartsCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getSsecPlugin(config),
     ];
 })

package/dist-es/commands/PutObjectAclCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -16,6 +17,7 @@ export class PutObjectAclCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/PutObjectCommand.js

@@ -1,5 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
-import { getCheckContentLengthHeaderPlugin } from "@aws-sdk/middleware-sdk-s3";
+import { getCheckContentLengthHeaderPlugin, getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getSsecPlugin } from "@aws-sdk/middleware-ssec";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
@@ -20,6 +20,7 @@ export class PutObjectCommand extends $Command
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
         getCheckContentLengthHeaderPlugin(config),
+        getThrow200ExceptionsPlugin(config),
         getSsecPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,

package/dist-es/commands/PutObjectLegalHoldCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class PutObjectLegalHoldCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/PutObjectLockConfigurationCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class PutObjectLockConfigurationCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/PutObjectRetentionCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class PutObjectRetentionCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/PutObjectTaggingCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -15,6 +16,7 @@ export class PutObjectTaggingCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/RestoreObjectCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
 import { Command as $Command } from "@smithy/smithy-client";
@@ -16,6 +17,7 @@ export class RestoreObjectCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,
             requestAlgorithmMember: "ChecksumAlgorithm",

package/dist-es/commands/SelectObjectContentCommand.js

@@ -1,3 +1,4 @@
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getSsecPlugin } from "@aws-sdk/middleware-ssec";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
@@ -16,6 +17,7 @@ export class SelectObjectContentCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getSsecPlugin(config),
     ];
 })

package/dist-es/commands/UploadPartCommand.js

@@ -1,4 +1,5 @@
 import { getFlexibleChecksumsPlugin } from "@aws-sdk/middleware-flexible-checksums";
+import { getThrow200ExceptionsPlugin } from "@aws-sdk/middleware-sdk-s3";
 import { getSsecPlugin } from "@aws-sdk/middleware-ssec";
 import { getEndpointPlugin } from "@smithy/middleware-endpoint";
 import { getSerdePlugin } from "@smithy/middleware-serde";
@@ -18,6 +19,7 @@ export class UploadPartCommand extends $Command
     return [
         getSerdePlugin(config, this.serialize, this.deserialize),
         getEndpointPlugin(config, Command.getEndpointParameterInstructions()),
+        getThrow200ExceptionsPlugin(config),
         getSsecPlugin(config),
         getFlexibleChecksumsPlugin(config, {
             input: this.input,

package/dist-types/S3Client.d.ts

@@ -270,7 +270,7 @@ export interface ClientDefaults extends Partial<__SmithyConfiguration<__HttpHand
 /**
  * @public
  */
-export type S3ClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointInputConfig<EndpointParameters> & RetryInputConfig & HostHeaderInputConfig & AwsAuthInputConfig & S3InputConfig & UserAgentInputConfig & EventStreamSerdeInputConfig & ClientInputEndpointParameters;
+export type S3ClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointInputConfig<EndpointParameters> & HostHeaderInputConfig & AwsAuthInputConfig & S3InputConfig & UserAgentInputConfig & RetryInputConfig & EventStreamSerdeInputConfig & ClientInputEndpointParameters;
 /**
  * @public
  *
@@ -281,7 +281,7 @@ export interface S3ClientConfig extends S3ClientConfigType {
 /**
  * @public
  */
-export type S3ClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RuntimeExtensionsConfig & RegionResolvedConfig & EndpointResolvedConfig<EndpointParameters> & RetryResolvedConfig & HostHeaderResolvedConfig & AwsAuthResolvedConfig & S3ResolvedConfig & UserAgentResolvedConfig & EventStreamSerdeResolvedConfig & ClientResolvedEndpointParameters;
+export type S3ClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RuntimeExtensionsConfig & RegionResolvedConfig & EndpointResolvedConfig<EndpointParameters> & HostHeaderResolvedConfig & AwsAuthResolvedConfig & S3ResolvedConfig & UserAgentResolvedConfig & RetryResolvedConfig & EventStreamSerdeResolvedConfig & ClientResolvedEndpointParameters;
 /**
  * @public
  *

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
+ * @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/DeleteObjectsCommand.d.ts

@@ -210,20 +210,18 @@ declare const DeleteObjectsCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @example To delete multiple object versions from a versioned bucket
+ * @example To delete multiple objects from a versioned bucket
  * ```javascript
- * // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
+ * // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "Delete": {
  *     "Objects": [
  *       {
- *         "Key": "HappyFace.jpg",
- *         "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *         "Key": "objectkey1"
  *       },
  *       {
- *         "Key": "HappyFace.jpg",
- *         "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *         "Key": "objectkey2"
  *       }
  *     ],
  *     "Quiet": false
@@ -235,31 +233,35 @@ declare const DeleteObjectsCommand_base: {
  * {
  *   "Deleted": [
  *     {
- *       "Key": "HappyFace.jpg",
- *       "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
+ *       "Key": "objectkey1"
  *     },
  *     {
- *       "Key": "HappyFace.jpg",
- *       "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
+ *       "Key": "objectkey2"
  *     }
  *   ]
  * }
  * *\/
- * // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
+ * // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
  * ```
  *
- * @example To delete multiple objects from a versioned bucket
+ * @example To delete multiple object versions from a versioned bucket
  * ```javascript
- * // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
+ * // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
  * const input = {
  *   "Bucket": "examplebucket",
  *   "Delete": {
  *     "Objects": [
  *       {
- *         "Key": "objectkey1"
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
  *       },
  *       {
- *         "Key": "objectkey2"
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
  *       }
  *     ],
  *     "Quiet": false
@@ -271,19 +273,17 @@ declare const DeleteObjectsCommand_base: {
  * {
  *   "Deleted": [
  *     {
- *       "DeleteMarker": "true",
- *       "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
- *       "Key": "objectkey1"
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
  *     },
  *     {
- *       "DeleteMarker": "true",
- *       "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
- *       "Key": "objectkey2"
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
  *     }
  *   ]
  * }
  * *\/
- * // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
+ * // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
  * ```
  *
  */

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

@@ -234,33 +234,33 @@ declare const PutObjectCommand_base: {
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @public
- * @example To upload an object and specify canned ACL.
+ * @example To upload an object
  * ```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 to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.
  * const input = {
- *   "ACL": "authenticated-read",
- *   "Body": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
+ *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
+ * // example id: to-upload-an-object-1481760101010
  * ```
  *
- * @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);
@@ -268,21 +268,22 @@ declare const PutObjectCommand_base: {
  * /* 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
  * ```
  *
- * @example To upload an object and specify server-side encryption and object tags
+ * @example To upload an object (specify optional headers)
  * ```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 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",
+ *   "Key": "HappyFace.jpg",
  *   "ServerSideEncryption": "AES256",
- *   "Tagging": "key1=value1&key2=value2"
+ *   "StorageClass": "STANDARD_IA"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
@@ -290,93 +291,92 @@ declare const PutObjectCommand_base: {
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
  *   "ServerSideEncryption": "AES256",
- *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
+ *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
+ * // 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
  * ```
  *
- * @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 canned ACL.
  * ```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 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 = {
- *   "Body": "HappyFace.jpg",
+ *   "ACL": "authenticated-read",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "ServerSideEncryption": "AES256",
- *   "StorageClass": "STANDARD_IA"
+ *   "Key": "exampleobject"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+ *   "VersionId": "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr"
  * }
  * *\/
- * // example id: to-upload-an-object-(specify-optional-headers)
+ * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
  * ```
  *
- * @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
  * ```
  *
  */