EndpointDetails endpointDetails
The virtual private cloud (VPC) endpoint settings that you want to configure for your SFTP server.
String endpointType
The type of VPC endpoint that you want your SFTP server connect to. If you connect to a VPC endpoint, your SFTP server isn't accessible over the public internet.
String hostKey
The RSA private key as generated by ssh-keygen -N "" -f my-new-server-key
command.
If you aren't planning to migrate existing users from an existing SFTP server to a new AWS SFTP server, don't update the host key. Accidentally changing a server's host key can be disruptive. For more information, see change-host-key in the AWS SFTP User Guide.
IdentityProviderDetails identityProviderDetails
An array containing all of the information required to call a customer-supplied authentication API. This
parameter is not required when the IdentityProviderType
value of server that is created uses the
SERVICE_MANAGED
authentication method.
String identityProviderType
The mode of authentication enabled for this service. The default value is SERVICE_MANAGED
, which
allows you to store and access SFTP user credentials within the service. An IdentityProviderType
value of API_GATEWAY
indicates that user authentication requires a call to an API Gateway endpoint
URL provided by you to integrate an identity provider of your choice.
String loggingRole
A value that allows the service to write your SFTP users' activity to your Amazon CloudWatch logs for monitoring and auditing purposes.
List<E> tags
Key-value pairs that can be used to group and search for servers.
String serverId
The service-assigned ID of the SFTP server that is created.
String homeDirectory
The landing directory (folder) for a user when they log in to the server using their SFTP client. An example is
/home/username
.
String 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 portions of their Amazon S3 bucket. Variables you can use inside this policy include
${Transfer:UserName}
, ${Transfer:HomeDirectory}
, and
${Transfer:HomeBucket}
.
String role
The IAM role that controls your user's access to your Amazon S3 bucket. The policies attached to this role will determine the level of access you want to provide your users when transferring files into and out of your Amazon S3 bucket or buckets. The IAM role should also contain a trust relationship that allows the SFTP server to access your resources when servicing your SFTP user's transfer requests.
String serverId
A system-assigned unique identifier for an SFTP server instance. This is the specific SFTP server that you added your user to.
String sshPublicKeyBody
The public portion of the Secure Shall (SSH) key used to authenticate the user to the SFTP server.
List<E> tags
Key-value pairs that can be used to group and search for users. Tags are metadata attached to users for any purpose.
String userName
A unique string that identifies a user and is associated with a server as specified by the ServerId
.
This user name must be a minimum of 3 and a maximum of 32 characters long. The following are valid characters:
a-z, A-Z, 0-9, underscore, and hyphen. The user name can't start with a hyphen.
String serverId
A unique system-assigned identifier for an SFTP server instance.
String serverId
A system-assigned unique identifier for a Secure File Transfer Protocol (SFTP) server instance that has the user assigned to it.
String sshPublicKeyId
A unique identifier used to reference your user's specific SSH key.
String userName
A unique string that identifies a user whose public key is being deleted.
String arn
Specifies the unique Amazon Resource Name (ARN) for the server to be described.
EndpointDetails endpointDetails
The virtual private cloud (VPC) endpoint settings that you configured for your SFTP server.
String endpointType
The type of endpoint that your SFTP server is connected to. If your SFTP server is connected to a VPC endpoint, your server isn't accessible over the public internet.
String hostKeyFingerprint
This value contains the Message-Digest Algorithm (MD5) hash of the server's host key. This value is equivalent to
the output of ssh-keygen -l -E md5 -f my-new-server-key
command.
IdentityProviderDetails identityProviderDetails
Specifies information to call a customer-supplied authentication API. This field is not populated when the
IdentityProviderType
of the server is SERVICE_MANAGED
>.
String identityProviderType
This property defines the mode of authentication method enabled for this service. A value of
SERVICE_MANAGED
, means that you are using this Server to store and access SFTP user credentials
within the service. A value of API_GATEWAY
indicates that you have integrated an API Gateway
endpoint that will be invoked for authenticating your user into the service.
String loggingRole
This property is an AWS Identity and Access Management (IAM) entity that allows the server to turn on Amazon CloudWatch logging for Amazon S3 events. When set, user activity can be view in your CloudWatch logs.
String serverId
This property is a unique system assigned identifier for the SFTP server that you instantiate.
String state
The condition of the SFTP server for the server that was described. A value of ONLINE
indicates that
the server can accept jobs and transfer files. A State
value of OFFLINE
means that the
server cannot perform file transfer operations.
The states of STARTING
and STOPPING
indicated that the server is in an intermediate
state, either not fully able to respond, or not fully offline. The values of START_FAILED
or
STOP_FAILED
can indicate an error condition.
List<E> tags
This property contains the key-value pairs that you can use to search for and group servers that were assigned to the server that was described.
Integer userCount
The number of users that are assigned to the SFTP server you specified with the ServerId
.
String arn
This property contains the unique Amazon Resource Name (ARN) for the user that was requested to be described.
String homeDirectory
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 would be:
/bucket_name/home/username
.
String policy
Specifies the name of the policy in use for the described user.
String role
This property specifies the IAM role that controls your user's access to your Amazon S3 bucket. The policies attached to this role will determine the level of access you want to provide your users when transferring files into and out of your Amazon S3 bucket or buckets. The IAM role should also contain a trust relationship that allows the SFTP server to access your resources when servicing your SFTP user's transfer requests.
List<E> sshPublicKeys
This property contains the public key portion of the Secure Shell (SSH) keys stored for the described user.
List<E> tags
This property contains the key-value pairs for the user requested. Tag can be used to search for and group users for a variety of purposes.
String userName
This property is the name of the user that was requested to be described. User names are used for authentication purposes. This is the string that will be used by your user when they log in to your SFTP server.
String serverId
A system-assigned unique identifier for an SFTP server.
DescribedServer server
An array containing the properties of the server with the ServerID
you specified.
String serverId
A system-assigned unique identifier for an SFTP server that has this user assigned.
DescribedUser user
An array containing the properties of the user account for the ServerID
value that you specified.
String vpcEndpointId
The ID of the VPC endpoint.
String arn
The unique Amazon Resource Name (ARN) for the server to be listed.
String identityProviderType
The authentication method used to validate a user for the server that was specified. listed. This can include
Secure Shell (SSH), user name and password combinations, or your own custom authentication method. Valid values
include SERVICE_MANAGED
or API_GATEWAY
.
String endpointType
The type of VPC endpoint that your SFTP server is connected to. If your SFTP server is connected to a VPC endpoint, your server isn't accessible over the public internet.
String loggingRole
The AWS Identity and Access Management entity that allows the server to turn on Amazon CloudWatch logging.
String serverId
This value is the unique system assigned identifier for the SFTP servers that were listed.
String state
This property describes the condition of the SFTP server for the server that was described. A value of
ONLINE
> indicates that the server can accept jobs and transfer files. A State
value
of OFFLINE
means that the server cannot perform file transfer operations.
The states of STARTING
and STOPPING
indicated that the server is in an intermediate
state, either not fully able to respond, or not fully offline. The values of START_FAILED
or
STOP_FAILED
can indicate an error condition.
Integer userCount
This property is a numeric value that indicates the number of users that are assigned to the SFTP server you
specified with the ServerId
.
String arn
This property is the unique Amazon Resource Name (ARN) for the user that you wish to learn about.
String homeDirectory
This value specifies the location that files are written to or read from an Amazon S3 bucket for the user you specify by their ARN.
String 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 to act on a user's behalf. It allows the server to inherit the trust relationship that enables that user to perform file operations to their Amazon S3 bucket.
Integer sshPublicKeyCount
This value is the number of SSH public keys stored for the user you specified.
String userName
The name of the user whose ARN was specified. User names are used for authentication purposes.
Integer maxResults
Specifies the number of servers to return as a response to the ListServers
query.
String nextToken
When additional results are obtained from the ListServers command, a NextToken
parameter is returned
in the output. You can then pass the NextToken
parameter in a subsequent command to continue listing
additional servers.
String nextToken
When you can get additional results from the ListServers
operation, a NextToken
parameter is returned in the output. In a following command, you can pass in the NextToken
parameter
to continue listing additional servers.
List<E> servers
An array of servers that were listed.
String arn
Requests the tags associated with a particular Amazon Resource Name (ARN). An ARN is an identifier for a specific AWS resource, such as a server, user, or role.
Integer maxResults
Specifies the number of tags to return as a response to the ListTagsForResource
request.
String nextToken
When you request additional results from the ListTagsForResource
call, a NextToken
parameter is returned in the input. You can then pass in a subsequent command the NextToken
parameter to continue listing additional tags.
String arn
This value is the ARN you specified to list the tags of.
String nextToken
When you can get additional results from the ListTagsForResource
call, a NextToken
parameter is returned in the output. You can then pass in a subsequent command the NextToken
parameter to continue listing additional tags.
List<E> tags
Key-value pairs that are assigned to a resource, usually for the purpose of grouping and searching for items. Tags are metadata that you define that you can use for any purpose.
Integer maxResults
Specifies the number of users to return as a response to the ListUsers
request.
String nextToken
When you can get additional results from the ListUsers
call, a NextToken
parameter is
returned in the output. You can then pass in a subsequent command the NextToken
parameter to
continue listing additional users.
String serverId
A system-assigned unique identifier for a Secure File Transfer Protocol (SFTP) server that has users are assigned to it.
String nextToken
When you can get additional results from the ListUsers
call, a NextToken
parameter is
returned in the output. You can then pass in a subsequent command the NextToken
parameter to
continue listing additional users.
String serverId
A system-assigned unique identifier for an SFTP server that the users are assigned to.
List<E> users
Returns the user accounts and their properties for the ServerId
value that you specify.
Date dateImported
The date that the public key was added to the user account.
String sshPublicKeyBody
The content of the SSH public key as specified by the PublicKeyId
.
String sshPublicKeyId
The SshPublicKeyId
parameter contains the identifier of the public key.
String serverId
A system-assigned unique identifier for an SFTP server that you start.
String serverId
A system-assigned unique identifier for an SFTP server that you stopped.
String serverId
A system assigned identifier for a specific server. That server's user authentication method is tested with a user name and password.
String userName
This request parameter is name of the user account to be tested.
String userPassword
The password of the user account to be tested.
String arn
This is the value of the resource that will have the tag removed. An Amazon Resource Name (ARN) is an identifier for a specific AWS resource, such as a server, user, or role.
List<E> tagKeys
TagKeys are key-value pairs assigned to ARNs that can be used to group and search for resources by type. This metadata can be attached to resources for any purpose.
EndpointDetails endpointDetails
The virtual private cloud (VPC) endpoint settings that are configured for your SFTP server. With a VPC endpoint, your SFTP server isn't accessible over the public internet.
String endpointType
The type of endpoint that you want your SFTP server to connect to. You can choose to connect to the public internet or a virtual private cloud (VPC) endpoint. With a VPC endpoint, your SFTP server isn't accessible over the public internet.
String hostKey
The RSA private key as generated by ssh-keygen -N "" -f my-new-server-key
.
If you aren't planning to migrate existing users from an existing SFTP server to a new AWS SFTP server, don't update the host key. Accidentally changing a server's host key can be disruptive. For more information, see change-host-key in the AWS SFTP User Guide.
IdentityProviderDetails identityProviderDetails
This response parameter is an array containing all of the information required to call a customer's authentication API method.
String loggingRole
A value that changes the AWS Identity and Access Management (IAM) role that allows Amazon S3 events to be logged in Amazon CloudWatch, turning logging on or off.
String serverId
A system-assigned unique identifier for an SFTP server instance that the user account is assigned to.
String serverId
A system-assigned unique identifier for an SFTP server that the user account is assigned to.
String homeDirectory
The HomeDirectory parameter specifies the landing directory (folder) for a user when they log in to the server
using their client. An example would be: /home/username
.
String 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 multiple users. The policy scopes down users access to portions of your Amazon S3 bucket.
Variables you can use inside this policy include ${Transfer:UserName}
,
${Transfer:HomeDirectory}
, and ${Transfer:HomeBucket}
.
String role
The IAM role that controls your user's access to your Amazon S3 bucket. The policies attached to this role will determine the level of access you want to provide your users when transferring files into and out of your Amazon S3 bucket or buckets. The IAM role should also contain a trust relationship that allows the Secure File Transfer Protocol (SFTP) server to access your resources when servicing your SFTP user's transfer requests.
String serverId
A system-assigned unique identifier for an SFTP server instance that the user account is assigned to.
String userName
A unique string that identifies a user and is associated with a server as specified by the ServerId. This is the string that will be used by your user when they log in to your SFTP server. This user name is a minimum of 3 and a maximum of 32 characters long. The following are valid characters: a-z, A-Z, 0-9, underscore, and hyphen. The user name can't start with a hyphen.
Copyright © 2019. All rights reserved.