aws-sdk-transfer 1.50.0 → 1.53.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e4409d8646c52571f98d0f73d469176b53d7a405abb734576d1246d449c4852
-  data.tar.gz: 79ab9afb3e5e42cd699384918c77c6e93f04d65e509c9482cf3364d9b7a26919
+  metadata.gz: a742e40b5f989c9031a96e4f5ff6dcd658b2c66d2a980c46e900563062c5b151
+  data.tar.gz: 32eb6766312c2fe5fdc87a957476eaff17631cca76e5210ba9a0abec50050533
 SHA512:
-  metadata.gz: 407fc4c5de4a8347616dde8a71db841ccd4193a6e7b38cc42e2b8df41df3350d7fe1eb03d6d996a3d9589f1e2cd215165c9e8078160fc8ae610ed19e9ace6bd1
-  data.tar.gz: ffc9a729b8a42a08d0e4d74b5e3b47c96a1c008bfcb5188b31df56ce5a3bd7608409432f116bd6c59e0a7ce8438d2035ee28a26fa2114c6158c15cdeadfb9282
+  metadata.gz: e80e403afecc2e0ec51577efd15bd0c6725775b5595e831c9051a57f55f882edd95fc2b03a9592c827362cf0d54793a4d7b11bfb05c8f5141f6c83dc828cdb1b
+  data.tar.gz: f1f2dc3daf9f057cde6588295144da746d7724ee59e314e3fe1345a662f72944d310763c4a1e484f10ad0d52e627955afd87edb06a98a609b5be160bc1eab80e

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.53.0 (2022-04-19)
+------------------
+
+* Feature - This release contains corrected HomeDirectoryMappings examples for several API functions: CreateAccess, UpdateAccess, CreateUser, and UpdateUser,.
+
+1.52.0 (2022-03-23)
+------------------
+
+* Feature - Documentation updates for AWS Transfer Family to describe how to remove an associated workflow from a server.
+
+1.51.0 (2022-03-10)
+------------------
+
+* Feature - Adding more descriptive error types for managed workflows
+
 1.50.0 (2022-03-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.50.0
+1.53.0

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

@@ -406,7 +406,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
@@ -657,8 +657,23 @@ module Aws::Transfer
     #   set, user activity can be viewed in your CloudWatch logs.
     #
     # @option params [String] :post_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed after the user authenticates.
+    #
+    #   <note markdown="1"> The SFTP protocol does not support post-authentication display
+    #   banners.
+    #
+    #    </note>
     #
     # @option params [String] :pre_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed before the user authenticates. For example, the
+    #   following banner displays details about using the system.
+    #
+    #   `This system is for the use of authorized users only. Individuals
+    #   using this computer system without authority, or in excess of their
+    #   authority, are subject to having all of their activities on this
+    #   system monitored and recorded by system personnel.`
     #
     # @option params [Array<String>] :protocols
     #   Specifies the file transfer protocol or protocols over which your file
@@ -821,7 +836,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
@@ -955,13 +970,13 @@ module Aws::Transfer
     #   The `TYPE` specifies which of the following actions is being taken for
     #   this step.
     #
-    #   * *Copy*\: copy the file to another location
+    #   * *COPY*\: copy the file to another location
     #
-    #   * *Custom*\: custom step with a lambda target
+    #   * *CUSTOM*\: custom step with a lambda target
     #
-    #   * *Delete*\: delete the file
+    #   * *DELETE*\: delete the file
     #
-    #   * *Tag*\: add a tag to the file
+    #   * *TAG*\: add a tag to the file
     #
     #   <note markdown="1"> Currently, copying and tagging are supported only on S3.
     #
@@ -1363,12 +1378,12 @@ module Aws::Transfer
     #   resp.execution.results.steps #=> Array
     #   resp.execution.results.steps[0].step_type #=> String, one of "COPY", "CUSTOM", "TAG", "DELETE"
     #   resp.execution.results.steps[0].outputs #=> String
-    #   resp.execution.results.steps[0].error.type #=> String, one of "PERMISSION_DENIED"
+    #   resp.execution.results.steps[0].error.type #=> String, one of "PERMISSION_DENIED", "CUSTOM_STEP_FAILED", "THROTTLED", "ALREADY_EXISTS", "NOT_FOUND", "BAD_REQUEST", "TIMEOUT", "INTERNAL_SERVER_ERROR"
     #   resp.execution.results.steps[0].error.message #=> String
     #   resp.execution.results.on_exception_steps #=> Array
     #   resp.execution.results.on_exception_steps[0].step_type #=> String, one of "COPY", "CUSTOM", "TAG", "DELETE"
     #   resp.execution.results.on_exception_steps[0].outputs #=> String
-    #   resp.execution.results.on_exception_steps[0].error.type #=> String, one of "PERMISSION_DENIED"
+    #   resp.execution.results.on_exception_steps[0].error.type #=> String, one of "PERMISSION_DENIED", "CUSTOM_STEP_FAILED", "THROTTLED", "ALREADY_EXISTS", "NOT_FOUND", "BAD_REQUEST", "TIMEOUT", "INTERNAL_SERVER_ERROR"
     #   resp.execution.results.on_exception_steps[0].error.message #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/DescribeExecution AWS API Documentation
@@ -2344,7 +2359,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
@@ -2572,8 +2587,23 @@ module Aws::Transfer
     #   set, user activity can be viewed in your CloudWatch logs.
     #
     # @option params [String] :post_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed after the user authenticates.
+    #
+    #   <note markdown="1"> The SFTP protocol does not support post-authentication display
+    #   banners.
+    #
+    #    </note>
     #
     # @option params [String] :pre_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed before the user authenticates. For example, the
+    #   following banner displays details about using the system.
+    #
+    #   `This system is for the use of authorized users only. Individuals
+    #   using this computer system without authority, or in excess of their
+    #   authority, are subject to having all of their activities on this
+    #   system monitored and recorded by system personnel.`
     #
     # @option params [Array<String>] :protocols
     #   Specifies the file transfer protocol or protocols over which your file
@@ -2617,6 +2647,12 @@ module Aws::Transfer
     #   Specifies the workflow ID for the workflow to assign and the execution
     #   role used for executing the workflow.
     #
+    #   To remove an associated workflow from a server, you can provide an
+    #   empty `OnUpload` object, as in the following example.
+    #
+    #   `aws transfer update-server --server-id s-01234567890abcdef
+    #   --workflow-details '\{"OnUpload":[]\}'`
+    #
     # @return [Types::UpdateServerResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateServerResponse#server_id #server_id} => String
@@ -2717,7 +2753,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
     # @option params [String] :policy
     #   A session policy for your user so that you can use the same IAM role
@@ -2830,7 +2866,7 @@ module Aws::Transfer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transfer'
-      context[:gem_version] = '1.50.0'
+      context[:gem_version] = '1.53.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -161,7 +161,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -465,9 +465,24 @@ module Aws::Transfer
     #   @return [String]
     #
     # @!attribute [rw] post_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed after the user authenticates.
+    #
+    #   <note markdown="1"> The SFTP protocol does not support post-authentication display
+    #   banners.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] pre_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed before the user authenticates. For example, the
+    #   following banner displays details about using the system.
+    #
+    #   `This system is for the use of authorized users only. Individuals
+    #   using this computer system without authority, or in excess of their
+    #   authority, are subject to having all of their activities on this
+    #   system monitored and recorded by system personnel.`
     #   @return [String]
     #
     # @!attribute [rw] protocols
@@ -631,7 +646,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -849,13 +864,13 @@ module Aws::Transfer
     #   The `TYPE` specifies which of the following actions is being taken
     #   for this step.
     #
-    #   * *Copy*\: copy the file to another location
+    #   * *COPY*\: copy the file to another location
     #
-    #   * *Custom*\: custom step with a lambda target
+    #   * *CUSTOM*\: custom step with a lambda target
     #
-    #   * *Delete*\: delete the file
+    #   * *DELETE*\: delete the file
     #
-    #   * *Tag*\: add a tag to the file
+    #   * *TAG*\: add a tag to the file
     #
     #   <note markdown="1"> Currently, copying and tagging are supported only on S3.
     #
@@ -1669,9 +1684,24 @@ module Aws::Transfer
     #   @return [String]
     #
     # @!attribute [rw] post_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed after the user authenticates.
+    #
+    #   <note markdown="1"> The SFTP protocol does not support post-authentication display
+    #   banners.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] pre_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed before the user authenticates. For example, the
+    #   following banner displays details about using the system.
+    #
+    #   `This system is for the use of authorized users only. Individuals
+    #   using this computer system without authority, or in excess of their
+    #   authority, are subject to having all of their activities on this
+    #   system monitored and recorded by system personnel.`
     #   @return [String]
     #
     # @!attribute [rw] protocols
@@ -2027,10 +2057,38 @@ module Aws::Transfer
     # the execution of the workflow.
     #
     # @!attribute [rw] type
-    #   Specifies the error type: currently, the only valid value is
-    #   `PERMISSION_DENIED`, which occurs if your policy does not contain
-    #   the correct permissions to complete one or more of the steps in the
-    #   workflow.
+    #   Specifies the error type.
+    #
+    #   * `ALREADY_EXISTS`\: occurs for a copy step, if the overwrite option
+    #     is not selected and a file with the same name already exists in
+    #     the target location.
+    #
+    #   * `BAD_REQUEST`\: a general bad request: for example, a step that
+    #     attempts to tag an EFS file returns `BAD_REQUEST`, as only S3
+    #     files can be tagged.
+    #
+    #   * `CUSTOM_STEP_FAILED`\: occurs when the custom step provided a
+    #     callback that indicates failure.
+    #
+    #   * `INTERNAL_SERVER_ERROR`\: a catch-all error that can occur for a
+    #     variety of reasons.
+    #
+    #   * `NOT_FOUND`\: occurs when a requested entity, for example a source
+    #     file for a copy step, does not exist.
+    #
+    #   * `PERMISSION_DENIED`\: occurs if your policy does not contain the
+    #     correct permissions to complete one or more of the steps in the
+    #     workflow.
+    #
+    #   * `TIMEOUT`\: occurs when the execution times out.
+    #
+    #     <note markdown="1"> You can set the `TimeoutSeconds` for a custom step, anywhere from
+    #     1 second to 1800 seconds (30 minutes).
+    #
+    #      </note>
+    #
+    #   * `THROTTLED`\: occurs if you exceed the new execution refill rate
+    #     of one workflow per second.
     #   @return [String]
     #
     # @!attribute [rw] message
@@ -2075,13 +2133,13 @@ module Aws::Transfer
     # @!attribute [rw] step_type
     #   One of the available step types.
     #
-    #   * *Copy*\: copy the file to another location
+    #   * *COPY*\: copy the file to another location
     #
-    #   * *Custom*\: custom step with a lambda target
+    #   * *CUSTOM*\: custom step with a lambda target
     #
-    #   * *Delete*\: delete the file
+    #   * *DELETE*\: delete the file
     #
-    #   * *Tag*\: add a tag to the file
+    #   * *TAG*\: add a tag to the file
     #   @return [String]
     #
     # @!attribute [rw] outputs
@@ -2129,7 +2187,7 @@ module Aws::Transfer
     #
     # The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    # `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    # `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #
     # @note When making an API call, you may pass HomeDirectoryMapEntry
     #   data as a hash:
@@ -3760,7 +3818,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -4031,9 +4089,24 @@ module Aws::Transfer
     #   @return [String]
     #
     # @!attribute [rw] post_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed after the user authenticates.
+    #
+    #   <note markdown="1"> The SFTP protocol does not support post-authentication display
+    #   banners.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] pre_authentication_login_banner
+    #   Specify a string to display when users connect to a server. This
+    #   string is displayed before the user authenticates. For example, the
+    #   following banner displays details about using the system.
+    #
+    #   `This system is for the use of authorized users only. Individuals
+    #   using this computer system without authority, or in excess of their
+    #   authority, are subject to having all of their activities on this
+    #   system monitored and recorded by system personnel.`
     #   @return [String]
     #
     # @!attribute [rw] protocols
@@ -4080,6 +4153,12 @@ module Aws::Transfer
     # @!attribute [rw] workflow_details
     #   Specifies the workflow ID for the workflow to assign and the
     #   execution role used for executing the workflow.
+    #
+    #   To remove an associated workflow from a server, you can provide an
+    #   empty `OnUpload` object, as in the following example.
+    #
+    #   `aws transfer update-server --server-id s-01234567890abcdef
+    #   --workflow-details '\{"OnUpload":[]\}'`
     #   @return [Types::WorkflowDetails]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/UpdateServerRequest AWS API Documentation
@@ -4178,7 +4257,7 @@ module Aws::Transfer
     #
     #   The following is an `Entry` and `Target` pair example for `chroot`.
     #
-    #   `[ \{ "Entry:": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
+    #   `[ \{ "Entry": "/", "Target": "/bucket_name/home/mydirectory" \} ]`
     #   @return [Array<Types::HomeDirectoryMapEntry>]
     #
     # @!attribute [rw] policy
@@ -4357,6 +4436,12 @@ module Aws::Transfer
     # @!attribute [rw] on_upload
     #   A trigger that starts a workflow: the workflow begins to execute
     #   after a file is uploaded.
+    #
+    #   To remove an associated workflow from a server, you can provide an
+    #   empty `OnUpload` object, as in the following example.
+    #
+    #   `aws transfer update-server --server-id s-01234567890abcdef
+    #   --workflow-details '\{"OnUpload":[]\}'`
     #   @return [Array<Types::WorkflowDetail>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/WorkflowDetails AWS API Documentation
@@ -4414,13 +4499,13 @@ module Aws::Transfer
     # @!attribute [rw] type
     #   Currently, the following step types are supported.
     #
-    #   * *Copy*\: copy the file to another location
+    #   * *COPY*\: copy the file to another location
     #
-    #   * *Custom*\: custom step with a lambda target
+    #   * *CUSTOM*\: custom step with a lambda target
     #
-    #   * *Delete*\: delete the file
+    #   * *DELETE*\: delete the file
     #
-    #   * *Tag*\: add a tag to the file
+    #   * *TAG*\: add a tag to the file
     #   @return [String]
     #
     # @!attribute [rw] copy_step_details

data/lib/aws-sdk-transfer.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-transfer
 version: !ruby/object:Gem::Version
-  version: 1.50.0
+  version: 1.53.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-03-04 00:00:00.000000000 Z
+date: 2022-04-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core