@aws-sdk/client-s3 3.325.0 → 3.327.0

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>
@@ -63,6 +63,16 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * };
  * const command = new GetObjectTaggingCommand(input);
  * const response = await client.send(command);
+ * // { // GetObjectTaggingOutput
+ * //   VersionId: "STRING_VALUE",
+ * //   TagSet: [ // TagSet // required
+ * //     { // Tag
+ * //       Key: "STRING_VALUE", // required
+ * //       Value: "STRING_VALUE", // required
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param GetObjectTaggingCommandInput - {@link GetObjectTaggingCommandInput}
@@ -71,6 +81,8 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * @see {@link GetObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To retrieve tag set of a specific object version
  * ```javascript

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
@@ -50,6 +50,11 @@ export interface GetObjectTorrentCommandOutput extends __WithSdkStreamMixin<GetO
  * };
  * const command = new GetObjectTorrentCommand(input);
  * const response = await client.send(command);
+ * // { // GetObjectTorrentOutput
+ * //   Body: "STREAMING_BLOB_VALUE",
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param GetObjectTorrentCommandInput - {@link GetObjectTorrentCommandInput}
@@ -58,6 +63,8 @@ export interface GetObjectTorrentCommandOutput extends __WithSdkStreamMixin<GetO
  * @see {@link GetObjectTorrentCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To retrieve torrent files for an object
  * ```javascript

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
@@ -68,6 +68,15 @@ export interface GetPublicAccessBlockCommandOutput extends GetPublicAccessBlockO
  * };
  * const command = new GetPublicAccessBlockCommand(input);
  * const response = await client.send(command);
+ * // { // GetPublicAccessBlockOutput
+ * //   PublicAccessBlockConfiguration: { // PublicAccessBlockConfiguration
+ * //     BlockPublicAcls: true || false,
+ * //     IgnorePublicAcls: true || false,
+ * //     BlockPublicPolicy: true || false,
+ * //     RestrictPublicBuckets: true || false,
+ * //   },
+ * // };
+ *
  * ```
  *
  * @param GetPublicAccessBlockCommandInput - {@link GetPublicAccessBlockCommandInput}
@@ -76,6 +85,8 @@ export interface GetPublicAccessBlockCommandOutput extends GetPublicAccessBlockO
  * @see {@link GetPublicAccessBlockCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class GetPublicAccessBlockCommand extends $Command<GetPublicAccessBlockCommandInput, GetPublicAccessBlockCommandOutput, S3ClientResolvedConfig> {

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
@@ -42,6 +52,8 @@ export interface HeadBucketCommandOutput extends __MetadataBearer {
  * };
  * const command = new HeadBucketCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param HeadBucketCommandInput - {@link HeadBucketCommandInput}
@@ -53,6 +65,8 @@ export interface HeadBucketCommandOutput extends __MetadataBearer {
  * @throws {@link NotFound} (client fault)
  *  <p>The specified content does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To determine if bucket exists
  * ```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>
@@ -154,6 +157,45 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  * };
  * const command = new HeadObjectCommand(input);
  * const response = await client.send(command);
+ * // { // HeadObjectOutput
+ * //   DeleteMarker: true || false,
+ * //   AcceptRanges: "STRING_VALUE",
+ * //   Expiration: "STRING_VALUE",
+ * //   Restore: "STRING_VALUE",
+ * //   ArchiveStatus: "ARCHIVE_ACCESS" || "DEEP_ARCHIVE_ACCESS",
+ * //   LastModified: new Date("TIMESTAMP"),
+ * //   ContentLength: Number("long"),
+ * //   ChecksumCRC32: "STRING_VALUE",
+ * //   ChecksumCRC32C: "STRING_VALUE",
+ * //   ChecksumSHA1: "STRING_VALUE",
+ * //   ChecksumSHA256: "STRING_VALUE",
+ * //   ETag: "STRING_VALUE",
+ * //   MissingMeta: Number("int"),
+ * //   VersionId: "STRING_VALUE",
+ * //   CacheControl: "STRING_VALUE",
+ * //   ContentDisposition: "STRING_VALUE",
+ * //   ContentEncoding: "STRING_VALUE",
+ * //   ContentLanguage: "STRING_VALUE",
+ * //   ContentType: "STRING_VALUE",
+ * //   Expires: new Date("TIMESTAMP"),
+ * //   WebsiteRedirectLocation: "STRING_VALUE",
+ * //   ServerSideEncryption: "AES256" || "aws:kms",
+ * //   Metadata: { // Metadata
+ * //     "<keys>": "STRING_VALUE",
+ * //   },
+ * //   SSECustomerAlgorithm: "STRING_VALUE",
+ * //   SSECustomerKeyMD5: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //   RequestCharged: "requester",
+ * //   ReplicationStatus: "COMPLETE" || "PENDING" || "FAILED" || "REPLICA",
+ * //   PartsCount: Number("int"),
+ * //   ObjectLockMode: "GOVERNANCE" || "COMPLIANCE",
+ * //   ObjectLockRetainUntilDate: new Date("TIMESTAMP"),
+ * //   ObjectLockLegalHoldStatus: "ON" || "OFF",
+ * // };
+ *
  * ```
  *
  * @param HeadObjectCommandInput - {@link HeadObjectCommandInput}
@@ -165,6 +207,8 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  * @throws {@link NotFound} (client fault)
  *  <p>The specified content does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To retrieve metadata of an object without returning the object itself
  * ```javascript

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
@@ -68,6 +68,46 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
  * };
  * const command = new ListBucketAnalyticsConfigurationsCommand(input);
  * const response = await client.send(command);
