@aws-sdk/client-s3 3.325.0 → 3.327.0

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

@@ -32,75 +32,60 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
  *          the <i>destination</i> bucket where you want the inventory to be stored, and
  *          whether to generate the inventory daily or weekly. You can also configure what object
  *          metadata to include and whether to inventory all object versions or only current versions.
- *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3
- *             Inventory</a> in the Amazon S3 User Guide.</p>
+ *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a> in the
+ *          Amazon S3 User Guide.</p>
  *          <important>
  *             <p>You must create a bucket policy on the <i>destination</i> bucket to
  *             grant permissions to Amazon S3 to write objects to the bucket in the defined location. For an
- *             example policy, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9">
- *                Granting Permissions for Amazon S3 Inventory and Storage Class Analysis</a>.</p>
+ *             example policy, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9"> Granting Permissions for Amazon S3 Inventory and Storage Class Analysis</a>.</p>
  *          </important>
- *          <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 and 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 Amazon S3 User Guide.</p>
- *          <p class="title">
- *             <b>Special Errors</b>
- *          </p>
- *          <ul>
- *             <li>
- *                <p class="title">
- *                   <b>HTTP 400 Bad Request Error</b>
- *                </p>
- *                <ul>
- *                   <li>
- *                      <p>
- *                         <i>Code:</i> InvalidArgument</p>
- *                   </li>
- *                   <li>
- *                      <p>
- *                         <i>Cause:</i> Invalid Argument</p>
- *                   </li>
- *                </ul>
- *             </li>
- *             <li>
- *                <p class="title">
- *                   <b>HTTP 400 Bad Request Error</b>
- *                </p>
- *                <ul>
- *                   <li>
- *                      <p>
- *                         <i>Code:</i> TooManyConfigurations</p>
- *                   </li>
- *                   <li>
- *                      <p>
- *                         <i>Cause:</i> You are attempting to create a new configuration
- *                      but have already reached the 1,000-configuration limit. </p>
- *                   </li>
- *                </ul>
- *             </li>
- *             <li>
- *                <p class="title">
- *                   <b>HTTP 403 Forbidden Error</b>
- *                </p>
- *                <ul>
- *                   <li>
- *                      <p>
- *                         <i>Code:</i> AccessDenied</p>
- *                   </li>
- *                   <li>
- *                      <p>
- *                         <i>Cause:</i> You are not the owner of the specified bucket,
- *                      or you do not have the <code>s3:PutInventoryConfiguration</code> bucket
- *                      permission to set the configuration on the bucket. </p>
- *                   </li>
- *                </ul>
- *             </li>
- *          </ul>
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>To use this operation, you must have permission to perform the
+ *                   <code>s3:PutInventoryConfiguration</code> action. The bucket owner has this permission
+ *                   by default and can grant this permission to others. </p>
+ *                <p>The <code>s3:PutInventoryConfiguration</code> permission allows a user to create an
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html">S3
+ *                      Inventory</a> report that includes all object metadata fields available and to
+ *                   specify the destination bucket to store the inventory. A user with read access to objects
+ *                   in the destination bucket can also access all object metadata fields that are available in
+ *                   the inventory report. </p>
+ *                <p>To restrict access to an inventory report, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html#example-bucket-policies-use-case-10">Restricting access to an Amazon S3 Inventory report</a> in the
+ *                   <i>Amazon S3 User Guide</i>. For more information about the metadata fields
+ *                   available in S3 Inventory, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html#storage-inventory-contents">Amazon S3
+ *                      Inventory lists</a> in the <i>Amazon S3 User Guide</i>. 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">Identity and
+ *                         access management in Amazon S3</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *             </dd>
+ *          </dl>
+ *          <p>
+ *             <code>PutBucketInventoryConfiguration</code> has the following special errors:</p>
+ *          <dl>
+ *             <dt>HTTP 400 Bad Request Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Code:</i> InvalidArgument</p>
+ *                <p>
+ *                   <i>Cause:</i> Invalid Argument</p>
+ *             </dd>
+ *             <dt>HTTP 400 Bad Request Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Code:</i> TooManyConfigurations</p>
+ *                <p>
+ *                   <i>Cause:</i> You are attempting to create a new configuration
+ *                         but have already reached the 1,000-configuration limit. </p>
+ *             </dd>
+ *             <dt>HTTP 403 Forbidden Error</dt>
+ *             <dd>
+ *                <p>
+ *                   <i>Cause:</i> You are not the owner of the specified bucket,
+ *                            or you do not have the <code>s3:PutInventoryConfiguration</code> bucket
+ *                            permission to set the configuration on the bucket. </p>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketInventoryConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -159,6 +144,8 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
  * };
  * const command = new PutBucketInventoryConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketInventoryConfigurationCommandInput - {@link PutBucketInventoryConfigurationCommandInput}
