@aws-sdk/client-s3 3.326.0 → 3.328.0

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

@@ -19,7 +19,8 @@ export interface GetObjectRetentionCommandOutput extends GetObjectRetentionOutpu
 }
 /**
  * @public
- * <p>Retrieves an object's retention settings. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.</p>
+ * <p>Retrieves an object's retention settings. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
+ *          Objects</a>.</p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>
  *          <p>The following action is related to <code>GetObjectRetention</code>:</p>
  *          <ul>

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

@@ -22,11 +22,11 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * <p>Returns the tag-set of an object. You send the GET request against the tagging
  *          subresource associated with the object.</p>
  *          <p>To use this operation, you must have permission to perform the
- *             <code>s3:GetObjectTagging</code> action. By default, the GET action returns
- *          information about current version of an object. For a versioned bucket, you can have
- *          multiple versions of an object in your bucket. To retrieve tags of any other version, use
- *          the versionId query parameter. You also need permission for the
- *             <code>s3:GetObjectVersionTagging</code> action.</p>
+ *             <code>s3:GetObjectTagging</code> action. By default, the GET action returns information
+ *          about current version of an object. For a versioned bucket, you can have multiple versions
+ *          of an object in your bucket. To retrieve tags of any other version, use the versionId query
+ *          parameter. You also need permission for the <code>s3:GetObjectVersionTagging</code>
+ *          action.</p>
  *          <p> By default, the bucket owner has this permission and can grant this permission to
  *          others.</p>
  *          <p> For information about the Amazon S3 object tagging feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object Tagging</a>.</p>

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

@@ -20,7 +20,7 @@ export interface GetObjectTorrentCommandOutput extends __WithSdkStreamMixin<GetO
 /**
  * @public
  * <p>Returns torrent files from a bucket. BitTorrent can save you bandwidth when you're
- *          distributing large files. For more information about BitTorrent, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3Torrent.html">Using BitTorrent with Amazon S3</a>.</p>
+ *          distributing large files.</p>
  *          <note>
  *             <p>You can get torrent only for objects that are less than 5 GB in size, and that are
  *             not encrypted using server-side encryption with a customer-provided encryption

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

@@ -22,7 +22,7 @@ export interface GetPublicAccessBlockCommandOutput extends GetPublicAccessBlockO
  * <p>Retrieves the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket. To use
  *          this operation, you must have the <code>s3:GetBucketPublicAccessBlock</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>
+ *             Policy</a>.</p>
  *          <important>
  *             <p>When Amazon S3 evaluates the <code>PublicAccessBlock</code> configuration for a bucket or
  *             an object, it checks the <code>PublicAccessBlock</code> configuration for both the

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

@@ -19,17 +19,27 @@ export interface HeadBucketCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>This action is useful to determine if a bucket exists and you have permission to
- *          access it. The action returns a <code>200 OK</code> if the bucket exists and you have
- *          permission to access it.</p>
- *          <p>If the bucket does not exist or you do not have permission to access it, the <code>HEAD</code> request
- *          returns a generic <code>404 Not Found</code> or <code>403 Forbidden</code> code. A message body is not
- *          included, so you cannot determine the exception beyond these error codes.</p>
+ * <p>This action is useful to determine if a bucket exists and you have permission to access
+ *          it. The action returns a <code>200 OK</code> if the bucket exists and you have permission
+ *          to access it.</p>
+ *          <p>If the bucket does not exist or you do not have permission to access it, the
+ *             <code>HEAD</code> request returns a generic <code>400 Bad Request</code>, <code>403
+ *             Forbidden</code> or <code>404 Not Found</code> code. A message body is not included, so
+ *          you cannot determine the exception beyond these error codes.</p>
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:ListBucket</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>
- *          <p>To use this API against an access point, you must provide the alias of the access point in place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form AccessPointName-AccountId.s3-accesspoint.Region.amazonaws.com. When using the Amazon Web Services SDKs, you provide the ARN in place of the bucket name. For more information see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a>.</p>
+ *          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>To use this API operation against an access point, you must provide the alias of the access point in place of the
+ *          bucket name or specify the access point ARN. When using the access point ARN, you must direct requests to
+ *          the access point hostname. The access point hostname takes the form
+ *             <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com.
+ *          When using the Amazon Web Services SDKs, you provide the ARN in place of the bucket name. For more
+ *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a>.</p>
+ *          <p>To use this API operation against an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
+ * If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
+ * For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
+ *             Error Codes</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -19,14 +19,15 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
 }
 /**
  * @public
- * <p>The HEAD action retrieves metadata from an object without returning the object
- *          itself. This action is useful if you're only interested in an object's metadata. To use
- *          HEAD, you must have READ access to the object.</p>
+ * <p>The HEAD action retrieves metadata from an object without returning the object itself.
+ *          This action is useful if you're only interested in an object's metadata. To use HEAD, you
+ *          must have READ access to the object.</p>
  *          <p>A <code>HEAD</code> request has the same options as a <code>GET</code> action on an
  *          object. The response is identical to the <code>GET</code> response except that there is no
  *          response body. Because of this, if the <code>HEAD</code> request generates an error, it
- *          returns a generic <code>404 Not Found</code> or <code>403 Forbidden</code> code. It is not
- *          possible to retrieve the exact exception beyond these error codes.</p>
+ *          returns a generic <code>400 Bad Request</code>, <code>403 Forbidden</code> or <code>404 Not
+ *             Found</code> code. It is not possible to retrieve the exact exception beyond these error
+ *          codes.</p>
  *          <p>If you encrypt an object by using server-side encryption with customer-provided
  *          encryption keys (SSE-C) when you store the object in Amazon S3, then when you retrieve the
  *          metadata from the object, you must use the following headers:</p>
@@ -41,25 +42,25 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *                <p>x-amz-server-side-encryption-customer-key-MD5</p>
  *             </li>
  *          </ul>
- *          <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption (Using
- *             Customer-Provided Encryption Keys)</a>.</p>
+ *          <p>For more information about SSE-C, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Server-Side Encryption
+ *             (Using Customer-Provided Encryption Keys)</a>.</p>
  *          <note>
  *             <ul>
  *                <li>
- *                   <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>, should
- *             not be sent for GET requests if your object uses server-side encryption with KMS keys (SSE-KMS)
- *             or server-side encryption with Amazon S3–managed encryption keys
- *             (SSE-S3). If your object does use these types of keys, you’ll get an HTTP 400 BadRequest
- *             error.</p>
+ *                   <p>Encryption request headers, like <code>x-amz-server-side-encryption</code>,
+ *                   should not be sent for GET requests if your object uses server-side encryption
+ *                   with KMS keys (SSE-KMS) or server-side encryption with Amazon S3–managed encryption
+ *                   keys (SSE-S3). If your object does use these types of keys, you’ll get an HTTP 400
+ *                   BadRequest error.</p>
  *                </li>
  *                <li>
- *                   <p>
- *                The last modified property in this case is the creation date of the object.</p>
+ *                   <p> The last modified property in this case is the creation date of the
+ *                   object.</p>
  *                </li>
  *             </ul>
  *          </note>
- *          <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common Request
- *             Headers</a>.</p>
+ *          <p>Request headers are limited to 8 KB in size. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html">Common
+ *             Request Headers</a>.</p>
  *          <p>Consider the following when using request headers:</p>
  *          <ul>
  *             <li>
@@ -99,23 +100,25 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *             </li>
  *          </ul>
  *          <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
- *          <p>
- *             <b>Permissions</b>
- *          </p>
- *          <p>You need the relevant read object (or version) permission for this operation. For more
- *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions
- *             in a Policy</a>. If the object you request does not exist, the error Amazon S3 returns
- *          depends on whether you also have the s3:ListBucket permission.</p>
- *          <ul>
- *             <li>
- *                <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 returns
- *                an HTTP status code 404 ("no such key") error.</p>
- *             </li>
- *             <li>
- *                <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 returns an HTTP
- *                status code 403 ("access denied") error.</p>
- *             </li>
- *          </ul>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You need the relevant read object (or version) permission for this operation. For more
+ *                   information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html">Actions, resources, and condition keys for Amazon S3</a>.
+ *                   If the object you request does not exist, the error Amazon S3 returns depends
+ *                   on whether you also have the s3:ListBucket permission.</p>
+ *                <ul>
+ *                   <li>
+ *                      <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 returns
+ *                         an HTTP status code 404 ("no such key") error.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>If you don’t have the <code>s3:ListBucket</code> permission, Amazon S3 returns an HTTP
+ *                         status code 403 ("access denied") error.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *          </dl>
  *          <p>The following actions are related to <code>HeadObject</code>:</p>
  *          <ul>
  *             <li>

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

@@ -21,8 +21,8 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
  * @public
  * <p>Lists the analytics configurations for the bucket. You can have up to 1,000 analytics
  *          configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations
- *          at a time. You should always check the <code>IsTruncated</code> element in the response. If
+ *          <p>This action supports list pagination and does not return more than 100 configurations at
+ *          a time. You should always check the <code>IsTruncated</code> element in the response. If
  *          there are no more configurations to list, <code>IsTruncated</code> is set to false. If
  *          there are more configurations to list, <code>IsTruncated</code> is set to true, and there
  *          will be a value in <code>NextContinuationToken</code>. You use the
@@ -32,8 +32,8 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:GetAnalyticsConfiguration</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 Amazon S3 analytics feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
  *             Analysis</a>. </p>
  *          <p>The following operations are related to

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

@@ -23,8 +23,7 @@ export interface ListBucketIntelligentTieringConfigurationsCommandOutput extends
  *          <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>ListBucketIntelligentTieringConfigurations</code> include: </p>
+ *          <p>Operations related to <code>ListBucketIntelligentTieringConfigurations</code> include: </p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -21,9 +21,9 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  * @public
  * <p>Returns a list of inventory configurations for the bucket. You can have up to 1,000
  *          analytics configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations
- *          at a time. Always check the <code>IsTruncated</code> element in the response. If there are
- *          no more configurations to list, <code>IsTruncated</code> is set to false. If there are more
+ *          <p>This action supports list pagination and does not return more than 100 configurations at
+ *          a time. Always check the <code>IsTruncated</code> element in the response. If there are no
+ *          more configurations to list, <code>IsTruncated</code> is set to false. If there are more
  *          configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
  *             <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
  *          to continue the pagination of the list by passing the value in continuation-token in the
@@ -31,8 +31,8 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  *          <p> To use this operation, you must have permissions to perform the
  *             <code>s3:GetInventoryConfiguration</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>The following operations are related to

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

@@ -22,9 +22,9 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
  * <p>Lists the metrics configurations for the bucket. The metrics configurations are only for
  *          the request metrics of the bucket and do not provide information on daily storage metrics.
  *          You can have up to 1,000 configurations per bucket.</p>
- *          <p>This action supports list pagination and does not return more than 100 configurations
- *          at a time. Always check the <code>IsTruncated</code> element in the response. If there are
- *          no more configurations to list, <code>IsTruncated</code> is set to false. If there are more
+ *          <p>This action supports list pagination and does not return more than 100 configurations at
+ *          a time. Always check the <code>IsTruncated</code> element in the response. If there are no
+ *          more configurations to list, <code>IsTruncated</code> is set to false. If there are more
  *          configurations to list, <code>IsTruncated</code> is set to true, and there is a value in
  *             <code>NextContinuationToken</code>. You use the <code>NextContinuationToken</code> value
  *          to continue the pagination of the list by passing the value in
@@ -32,11 +32,10 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
  *          <p>To use this operation, you must have permissions to perform the
  *             <code>s3:GetMetricsConfiguration</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>
+ *          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 more information about metrics configurations and CloudWatch request metrics, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
- *             CloudWatch</a>.</p>
+ *             <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>ListBucketMetricsConfigurations</code>:</p>
  *          <ul>

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

@@ -20,7 +20,9 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
 /**
  * @public
  * <p>Returns a list of all buckets owned by the authenticated sender of the request. To use
- *         this operation, you must have the <code>s3:ListAllMyBuckets</code> permission.</p>
+ *          this operation, you must have the <code>s3:ListAllMyBuckets</code> permission. </p>
+ *          <p>For information about Amazon S3 buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html">Creating, configuring, and
+ *             working with Amazon S3 buckets</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -54,9 +56,9 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To list object versions
+ * @example To list all buckets
  * ```javascript
- * // The following example return versions of an object with specific key name prefix. The request limits the number of items returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify this token value in your next request to fetch next set of object versions.
+ * // The following example returns all the buckets owned by the sender of this request.
  * const input = undefined;
  * const command = new ListBucketsCommand(input);
  * const response = await client.send(command);
@@ -64,15 +66,15 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
  * {
  *   "Buckets": [
  *     {
- *       "CreationDate": "2012-02-15T21: 03: 02.000Z",
+ *       "CreationDate": "2012-02-15T21:03:02.000Z",
  *       "Name": "examplebucket"
  *     },
  *     {
- *       "CreationDate": "2011-07-24T19: 33: 50.000Z",
+ *       "CreationDate": "2011-07-24T19:33:50.000Z",
  *       "Name": "examplebucket2"
  *     },
  *     {
- *       "CreationDate": "2010-12-17T00: 56: 49.000Z",
+ *       "CreationDate": "2010-12-17T00:56:49.000Z",
  *       "Name": "examplebucket3"
  *     }
  *   ],
@@ -82,7 +84,7 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
  *   }
  * }
  * *\/
- * // example id: to-list-object-versions-1481910996058
+ * // example id: to-list-buckets-1481910996058
  * ```
  *
  */

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