+ * // { // ListBucketAnalyticsConfigurationsOutput
+ * //   IsTruncated: true || false,
+ * //   ContinuationToken: "STRING_VALUE",
+ * //   NextContinuationToken: "STRING_VALUE",
+ * //   AnalyticsConfigurationList: [ // AnalyticsConfigurationList
+ * //     { // AnalyticsConfiguration
+ * //       Id: "STRING_VALUE", // required
+ * //       Filter: { // AnalyticsFilter Union: only one key present
+ * //         Prefix: "STRING_VALUE",
+ * //         Tag: { // Tag
+ * //           Key: "STRING_VALUE", // required
+ * //           Value: "STRING_VALUE", // required
+ * //         },
+ * //         And: { // AnalyticsAndOperator
+ * //           Prefix: "STRING_VALUE",
+ * //           Tags: [ // TagSet
+ * //             {
+ * //               Key: "STRING_VALUE", // required
+ * //               Value: "STRING_VALUE", // required
+ * //             },
+ * //           ],
+ * //         },
+ * //       },
+ * //       StorageClassAnalysis: { // StorageClassAnalysis
+ * //         DataExport: { // StorageClassAnalysisDataExport
+ * //           OutputSchemaVersion: "V_1", // required
+ * //           Destination: { // AnalyticsExportDestination
+ * //             S3BucketDestination: { // AnalyticsS3BucketDestination
+ * //               Format: "CSV", // required
+ * //               BucketAccountId: "STRING_VALUE",
+ * //               Bucket: "STRING_VALUE", // required
+ * //               Prefix: "STRING_VALUE",
+ * //             },
+ * //           },
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param ListBucketAnalyticsConfigurationsCommandInput - {@link ListBucketAnalyticsConfigurationsCommandInput}
@@ -76,6 +116,8 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
  * @see {@link ListBucketAnalyticsConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class ListBucketAnalyticsConfigurationsCommand extends $Command<ListBucketAnalyticsConfigurationsCommandInput, ListBucketAnalyticsConfigurationsCommandOutput, S3ClientResolvedConfig> {

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>
@@ -54,6 +53,40 @@ export interface ListBucketIntelligentTieringConfigurationsCommandOutput extends
  * };
  * const command = new ListBucketIntelligentTieringConfigurationsCommand(input);
  * const response = await client.send(command);
+ * // { // ListBucketIntelligentTieringConfigurationsOutput
+ * //   IsTruncated: true || false,
+ * //   ContinuationToken: "STRING_VALUE",
+ * //   NextContinuationToken: "STRING_VALUE",
+ * //   IntelligentTieringConfigurationList: [ // IntelligentTieringConfigurationList
+ * //     { // IntelligentTieringConfiguration
+ * //       Id: "STRING_VALUE", // required
+ * //       Filter: { // IntelligentTieringFilter
+ * //         Prefix: "STRING_VALUE",
+ * //         Tag: { // Tag
+ * //           Key: "STRING_VALUE", // required
+ * //           Value: "STRING_VALUE", // required
+ * //         },
+ * //         And: { // IntelligentTieringAndOperator
+ * //           Prefix: "STRING_VALUE",
+ * //           Tags: [ // TagSet
+ * //             {
+ * //               Key: "STRING_VALUE", // required
+ * //               Value: "STRING_VALUE", // required
+ * //             },
+ * //           ],
+ * //         },
+ * //       },
+ * //       Status: "Enabled" || "Disabled", // required
+ * //       Tierings: [ // TieringList // required
+ * //         { // Tiering
+ * //           Days: Number("int"), // required
+ * //           AccessTier: "ARCHIVE_ACCESS" || "DEEP_ARCHIVE_ACCESS", // required
+ * //         },
+ * //       ],
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param ListBucketIntelligentTieringConfigurationsCommandInput - {@link ListBucketIntelligentTieringConfigurationsCommandInput}
@@ -62,6 +95,8 @@ export interface ListBucketIntelligentTieringConfigurationsCommandOutput extends
  * @see {@link ListBucketIntelligentTieringConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class ListBucketIntelligentTieringConfigurationsCommand extends $Command<ListBucketIntelligentTieringConfigurationsCommandInput, ListBucketIntelligentTieringConfigurationsCommandOutput, S3ClientResolvedConfig> {

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
@@ -67,6 +67,42 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  * };
  * const command = new ListBucketInventoryConfigurationsCommand(input);
  * const response = await client.send(command);
+ * // { // ListBucketInventoryConfigurationsOutput
+ * //   ContinuationToken: "STRING_VALUE",
+ * //   InventoryConfigurationList: [ // InventoryConfigurationList
+ * //     { // InventoryConfiguration
+ * //       Destination: { // InventoryDestination
+ * //         S3BucketDestination: { // InventoryS3BucketDestination
+ * //           AccountId: "STRING_VALUE",
+ * //           Bucket: "STRING_VALUE", // required
+ * //           Format: "CSV" || "ORC" || "Parquet", // required
+ * //           Prefix: "STRING_VALUE",
+ * //           Encryption: { // InventoryEncryption
+ * //             SSES3: {},
+ * //             SSEKMS: { // SSEKMS
+ * //               KeyId: "STRING_VALUE", // required
+ * //             },
+ * //           },
+ * //         },
+ * //       },
+ * //       IsEnabled: true || false, // required
+ * //       Filter: { // InventoryFilter
+ * //         Prefix: "STRING_VALUE", // required
+ * //       },
+ * //       Id: "STRING_VALUE", // required
+ * //       IncludedObjectVersions: "All" || "Current", // required
+ * //       OptionalFields: [ // InventoryOptionalFields
+ * //         "Size" || "LastModifiedDate" || "StorageClass" || "ETag" || "IsMultipartUploaded" || "ReplicationStatus" || "EncryptionStatus" || "ObjectLockRetainUntilDate" || "ObjectLockMode" || "ObjectLockLegalHoldStatus" || "IntelligentTieringAccessTier" || "BucketKeyStatus" || "ChecksumAlgorithm",
+ * //       ],
+ * //       Schedule: { // InventorySchedule
+ * //         Frequency: "Daily" || "Weekly", // required
+ * //       },
+ * //     },
+ * //   ],
+ * //   IsTruncated: true || false,
+ * //   NextContinuationToken: "STRING_VALUE",
+ * // };
+ *
  * ```
  *
  * @param ListBucketInventoryConfigurationsCommandInput - {@link ListBucketInventoryConfigurationsCommandInput}
@@ -75,6 +111,8 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  * @see {@link ListBucketInventoryConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class ListBucketInventoryConfigurationsCommand extends $Command<ListBucketInventoryConfigurationsCommandInput, ListBucketInventoryConfigurationsCommandOutput, S3ClientResolvedConfig> {

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>
@@ -69,6 +68,35 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
  * };
  * const command = new ListBucketMetricsConfigurationsCommand(input);
  * const response = await client.send(command);
+ * // { // ListBucketMetricsConfigurationsOutput
+ * //   IsTruncated: true || false,
+ * //   ContinuationToken: "STRING_VALUE",
+ * //   NextContinuationToken: "STRING_VALUE",
+ * //   MetricsConfigurationList: [ // MetricsConfigurationList
+ * //     { // MetricsConfiguration
+ * //       Id: "STRING_VALUE", // required
+ * //       Filter: { // MetricsFilter Union: only one key present
+ * //         Prefix: "STRING_VALUE",
+ * //         Tag: { // Tag
+ * //           Key: "STRING_VALUE", // required
+ * //           Value: "STRING_VALUE", // required
+ * //         },
+ * //         AccessPointArn: "STRING_VALUE",
+ * //         And: { // MetricsAndOperator
+ * //           Prefix: "STRING_VALUE",
+ * //           Tags: [ // TagSet
+ * //             {
+ * //               Key: "STRING_VALUE", // required
+ * //               Value: "STRING_VALUE", // required
+ * //             },
+ * //           ],
+ * //           AccessPointArn: "STRING_VALUE",
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param ListBucketMetricsConfigurationsCommandInput - {@link ListBucketMetricsConfigurationsCommandInput}
@@ -77,6 +105,8 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
  * @see {@link ListBucketMetricsConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class ListBucketMetricsConfigurationsCommand extends $Command<ListBucketMetricsConfigurationsCommandInput, ListBucketMetricsConfigurationsCommandOutput, S3ClientResolvedConfig> {