aws-sdk-transfer 1.54.0 → 1.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65c22200ccc095cf2afc03c93c5381a621da9ae132ebf660e29725359151815e
-  data.tar.gz: 0e393876399f2472754a661d0235b48c53eaee4db832faabb26210a99dd14983
+  metadata.gz: 62b5d0ac159e15bf5798644c697ad294c6f80b8acd1646184ffc4d8e59348674
+  data.tar.gz: be3190d2ad62cf50d55bd2323e1ce6c0d85e6d7b6f2252d04cb00451d9162d64
 SHA512:
-  metadata.gz: 885c30e162f5be6b9f0a75cd78bc2071e07c13e31f23e21861188e7016920ca3b22724b015a9bd812498d871903f4424a084752951150ede299d4608163397ef
-  data.tar.gz: 908228841afdb842d56e00c206ac1d9f37b6af85c13b2170f7f8926f2d32dbe122187a2b51be587ed97a37ce1e8c1093d1f657c5ed84f68364bf9af5c694a521
+  metadata.gz: ebb9965f55002d391809c579488c79896b624d3f7452d48ac1970d424c32f0b6ac150fb75339a734a6553f04f96cb75b9c6c339630b9639f75a8da90d2a8ce1d
+  data.tar.gz: ccfd528219dcf37f60f0dd5181a4fb80fa115a5405fc91b1fce2c09fdc1bfbf0dcdb5a945196d01ddcd056ef5a8e26ea6237e498c51322ac1b3f868dfc70e5ea

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.55.0 (2022-05-18)
+------------------
+
+* Feature - 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.
+
 1.54.0 (2022-05-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.54.0
+1.55.0

data/lib/aws-sdk-transfer/client.rb

@@ -608,25 +608,8 @@ module Aws::Transfer
     #    </note>
     #
     # @option params [String] :host_key
-    #   The RSA or ECDSA private key to use for your server.
-    #
-    #   Use the following command to generate an RSA 2048 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Use a minimum value of 2048 for the `-b` option: you can create a
-    #   stronger key using 3072 or 4096.
-    #
-    #   Use the following command to generate an ECDSA 256 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Valid values for the `-b` option for ECDSA are 256, 384, and 521.
-    #
-    #   For both of these commands, you can replace *my-new-server-key* with a
-    #   string of your choice.
+    #   The RSA private key as generated by the `ssh-keygen -N "" -m PEM -f
+    #   my-new-server-key` command.
     #
     #   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.
@@ -725,13 +708,22 @@ module Aws::Transfer
     # @option params [Types::ProtocolDetails] :protocol_details
     #   The protocol settings that are configured for your server.
     #
-    #   Use the `PassiveIp` 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.
+    #   * Use the `PassiveIp` 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.
+    #
+    #   * Use the `SetStatOption` 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 `ENABLE_NO_OP` 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
+    #     `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
+    #     entry to CloudWatch Logs, so you can determine when the client is
+    #     making a SETSTAT call.
     #
-    #   Use the `TlsSessionResumptionMode` parameter to determine whether or
-    #   not your Transfer server resumes recent, negotiated sessions through a
-    #   unique session ID.
+    #   * Use the `TlsSessionResumptionMode` parameter to determine whether or
+    #     not your Transfer server resumes recent, negotiated sessions through
+    #     a unique session ID.
     #
     # @option params [String] :security_policy_name
     #   Specifies the name of the security policy that is attached to the
@@ -776,6 +768,7 @@ module Aws::Transfer
     #     protocol_details: {
     #       passive_ip: "PassiveIp",
     #       tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
+    #       set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
     #     },
     #     security_policy_name: "SecurityPolicyName",
     #     tags: [
@@ -1483,6 +1476,7 @@ module Aws::Transfer
     #   resp.server.certificate #=> String
     #   resp.server.protocol_details.passive_ip #=> String
     #   resp.server.protocol_details.tls_session_resumption_mode #=> String, one of "DISABLED", "ENABLED", "ENFORCED"
+    #   resp.server.protocol_details.set_stat_option #=> String, one of "DEFAULT", "ENABLE_NO_OP"
     #   resp.server.domain #=> String, one of "S3", "EFS"
     #   resp.server.endpoint_details.address_allocation_ids #=> Array
     #   resp.server.endpoint_details.address_allocation_ids[0] #=> String
@@ -2535,13 +2529,22 @@ module Aws::Transfer
     # @option params [Types::ProtocolDetails] :protocol_details
     #   The protocol settings that are configured for your server.
     #
-    #   Use the `PassiveIp` 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.
+    #   * Use the `PassiveIp` 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.
     #
-    #   Use the `TlsSessionResumptionMode` parameter to determine whether or
-    #   not your Transfer server resumes recent, negotiated sessions through a
-    #   unique session ID.
+    #   * Use the `SetStatOption` 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 `ENABLE_NO_OP` 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
+    #     `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
+    #     entry to CloudWatch Logs, so you can determine when the client is
+    #     making a SETSTAT call.
+    #
+    #   * Use the `TlsSessionResumptionMode` parameter to determine whether or
+    #     not your Transfer server resumes recent, negotiated sessions through
+    #     a unique session ID.
     #
     # @option params [Types::EndpointDetails] :endpoint_details
     #   The virtual private cloud (VPC) endpoint settings that are configured
@@ -2579,32 +2582,15 @@ module Aws::Transfer
     #    </note>
     #
     # @option params [String] :host_key
-    #   The RSA or ECDSA private key to use for your server.
-    #
-    #   Use the following command to generate an RSA 2048 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Use a minimum value of 2048 for the `-b` option: you can create a
-    #   stronger key using 3072 or 4096.
-    #
-    #   Use the following command to generate an ECDSA 256 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Valid values for the `-b` option for ECDSA are 256, 384, and 521.
-    #
-    #   For both of these commands, you can replace *my-new-server-key* with a
-    #   string of your choice.
+    #   The RSA private key as generated by `ssh-keygen -N "" -m PEM -f
+    #   my-new-server-key`.
     #
     #   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.
+    #   server to a new server, don't update the host key. Accidentally
+    #   changing a server's host key can be disruptive.
     #
     #   For more information, see [Change the host key for your SFTP-enabled
-    #   server][1] in the *Amazon Web Services Transfer Family User Guide*.
+    #   server][1] in the *Amazon Web ServicesTransfer Family User Guide*.
     #
     #
     #
@@ -2698,6 +2684,7 @@ module Aws::Transfer
     #     protocol_details: {
     #       passive_ip: "PassiveIp",
     #       tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
+    #       set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
     #     },
     #     endpoint_details: {
     #       address_allocation_ids: ["AddressAllocationId"],
@@ -2900,7 +2887,7 @@ module Aws::Transfer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transfer'
-      context[:gem_version] = '1.54.0'
+      context[:gem_version] = '1.55.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-transfer/client_api.rb

@@ -165,6 +165,7 @@ module Aws::Transfer
     ServiceMetadata = Shapes::StructureShape.new(name: 'ServiceMetadata')
     ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException')
     SessionId = Shapes::StringShape.new(name: 'SessionId')
+    SetStatOption = Shapes::StringShape.new(name: 'SetStatOption')
     SourceFileLocation = Shapes::StringShape.new(name: 'SourceFileLocation')
     SourceIp = Shapes::StringShape.new(name: 'SourceIp')
     SshPublicKey = Shapes::StructureShape.new(name: 'SshPublicKey')
@@ -612,6 +613,7 @@ module Aws::Transfer
 
     ProtocolDetails.add_member(:passive_ip, Shapes::ShapeRef.new(shape: PassiveIp, location_name: "PassiveIp"))
     ProtocolDetails.add_member(:tls_session_resumption_mode, Shapes::ShapeRef.new(shape: TlsSessionResumptionMode, location_name: "TlsSessionResumptionMode"))
+    ProtocolDetails.add_member(:set_stat_option, Shapes::ShapeRef.new(shape: SetStatOption, location_name: "SetStatOption"))
     ProtocolDetails.struct_class = Types::ProtocolDetails
 
     Protocols.member = Shapes::ShapeRef.new(shape: Protocol)

data/lib/aws-sdk-transfer/types.rb

@@ -300,6 +300,7 @@ module Aws::Transfer
     #         protocol_details: {
     #           passive_ip: "PassiveIp",
     #           tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
+    #           set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
     #         },
     #         security_policy_name: "SecurityPolicyName",
     #         tags: [
@@ -409,25 +410,8 @@ module Aws::Transfer
     #   @return [String]
     #
     # @!attribute [rw] host_key
-    #   The RSA or ECDSA private key to use for your server.
-    #
-    #   Use the following command to generate an RSA 2048 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Use a minimum value of 2048 for the `-b` option: you can create a
-    #   stronger key using 3072 or 4096.
-    #
-    #   Use the following command to generate an ECDSA 256 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Valid values for the `-b` option for ECDSA are 256, 384, and 521.
-    #
-    #   For both of these commands, you can replace *my-new-server-key* with
-    #   a string of your choice.
+    #   The RSA private key as generated by the `ssh-keygen -N "" -m PEM -f
+    #   my-new-server-key` command.
     #
     #   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.
@@ -536,13 +520,23 @@ module Aws::Transfer
     # @!attribute [rw] protocol_details
     #   The protocol settings that are configured for your server.
     #
-    #   Use the `PassiveIp` 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.
-    #
-    #   Use the `TlsSessionResumptionMode` parameter to determine whether or
-    #   not your Transfer server resumes recent, negotiated sessions through
-    #   a unique session ID.
+    #   * Use the `PassiveIp` 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.
+    #
+    #   * Use the `SetStatOption` 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 `ENABLE_NO_OP` 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
+    #     `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
+    #     entry to CloudWatch Logs, so you can determine when the client is
+    #     making a SETSTAT call.
+    #
+    #   * Use the `TlsSessionResumptionMode` parameter to determine whether
+    #     or not your Transfer server resumes recent, negotiated sessions
+    #     through a unique session ID.
     #   @return [Types::ProtocolDetails]
     #
     # @!attribute [rw] security_policy_name
@@ -3173,6 +3167,7 @@ module Aws::Transfer
     #       {
     #         passive_ip: "PassiveIp",
     #         tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
+    #         set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
     #       }
     #
     # @!attribute [rw] passive_ip
@@ -3231,11 +3226,39 @@ module Aws::Transfer
     #      </note>
     #   @return [String]
     #
+    # @!attribute [rw] set_stat_option
+    #   Use the `SetStatOption` to ignore the error that is generated when
+    #   the client attempts to use SETSTAT on a file you are uploading to an
+    #   S3 bucket.
+    #
+    #   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.
+    #
+    #   Set the value to `ENABLE_NO_OP` 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 `SetStatOption`
+    #   `ENABLE_NO_OP` 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.
+    #
+    #   <note markdown="1"> 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.
+    #
+    #    </note>
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ProtocolDetails AWS API Documentation
     #
     class ProtocolDetails < Struct.new(
       :passive_ip,
-      :tls_session_resumption_mode)
+      :tls_session_resumption_mode,
+      :set_stat_option)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3953,6 +3976,7 @@ module Aws::Transfer
     #         protocol_details: {
     #           passive_ip: "PassiveIp",
     #           tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED
+    #           set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP
     #         },
     #         endpoint_details: {
     #           address_allocation_ids: ["AddressAllocationId"],
@@ -4030,13 +4054,23 @@ module Aws::Transfer
     # @!attribute [rw] protocol_details
     #   The protocol settings that are configured for your server.
     #
-    #   Use the `PassiveIp` 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.
-    #
-    #   Use the `TlsSessionResumptionMode` parameter to determine whether or
-    #   not your Transfer server resumes recent, negotiated sessions through
-    #   a unique session ID.
+    #   * Use the `PassiveIp` 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.
+    #
+    #   * Use the `SetStatOption` 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 `ENABLE_NO_OP` 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
+    #     `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log
+    #     entry to CloudWatch Logs, so you can determine when the client is
+    #     making a SETSTAT call.
+    #
+    #   * Use the `TlsSessionResumptionMode` parameter to determine whether
+    #     or not your Transfer server resumes recent, negotiated sessions
+    #     through a unique session ID.
     #   @return [Types::ProtocolDetails]
     #
     # @!attribute [rw] endpoint_details
@@ -4077,32 +4111,15 @@ module Aws::Transfer
     #   @return [String]
     #
     # @!attribute [rw] host_key
-    #   The RSA or ECDSA private key to use for your server.
-    #
-    #   Use the following command to generate an RSA 2048 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Use a minimum value of 2048 for the `-b` option: you can create a
-    #   stronger key using 3072 or 4096.
-    #
-    #   Use the following command to generate an ECDSA 256 bit key with no
-    #   passphrase:
-    #
-    #   `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`.
-    #
-    #   Valid values for the `-b` option for ECDSA are 256, 384, and 521.
-    #
-    #   For both of these commands, you can replace *my-new-server-key* with
-    #   a string of your choice.
+    #   The RSA private key as generated by `ssh-keygen -N "" -m PEM -f
+    #   my-new-server-key`.
     #
     #   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.
+    #   server to a new server, don't update the host key. Accidentally
+    #   changing a server's host key can be disruptive.
     #
     #   For more information, see [Change the host key for your SFTP-enabled
-    #   server][1] in the *Amazon Web Services Transfer Family User Guide*.
+    #   server][1] in the *Amazon Web ServicesTransfer Family User Guide*.
     #
     #
     #

data/lib/aws-sdk-transfer.rb

@@ -49,6 +49,6 @@ require_relative 'aws-sdk-transfer/customizations'
 # @!group service
 module Aws::Transfer
 
-  GEM_VERSION = '1.54.0'
+  GEM_VERSION = '1.55.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-transfer
 version: !ruby/object:Gem::Version
-  version: 1.54.0
+  version: 1.55.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-05-12 00:00:00.000000000 Z
+date: 2022-05-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core