aws-sdk-transfer 1.14.0 → 1.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1b6d99cc257a9fbe2dd1c248eea093edead665e7
-  data.tar.gz: ac41759ef49d330cdea6227354e0fce954e85c80
+  metadata.gz: 640f4f4d43eb97008366aea349e471a7ec69b1e3
+  data.tar.gz: 2b8ba0c1a8dcd6d87cddd7f6fb3e41549fa0b40b
 SHA512:
-  metadata.gz: fdd3779e23a66f981e8b9db9206dbd690dd32dbca279f67eca4225ba37eb093d6c59cbda5758d18204ba9fc8698644bf821b384f590ffd25c022241abe3b8320
-  data.tar.gz: a310e7aeb28f0208f095006192a42683e3010942fc7dc9a54472b67bac0e35975db69ce19d1d1d6375312be625a68e53451754a696fd46817e41e4e889aed5fc
+  metadata.gz: 1acd1ed522cc99b0608011624e750c1805eef04e2ad86f42dad100834eaaf2ba8e7c8b7a34db04e35d6e319181a8246fe5207a2b6b84c573818c9d54f26cf23c
+  data.tar.gz: eeb3e5a1d74130be87048906d6845253bf96c9414a9cc8fd7b958d23ec8ad568dd62c48aa1be5621949d36a66521b379c54452f1a899e581dce298d32332324b

data/lib/aws-sdk-transfer.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-transfer/customizations'
 # @service
 module Aws::Transfer
 
-  GEM_VERSION = '1.14.0'
+  GEM_VERSION = '1.15.0'
 
 end

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

@@ -288,7 +288,7 @@ module Aws::Transfer
     #   Accidentally changing a server's host key can be disruptive.
     #
     #   For more information, see
-    #   "https://docs.aws.amazon.com/transfer/latest/userguide/change-host-key"
+    #   "https://alpha-docs-aws.amazon.com/transfer/latest/userguide/configuring-servers.html#change-host-key"
     #   in the *AWS SFTP User Guide.*
     #
     # @option params [Types::IdentityProviderDetails] :identity_provider_details
@@ -364,7 +364,35 @@ module Aws::Transfer
     #
     # @option params [String] :home_directory
     #   The landing directory (folder) for a user when they log in to the
-    #   server using their SFTP client. An example is `/home/username `.
+    #   server using their SFTP client.
+    #
+    #   An example is <`your-Amazon-S3-bucket-name>/home/username`.
+    #
+    # @option params [String] :home_directory_type
+    #   The type of landing directory (folder) you want your users' home
+    #   directory to be when they log into the SFTP server. If you set it to
+    #   `PATH`, the user will see the absolute Amazon S3 bucket paths as is in
+    #   their SFTP clients. If you set it `LOGICAL`, you will need to provide
+    #   mappings in the `HomeDirectoryMappings` for how you want to make S3
+    #   paths visible to your user.
+    #
+    # @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
+    #   Logical directory mappings that specify what S3 paths and keys should
+    #   be visible to your user and how you want to make them visible. You
+    #   will need to specify the "`Entry`" and "`Target`" pair, where
+    #   `Entry` shows how the path is made visible and `Target` is the actual
+    #   S3 path. If you only specify a target, it will be displayed as is. You
+    #   will need to also make sure that your AWS IAM Role provides access to
+    #   paths in `Target`. The following is an example.
+    #
+    #   `'[ "/bucket2/documentation", \{ "Entry": "your-personal-report.pdf",
+    #   "Target": "/bucket3/customized-reports/$\{transfer:UserName\}.pdf" \}
+    #   ]'`
+    #
+    #   In most cases, you can use this value instead of the scope down policy
+    #   to lock your user down to the designated home directory ("chroot").
+    #   To do this, you can set `Entry` to '/' and set `Target` to the
+    #   HomeDirectory parameter value.
     #
     # @option params [String] :policy
     #   A scope-down policy for your user so you can use the same IAM role
@@ -424,6 +452,13 @@ module Aws::Transfer
     #
     #   resp = client.create_user({
     #     home_directory: "HomeDirectory",
