@aws-sdk/client-s3 3.288.0 → 3.290.0

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

@@ -67,6 +67,23 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "bigobject",
+ *   "UploadId": "xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
+ * };
+ * const command = new AbortMultipartUploadCommand(input);
+ * await client.send(command);
+ * // example id: to-abort-a-multipart-upload-1481853354987
+ * ```
+ *
  */
 export declare class AbortMultipartUploadCommand extends $Command<AbortMultipartUploadCommandInput, AbortMultipartUploadCommandOutput, S3ClientResolvedConfig> {
     readonly input: AbortMultipartUploadCommandInput;

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

@@ -139,6 +139,40 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "bigobject",
+ *   "MultipartUpload": {
+ *     "Parts": [
+ *       {
+ *         "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
+ *         "PartNumber": "1"
+ *       },
+ *       {
+ *         "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
+ *         "PartNumber": "2"
+ *       }
+ *     ]
+ *   },
+ *   "UploadId": "7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
+ * };
+ * const command = new CompleteMultipartUploadCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Bucket": "acexamplebucket",
+ *   "ETag": "\"4d9031c7644d8081c2829f4ea23c55f7-2\"",
+ *   "Key": "bigobject",
+ *   "Location": "https://examplebucket.s3.<Region>.amazonaws.com/bigobject"
+ * }
+ * *\/
+ * // example id: to-complete-multipart-upload-1481851590483
+ * ```
+ *
  */
 export declare class CompleteMultipartUploadCommand extends $Command<CompleteMultipartUploadCommandInput, CompleteMultipartUploadCommandOutput, S3ClientResolvedConfig> {
     readonly input: CompleteMultipartUploadCommandInput;

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

@@ -212,6 +212,32 @@ 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.
+ * const input = {
+ *   "Bucket": "destinationbucket",
+ *   "CopySource": "/sourcebucket/HappyFacejpg",
+ *   "Key": "HappyFaceCopyjpg"
+ * };
+ * const command = new CopyObjectCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CopyObjectResult": {
+ *     "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
+ *     "LastModified": "2016-12-15T17:38:53.000Z"
+ *   }
+ * }
+ * *\/
+ * // example id: to-copy-an-object-1481823186878
+ * ```
+ *
  */
 export declare class CopyObjectCommand extends $Command<CopyObjectCommandInput, CopyObjectCommandOutput, S3ClientResolvedConfig> {
     readonly input: CopyObjectCommandInput;

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

@@ -174,6 +174,52 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "CreateBucketConfiguration": {
+ *     "LocationConstraint": "eu-west-1"
+ *   }
+ * };
+ * const command = new CreateBucketCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
+ * }
+ * *\/
+ * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
+ * ```
+ *
+ * @example To create a bucket
+ * ```javascript
+ * // The following example creates a bucket.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new CreateBucketCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Location": "/examplebucket"
+ * }
+ * *\/
+ * // example id: to-create-a-bucket--1472851826060
+ * ```
+ *
  */
 export declare class CreateBucketCommand extends $Command<CreateBucketCommandInput, CreateBucketCommandOutput, S3ClientResolvedConfig> {
     readonly input: CreateBucketCommandInput;

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

@@ -296,6 +296,26 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "largeobject"
+ * };
+ * const command = new CreateMultipartUploadCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Bucket": "examplebucket",
+ *   "Key": "largeobject",
+ *   "UploadId": "ibZBv_75gd9r8lH_gqXatLdxMVpAlj6ZQjEs.OwyF3953YdwbcQnMA2BLGn8Lx12fQNICtMw5KyteFeHw.Sjng--"
+ * }
+ * *\/
+ * // example id: to-initiate-a-multipart-upload-1481836794513
+ * ```
+ *
  */
 export declare class CreateMultipartUploadCommand extends $Command<CreateMultipartUploadCommandInput, CreateMultipartUploadCommandOutput, S3ClientResolvedConfig> {
     readonly input: CreateMultipartUploadCommandInput;

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,18 @@ 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.
+ * const input = {
+ *   "Bucket": "forrandall2"
+ * };
+ * const command = new DeleteBucketCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-a-bucket-1473108514262
+ * ```
+ *
  */
 export declare class DeleteBucketCommand extends $Command<DeleteBucketCommandInput, DeleteBucketCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketCommandInput;

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

@@ -49,6 +49,18 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new DeleteBucketCorsCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-cors-configuration-on-a-bucket-1483042856112
+ * ```
+ *
  */
 export declare class DeleteBucketCorsCommand extends $Command<DeleteBucketCorsCommandInput, DeleteBucketCorsCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketCorsCommandInput;

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,18 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new DeleteBucketLifecycleCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-lifecycle-configuration-on-a-bucket-1483043310583
+ * ```
+ *
  */
 export declare class DeleteBucketLifecycleCommand extends $Command<DeleteBucketLifecycleCommandInput, DeleteBucketLifecycleCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketLifecycleCommandInput;

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,18 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new DeleteBucketPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-bucket-policy-1483043406577
+ * ```
+ *
  */
 export declare class DeleteBucketPolicyCommand extends $Command<DeleteBucketPolicyCommandInput, DeleteBucketPolicyCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketPolicyCommandInput;

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

@@ -52,6 +52,18 @@ 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.
+ * const input = {
+ *   "Bucket": "example"
+ * };
+ * const command = new DeleteBucketReplicationCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-bucket-replication-configuration-1483043684668
+ * ```
+ *
  */
 export declare class DeleteBucketReplicationCommand extends $Command<DeleteBucketReplicationCommandInput, DeleteBucketReplicationCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketReplicationCommandInput;

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

