@aws-sdk/client-s3 3.353.0 → 3.357.0

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

@@ -40,7 +40,7 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  *          request types, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html#VirtualHostingSpecifyBucket">HTTP Host
  *             Header Bucket Specification</a>.</p>
  *          <p>For more information about returning the ACL of an object, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html">GetObjectAcl</a>.</p>
- *          <p>If the object you are retrieving is stored in the S3 Glacier or
+ *          <p>If the object you are retrieving is stored in the S3 Glacier Flexible Retrieval or
  *          S3 Glacier Deep Archive storage class, or S3 Intelligent-Tiering Archive or
  *          S3 Intelligent-Tiering Deep Archive tiers, before you can retrieve the object you must first restore a
  *          copy using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html">RestoreObject</a>. Otherwise, this action returns an
@@ -48,21 +48,28 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/restoring-objects.html">Restoring
  *             Archived Objects</a>.</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>
+ *          be sent for GET requests if your object uses server-side encryption with Key Management Service (KMS)
+ *          keys (SSE-KMS), dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-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 Bad Request error.</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 GET the object,
  *          you must use the following headers:</p>
  *          <ul>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-algorithm</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-algorithm</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-key</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-key</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-key-MD5</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-key-MD5</code>
+ *                </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
@@ -76,22 +83,16 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  *             <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/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
+ *                      Policy</a>. If the object that you request doesn’t exist, the error that Amazon S3 returns depends
  *                   on whether you also have the <code>s3:ListBucket</code> permission.</p>
- *                <ul>
- *                   <li>
- *                      <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3 will
- *                         return 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 will return an
+ *                <p>If you have the <code>s3:ListBucket</code> permission on the bucket, Amazon S3
+ *                         returns an HTTP status code 404 (Not Found) error.</p>
+ *                <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>
  *             <dt>Versioning</dt>
  *             <dd>
- *                <p>By default, the GET action returns the current version of an object. To return a
+ *                <p>By default, the <code>GET</code> action returns the current version of an object. To return a
  *                   different version, use the <code>versionId</code> subresource.</p>
  *                <note>
  *                   <ul>
@@ -114,17 +115,17 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  *             </dd>
  *             <dt>Overriding Response Header Values</dt>
  *             <dd>
- *                <p>There are times when you want to override certain response header values in a GET
+ *                <p>There are times when you want to override certain response header values in a <code>GET</code>
  *                   response. For example, you might override the <code>Content-Disposition</code> response
- *                   header value in your GET request.</p>
+ *          header value in your <code>GET</code> request.</p>
  *                <p>You can override values for a set of response headers using the following query
  *                   parameters. These response header values are sent only on a successful request, that is,
  *                   when status code 200 OK is returned. The set of headers you can override using these
  *                   parameters is a subset of the headers that Amazon S3 accepts when you create an object. The
- *                   response headers that you can override for the GET response are <code>Content-Type</code>,
+ *                   response headers that you can override for the <code>GET</code> response are <code>Content-Type</code>,
  *                   <code>Content-Language</code>, <code>Expires</code>, <code>Cache-Control</code>,
  *                   <code>Content-Disposition</code>, and <code>Content-Encoding</code>. To override these
- *                   header values in the GET response, you use the following request parameters.</p>
+ *                   header values in the <code>GET</code> response, you use the following request parameters.</p>
  *                <note>
  *                   <p>You must sign the request, either using an Authorization header or a presigned URL,
  *                      when using these parameters. They cannot be used with an unsigned (anonymous)
@@ -166,13 +167,13 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  *             <dt>Overriding Response Header Values</dt>
  *             <dd>
  *                <p>If both of the <code>If-Match</code> and <code>If-Unmodified-Since</code> headers are
- *                   present in the request as follows: <code>If-Match</code> condition evaluates to
- *                   <code>true</code>, and; <code>If-Unmodified-Since</code> condition evaluates to
- *                   <code>false</code>; then, S3 returns 200 OK and the data requested. </p>
+ *                  present in the request as follows: <code>If-Match</code> condition evaluates to
+ *                  <code>true</code>, and; <code>If-Unmodified-Since</code> condition evaluates to
+ *                  <code>false</code>; then, S3 returns 200 OK and the data requested. </p>
  *                <p>If both of the <code>If-None-Match</code> and <code>If-Modified-Since</code> headers are