@@ -35,8 +35,8 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
  *          upload initiation time.</p>
  *          <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
  *             Upload</a>.</p>
- *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
- *          Permissions</a>.</p>
+ *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
+ *             and Permissions</a>.</p>
  *          <p>The following operations are related to <code>ListMultipartUploads</code>:</p>
  *          <ul>
  *             <li>

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

@@ -23,10 +23,8 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  *          parameters as selection criteria to return metadata about a subset of all the object
  *          versions.</p>
  *          <important>
- *             <p>
- *             To use this operation, you must have permissions to perform the
- *             <code>s3:ListBucketVersions</code> action. Be aware of the name difference.
- *          </p>
+ *             <p> To use this operation, you must have permissions to perform the
+ *                <code>s3:ListBucketVersions</code> action. Be aware of the name difference. </p>
  *          </important>
  *          <note>
  *             <p> A 200 OK response can contain valid or invalid XML. Make sure to design your
@@ -34,8 +32,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  *          </note>
  *          <p>To use this operation, you must have READ access to the bucket.</p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>
- *          <p>The following operations are related to
- *             <code>ListObjectVersions</code>:</p>
+ *          <p>The following operations are related to <code>ListObjectVersions</code>:</p>
  *          <ul>
  *             <li>
  *                <p>

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

