@aws-sdk/client-s3 3.454.0 → 3.456.0

package/dist-cjs/models/models_0.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReplicationStatus = exports.Protocol = exports.BucketVersioningStatus = exports.MFADeleteStatus = exports.Payer = exports.ReplicationRuleStatus = exports.SseKmsEncryptedObjectsStatus = exports.ReplicaModificationsStatus = exports.ReplicationRuleFilter = exports.ExistingObjectReplicationStatus = exports.ReplicationTimeStatus = exports.MetricsStatus = exports.DeleteMarkerReplicationStatus = exports.FilterRuleName = exports.Event = exports.MetricsFilter = exports.BucketLogsPermission = exports.ExpirationStatus = exports.TransitionStorageClass = exports.LifecycleRuleFilter = exports.InventoryFrequency = exports.InventoryOptionalField = exports.InventoryIncludedObjectVersions = exports.InventoryFormat = exports.IntelligentTieringAccessTier = exports.IntelligentTieringStatus = exports.StorageClassAnalysisSchemaVersion = exports.AnalyticsS3ExportFileFormat = exports.AnalyticsFilter = exports.ObjectOwnership = exports.BucketLocationConstraint = exports.BucketCannedACL = exports.BucketAlreadyOwnedByYou = exports.BucketAlreadyExists = exports.ObjectNotInActiveTierError = exports.TaggingDirective = exports.StorageClass = exports.ObjectLockMode = exports.ObjectLockLegalHoldStatus = exports.MetadataDirective = exports.ChecksumAlgorithm = exports.ObjectCannedACL = exports.ServerSideEncryption = exports.OwnerOverride = exports.Permission = exports.Type = exports.BucketAccelerateStatus = exports.NoSuchUpload = exports.RequestPayer = exports.RequestCharged = void 0;
-exports.PutObjectRequestFilterSensitiveLog = exports.PutObjectOutputFilterSensitiveLog = exports.PutBucketInventoryConfigurationRequestFilterSensitiveLog = exports.PutBucketEncryptionRequestFilterSensitiveLog = exports.ListPartsRequestFilterSensitiveLog = exports.ListBucketInventoryConfigurationsOutputFilterSensitiveLog = exports.HeadObjectRequestFilterSensitiveLog = exports.HeadObjectOutputFilterSensitiveLog = exports.GetObjectTorrentOutputFilterSensitiveLog = exports.GetObjectAttributesRequestFilterSensitiveLog = exports.GetObjectRequestFilterSensitiveLog = exports.GetObjectOutputFilterSensitiveLog = exports.GetBucketInventoryConfigurationOutputFilterSensitiveLog = exports.InventoryConfigurationFilterSensitiveLog = exports.InventoryDestinationFilterSensitiveLog = exports.InventoryS3BucketDestinationFilterSensitiveLog = exports.InventoryEncryptionFilterSensitiveLog = exports.SSEKMSFilterSensitiveLog = exports.GetBucketEncryptionOutputFilterSensitiveLog = exports.ServerSideEncryptionConfigurationFilterSensitiveLog = exports.ServerSideEncryptionRuleFilterSensitiveLog = exports.ServerSideEncryptionByDefaultFilterSensitiveLog = exports.CreateMultipartUploadRequestFilterSensitiveLog = exports.CreateMultipartUploadOutputFilterSensitiveLog = exports.CopyObjectRequestFilterSensitiveLog = exports.CopyObjectOutputFilterSensitiveLog = exports.CompleteMultipartUploadRequestFilterSensitiveLog = exports.CompleteMultipartUploadOutputFilterSensitiveLog = exports.MFADelete = exports.ObjectVersionStorageClass = exports.NoSuchBucket = exports.OptionalObjectAttributes = exports.ObjectStorageClass = exports.EncodingType = exports.ArchiveStatus = exports.NotFound = exports.ObjectLockRetentionMode = exports.ObjectLockEnabled = exports.ObjectAttributes = exports.NoSuchKey = exports.InvalidObjectState = exports.ChecksumMode = void 0;
+exports.Protocol = exports.BucketVersioningStatus = exports.MFADeleteStatus = exports.Payer = exports.ReplicationRuleStatus = exports.SseKmsEncryptedObjectsStatus = exports.ReplicaModificationsStatus = exports.ReplicationRuleFilter = exports.ExistingObjectReplicationStatus = exports.ReplicationTimeStatus = exports.MetricsStatus = exports.DeleteMarkerReplicationStatus = exports.FilterRuleName = exports.Event = exports.MetricsFilter = exports.PartitionDateSource = exports.BucketLogsPermission = exports.ExpirationStatus = exports.TransitionStorageClass = exports.LifecycleRuleFilter = exports.InventoryFrequency = exports.InventoryOptionalField = exports.InventoryIncludedObjectVersions = exports.InventoryFormat = exports.IntelligentTieringAccessTier = exports.IntelligentTieringStatus = exports.StorageClassAnalysisSchemaVersion = exports.AnalyticsS3ExportFileFormat = exports.AnalyticsFilter = exports.ObjectOwnership = exports.BucketLocationConstraint = exports.BucketCannedACL = exports.BucketAlreadyOwnedByYou = exports.BucketAlreadyExists = exports.ObjectNotInActiveTierError = exports.TaggingDirective = exports.StorageClass = exports.ObjectLockMode = exports.ObjectLockLegalHoldStatus = exports.MetadataDirective = exports.ChecksumAlgorithm = exports.ObjectCannedACL = exports.ServerSideEncryption = exports.OwnerOverride = exports.Permission = exports.Type = exports.BucketAccelerateStatus = exports.NoSuchUpload = exports.RequestPayer = exports.RequestCharged = void 0;
+exports.PutObjectRequestFilterSensitiveLog = exports.PutObjectOutputFilterSensitiveLog = exports.PutBucketInventoryConfigurationRequestFilterSensitiveLog = exports.PutBucketEncryptionRequestFilterSensitiveLog = exports.ListPartsRequestFilterSensitiveLog = exports.ListBucketInventoryConfigurationsOutputFilterSensitiveLog = exports.HeadObjectRequestFilterSensitiveLog = exports.HeadObjectOutputFilterSensitiveLog = exports.GetObjectTorrentOutputFilterSensitiveLog = exports.GetObjectAttributesRequestFilterSensitiveLog = exports.GetObjectRequestFilterSensitiveLog = exports.GetObjectOutputFilterSensitiveLog = exports.GetBucketInventoryConfigurationOutputFilterSensitiveLog = exports.InventoryConfigurationFilterSensitiveLog = exports.InventoryDestinationFilterSensitiveLog = exports.InventoryS3BucketDestinationFilterSensitiveLog = exports.InventoryEncryptionFilterSensitiveLog = exports.SSEKMSFilterSensitiveLog = exports.GetBucketEncryptionOutputFilterSensitiveLog = exports.ServerSideEncryptionConfigurationFilterSensitiveLog = exports.ServerSideEncryptionRuleFilterSensitiveLog = exports.ServerSideEncryptionByDefaultFilterSensitiveLog = exports.CreateMultipartUploadRequestFilterSensitiveLog = exports.CreateMultipartUploadOutputFilterSensitiveLog = exports.CopyObjectRequestFilterSensitiveLog = exports.CopyObjectOutputFilterSensitiveLog = exports.CompleteMultipartUploadRequestFilterSensitiveLog = exports.CompleteMultipartUploadOutputFilterSensitiveLog = exports.MFADelete = exports.ObjectVersionStorageClass = exports.NoSuchBucket = exports.OptionalObjectAttributes = exports.ObjectStorageClass = exports.EncodingType = exports.ArchiveStatus = exports.NotFound = exports.ObjectLockRetentionMode = exports.ObjectLockEnabled = exports.ObjectAttributes = exports.NoSuchKey = exports.InvalidObjectState = exports.ChecksumMode = exports.ReplicationStatus = void 0;
 const smithy_client_1 = require("@smithy/smithy-client");
 const S3ServiceException_1 = require("./S3ServiceException");
 exports.RequestCharged = {
@@ -259,6 +259,10 @@ exports.BucketLogsPermission = {
     READ: "READ",
     WRITE: "WRITE",
 };
+exports.PartitionDateSource = {
+    DeliveryTime: "DeliveryTime",
+    EventTime: "EventTime",
+};
 var MetricsFilter;
 (function (MetricsFilter) {
     MetricsFilter.visit = (value, visitor) => {

package/dist-cjs/protocols/Aws_restXml.js

@@ -7119,6 +7119,10 @@ const se_LoggingEnabled = (input, context) => {
         const node = xml_builder_1.XmlNode.of("TargetPrefix", input.TargetPrefix).withName("TargetPrefix");
         bodyNode.addChildNode(node);
     }
+    if (input.TargetObjectKeyFormat != null) {
+        const node = se_TargetObjectKeyFormat(input.TargetObjectKeyFormat, context).withName("TargetObjectKeyFormat");
+        bodyNode.addChildNode(node);
+    }
     return bodyNode;
 };
 const se_MetadataEntry = (input, context) => {
@@ -7406,6 +7410,14 @@ const se_ParquetInput = (input, context) => {
     const bodyNode = new xml_builder_1.XmlNode("ParquetInput");
     return bodyNode;
 };
+const se_PartitionedPrefix = (input, context) => {
+    const bodyNode = new xml_builder_1.XmlNode("PartitionedPrefix");
+    if (input.PartitionDateSource != null) {
+        const node = xml_builder_1.XmlNode.of("PartitionDateSource", input.PartitionDateSource).withName("PartitionDateSource");
+        bodyNode.addChildNode(node);
+    }
+    return bodyNode;
+};
 const se_PublicAccessBlockConfiguration = (input, context) => {
     const bodyNode = new xml_builder_1.XmlNode("PublicAccessBlockConfiguration");
     if (input.BlockPublicAcls != null) {
@@ -7821,6 +7833,10 @@ const se_ServerSideEncryptionRules = (input, context) => {
         return node.withName("member");
     });
 };
+const se_SimplePrefix = (input, context) => {
+    const bodyNode = new xml_builder_1.XmlNode("SimplePrefix");
+    return bodyNode;
+};
 const se_SourceSelectionCriteria = (input, context) => {
     const bodyNode = new xml_builder_1.XmlNode("SourceSelectionCriteria");
     if (input.SseKmsEncryptedObjects != null) {
@@ -7928,6 +7944,18 @@ const se_TargetGrants = (input, context) => {
         return node.withName("Grant");
     });
 };
+const se_TargetObjectKeyFormat = (input, context) => {
+    const bodyNode = new xml_builder_1.XmlNode("TargetObjectKeyFormat");
+    if (input.SimplePrefix != null) {
+        const node = se_SimplePrefix(input.SimplePrefix, context).withName("SimplePrefix");
+        bodyNode.addChildNode(node);
+    }
+    if (input.PartitionedPrefix != null) {
+        const node = se_PartitionedPrefix(input.PartitionedPrefix, context).withName("PartitionedPrefix");
+        bodyNode.addChildNode(node);
+    }
+    return bodyNode;
+};
 const se_Tiering = (input, context) => {
     const bodyNode = new xml_builder_1.XmlNode("Tiering");
     if (input.Days != null) {
@@ -8856,6 +8884,9 @@ const de_LoggingEnabled = (output, context) => {
     if (output["TargetPrefix"] !== undefined) {
         contents.TargetPrefix = (0, smithy_client_1.expectString)(output["TargetPrefix"]);
     }
+    if (output["TargetObjectKeyFormat"] !== undefined) {
+        contents.TargetObjectKeyFormat = de_TargetObjectKeyFormat(output["TargetObjectKeyFormat"], context);
+    }
     return contents;
 };
 const de_Metrics = (output, context) => {
@@ -9195,6 +9226,13 @@ const de_Part = (output, context) => {
     }
     return contents;
 };
+const de_PartitionedPrefix = (output, context) => {
+    const contents = {};
+    if (output["PartitionDateSource"] !== undefined) {
+        contents.PartitionDateSource = (0, smithy_client_1.expectString)(output["PartitionDateSource"]);
+    }
+    return contents;
+};
 const de_Parts = (output, context) => {
     return (output || [])
         .filter((e) => e != null)
@@ -9482,6 +9520,10 @@ const de_ServerSideEncryptionRules = (output, context) => {
         return de_ServerSideEncryptionRule(entry, context);
     });
 };
+const de_SimplePrefix = (output, context) => {
+    const contents = {};
+    return contents;
+};
 const de_SourceSelectionCriteria = (output, context) => {
     const contents = {};
     if (output["SseKmsEncryptedObjects"] !== undefined) {
@@ -9574,6 +9616,16 @@ const de_TargetGrants = (output, context) => {
         return de_TargetGrant(entry, context);
     });
 };
+const de_TargetObjectKeyFormat = (output, context) => {
+    const contents = {};
+    if (output["SimplePrefix"] !== undefined) {
+        contents.SimplePrefix = de_SimplePrefix(output["SimplePrefix"], context);
+    }
+    if (output["PartitionedPrefix"] !== undefined) {
+        contents.PartitionedPrefix = de_PartitionedPrefix(output["PartitionedPrefix"], context);
+    }
+    return contents;
+};
 const de_Tiering = (output, context) => {
     const contents = {};
     if (output["Days"] !== undefined) {

package/dist-es/models/models_0.js

@@ -251,6 +251,10 @@ export const BucketLogsPermission = {
     READ: "READ",
     WRITE: "WRITE",
 };
+export const PartitionDateSource = {
+    DeliveryTime: "DeliveryTime",
+    EventTime: "EventTime",
+};
 export var MetricsFilter;
 (function (MetricsFilter) {
     MetricsFilter.visit = (value, visitor) => {

package/dist-es/protocols/Aws_restXml.js

@@ -6927,6 +6927,10 @@ const se_LoggingEnabled = (input, context) => {
         const node = __XmlNode.of("TargetPrefix", input.TargetPrefix).withName("TargetPrefix");
         bodyNode.addChildNode(node);
     }
+    if (input.TargetObjectKeyFormat != null) {
+        const node = se_TargetObjectKeyFormat(input.TargetObjectKeyFormat, context).withName("TargetObjectKeyFormat");
+        bodyNode.addChildNode(node);
+    }
     return bodyNode;
 };
 const se_MetadataEntry = (input, context) => {
@@ -7214,6 +7218,14 @@ const se_ParquetInput = (input, context) => {
     const bodyNode = new __XmlNode("ParquetInput");
     return bodyNode;
 };
+const se_PartitionedPrefix = (input, context) => {
+    const bodyNode = new __XmlNode("PartitionedPrefix");
+    if (input.PartitionDateSource != null) {
+        const node = __XmlNode.of("PartitionDateSource", input.PartitionDateSource).withName("PartitionDateSource");
+        bodyNode.addChildNode(node);
+    }
+    return bodyNode;
+};
 const se_PublicAccessBlockConfiguration = (input, context) => {
     const bodyNode = new __XmlNode("PublicAccessBlockConfiguration");
     if (input.BlockPublicAcls != null) {
@@ -7629,6 +7641,10 @@ const se_ServerSideEncryptionRules = (input, context) => {
         return node.withName("member");
     });
 };
+const se_SimplePrefix = (input, context) => {
+    const bodyNode = new __XmlNode("SimplePrefix");
+    return bodyNode;
+};
 const se_SourceSelectionCriteria = (input, context) => {
     const bodyNode = new __XmlNode("SourceSelectionCriteria");
     if (input.SseKmsEncryptedObjects != null) {
@@ -7736,6 +7752,18 @@ const se_TargetGrants = (input, context) => {
         return node.withName("Grant");
     });
 };
+const se_TargetObjectKeyFormat = (input, context) => {
+    const bodyNode = new __XmlNode("TargetObjectKeyFormat");
+    if (input.SimplePrefix != null) {
+        const node = se_SimplePrefix(input.SimplePrefix, context).withName("SimplePrefix");
+        bodyNode.addChildNode(node);
+    }
+    if (input.PartitionedPrefix != null) {
+        const node = se_PartitionedPrefix(input.PartitionedPrefix, context).withName("PartitionedPrefix");
+        bodyNode.addChildNode(node);
+    }
+    return bodyNode;
+};
 const se_Tiering = (input, context) => {
     const bodyNode = new __XmlNode("Tiering");
     if (input.Days != null) {
@@ -8664,6 +8692,9 @@ const de_LoggingEnabled = (output, context) => {
     if (output["TargetPrefix"] !== undefined) {
         contents.TargetPrefix = __expectString(output["TargetPrefix"]);
     }
+    if (output["TargetObjectKeyFormat"] !== undefined) {
+        contents.TargetObjectKeyFormat = de_TargetObjectKeyFormat(output["TargetObjectKeyFormat"], context);
+    }
     return contents;
 };
 const de_Metrics = (output, context) => {
@@ -9003,6 +9034,13 @@ const de_Part = (output, context) => {
     }
     return contents;
 };
+const de_PartitionedPrefix = (output, context) => {
+    const contents = {};
+    if (output["PartitionDateSource"] !== undefined) {
+        contents.PartitionDateSource = __expectString(output["PartitionDateSource"]);
+    }
+    return contents;
+};
 const de_Parts = (output, context) => {
     return (output || [])
         .filter((e) => e != null)
@@ -9290,6 +9328,10 @@ const de_ServerSideEncryptionRules = (output, context) => {
         return de_ServerSideEncryptionRule(entry, context);
     });
 };
+const de_SimplePrefix = (output, context) => {
+    const contents = {};
+    return contents;
+};
 const de_SourceSelectionCriteria = (output, context) => {
     const contents = {};
     if (output["SseKmsEncryptedObjects"] !== undefined) {
@@ -9382,6 +9424,16 @@ const de_TargetGrants = (output, context) => {
         return de_TargetGrant(entry, context);
     });
 };
+const de_TargetObjectKeyFormat = (output, context) => {
+    const contents = {};
+    if (output["SimplePrefix"] !== undefined) {
+        contents.SimplePrefix = de_SimplePrefix(output["SimplePrefix"], context);
+    }
+    if (output["PartitionedPrefix"] !== undefined) {
+        contents.PartitionedPrefix = de_PartitionedPrefix(output["PartitionedPrefix"], context);
+    }
+    return contents;
+};
 const de_Tiering = (output, context) => {
     const contents = {};
     if (output["Days"] !== undefined) {

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

@@ -181,39 +181,39 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To create a bucket
+ * @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/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/GetBucketLoggingCommand.d.ts

@@ -66,6 +66,12 @@ export interface GetBucketLoggingCommandOutput extends GetBucketLoggingOutput, _
  * //       },
  * //     ],
  * //     TargetPrefix: "STRING_VALUE", // required
+ * //     TargetObjectKeyFormat: { // TargetObjectKeyFormat
+ * //       SimplePrefix: {},
+ * //       PartitionedPrefix: { // PartitionedPrefix
+ * //         PartitionDateSource: "EventTime" || "DeliveryTime",
+ * //       },
+ * //     },
  * //   },
  * // };
  *

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

@@ -100,7 +100,7 @@ export interface GetObjectCommandOutput extends Omit<GetObjectOutput, "Body">, _
  *                <note>
  *                   <ul>
  *                      <li>
- *                         <p> If you supply a <code>versionId</code>, you need the
+ *                         <p>If you supply a <code>versionId</code>, you need the
  *                               <code>s3:GetObjectVersion</code> permission to access a specific
  *                            version of an object. If you request a specific version, you do not need
  *                            to have the <code>s3:GetObject</code> permission. If you request the
@@ -109,9 +109,10 @@ export interface GetObjectCommandOutput extends Omit<GetObjectOutput, "Body">, _
  *                               <code>s3:GetObjectVersion</code> permission won't be required.</p>
  *                      </li>
  *                      <li>
- *                         <p>If the current version of the object is a delete marker, Amazon S3 behaves
- *                            as if the object was deleted and includes <code>x-amz-delete-marker:
- *                               true</code> in the response.</p>
+ *                         <p>If the current version of the object is a delete marker, Amazon S3 behaves as if the object was deleted and includes <code>x-amz-delete-marker: true</code> in the response.</p>
+ *                      </li>
+ *                      <li>
+ *                         <p>If the specified version is a delete marker, the response returns a 405 (Method Not Allowed) error and the <code>Last-Modified: timestamp</code> response header.</p>
  *                      </li>
  *                   </ul>
  *                </note>
@@ -287,53 +288,53 @@ export interface GetObjectCommandOutput extends Omit<GetObjectOutput, "Body">, _
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To retrieve 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/HeadObjectCommand.d.ts

@@ -29,9 +29,9 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *          <p>A <code>HEAD</code> request has the same options as a <code>GET</code> action on an
  *          object. The response is identical to the <code>GET</code> response except that there is no
  *          response body. Because of this, if the <code>HEAD</code> request generates an error, it
- *          returns a generic <code>400 Bad Request</code>, <code>403 Forbidden</code> or <code>404 Not
- *             Found</code> code. It is not possible to retrieve the exact exception beyond these error
- *          codes.</p>
+ *          returns a generic code, such as <code>400 Bad Request</code>, <code>403 Forbidden</code>, <code>404 Not
+ *             Found</code>, <code>405 Method Not Allowed</code>, <code>412 Precondition Failed</code>, or <code>304 Not Modified</code>.
+ *       It's not possible to retrieve the exact exception of these error codes.</p>
  *          <p>If you encrypt an object by using server-side encryption with customer-provided
  *          encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the
  *          metadata from the object, you must use the following headers:</p>
@@ -129,6 +129,17 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *                   </li>
  *                </ul>
  *             </dd>
+ *             <dt>Versioning</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <p>If the current version of the object is a delete marker, Amazon S3 behaves as if the object was deleted and includes <code>x-amz-delete-marker: true</code> in the response.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>If the specified version is a delete marker, the response returns a 405 (Method Not Allowed) error and the <code>Last-Modified: timestamp</code> response header.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
  *          </dl>
  *          <p>The following actions are related to <code>HeadObject</code>:</p>
  *          <ul>

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

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

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

@@ -36,7 +36,6 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  *             appropriately.</p>
  *          </note>
  *          <p>To use this operation, you must have READ access to the bucket.</p>
- *          <p>This action is not supported by Amazon S3 on Outposts.</p>
  *          <p>The following operations are related to <code>ListObjectVersions</code>:</p>
  *          <ul>
  *             <li>