@aws-sdk/client-s3 3.325.0 → 3.327.0

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

@@ -24,10 +24,10 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
  *          <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>
- *          <p> For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
- *             CloudWatch</a>.</p>
+ *          permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing
+ *             Access Permissions to Your Amazon S3 Resources</a>.</p>
+ *          <p> For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring
+ *             Metrics with Amazon CloudWatch</a>.</p>
  *          <p>The following operations are related to
  *          <code>GetBucketMetricsConfiguration</code>:</p>
  *          <ul>
@@ -48,8 +48,7 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
- *                   CloudWatch</a>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>
  *                </p>
  *             </li>
  *          </ul>
@@ -66,6 +65,30 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
  * };
  * const command = new GetBucketMetricsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketMetricsConfigurationOutput
+ * //   MetricsConfiguration: { // 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 GetBucketMetricsConfigurationCommandInput - {@link GetBucketMetricsConfigurationCommandInput}
@@ -74,6 +97,8 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
  * @see {@link GetBucketMetricsConfigurationCommandOutput} 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 GetBucketMetricsConfigurationCommand extends $Command<GetBucketMetricsConfigurationCommandInput, GetBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -26,9 +26,14 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
  *          bucket. However, the bucket owner can use a bucket policy to grant permission to other
  *          users to read this configuration with the <code>s3:GetBucketNotification</code>
  *          permission.</p>
+ *          <p>To use this API operation against an access point, provide the alias of the access point in place of the bucket name.</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>
  *          <p>For more information about setting and reading the notification configuration on a
- *          bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of
- *             Bucket Events</a>. For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
+ *          bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Setting Up Notification of Bucket Events</a>. For more information about bucket
+ *          policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies</a>.</p>
  *          <p>The following action is related to <code>GetBucketNotification</code>:</p>
  *          <ul>
  *             <li>
@@ -49,6 +54,67 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
  * };
  * const command = new GetBucketNotificationConfigurationCommand(input);
  * const response = await client.send(command);