@@ -19,24 +19,23 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
 }
 /**
  * @public
- * <p>Returns some or all (up to 1,000) of the objects in a bucket with each request. You can use
- *          the request parameters as selection criteria to return a subset of the objects in a bucket. A
- *          <code>200 OK</code> response can contain valid or invalid XML. Make sure to design your
- *          application to parse the contents of the response and handle it appropriately.
+ * <p>Returns some or all (up to 1,000) of the objects in a bucket with each request. You can
+ *          use the request parameters as selection criteria to return a subset of the objects in a
+ *          bucket. A <code>200 OK</code> response can contain valid or invalid XML. Make sure to
+ *          design your application to parse the contents of the response and handle it appropriately.
  *          Objects are returned sorted in an ascending order of the respective key names in the list.
  *          For more information about listing objects, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ListingKeysUsingAPIs.html">Listing object keys
  *             programmatically</a>
  *          </p>
  *          <p>To use this operation, you must have READ access to the bucket.</p>
- *          <p>To use this action in an Identity and Access Management (IAM) policy, you must
- *          have permissions to perform the <code>s3:ListBucket</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>
+ *          <p>To use this action in an Identity and Access Management (IAM) policy, you must have permissions to perform
+ *          the <code>s3:ListBucket</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>
  *          <important>
- *             <p>This section describes the latest revision of this action. We recommend that you use this
- *             revised API for application development. For backward compatibility, Amazon S3 continues to
- *             support the prior version of this API, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html">ListObjects</a>.</p>
+ *             <p>This section describes the latest revision of this action. We recommend that you use
+ *             this revised API for application development. For backward compatibility, Amazon S3 continues
+ *             to support the prior version of this API, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html">ListObjects</a>.</p>
  *          </important>
  *          <p>To get a list of your buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html">ListBuckets</a>.</p>
  *          <p>The following operations are related to <code>ListObjectsV2</code>:</p>
@@ -129,7 +128,7 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  * ```javascript
  * // The following example retrieves object list. The request specifies max keys to limit response to include only 2 object keys.
  * const input = {
- *   "Bucket": "examplebucket",
+ *   "Bucket": "DOC-EXAMPLE-BUCKET",
  *   "MaxKeys": "2"
  * };
  * const command = new ListObjectsV2Command(input);
@@ -155,7 +154,7 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  *   "IsTruncated": true,
  *   "KeyCount": "2",
  *   "MaxKeys": "2",
- *   "Name": "examplebucket",
+ *   "Name": "DOC-EXAMPLE-BUCKET",
  *   "NextContinuationToken": "1w41l63U0xa8q7smH50vCxyTQqdxo69O3EmK28Bi5PcROI4wI/EyIJg==",
  *   "Prefix": ""
  * }

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

@@ -30,12 +30,11 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
  *          requests you can include the part-number-marker query string parameter and set its value to
  *          the <code>NextPartNumberMarker</code> field value from the previous response.</p>
  *          <p>If the upload was created using a checksum algorithm, you will need to have permission
- *            to the <code>kms:Decrypt</code> action for the request to succeed.
- *        </p>
+ *          to the <code>kms:Decrypt</code> action for the request to succeed. </p>
  *          <p>For more information on multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html">Uploading Objects Using Multipart
  *             Upload</a>.</p>
- *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload and
- *          Permissions</a>.</p>
+ *          <p>For information on permissions required to use the multipart upload API, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html">Multipart Upload
+ *             and Permissions</a>.</p>
  *          <p>The following operations are related to <code>ListParts</code>:</p>
  *          <ul>
  *             <li>

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

@@ -36,13 +36,14 @@ export interface PutBucketAccelerateConfigurationCommandOutput extends __Metadat
  *                <p> Suspended – Disables accelerated data transfers to the bucket.</p>
  *             </li>
  *          </ul>
- *          <p>The <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a> action returns the transfer acceleration
- *          state of a bucket.</p>
+ *          <p>The <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html">GetBucketAccelerateConfiguration</a> action returns the transfer acceleration state
+ *          of a bucket.</p>
  *          <p>After setting the Transfer Acceleration state of a bucket to Enabled, it might take up
  *          to thirty minutes before the data transfer rates to the bucket increase.</p>
  *          <p> The name of the bucket used for Transfer Acceleration must be DNS-compliant and must
  *          not contain periods (".").</p>
- *          <p> For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer Acceleration</a>.</p>
+ *          <p> For more information about transfer acceleration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html">Transfer
+ *          Acceleration</a>.</p>
  *          <p>The following operations are related to
  *          <code>PutBucketAccelerateConfiguration</code>:</p>
  *          <ul>