+    #     home_directory_type: "PATH", # accepts PATH, LOGICAL
+    #     home_directory_mappings: [
+    #       {
+    #         entry: "MapEntry", # required
+    #         target: "MapTarget", # required
+    #       },
+    #     ],
     #     policy: "Policy",
     #     role: "Role", # required
     #     server_id: "ServerId", # required
@@ -620,6 +655,10 @@ module Aws::Transfer
     #   resp.server_id #=> String
     #   resp.user.arn #=> String
     #   resp.user.home_directory #=> String
+    #   resp.user.home_directory_mappings #=> Array
+    #   resp.user.home_directory_mappings[0].entry #=> String
+    #   resp.user.home_directory_mappings[0].target #=> String
+    #   resp.user.home_directory_type #=> String, one of "PATH", "LOGICAL"
     #   resp.user.policy #=> String
     #   resp.user.role #=> String
     #   resp.user.ssh_public_keys #=> Array
@@ -818,6 +857,7 @@ module Aws::Transfer
     #   resp.users #=> Array
     #   resp.users[0].arn #=> String
     #   resp.users[0].home_directory #=> String
+    #   resp.users[0].home_directory_type #=> String, one of "PATH", "LOGICAL"
     #   resp.users[0].role #=> String
     #   resp.users[0].ssh_public_key_count #=> Integer
     #   resp.users[0].user_name #=> String
@@ -1099,8 +1139,35 @@ module Aws::Transfer
     #
     # @option params [String] :home_directory
     #   A parameter that specifies the landing directory (folder) for a user
-    #   when they log in to the server using their client. An example is
-    #   `/home/username `.
+    #   when they log in to the server using their client.
+    #
+    #   An example is `<your-Amazon-S3-bucket-name>/home/username`.
+    #
+    # @option params [String] :home_directory_type
+    #   The type of landing directory (folder) you want your users' home
+    #   directory to be when they log into the SFTP serve. If you set it to
+    #   `PATH`, the user will see the absolute Amazon S3 bucket paths as is in
+    #   their SFTP clients. If you set it `LOGICAL`, you will need to provide
+    #   mappings in the `HomeDirectoryMappings` for how you want to make S3
+    #   paths visible to your user.
+    #
+    # @option params [Array<Types::HomeDirectoryMapEntry>] :home_directory_mappings
+    #   Logical directory mappings that specify what S3 paths and keys should
+    #   be visible to your user and how you want to make them visible. You
+    #   will need to specify the "`Entry`" and "`Target`" pair, where
+    #   `Entry` shows how the path is made visible and `Target` is the actual
+    #   S3 path. If you only specify a target, it will be displayed as is. You
+    #   will need to also make sure that your AWS IAM Role provides access to
+    #   paths in `Target`. The following is an example.
+    #
+    #   `'[ "/bucket2/documentation", \{ "Entry": "your-personal-report.pdf",
+    #   "Target": "/bucket3/customized-reports/$\{transfer:UserName\}.pdf" \}
+    #   ]'`
+    #
+    #   In most cases, you can use this value instead of the scope down policy
+    #   to lock your user down to the designated home directory ("chroot").
+    #   To do this, you can set `Entry` to '/' and set `Target` to the
+    #   HomeDirectory parameter value.
     #
     # @option params [String] :policy
     #   Allows you to supply a scope-down policy for your user so you can use
@@ -1155,6 +1222,13 @@ module Aws::Transfer
     #
     #   resp = client.update_user({
     #     home_directory: "HomeDirectory",
+    #     home_directory_type: "PATH", # accepts PATH, LOGICAL
+    #     home_directory_mappings: [
+    #       {
+    #         entry: "MapEntry", # required
+    #         target: "MapTarget", # required
+    #       },
+    #     ],
     #     policy: "Policy",
     #     role: "Role",
     #     server_id: "ServerId", # required
@@ -1188,7 +1262,7 @@ module Aws::Transfer
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-transfer'
-      context[:gem_version] = '1.14.0'
+      context[:gem_version] = '1.15.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -29,6 +29,9 @@ module Aws::Transfer
     EndpointDetails = Shapes::StructureShape.new(name: 'EndpointDetails')
     EndpointType = Shapes::StringShape.new(name: 'EndpointType')
     HomeDirectory = Shapes::StringShape.new(name: 'HomeDirectory')
