@aws-sdk/client-s3 3.325.0 → 3.327.0

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

@@ -23,11 +23,9 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  *          <p>To use this operation, you must have permission to perform the
  *             <code>s3:PutBucketCORS</code> action. The bucket owner has this permission by default
  *          and can grant this permission to others. </p>
- *          <p>For information about <code>cors</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling
- *             Cross-Origin Resource Sharing</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p class="title">
- *             <b>Related Resources:</b>
- *          </p>
+ *          <p>For information about <code>cors</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling Cross-Origin Resource Sharing</a> in
+ *          the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>The following operations are related to <code>DeleteBucketCors</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -52,6 +50,8 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketCorsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketCorsCommandInput - {@link DeleteBucketCorsCommandInput}
@@ -60,6 +60,8 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketCorsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete cors configuration on a bucket.
  * ```javascript

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

@@ -19,17 +19,17 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>This implementation of the DELETE action removes default encryption from the bucket.
- *          For information about the Amazon S3 default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Default Bucket Encryption</a> in the
- *             <i>Amazon S3 User Guide</i>.</p>
+ * <p>This implementation of the DELETE action resets the default encryption for the
+ *          bucket as server-side encryption with Amazon S3 managed keys (SSE-S3). For information about the
+ *          bucket default encryption feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 Bucket Default Encryption</a>
+ *          in the <i>Amazon S3 User Guide</i>.</p>
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutEncryptionConfiguration</code> action. The bucket owner has this permission
  *          by default. The bucket owner can grant this permission to others. For more information
- *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to your Amazon S3
- *             Resources</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
+ *             Access Permissions to your Amazon S3 Resources</a> in the
+ *             <i>Amazon S3 User Guide</i>.</p>
+ *          <p>The following operations are related to <code>DeleteBucketEncryption</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -54,6 +54,8 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketEncryptionCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketEncryptionCommandInput - {@link DeleteBucketEncryptionCommandInput}
@@ -62,6 +64,8 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketEncryptionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketEncryptionCommand extends $Command<DeleteBucketEncryptionCommandInput, DeleteBucketEncryptionCommandOutput, S3ClientResolvedConfig> {

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

@@ -23,8 +23,7 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  *          <p>The S3 Intelligent-Tiering storage class is designed to optimize storage costs by automatically moving data to the most cost-effective storage access tier, without performance impact or operational overhead. S3 Intelligent-Tiering delivers automatic cost savings in three low latency and high throughput access tiers. To get the lowest storage cost on data that can be accessed in minutes to hours, you can choose to activate additional archiving capabilities.</p>
  *          <p>The S3 Intelligent-Tiering storage class is  the ideal storage class for data with unknown, changing, or unpredictable access patterns, independent of object size or retention period. If the size of an object is less than 128 KB, it is not monitored and not eligible for auto-tiering. Smaller objects can be stored, but they are always charged at the Frequent Access tier rates in the S3 Intelligent-Tiering storage class.</p>
  *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html#sc-dynamic-data-access">Storage class for automatically optimizing frequently and infrequently accessed objects</a>.</p>
- *          <p>Operations related to
- *             <code>DeleteBucketIntelligentTieringConfiguration</code> include: </p>
+ *          <p>Operations related to <code>DeleteBucketIntelligentTieringConfiguration</code> include: </p>
  *          <ul>
  *             <li>
  *                <p>
@@ -54,6 +53,8 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  * };
  * const command = new DeleteBucketIntelligentTieringConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketIntelligentTieringConfigurationCommandInput - {@link DeleteBucketIntelligentTieringConfigurationCommandInput}
@@ -62,6 +63,8 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  * @see {@link DeleteBucketIntelligentTieringConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketIntelligentTieringConfigurationCommand extends $Command<DeleteBucketIntelligentTieringConfigurationCommandInput, DeleteBucketIntelligentTieringConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -24,8 +24,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutInventoryConfiguration</code> action. The bucket owner has this permission
  *          by default. The bucket owner can grant this permission to others. For more information
- *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
- *             Resources</a>.</p>
+ *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
+ *             Access Permissions to Your Amazon S3 Resources</a>.</p>
  *          <p>For information about the Amazon S3 inventory feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a>.</p>
  *          <p>Operations related to <code>DeleteBucketInventoryConfiguration</code> include: </p>
  *          <ul>
@@ -58,6 +58,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  * };
  * const command = new DeleteBucketInventoryConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketInventoryConfigurationCommandInput - {@link DeleteBucketInventoryConfigurationCommandInput}
@@ -66,6 +68,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  * @see {@link DeleteBucketInventoryConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketInventoryConfigurationCommand extends $Command<DeleteBucketInventoryConfigurationCommandInput, DeleteBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -28,8 +28,7 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  *          permission and the bucket owner can grant this permission to others.</p>
  *          <p>There is usually some time lag before lifecycle configuration deletion is fully
  *          propagated to all the Amazon S3 systems.</p>
- *          <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to
- *             Describe Lifecycle Actions</a>.</p>
+ *          <p>For more information about the object expiration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#intro-lifecycle-rules-actions">Elements to Describe Lifecycle Actions</a>.</p>
  *          <p>Related actions include:</p>
  *          <ul>
  *             <li>
@@ -55,6 +54,8 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketLifecycleCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketLifecycleCommandInput - {@link DeleteBucketLifecycleCommandInput}
@@ -63,6 +64,8 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketLifecycleCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete lifecycle configuration on a bucket.
  * ```javascript

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