@@ -167,6 +154,8 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
  * @see {@link PutBucketInventoryConfigurationCommandOutput} 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 PutBucketInventoryConfigurationCommand extends $Command<PutBucketInventoryConfigurationCommandInput, PutBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -20,10 +20,10 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
 /**
  * @public
  * <p>Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle
- *          configuration. Keep in mind that this will overwrite an existing lifecycle configuration, so if
- *          you want to retain any configuration details, they must be included in the new lifecycle
- *          configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing your storage
- *             lifecycle</a>.</p>
+ *          configuration. Keep in mind that this will overwrite an existing lifecycle configuration,
+ *          so if you want to retain any configuration details, they must be included in the new
+ *          lifecycle configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing
+ *             your storage lifecycle</a>.</p>
  *          <note>
  *             <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an
  *             object key name prefix, one or more object tags, or a combination of both. Accordingly,
@@ -31,64 +31,66 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  *             filtering based only on an object key name prefix, which is supported for backward
  *             compatibility. For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>.</p>
  *          </note>
- *          <p>
- *             <b>Rules</b>
- *          </p>
- *          <p>You specify the lifecycle configuration in your request body. The lifecycle
- *          configuration is specified as XML consisting of one or more rules. An Amazon S3 Lifecycle
- *          configuration can have up to 1,000 rules. This limit is not adjustable. Each rule consists
- *          of the following:</p>
- *          <ul>
- *             <li>
- *                <p>Filter identifying a subset of objects to which the rule applies. The filter can
- *                be based on a key name prefix, object tags, or a combination of both.</p>
- *             </li>
- *             <li>
- *                <p>Status whether the rule is in effect.</p>
- *             </li>
- *             <li>
- *                <p>One or more lifecycle transition and expiration actions that you want Amazon S3 to
- *                perform on the objects identified by the filter. If the state of your bucket is
- *                versioning-enabled or versioning-suspended, you can have many versions of the same
- *                object (one current version and zero or more noncurrent versions). Amazon S3 provides
- *                predefined actions that you can specify for current and noncurrent object
- *                versions.</p>
- *             </li>
- *          </ul>
- *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object
- *             Lifecycle Management</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html">Lifecycle Configuration Elements</a>.</p>
- *          <p>
- *             <b>Permissions</b>
- *          </p>
- *          <p>By default, all Amazon S3 resources are private, including buckets, objects, and related
- *          subresources (for example, lifecycle configuration and website configuration). Only the
- *          resource owner (that is, the Amazon Web Services account that created it) can access the resource. The
- *          resource owner can optionally grant access permissions to others by writing an access
- *          policy. For this operation, a user must get the <code>s3:PutLifecycleConfiguration</code>
- *          permission.</p>
- *          <p>You can also explicitly deny permissions. Explicit deny also supersedes any other
- *          permissions. If you want to block users or accounts from removing or deleting objects from
- *          your bucket, you must deny them permissions for the following actions:</p>
- *          <ul>
- *             <li>
- *                <p>
- *                   <code>s3:DeleteObject</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>s3:DeleteObjectVersion</code>
- *                </p>
- *             </li>
- *             <li>
- *                <p>
- *                   <code>s3:PutLifecycleConfiguration</code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p>For more information about permissions, see <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>The following are related to <code>PutBucketLifecycleConfiguration</code>:</p>
+ *          <dl>
+ *             <dt>Rules</dt>
+ *             <dd>
+ *                <p>You specify the lifecycle configuration in your request body. The lifecycle
+ *                   configuration is specified as XML consisting of one or more rules. An Amazon S3 Lifecycle
+ *                   configuration can have up to 1,000 rules. This limit is not adjustable. Each rule consists
+ *                   of the following:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>Filter identifying a subset of objects to which the rule applies. The filter can
+ *                         be based on a key name prefix, object tags, or a combination of both.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>Status whether the rule is in effect.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>One or more lifecycle transition and expiration actions that you want Amazon S3 to
+ *                         perform on the objects identified by the filter. If the state of your bucket is
+ *                         versioning-enabled or versioning-suspended, you can have many versions of the same
+ *                         object (one current version and zero or more noncurrent versions). Amazon S3 provides
+ *                         predefined actions that you can specify for current and noncurrent object
+ *                         versions.</p>
+ *                   </li>
+ *                </ul>
+ *                <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle Management</a>
+ *                   and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html">Lifecycle Configuration Elements</a>.</p>
+ *             </dd>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>By default, all Amazon S3 resources are private, including buckets, objects, and related
+ *                   subresources (for example, lifecycle configuration and website configuration). Only the
+ *                   resource owner (that is, the Amazon Web Services account that created it) can access the resource. The
+ *                   resource owner can optionally grant access permissions to others by writing an access
+ *                   policy. For this operation, a user must get the <code>s3:PutLifecycleConfiguration</code>
+ *                   permission.</p>
+ *                <p>You can also explicitly deny permissions. Explicit deny also supersedes any other
+ *                   permissions. If you want to block users or accounts from removing or deleting objects from
+ *                   your bucket, you must deny them permissions for the following actions:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:DeleteObject</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:DeleteObjectVersion</code>
+ *                      </p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <code>s3:PutLifecycleConfiguration</code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *                <p>For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to
+ *                   Your Amazon S3 Resources</a>.</p>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutBucketLifecycleConfiguration</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -175,6 +177,8 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  * };
  * const command = new PutBucketLifecycleConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketLifecycleConfigurationCommandInput - {@link PutBucketLifecycleConfigurationCommandInput}
@@ -183,6 +187,8 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  * @see {@link PutBucketLifecycleConfigurationCommandOutput} 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 Put bucket lifecycle
  * ```javascript

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

@@ -20,56 +20,62 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
 /**
  * @public
  * <p>Set the logging parameters for a bucket and to specify permissions for who can view and
- *          modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as the
- *          source bucket. To set the logging status of a bucket, you must be the bucket owner.</p>
- *          <p>The bucket owner is automatically granted FULL_CONTROL to all logs. You use the <code>Grantee</code> request element to grant access to other people. The
+ *          modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as
+ *          the source bucket. To set the logging status of a bucket, you must be the bucket
+ *          owner.</p>
+ *          <p>The bucket owner is automatically granted FULL_CONTROL to all logs. You use the
+ *             <code>Grantee</code> request element to grant access to other people. The
  *             <code>Permissions</code> request element specifies the kind of access the grantee has to
  *          the logs.</p>
  *          <important>
- *             <p>If the target bucket for log delivery uses the bucket owner enforced
- *             setting for S3 Object Ownership, you can't use the <code>Grantee</code> request element
- *             to grant access to others. Permissions can only be granted using policies. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general">Permissions for server access log delivery</a> in the
+ *             <p>If the target bucket for log delivery uses the bucket owner enforced setting for S3
+ *             Object Ownership, you can't use the <code>Grantee</code> request element to grant access
+ *             to others. Permissions can only be granted using policies. For more information, see
+ *                <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general">Permissions for server access log delivery</a> in the
  *                <i>Amazon S3 User Guide</i>.</p>
  *          </important>
- *          <p>
- *             <b>Grantee Values</b>
- *          </p>
- *          <p>You can specify the person (grantee) to whom you're assigning access rights (using
- *          request elements) in the following ways:</p>
- *          <ul>
- *             <li>
- *                <p>By the person's ID:</p>
- *                <p>
- *                   <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                   xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
- *                   </Grantee></code>
- *                </p>
- *                <p>DisplayName is optional and ignored in the request.</p>
- *             </li>
- *             <li>
- *                <p>By Email address:</p>
- *                <p>
- *                   <code> <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                   xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
- *                </p>
- *                <p>The grantee is resolved to the CanonicalUser and, in a response to a GET Object
- *                acl request, appears as the CanonicalUser.</p>
- *             </li>
- *             <li>
- *                <p>By URI:</p>
- *                <p>
- *                   <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- *                   xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
- *                </p>
- *             </li>
- *          </ul>
+ *          <dl>
+ *             <dt>Grantee Values</dt>
+ *             <dd>
+ *                <p>You can specify the person (grantee) to whom you're assigning access rights (using
+ *                   request elements) in the following ways:</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>By the person's ID:</p>
+ *                      <p>
+ *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
+ *                         </Grantee></code>
+ *                      </p>
+ *                      <p>DisplayName is optional and ignored in the request.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>By Email address:</p>
+ *                      <p>
+ *                         <code> <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
+ *                      </p>
+ *                      <p>The grantee is resolved to the CanonicalUser and, in a response to a GET Object
+ *                         acl request, appears as the CanonicalUser.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>By URI:</p>
+ *                      <p>
+ *                         <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ *                         xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
+ *                      </p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *          </dl>
  *          <p>To enable logging, you use LoggingEnabled and its children request elements. To disable
  *          logging, you use an empty BucketLoggingStatus request element:</p>
  *          <p>
  *             <code><BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01"
  *             /></code>
  *          </p>
- *          <p>For more information about server access logging, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html">Server Access Logging</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *          <p>For more information about server access logging, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html">Server Access Logging</a> in the
+ *             <i>Amazon S3 User Guide</i>. </p>
  *          <p>For more information about creating a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>. For more
  *          information about returning the logging status of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html">GetBucketLogging</a>.</p>
  *          <p>The following operations are related to <code>PutBucketLogging</code>:</p>
@@ -127,6 +133,8 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketLoggingCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketLoggingCommandInput - {@link PutBucketLoggingCommandInput}
@@ -135,6 +143,8 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketLoggingCommandOutput} 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 Set logging configuration for a bucket
  * ```javascript

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

@@ -26,10 +26,10 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
  *          <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>PutBucketMetricsConfiguration</code>:</p>
  *          <ul>
@@ -100,6 +100,8 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
  * };
  * const command = new PutBucketMetricsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketMetricsConfigurationCommandInput - {@link PutBucketMetricsConfigurationCommandInput}
@@ -108,6 +110,8 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
  * @see {@link PutBucketMetricsConfigurationCommandOutput} 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 PutBucketMetricsConfigurationCommand extends $Command<PutBucketMetricsConfigurationCommandInput, PutBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -21,7 +21,7 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  * @public
  * <p>Enables notifications of specified events for a bucket. For more information about event
  *          notifications, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Event
- *             Notifications</a>.</p>
+ *          Notifications</a>.</p>
  *          <p>Using this API, you can replace an existing notification configuration. The
  *          configuration is an XML file that defines the event types that you want Amazon S3 to publish and
  *          the destination where you want Amazon S3 to publish an event notification when it detects an
@@ -34,19 +34,19 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  *          <p>
  *             <code></NotificationConfiguration></code>
  *          </p>
- *          <p>This action replaces the existing notification configuration with the configuration
- *          you include in the request body.</p>
+ *          <p>This action replaces the existing notification configuration with the configuration you
+ *          include in the request body.</p>
  *          <p>After Amazon S3 receives this request, it first verifies that any Amazon Simple Notification
  *          Service (Amazon SNS) or Amazon Simple Queue Service (Amazon SQS) destination exists, and
  *          that the bucket owner has permission to publish to it by sending a test notification. In
  *          the case of Lambda destinations, Amazon S3 verifies that the Lambda function permissions
  *          grant Amazon S3 permission to invoke the function from the Amazon S3 bucket. For more information,
- *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Notifications for Amazon S3
- *             Events</a>.</p>
+ *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Notifications for Amazon S3 Events</a>.</p>
  *          <p>You can disable notifications by adding the empty NotificationConfiguration
  *          element.</p>
- *          <p>For more information about the number of event notification configurations that you can create per bucket, see
- *          <a href="https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3">Amazon S3 service quotas</a> in <i>Amazon Web Services General Reference</i>.</p>
+ *          <p>For more information about the number of event notification configurations that you can
+ *          create per bucket, see <a href="https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3">Amazon S3 service quotas</a> in <i>Amazon Web Services
+ *             General Reference</i>.</p>
  *          <p>By default, only the bucket owner can configure notifications on a bucket. However,
  *          bucket owners can use a bucket policy to grant permission to other users to set this
  *          configuration with <code>s3:PutBucketNotification</code> permission.</p>
@@ -54,12 +54,9 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  *             <p>The PUT notification is an atomic operation. For example, suppose your notification
  *             configuration includes SNS topic, SQS queue, and Lambda function configurations. When
  *             you send a PUT request with this configuration, Amazon S3 sends test messages to your SNS
- *             topic. If the message fails, the entire PUT action will fail, and Amazon S3 will not add
- *             the configuration to your bucket.</p>
+ *             topic. If the message fails, the entire PUT action will fail, and Amazon S3 will not add the
+ *             configuration to your bucket.</p>
  *          </note>
- *          <p>
- *             <b>Responses</b>
- *          </p>
  *          <p>If the configuration in the request body includes only one
  *             <code>TopicConfiguration</code> specifying only the
  *             <code>s3:ReducedRedundancyLostObject</code> event type, the response will also include
@@ -147,6 +144,8 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  * };
  * const command = new PutBucketNotificationConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketNotificationConfigurationCommandInput - {@link PutBucketNotificationConfigurationCommandInput}
@@ -155,6 +154,8 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  * @see {@link PutBucketNotificationConfigurationCommandOutput} 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 Set notification configuration for a bucket
  * ```javascript

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

@@ -21,8 +21,10 @@ export interface PutBucketOwnershipControlsCommandOutput extends __MetadataBeare
  * @public
  * <p>Creates or modifies <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/user-guide/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/user-guide/about-object-ownership.html">Using object ownership</a>. </p>
+ *          more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/user-guide/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/user-guide/about-object-ownership.html">Using object
+ *             ownership</a>. </p>
  *          <p>The following operations are related to <code>PutBucketOwnershipControls</code>:</p>
  *          <ul>
  *             <li>
@@ -56,6 +58,8 @@ export interface PutBucketOwnershipControlsCommandOutput extends __MetadataBeare
  * };
  * const command = new PutBucketOwnershipControlsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketOwnershipControlsCommandInput - {@link PutBucketOwnershipControlsCommandInput}
@@ -64,6 +68,8 @@ export interface PutBucketOwnershipControlsCommandOutput extends __MetadataBeare
  * @see {@link PutBucketOwnershipControlsCommandOutput} 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 PutBucketOwnershipControlsCommand extends $Command<PutBucketOwnershipControlsCommandInput, PutBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {

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

@@ -28,11 +28,15 @@ export interface PutBucketPolicyCommandOutput 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, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy examples</a>.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy
+ *             examples</a>.</p>
  *          <p>The following operations are related to <code>PutBucketPolicy</code>:</p>
  *          <ul>
  *             <li>
@@ -62,6 +66,8 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketPolicyCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketPolicyCommandInput - {@link PutBucketPolicyCommandInput}
@@ -70,6 +76,8 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketPolicyCommandOutput} 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 Set bucket policy
  * ```javascript