@aws-sdk/client-s3 3.460.0 → 3.461.0

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
-import { PutBucketReplicationRequest } from "../models/models_0";
+import { PutBucketReplicationRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -23,7 +23,10 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p> Creates a replication configuration or replaces an existing one. For more information,
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p> Creates a replication configuration or replaces an existing one. For more information,
  *          see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the <i>Amazon S3 User Guide</i>. </p>
  *          <p>Specify the replication configuration in the request body. In the replication
  *          configuration, you provide the name of the destination bucket or buckets where you want
@@ -142,7 +145,7 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
  *         Destination: { // Destination
  *           Bucket: "STRING_VALUE", // required
  *           Account: "STRING_VALUE",
- *           StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ *           StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  *           AccessControlTranslation: { // AccessControlTranslation
  *             Owner: "Destination", // required
  *           },

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
-import { PutBucketRequestPaymentRequest } from "../models/models_0";
+import { PutBucketRequestPaymentRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -23,7 +23,10 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the request payment configuration for a bucket. By default, the bucket owner pays
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the request payment configuration for a bucket. By default, the bucket owner pays
  *          for downloads from the bucket. This configuration parameter enables the bucket owner (only)
  *          to specify that the person requesting the download will be charged for the download. For
  *          more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
-import { PutBucketTaggingRequest } from "../models/models_0";
+import { PutBucketTaggingRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -23,7 +23,10 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the tags for a bucket.</p>
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the tags for a bucket.</p>
  *          <p>Use tags to organize your Amazon Web Services bill to reflect your own cost structure. To do this,
  *          sign up to get your Amazon Web Services account bill with tag key values included. Then, to see the cost
  *          of combined resources, organize your billing information according to resources with the

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
-import { PutBucketVersioningRequest } from "../models/models_0";
+import { PutBucketVersioningRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -23,7 +23,10 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the versioning state of an existing bucket.</p>
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <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>
  *             <b>Enabled</b>—Enables versioning for the objects in the

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@smithy/types";
-import { PutBucketWebsiteRequest } from "../models/models_0";
+import { PutBucketWebsiteRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -23,7 +23,10 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Sets the configuration of the website that is specified in the <code>website</code>
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the configuration of the website that is specified in the <code>website</code>
  *          subresource. To configure a bucket as a website, you can add this subresource on the bucket
  *          with website configuration information such as the file name of the index document and any
  *          redirect rules. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on Amazon S3</a>.</p>

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

@@ -23,11 +23,14 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
 }
 /**
  * @public
- * <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions
- *          for a new or existing object in an S3 bucket. You must have <code>WRITE_ACP</code>
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions
+ *          for a new or existing object in an S3 bucket. You must have the <code>WRITE_ACP</code>
  *          permission to set the ACL of an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions">What
  *             permissions can I grant?</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <p>This action is not supported by Amazon S3 on Outposts.</p>
+ *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
  *          <p>Depending on your application needs, you can choose to set the ACL on an object using
  *          either the request body or the headers. For example, if you have an existing application
  *          that updates a bucket ACL using the request body, you can continue to use that approach.

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

@@ -1,7 +1,7 @@
 import { EndpointParameterInstructions } from "@smithy/middleware-endpoint";
 import { Command as $Command } from "@smithy/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack, StreamingBlobPayloadInputTypes } from "@smithy/types";
-import { PutObjectOutput, PutObjectRequest } from "../models/models_0";
+import { PutObjectOutput, PutObjectRequest } from "../models/models_1";
 import { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public
@@ -24,84 +24,121 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
 }
 /**
  * @public
- * <p>Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object
- *          to it.</p>
- *          <note>
- *             <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
- *             entire object to the bucket. You cannot use <code>PutObject</code> to only update a
- *             single piece of metadata for an existing object. You must put the entire object with
- *             updated metadata if you want to update some values.</p>
- *          </note>
- *          <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
- *          simultaneously, it overwrites all but the last object written. To prevent objects from
- *          being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
- *             Lock</a>.</p>
- *          <p>To ensure that data is not corrupted traversing the network, use the
- *             <code>Content-MD5</code> header. When you use this header, Amazon S3 checks the object
- *          against the provided MD5 value and, if they do not match, returns an error. Additionally,
- *          you can calculate the MD5 while putting an object to Amazon S3 and compare the returned ETag to
- *          the calculated MD5 value.</p>
+ * <p>Adds an object to a bucket.</p>
  *          <note>
  *             <ul>
  *                <li>
- *                   <p>To successfully complete the <code>PutObject</code> request, you must have the
- *                      <code>s3:PutObject</code> in your IAM permissions.</p>
+ *                   <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
+ *                entire object to the bucket. You cannot use <code>PutObject</code> to only update a
+ *                single piece of metadata for an existing object. You must put the entire object with
+ *                updated metadata if you want to update some values.</p>
  *                </li>
  *                <li>
- *                   <p>To successfully change the objects acl of your <code>PutObject</code> request,
- *                   you must have the <code>s3:PutObjectAcl</code> in your IAM permissions.</p>
+ *                   <p>If your bucket uses the bucket owner enforced setting for Object Ownership, ACLs are disabled and no longer affect permissions. All
+ *                   objects written to the bucket by any account will be owned by the bucket owner.</p>
  *                </li>
  *                <li>
- *                   <p>To successfully set the tag-set with your <code>PutObject</code> request, you
- *                   must have the <code>s3:PutObjectTagging</code> in your IAM permissions.</p>
- *                </li>
- *                <li>
- *                   <p> The <code>Content-MD5</code> header is required for any request to upload an
- *                   object with a retention period configured using Amazon S3 Object Lock. For more
- *                   information about Amazon S3 Object Lock, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html">Amazon S3 Object Lock
- *                      Overview</a> in the <i>Amazon S3 User Guide</i>. </p>
+ *                   <p>
+ *                      <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
+ *                      </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
+ *     <i>Amazon S3 User Guide</i>.</p>
  *                </li>
  *             </ul>
  *          </note>
- *          <p>You have four mutually exclusive options to protect data using server-side encryption in
- *          Amazon S3, depending on how you choose to manage the encryption keys. Specifically, the
- *          encryption key options are Amazon S3 managed keys (SSE-S3), Amazon Web Services KMS keys (SSE-KMS or
- *          DSSE-KMS), and customer-provided keys (SSE-C). Amazon S3 encrypts data with server-side
- *          encryption by using Amazon S3 managed keys (SSE-S3) by default. You can optionally tell Amazon S3 to
- *          encrypt data at rest by using server-side encryption with other key options. For more
- *          information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using Server-Side
- *             Encryption</a>.</p>
- *          <p>When adding a new object, you can use headers to grant ACL-based permissions to
- *          individual Amazon Web Services accounts or to predefined groups defined by Amazon S3. These permissions are
- *          then added to the ACL on the object. By default, all objects are private. Only the owner
- *          has full access control. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL) Overview</a>
- *          and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html">Managing
- *             ACLs Using the REST API</a>. </p>
- *          <p>If the bucket that you're uploading objects to uses the bucket owner enforced setting
- *          for S3 Object Ownership, ACLs are disabled and no longer affect permissions. Buckets that
- *          use this setting only accept PUT requests that don't specify an ACL or PUT requests that
- *          specify bucket owner full control ACLs, such as the <code>bucket-owner-full-control</code>
- *          canned ACL or an equivalent form of this ACL expressed in the XML format. PUT requests that
- *          contain other ACLs (for example, custom grants to certain Amazon Web Services accounts) fail and return a
- *             <code>400</code> error with the error code <code>AccessControlListNotSupported</code>.
- *          For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling ownership of
- *             objects and disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
- *          <note>
- *             <p>If your bucket uses the bucket owner enforced setting for Object Ownership, all
- *             objects written to the bucket by any account will be owned by the bucket owner.</p>
- *          </note>
- *          <p>By default, Amazon S3 uses the STANDARD Storage Class to store newly created objects. The
- *          STANDARD storage class provides high durability and high availability. Depending on
- *          performance needs, you can specify a different Storage Class. Amazon S3 on Outposts only uses
- *          the OUTPOSTS Storage Class. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html">Storage Classes</a> in the
- *             <i>Amazon S3 User Guide</i>.</p>
- *          <p>If you enable versioning for a bucket, Amazon S3 automatically generates a unique version ID
- *          for the object being stored. Amazon S3 returns this ID in the response. When you enable
- *          versioning for a bucket, if Amazon S3 receives multiple write requests for the same object
- *          simultaneously, it stores all of the objects. For more information about versioning, see
+ *          <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
+ *          simultaneously, it overwrites all but the last object written. However, Amazon S3 provides features that can modify this behavior:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <b>S3 Object Lock</b> - To prevent objects from
+ *             being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
+ *                Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
+ *                <note>
+ *                   <p>This functionality is not supported for directory buckets.</p>
+ *                </note>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <b>S3 Versioning</b> - When you enable
+ *             versioning for a bucket, if Amazon S3 receives multiple write requests for the same object
+ *             simultaneously, it stores all versions of the objects. For each write request that is made to the same object, Amazon S3 automatically generates a unique version ID
+ *             of that object being stored in Amazon S3.
+ *            You can retrieve, replace, or delete any version of the object. For more information about versioning, see
  *             <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding Objects to
- *             Versioning-Enabled Buckets</a>. For information about returning the versioning state
- *          of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
+ *                Versioning-Enabled Buckets</a> in the <i>Amazon S3
+ *                   User Guide</i>. For information about returning the versioning state
+ *             of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
+ *                <note>
+ *                   <p>This functionality is not supported for directory buckets.</p>
+ *                </note>
+ *             </li>
+ *          </ul>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <b>General purpose bucket permissions</b> - The following permissions are required in your policies when your
+ *                         <code>PutObject</code> request includes specific headers.</p>
+ *                      <ul>
+ *                         <li>
+ *                            <p>
+ *                               <b>
+ *                                  <code>s3:PutObject</code>
+ *                               </b> - To successfully complete the <code>PutObject</code> request, you must always have the <code>s3:PutObject</code> permission on a bucket to add an object
+ *                                  to it.</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <b>
+ *                                  <code>s3:PutObjectAcl</code>
+ *                               </b> - To successfully change the objects ACL of your <code>PutObject</code> request, you must have the <code>s3:PutObjectAcl</code>.</p>
+ *                         </li>
+ *                         <li>
+ *                            <p>
+ *                               <b>
+ *                                  <code>s3:PutObjectTagging</code>
+ *                               </b> - To successfully set the tag-set with your <code>PutObject</code> request, you
+ *                                  must have the <code>s3:PutObjectTagging</code>.</p>
+ *                         </li>
+ *                      </ul>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
+ * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
+ *                            <code>CreateSession</code>
+ *                         </a>.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>Data integrity with Content-MD5</dt>
+ *             <dd>
+ *                <ul>
+ *                   <li>
+ *                      <p>
+ *                         <b>General purpose bucket</b> - To ensure that data is not corrupted traversing the network, use the
+ *                     <code>Content-MD5</code> header. When you use this header, Amazon S3 checks the object
+ *                     against the provided MD5 value and, if they do not match, Amazon S3 returns an error. Alternatively, when the object's ETag is its MD5 digest,
+ *                     you can calculate the MD5 while putting the object to Amazon S3 and compare the returned ETag to
+ *                     the calculated MD5 value.</p>
+ *                   </li>
+ *                   <li>
+ *                      <p>
+ *                         <b>Directory bucket</b> - This functionality is not supported for directory buckets.</p>
+ *                   </li>
+ *                </ul>
+ *             </dd>
+ *             <dt>HTTP Host header syntax</dt>
+ *             <dd>
+ *                <p>
+ *                   <b>Directory buckets </b> - The HTTP Host header syntax is <code>
+ *                      <i>Bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com</code>.</p>
+ *             </dd>
+ *          </dl>
  *          <p>For more information about related Amazon S3 APIs, see the following:</p>
  *          <ul>
  *             <li>
@@ -147,7 +184,7 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  *     "<keys>": "STRING_VALUE",
  *   },
  *   ServerSideEncryption: "AES256" || "aws:kms" || "aws:kms:dsse",
- *   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW",
+ *   StorageClass: "STANDARD" || "REDUCED_REDUNDANCY" || "STANDARD_IA" || "ONEZONE_IA" || "INTELLIGENT_TIERING" || "GLACIER" || "DEEP_ARCHIVE" || "OUTPOSTS" || "GLACIER_IR" || "SNOW" || "EXPRESS_ONEZONE",
  *   WebsiteRedirectLocation: "STRING_VALUE",
  *   SSECustomerAlgorithm: "STRING_VALUE",
  *   SSECustomerKey: "STRING_VALUE",
@@ -192,107 +229,107 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * @throws {@link S3ServiceException}
  * <p>Base exception class for all service exceptions from S3 service.</p>
  *
- * @example To upload object and specify user-defined metadata
+ * @example To upload an object and specify optional tags
  * ```javascript
- * // The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.
+ * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
  * const input = {
- *   "Body": "filetoupload",
+ *   "Body": "c:\\HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
- *   "Metadata": {
- *     "metadata1": "value1",
- *     "metadata2": "value2"
- *   }
+ *   "Key": "HappyFace.jpg",
+ *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
+ *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
  * }
  * *\/
- * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
+ * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
  * ```
  *
- * @example To upload an object (specify optional headers)
+ * @example To create an object.
  * ```javascript
- * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
+ * // The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
  * const input = {
- *   "Body": "HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "ServerSideEncryption": "AES256",
- *   "StorageClass": "STANDARD_IA"
+ *   "Key": "objectkey"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "ServerSideEncryption": "AES256",
- *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
+ *   "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
  * }
  * *\/
- * // example id: to-upload-an-object-(specify-optional-headers)
+ * // example id: to-create-an-object-1483147613675
  * ```
  *
- * @example To upload an object and specify optional tags
+ * @example To upload object and specify user-defined metadata
  * ```javascript
- * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
+ * // The following example creates an object. The request also specifies optional metadata. If the bucket is versioning enabled, S3 returns version ID in response.
  * const input = {
- *   "Body": "c:\\HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg",
- *   "Tagging": "key1=value1&key2=value2"
+ *   "Key": "exampleobject",
+ *   "Metadata": {
+ *     "metadata1": "value1",
+ *     "metadata2": "value2"
+ *   }
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
+ *   "VersionId": "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
+ * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
  * ```
  *
- * @example To create an object.
+ * @example To upload an object
  * ```javascript
- * // The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
+ * // 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.
  * const input = {
- *   "Body": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "objectkey"
+ *   "Key": "HappyFace.jpg"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
+ *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
  * }
  * *\/
- * // example id: to-create-an-object-1483147613675
+ * // example id: to-upload-an-object-1481760101010
  * ```
  *
- * @example To upload an object
+ * @example To upload an object and specify server-side encryption and object tags
  * ```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.
+ * // The following example uploads an object. The request specifies the optional server-side encryption option. The request also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
  * const input = {
- *   "Body": "HappyFace.jpg",
+ *   "Body": "filetoupload",
  *   "Bucket": "examplebucket",
- *   "Key": "HappyFace.jpg"
+ *   "Key": "exampleobject",
+ *   "ServerSideEncryption": "AES256",
+ *   "Tagging": "key1=value1&key2=value2"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
- *   "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
+ *   "ServerSideEncryption": "AES256",
+ *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
  * }
  * *\/
- * // example id: to-upload-an-object-1481760101010
+ * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
  * ```
  *
  * @example To upload an object and specify canned ACL.
@@ -315,15 +352,15 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
  * ```
  *
- * @example To upload an object and specify server-side encryption and object tags
+ * @example To upload an object (specify optional headers)
  * ```javascript
- * // The following example uploads an object. The request specifies the optional server-side encryption option. The request also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
+ * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
  * const input = {
- *   "Body": "filetoupload",
+ *   "Body": "HappyFace.jpg",
  *   "Bucket": "examplebucket",
- *   "Key": "exampleobject",
+ *   "Key": "HappyFace.jpg",
  *   "ServerSideEncryption": "AES256",
- *   "Tagging": "key1=value1&key2=value2"
+ *   "StorageClass": "STANDARD_IA"
  * };
  * const command = new PutObjectCommand(input);
  * const response = await client.send(command);
@@ -331,10 +368,10 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
  * {
  *   "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
  *   "ServerSideEncryption": "AES256",
- *   "VersionId": "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt"
+ *   "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
  * }
  * *\/
- * // example id: to-upload-an-object-and-specify-server-side-encryption-and-object-tags-1483398331831
+ * // example id: to-upload-an-object-(specify-optional-headers)
  * ```
  *
  */

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

@@ -23,10 +23,13 @@ export interface PutObjectLegalHoldCommandOutput extends PutObjectLegalHoldOutpu
 }
 /**
  * @public
- * <p>Applies a legal hold configuration to the specified object. For more information, see
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <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>
+ *          <p>This functionality is not supported for Amazon S3 on Outposts.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -23,7 +23,10 @@ export interface PutObjectLockConfigurationCommandOutput extends PutObjectLockCo
 }
 /**
  * @public
- * <p>Places an Object Lock configuration on the specified bucket. The rule specified in the
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Places an Object Lock configuration on the specified bucket. The rule specified in the
  *          Object Lock configuration will be applied by default to every new object placed in the
  *          specified bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>. </p>
  *          <note>

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

@@ -23,11 +23,14 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
 }
 /**
  * @public
- * <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.
  *          Users or accounts require the <code>s3:PutObjectRetention</code> permission in order to
  *          place an Object Retention configuration on objects. Bypassing a Governance Retention
  *          configuration requires the <code>s3:BypassGovernanceRetention</code> permission. </p>
- *          <p>This action is not supported by Amazon S3 on Outposts.</p>
+ *          <p>This functionality is not supported for Amazon S3 on Outposts.</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

@@ -23,7 +23,10 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
 }
 /**
  * @public
- * <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
  *          key-value pair. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
  *          <p>You can associate tags with an object by sending a PUT request against the tagging
  *          subresource that is associated with the object. You can retrieve tags by sending a GET

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

@@ -23,7 +23,10 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket.
+ * <note>
+ *             <p>This operation is not supported by directory buckets.</p>
+ *          </note>
+ *          <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket.
  *          To use this operation, you must have the <code>s3:PutBucketPublicAccessBlock</code>
  *          permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
  *             Policy</a>.</p>