@aws-sdk/client-s3 3.289.0 → 3.290.0

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

@@ -67,6 +67,10 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  * @see {@link AbortMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchUpload} (client fault)
+ *  <p>The specified multipart upload does not exist.</p>
+ *
+ *
  * @example To abort a multipart upload
  * ```javascript
  * // The following example aborts a multipart upload.

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

@@ -139,6 +139,7 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * @see {@link CompleteMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To complete multipart upload
  * ```javascript
  * // The following example completes a multipart upload.

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

@@ -212,6 +212,11 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  * @see {@link CopyObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link ObjectNotInActiveTierError} (client fault)
+ *  <p>The source object of the COPY action is not in the active tier and is only stored in
+ *          Amazon S3 Glacier.</p>
+ *
+ *
  * @example To copy an object
  * ```javascript
  * // The following example copies an object from one bucket to another.

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

@@ -174,6 +174,17 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * @see {@link CreateBucketCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link BucketAlreadyExists} (client fault)
+ *  <p>The requested bucket name is not available. The bucket namespace is shared by all users
+ *          of the system. Select a different name and try again.</p>
+ *
+ * @throws {@link BucketAlreadyOwnedByYou} (client fault)
+ *  <p>The bucket you tried to create already exists, and you own it. Amazon S3 returns this error
+ *          in all Amazon Web Services Regions except in the North Virginia Region. For legacy compatibility, if you
+ *          re-create an existing bucket that you already own in the North Virginia Region, Amazon S3
+ *          returns 200 OK and resets the bucket access control lists (ACLs).</p>
+ *
+ *
  * @example To create a bucket in a specific region
  * ```javascript
  * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.

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