@@ -25,9 +25,10 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  *          <p> To use this operation, you must have permissions to perform the
  *             <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by
  *          default. The bucket owner can grant this permission to others. For more information about
- *          permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
- *             Resources</a>.</p>
- *          <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>. </p>
+ *          permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
+ *             Access Permissions to Your Amazon S3 Resources</a>.</p>
+ *          <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
+ *             Amazon CloudWatch</a>. </p>
  *          <p>The following operations are related to
  *          <code>DeleteBucketMetricsConfiguration</code>:</p>
  *          <ul>
@@ -48,8 +49,7 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
- *                   CloudWatch</a>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
  *                </p>
  *             </li>
  *          </ul>
@@ -66,6 +66,8 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  * };
  * const command = new DeleteBucketMetricsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketMetricsConfigurationCommandInput - {@link DeleteBucketMetricsConfigurationCommandInput}
@@ -74,6 +76,8 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  * @see {@link DeleteBucketMetricsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketMetricsConfigurationCommand extends $Command<DeleteBucketMetricsConfigurationCommandInput, DeleteBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -21,8 +21,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * @public
  * <p>Removes <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
  *          must have the <code>s3:PutBucketOwnershipControls</code> permission. For more information
- *          about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying
- *             Permissions in a Policy</a>.</p>
+ *          about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
+ *             Policy</a>.</p>
  *          <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html">Using Object Ownership</a>. </p>
  *          <p>The following operations are related to
  *          <code>DeleteBucketOwnershipControls</code>:</p>
@@ -50,6 +50,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * };
  * const command = new DeleteBucketOwnershipControlsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketOwnershipControlsCommandInput - {@link DeleteBucketOwnershipControlsCommandInput}