+    HomeDirectoryMapEntry = Shapes::StructureShape.new(name: 'HomeDirectoryMapEntry')
+    HomeDirectoryMappings = Shapes::ListShape.new(name: 'HomeDirectoryMappings')
+    HomeDirectoryType = Shapes::StringShape.new(name: 'HomeDirectoryType')
     HostKey = Shapes::StringShape.new(name: 'HostKey')
     HostKeyFingerprint = Shapes::StringShape.new(name: 'HostKeyFingerprint')
     IdentityProviderDetails = Shapes::StructureShape.new(name: 'IdentityProviderDetails')
@@ -48,6 +51,8 @@ module Aws::Transfer
     ListedServers = Shapes::ListShape.new(name: 'ListedServers')
     ListedUser = Shapes::StructureShape.new(name: 'ListedUser')
     ListedUsers = Shapes::ListShape.new(name: 'ListedUsers')
+    MapEntry = Shapes::StringShape.new(name: 'MapEntry')
+    MapTarget = Shapes::StringShape.new(name: 'MapTarget')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
     Message = Shapes::StringShape.new(name: 'Message')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
@@ -58,6 +63,7 @@ module Aws::Transfer
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResourceType = Shapes::StringShape.new(name: 'ResourceType')
     Response = Shapes::StringShape.new(name: 'Response')
+    RetryAfterSeconds = Shapes::StringShape.new(name: 'RetryAfterSeconds')
     Role = Shapes::StringShape.new(name: 'Role')
     ServerId = Shapes::StringShape.new(name: 'ServerId')
     ServiceErrorMessage = Shapes::StringShape.new(name: 'ServiceErrorMessage')
@@ -79,6 +85,7 @@ module Aws::Transfer
     Tags = Shapes::ListShape.new(name: 'Tags')
     TestIdentityProviderRequest = Shapes::StructureShape.new(name: 'TestIdentityProviderRequest')
     TestIdentityProviderResponse = Shapes::StructureShape.new(name: 'TestIdentityProviderResponse')
+    ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UpdateServerRequest = Shapes::StructureShape.new(name: 'UpdateServerRequest')
     UpdateServerResponse = Shapes::StructureShape.new(name: 'UpdateServerResponse')
@@ -103,6 +110,8 @@ module Aws::Transfer
     CreateServerResponse.struct_class = Types::CreateServerResponse
 
     CreateUserRequest.add_member(:home_directory, Shapes::ShapeRef.new(shape: HomeDirectory, location_name: "HomeDirectory"))
+    CreateUserRequest.add_member(:home_directory_type, Shapes::ShapeRef.new(shape: HomeDirectoryType, location_name: "HomeDirectoryType"))
+    CreateUserRequest.add_member(:home_directory_mappings, Shapes::ShapeRef.new(shape: HomeDirectoryMappings, location_name: "HomeDirectoryMappings"))
     CreateUserRequest.add_member(:policy, Shapes::ShapeRef.new(shape: Policy, location_name: "Policy"))
     CreateUserRequest.add_member(:role, Shapes::ShapeRef.new(shape: Role, required: true, location_name: "Role"))
     CreateUserRequest.add_member(:server_id, Shapes::ShapeRef.new(shape: ServerId, required: true, location_name: "ServerId"))
@@ -156,6 +165,8 @@ module Aws::Transfer
 
     DescribedUser.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "Arn"))
     DescribedUser.add_member(:home_directory, Shapes::ShapeRef.new(shape: HomeDirectory, location_name: "HomeDirectory"))
+    DescribedUser.add_member(:home_directory_mappings, Shapes::ShapeRef.new(shape: HomeDirectoryMappings, location_name: "HomeDirectoryMappings"))
+    DescribedUser.add_member(:home_directory_type, Shapes::ShapeRef.new(shape: HomeDirectoryType, location_name: "HomeDirectoryType"))
     DescribedUser.add_member(:policy, Shapes::ShapeRef.new(shape: Policy, location_name: "Policy"))
     DescribedUser.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
     DescribedUser.add_member(:ssh_public_keys, Shapes::ShapeRef.new(shape: SshPublicKeys, location_name: "SshPublicKeys"))