@@ -296,6 +296,7 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  * @see {@link CreateMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To initiate a multipart upload
  * ```javascript
  * // The following example initiates a multipart upload.

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

@@ -56,6 +56,7 @@ export interface DeleteBucketAnalyticsConfigurationCommandOutput extends __Metad
  * @see {@link DeleteBucketAnalyticsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketAnalyticsConfigurationCommand extends $Command<DeleteBucketAnalyticsConfigurationCommandInput, DeleteBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketAnalyticsConfigurationCommandInput;

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

@@ -45,6 +45,7 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete a bucket
  * ```javascript
  * // The following example deletes the specified bucket.

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

@@ -49,6 +49,7 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketCorsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete cors configuration on a bucket.
  * ```javascript
  * // The following example deletes CORS configuration on a bucket.

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

@@ -51,6 +51,7 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketEncryptionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketEncryptionCommand extends $Command<DeleteBucketEncryptionCommandInput, DeleteBucketEncryptionCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketEncryptionCommandInput;

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

@@ -51,6 +51,7 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  * @see {@link DeleteBucketIntelligentTieringConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketIntelligentTieringConfigurationCommand extends $Command<DeleteBucketIntelligentTieringConfigurationCommandInput, DeleteBucketIntelligentTieringConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketIntelligentTieringConfigurationCommandInput;

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

@@ -54,6 +54,7 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  * @see {@link DeleteBucketInventoryConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketInventoryConfigurationCommand extends $Command<DeleteBucketInventoryConfigurationCommandInput, DeleteBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketInventoryConfigurationCommandInput;

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

@@ -52,6 +52,7 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketLifecycleCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete lifecycle configuration on a bucket.
  * ```javascript
  * // The following example deletes lifecycle configuration on a bucket.

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

@@ -62,6 +62,7 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  * @see {@link DeleteBucketMetricsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketMetricsConfigurationCommand extends $Command<DeleteBucketMetricsConfigurationCommandInput, DeleteBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketMetricsConfigurationCommandInput;

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

@@ -47,6 +47,7 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * @see {@link DeleteBucketOwnershipControlsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeleteBucketOwnershipControlsCommand extends $Command<DeleteBucketOwnershipControlsCommandInput, DeleteBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketOwnershipControlsCommandInput;

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

@@ -58,6 +58,7 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketPolicyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete bucket policy
  * ```javascript
  * // The following example deletes bucket policy on the specified bucket.

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

@@ -52,6 +52,7 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketReplicationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete bucket replication configuration
  * ```javascript
  * // The following example deletes replication configuration set on bucket.

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

@@ -45,6 +45,7 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete bucket tags
  * ```javascript
  * // The following example deletes bucket tags.

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

@@ -52,6 +52,7 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketWebsiteCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete bucket website configuration
  * ```javascript
  * // The following example deletes bucket website configuration.

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

@@ -54,6 +54,7 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * @see {@link DeleteObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete an object (from a non-versioned bucket)
  * ```javascript
  * // The following example deletes an object from a non-versioned bucket.

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

@@ -50,6 +50,7 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * @see {@link DeleteObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To remove tag set from an object
  * ```javascript
  * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.

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

@@ -80,6 +80,7 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * @see {@link DeleteObjectsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To delete multiple objects from a versioned bucket
  * ```javascript
  * // The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.

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

@@ -56,6 +56,7 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
  * @see {@link DeletePublicAccessBlockCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class DeletePublicAccessBlockCommand extends $Command<DeletePublicAccessBlockCommandInput, DeletePublicAccessBlockCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeletePublicAccessBlockCommandInput;

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

@@ -54,6 +54,7 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
  * @see {@link GetBucketAccelerateConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketAccelerateConfigurationCommand extends $Command<GetBucketAccelerateConfigurationCommandInput, GetBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketAccelerateConfigurationCommandInput;

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

@@ -50,6 +50,7 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
  * @see {@link GetBucketAclCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketAclCommand extends $Command<GetBucketAclCommandInput, GetBucketAclCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketAclCommandInput;

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

@@ -57,6 +57,7 @@ export interface GetBucketAnalyticsConfigurationCommandOutput extends GetBucketA
  * @see {@link GetBucketAnalyticsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketAnalyticsConfigurationCommand extends $Command<GetBucketAnalyticsConfigurationCommandInput, GetBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketAnalyticsConfigurationCommandInput;

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

@@ -48,6 +48,7 @@ export interface GetBucketCorsCommandOutput extends GetBucketCorsOutput, __Metad
  * @see {@link GetBucketCorsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get cors configuration set on a bucket
  * ```javascript
  * // The following example returns cross-origin resource sharing (CORS) configuration set on a bucket.

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

@@ -50,6 +50,7 @@ export interface GetBucketEncryptionCommandOutput extends GetBucketEncryptionOut
  * @see {@link GetBucketEncryptionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketEncryptionCommand extends $Command<GetBucketEncryptionCommandInput, GetBucketEncryptionCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketEncryptionCommandInput;

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

@@ -51,6 +51,7 @@ export interface GetBucketIntelligentTieringConfigurationCommandOutput extends G
  * @see {@link GetBucketIntelligentTieringConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketIntelligentTieringConfigurationCommand extends $Command<GetBucketIntelligentTieringConfigurationCommandInput, GetBucketIntelligentTieringConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketIntelligentTieringConfigurationCommandInput;

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

@@ -55,6 +55,7 @@ export interface GetBucketInventoryConfigurationCommandOutput extends GetBucketI
  * @see {@link GetBucketInventoryConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketInventoryConfigurationCommand extends $Command<GetBucketInventoryConfigurationCommandInput, GetBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketInventoryConfigurationCommandInput;

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

@@ -82,6 +82,7 @@ export interface GetBucketLifecycleConfigurationCommandOutput extends GetBucketL
  * @see {@link GetBucketLifecycleConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get lifecycle configuration on a bucket
  * ```javascript
  * // The following example retrieves lifecycle configuration on set on a bucket.

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

@@ -46,6 +46,7 @@ export interface GetBucketLocationCommandOutput extends GetBucketLocationOutput,
  * @see {@link GetBucketLocationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get bucket location
  * ```javascript
  * // The following example returns bucket location.

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

@@ -43,6 +43,7 @@ export interface GetBucketLoggingCommandOutput extends GetBucketLoggingOutput, _
  * @see {@link GetBucketLoggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketLoggingCommand extends $Command<GetBucketLoggingCommandInput, GetBucketLoggingCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketLoggingCommandInput;

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

@@ -62,6 +62,7 @@ export interface GetBucketMetricsConfigurationCommandOutput extends GetBucketMet
  * @see {@link GetBucketMetricsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketMetricsConfigurationCommand extends $Command<GetBucketMetricsConfigurationCommandInput, GetBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketMetricsConfigurationCommandInput;

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

@@ -46,6 +46,7 @@ export interface GetBucketNotificationConfigurationCommandOutput extends Notific
  * @see {@link GetBucketNotificationConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketNotificationConfigurationCommand extends $Command<GetBucketNotificationConfigurationCommandInput, GetBucketNotificationConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketNotificationConfigurationCommandInput;

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

@@ -46,6 +46,7 @@ export interface GetBucketOwnershipControlsCommandOutput extends GetBucketOwners
  * @see {@link GetBucketOwnershipControlsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketOwnershipControlsCommand extends $Command<GetBucketOwnershipControlsCommandInput, GetBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketOwnershipControlsCommandInput;

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

@@ -51,6 +51,7 @@ export interface GetBucketPolicyCommandOutput extends GetBucketPolicyOutput, __M
  * @see {@link GetBucketPolicyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get bucket policy
  * ```javascript
  * // The following example returns bucket policy associated with a bucket.

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

@@ -57,6 +57,7 @@ export interface GetBucketPolicyStatusCommandOutput extends GetBucketPolicyStatu
  * @see {@link GetBucketPolicyStatusCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetBucketPolicyStatusCommand extends $Command<GetBucketPolicyStatusCommandInput, GetBucketPolicyStatusCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketPolicyStatusCommandInput;

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

@@ -58,6 +58,7 @@ export interface GetBucketReplicationCommandOutput extends GetBucketReplicationO
  * @see {@link GetBucketReplicationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get replication configuration set on a bucket
  * ```javascript
  * // The following example returns replication configuration set on a bucket.

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

@@ -38,6 +38,7 @@ export interface GetBucketRequestPaymentCommandOutput extends GetBucketRequestPa
  * @see {@link GetBucketRequestPaymentCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get bucket versioning configuration
  * ```javascript
  * // The following example retrieves bucket versioning configuration.

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

@@ -58,6 +58,7 @@ export interface GetBucketTaggingCommandOutput extends GetBucketTaggingOutput, _
  * @see {@link GetBucketTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get tag set associated with a bucket
  * ```javascript
  * // The following example returns tag set associated with a bucket

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

@@ -51,6 +51,7 @@ export interface GetBucketVersioningCommandOutput extends GetBucketVersioningOut
  * @see {@link GetBucketVersioningCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get bucket versioning configuration
  * ```javascript
  * // The following example retrieves bucket versioning configuration.

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

@@ -49,6 +49,7 @@ export interface GetBucketWebsiteCommandOutput extends GetBucketWebsiteOutput, _
  * @see {@link GetBucketWebsiteCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To get bucket website configuration
  * ```javascript
  * // The following example retrieves website configuration of a bucket.

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

@@ -69,6 +69,10 @@ export interface GetObjectAclCommandOutput extends GetObjectAclOutput, __Metadat
  * @see {@link GetObjectAclCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ *
  * @example To retrieve object ACL
  * ```javascript
  * // The following example retrieves access control list (ACL) of an object.

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

@@ -178,6 +178,10 @@ export interface GetObjectAttributesCommandOutput extends GetObjectAttributesOut
  * @see {@link GetObjectAttributesCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ *
  */
 export declare class GetObjectAttributesCommand extends $Command<GetObjectAttributesCommandInput, GetObjectAttributesCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetObjectAttributesCommandInput;

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

@@ -190,6 +190,13 @@ export interface GetObjectCommandOutput extends __WithSdkStreamMixin<GetObjectOu
  * @see {@link GetObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link InvalidObjectState} (client fault)
+ *  <p>Object is archived and inaccessible until restored.</p>
+ *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ *
  * @example To retrieve a byte range of 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.

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

@@ -39,6 +39,7 @@ export interface GetObjectLegalHoldCommandOutput extends GetObjectLegalHoldOutpu
  * @see {@link GetObjectLegalHoldCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetObjectLegalHoldCommand extends $Command<GetObjectLegalHoldCommandInput, GetObjectLegalHoldCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetObjectLegalHoldCommandInput;

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

@@ -40,6 +40,7 @@ export interface GetObjectLockConfigurationCommandOutput extends GetObjectLockCo
  * @see {@link GetObjectLockConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetObjectLockConfigurationCommand extends $Command<GetObjectLockConfigurationCommandInput, GetObjectLockConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetObjectLockConfigurationCommandInput;

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

@@ -38,6 +38,7 @@ export interface GetObjectRetentionCommandOutput extends GetObjectRetentionOutpu
  * @see {@link GetObjectRetentionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetObjectRetentionCommand extends $Command<GetObjectRetentionCommandInput, GetObjectRetentionCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetObjectRetentionCommandInput;

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

@@ -57,6 +57,7 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
  * @see {@link GetObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To retrieve tag set of a specific object version
  * ```javascript
  * // The following example retrieves tag set of an object. The request specifies object version.

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

@@ -45,6 +45,7 @@ export interface GetObjectTorrentCommandOutput extends __WithSdkStreamMixin<GetO
  * @see {@link GetObjectTorrentCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To retrieve torrent files for an object
  * ```javascript
  * // The following example retrieves torrent files of an object.

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

@@ -65,6 +65,7 @@ export interface GetPublicAccessBlockCommandOutput extends GetPublicAccessBlockO
  * @see {@link GetPublicAccessBlockCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class GetPublicAccessBlockCommand extends $Command<GetPublicAccessBlockCommandInput, GetPublicAccessBlockCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetPublicAccessBlockCommandInput;

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

@@ -39,6 +39,10 @@ export interface HeadBucketCommandOutput extends __MetadataBearer {
  * @see {@link HeadBucketCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NotFound} (client fault)
+ *  <p>The specified content does not exist.</p>
+ *
+ *
  * @example To determine if bucket exists
  * ```javascript
  * // This operation checks to see if a bucket exists.

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

@@ -138,6 +138,10 @@ export interface HeadObjectCommandOutput extends HeadObjectOutput, __MetadataBea
  * @see {@link HeadObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NotFound} (client fault)
+ *  <p>The specified content does not exist.</p>
+ *
+ *
  * @example To retrieve metadata of an object without returning the object itself
  * ```javascript
  * // The following example retrieves an object metadata.

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

@@ -64,6 +64,7 @@ export interface ListBucketAnalyticsConfigurationsCommandOutput extends ListBuck
  * @see {@link ListBucketAnalyticsConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class ListBucketAnalyticsConfigurationsCommand extends $Command<ListBucketAnalyticsConfigurationsCommandInput, ListBucketAnalyticsConfigurationsCommandOutput, S3ClientResolvedConfig> {
     readonly input: ListBucketAnalyticsConfigurationsCommandInput;

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

@@ -51,6 +51,7 @@ export interface ListBucketIntelligentTieringConfigurationsCommandOutput extends
  * @see {@link ListBucketIntelligentTieringConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class ListBucketIntelligentTieringConfigurationsCommand extends $Command<ListBucketIntelligentTieringConfigurationsCommandInput, ListBucketIntelligentTieringConfigurationsCommandOutput, S3ClientResolvedConfig> {
     readonly input: ListBucketIntelligentTieringConfigurationsCommandInput;

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

@@ -63,6 +63,7 @@ export interface ListBucketInventoryConfigurationsCommandOutput extends ListBuck
  * @see {@link ListBucketInventoryConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class ListBucketInventoryConfigurationsCommand extends $Command<ListBucketInventoryConfigurationsCommandInput, ListBucketInventoryConfigurationsCommandOutput, S3ClientResolvedConfig> {
     readonly input: ListBucketInventoryConfigurationsCommandInput;

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

@@ -65,6 +65,7 @@ export interface ListBucketMetricsConfigurationsCommandOutput extends ListBucket
  * @see {@link ListBucketMetricsConfigurationsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class ListBucketMetricsConfigurationsCommand extends $Command<ListBucketMetricsConfigurationsCommandInput, ListBucketMetricsConfigurationsCommandOutput, S3ClientResolvedConfig> {
     readonly input: ListBucketMetricsConfigurationsCommandInput;

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

@@ -30,6 +30,7 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
  * @see {@link ListBucketsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To list object versions
  * ```javascript
  * // The following example return versions of an object with specific key name prefix. The request limits the number of items returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify this token value in your next request to fetch next set of object versions.

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

@@ -74,6 +74,7 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
  * @see {@link ListMultipartUploadsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To list in-progress multipart uploads on a bucket
  * ```javascript
  * // The following example lists in-progress multipart uploads on a specific bucket.

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

@@ -67,6 +67,7 @@ export interface ListObjectVersionsCommandOutput extends ListObjectVersionsOutpu
  * @see {@link ListObjectVersionsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To list object versions
  * ```javascript
  * // The following example return versions of an object with specific key name prefix. The request limits the number of items returned to two. If there are are more than two object version, S3 returns NextToken in the response. You can specify this token value in your next request to fetch next set of object versions.

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

@@ -64,6 +64,10 @@ export interface ListObjectsCommandOutput extends ListObjectsOutput, __MetadataB
  * @see {@link ListObjectsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchBucket} (client fault)
+ *  <p>The specified bucket does not exist.</p>
+ *
+ *
  * @example To list objects in a bucket
  * ```javascript
  * // The following example list two objects in a bucket.

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

@@ -66,6 +66,10 @@ export interface ListObjectsV2CommandOutput extends ListObjectsV2Output, __Metad
  * @see {@link ListObjectsV2CommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchBucket} (client fault)
+ *  <p>The specified bucket does not exist.</p>
+ *
+ *
  * @example To get object list
  * ```javascript
  * // The following example retrieves object list. The request specifies max keys to limit response to include only 2 object keys.

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

@@ -78,6 +78,7 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
  * @see {@link ListPartsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To list parts of a multipart upload.
  * ```javascript
  * // The following example lists parts uploaded for a specific multipart upload.

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

@@ -66,6 +66,7 @@ export interface PutBucketAccelerateConfigurationCommandOutput extends __Metadat
  * @see {@link PutBucketAccelerateConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketAccelerateConfigurationCommand extends $Command<PutBucketAccelerateConfigurationCommandInput, PutBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketAccelerateConfigurationCommandInput;

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

@@ -217,6 +217,7 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketAclCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Put bucket acl
  * ```javascript
  * // The following example replaces existing ACL on a bucket. The ACL grants the bucket owner (specified using the owner ID) and write permission to the LogDelivery group. Because this is a replace operation, you must specify all the grants in your request. To incrementally add or remove ACL grants, you might use the console.

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

@@ -133,6 +133,7 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
  * @see {@link PutBucketAnalyticsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketAnalyticsConfigurationCommand extends $Command<PutBucketAnalyticsConfigurationCommandInput, PutBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketAnalyticsConfigurationCommandInput;

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

@@ -84,6 +84,7 @@ export interface PutBucketCorsCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketCorsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To set cors configuration on a bucket.
  * ```javascript
  * // The following example enables PUT, POST, and DELETE requests from www.example.com, and enables GET requests from any domain.

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

@@ -62,6 +62,7 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketEncryptionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketEncryptionCommand extends $Command<PutBucketEncryptionCommandInput, PutBucketEncryptionCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketEncryptionCommandInput;

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

@@ -110,6 +110,7 @@ export interface PutBucketIntelligentTieringConfigurationCommandOutput extends _
  * @see {@link PutBucketIntelligentTieringConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketIntelligentTieringConfigurationCommand extends $Command<PutBucketIntelligentTieringConfigurationCommandInput, PutBucketIntelligentTieringConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketIntelligentTieringConfigurationCommandInput;

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

@@ -127,6 +127,7 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
  * @see {@link PutBucketInventoryConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketInventoryConfigurationCommand extends $Command<PutBucketInventoryConfigurationCommandInput, PutBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketInventoryConfigurationCommandInput;

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

@@ -116,6 +116,7 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  * @see {@link PutBucketLifecycleConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Put bucket lifecycle
  * ```javascript
  * // The following example replaces existing lifecycle configuration, if any, on the specified bucket.

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

@@ -104,6 +104,7 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketLoggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set logging configuration for a bucket
  * ```javascript
  * // The following example sets logging policy on a bucket. For the Log Delivery group to deliver logs to the destination bucket, it needs permission for the READ_ACP action which the policy grants.

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

@@ -75,6 +75,7 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
  * @see {@link PutBucketMetricsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketMetricsConfigurationCommand extends $Command<PutBucketMetricsConfigurationCommandInput, PutBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketMetricsConfigurationCommandInput;

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

@@ -83,6 +83,7 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  * @see {@link PutBucketNotificationConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set notification configuration for a bucket
  * ```javascript
  * // The following example sets notification configuration on a bucket to publish the object created events to an SNS topic.

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

@@ -45,6 +45,7 @@ export interface PutBucketOwnershipControlsCommandOutput extends __MetadataBeare
  * @see {@link PutBucketOwnershipControlsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutBucketOwnershipControlsCommand extends $Command<PutBucketOwnershipControlsCommandInput, PutBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutBucketOwnershipControlsCommandInput;

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

@@ -55,6 +55,7 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketPolicyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set bucket policy
  * ```javascript
  * // The following example sets a permission policy on a bucket.

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

@@ -90,6 +90,7 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketReplicationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set replication configuration on a bucket
  * ```javascript
  * // The following example sets replication configuration on a bucket.

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

@@ -46,6 +46,7 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketRequestPaymentCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set request payment configuration on a bucket.
  * ```javascript
  * // The following example sets request payment configuration on a bucket so that person requesting the download is charged.

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

@@ -103,6 +103,7 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set tags on a bucket
  * ```javascript
  * // The following example sets tags on a bucket. Any existing tags are replaced.

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

@@ -71,6 +71,7 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketVersioningCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set versioning configuration on a bucket
  * ```javascript
  * // The following example sets versioning configuration on bucket. The configuration enables versioning on the bucket.

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

@@ -150,6 +150,7 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
  * @see {@link PutBucketWebsiteCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example Set website configuration on a bucket
  * ```javascript
  * // The following example adds website configuration to a bucket.

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

@@ -207,6 +207,10 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
  * @see {@link PutObjectAclCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ *
  * @example To grant permissions using object ACL
  * ```javascript
  * // The following example adds grants to an object ACL. The first permission grants user1 and user2 FULL_CONTROL and the AllUsers group READ permission.

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

@@ -137,6 +137,7 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * @see {@link PutObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To upload an object
  * ```javascript
  * // The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.

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

@@ -32,6 +32,7 @@ export interface PutObjectLegalHoldCommandOutput extends PutObjectLegalHoldOutpu
  * @see {@link PutObjectLegalHoldCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutObjectLegalHoldCommand extends $Command<PutObjectLegalHoldCommandInput, PutObjectLegalHoldCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutObjectLegalHoldCommandInput;

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

@@ -49,6 +49,7 @@ export interface PutObjectLockConfigurationCommandOutput extends PutObjectLockCo
  * @see {@link PutObjectLockConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutObjectLockConfigurationCommand extends $Command<PutObjectLockConfigurationCommandInput, PutObjectLockConfigurationCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutObjectLockConfigurationCommandInput;

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

@@ -34,6 +34,7 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
  * @see {@link PutObjectRetentionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutObjectRetentionCommand extends $Command<PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutObjectRetentionCommandInput;

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

@@ -120,6 +120,7 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
  * @see {@link PutObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To add tags to an existing object
  * ```javascript
  * // The following example adds tags to an existing object.

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

@@ -67,6 +67,7 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
  * @see {@link PutPublicAccessBlockCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class PutPublicAccessBlockCommand extends $Command<PutPublicAccessBlockCommandInput, PutPublicAccessBlockCommandOutput, S3ClientResolvedConfig> {
     readonly input: PutPublicAccessBlockCommandInput;

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

@@ -312,6 +312,10 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  * @see {@link RestoreObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link ObjectAlreadyInActiveTierError} (client fault)
+ *  <p>This action is not allowed against this storage tier.</p>
+ *
+ *
  * @example To restore an archived object
  * ```javascript
  * // The following example restores for one day an archived copy of an object back into Amazon S3 bucket.

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

@@ -143,6 +143,7 @@ export interface SelectObjectContentCommandOutput extends SelectObjectContentOut
  * @see {@link SelectObjectContentCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class SelectObjectContentCommand extends $Command<SelectObjectContentCommandInput, SelectObjectContentCommandOutput, S3ClientResolvedConfig> {
     readonly input: SelectObjectContentCommandInput;

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

@@ -158,6 +158,7 @@ export interface UploadPartCommandOutput extends UploadPartOutput, __MetadataBea
  * @see {@link UploadPartCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To upload a part
  * ```javascript
  * // The following example uploads part 1 of a multipart upload. The example specifies a file name for the part data. The Upload ID is same that is returned by the initiate multipart upload.

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

@@ -195,6 +195,7 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
  * @see {@link UploadPartCopyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  * @example To upload a part by copying byte range from an existing object as data source
  * ```javascript
  * // The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.

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

@@ -61,6 +61,7 @@ export interface WriteGetObjectResponseCommandOutput extends __MetadataBearer {
  * @see {@link WriteGetObjectResponseCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ *
  */
 export declare class WriteGetObjectResponseCommand extends $Command<WriteGetObjectResponseCommandInput, WriteGetObjectResponseCommandOutput, S3ClientResolvedConfig> {
     readonly input: WriteGetObjectResponseCommandInput;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-s3",
   "description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native",
-  "version": "3.289.0",
+  "version": "3.290.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -24,54 +24,54 @@
     "@aws-crypto/sha1-browser": "3.0.0",
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.289.0",
-    "@aws-sdk/config-resolver": "3.289.0",
-    "@aws-sdk/credential-provider-node": "3.289.0",
-    "@aws-sdk/eventstream-serde-browser": "3.289.0",
-    "@aws-sdk/eventstream-serde-config-resolver": "3.289.0",
-    "@aws-sdk/eventstream-serde-node": "3.289.0",
-    "@aws-sdk/fetch-http-handler": "3.289.0",
-    "@aws-sdk/hash-blob-browser": "3.289.0",
-    "@aws-sdk/hash-node": "3.289.0",
-    "@aws-sdk/hash-stream-node": "3.289.0",
-    "@aws-sdk/invalid-dependency": "3.289.0",
-    "@aws-sdk/md5-js": "3.289.0",
-    "@aws-sdk/middleware-bucket-endpoint": "3.289.0",
-    "@aws-sdk/middleware-content-length": "3.289.0",
-    "@aws-sdk/middleware-endpoint": "3.289.0",
-    "@aws-sdk/middleware-expect-continue": "3.289.0",
-    "@aws-sdk/middleware-flexible-checksums": "3.289.0",
-    "@aws-sdk/middleware-host-header": "3.289.0",
-    "@aws-sdk/middleware-location-constraint": "3.289.0",
-    "@aws-sdk/middleware-logger": "3.289.0",
-    "@aws-sdk/middleware-recursion-detection": "3.289.0",
-    "@aws-sdk/middleware-retry": "3.289.0",
-    "@aws-sdk/middleware-sdk-s3": "3.289.0",
-    "@aws-sdk/middleware-serde": "3.289.0",
-    "@aws-sdk/middleware-signing": "3.289.0",
-    "@aws-sdk/middleware-ssec": "3.289.0",
-    "@aws-sdk/middleware-stack": "3.289.0",
-    "@aws-sdk/middleware-user-agent": "3.289.0",
-    "@aws-sdk/node-config-provider": "3.289.0",
-    "@aws-sdk/node-http-handler": "3.289.0",
-    "@aws-sdk/protocol-http": "3.289.0",
-    "@aws-sdk/signature-v4-multi-region": "3.289.0",
-    "@aws-sdk/smithy-client": "3.289.0",
-    "@aws-sdk/types": "3.289.0",
-    "@aws-sdk/url-parser": "3.289.0",
+    "@aws-sdk/client-sts": "3.290.0",
+    "@aws-sdk/config-resolver": "3.290.0",
+    "@aws-sdk/credential-provider-node": "3.290.0",
+    "@aws-sdk/eventstream-serde-browser": "3.290.0",
+    "@aws-sdk/eventstream-serde-config-resolver": "3.290.0",
+    "@aws-sdk/eventstream-serde-node": "3.290.0",
+    "@aws-sdk/fetch-http-handler": "3.290.0",
+    "@aws-sdk/hash-blob-browser": "3.290.0",
+    "@aws-sdk/hash-node": "3.290.0",
+    "@aws-sdk/hash-stream-node": "3.290.0",
+    "@aws-sdk/invalid-dependency": "3.290.0",
+    "@aws-sdk/md5-js": "3.290.0",
+    "@aws-sdk/middleware-bucket-endpoint": "3.290.0",
+    "@aws-sdk/middleware-content-length": "3.290.0",
+    "@aws-sdk/middleware-endpoint": "3.290.0",
+    "@aws-sdk/middleware-expect-continue": "3.290.0",
+    "@aws-sdk/middleware-flexible-checksums": "3.290.0",
+    "@aws-sdk/middleware-host-header": "3.290.0",
+    "@aws-sdk/middleware-location-constraint": "3.290.0",
+    "@aws-sdk/middleware-logger": "3.290.0",
+    "@aws-sdk/middleware-recursion-detection": "3.290.0",
+    "@aws-sdk/middleware-retry": "3.290.0",
+    "@aws-sdk/middleware-sdk-s3": "3.290.0",
+    "@aws-sdk/middleware-serde": "3.290.0",
+    "@aws-sdk/middleware-signing": "3.290.0",
+    "@aws-sdk/middleware-ssec": "3.290.0",
+    "@aws-sdk/middleware-stack": "3.290.0",
+    "@aws-sdk/middleware-user-agent": "3.290.0",
+    "@aws-sdk/node-config-provider": "3.290.0",
+    "@aws-sdk/node-http-handler": "3.290.0",
+    "@aws-sdk/protocol-http": "3.290.0",
+    "@aws-sdk/signature-v4-multi-region": "3.290.0",
+    "@aws-sdk/smithy-client": "3.290.0",
+    "@aws-sdk/types": "3.290.0",
+    "@aws-sdk/url-parser": "3.290.0",
     "@aws-sdk/util-base64": "3.208.0",
     "@aws-sdk/util-body-length-browser": "3.188.0",
     "@aws-sdk/util-body-length-node": "3.208.0",
-    "@aws-sdk/util-defaults-mode-browser": "3.289.0",
-    "@aws-sdk/util-defaults-mode-node": "3.289.0",
-    "@aws-sdk/util-endpoints": "3.289.0",
-    "@aws-sdk/util-retry": "3.289.0",
-    "@aws-sdk/util-stream-browser": "3.289.0",
-    "@aws-sdk/util-stream-node": "3.289.0",
-    "@aws-sdk/util-user-agent-browser": "3.289.0",
-    "@aws-sdk/util-user-agent-node": "3.289.0",
+    "@aws-sdk/util-defaults-mode-browser": "3.290.0",
+    "@aws-sdk/util-defaults-mode-node": "3.290.0",
+    "@aws-sdk/util-endpoints": "3.290.0",
+    "@aws-sdk/util-retry": "3.290.0",
+    "@aws-sdk/util-stream-browser": "3.290.0",
+    "@aws-sdk/util-stream-node": "3.290.0",
+    "@aws-sdk/util-user-agent-browser": "3.290.0",
+    "@aws-sdk/util-user-agent-node": "3.290.0",
     "@aws-sdk/util-utf8": "3.254.0",
-    "@aws-sdk/util-waiter": "3.289.0",
+    "@aws-sdk/util-waiter": "3.290.0",
     "@aws-sdk/xml-builder": "3.201.0",
     "fast-xml-parser": "4.1.2",
     "tslib": "^2.3.1"