@aws-sdk/client-transfer 3.92.0 → 3.94.0

package/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [3.94.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.93.0...v3.94.0) (2022-05-18)
+
+
+### Features
+
+* **client-transfer:** AWS Transfer Family now supports SetStat server configuration option, which provides the ability to ignore SetStat command issued by file transfer clients, enabling customers to upload files without any errors. ([59da2d5](https://github.com/aws/aws-sdk-js-v3/commit/59da2d5599801b2f38b2deded19d526c20218680))
+
+
+
+
+
 # [3.92.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.91.0...v3.92.0) (2022-05-16)
 
 **Note:** Version bump only for package @aws-sdk/client-transfer

package/dist-cjs/models/models_0.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DescribeAccessResponse = exports.DescribedAccess = exports.DescribeAccessRequest = exports.DeleteWorkflowRequest = exports.DeleteUserRequest = exports.DeleteSshPublicKeyRequest = exports.DeleteServerRequest = exports.DeleteAccessRequest = exports.CustomStepStatus = exports.CreateWorkflowResponse = exports.CreateWorkflowRequest = exports.WorkflowStep = exports.WorkflowStepType = exports.TagStepDetails = exports.S3Tag = exports.DeleteStepDetails = exports.CustomStepDetails = exports.CreateUserResponse = exports.CreateUserRequest = exports.ThrottlingException = exports.CreateServerResponse = exports.CreateServerRequest = exports.WorkflowDetails = exports.WorkflowDetail = exports.Tag = exports.Protocol = exports.ProtocolDetails = exports.TlsSessionResumptionMode = exports.IdentityProviderType = exports.IdentityProviderDetails = exports.EndpointType = exports.EndpointDetails = exports.Domain = exports.ServiceUnavailableException = exports.ResourceNotFoundException = exports.ResourceExistsException = exports.InvalidRequestException = exports.InternalServiceError = exports.CreateAccessResponse = exports.CreateAccessRequest = exports.PosixProfile = exports.HomeDirectoryType = exports.HomeDirectoryMapEntry = exports.CopyStepDetails = exports.OverwriteExisting = exports.InputFileLocation = exports.S3InputFileLocation = exports.EfsFileLocation = exports.ConflictException = exports.AccessDeniedException = void 0;
-exports.SendWorkflowStepStateRequest = exports.ListWorkflowsResponse = exports.ListWorkflowsRequest = exports.ListUsersResponse = exports.ListUsersRequest = exports.ListTagsForResourceResponse = exports.ListTagsForResourceRequest = exports.ListServersResponse = exports.ListServersRequest = exports.ListSecurityPoliciesResponse = exports.ListSecurityPoliciesRequest = exports.ListExecutionsResponse = exports.ListExecutionsRequest = exports.ListedWorkflow = exports.ListedUser = exports.ListedServer = exports.ListedExecution = exports.ListAccessesResponse = exports.ListedAccess = exports.ListAccessesRequest = exports.InvalidNextTokenException = exports.ImportSshPublicKeyResponse = exports.ImportSshPublicKeyRequest = exports.DescribeWorkflowResponse = exports.DescribeWorkflowRequest = exports.DescribeUserResponse = exports.DescribeUserRequest = exports.DescribeServerResponse = exports.DescribeServerRequest = exports.DescribeSecurityPolicyResponse = exports.DescribeSecurityPolicyRequest = exports.DescribeExecutionResponse = exports.DescribeExecutionRequest = exports.DescribedWorkflow = exports.DescribedUser = exports.SshPublicKey = exports.DescribedServer = exports.State = exports.DescribedSecurityPolicy = exports.DescribedExecution = exports.ExecutionStatus = exports.ServiceMetadata = exports.UserDetails = exports.ExecutionResults = exports.ExecutionStepResult = exports.ExecutionError = exports.ExecutionErrorType = exports.LoggingConfiguration = exports.FileLocation = exports.S3FileLocation = void 0;
-exports.UpdateUserResponse = exports.UpdateUserRequest = exports.UpdateServerResponse = exports.UpdateServerRequest = exports.UpdateAccessResponse = exports.UpdateAccessRequest = exports.UntagResourceRequest = exports.TestIdentityProviderResponse = exports.TestIdentityProviderRequest = exports.TagResourceRequest = exports.StopServerRequest = exports.StartServerRequest = exports.SendWorkflowStepStateResponse = void 0;
+exports.DescribedAccess = exports.DescribeAccessRequest = exports.DeleteWorkflowRequest = exports.DeleteUserRequest = exports.DeleteSshPublicKeyRequest = exports.DeleteServerRequest = exports.DeleteAccessRequest = exports.CustomStepStatus = exports.CreateWorkflowResponse = exports.CreateWorkflowRequest = exports.WorkflowStep = exports.WorkflowStepType = exports.TagStepDetails = exports.S3Tag = exports.DeleteStepDetails = exports.CustomStepDetails = exports.CreateUserResponse = exports.CreateUserRequest = exports.ThrottlingException = exports.CreateServerResponse = exports.CreateServerRequest = exports.WorkflowDetails = exports.WorkflowDetail = exports.Tag = exports.Protocol = exports.ProtocolDetails = exports.TlsSessionResumptionMode = exports.SetStatOption = exports.IdentityProviderType = exports.IdentityProviderDetails = exports.EndpointType = exports.EndpointDetails = exports.Domain = exports.ServiceUnavailableException = exports.ResourceNotFoundException = exports.ResourceExistsException = exports.InvalidRequestException = exports.InternalServiceError = exports.CreateAccessResponse = exports.CreateAccessRequest = exports.PosixProfile = exports.HomeDirectoryType = exports.HomeDirectoryMapEntry = exports.CopyStepDetails = exports.OverwriteExisting = exports.InputFileLocation = exports.S3InputFileLocation = exports.EfsFileLocation = exports.ConflictException = exports.AccessDeniedException = void 0;
+exports.ListWorkflowsResponse = exports.ListWorkflowsRequest = exports.ListUsersResponse = exports.ListUsersRequest = exports.ListTagsForResourceResponse = exports.ListTagsForResourceRequest = exports.ListServersResponse = exports.ListServersRequest = exports.ListSecurityPoliciesResponse = exports.ListSecurityPoliciesRequest = exports.ListExecutionsResponse = exports.ListExecutionsRequest = exports.ListedWorkflow = exports.ListedUser = exports.ListedServer = exports.ListedExecution = exports.ListAccessesResponse = exports.ListedAccess = exports.ListAccessesRequest = exports.InvalidNextTokenException = exports.ImportSshPublicKeyResponse = exports.ImportSshPublicKeyRequest = exports.DescribeWorkflowResponse = exports.DescribeWorkflowRequest = exports.DescribeUserResponse = exports.DescribeUserRequest = exports.DescribeServerResponse = exports.DescribeServerRequest = exports.DescribeSecurityPolicyResponse = exports.DescribeSecurityPolicyRequest = exports.DescribeExecutionResponse = exports.DescribeExecutionRequest = exports.DescribedWorkflow = exports.DescribedUser = exports.SshPublicKey = exports.DescribedServer = exports.State = exports.DescribedSecurityPolicy = exports.DescribedExecution = exports.ExecutionStatus = exports.ServiceMetadata = exports.UserDetails = exports.ExecutionResults = exports.ExecutionStepResult = exports.ExecutionError = exports.ExecutionErrorType = exports.LoggingConfiguration = exports.FileLocation = exports.S3FileLocation = exports.DescribeAccessResponse = void 0;
+exports.UpdateUserResponse = exports.UpdateUserRequest = exports.UpdateServerResponse = exports.UpdateServerRequest = exports.UpdateAccessResponse = exports.UpdateAccessRequest = exports.UntagResourceRequest = exports.TestIdentityProviderResponse = exports.TestIdentityProviderRequest = exports.TagResourceRequest = exports.StopServerRequest = exports.StartServerRequest = exports.SendWorkflowStepStateResponse = exports.SendWorkflowStepStateRequest = void 0;
 const smithy_client_1 = require("@aws-sdk/smithy-client");
 const TransferServiceException_1 = require("./TransferServiceException");
 class AccessDeniedException extends TransferServiceException_1.TransferServiceException {
@@ -195,6 +195,11 @@ var IdentityProviderType;
     IdentityProviderType["AWS_LAMBDA"] = "AWS_LAMBDA";
     IdentityProviderType["SERVICE_MANAGED"] = "SERVICE_MANAGED";
 })(IdentityProviderType = exports.IdentityProviderType || (exports.IdentityProviderType = {}));
+var SetStatOption;
+(function (SetStatOption) {
+    SetStatOption["DEFAULT"] = "DEFAULT";
+    SetStatOption["ENABLE_NO_OP"] = "ENABLE_NO_OP";
+})(SetStatOption = exports.SetStatOption || (exports.SetStatOption = {}));
 var TlsSessionResumptionMode;
 (function (TlsSessionResumptionMode) {
     TlsSessionResumptionMode["DISABLED"] = "DISABLED";

package/dist-cjs/protocols/Aws_json1_1.js

@@ -2224,6 +2224,7 @@ const serializeAws_json1_1PosixProfile = (input, context) => {
 const serializeAws_json1_1ProtocolDetails = (input, context) => {
     return {
         ...(input.PassiveIp !== undefined && input.PassiveIp !== null && { PassiveIp: input.PassiveIp }),
+        ...(input.SetStatOption !== undefined && input.SetStatOption !== null && { SetStatOption: input.SetStatOption }),
         ...(input.TlsSessionResumptionMode !== undefined &&
             input.TlsSessionResumptionMode !== null && { TlsSessionResumptionMode: input.TlsSessionResumptionMode }),
     };
@@ -3028,6 +3029,7 @@ const deserializeAws_json1_1PosixProfile = (output, context) => {
 const deserializeAws_json1_1ProtocolDetails = (output, context) => {
     return {
         PassiveIp: (0, smithy_client_1.expectString)(output.PassiveIp),
+        SetStatOption: (0, smithy_client_1.expectString)(output.SetStatOption),
         TlsSessionResumptionMode: (0, smithy_client_1.expectString)(output.TlsSessionResumptionMode),
     };
 };

package/dist-es/models/models_0.js

@@ -164,6 +164,11 @@ export var IdentityProviderType;
     IdentityProviderType["AWS_LAMBDA"] = "AWS_LAMBDA";
     IdentityProviderType["SERVICE_MANAGED"] = "SERVICE_MANAGED";
 })(IdentityProviderType || (IdentityProviderType = {}));
+export var SetStatOption;
+(function (SetStatOption) {
+    SetStatOption["DEFAULT"] = "DEFAULT";
+    SetStatOption["ENABLE_NO_OP"] = "ENABLE_NO_OP";
+})(SetStatOption || (SetStatOption = {}));
 export var TlsSessionResumptionMode;
 (function (TlsSessionResumptionMode) {
     TlsSessionResumptionMode["DISABLED"] = "DISABLED";

package/dist-es/protocols/Aws_json1_1.js

@@ -2711,7 +2711,7 @@ var serializeAws_json1_1PosixProfile = function (input, context) {
     })), (input.Uid !== undefined && input.Uid !== null && { Uid: input.Uid }));
 };
 var serializeAws_json1_1ProtocolDetails = function (input, context) {
-    return __assign(__assign({}, (input.PassiveIp !== undefined && input.PassiveIp !== null && { PassiveIp: input.PassiveIp })), (input.TlsSessionResumptionMode !== undefined &&
+    return __assign(__assign(__assign({}, (input.PassiveIp !== undefined && input.PassiveIp !== null && { PassiveIp: input.PassiveIp })), (input.SetStatOption !== undefined && input.SetStatOption !== null && { SetStatOption: input.SetStatOption })), (input.TlsSessionResumptionMode !== undefined &&
         input.TlsSessionResumptionMode !== null && { TlsSessionResumptionMode: input.TlsSessionResumptionMode }));
 };
 var serializeAws_json1_1Protocols = function (input, context) {
@@ -3437,6 +3437,7 @@ var deserializeAws_json1_1PosixProfile = function (output, context) {
 var deserializeAws_json1_1ProtocolDetails = function (output, context) {
     return {
         PassiveIp: __expectString(output.PassiveIp),
+        SetStatOption: __expectString(output.SetStatOption),
         TlsSessionResumptionMode: __expectString(output.TlsSessionResumptionMode),
     };
 };

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

@@ -500,6 +500,10 @@ export declare enum IdentityProviderType {
     AWS_LAMBDA = "AWS_LAMBDA",
     SERVICE_MANAGED = "SERVICE_MANAGED"
 }
+export declare enum SetStatOption {
+    DEFAULT = "DEFAULT",
+    ENABLE_NO_OP = "ENABLE_NO_OP"
+}
 export declare enum TlsSessionResumptionMode {
     DISABLED = "DISABLED",
     ENABLED = "ENABLED",
@@ -562,6 +566,19 @@ export interface ProtocolDetails {
      *          </ul>
      */
     TlsSessionResumptionMode?: TlsSessionResumptionMode | string;
+    /**
+     * <p>Use the <code>SetStatOption</code> to ignore the error that is generated when the client attempts to use SETSTAT on a file you are uploading to an S3 bucket.</p>
+     *          <p>Some SFTP file transfer clients can attempt to change the attributes of remote files, including timestamp and permissions, using commands, such as SETSTAT when uploading the file.
+     *         However, these commands are not compatible with object storage systems, such as Amazon S3. Due to this incompatibility, file uploads from these clients can result in errors even when
+     *         the file is otherwise successfully uploaded.</p>
+     *          <p>Set the value to <code>ENABLE_NO_OP</code> to have the Transfer Family server ignore the SETSTAT command, and upload files without needing to make any changes to your SFTP client.
+     *         While the <code>SetStatOption</code>
+     *             <code>ENABLE_NO_OP</code> setting ignores the error, it does generate a log entry in CloudWatch Logs, so you can determine when the client is making a SETSTAT call.</p>
+     *          <note>
+     *             <p>If you want to preserve the original timestamp for your file, and modify other file attributes using SETSTAT, you can use Amazon EFS as backend storage with Transfer Family.</p>
+     *          </note>
+     */
+    SetStatOption?: SetStatOption | string;
 }
 export declare namespace ProtocolDetails {
     /**
@@ -720,19 +737,8 @@ export interface CreateServerRequest {
      */
     EndpointType?: EndpointType | string;
     /**
-     * <p>The RSA or ECDSA private key to use for your server.</p>
-     *
-     *          <p>Use the following command to generate an RSA 2048 bit key with no passphrase:</p>
-     *          <p>
-     *             <code>ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key</code>.</p>
-     *          <p>Use a minimum value of 2048 for the <code>-b</code> option: you can create a stronger key using 3072 or 4096.</p>
-     *
-     *          <p>Use the following command to generate an ECDSA 256 bit key with no passphrase:</p>
-     *          <p>
-     *             <code>ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key</code>.</p>
-     *          <p>Valid values for the <code>-b</code> option for ECDSA are 256, 384, and 521.</p>
-     *
-     *          <p>For both of these commands, you can replace <i>my-new-server-key</i> with a string of your choice.</p>
+     * <p>The RSA private key as generated by the <code>ssh-keygen -N "" -m PEM -f
+     *         my-new-server-key</code> command.</p>
      *
      *          <important>
      *             <p>If you aren't planning to migrate existing users from an existing SFTP-enabled
@@ -833,12 +839,24 @@ export interface CreateServerRequest {
     Protocols?: (Protocol | string)[];
     /**
      * <p>The protocol settings that are configured for your server.</p>
-     *          <p>
-     *       Use the <code>PassiveIp</code> parameter to indicate passive mode (for FTP and FTPS protocols).
-     *       Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.
-     *     </p>
-     *          <p>Use the <code>TlsSessionResumptionMode</code> parameter to determine whether or not your Transfer server
-     *       resumes recent, negotiated sessions through a unique session ID.</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *           Use the <code>PassiveIp</code> parameter to indicate passive mode (for FTP and FTPS protocols).
+     *           Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.
+     *         </p>
+     *             </li>
+     *             <li>
+     *                <p>Use the <code>SetStatOption</code> to ignore the error that is generated when the client attempts to use SETSTAT on a file you are uploading to an S3 bucket.
+     *         Set the value to <code>ENABLE_NO_OP</code> to have the Transfer Family server ignore the SETSTAT command, and upload files without needing to make any changes to your SFTP client.
+     *         Note that with <code>SetStatOption</code> set to <code>ENABLE_NO_OP</code>, Transfer generates a log entry to CloudWatch Logs, so you can determine when the client
+     *         is making a SETSTAT call.</p>
+     *             </li>
+     *             <li>
+     *                <p>Use the <code>TlsSessionResumptionMode</code> parameter to determine whether or not your Transfer server
+     *           resumes recent, negotiated sessions through a unique session ID.</p>
+     *             </li>
+     *          </ul>
      */
     ProtocolDetails?: ProtocolDetails;
     /**
@@ -3213,15 +3231,25 @@ export interface UpdateServerRequest {
      */
     Certificate?: string;
     /**
-     * <p>
-     *       The protocol settings that are configured for your server.
-     *     </p>
-     *          <p>
-     *       Use the <code>PassiveIp</code> parameter to indicate passive mode (for FTP and FTPS protocols).
-     *       Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.
-     *     </p>
-     *          <p>Use the <code>TlsSessionResumptionMode</code> parameter to determine whether or not your Transfer server
-     *       resumes recent, negotiated sessions through a unique session ID.</p>
+     * <p>The protocol settings that are configured for your server.</p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *           Use the <code>PassiveIp</code> parameter to indicate passive mode (for FTP and FTPS protocols).
+     *           Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.
+     *         </p>
+     *             </li>
+     *             <li>
+     *                <p>Use the <code>SetStatOption</code> to ignore the error that is generated when the client attempts to use SETSTAT on a file you are uploading to an S3 bucket.
+     *         Set the value to <code>ENABLE_NO_OP</code> to have the Transfer Family server ignore the SETSTAT command, and upload files without needing to make any changes to your SFTP client.
+     *         Note that with <code>SetStatOption</code> set to <code>ENABLE_NO_OP</code>, Transfer generates a log entry to CloudWatch Logs, so you can determine when the client
+     *         is making a SETSTAT call.</p>
+     *             </li>
+     *             <li>
+     *                <p>Use the <code>TlsSessionResumptionMode</code> parameter to determine whether or not your Transfer server
+     *           resumes recent, negotiated sessions through a unique session ID.</p>
+     *             </li>
+     *          </ul>
      */
     ProtocolDetails?: ProtocolDetails;
     /**
@@ -3255,29 +3283,18 @@ export interface UpdateServerRequest {
      */
     EndpointType?: EndpointType | string;
     /**
-     * <p>The RSA or ECDSA private key to use for your server.</p>
-     *
-     *          <p>Use the following command to generate an RSA 2048 bit key with no passphrase:</p>
-     *          <p>
-     *             <code>ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key</code>.</p>
-     *          <p>Use a minimum value of 2048 for the <code>-b</code> option: you can create a stronger key using 3072 or 4096.</p>
-     *
-     *          <p>Use the following command to generate an ECDSA 256 bit key with no passphrase:</p>
-     *          <p>
-     *             <code>ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key</code>.</p>
-     *          <p>Valid values for the <code>-b</code> option for ECDSA are 256, 384, and 521.</p>
-     *
-     *          <p>For both of these commands, you can replace <i>my-new-server-key</i> with a string of your choice.</p>
+     * <p>The RSA private key as generated by <code>ssh-keygen -N "" -m PEM -f
+     *         my-new-server-key</code>.</p>
      *
      *          <important>
-     *             <p>If you aren't planning to migrate existing users from an existing SFTP-enabled
-     *         server to a new server, don't update the host key. Accidentally changing a
-     *         server's host key can be disruptive.</p>
+     *             <p>If you aren't planning to migrate existing users from an existing server to a new
+     *         server, don't update the host key. Accidentally changing a server's host key can
+     *         be disruptive.</p>
      *          </important>
      *
      *
      *
-     *          <p>For more information, see <a href="https://docs.aws.amazon.com/transfer/latest/userguide/edit-server-config.html#configuring-servers-change-host-key">Change the host key for your SFTP-enabled server</a> in the <i>Amazon Web Services Transfer
+     *          <p>For more information, see <a href="https://docs.aws.amazon.com/transfer/latest/userguide/edit-server-config.html#configuring-servers-change-host-key">Change the host key for your SFTP-enabled server</a> in the <i>Amazon Web ServicesTransfer
      *         Family User Guide</i>.</p>
      */
     HostKey?: string;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -219,6 +219,10 @@ export declare enum IdentityProviderType {
     AWS_LAMBDA = "AWS_LAMBDA",
     SERVICE_MANAGED = "SERVICE_MANAGED"
 }
+export declare enum SetStatOption {
+    DEFAULT = "DEFAULT",
+    ENABLE_NO_OP = "ENABLE_NO_OP"
+}
 export declare enum TlsSessionResumptionMode {
     DISABLED = "DISABLED",
     ENABLED = "ENABLED",
@@ -230,6 +234,8 @@ export interface ProtocolDetails {
     PassiveIp?: string;
     
     TlsSessionResumptionMode?: TlsSessionResumptionMode | string;
+    
+    SetStatOption?: SetStatOption | string;
 }
 export declare namespace ProtocolDetails {
     

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-transfer",
   "description": "AWS SDK for JavaScript Transfer Client for Node.js, Browser and React Native",
-  "version": "3.92.0",
+  "version": "3.94.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -18,9 +18,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "2.0.0",
     "@aws-crypto/sha256-js": "2.0.0",
-    "@aws-sdk/client-sts": "3.92.0",
+    "@aws-sdk/client-sts": "3.94.0",
     "@aws-sdk/config-resolver": "3.80.0",
-    "@aws-sdk/credential-provider-node": "3.87.0",
+    "@aws-sdk/credential-provider-node": "3.94.0",
     "@aws-sdk/fetch-http-handler": "3.78.0",
     "@aws-sdk/hash-node": "3.78.0",
     "@aws-sdk/invalid-dependency": "3.78.0",
@@ -33,7 +33,7 @@
     "@aws-sdk/middleware-stack": "3.78.0",
     "@aws-sdk/middleware-user-agent": "3.78.0",
     "@aws-sdk/node-config-provider": "3.80.0",
-    "@aws-sdk/node-http-handler": "3.82.0",
+    "@aws-sdk/node-http-handler": "3.94.0",
     "@aws-sdk/protocol-http": "3.78.0",
     "@aws-sdk/smithy-client": "3.85.0",
     "@aws-sdk/types": "3.78.0",