@@ -45,6 +45,18 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new DeleteBucketTaggingCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-bucket-tags-1483043846509
+ * ```
+ *
  */
 export declare class DeleteBucketTaggingCommand extends $Command<DeleteBucketTaggingCommandInput, DeleteBucketTaggingCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketTaggingCommandInput;

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

@@ -52,6 +52,18 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new DeleteBucketWebsiteCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-bucket-website-configuration-1483043937825
+ * ```
+ *
  */
 export declare class DeleteBucketWebsiteCommand extends $Command<DeleteBucketWebsiteCommandInput, DeleteBucketWebsiteCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteBucketWebsiteCommandInput;

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

@@ -54,6 +54,31 @@ 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.
+ * const input = {
+ *   "Bucket": "ExampleBucket",
+ *   "Key": "HappyFace.jpg"
+ * };
+ * const command = new DeleteObjectCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
+ * ```
+ *
+ * @example To delete an object
+ * ```javascript
+ * // The following example deletes an object from an S3 bucket.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "objectkey.jpg"
+ * };
+ * const command = new DeleteObjectCommand(input);
+ * await client.send(command);
+ * // example id: to-delete-an-object-1472850136595
+ * ```
+ *
  */
 export declare class DeleteObjectCommand extends $Command<DeleteObjectCommandInput, DeleteObjectCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteObjectCommandInput;

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

@@ -50,6 +50,42 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "HappyFace.jpg"
+ * };
+ * const command = new DeleteObjectTaggingCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "VersionId": "null"
+ * }
+ * *\/
+ * // example id: to-remove-tag-set-from-an-object-1483145342862
+ * ```
+ *
+ * @example To remove tag set from an object version
+ * ```javascript
+ * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Key": "HappyFace.jpg",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ * };
+ * const command = new DeleteObjectTaggingCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ * }
+ * *\/
+ * // example id: to-remove-tag-set-from-an-object-version-1483145285913
+ * ```
+ *
  */
 export declare class DeleteObjectTaggingCommand extends $Command<DeleteObjectTaggingCommandInput, DeleteObjectTaggingCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteObjectTaggingCommandInput;

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

@@ -80,6 +80,83 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Delete": {
+ *     "Objects": [
+ *       {
+ *         "Key": "objectkey1"
+ *       },
+ *       {
+ *         "Key": "objectkey2"
+ *       }
+ *     ],
+ *     "Quiet": false
+ *   }
+ * };
+ * const command = new DeleteObjectsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Deleted": [
+ *     {
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
+ *       "Key": "objectkey1"
+ *     },
+ *     {
+ *       "DeleteMarker": "true",
+ *       "DeleteMarkerVersionId": "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
+ *       "Key": "objectkey2"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-delete-multiple-objects-from-a-versioned-bucket-1483146248805
+ * ```
+ *
+ * @example To delete multiple object versions from a versioned bucket
+ * ```javascript
+ * // The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object versions and returns the key and versions of deleted objects in the response.
+ * const input = {
+ *   "Bucket": "examplebucket",
+ *   "Delete": {
+ *     "Objects": [
+ *       {
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *       },
+ *       {
+ *         "Key": "HappyFace.jpg",
+ *         "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *       }
+ *     ],
+ *     "Quiet": false
+ *   }
+ * };
+ * const command = new DeleteObjectsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Deleted": [
+ *     {
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd"
+ *     },
+ *     {
+ *       "Key": "HappyFace.jpg",
+ *       "VersionId": "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-delete-multiple-object-versions-from-a-versioned-bucket-1483147087737
+ * ```
+ *
  */
 export declare class DeleteObjectsCommand extends $Command<DeleteObjectsCommandInput, DeleteObjectsCommandOutput, S3ClientResolvedConfig> {
     readonly input: DeleteObjectsCommandInput;

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,36 @@ 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.
+ * const input = {
+ *   "Bucket": "examplebucket"
+ * };
+ * const command = new GetBucketCorsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "CORSRules": [
+ *     {
+ *       "AllowedHeaders": [
+ *         "Authorization"
+ *       ],
+ *       "AllowedMethods": [
+ *         "GET"
+ *       ],
+ *       "AllowedOrigins": [
+ *         "*"
+ *       ],
+ *       "MaxAgeSeconds": 3000
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-get-cors-configuration-set-on-a-bucket-1481596855475
+ * ```
+ *
  */
 export declare class GetBucketCorsCommand extends $Command<GetBucketCorsCommandInput, GetBucketCorsCommandOutput, S3ClientResolvedConfig> {
     readonly input: GetBucketCorsCommandInput;

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;