@aws-sdk/client-s3 3.321.1 → 3.326.0

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

@@ -73,6 +73,10 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  * };
  * const command = new AbortMultipartUploadCommand(input);
  * const response = await client.send(command);
+ * // { // AbortMultipartUploadOutput
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param AbortMultipartUploadCommandInput - {@link AbortMultipartUploadCommandInput}
@@ -84,6 +88,8 @@ export interface AbortMultipartUploadCommandOutput extends AbortMultipartUploadO
  * @throws {@link NoSuchUpload} (client fault)
  *  <p>The specified multipart upload does not exist.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To abort a multipart upload
  * ```javascript

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

@@ -164,6 +164,23 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * };
  * const command = new CompleteMultipartUploadCommand(input);
  * const response = await client.send(command);
+ * // { // CompleteMultipartUploadOutput
+ * //   Location: "STRING_VALUE",
+ * //   Bucket: "STRING_VALUE",
+ * //   Key: "STRING_VALUE",
+ * //   Expiration: "STRING_VALUE",
+ * //   ETag: "STRING_VALUE",
+ * //   ChecksumCRC32: "STRING_VALUE",
+ * //   ChecksumCRC32C: "STRING_VALUE",
+ * //   ChecksumSHA1: "STRING_VALUE",
+ * //   ChecksumSHA256: "STRING_VALUE",
+ * //   ServerSideEncryption: "AES256" || "aws:kms",
+ * //   VersionId: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param CompleteMultipartUploadCommandInput - {@link CompleteMultipartUploadCommandInput}
@@ -172,6 +189,8 @@ export interface CompleteMultipartUploadCommandOutput extends CompleteMultipartU
  * @see {@link CompleteMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To complete multipart upload
  * ```javascript

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

@@ -256,6 +256,27 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  * };
  * const command = new CopyObjectCommand(input);
  * const response = await client.send(command);
+ * // { // CopyObjectOutput
+ * //   CopyObjectResult: { // CopyObjectResult
+ * //     ETag: "STRING_VALUE",
+ * //     LastModified: new Date("TIMESTAMP"),
+ * //     ChecksumCRC32: "STRING_VALUE",
+ * //     ChecksumCRC32C: "STRING_VALUE",
+ * //     ChecksumSHA1: "STRING_VALUE",
+ * //     ChecksumSHA256: "STRING_VALUE",
+ * //   },
+ * //   Expiration: "STRING_VALUE",
+ * //   CopySourceVersionId: "STRING_VALUE",
+ * //   VersionId: "STRING_VALUE",
+ * //   ServerSideEncryption: "AES256" || "aws:kms",
+ * //   SSECustomerAlgorithm: "STRING_VALUE",
+ * //   SSECustomerKeyMD5: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   SSEKMSEncryptionContext: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param CopyObjectCommandInput - {@link CopyObjectCommandInput}
@@ -268,6 +289,8 @@ export interface CopyObjectCommandOutput extends CopyObjectOutput, __MetadataBea
  *  <p>The source object of the COPY action is not in the active tier and is only stored in
  *          Amazon S3 Glacier.</p>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To copy an object
  * ```javascript

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

@@ -187,6 +187,10 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * };
  * const command = new CreateBucketCommand(input);
  * const response = await client.send(command);
+ * // { // CreateBucketOutput
+ * //   Location: "STRING_VALUE",
+ * // };
+ *
  * ```
  *
  * @param CreateBucketCommandInput - {@link CreateBucketCommandInput}
@@ -205,6 +209,8 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  *          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>
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To create a bucket in a specific region
  * ```javascript

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

@@ -329,6 +329,22 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  * };
  * const command = new CreateMultipartUploadCommand(input);
  * const response = await client.send(command);
+ * // { // CreateMultipartUploadOutput
+ * //   AbortDate: new Date("TIMESTAMP"),
+ * //   AbortRuleId: "STRING_VALUE",
+ * //   Bucket: "STRING_VALUE",
+ * //   Key: "STRING_VALUE",
+ * //   UploadId: "STRING_VALUE",
+ * //   ServerSideEncryption: "AES256" || "aws:kms",
+ * //   SSECustomerAlgorithm: "STRING_VALUE",
+ * //   SSECustomerKeyMD5: "STRING_VALUE",
+ * //   SSEKMSKeyId: "STRING_VALUE",
+ * //   SSEKMSEncryptionContext: "STRING_VALUE",
+ * //   BucketKeyEnabled: true || false,
+ * //   RequestCharged: "requester",
+ * //   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256",
+ * // };
+ *
  * ```
  *
  * @param CreateMultipartUploadCommandInput - {@link CreateMultipartUploadCommandInput}
