@aws-sdk/client-s3 3.50.0 → 3.53.0

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

@@ -11,10 +11,10 @@ export interface PutBucketAccelerateConfigurationCommandOutput extends __Metadat
  *          bucket-level feature that enables you to perform faster data transfers to Amazon S3.</p>
  *
  *          <p> To use this operation, you must have permission to perform the
- *          s3:PutAccelerateConfiguration 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>
+ *             <code>s3:PutAccelerateConfiguration</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> The Transfer Acceleration state of a bucket can be set to one of the following two
  *          values:</p>

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

@@ -11,7 +11,9 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
  *          encryption and Amazon S3 Bucket Key for an existing bucket.</p>
  *          <p>Default encryption for a bucket can use server-side encryption with Amazon S3-managed keys
  *          (SSE-S3) or customer managed keys (SSE-KMS). If you specify default encryption
- *          using SSE-KMS, you can also configure Amazon S3 Bucket Key. For information about default
+ *          using SSE-KMS, you can also configure Amazon S3 Bucket Key. When the default encryption is SSE-KMS, if
+ *          you upload an object to the bucket and do not specify the KMS key to use for encryption, Amazon S3
+ *          uses the default Amazon Web Services managed KMS key for your account. For information about default
  *          encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 default bucket encryption</a>
  *          in the <i>Amazon S3 User Guide</i>. For more information about S3 Bucket Keys,
  *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket Keys</a> in the <i>Amazon S3 User Guide</i>.</p>

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