@@ -58,6 +60,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * @see {@link DeleteBucketOwnershipControlsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketOwnershipControlsCommand extends $Command<DeleteBucketOwnershipControlsCommandInput, DeleteBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {

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

@@ -29,9 +29,12 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  *          identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
  *             Allowed</code> error. </p>
  *          <important>
- *             <p>As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
- *             always use this operation, even if the policy explicitly denies the root user the
- *             ability to perform this action.</p>
+ *             <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
+ *             buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
+ *                <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
+ *                <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
+ *             denies the root principal's access. Bucket owner root principals can only be blocked from performing
+ *             these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
  *          </important>
  *          <p>For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and
  *             UserPolicies</a>. </p>
@@ -61,6 +64,8 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketPolicyCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketPolicyCommandInput - {@link DeleteBucketPolicyCommandInput}
@@ -69,6 +74,8 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketPolicyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket policy
  * ```javascript

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

@@ -23,13 +23,14 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutReplicationConfiguration</code> action. The bucket owner has these
  *          permissions by default and can grant it to others. For more information about permissions,
- *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
- *             Resources</a>. </p>
+ *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
+ *             Access Permissions to Your Amazon S3 Resources</a>. </p>
  *          <note>
  *             <p>It can take a while for the deletion of a replication configuration to fully
  *             propagate.</p>
  *          </note>
- *          <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p> For information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the
+ *             <i>Amazon S3 User Guide</i>.</p>
  *          <p>The following operations are related to <code>DeleteBucketReplication</code>:</p>
  *          <ul>
  *             <li>
@@ -55,6 +56,8 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketReplicationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketReplicationCommandInput - {@link DeleteBucketReplicationCommandInput}
@@ -63,6 +66,8 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketReplicationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket replication configuration
  * ```javascript

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

@@ -48,6 +48,8 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketTaggingCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketTaggingCommandInput - {@link DeleteBucketTaggingCommandInput}
@@ -56,6 +58,8 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket tags
  * ```javascript

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

@@ -55,6 +55,8 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketWebsiteCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketWebsiteCommandInput - {@link DeleteBucketWebsiteCommandInput}
@@ -63,6 +65,8 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketWebsiteCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket website configuration
  * ```javascript

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

@@ -22,21 +22,21 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * <p>Removes the null version (if there is one) of an object and inserts a delete marker,
  *          which becomes the latest version of the object. If there isn't a null version, Amazon S3 does
  *          not remove any objects but will still respond that the command was successful.</p>
- *          <p>To remove a specific version, you must be the bucket owner and you must use the version
- *          Id subresource. Using this subresource permanently deletes the version. If the object
- *          deleted is a delete marker, Amazon S3 sets the response header,
- *          <code>x-amz-delete-marker</code>, to true. </p>
+ *          <p>To remove a specific version, you must use the version Id subresource. Using this
+ *          subresource permanently deletes the version. If the object deleted is a delete marker, Amazon S3
+ *          sets the response header, <code>x-amz-delete-marker</code>, to true. </p>
  *          <p>If the object you want to delete is in a bucket where the bucket versioning
  *          configuration is MFA Delete enabled, you must include the <code>x-amz-mfa</code> request
  *          header in the DELETE <code>versionId</code> request. Requests that include
  *             <code>x-amz-mfa</code> must use HTTPS. </p>
- *          <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample Request</a>. </p>
- *          <p>You can delete objects by explicitly calling DELETE Object or configure its
- *          lifecycle (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to
- *          enable Amazon S3 to remove them for you. If you want to block users or accounts from removing or
- *          deleting objects from your bucket, you must deny them the <code>s3:DeleteObject</code>,
- *             <code>s3:DeleteObjectVersion</code>, and <code>s3:PutLifeCycleConfiguration</code>
- *          actions. </p>
+ *          <p> For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a>. To see sample
+ *          requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample
+ *             Request</a>. </p>
+ *          <p>You can delete objects by explicitly calling DELETE Object or configure its lifecycle
+ *             (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to enable Amazon S3 to remove them for you. If you want to block
+ *          users or accounts from removing or deleting objects from your bucket, you must deny them
+ *          the <code>s3:DeleteObject</code>, <code>s3:DeleteObjectVersion</code>, and
+ *             <code>s3:PutLifeCycleConfiguration</code> actions. </p>
  *          <p>The following action is related to <code>DeleteObject</code>:</p>
  *          <ul>
  *             <li>
@@ -62,6 +62,12 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * };
  * const command = new DeleteObjectCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectOutput
+ * //   DeleteMarker: true || false,
+ * //   VersionId: "STRING_VALUE",
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectCommandInput - {@link DeleteObjectCommandInput}
@@ -70,6 +76,8 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * @see {@link DeleteObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete an object (from a non-versioned bucket)
  * ```javascript

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

@@ -20,15 +20,13 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
 /**
  * @public
  * <p>Removes the entire tag set from the specified object. For more information about
- *          managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object
- *             Tagging</a>.</p>
+ *          managing object tags, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html"> Object Tagging</a>.</p>
  *          <p>To use this operation, you must have permission to perform the
  *             <code>s3:DeleteObjectTagging</code> action.</p>
  *          <p>To delete tags of a specific object version, add the <code>versionId</code> query
  *          parameter in the request. You will need permission for the
  *             <code>s3:DeleteObjectVersionTagging</code> action.</p>
- *          <p>The following operations are related to
- *          <code>DeleteBucketMetricsConfiguration</code>:</p>
+ *          <p>The following operations are related to <code>DeleteObjectTagging</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -55,6 +53,10 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectTaggingOutput
+ * //   VersionId: "STRING_VALUE",
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectTaggingCommandInput - {@link DeleteObjectTaggingCommandInput}
@@ -63,6 +65,8 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * @see {@link DeleteObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To remove tag set from an object version
  * ```javascript

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

@@ -20,28 +20,27 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
 /**
  * @public
  * <p>This action enables you to delete multiple objects from a bucket using a single HTTP
- *          request. If you know the object keys that you want to delete, then this action provides
- *          a suitable alternative to sending individual delete requests, reducing per-request
+ *          request. If you know the object keys that you want to delete, then this action provides a
+ *          suitable alternative to sending individual delete requests, reducing per-request
  *          overhead.</p>
  *          <p>The request contains a list of up to 1000 keys that you want to delete. In the XML, you
  *          provide the object key names, and optionally, version IDs if you want to delete a specific
  *          version of the object from a versioning-enabled bucket. For each key, Amazon S3 performs a
- *          delete action and returns the result of that delete, success, or failure, in the
- *          response. Note that if the object specified in the request is not found, Amazon S3 returns the
- *          result as deleted.</p>
+ *          delete action and returns the result of that delete, success, or failure, in the response.
+ *          Note that if the object specified in the request is not found, Amazon S3 returns the result as
+ *          deleted.</p>
  *          <p> The action supports two modes for the response: verbose and quiet. By default, the
- *          action uses verbose mode in which the response includes the result of deletion of each
- *          key in your request. In quiet mode the response includes only keys where the delete
- *          action encountered an error. For a successful deletion, the action does not return
- *          any information about the delete in the response body.</p>
- *          <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete
- *          any versioned objects, you must include an MFA token. If you do not provide one, the entire
+ *          action uses verbose mode in which the response includes the result of deletion of each key
+ *          in your request. In quiet mode the response includes only keys where the delete action
+ *          encountered an error. For a successful deletion, the action does not return any information
+ *          about the delete in the response body.</p>
+ *          <p>When performing this action on an MFA Delete enabled bucket, that attempts to delete any
+ *          versioned objects, you must include an MFA token. If you do not provide one, the entire
  *          request will fail, even if there are non-versioned objects you are trying to delete. If you
  *          provide an invalid token, whether there are versioned keys in the request or not, the
  *          entire Multi-Object Delete request will fail. For information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html#MultiFactorAuthenticationDelete"> MFA
- *          Delete</a>.</p>
- *          <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon
- *          S3 uses the header value to ensure that your request body has not been altered in
+ *             Delete</a>.</p>
+ *          <p>Finally, the Content-MD5 header is required for all Multi-Object Delete requests. Amazon S3 uses the header value to ensure that your request body has not been altered in
  *          transit.</p>
  *          <p>The following operations are related to <code>DeleteObjects</code>:</p>
  *          <ul>
@@ -96,6 +95,26 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * };
  * const command = new DeleteObjectsCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectsOutput
+ * //   Deleted: [ // DeletedObjects
+ * //     { // DeletedObject
+ * //       Key: "STRING_VALUE",
+ * //       VersionId: "STRING_VALUE",
+ * //       DeleteMarker: true || false,
+ * //       DeleteMarkerVersionId: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   RequestCharged: "requester",
+ * //   Errors: [ // Errors
+ * //     { // Error
+ * //       Key: "STRING_VALUE",
+ * //       VersionId: "STRING_VALUE",
+ * //       Code: "STRING_VALUE",
+ * //       Message: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectsCommandInput - {@link DeleteObjectsCommandInput}
@@ -104,19 +123,23 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * @see {@link DeleteObjectsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @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
@@ -128,35 +151,31 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * {
  *   "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
  * ```
  *
- * @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
@@ -168,17 +187,19 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * {
  *   "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
  * ```
  *
  */