@aws-sdk/client-s3 3.325.0 → 3.327.0

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

@@ -40,34 +40,37 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
  *             replication of delete markers differently. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations">Backward Compatibility</a>.</p>
  *          </note>
  *          <p>For information about enabling versioning on a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html">Using Versioning</a>.</p>
- *          <p>
- *             <b>Handling Replication of Encrypted Objects</b>
- *          </p>
- *          <p>By default, Amazon S3 doesn't replicate objects that are stored at rest using server-side
- *          encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects, add the
- *          following: <code>SourceSelectionCriteria</code>, <code>SseKmsEncryptedObjects</code>,
- *             <code>Status</code>, <code>EncryptionConfiguration</code>, and
- *             <code>ReplicaKmsKeyID</code>. For information about replication configuration, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating Objects
- *                Created with SSE Using KMS keys</a>.</p>
- *          <p>For information on <code>PutBucketReplication</code> errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList">List of
- *             replication-related error codes</a>
- *          </p>
- *          <p>
- *             <b>Permissions</b>
- *          </p>
- *          <p>To create a <code>PutBucketReplication</code> request, you must have <code>s3:PutReplicationConfiguration</code>
- *          permissions for the bucket.
- *          </p>
- *          <p>By default, a resource owner, in this case the Amazon Web Services account that created the bucket, can
- *          perform this operation. The resource owner can also grant others permissions to perform the
- *          operation. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a Policy</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>To perform this operation, the user or role performing the action must have the
- *                <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a> permission.</p>
- *          </note>
+ *          <dl>
+ *             <dt>Handling Replication of Encrypted Objects</dt>
+ *             <dd>
+ *                <p>By default, Amazon S3 doesn't replicate objects that are stored at rest using server-side
+ *                   encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects, add the following:
+ *                   <code>SourceSelectionCriteria</code>, <code>SseKmsEncryptedObjects</code>,
+ *                   <code>Status</code>, <code>EncryptionConfiguration</code>, and
+ *                   <code>ReplicaKmsKeyID</code>. For information about replication configuration, see
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating Objects
+ *                      Created with SSE Using KMS keys</a>.</p>
+ *                <p>For information on <code>PutBucketReplication</code> errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList">List of
+ *                   replication-related error codes</a>
+ *                </p>
+ *             </dd>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>To create a <code>PutBucketReplication</code> request, you must have
+ *                   <code>s3:PutReplicationConfiguration</code> permissions for the bucket.
+ *
+ *                </p>
+ *                <p>By default, a resource owner, in this case the Amazon Web Services account that created the bucket,
+ *                   can perform this operation. The resource owner can also grant others permissions to perform
+ *                   the operation. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
+ *                      Policy</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>To perform this operation, the user or role performing the action must have the
+ *                      <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a> permission.</p>
+ *                </note>
+ *             </dd>
+ *          </dl>
  *          <p>The following operations are related to <code>PutBucketReplication</code>:</p>
  *          <ul>
  *             <li>
@@ -160,6 +163,8 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketReplicationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketReplicationCommandInput - {@link PutBucketReplicationCommandInput}
@@ -168,6 +173,8 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketReplicationCommandOutput} 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 replication configuration on a bucket
  * ```javascript

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

@@ -23,7 +23,7 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
  *          for downloads from the bucket. This configuration parameter enables the bucket owner (only)
  *          to specify that the person requesting the download will be charged for the download. For
  *          more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays
- *             Buckets</a>.</p>
+ *          Buckets</a>.</p>
  *          <p>The following operations are related to <code>PutBucketRequestPayment</code>:</p>
  *          <ul>
  *             <li>
@@ -54,6 +54,8 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketRequestPaymentCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketRequestPaymentCommandInput - {@link PutBucketRequestPaymentCommandInput}
@@ -62,6 +64,8 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketRequestPaymentCommandOutput} 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 request payment configuration on a bucket.
  * ```javascript

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