@@ -166,6 +177,12 @@ module Aws::Transfer
     EndpointDetails.add_member(:vpc_endpoint_id, Shapes::ShapeRef.new(shape: VpcEndpointId, location_name: "VpcEndpointId"))
     EndpointDetails.struct_class = Types::EndpointDetails
 
+    HomeDirectoryMapEntry.add_member(:entry, Shapes::ShapeRef.new(shape: MapEntry, required: true, location_name: "Entry"))
+    HomeDirectoryMapEntry.add_member(:target, Shapes::ShapeRef.new(shape: MapTarget, required: true, location_name: "Target"))
+    HomeDirectoryMapEntry.struct_class = Types::HomeDirectoryMapEntry
+
+    HomeDirectoryMappings.member = Shapes::ShapeRef.new(shape: HomeDirectoryMapEntry)
+
     IdentityProviderDetails.add_member(:url, Shapes::ShapeRef.new(shape: Url, location_name: "Url"))
     IdentityProviderDetails.add_member(:invocation_role, Shapes::ShapeRef.new(shape: Role, location_name: "InvocationRole"))
     IdentityProviderDetails.struct_class = Types::IdentityProviderDetails
@@ -230,6 +247,7 @@ module Aws::Transfer
 
     ListedUser.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "Arn"))
     ListedUser.add_member(:home_directory, Shapes::ShapeRef.new(shape: HomeDirectory, location_name: "HomeDirectory"))
+    ListedUser.add_member(:home_directory_type, Shapes::ShapeRef.new(shape: HomeDirectoryType, location_name: "HomeDirectoryType"))
     ListedUser.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
     ListedUser.add_member(:ssh_public_key_count, Shapes::ShapeRef.new(shape: SshPublicKeyCount, location_name: "SshPublicKeyCount"))
     ListedUser.add_member(:user_name, Shapes::ShapeRef.new(shape: UserName, location_name: "UserName"))
@@ -286,6 +304,9 @@ module Aws::Transfer
     TestIdentityProviderResponse.add_member(:url, Shapes::ShapeRef.new(shape: Url, required: true, location_name: "Url"))
     TestIdentityProviderResponse.struct_class = Types::TestIdentityProviderResponse
 
+    ThrottlingException.add_member(:retry_after_seconds, Shapes::ShapeRef.new(shape: RetryAfterSeconds, location_name: "RetryAfterSeconds"))
+    ThrottlingException.struct_class = Types::ThrottlingException
+
     UntagResourceRequest.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, required: true, location_name: "Arn"))
     UntagResourceRequest.add_member(:tag_keys, Shapes::ShapeRef.new(shape: TagKeys, required: true, location_name: "TagKeys"))
     UntagResourceRequest.struct_class = Types::UntagResourceRequest
@@ -302,6 +323,8 @@ module Aws::Transfer
     UpdateServerResponse.struct_class = Types::UpdateServerResponse
 
     UpdateUserRequest.add_member(:home_directory, Shapes::ShapeRef.new(shape: HomeDirectory, location_name: "HomeDirectory"))
+    UpdateUserRequest.add_member(:home_directory_type, Shapes::ShapeRef.new(shape: HomeDirectoryType, location_name: "HomeDirectoryType"))
+    UpdateUserRequest.add_member(:home_directory_mappings, Shapes::ShapeRef.new(shape: HomeDirectoryMappings, location_name: "HomeDirectoryMappings"))
     UpdateUserRequest.add_member(:policy, Shapes::ShapeRef.new(shape: Policy, location_name: "Policy"))
     UpdateUserRequest.add_member(:role, Shapes::ShapeRef.new(shape: Role, location_name: "Role"))
     UpdateUserRequest.add_member(:server_id, Shapes::ShapeRef.new(shape: ServerId, required: true, location_name: "ServerId"))