@@ -337,6 +353,8 @@ export interface CreateMultipartUploadCommandOutput extends CreateMultipartUploa
  * @see {@link CreateMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To initiate a multipart upload
  * ```javascript

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

@@ -60,6 +60,8 @@ export interface DeleteBucketAnalyticsConfigurationCommandOutput extends __Metad
  * };
  * const command = new DeleteBucketAnalyticsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketAnalyticsConfigurationCommandInput - {@link DeleteBucketAnalyticsConfigurationCommandInput}
@@ -68,6 +70,8 @@ export interface DeleteBucketAnalyticsConfigurationCommandOutput extends __Metad
  * @see {@link DeleteBucketAnalyticsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketAnalyticsConfigurationCommand extends $Command<DeleteBucketAnalyticsConfigurationCommandInput, DeleteBucketAnalyticsConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -48,6 +48,8 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketCommandInput - {@link DeleteBucketCommandInput}
@@ -56,6 +58,8 @@ export interface DeleteBucketCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete a bucket
  * ```javascript

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

@@ -52,6 +52,8 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketCorsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketCorsCommandInput - {@link DeleteBucketCorsCommandInput}
@@ -60,6 +62,8 @@ export interface DeleteBucketCorsCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketCorsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete cors configuration on a bucket.
  * ```javascript

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

@@ -54,6 +54,8 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketEncryptionCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketEncryptionCommandInput - {@link DeleteBucketEncryptionCommandInput}
@@ -62,6 +64,8 @@ export interface DeleteBucketEncryptionCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketEncryptionCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketEncryptionCommand extends $Command<DeleteBucketEncryptionCommandInput, DeleteBucketEncryptionCommandOutput, S3ClientResolvedConfig> {

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

@@ -54,6 +54,8 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  * };
  * const command = new DeleteBucketIntelligentTieringConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketIntelligentTieringConfigurationCommandInput - {@link DeleteBucketIntelligentTieringConfigurationCommandInput}
@@ -62,6 +64,8 @@ export interface DeleteBucketIntelligentTieringConfigurationCommandOutput extend
  * @see {@link DeleteBucketIntelligentTieringConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketIntelligentTieringConfigurationCommand extends $Command<DeleteBucketIntelligentTieringConfigurationCommandInput, DeleteBucketIntelligentTieringConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -58,6 +58,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  * };
  * const command = new DeleteBucketInventoryConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketInventoryConfigurationCommandInput - {@link DeleteBucketInventoryConfigurationCommandInput}
@@ -66,6 +68,8 @@ export interface DeleteBucketInventoryConfigurationCommandOutput extends __Metad
  * @see {@link DeleteBucketInventoryConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketInventoryConfigurationCommand extends $Command<DeleteBucketInventoryConfigurationCommandInput, DeleteBucketInventoryConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -55,6 +55,8 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketLifecycleCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketLifecycleCommandInput - {@link DeleteBucketLifecycleCommandInput}
@@ -63,6 +65,8 @@ export interface DeleteBucketLifecycleCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketLifecycleCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete lifecycle configuration on a bucket.
  * ```javascript

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

@@ -66,6 +66,8 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  * };
  * const command = new DeleteBucketMetricsConfigurationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketMetricsConfigurationCommandInput - {@link DeleteBucketMetricsConfigurationCommandInput}