@@ -8,6 +8,8 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
 }
 /**
  * <p>Creates a new lifecycle configuration for the bucket or replaces an existing lifecycle
+ *          configuration. Keep in mind that this will overwrite an existing lifecycle configuration, so if
+ *          you want to retain any configuration details, they must be included in the new lifecycle
  *          configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing your storage
  *             lifecycle</a>.</p>
  *
@@ -59,7 +61,7 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  *          subresources (for example, lifecycle configuration and website configuration). Only the
  *          resource owner (that is, the Amazon Web Services account that created it) can access the resource. The
  *          resource owner can optionally grant access permissions to others by writing an access
- *          policy. For this operation, a user must get the s3:PutLifecycleConfiguration
+ *          policy. For this operation, a user must get the <code>s3:PutLifecycleConfiguration</code>
  *          permission.</p>
  *
  *          <p>You can also explicitly deny permissions. Explicit deny also supersedes any other
@@ -68,13 +70,19 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
  *
  *          <ul>
  *             <li>
- *                <p>s3:DeleteObject</p>
+ *                <p>
+ *                   <code>s3:DeleteObject</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>s3:DeleteObjectVersion</p>
+ *                <p>
+ *                   <code>s3:DeleteObjectVersion</code>
+ *                </p>
  *             </li>
  *             <li>
- *                <p>s3:PutLifecycleConfiguration</p>
+ *                <p>
+ *                   <code>s3:PutLifecycleConfiguration</code>
+ *                </p>
  *             </li>
  *          </ul>
  *

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

@@ -38,7 +38,8 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
  *
  *          <p>You can disable notifications by adding the empty NotificationConfiguration
  *          element.</p>
- *
+ *          <p>For more information about the number of event notification configurations that you can create per bucket, see
+ *          <a href="https://docs.aws.amazon.com/general/latest/gr/s3.html#limits_s3">Amazon S3 service quotas</a> in <i>Amazon Web Services General Reference</i>.</p>
  *          <p>By default, only the bucket owner can configure notifications on a bucket. However,
  *          bucket owners can use a bucket policy to grant permission to other users to set this
  *          configuration with <code>s3:PutBucketNotification</code> permission.</p>

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

@@ -7,8 +7,7 @@ export interface PutBucketVersioningCommandInput extends PutBucketVersioningRequ
 export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
 }
 /**
- * <p>Sets the versioning state of an existing bucket. To set the versioning state, you must
- *          be the bucket owner.</p>
+ * <p>Sets the versioning state of an existing bucket.</p>
  *          <p>You can set the versioning state with one of the following values:</p>
  *
  *          <p>
@@ -22,8 +21,9 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
  *          <p>If the versioning state has never been set on a bucket, it has no versioning state; a
  *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a> request does not return a versioning state value.</p>
  *
- *          <p>If the bucket owner enables MFA Delete in the bucket versioning configuration, the
- *          bucket owner must include the <code>x-amz-mfa request</code> header and the
+ *          <p>In order to enable MFA Delete, you must be the bucket owner. If you are the bucket owner
+ *          and want to enable MFA Delete in the bucket versioning configuration, you must
+ *          include the <code>x-amz-mfa request</code> header and the
  *             <code>Status</code> and the <code>MfaDelete</code> request elements in a request to set
  *          the versioning state of the bucket.</p>
  *

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

@@ -7,7 +7,7 @@ export interface PutObjectLegalHoldCommandInput extends PutObjectLegalHoldReques
 export interface PutObjectLegalHoldCommandOutput extends PutObjectLegalHoldOutput, __MetadataBearer {
 }
 /**
- * <p>Applies a Legal Hold configuration to the specified object. For more information, see
+ * <p>Applies a legal hold configuration to the specified object. For more information, see
  *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
  *             Objects</a>.</p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@aws-sdk/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { PutObjectRetentionOutput, PutObjectRetentionRequest } from "../models/models_0";
+import { PutObjectRetentionOutput, PutObjectRetentionRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 export interface PutObjectRetentionCommandInput extends PutObjectRetentionRequest {
 }
@@ -13,13 +13,6 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
  *           requires the <code>s3:BypassGovernanceRetention</code> permission.
  *          </p>
  *          <p>This action is not supported by Amazon S3 on Outposts.</p>
- *
- *          <p>
- *             <b>Permissions</b>
- *          </p>
- *          <p>When the Object Lock retention mode is set to compliance, you need <code>s3:PutObjectRetention</code> and
- *          <code>s3:BypassGovernanceRetention</code> permissions. For other requests to <code>PutObjectRetention</code>,
- *          only <code>s3:PutObjectRetention</code> permissions are required.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@aws-sdk/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { PutObjectTaggingOutput, PutObjectTaggingRequest } from "../models/models_0";
+import { PutObjectTaggingOutput, PutObjectTaggingRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 export interface PutObjectTaggingCommandInput extends PutObjectTaggingRequest {
 }

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

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@aws-sdk/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { PutPublicAccessBlockRequest } from "../models/models_0";
+import { PutPublicAccessBlockRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 export interface PutPublicAccessBlockCommandInput extends PutPublicAccessBlockRequest {
 }

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

@@ -1,7 +1,6 @@
 import { Command as $Command } from "@aws-sdk/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { RestoreObjectOutput } from "../models/models_0";
-import { RestoreObjectRequest } from "../models/models_1";
+import { RestoreObjectOutput, RestoreObjectRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 export interface RestoreObjectCommandInput extends RestoreObjectRequest {
 }
@@ -145,42 +144,35 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
  *          <ul>
  *             <li>
  *                <p>
- *                   <b>
- *                      <code>Expedited</code>
- *                   </b> - Expedited retrievals
- *                allow you to quickly access your data stored in the S3 Glacier
- *                storage class or S3 Intelligent-Tiering Archive tier when occasional urgent requests for a
- *                subset of archives are required. For all but the largest archived objects (250 MB+),
- *                data accessed using Expedited retrievals is typically made available within 1–5
- *                minutes. Provisioned capacity ensures that retrieval capacity for Expedited
- *                retrievals is available when you need it. Expedited retrievals and provisioned
- *                capacity are not available for objects stored in the S3 Glacier Deep Archive
- *                storage class or S3 Intelligent-Tiering Deep Archive tier.</p>
+ *                   <code>Expedited</code> - Expedited retrievals allow you to quickly access your
+ *                data stored in the S3 Glacier storage class or S3 Intelligent-Tiering Archive
+ *                tier when occasional urgent requests for a subset of archives are required. For all
+ *                but the largest archived objects (250 MB+), data accessed using Expedited retrievals
+ *                is typically made available within 1–5 minutes. Provisioned capacity ensures that
+ *                retrieval capacity for Expedited retrievals is available when you need it. Expedited
+ *                retrievals and provisioned capacity are not available for objects stored in the
+ *                S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <b>
- *                      <code>Standard</code>
- *                   </b> - Standard retrievals allow
- *                you to access any of your archived objects within several hours. This is the default
- *                option for retrieval requests that do not specify the retrieval option. Standard
- *                retrievals typically finish within 3–5 hours for objects stored in the
- *                S3 Glacier storage class or S3 Intelligent-Tiering Archive tier. They
- *                typically finish within 12 hours for objects stored in the
- *                S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.
- *                Standard retrievals are free for objects stored in S3 Intelligent-Tiering.</p>
+ *                   <code>Standard</code> - Standard retrievals allow you to access any of your
+ *                archived objects within several hours. This is the default option for retrieval
+ *                requests that do not specify the retrieval option. Standard retrievals typically
+ *                finish within 3–5 hours for objects stored in the S3 Glacier storage
+ *                class or S3 Intelligent-Tiering Archive tier. They typically finish within 12 hours for
+ *                objects stored in the S3 Glacier Deep Archive storage class or
+ *                S3 Intelligent-Tiering Deep Archive tier. Standard retrievals are free for objects stored in
+ *                S3 Intelligent-Tiering.</p>
  *             </li>
  *             <li>
  *                <p>
- *                   <b>
- *                      <code>Bulk</code>
- *                   </b> - Bulk retrievals are the
- *                lowest-cost retrieval option in S3 Glacier, enabling you to retrieve large amounts,
- *                even petabytes, of data inexpensively. Bulk retrievals typically finish within 5–12
- *                hours for objects stored in the S3 Glacier storage class or
- *                S3 Intelligent-Tiering Archive tier. They typically finish within 48 hours for objects stored
- *                in the S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier.
- *                Bulk retrievals are free for objects stored in S3 Intelligent-Tiering.</p>
+ *                   <code>Bulk</code> - Bulk retrievals are the lowest-cost retrieval option in
+ *                S3 Glacier, enabling you to retrieve large amounts, even petabytes, of data
+ *                inexpensively. Bulk retrievals typically finish within 5–12 hours for objects stored
+ *                in the S3 Glacier storage class or S3 Intelligent-Tiering Archive tier. They
+ *                typically finish within 48 hours for objects stored in the
+ *                S3 Glacier Deep Archive storage class or S3 Intelligent-Tiering Deep Archive tier. Bulk
+ *                retrievals are free for objects stored in S3 Intelligent-Tiering.</p>
  *             </li>
  *          </ul>
  *          <p>For more information about archive retrieval options and provisioned capacity for

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

@@ -36,13 +36,13 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
  *                   Permissions</a> in the <i>Amazon S3 User Guide</i>.</p>
  *             </li>
  *             <li>
- *                <p>For information about copying objects using a single atomic action vs. the
- *                multipart upload, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html">Operations on
- *                   Objects</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <p>For information about copying objects using a single atomic action vs. a multipart
+ *                upload, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectOperations.html">Operations on Objects</a> in
+ *                the <i>Amazon S3 User Guide</i>.</p>
  *             </li>
  *             <li>
  *                <p>For information about using server-side encryption with customer-provided
- *                encryption keys with the UploadPartCopy operation, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html">CopyObject</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>.</p>
+ *                encryption keys with the <code>UploadPartCopy</code> operation, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html">CopyObject</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html">UploadPart</a>.</p>
  *             </li>
  *          </ul>
  *          <p>Note the following additional considerations about the request headers

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

@@ -41,6 +41,7 @@ export * from "./GetBucketTaggingCommand";
 export * from "./GetBucketVersioningCommand";
 export * from "./GetBucketWebsiteCommand";
 export * from "./GetObjectAclCommand";
+export * from "./GetObjectAttributesCommand";
 export * from "./GetObjectCommand";
 export * from "./GetObjectLegalHoldCommand";
 export * from "./GetObjectLockConfigurationCommand";

package/dist-types/index.d.ts

@@ -4,3 +4,4 @@ export * from "./commands";
 export * from "./models";
 export * from "./pagination";
 export * from "./waiters";
+export { S3ServiceException } from "./models/S3ServiceException";

package/dist-types/models/S3ServiceException.d.ts

@@ -0,0 +1,10 @@
+import { ServiceException as __ServiceException, ServiceExceptionOptions as __ServiceExceptionOptions } from "@aws-sdk/smithy-client";
+/**
+ * Base exception class for all service exceptions from S3 service.
+ */
+export declare class S3ServiceException extends __ServiceException {
+    /**
+     * @internal
+     */
+    constructor(options: __ServiceExceptionOptions);
+}