- *                   present in the request as follows:<code> If-None-Match</code> condition evaluates to
- *                   <code>false</code>, and; <code>If-Modified-Since</code> condition evaluates to
- *                   <code>true</code>; then, S3 returns 304 Not Modified response code.</p>
+ *                  present in the request as follows:<code> If-None-Match</code> condition evaluates to
+ *                  <code>false</code>, and; <code>If-Modified-Since</code> condition evaluates to
+ *                  <code>true</code>; then, S3 returns 304 Not Modified response code.</p>
  *                <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
  *             </dd>
  *          </dl>
@@ -278,53 +279,53 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To retrieve an object
+ * @example To retrieve a byte range of an object
  * ```javascript
- * // The following example retrieves an object for an S3 bucket.
+ * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "SampleFile.txt",
+ *   "Range": "bytes=0-9"
  * };
  * const command = new GetObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "AcceptRanges": "bytes",
- *   "ContentLength": "3191",
- *   "ContentType": "image/jpeg",
- *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
+ *   "ContentLength": "10",
+ *   "ContentRange": "bytes 0-9/43",
+ *   "ContentType": "text/plain",
+ *   "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
+ *   "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
  *   "Metadata": {},
- *   "TagCount": 2,
  *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-an-object-1481827837012
+ * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
  * ```
  *
- * @example To retrieve a byte range of an object
+ * @example To retrieve an object
  * ```javascript
- * // The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a specific byte range.
+ * // The following example retrieves an object for an S3 bucket.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "SampleFile.txt",
- *   "Range": "bytes=0-9"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new GetObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "AcceptRanges": "bytes",
- *   "ContentLength": "10",
- *   "ContentRange": "bytes 0-9/43",
- *   "ContentType": "text/plain",
- *   "ETag": "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
- *   "LastModified": "Thu, 09 Oct 2014 22:57:28 GMT",
+ *   "ContentLength": "3191",
+ *   "ContentType": "image/jpeg",
+ *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
+ *   "LastModified": "Thu, 15 Dec 2016 01:19:41 GMT",
  *   "Metadata": {},
+ *   "TagCount": 2,
  *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-a-byte-range-of-an-object--1481832674603
+ * // example id: to-retrieve-an-object-1481827837012
  * ```
  *
  */

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

@@ -88,13 +88,12 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To retrieve tag set of a specific object version
+ * @example To retrieve tag set of an object
  * ```javascript
- * // The following example retrieves tag set of an object. The request specifies object version.
+ * // The following example retrieves tag set of an object.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new GetObjectTaggingCommand(input);
  * const response = await client.send(command);
@@ -102,22 +101,27 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * {
  *   "TagSet": [
  *     {
- *       "Key": "Key1",
- *       "Value": "Value1"
+ *       "Key": "Key4",
+ *       "Value": "Value4"
+ *     },
+ *     {
+ *       "Key": "Key3",
+ *       "Value": "Value3"
  *     }
  *   ],
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
+ * // example id: to-retrieve-tag-set-of-an-object-1481833847896
  * ```
  *
- * @example To retrieve tag set of an object
+ * @example To retrieve tag set of a specific object version
  * ```javascript
- * // The following example retrieves tag set of an object.
+ * // The following example retrieves tag set of an object. The request specifies object version.
  * const input = {
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "exampleobject",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * };
  * const command = new GetObjectTaggingCommand(input);
  * const response = await client.send(command);
@@ -125,18 +129,14 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * {
  *   "TagSet": [
  *     {
- *       "Key": "Key4",
- *       "Value": "Value4"
- *     },
- *     {
- *       "Key": "Key3",
- *       "Value": "Value3"
+ *       "Key": "Key1",
+ *       "Value": "Value1"
  *     }
  *   ],
- *   "VersionId": "null"
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * }
  * *\/
- * // example id: to-retrieve-tag-set-of-an-object-1481833847896
+ * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
  * ```
  *
  */

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

@@ -23,8 +23,8 @@ 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
+ * <p>The <code>HEAD</code> 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 <code>HEAD</code>, 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
@@ -37,13 +37,19 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *          metadata from the object, you must use the following headers:</p>
  *          <ul>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-algorithm</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-algorithm</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-key</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-key</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>x-amz-server-side-encryption-customer-key-MD5</p>