@@ -74,6 +76,8 @@ export interface DeleteBucketMetricsConfigurationCommandOutput extends __Metadat
  * @see {@link DeleteBucketMetricsConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketMetricsConfigurationCommand extends $Command<DeleteBucketMetricsConfigurationCommandInput, DeleteBucketMetricsConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -50,6 +50,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * };
  * const command = new DeleteBucketOwnershipControlsCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketOwnershipControlsCommandInput - {@link DeleteBucketOwnershipControlsCommandInput}
@@ -58,6 +60,8 @@ export interface DeleteBucketOwnershipControlsCommandOutput extends __MetadataBe
  * @see {@link DeleteBucketOwnershipControlsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeleteBucketOwnershipControlsCommand extends $Command<DeleteBucketOwnershipControlsCommandInput, DeleteBucketOwnershipControlsCommandOutput, S3ClientResolvedConfig> {

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

@@ -61,6 +61,8 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketPolicyCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketPolicyCommandInput - {@link DeleteBucketPolicyCommandInput}
@@ -69,6 +71,8 @@ export interface DeleteBucketPolicyCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketPolicyCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket policy
  * ```javascript

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

@@ -55,6 +55,8 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketReplicationCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketReplicationCommandInput - {@link DeleteBucketReplicationCommandInput}
@@ -63,6 +65,8 @@ export interface DeleteBucketReplicationCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketReplicationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket replication configuration
  * ```javascript

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

@@ -48,6 +48,8 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketTaggingCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketTaggingCommandInput - {@link DeleteBucketTaggingCommandInput}
@@ -56,6 +58,8 @@ export interface DeleteBucketTaggingCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket tags
  * ```javascript

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

@@ -55,6 +55,8 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeleteBucketWebsiteCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeleteBucketWebsiteCommandInput - {@link DeleteBucketWebsiteCommandInput}
@@ -63,6 +65,8 @@ export interface DeleteBucketWebsiteCommandOutput extends __MetadataBearer {
  * @see {@link DeleteBucketWebsiteCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete bucket website configuration
  * ```javascript

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

@@ -62,6 +62,12 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * };
  * const command = new DeleteObjectCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectOutput
+ * //   DeleteMarker: true || false,
+ * //   VersionId: "STRING_VALUE",
+ * //   RequestCharged: "requester",
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectCommandInput - {@link DeleteObjectCommandInput}
@@ -70,29 +76,31 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
  * @see {@link DeleteObjectCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To delete an object (from a non-versioned bucket)
+ * @example To delete an object
  * ```javascript
- * // The following example deletes an object from a non-versioned bucket.
+ * // The following example deletes an object from an S3 bucket.
  * const input = {
- *   "Bucket": "ExampleBucket",
- *   "Key": "HappyFace.jpg"
+ *   "Bucket": "examplebucket",
+ *   "Key": "objectkey.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
+ * // example id: to-delete-an-object-1472850136595
  * ```
  *
- * @example To delete an object
+ * @example To delete an object (from a non-versioned bucket)
  * ```javascript
- * // The following example deletes an object from an S3 bucket.
+ * // The following example deletes an object from a non-versioned bucket.
  * const input = {
- *   "Bucket": "examplebucket",
- *   "Key": "objectkey.jpg"
+ *   "Bucket": "ExampleBucket",
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectCommand(input);
  * await client.send(command);
- * // example id: to-delete-an-object-1472850136595
+ * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
  * ```
  *
  */

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

@@ -55,6 +55,10 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectTaggingOutput
+ * //   VersionId: "STRING_VALUE",
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectTaggingCommandInput - {@link DeleteObjectTaggingCommandInput}
@@ -63,40 +67,42 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
  * @see {@link DeleteObjectTaggingCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To remove tag set from an object version
+ * @example To remove tag set from an object
  * ```javascript
- * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
+ * // 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",
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
+ *   "VersionId": "null"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-version-1483145285913
+ * // example id: to-remove-tag-set-from-an-object-1483145342862
  * ```
  *
- * @example To remove tag set from an object
+ * @example To remove tag set from an object version
  * ```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.
+ * // 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"
+ *   "Key": "HappyFace.jpg",
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * };
  * const command = new DeleteObjectTaggingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "VersionId": "null"
+ *   "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
  * }
  * *\/
- * // example id: to-remove-tag-set-from-an-object-1483145342862
+ * // example id: to-remove-tag-set-from-an-object-version-1483145285913
  * ```
  *
  */

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

@@ -96,6 +96,26 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * };
  * const command = new DeleteObjectsCommand(input);
  * const response = await client.send(command);
+ * // { // DeleteObjectsOutput
+ * //   Deleted: [ // DeletedObjects
+ * //     { // DeletedObject
+ * //       Key: "STRING_VALUE",
+ * //       VersionId: "STRING_VALUE",
+ * //       DeleteMarker: true || false,
+ * //       DeleteMarkerVersionId: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * //   RequestCharged: "requester",
+ * //   Errors: [ // Errors
+ * //     { // Error
+ * //       Key: "STRING_VALUE",
+ * //       VersionId: "STRING_VALUE",
+ * //       Code: "STRING_VALUE",
+ * //       Message: "STRING_VALUE",
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param DeleteObjectsCommandInput - {@link DeleteObjectsCommandInput}
@@ -104,6 +124,8 @@ export interface DeleteObjectsCommandOutput extends DeleteObjectsOutput, __Metad
  * @see {@link DeleteObjectsCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  * @example To delete multiple objects from a versioned bucket
  * ```javascript

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

@@ -59,6 +59,8 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
  * };
  * const command = new DeletePublicAccessBlockCommand(input);
  * const response = await client.send(command);
+ * // {};
+ *
  * ```
  *
  * @param DeletePublicAccessBlockCommandInput - {@link DeletePublicAccessBlockCommandInput}
@@ -67,6 +69,8 @@ export interface DeletePublicAccessBlockCommandOutput extends __MetadataBearer {
  * @see {@link DeletePublicAccessBlockCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class DeletePublicAccessBlockCommand extends $Command<DeletePublicAccessBlockCommandInput, DeletePublicAccessBlockCommandOutput, S3ClientResolvedConfig> {

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

@@ -57,6 +57,10 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
  * };
  * const command = new GetBucketAccelerateConfigurationCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketAccelerateConfigurationOutput
+ * //   Status: "Enabled" || "Suspended",
+ * // };
+ *
  * ```
  *
  * @param GetBucketAccelerateConfigurationCommandInput - {@link GetBucketAccelerateConfigurationCommandInput}
@@ -65,6 +69,8 @@ export interface GetBucketAccelerateConfigurationCommandOutput extends GetBucket
  * @see {@link GetBucketAccelerateConfigurationCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class GetBucketAccelerateConfigurationCommand extends $Command<GetBucketAccelerateConfigurationCommandInput, GetBucketAccelerateConfigurationCommandOutput, S3ClientResolvedConfig> {

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

@@ -53,6 +53,25 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
  * };
  * const command = new GetBucketAclCommand(input);
  * const response = await client.send(command);
+ * // { // GetBucketAclOutput
+ * //   Owner: { // Owner
+ * //     DisplayName: "STRING_VALUE",
+ * //     ID: "STRING_VALUE",
+ * //   },
+ * //   Grants: [ // Grants
+ * //     { // Grant
+ * //       Grantee: { // Grantee
+ * //         DisplayName: "STRING_VALUE",
+ * //         EmailAddress: "STRING_VALUE",
+ * //         ID: "STRING_VALUE",
+ * //         URI: "STRING_VALUE",
+ * //         Type: "CanonicalUser" || "AmazonCustomerByEmail" || "Group", // required
+ * //       },
+ * //       Permission: "FULL_CONTROL" || "WRITE" || "WRITE_ACP" || "READ" || "READ_ACP",
+ * //     },
+ * //   ],
+ * // };
+ *
  * ```
  *
  * @param GetBucketAclCommandInput - {@link GetBucketAclCommandInput}
@@ -61,6 +80,8 @@ export interface GetBucketAclCommandOutput extends GetBucketAclOutput, __Metadat
  * @see {@link GetBucketAclCommandOutput} for command's `response` shape.
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
  *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
  *
  */
 export declare class GetBucketAclCommand extends $Command<GetBucketAclCommandInput, GetBucketAclCommandOutput, S3ClientResolvedConfig> {