@@ -20,23 +20,23 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
 /**
  * @public
  * <p>Sets the tags for a bucket.</p>
- *          <p>Use tags to organize your Amazon Web Services bill to reflect your own cost structure. To do this, sign
- *          up to get your Amazon Web Services account bill with tag key values included. Then, to see the cost of
- *          combined resources, organize your billing information according to resources with the same
- *          tag key values. For example, you can tag several resources with a specific application
+ *          <p>Use tags to organize your Amazon Web Services bill to reflect your own cost structure. To do this,
+ *          sign up to get your Amazon Web Services account bill with tag key values included. Then, to see the cost
+ *          of combined resources, organize your billing information according to resources with the
+ *          same tag key values. For example, you can tag several resources with a specific application
  *          name, and then organize your billing information to see the total cost of that application
- *          across several services. For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Cost Allocation
- *             and Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html">Using Cost Allocation in Amazon S3 Bucket
- *                Tags</a>.</p>
+ *          across several services. For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Cost Allocation and
+ *             Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html">Using Cost Allocation in Amazon S3 Bucket
+ *             Tags</a>.</p>
  *          <note>
- *             <p>
- *             When this operation sets the tags for a bucket, it will overwrite any current tags the
- *             bucket already has. You cannot use this operation to add tags to an existing list of tags.</p>
+ *             <p> When this operation sets the tags for a bucket, it will overwrite any current tags
+ *             the bucket already has. You cannot use this operation to add tags to an existing list of
+ *             tags.</p>
  *          </note>
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:PutBucketTagging</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>.</p>
+ *          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>.</p>
  *          <p>
  *             <code>PutBucketTagging</code> has the following special errors:</p>
  *          <ul>
@@ -116,6 +116,8 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketTaggingCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketTaggingCommandInput - {@link PutBucketTaggingCommandInput}
@@ -124,6 +126,8 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketTaggingCommandOutput} 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 tags on a bucket
  * ```javascript

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

@@ -30,21 +30,19 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
  *          <p>If the versioning state has never been set on a bucket, it has no versioning state; a
  *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a> request does not return a versioning state value.</p>
  *          <p>In order to enable MFA Delete, you must be the bucket owner. If you are the bucket owner
- *          and want to enable MFA Delete in the bucket versioning configuration, you must
- *          include the <code>x-amz-mfa request</code> header and the
- *             <code>Status</code> and the <code>MfaDelete</code> request elements in a request to set
- *          the versioning state of the bucket.</p>
+ *          and want to enable MFA Delete in the bucket versioning configuration, you must include the
+ *             <code>x-amz-mfa request</code> header and the <code>Status</code> and the
+ *             <code>MfaDelete</code> request elements in a request to set the versioning state of the
+ *          bucket.</p>
  *          <important>
- *             <p>If you have an object expiration lifecycle policy in your non-versioned bucket and
+ *             <p>If you have an object expiration lifecycle configuration in your non-versioned bucket and
  *             you want to maintain the same permanent delete behavior when you enable versioning, you
- *             must add a noncurrent expiration policy. The noncurrent expiration lifecycle policy will
+ *             must add a noncurrent expiration policy. The noncurrent expiration lifecycle configuration will
  *             manage the deletes of the noncurrent object versions in the version-enabled bucket. (A
  *             version-enabled bucket maintains one current and zero or more noncurrent object
  *             versions.) For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-and-other-bucket-config">Lifecycle and Versioning</a>.</p>
  *          </important>
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *          <p>The following operations are related to <code>PutBucketVersioning</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -81,6 +79,8 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketVersioningCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketVersioningCommandInput - {@link PutBucketVersioningCommandInput}
@@ -89,6 +89,8 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketVersioningCommandOutput} 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 versioning configuration on a bucket
  * ```javascript

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

@@ -182,6 +182,8 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
  * };
  * const command = new PutBucketWebsiteCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param PutBucketWebsiteCommandInput - {@link PutBucketWebsiteCommandInput}
@@ -190,6 +192,8 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketWebsiteCommandOutput} 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 website configuration on a bucket
  * ```javascript

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

@@ -24,54 +24,131 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  *          permission to set the ACL of an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions">What
  *             permissions can I grant?</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>
- *          <p>Depending on your application needs, you can choose to set
- *          the ACL on an object using either the request body or the headers. For example, if you have
- *          an existing application that updates a bucket ACL using the request body, you can continue
- *          to use that approach. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>Depending on your application needs, you can choose to set the ACL on an object using
+ *          either the request body or the headers. For example, if you have an existing application
+ *          that updates a bucket ACL using the request body, you can continue to use that approach.
+ *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a>
+ *          in the <i>Amazon S3 User Guide</i>.</p>
  *          <important>
- *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs are disabled and no longer affect permissions.
- *             You must use policies to grant access to your bucket and the objects in it. Requests to set ACLs or update ACLs fail and
- *             return the <code>AccessControlListNotSupported</code> error code. Requests to read ACLs are still supported.
- *             For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object ownership</a>
- *             in the <i>Amazon S3 User Guide</i>.</p>
+ *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs
+ *             are disabled and no longer affect permissions. You must use policies to grant access to
+ *             your bucket and the objects in it. Requests to set ACLs or update ACLs fail and return
+ *             the <code>AccessControlListNotSupported</code> error code. Requests to read ACLs are
+ *             still supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object
+ *                ownership</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          </important>
- *          <p>
- *             <b>Access Permissions</b>
- *          </p>
- *          <p>You can set access permissions using one of the following methods:</p>
- *          <ul>
- *             <li>
- *                <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports
- *                a set of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set
- *                of grantees and permissions. Specify the canned ACL name as the value of
- *                   <code>x-amz-ac</code>l. If you use this header, you cannot use other access
- *                control-specific headers in your request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned ACL</a>.</p>
- *             </li>
- *             <li>
- *                <p>Specify access permissions explicitly with the <code>x-amz-grant-read</code>,
- *                   <code>x-amz-grant-read-acp</code>, <code>x-amz-grant-write-acp</code>, and
- *                   <code>x-amz-grant-full-control</code> headers. When using these headers, you
- *                specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3 groups) who
- *                will receive the permission. If you use these ACL-specific headers, you cannot use
- *                   <code>x-amz-acl</code> header to set a canned ACL. These parameters map to the set
- *                of permissions that Amazon S3 supports in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
- *                Overview</a>.</p>
- *                <p>You specify each grantee as a type=value pair, where the type is one of the
- *                following:</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You can set access permissions using one of the following methods:</p>
  *                <ul>
  *                   <li>
+ *                      <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports
+ *                         a set of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set
+ *                         of grantees and permissions. Specify the canned ACL name as the value of
+ *                         <code>x-amz-ac</code>l. If you use this header, you cannot use other access
+ *                         control-specific headers in your request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
+ *                            ACL</a>.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>Specify access permissions explicitly with the <code>x-amz-grant-read</code>,
+ *                         <code>x-amz-grant-read-acp</code>, <code>x-amz-grant-write-acp</code>, and
+ *                         <code>x-amz-grant-full-control</code> headers. When using these headers, you
+ *                         specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3 groups) who
+ *                         will receive the permission. If you use these ACL-specific headers, you cannot use
+ *                         <code>x-amz-acl</code> header to set a canned ACL. These parameters map to the set
+ *                         of permissions that Amazon S3 supports in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control
+ *                            List (ACL) Overview</a>.</p>
+ *                      <p>You specify each grantee as a type=value pair, where the type is one of the
+ *                         following:</p>
+ *                      <ul>
+ *                         <li>
+ *                            <p>
+ *                               <code>id</code> – if the value specified is the canonical user ID of an
+ *                               Amazon Web Services account</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <code>uri</code> – if you are granting permissions to a predefined
+ *                               group</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <code>emailAddress</code> – if the value specified is the email address of
+ *                               an Amazon Web Services account</p>
+ *                            <note>
+ *                               <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
+ *                               <ul>
+ *                                  <li>
+ *                                     <p>US East (N. Virginia)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>US West (N. California)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p> US West (Oregon)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p> Asia Pacific (Singapore)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Asia Pacific (Sydney)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Asia Pacific (Tokyo)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>Europe (Ireland)</p>
+ *                                  </li>
+ *                                  <li>
+ *                                     <p>South America (São Paulo)</p>
+ *                                  </li>
+ *                               </ul>
+ *                               <p>For a list of all the Amazon S3 supported Regions and endpoints, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a> in the Amazon Web Services General Reference.</p>
+ *                            </note>
+ *                         </li>
+ *                      </ul>
+ *                      <p>For example, the following <code>x-amz-grant-read</code> header grants list
+ *                         objects permission to the two Amazon Web Services accounts identified by their email
+ *                         addresses.</p>
  *                      <p>
- *                         <code>id</code> – if the value specified is the canonical user ID of an Amazon Web Services account</p>
+ *                         <code>x-amz-grant-read: emailAddress="xyz@amazon.com",
+ *                         emailAddress="abc@amazon.com" </code>
+ *                      </p>
  *                   </li>
+ *                </ul>
+ *                <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
+ *                   both.</p>
+ *             </dd>
+ *             <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>uri</code> – if you are granting permissions to a predefined
- *                      group</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 URI:</p>
  *                      <p>
- *                         <code>emailAddress</code> – if the value specified is the email address of
- *                      an Amazon Web Services account</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>
+ *                   <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>lt;/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>
  *                      <note>
  *                         <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
  *                         <ul>
@@ -104,88 +181,15 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  *                      </note>
  *                   </li>
  *                </ul>
- *                <p>For example, the following <code>x-amz-grant-read</code> header grants list
- *                objects permission to the two Amazon Web Services accounts identified by their email
- *                addresses.</p>
- *                <p>
- *                   <code>x-amz-grant-read: emailAddress="xyz@amazon.com",
- *                   emailAddress="abc@amazon.com" </code>
- *                </p>
- *             </li>
- *          </ul>
- *          <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
- *          both.</p>
- *          <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 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>
- *             <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>lt;/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>
- *                <note>
- *                   <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
- *                   <ul>
- *                      <li>
- *                         <p>US East (N. Virginia)</p>
- *                      </li>
- *                      <li>
- *                         <p>US West (N. California)</p>
- *                      </li>
- *                      <li>
- *                         <p> US West (Oregon)</p>
- *                      </li>
- *                      <li>
- *                         <p> Asia Pacific (Singapore)</p>
- *                      </li>
- *                      <li>
- *                         <p>Asia Pacific (Sydney)</p>
- *                      </li>
- *                      <li>
- *                         <p>Asia Pacific (Tokyo)</p>
- *                      </li>
- *                      <li>
- *                         <p>Europe (Ireland)</p>
- *                      </li>
- *                      <li>
- *                         <p>South America (São Paulo)</p>
- *                      </li>
- *                   </ul>
- *                   <p>For a list of all the Amazon S3 supported Regions and endpoints, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a> in the Amazon Web Services General Reference.</p>
- *                </note>
- *             </li>
- *          </ul>
- *          <p>
- *             <b>Versioning</b>
- *          </p>
- *          <p>The ACL of an object is set at the object version level. By default, PUT sets the ACL of
- *          the current version of an object. To set the ACL of a different version, use the
- *             <code>versionId</code> subresource.</p>
- *          <p class="title">
- *             <b>Related Resources</b>
- *          </p>
+ *             </dd>
+ *             <dt>Versioning</dt>
+ *             <dd>
+ *                <p>The ACL of an object is set at the object version level. By default, PUT sets the ACL of
+ *                   the current version of an object. To set the ACL of a different version, use the
+ *                   <code>versionId</code> subresource.</p>
+ *             </dd>
+ *          </dl>
+ *          <p>The following operations are related to <code>PutObjectAcl</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -239,6 +243,10 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  * };
  * const command = new PutObjectAclCommand(input);
  * const response = await client.send(command);
+ * // { // PutObjectAclOutput
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param PutObjectAclCommandInput - {@link PutObjectAclCommandInput}
@@ -250,6 +258,8 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  * @throws {@link NoSuchKey} (client fault)
  *  <p>The specified key does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To grant permissions using object ACL
  * ```javascript