@@ -379,6 +402,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:delete_user, Seahorse::Model::Operation.new.tap do |o|
@@ -428,6 +452,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceExistsException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:list_servers, Seahorse::Model::Operation.new.tap do |o|
@@ -495,6 +520,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:stop_server, Seahorse::Model::Operation.new.tap do |o|
@@ -507,6 +533,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
@@ -518,6 +545,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
       api.add_operation(:test_identity_provider, Seahorse::Model::Operation.new.tap do |o|
@@ -541,6 +569,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
       end)
 
       api.add_operation(:update_server, Seahorse::Model::Operation.new.tap do |o|
@@ -552,7 +581,9 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceExistsException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
 
       api.add_operation(:update_user, Seahorse::Model::Operation.new.tap do |o|
@@ -565,6 +596,7 @@ module Aws::Transfer
         o.errors << Shapes::ShapeRef.new(shape: InternalServiceError)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
       end)
     end
 

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

@@ -126,5 +126,21 @@ module Aws::Transfer
 
     end
 
+    class ThrottlingException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::Transfer::Types::ThrottlingException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def retry_after_seconds
+        @data[:retry_after_seconds]
+      end
+
+    end
+
   end
 end

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

@@ -52,7 +52,7 @@ module Aws::Transfer
     #   Accidentally changing a server's host key can be disruptive.
     #
     #   For more information, see
-    #   "https://docs.aws.amazon.com/transfer/latest/userguide/change-host-key"
+    #   "https://alpha-docs-aws.amazon.com/transfer/latest/userguide/configuring-servers.html#change-host-key"
     #   in the *AWS SFTP User Guide.*
     #   @return [String]
     #
@@ -112,6 +112,13 @@ module Aws::Transfer
     #
     #       {
     #         home_directory: "HomeDirectory",
+    #         home_directory_type: "PATH", # accepts PATH, LOGICAL
+    #         home_directory_mappings: [
+    #           {
+    #             entry: "MapEntry", # required
+    #             target: "MapTarget", # required
+    #           },
+    #         ],
     #         policy: "Policy",
     #         role: "Role", # required
     #         server_id: "ServerId", # required
@@ -127,9 +134,40 @@ module Aws::Transfer
     #
     # @!attribute [rw] home_directory
     #   The landing directory (folder) for a user when they log in to the
-    #   server using their SFTP client. An example is `/home/username `.
+    #   server using their SFTP client.
+    #
+    #   An example is <`your-Amazon-S3-bucket-name>/home/username`.
+    #   @return [String]
+    #
+    # @!attribute [rw] home_directory_type
+    #   The type of landing directory (folder) you want your users' home
+    #   directory to be when they log into the SFTP server. If you set it to
+    #   `PATH`, the user will see the absolute Amazon S3 bucket paths as is
+    #   in their SFTP clients. If you set it `LOGICAL`, you will need to
+    #   provide mappings in the `HomeDirectoryMappings` for how you want to
+    #   make S3 paths visible to your user.
     #   @return [String]
     #
+    # @!attribute [rw] home_directory_mappings
+    #   Logical directory mappings that specify what S3 paths and keys
+    #   should be visible to your user and how you want to make them
+    #   visible. You will need to specify the "`Entry`" and "`Target`"
+    #   pair, where `Entry` shows how the path is made visible and `Target`
+    #   is the actual S3 path. If you only specify a target, it will be
+    #   displayed as is. You will need to also make sure that your AWS IAM
+    #   Role provides access to paths in `Target`. The following is an
+    #   example.
+    #
+    #   `'[ "/bucket2/documentation", \{ "Entry":
+    #   "your-personal-report.pdf", "Target":
+    #   "/bucket3/customized-reports/$\{transfer:UserName\}.pdf" \} ]'`
+    #
+    #   In most cases, you can use this value instead of the scope down
+    #   policy to lock your user down to the designated home directory
+    #   ("chroot"). To do this, you can set `Entry` to '/' and set
+    #   `Target` to the HomeDirectory parameter value.
+    #   @return [Array<Types::HomeDirectoryMapEntry>]
+    #
     # @!attribute [rw] policy
     #   A scope-down policy for your user so you can use the same IAM role
     #   across multiple users. This policy scopes down user access to
@@ -190,6 +228,8 @@ module Aws::Transfer
     #
     class CreateUserRequest < Struct.new(
       :home_directory,
+      :home_directory_type,
+      :home_directory_mappings,
       :policy,
       :role,
       :server_id,
@@ -471,8 +511,37 @@ module Aws::Transfer
     # @!attribute [rw] home_directory
     #   This property specifies the landing directory (or folder), which is
     #   the location that files are written to or read from in an Amazon S3
-    #   bucket for the described user. An example is
-    #   `/bucket_name/home/username `.
+    #   bucket for the described user. An example is `/your s3 bucket
+    #   name/home/username `.
+    #   @return [String]
+    #
+    # @!attribute [rw] home_directory_mappings
+    #   Logical directory mappings that you specified for what S3 paths and
+    #   keys should be visible to your user and how you want to make them
+    #   visible. You will need to specify the "`Entry`" and "`Target`"
+    #   pair, where `Entry` shows how the path is made visible and `Target`
+    #   is the actual S3 path. If you only specify a target, it will be
+    #   displayed as is. You will need to also make sure that your AWS IAM
+    #   Role provides access to paths in `Target`.
+    #
+    #   In most cases, you can use this value instead of the scope down
+    #   policy to lock your user down to the designated home directory
+    #   ("chroot"). To do this, you can set `Entry` to '/' and set
+    #   `Target` to the HomeDirectory parameter value.
+    #
+    #   In most cases, you can use this value instead of the scope down
+    #   policy to lock your user down to the designated home directory
+    #   ("chroot"). To do this, you can set `Entry` to '/' and set
+    #   `Target` to the HomeDirectory parameter value.
+    #   @return [Array<Types::HomeDirectoryMapEntry>]
+    #
+    # @!attribute [rw] home_directory_type
+    #   The type of landing directory (folder) you mapped for your users'
+    #   to see when they log into the SFTP server. If you set it to `PATH`,
+    #   the user will see the absolute Amazon S3 bucket paths as is in their
+    #   SFTP clients. If you set it `LOGICAL`, you will need to provide
+    #   mappings in the `HomeDirectoryMappings` for how you want to make S3
+    #   paths visible to your user.
     #   @return [String]
     #
     # @!attribute [rw] policy
@@ -512,6 +581,8 @@ module Aws::Transfer
     class DescribedUser < Struct.new(
       :arn,
       :home_directory,
+      :home_directory_mappings,
+      :home_directory_type,
       :policy,
       :role,
       :ssh_public_keys,
@@ -541,6 +612,33 @@ module Aws::Transfer
       include Aws::Structure
     end
 
+    # Represents an object that contains entries and a targets for
+    # `HomeDirectoryMappings`.
+    #
+    # @note When making an API call, you may pass HomeDirectoryMapEntry
+    #   data as a hash:
+    #
+    #       {
+    #         entry: "MapEntry", # required
+    #         target: "MapTarget", # required
+    #       }
+    #
+    # @!attribute [rw] entry
+    #   Represents an entry and a target for `HomeDirectoryMappings`.
+    #   @return [String]
+    #
+    # @!attribute [rw] target
+    #   Represents the map target that is used in a `HomeDirectorymapEntry`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/HomeDirectoryMapEntry AWS API Documentation
+    #
+    class HomeDirectoryMapEntry < Struct.new(
+      :entry,
+      :target)
+      include Aws::Structure
+    end
+
     # Returns information related to the type of user authentication that is
     # in use for a server's users. A server can have only one method of
     # authentication.
@@ -908,6 +1006,15 @@ module Aws::Transfer
     #   from an Amazon S3 bucket for the user you specify by their ARN.
     #   @return [String]
     #
+    # @!attribute [rw] home_directory_type
+    #   The type of landing directory (folder) you mapped for your users'
+    #   home directory. If you set it to `PATH`, the user will see the
+    #   absolute Amazon S3 bucket paths as is in their SFTP clients. If you
+    #   set it `LOGICAL`, you will need to provide mappings in the
+    #   `HomeDirectoryMappings` for how you want to make S3 paths visible to
+    #   your user.
+    #   @return [String]
+    #
     # @!attribute [rw] role
     #   The role in use by this user. A *role* is an AWS Identity and Access
     #   Management (IAM) entity that, in this case, allows the SFTP server
@@ -931,6 +1038,7 @@ module Aws::Transfer
     class ListedUser < Struct.new(
       :arn,
       :home_directory,
+      :home_directory_type,
       :role,
       :ssh_public_key_count,
       :user_name)
@@ -1179,6 +1287,20 @@ module Aws::Transfer
       include Aws::Structure
     end
 
+    # The request was denied due to request throttling.
+    #
+    # HTTP Status Code: 400
+    #
+    # @!attribute [rw] retry_after_seconds
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ThrottlingException AWS API Documentation
+    #
+    class ThrottlingException < Struct.new(
+      :retry_after_seconds)
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass UntagResourceRequest
     #   data as a hash:
     #
@@ -1296,6 +1418,13 @@ module Aws::Transfer
     #
     #       {
     #         home_directory: "HomeDirectory",
+    #         home_directory_type: "PATH", # accepts PATH, LOGICAL
+    #         home_directory_mappings: [
+    #           {
+    #             entry: "MapEntry", # required
+    #             target: "MapTarget", # required
+    #           },
+    #         ],
     #         policy: "Policy",
     #         role: "Role",
     #         server_id: "ServerId", # required
@@ -1304,10 +1433,40 @@ module Aws::Transfer
     #
     # @!attribute [rw] home_directory
     #   A parameter that specifies the landing directory (folder) for a user
-    #   when they log in to the server using their client. An example is
-    #   `/home/username `.
+    #   when they log in to the server using their client.
+    #
+    #   An example is `<your-Amazon-S3-bucket-name>/home/username`.
     #   @return [String]
     #
+    # @!attribute [rw] home_directory_type
+    #   The type of landing directory (folder) you want your users' home
+    #   directory to be when they log into the SFTP serve. If you set it to
+    #   `PATH`, the user will see the absolute Amazon S3 bucket paths as is
+    #   in their SFTP clients. If you set it `LOGICAL`, you will need to
+    #   provide mappings in the `HomeDirectoryMappings` for how you want to
+    #   make S3 paths visible to your user.
+    #   @return [String]
+    #
+    # @!attribute [rw] home_directory_mappings
+    #   Logical directory mappings that specify what S3 paths and keys
+    #   should be visible to your user and how you want to make them
+    #   visible. You will need to specify the "`Entry`" and "`Target`"
+    #   pair, where `Entry` shows how the path is made visible and `Target`
+    #   is the actual S3 path. If you only specify a target, it will be
+    #   displayed as is. You will need to also make sure that your AWS IAM
+    #   Role provides access to paths in `Target`. The following is an
+    #   example.
+    #
+    #   `'[ "/bucket2/documentation", \{ "Entry":
+    #   "your-personal-report.pdf", "Target":
+    #   "/bucket3/customized-reports/$\{transfer:UserName\}.pdf" \} ]'`
+    #
+    #   In most cases, you can use this value instead of the scope down
+    #   policy to lock your user down to the designated home directory
+    #   ("chroot"). To do this, you can set `Entry` to '/' and set
+    #   `Target` to the HomeDirectory parameter value.
+    #   @return [Array<Types::HomeDirectoryMapEntry>]
+    #
     # @!attribute [rw] policy
     #   Allows you to supply a scope-down policy for your user so you can
     #   use the same AWS Identity and Access Management (IAM) role across
@@ -1360,6 +1519,8 @@ module Aws::Transfer
     #
     class UpdateUserRequest < Struct.new(
       :home_directory,
+      :home_directory_type,
+      :home_directory_mappings,
       :policy,
       :role,
       :server_id,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-transfer
 version: !ruby/object:Gem::Version
-  version: 1.14.0
+  version: 1.15.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-23 00:00:00.000000000 Z
+date: 2019-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core