aws-sdk-transfer 1.47.0 → 1.50.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e506a67cabd21108c149c0bcd0fcd2b078d49cc9706bfcbcb7cff4c727687626
-  data.tar.gz: 950a4529cc3a61dcb02e761a93fd3636339220db7e0c5d2b01b8beb448015a2f
+  metadata.gz: 4e4409d8646c52571f98d0f73d469176b53d7a405abb734576d1246d449c4852
+  data.tar.gz: 79ab9afb3e5e42cd699384918c77c6e93f04d65e509c9482cf3364d9b7a26919
 SHA512:
-  metadata.gz: 1b9be93382ef08bd87c6951222ab0cea50b78ce5088b097cb585bd1510db87ab132313f53f7f89981441c82f95e8b3d8c70b1fb086823e2991e47f267ec2c977
-  data.tar.gz: d139c6ffe449b8aed1f1af7d6cca4957b8092fcf22d56385cc8c8321aa7c1216713d97dcb45bcf4c851ce803e0cf2f545c26538a742cb2e5f992efc6ea139d73
+  metadata.gz: 407fc4c5de4a8347616dde8a71db841ccd4193a6e7b38cc42e2b8df41df3350d7fe1eb03d6d996a3d9589f1e2cd215165c9e8078160fc8ae610ed19e9ace6bd1
+  data.tar.gz: ffc9a729b8a42a08d0e4d74b5e3b47c96a1c008bfcb5188b31df56ce5a3bd7608409432f116bd6c59e0a7ce8438d2035ee28a26fa2114c6158c15cdeadfb9282

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.50.0 (2022-03-04)
+------------------
+
+* Feature - Add waiters for server online and offline.
+
+1.49.0 (2022-02-24)
+------------------
+
+* Feature - Support automatic pagination when listing AWS Transfer Family resources.
+
+1.48.0 (2022-02-23)
+------------------
+
+* Feature - The file input selection feature provides the ability to use either the originally uploaded file or the output file from the previous workflow step, enabling customers to make multiple copies of the original file while keeping the source file intact for file archival.
+
 1.47.0 (2022-02-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.47.0
+1.50.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::Transfer
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -406,17 +408,6 @@ module Aws::Transfer
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon S3
-    #   or EFS, the entry is ignored. As a workaround, you can use the Amazon
-    #   S3 API or EFS API to create 0 byte objects as place holders for your
-    #   directory. If using the CLI, use the `s3api` or `efsapi` call instead
-    #   of `s3` or `efs` so you can use the put-object operation. For example,
-    #   you use the following: `aws s3api put-object --bucket bucketname --key
-    #   path/to/folder/`. Make sure that the end of the key name ends in a `/`
-    #   for it to be considered a folder.
-    #
-    #    </note>
-    #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
     #   across multiple users. This policy scopes down user access to portions
@@ -832,17 +823,6 @@ module Aws::Transfer
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon S3
-    #   or EFS, the entry is ignored. As a workaround, you can use the Amazon
-    #   S3 API or EFS API to create 0 byte objects as place holders for your
-    #   directory. If using the CLI, use the `s3api` or `efsapi` call instead
-    #   of `s3` or `efs` so you can use the put-object operation. For example,
-    #   you use the following: `aws s3api put-object --bucket bucketname --key
-    #   path/to/folder/`. Make sure that the end of the key name ends in a `/`
-    #   for it to be considered a folder.
-    #
-    #    </note>
-    #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
     #   across multiple users. This policy scopes down user access to portions
@@ -1029,14 +1009,17 @@ module Aws::Transfer
     #             },
     #           },
     #           overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         custom_step_details: {
     #           name: "WorkflowStepName",
     #           target: "CustomStepTarget",
     #           timeout_seconds: 1,
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         delete_step_details: {
     #           name: "WorkflowStepName",
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         tag_step_details: {
     #           name: "WorkflowStepName",
@@ -1046,6 +1029,7 @@ module Aws::Transfer
     #               value: "S3TagValue", # required
     #             },
     #           ],
+    #           source_file_location: "SourceFileLocation",
     #         },
     #       },
     #     ],
@@ -1065,14 +1049,17 @@ module Aws::Transfer
     #             },
     #           },
     #           overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         custom_step_details: {
     #           name: "WorkflowStepName",
     #           target: "CustomStepTarget",
     #           timeout_seconds: 1,
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         delete_step_details: {
     #           name: "WorkflowStepName",
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         tag_step_details: {
     #           name: "WorkflowStepName",
@@ -1082,6 +1069,7 @@ module Aws::Transfer
     #               value: "S3TagValue", # required
     #             },
     #           ],
+    #           source_file_location: "SourceFileLocation",
     #         },
     #       },
     #     ],
@@ -1495,6 +1483,12 @@ module Aws::Transfer
     #   resp.server.workflow_details.on_upload[0].workflow_id #=> String
     #   resp.server.workflow_details.on_upload[0].execution_role #=> String
     #
+    #
+    # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
+    #
+    #   * server_offline
+    #   * server_online
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeServer AWS API Documentation
     #
     # @overload describe_server(params = {})
@@ -1591,14 +1585,18 @@ module Aws::Transfer
     #   resp.workflow.steps[0].copy_step_details.destination_file_location.efs_file_location.file_system_id #=> String
     #   resp.workflow.steps[0].copy_step_details.destination_file_location.efs_file_location.path #=> String
     #   resp.workflow.steps[0].copy_step_details.overwrite_existing #=> String, one of "TRUE", "FALSE"
+    #   resp.workflow.steps[0].copy_step_details.source_file_location #=> String
     #   resp.workflow.steps[0].custom_step_details.name #=> String
     #   resp.workflow.steps[0].custom_step_details.target #=> String
     #   resp.workflow.steps[0].custom_step_details.timeout_seconds #=> Integer
+    #   resp.workflow.steps[0].custom_step_details.source_file_location #=> String
     #   resp.workflow.steps[0].delete_step_details.name #=> String
+    #   resp.workflow.steps[0].delete_step_details.source_file_location #=> String
     #   resp.workflow.steps[0].tag_step_details.name #=> String
     #   resp.workflow.steps[0].tag_step_details.tags #=> Array
     #   resp.workflow.steps[0].tag_step_details.tags[0].key #=> String
     #   resp.workflow.steps[0].tag_step_details.tags[0].value #=> String
+    #   resp.workflow.steps[0].tag_step_details.source_file_location #=> String
     #   resp.workflow.on_exception_steps #=> Array
     #   resp.workflow.on_exception_steps[0].type #=> String, one of "COPY", "CUSTOM", "TAG", "DELETE"
     #   resp.workflow.on_exception_steps[0].copy_step_details.name #=> String
@@ -1607,14 +1605,18 @@ module Aws::Transfer
     #   resp.workflow.on_exception_steps[0].copy_step_details.destination_file_location.efs_file_location.file_system_id #=> String
     #   resp.workflow.on_exception_steps[0].copy_step_details.destination_file_location.efs_file_location.path #=> String
     #   resp.workflow.on_exception_steps[0].copy_step_details.overwrite_existing #=> String, one of "TRUE", "FALSE"
+    #   resp.workflow.on_exception_steps[0].copy_step_details.source_file_location #=> String
     #   resp.workflow.on_exception_steps[0].custom_step_details.name #=> String
     #   resp.workflow.on_exception_steps[0].custom_step_details.target #=> String
     #   resp.workflow.on_exception_steps[0].custom_step_details.timeout_seconds #=> Integer
+    #   resp.workflow.on_exception_steps[0].custom_step_details.source_file_location #=> String
     #   resp.workflow.on_exception_steps[0].delete_step_details.name #=> String
+    #   resp.workflow.on_exception_steps[0].delete_step_details.source_file_location #=> String
     #   resp.workflow.on_exception_steps[0].tag_step_details.name #=> String
     #   resp.workflow.on_exception_steps[0].tag_step_details.tags #=> Array
     #   resp.workflow.on_exception_steps[0].tag_step_details.tags[0].key #=> String
     #   resp.workflow.on_exception_steps[0].tag_step_details.tags[0].value #=> String
+    #   resp.workflow.on_exception_steps[0].tag_step_details.source_file_location #=> String
     #   resp.workflow.workflow_id #=> String
     #   resp.workflow.tags #=> Array
     #   resp.workflow.tags[0].key #=> String
@@ -2344,17 +2346,6 @@ module Aws::Transfer
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon S3
-    #   or EFS, the entry is ignored. As a workaround, you can use the Amazon
-    #   S3 API or EFS API to create 0 byte objects as place holders for your
-    #   directory. If using the CLI, use the `s3api` or `efsapi` call instead
-    #   of `s3` or `efs` so you can use the put-object operation. For example,
-    #   you use the following: `aws s3api put-object --bucket bucketname --key
-    #   path/to/folder/`. Make sure that the end of the key name ends in a `/`
-    #   for it to be considered a folder.
-    #
-    #    </note>
-    #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
     #   across multiple users. This policy scopes down user access to portions
@@ -2728,17 +2719,6 @@ module Aws::Transfer
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon S3
-    #   or EFS, the entry is ignored. As a workaround, you can use the Amazon
-    #   S3 API or EFS API to create 0 byte objects as place holders for your
-    #   directory. If using the CLI, use the `s3api` or `efsapi` call instead
-    #   of `s3` or `efs` so you can use the put-object operation. For example,
-    #   you use the following: `aws s3api put-object --bucket bucketname --key
-    #   path/to/folder/`. Make sure that the end of the key name ends in a `/`
-    #   for it to be considered a folder.
-    #
-    #    </note>
-    #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
     #   across multiple users. This policy scopes down user access to portions
@@ -2850,14 +2830,129 @@ module Aws::Transfer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transfer'
-      context[:gem_version] = '1.47.0'
+      context[:gem_version] = '1.50.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 
+    # Polls an API operation until a resource enters a desired state.
+    #
+    # ## Basic Usage
+    #
+    # A waiter will call an API operation until:
+    #
+    # * It is successful
+    # * It enters a terminal state
+    # * It makes the maximum number of attempts
+    #
+    # In between attempts, the waiter will sleep.
+    #
+    #     # polls in a loop, sleeping between attempts
+    #     client.wait_until(waiter_name, params)
+    #
+    # ## Configuration
+    #
+    # You can configure the maximum number of polling attempts, and the
+    # delay (in seconds) between each polling attempt. You can pass
+    # configuration as the final arguments hash.
+    #
+    #     # poll for ~25 seconds
+    #     client.wait_until(waiter_name, params, {
+    #       max_attempts: 5,
+    #       delay: 5,
+    #     })
+    #
+    # ## Callbacks
+    #
+    # You can be notified before each polling attempt and before each
+    # delay. If you throw `:success` or `:failure` from these callbacks,
+    # it will terminate the waiter.
+    #
+    #     started_at = Time.now
+    #     client.wait_until(waiter_name, params, {
+    #
+    #       # disable max attempts
+    #       max_attempts: nil,
+    #
+    #       # poll for 1 hour, instead of a number of attempts
+    #       before_wait: -> (attempts, response) do
+    #         throw :failure if Time.now - started_at > 3600
+    #       end
+    #     })
+    #
+    # ## Handling Errors
+    #
+    # When a waiter is unsuccessful, it will raise an error.
+    # All of the failure errors extend from
+    # {Aws::Waiters::Errors::WaiterFailed}.
+    #
+    #     begin
+    #       client.wait_until(...)
+    #     rescue Aws::Waiters::Errors::WaiterFailed
+    #       # resource did not enter the desired state in time
+    #     end
+    #
+    # ## Valid Waiters
+    #
+    # The following table lists the valid waiter names, the operations they call,
+    # and the default `:delay` and `:max_attempts` values.
+    #
+    # | waiter_name    | params                   | :delay   | :max_attempts |
+    # | -------------- | ------------------------ | -------- | ------------- |
+    # | server_offline | {Client#describe_server} | 30       | 120           |
+    # | server_online  | {Client#describe_server} | 30       | 120           |
+    #
+    # @raise [Errors::FailureStateError] Raised when the waiter terminates
+    #   because the waiter has entered a state that it will not transition
+    #   out of, preventing success.
+    #
+    # @raise [Errors::TooManyAttemptsError] Raised when the configured
+    #   maximum number of attempts have been made, and the waiter is not
+    #   yet successful.
+    #
+    # @raise [Errors::UnexpectedError] Raised when an error is encounted
+    #   while polling for a resource that is not expected.
+    #
+    # @raise [Errors::NoSuchWaiterError] Raised when you request to wait
+    #   for an unknown state.
+    #
+    # @return [Boolean] Returns `true` if the waiter was successful.
+    # @param [Symbol] waiter_name
+    # @param [Hash] params ({})
+    # @param [Hash] options ({})
+    # @option options [Integer] :max_attempts
+    # @option options [Integer] :delay
+    # @option options [Proc] :before_attempt
+    # @option options [Proc] :before_wait
+    def wait_until(waiter_name, params = {}, options = {})
+      w = waiter(waiter_name, options)
+      yield(w.waiter) if block_given? # deprecated
+      w.wait(params)
+    end
+
     # @api private
     # @deprecated
     def waiter_names
-      []
+      waiters.keys
+    end
+
+    private
+
+    # @param [Symbol] waiter_name
+    # @param [Hash] options ({})
+    def waiter(waiter_name, options = {})
+      waiter_class = waiters[waiter_name]
+      if waiter_class
+        waiter_class.new(options.merge(client: self))
+      else
+        raise Aws::Waiters::Errors::NoSuchWaiterError.new(waiter_name, waiters.keys)
+      end
+    end
+
+    def waiters
+      {
+        server_offline: Waiters::ServerOffline,
+        server_online: Waiters::ServerOnline
+      }
     end
 
     class << self

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')
+    SourceFileLocation = Shapes::StringShape.new(name: 'SourceFileLocation')
     SourceIp = Shapes::StringShape.new(name: 'SourceIp')
     SshPublicKey = Shapes::StructureShape.new(name: 'SshPublicKey')
     SshPublicKeyBody = Shapes::StringShape.new(name: 'SshPublicKeyBody')
@@ -223,6 +224,7 @@ module Aws::Transfer
     CopyStepDetails.add_member(:name, Shapes::ShapeRef.new(shape: WorkflowStepName, location_name: "Name"))
     CopyStepDetails.add_member(:destination_file_location, Shapes::ShapeRef.new(shape: InputFileLocation, location_name: "DestinationFileLocation"))
     CopyStepDetails.add_member(:overwrite_existing, Shapes::ShapeRef.new(shape: OverwriteExisting, location_name: "OverwriteExisting"))
+    CopyStepDetails.add_member(:source_file_location, Shapes::ShapeRef.new(shape: SourceFileLocation, location_name: "SourceFileLocation"))
     CopyStepDetails.struct_class = Types::CopyStepDetails
 
     CreateAccessRequest.add_member(:home_directory, Shapes::ShapeRef.new(shape: HomeDirectory, location_name: "HomeDirectory"))
@@ -287,6 +289,7 @@ module Aws::Transfer
     CustomStepDetails.add_member(:name, Shapes::ShapeRef.new(shape: WorkflowStepName, location_name: "Name"))
     CustomStepDetails.add_member(:target, Shapes::ShapeRef.new(shape: CustomStepTarget, location_name: "Target"))
     CustomStepDetails.add_member(:timeout_seconds, Shapes::ShapeRef.new(shape: CustomStepTimeoutSeconds, location_name: "TimeoutSeconds"))
+    CustomStepDetails.add_member(:source_file_location, Shapes::ShapeRef.new(shape: SourceFileLocation, location_name: "SourceFileLocation"))
     CustomStepDetails.struct_class = Types::CustomStepDetails
 
     DeleteAccessRequest.add_member(:server_id, Shapes::ShapeRef.new(shape: ServerId, required: true, location_name: "ServerId"))
@@ -302,6 +305,7 @@ module Aws::Transfer
     DeleteSshPublicKeyRequest.struct_class = Types::DeleteSshPublicKeyRequest
 
     DeleteStepDetails.add_member(:name, Shapes::ShapeRef.new(shape: WorkflowStepName, location_name: "Name"))
+    DeleteStepDetails.add_member(:source_file_location, Shapes::ShapeRef.new(shape: SourceFileLocation, location_name: "SourceFileLocation"))
     DeleteStepDetails.struct_class = Types::DeleteStepDetails
 
     DeleteUserRequest.add_member(:server_id, Shapes::ShapeRef.new(shape: ServerId, required: true, location_name: "ServerId"))
@@ -687,6 +691,7 @@ module Aws::Transfer
 
     TagStepDetails.add_member(:name, Shapes::ShapeRef.new(shape: WorkflowStepName, location_name: "Name"))
     TagStepDetails.add_member(:tags, Shapes::ShapeRef.new(shape: S3Tags, location_name: "Tags"))
+    TagStepDetails.add_member(:source_file_location, Shapes::ShapeRef.new(shape: SourceFileLocation, location_name: "SourceFileLocation"))
     TagStepDetails.struct_class = Types::TagStepDetails
 
     Tags.member = Shapes::ShapeRef.new(shape: Tag)

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

@@ -56,6 +56,7 @@ module Aws::Transfer
     #           },
     #         },
     #         overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #         source_file_location: "SourceFileLocation",
     #       }
     #
     # @!attribute [rw] name
@@ -64,7 +65,8 @@ module Aws::Transfer
     #
     # @!attribute [rw] destination_file_location
     #   Specifies the location for the file being copied. Only applicable
-    #   for the Copy type of workflow steps.
+    #   for Copy type workflow steps. Use `$\{Transfer:username\}` in this
+    #   field to parametrize the destination prefix by username.
     #   @return [Types::InputFileLocation]
     #
     # @!attribute [rw] overwrite_existing
@@ -72,12 +74,26 @@ module Aws::Transfer
     #   of the same name. The default is `FALSE`.
     #   @return [String]
     #
+    # @!attribute [rw] source_file_location
+    #   Specifies which file to use as input to the workflow step: either
+    #   the output from the previous step, or the originally uploaded file
+    #   for the workflow.
+    #
+    #   * Enter `$\{previous.file\}` to use the previous file as the input.
+    #     In this case, this workflow step uses the output file from the
+    #     previous workflow step as input. This is the default value.
+    #
+    #   * Enter `$\{original.file\}` to use the originally-uploaded file
+    #     location as input for this step.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CopyStepDetails AWS API Documentation
     #
     class CopyStepDetails < Struct.new(
       :name,
       :destination_file_location,
-      :overwrite_existing)
+      :overwrite_existing,
+      :source_file_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -146,17 +162,6 @@ module Aws::Transfer
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
-    #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon
-    #   S3 or EFS, the entry is ignored. As a workaround, you can use the
-    #   Amazon S3 API or EFS API to create 0 byte objects as place holders
-    #   for your directory. If using the CLI, use the `s3api` or `efsapi`
-    #   call instead of `s3` or `efs` so you can use the put-object
-    #   operation. For example, you use the following: `aws s3api put-object
-    #   --bucket bucketname --key path/to/folder/`. Make sure that the end
-    #   of the key name ends in a `/` for it to be considered a folder.
-    #
-    #    </note>
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -627,17 +632,6 @@ module Aws::Transfer
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
-    #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon
-    #   S3 or EFS, the entry is ignored. As a workaround, you can use the
-    #   Amazon S3 API or EFS API to create 0 byte objects as place holders
-    #   for your directory. If using the CLI, use the `s3api` or `efsapi`
-    #   call instead of `s3` or `efs` so you can use the put-object
-    #   operation. For example, you use the following: `aws s3api put-object
-    #   --bucket bucketname --key path/to/folder/`. Make sure that the end
-    #   of the key name ends in a `/` for it to be considered a folder.
-    #
-    #    </note>
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -772,14 +766,17 @@ module Aws::Transfer
     #                 },
     #               },
     #               overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             custom_step_details: {
     #               name: "WorkflowStepName",
     #               target: "CustomStepTarget",
     #               timeout_seconds: 1,
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             delete_step_details: {
     #               name: "WorkflowStepName",
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             tag_step_details: {
     #               name: "WorkflowStepName",
@@ -789,6 +786,7 @@ module Aws::Transfer
     #                   value: "S3TagValue", # required
     #                 },
     #               ],
+    #               source_file_location: "SourceFileLocation",
     #             },
     #           },
     #         ],
@@ -808,14 +806,17 @@ module Aws::Transfer
     #                 },
     #               },
     #               overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             custom_step_details: {
     #               name: "WorkflowStepName",
     #               target: "CustomStepTarget",
     #               timeout_seconds: 1,
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             delete_step_details: {
     #               name: "WorkflowStepName",
+    #               source_file_location: "SourceFileLocation",
     #             },
     #             tag_step_details: {
     #               name: "WorkflowStepName",
@@ -825,6 +826,7 @@ module Aws::Transfer
     #                   value: "S3TagValue", # required
     #                 },
     #               ],
+    #               source_file_location: "SourceFileLocation",
     #             },
     #           },
     #         ],
@@ -912,6 +914,7 @@ module Aws::Transfer
     #         name: "WorkflowStepName",
     #         target: "CustomStepTarget",
     #         timeout_seconds: 1,
+    #         source_file_location: "SourceFileLocation",
     #       }
     #
     # @!attribute [rw] name
@@ -926,12 +929,26 @@ module Aws::Transfer
     #   Timeout, in seconds, for the step.
     #   @return [Integer]
     #
+    # @!attribute [rw] source_file_location
+    #   Specifies which file to use as input to the workflow step: either
+    #   the output from the previous step, or the originally uploaded file
+    #   for the workflow.
+    #
+    #   * Enter `$\{previous.file\}` to use the previous file as the input.
+    #     In this case, this workflow step uses the output file from the
+    #     previous workflow step as input. This is the default value.
+    #
+    #   * Enter `$\{original.file\}` to use the originally-uploaded file
+    #     location as input for this step.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/CustomStepDetails AWS API Documentation
     #
     class CustomStepDetails < Struct.new(
       :name,
       :target,
-      :timeout_seconds)
+      :timeout_seconds,
+      :source_file_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1037,16 +1054,31 @@ module Aws::Transfer
     #
     #       {
     #         name: "WorkflowStepName",
+    #         source_file_location: "SourceFileLocation",
     #       }
     #
     # @!attribute [rw] name
     #   The name of the step, used as an identifier.
     #   @return [String]
     #
+    # @!attribute [rw] source_file_location
+    #   Specifies which file to use as input to the workflow step: either
+    #   the output from the previous step, or the originally uploaded file
+    #   for the workflow.
+    #
+    #   * Enter `$\{previous.file\}` to use the previous file as the input.
+    #     In this case, this workflow step uses the output file from the
+    #     previous workflow step as input. This is the default value.
+    #
+    #   * Enter `$\{original.file\}` to use the originally-uploaded file
+    #     location as input for this step.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DeleteStepDetails AWS API Documentation
     #
     class DeleteStepDetails < Struct.new(
-      :name)
+      :name,
+      :source_file_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2099,17 +2131,6 @@ module Aws::Transfer
     #
     # `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
-    # <note markdown="1"> If the target of a logical directory entry does not exist in Amazon S3
-    # or EFS, the entry is ignored. As a workaround, you can use the Amazon
-    # S3 API or EFS API to create 0 byte objects as place holders for your
-    # directory. If using the CLI, use the `s3api` or `efsapi` call instead
-    # of `s3` or `efs` so you can use the put-object operation. For example,
-    # you use the following: `aws s3api put-object --bucket bucketname --key
-    # path/to/folder/`. Make sure that the end of the key name ends in a `/`
-    # for it to be considered a folder.
-    #
-    #  </note>
-    #
     # @note When making an API call, you may pass HomeDirectoryMapEntry
     #   data as a hash:
     #
@@ -3514,6 +3535,7 @@ module Aws::Transfer
     #             value: "S3TagValue", # required
     #           },
     #         ],
+    #         source_file_location: "SourceFileLocation",
     #       }
     #
     # @!attribute [rw] name
@@ -3524,11 +3546,25 @@ module Aws::Transfer
     #   Array that contains from 1 to 10 key/value pairs.
     #   @return [Array<Types::S3Tag>]
     #
+    # @!attribute [rw] source_file_location
+    #   Specifies which file to use as input to the workflow step: either
+    #   the output from the previous step, or the originally uploaded file
+    #   for the workflow.
+    #
+    #   * Enter `$\{previous.file\}` to use the previous file as the input.
+    #     In this case, this workflow step uses the output file from the
+    #     previous workflow step as input. This is the default value.
+    #
+    #   * Enter `$\{original.file\}` to use the originally-uploaded file
+    #     location as input for this step.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/TagStepDetails AWS API Documentation
     #
     class TagStepDetails < Struct.new(
       :name,
-      :tags)
+      :tags,
+      :source_file_location)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3595,6 +3631,11 @@ module Aws::Transfer
     #
     # @!attribute [rw] message
     #   A message that indicates whether the test was successful or not.
+    #
+    #   <note markdown="1"> If an empty string is returned, the most likely cause is that the
+    #   authentication failed due to an incorrect username or password.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] url
@@ -3720,17 +3761,6 @@ module Aws::Transfer
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
-    #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon
-    #   S3 or EFS, the entry is ignored. As a workaround, you can use the
-    #   Amazon S3 API or EFS API to create 0 byte objects as place holders
-    #   for your directory. If using the CLI, use the `s3api` or `efsapi`
-    #   call instead of `s3` or `efs` so you can use the put-object
-    #   operation. For example, you use the following: `aws s3api put-object
-    #   --bucket bucketname --key path/to/folder/`. Make sure that the end
-    #   of the key name ends in a `/` for it to be considered a folder.
-    #
-    #    </note>
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -4149,17 +4179,6 @@ module Aws::Transfer
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
     #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
-    #
-    #   <note markdown="1"> If the target of a logical directory entry does not exist in Amazon
-    #   S3 or EFS, the entry is ignored. As a workaround, you can use the
-    #   Amazon S3 API or EFS API to create 0 byte objects as place holders
-    #   for your directory. If using the CLI, use the `s3api` or `efsapi`
-    #   call instead of `s3` or `efs` so you can use the put-object
-    #   operation. For example, you use the following: `aws s3api put-object
-    #   --bucket bucketname --key path/to/folder/`. Make sure that the end
-    #   of the key name ends in a `/` for it to be considered a folder.
-    #
-    #    </note>
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -4368,14 +4387,17 @@ module Aws::Transfer
     #             },
     #           },
     #           overwrite_existing: "TRUE", # accepts TRUE, FALSE
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         custom_step_details: {
     #           name: "WorkflowStepName",
     #           target: "CustomStepTarget",
     #           timeout_seconds: 1,
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         delete_step_details: {
     #           name: "WorkflowStepName",
+    #           source_file_location: "SourceFileLocation",
     #         },
     #         tag_step_details: {
     #           name: "WorkflowStepName",
@@ -4385,6 +4407,7 @@ module Aws::Transfer
     #               value: "S3TagValue", # required
     #             },
     #           ],
+    #           source_file_location: "SourceFileLocation",
     #         },
     #       }
     #

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

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+# WARNING ABOUT GENERATED CODE
+#
+# This file is generated. See the contributing guide for more information:
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
+#
+# WARNING ABOUT GENERATED CODE
+
+require 'aws-sdk-core/waiters'
+
+module Aws::Transfer
+  # Waiters are utility methods that poll for a particular state to occur
+  # on a client. Waiters can fail after a number of attempts at a polling
+  # interval defined for the service client.
+  #
+  # For a list of operations that can be waited for and the
+  # client methods called for each operation, see the table below or the
+  # {Client#wait_until} field documentation for the {Client}.
+  #
+  # # Invoking a Waiter
+  # To invoke a waiter, call #wait_until on a {Client}. The first parameter
+  # is the waiter name, which is specific to the service client and indicates
+  # which operation is being waited for. The second parameter is a hash of
+  # parameters that are passed to the client method called by the waiter,
+  # which varies according to the waiter name.
+  #
+  # # Wait Failures
+  # To catch errors in a waiter, use WaiterFailed,
+  # as shown in the following example.
+  #
+  #     rescue rescue Aws::Waiters::Errors::WaiterFailed => error
+  #       puts "failed waiting for instance running: #{error.message}
+  #     end
+  #
+  # # Configuring a Waiter
+  # Each waiter has a default polling interval and a maximum number of
+  # attempts it will make before returning control to your program.
+  # To set these values, use the `max_attempts` and `delay` parameters
+  # in your `#wait_until` call.
+  # The following example waits for up to 25 seconds, polling every five seconds.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.max_attempts = 5
+  #       w.delay = 5
+  #     end
+  #
+  # To disable wait failures, set the value of either of these parameters
+  # to `nil`.
+  #
+  # # Extending a Waiter
+  # To modify the behavior of waiters, you can register callbacks that are
+  # triggered before each polling attempt and before waiting.
+  #
+  # The following example implements an exponential backoff in a waiter
+  # by doubling the amount of time to wait on every attempt.
+  #
+  #     client.wait_until(...) do |w|
+  #       w.interval = 0 # disable normal sleep
+  #       w.before_wait do |n, resp|
+  #         sleep(n ** 2)
+  #       end
+  #     end
+  #
+  # # Available Waiters
+  #
+  # The following table lists the valid waiter names, the operations they call,
+  # and the default `:delay` and `:max_attempts` values.
+  #
+  # | waiter_name    | params                   | :delay   | :max_attempts |
+  # | -------------- | ------------------------ | -------- | ------------- |
+  # | server_offline | {Client#describe_server} | 30       | 120           |
+  # | server_online  | {Client#describe_server} | 30       | 120           |
+  #
+  module Waiters
+
+    class ServerOffline
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (120)
+      # @option options [Integer] :delay (30)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 120,
+          delay: 30,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_server,
+            acceptors: [
+              {
+                "argument" => "server.state",
+                "expected" => "OFFLINE",
+                "matcher" => "path",
+                "state" => "success"
+              },
+              {
+                "argument" => "server.state",
+                "expected" => "STOP_FAILED",
+                "matcher" => "path",
+                "state" => "failure"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_server)
+      # @return (see Client#describe_server)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+
+    class ServerOnline
+
+      # @param [Hash] options
+      # @option options [required, Client] :client
+      # @option options [Integer] :max_attempts (120)
+      # @option options [Integer] :delay (30)
+      # @option options [Proc] :before_attempt
+      # @option options [Proc] :before_wait
+      def initialize(options)
+        @client = options.fetch(:client)
+        @waiter = Aws::Waiters::Waiter.new({
+          max_attempts: 120,
+          delay: 30,
+          poller: Aws::Waiters::Poller.new(
+            operation_name: :describe_server,
+            acceptors: [
+              {
+                "argument" => "server.state",
+                "expected" => "ONLINE",
+                "matcher" => "path",
+                "state" => "success"
+              },
+              {
+                "argument" => "server.state",
+                "expected" => "START_FAILED",
+                "matcher" => "path",
+                "state" => "failure"
+              }
+            ]
+          )
+        }.merge(options))
+      end
+
+      # @option (see Client#describe_server)
+      # @return (see Client#describe_server)
+      def wait(params = {})
+        @waiter.wait(client: @client, params: params)
+      end
+
+      # @api private
+      attr_reader :waiter
+
+    end
+  end
+end

data/lib/aws-sdk-transfer.rb

@@ -15,6 +15,7 @@ require_relative 'aws-sdk-transfer/types'
 require_relative 'aws-sdk-transfer/client_api'
 require_relative 'aws-sdk-transfer/client'
 require_relative 'aws-sdk-transfer/errors'
+require_relative 'aws-sdk-transfer/waiters'
 require_relative 'aws-sdk-transfer/resource'
 require_relative 'aws-sdk-transfer/customizations'
 
@@ -48,6 +49,6 @@ require_relative 'aws-sdk-transfer/customizations'
 # @!group service
 module Aws::Transfer
 
-  GEM_VERSION = '1.47.0'
+  GEM_VERSION = '1.50.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-transfer
 version: !ruby/object:Gem::Version
-  version: 1.47.0
+  version: 1.50.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-18 00:00:00.000000000 Z
+date: 2022-03-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement
@@ -62,6 +62,7 @@ files:
 - lib/aws-sdk-transfer/errors.rb
 - lib/aws-sdk-transfer/resource.rb
 - lib/aws-sdk-transfer/types.rb
+- lib/aws-sdk-transfer/waiters.rb
 homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0