+ *                <p>
+ *                   <code>x-amz-server-side-encryption-customer-key-MD5</code>
+ *                </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
@@ -52,10 +58,11 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *             <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>
+ *                   should not be sent for <code>GET</code> requests if your object uses server-side
+ *                   encryption with Key Management Service (KMS) keys (SSE-KMS), dual-layer server-side
+ *                   encryption with Amazon Web Services KMS keys (DSSE-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 Bad Request error.</p>
  *                </li>
  *                <li>
  *                   <p> The last modified property in this case is the creation date of the
@@ -109,16 +116,16 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  *             <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
+ *                   If the object you request doesn't exist, the error that 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>
+ *                         an HTTP status code 404 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>
+ *                         status code 403 error.</p>
  *                   </li>
  *                </ul>
  *             </dd>

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

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

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

@@ -74,6 +74,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  *   Prefix: "STRING_VALUE",
  *   VersionIdMarker: "STRING_VALUE",
  *   ExpectedBucketOwner: "STRING_VALUE",
+ *   RequestPayer: "requester",
  * };
  * const command = new ListObjectVersionsCommand(input);
  * const response = await client.send(command);
@@ -123,6 +124,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  * //     },
  * //   ],
  * //   EncodingType: "url",
+ * //   RequestCharged: "requester",
  * // };
  *
  * ```

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

@@ -107,6 +107,7 @@ export interface ListObjectsCommandOutput extends ListObjectsOutput, __MetadataB
  * //     },
  * //   ],
  * //   EncodingType: "url",
+ * //   RequestCharged: "requester",
  * // };
  *
  * ```

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

@@ -112,6 +112,7 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  * //   ContinuationToken: "STRING_VALUE",
  * //   NextContinuationToken: "STRING_VALUE",
  * //   StartAfter: "STRING_VALUE",
+ * //   RequestCharged: "requester",
  * // };
  *
  * ```

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

@@ -54,7 +54,7 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
  *          <dl>
  *             <dt>Permissions</dt>
  *             <dd>
- *                <p>You can set access permissions using one of the following methods:</p>
+ *                <p>You can set access permissions by 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

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

@@ -25,20 +25,21 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
  * @public
  * <p>This action uses the <code>encryption</code> subresource to configure default encryption
  *          and Amazon S3 Bucket Keys for an existing bucket.</p>
- *          <p>By default, all buckets have a default encryption configuration that
- *          uses server-side encryption with Amazon S3 managed keys (SSE-S3).
- *          You can optionally configure default encryption for a bucket by using server-side
- *          encryption with an Amazon Web Services KMS key (SSE-KMS) or a customer-provided key (SSE-C). If you specify default encryption by using
- *          SSE-KMS, you can also configure Amazon S3 Bucket Keys. For information about bucket default encryption,
- *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3
- *             bucket default encryption</a> in the <i>Amazon S3 User Guide</i>. For more
- *          information about S3 Bucket Keys, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the
- *             <i>Amazon S3 User Guide</i>.</p>
+ *          <p>By default, all buckets have a default encryption configuration that uses server-side
+ *          encryption with Amazon S3 managed keys (SSE-S3). You can optionally configure default encryption
+ *          for a bucket by using server-side encryption with Key Management Service (KMS) keys (SSE-KMS),
+ *          dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS), or server-side
+ *          encryption with customer-provided keys (SSE-C). If you specify default encryption by using
+ *          SSE-KMS, you can also configure Amazon S3 Bucket Keys. For information about bucket default
+ *          encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 bucket default encryption</a>
+ *          in the <i>Amazon S3 User Guide</i>. For more information about S3 Bucket Keys, see
+ *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket
+ *             Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
  *          <important>
  *             <p>This action requires Amazon Web Services Signature Version 4. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">
  *                Authenticating Requests (Amazon Web Services Signature Version 4)</a>. </p>
  *          </important>
- *          <p>To use this operation, you must have permissions to perform the
+ *          <p>To use this operation, you must have permission to perform the
  *             <code>s3:PutEncryptionConfiguration</code> action. The bucket owner has this permission
  *          by default. The bucket owner can grant this permission to others. For more information
  *          about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing

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

@@ -44,11 +44,11 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  *                   of the following:</p>
  *                <ul>
  *                   <li>
- *                      <p>Filter identifying a subset of objects to which the rule applies. The filter can
+ *                      <p>A 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>
+ *                      <p>A status indicating whether the rule is in effect.</p>
  *                   </li>
  *                   <li>
  *                      <p>One or more lifecycle transition and expiration actions that you want Amazon S3 to
@@ -70,7 +70,7 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  *                   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
+ *                <p>You can also explicitly deny permissions. An 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>