+ * // { // NotificationConfiguration
+ * //   TopicConfigurations: [ // TopicConfigurationList
+ * //     { // TopicConfiguration
+ * //       Id: "STRING_VALUE",
+ * //       TopicArn: "STRING_VALUE", // required
+ * //       Events: [ // EventList // required
+ * //         "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ * //       ],
+ * //       Filter: { // NotificationConfigurationFilter
+ * //         Key: { // S3KeyFilter
+ * //           FilterRules: [ // FilterRuleList
+ * //             { // FilterRule
+ * //               Name: "prefix" || "suffix",
+ * //               Value: "STRING_VALUE",
+ * //             },
+ * //           ],
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   QueueConfigurations: [ // QueueConfigurationList
+ * //     { // QueueConfiguration
+ * //       Id: "STRING_VALUE",
+ * //       QueueArn: "STRING_VALUE", // required
+ * //       Events: [ // required
+ * //         "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ * //       ],
+ * //       Filter: {
+ * //         Key: {
+ * //           FilterRules: [
+ * //             {
+ * //               Name: "prefix" || "suffix",
+ * //               Value: "STRING_VALUE",
+ * //             },
+ * //           ],
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   LambdaFunctionConfigurations: [ // LambdaFunctionConfigurationList
+ * //     { // LambdaFunctionConfiguration
+ * //       Id: "STRING_VALUE",
+ * //       LambdaFunctionArn: "STRING_VALUE", // required
+ * //       Events: [ // required
+ * //         "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ * //       ],
+ * //       Filter: {
+ * //         Key: {
+ * //           FilterRules: [
+ * //             {
+ * //               Name: "prefix" || "suffix",
+ * //               Value: "STRING_VALUE",
+ * //             },
+ * //           ],
+ * //         },
+ * //       },
+ * //     },
+ * //   ],
+ * //   EventBridgeConfiguration: {},
+ * // };
+ *
  * ```
  *
  * @param GetBucketNotificationConfigurationCommandInput - {@link GetBucketNotificationConfigurationCommandInput}
@@ -57,6 +123,8 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
  * @see {@link GetBucketNotificationConfigurationCommandOutput} 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 GetBucketNotificationConfigurationCommand extends $Command<GetBucketNotificationConfigurationCommandInput, GetBucketNotificationConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -21,9 +21,10 @@ export interface GetBucketOwnershipControlsCommandOutput extends GetBucketOwners
  * @public
  * <p>Retrieves <code>OwnershipControls</code> for an Amazon S3 bucket. To use this operation, you
  *          must have the <code>s3:GetBucketOwnershipControls</code> permission. For more information
- *          about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying
- *             permissions in a policy</a>. </p>
- *          <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object Ownership</a>. </p>
+ *          about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html">Specifying permissions in a
+ *             policy</a>. </p>
+ *          <p>For information about Amazon S3 Object Ownership, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Using Object
+ *             Ownership</a>. </p>
  *          <p>The following operations are related to <code>GetBucketOwnershipControls</code>:</p>
  *          <ul>
  *             <li>
@@ -49,6 +50,16 @@ export interface GetBucketOwnershipControlsCommandOutput extends GetBucketOwners
  * };
  * const command = new GetBucketOwnershipControlsCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketOwnershipControlsOutput
+ * //   OwnershipControls: { // OwnershipControls
+ * //     Rules: [ // OwnershipControlsRules // required
+ * //       { // OwnershipControlsRule
+ * //         ObjectOwnership: "BucketOwnerPreferred" || "ObjectWriter" || "BucketOwnerEnforced", // required
+ * //       },
+ * //     ],
+ * //   },
+ * // };
+ *
  * ```
  *
  * @param GetBucketOwnershipControlsCommandInput - {@link GetBucketOwnershipControlsCommandInput}
@@ -57,6 +68,8 @@ export interface GetBucketOwnershipControlsCommandOutput extends GetBucketOwners
  * @see {@link GetBucketOwnershipControlsCommandOutput} 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 GetBucketOwnershipControlsCommand extends $Command<GetBucketOwnershipControlsCommandInput, GetBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {

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

@@ -28,10 +28,18 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
  *          identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
  *             Allowed</code> error.</p>
  *          <important>
- *             <p>As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
- *             always use this operation, even if the policy explicitly denies the root user the
- *             ability to perform this action.</p>
+ *             <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
+ *             buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
+ *             <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
+ *             <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
+ *             denies the root principal's access. Bucket owner root principals can only be blocked from performing
+ *             these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
  *          </important>
+ *          <p>To use this API operation against an access point, provide the alias of the access point in place of the bucket name.</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>
  *          <p>For more information about bucket policies, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
  *             Policies</a>.</p>
  *          <p>The following action is related to <code>GetBucketPolicy</code>:</p>
@@ -54,6 +62,10 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
  * };
  * const command = new GetBucketPolicyCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketPolicyOutput
+ * //   Policy: "STRING_VALUE",
+ * // };
+ *
  * ```
  *
  * @param GetBucketPolicyCommandInput - {@link GetBucketPolicyCommandInput}
@@ -62,6 +74,8 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
  * @see {@link GetBucketPolicyCommandOutput} 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 get bucket policy
  * ```javascript

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

@@ -22,7 +22,7 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
  * <p>Retrieves the policy status for an Amazon S3 bucket, indicating whether the bucket is public.
  *          In order to use this operation, you must have the <code>s3:GetBucketPolicyStatus</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>
  *          <p> For more information about when Amazon S3 considers a bucket public, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status">The Meaning of "Public"</a>. </p>
  *          <p>The following operations are related to <code>GetBucketPolicyStatus</code>:</p>
  *          <ul>
@@ -60,6 +60,12 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
  * };
  * const command = new GetBucketPolicyStatusCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketPolicyStatusOutput
+ * //   PolicyStatus: { // PolicyStatus
+ * //     IsPublic: true || false,
+ * //   },
+ * // };
+ *
  * ```
  *
  * @param GetBucketPolicyStatusCommandInput - {@link GetBucketPolicyStatusCommandInput}
@@ -68,6 +74,8 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
  * @see {@link GetBucketPolicyStatusCommandOutput} 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 GetBucketPolicyStatusCommand extends $Command<GetBucketPolicyStatusCommandInput, GetBucketPolicyStatusCommandOutput, S3ClientResolvedConfig> {

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

@@ -61,6 +61,73 @@ export interface GetBucketReplicationCommandOutput extends GetBucketReplicationO
  * };
  * const command = new GetBucketReplicationCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketReplicationOutput
+ * //   ReplicationConfiguration: { // ReplicationConfiguration
+ * //     Role: "STRING_VALUE", // required
+ * //     Rules: [ // ReplicationRules // required
+ * //       { // ReplicationRule
+ * //         ID: "STRING_VALUE",
+ * //         Priority: Number("int"),
+ * //         Prefix: "STRING_VALUE",
+ * //         Filter: { // ReplicationRuleFilter Union: only one key present
+ * //           Prefix: "STRING_VALUE",
+ * //           Tag: { // Tag
+ * //             Key: "STRING_VALUE", // required
+ * //             Value: "STRING_VALUE", // required
+ * //           },
+ * //           And: { // ReplicationRuleAndOperator
+ * //             Prefix: "STRING_VALUE",
+ * //             Tags: [ // TagSet
+ * //               {
+ * //                 Key: "STRING_VALUE", // required
+ * //                 Value: "STRING_VALUE", // required
+ * //               },
+ * //             ],
+ * //           },
+ * //         },
+ * //         Status: "Enabled" || "Disabled", // required
+ * //         SourceSelectionCriteria: { // SourceSelectionCriteria
+ * //           SseKmsEncryptedObjects: { // SseKmsEncryptedObjects
+ * //             Status: "Enabled" || "Disabled", // required
+ * //           },
+ * //           ReplicaModifications: { // ReplicaModifications
+ * //             Status: "Enabled" || "Disabled", // required
+ * //           },
+ * //         },
+ * //         ExistingObjectReplication: { // ExistingObjectReplication
+ * //           Status: "Enabled" || "Disabled", // required
+ * //         },
+ * //         Destination: { // Destination
+ * //           Bucket: "STRING_VALUE", // required
+ * //           Account: "STRING_VALUE",
+ * //           StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ * //           AccessControlTranslation: { // AccessControlTranslation
+ * //             Owner: "Destination", // required
+ * //           },
+ * //           EncryptionConfiguration: { // EncryptionConfiguration
+ * //             ReplicaKmsKeyID: "STRING_VALUE",
+ * //           },
+ * //           ReplicationTime: { // ReplicationTime
+ * //             Status: "Enabled" || "Disabled", // required
+ * //             Time: { // ReplicationTimeValue
+ * //               Minutes: Number("int"),
+ * //             },
+ * //           },
+ * //           Metrics: { // Metrics
+ * //             Status: "Enabled" || "Disabled", // required
+ * //             EventThreshold: {
+ * //               Minutes: Number("int"),
+ * //             },
+ * //           },
+ * //         },
+ * //         DeleteMarkerReplication: { // DeleteMarkerReplication
+ * //           Status: "Enabled" || "Disabled",
+ * //         },
+ * //       },
+ * //     ],
+ * //   },
+ * // };
+ *
  * ```
  *
  * @param GetBucketReplicationCommandInput - {@link GetBucketReplicationCommandInput}
@@ -69,6 +136,8 @@ export interface GetBucketReplicationCommandOutput extends GetBucketReplicationO
  * @see {@link GetBucketReplicationCommandOutput} 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 get replication configuration set on a bucket
  * ```javascript

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

@@ -20,7 +20,8 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
 /**
  * @public
  * <p>Returns the request payment configuration of a bucket. To use this version of the
- *          operation, you must be the bucket owner. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays Buckets</a>.</p>
+ *          operation, you must be the bucket owner. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays
+ *             Buckets</a>.</p>
  *          <p>The following operations are related to <code>GetBucketRequestPayment</code>:</p>
  *          <ul>
  *             <li>
@@ -41,6 +42,10 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
  * };
  * const command = new GetBucketRequestPaymentCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketRequestPaymentOutput
+ * //   Payer: "Requester" || "BucketOwner",
+ * // };
+ *
  * ```
  *
  * @param GetBucketRequestPaymentCommandInput - {@link GetBucketRequestPaymentCommandInput}
@@ -49,6 +54,8 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
  * @see {@link GetBucketRequestPaymentCommandOutput} 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 get bucket versioning configuration
  * ```javascript

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

@@ -61,6 +61,15 @@ export interface GetBucketTaggingCommandOutput extends GetBucketTaggingOutput, _
  * };
  * const command = new GetBucketTaggingCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketTaggingOutput
+ * //   TagSet: [ // TagSet // required
+ * //     { // Tag
+ * //       Key: "STRING_VALUE", // required
+ * //       Value: "STRING_VALUE", // required
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param GetBucketTaggingCommandInput - {@link GetBucketTaggingCommandInput}
@@ -69,6 +78,8 @@ export interface GetBucketTaggingCommandOutput extends GetBucketTaggingOutput, _
  * @see {@link GetBucketTaggingCommandOutput} 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 get tag set associated with a bucket
  * ```javascript

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

@@ -54,6 +54,11 @@ export interface GetBucketVersioningCommandOutput extends GetBucketVersioningOut
  * };
  * const command = new GetBucketVersioningCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketVersioningOutput
+ * //   Status: "Enabled" || "Suspended",
+ * //   MFADelete: "Enabled" || "Disabled",
+ * // };
+ *
  * ```
  *
  * @param GetBucketVersioningCommandInput - {@link GetBucketVersioningCommandInput}
@@ -62,6 +67,8 @@ export interface GetBucketVersioningCommandOutput extends GetBucketVersioningOut
  * @see {@link GetBucketVersioningCommandOutput} 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 get bucket versioning configuration
  * ```javascript

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

@@ -21,13 +21,12 @@ export interface GetBucketWebsiteCommandOutput extends GetBucketWebsiteOutput, _
  * @public
  * <p>Returns the website configuration for a bucket. To host website on Amazon S3, you can
  *          configure a bucket as website by adding a website configuration. For more information about
- *          hosting websites, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on
- *             Amazon S3</a>. </p>
+ *          hosting websites, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on Amazon S3</a>. </p>
  *          <p>This GET action requires the <code>S3:GetBucketWebsite</code> permission. By default,
  *          only the bucket owner can read the bucket website configuration. However, bucket owners can
  *          allow other users to read the website configuration by writing a bucket policy granting
  *          them the <code>S3:GetBucketWebsite</code> permission.</p>
- *          <p>The following operations are related to <code>DeleteBucketWebsite</code>:</p>
+ *          <p>The following operations are related to <code>GetBucketWebsite</code>:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -52,6 +51,34 @@ export interface GetBucketWebsiteCommandOutput extends GetBucketWebsiteOutput, _
  * };
  * const command = new GetBucketWebsiteCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketWebsiteOutput
+ * //   RedirectAllRequestsTo: { // RedirectAllRequestsTo
+ * //     HostName: "STRING_VALUE", // required
+ * //     Protocol: "http" || "https",
+ * //   },
+ * //   IndexDocument: { // IndexDocument
+ * //     Suffix: "STRING_VALUE", // required
+ * //   },
+ * //   ErrorDocument: { // ErrorDocument
+ * //     Key: "STRING_VALUE", // required
+ * //   },
+ * //   RoutingRules: [ // RoutingRules
+ * //     { // RoutingRule
+ * //       Condition: { // Condition
+ * //         HttpErrorCodeReturnedEquals: "STRING_VALUE",
+ * //         KeyPrefixEquals: "STRING_VALUE",
+ * //       },
+ * //       Redirect: { // Redirect
+ * //         HostName: "STRING_VALUE",
+ * //         HttpRedirectCode: "STRING_VALUE",
+ * //         Protocol: "http" || "https",
+ * //         ReplaceKeyPrefixWith: "STRING_VALUE",
+ * //         ReplaceKeyWith: "STRING_VALUE",
+ * //       },
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param GetBucketWebsiteCommandInput - {@link GetBucketWebsiteCommandInput}
@@ -60,6 +87,8 @@ export interface GetBucketWebsiteCommandOutput extends GetBucketWebsiteOutput, _
  * @see {@link GetBucketWebsiteCommandOutput} 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 get bucket website configuration
  * ```javascript

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

@@ -25,17 +25,15 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
  *             User Guide</i>
  *          </p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>
- *          <p>
- *             <b>Versioning</b>
- *          </p>
  *          <p>By default, GET returns ACL information about the current version of an object. To
  *          return ACL information about a different version, use the versionId subresource.</p>
  *          <note>
  *             <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership,
- *             requests to read ACLs are still supported and return the <code>bucket-owner-full-control</code>
- *             ACL with the owner being the account that created the bucket. For more information, see
- *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">
- *                Controlling object ownership and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *             requests to read ACLs are still supported and return the
+ *                <code>bucket-owner-full-control</code> ACL with the owner being the account that
+ *             created the bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling object
+ *                ownership and disabling ACLs</a> in the
+ *             <i>Amazon S3 User Guide</i>.</p>
  *          </note>
  *          <p>The following operations are related to <code>GetObjectAcl</code>:</p>
  *          <ul>
@@ -75,6 +73,26 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
  * };
  * const command = new GetObjectAclCommand(input);
  * const response = await client.send(command);
+ * // { // GetObjectAclOutput
+ * //   Owner: { // Owner
+ * //     DisplayName: "STRING_VALUE",
+ * //     ID: "STRING_VALUE",
+ * //   },
+ * //   Grants: [ // Grants
+ * //     { // Grant
+ * //       Grantee: { // Grantee
+ * //         DisplayName: "STRING_VALUE",
+ * //         EmailAddress: "STRING_VALUE",
+ * //         ID: "STRING_VALUE",
+ * //         URI: "STRING_VALUE",
+ * //         Type: "CanonicalUser" || "AmazonCustomerByEmail" || "Group", // required
+ * //       },
+ * //       Permission: "FULL_CONTROL" || "WRITE" || "WRITE_ACP" || "READ" || "READ_ACP",
+ * //     },
+ * //   ],
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param GetObjectAclCommandInput - {@link GetObjectAclCommandInput}
@@ -86,6 +104,8 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
  * @throws {@link NoSuchKey} (client fault)
  *  <p>The specified key does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To retrieve object ACL
  * ```javascript