Expand description
Data structures used by operation inputs/outputs.
Modules§
Structs§
- As2Connector
Config Contains the details for an AS2 connector object. The connector object is used for AS2 outbound processes, to connect the Transfer Family customer with the trading partner.
- Connector
File Transfer Result A structure that contains the details for files transferred using an SFTP connector, during a single transfer.
- Copy
Step Details Each step type has its own
StepDetails
structure.- Custom
Directories Type Contains Amazon S3 locations for storing specific types of AS2 message files.
- Custom
Step Details Each step type has its own
StepDetails
structure.- Decrypt
Step Details Each step type has its own
StepDetails
structure.- Delete
Step Details The name of the step, used to identify the delete step.
- Described
Access Describes the properties of the access that was specified.
- Described
Agreement Describes the properties of an agreement.
- Described
Certificate Describes the properties of a certificate.
- Described
Connector Describes the parameters for the connector, as identified by the
ConnectorId
.- Described
Execution The details for an execution object.
- Described
Host Key The details for a server host key.
- Described
Identity Center Config A structure that contains the details of the IAM Identity Center used for your web app. Returned during a call to
DescribeWebApp
.- Described
Profile The details for a local or partner AS2 profile.
- Described
Security Policy Describes the properties of a security policy that you specify. For more information about security policies, see Working with security policies for servers or Working with security policies for SFTP connectors.
- Described
Server Describes the properties of a file transfer protocol-enabled server that was specified.
- Described
User Describes the properties of a user that was specified.
- Described
WebApp A structure that describes the parameters for the web app, as identified by the
WebAppId
.- Described
WebApp Customization A structure that contains the customization fields for the web app. You can provide a title, logo, and icon to customize the appearance of your web app.
- Described
Workflow Describes the properties of the specified workflow
- EfsFile
Location Specifies the details for the file location for the file that's being used in the workflow. Only applicable if you are using Amazon Elastic File Systems (Amazon EFS) for storage.
- Endpoint
Details The virtual private cloud (VPC) endpoint settings that are configured for your file transfer protocol-enabled server. With a VPC endpoint, you can restrict access to your server and resources only within your VPC. To control incoming internet traffic, invoke the
UpdateServer
API and attach an Elastic IP address to your server's endpoint.After May 19, 2021, you won't be able to create a server using
EndpointType=VPC_ENDPOINT
in your Amazon Web Services account if your account hasn't already done so before May 19, 2021. If you have already created servers withEndpointType=VPC_ENDPOINT
in your Amazon Web Services account on or before May 19, 2021, you will not be affected. After this date, useEndpointType
=VPC
.For more information, see https://docs.aws.amazon.com/transfer/latest/userguide/create-server-in-vpc.html#deprecate-vpc-endpoint.
It is recommended that you use
VPC
as theEndpointType
. With this endpoint type, you have the option to directly associate up to three Elastic IPv4 addresses (BYO IP included) with your server's endpoint and use VPC security groups to restrict traffic by the client's public IP address. This is not possible withEndpointType
set toVPC_ENDPOINT
.- Execution
Error Specifies the error message and type, for an error that occurs during the execution of the workflow.
- Execution
Results Specifies the steps in the workflow, as well as the steps to execute in case of any errors during workflow execution.
- Execution
Step Result Specifies the following details for the step: error (if any), outputs (if any), and the step type.
- File
Location Specifies the Amazon S3 or EFS file details to be used in the step.
- Home
Directory MapEntry Represents an object that contains entries and targets for
HomeDirectoryMappings
.The following is an
Entry
andTarget
pair example forchroot
.\[ { "Entry": "/", "Target": "/bucket_name/home/mydirectory" } \]
- Identity
Center Config A structure that describes the values to use for the IAM Identity Center settings when you create or update a web app.
- Identity
Provider Details Returns information related to the type of user authentication that is in use for a file transfer protocol-enabled server's users. A server can have only one method of authentication.
- Input
File Location Specifies the location for the file that's being processed.
- Listed
Access Lists the properties for one or more specified associated accesses.
- Listed
Agreement Describes the properties of an agreement.
- Listed
Certificate Describes the properties of a certificate.
- Listed
Connector Returns details of the connector that is specified.
- Listed
Execution Returns properties of the execution that is specified.
- Listed
Host Key Returns properties of the host key that's specified.
- Listed
Profile Returns the properties of the profile that was specified.
- Listed
Server Returns properties of a file transfer protocol-enabled server that was specified.
- Listed
User Returns properties of the user that you specify.
- Listed
WebApp a structure that contains details for the web app.
- Listed
Workflow Contains the identifier, text description, and Amazon Resource Name (ARN) for the workflow.
- Logging
Configuration Consists of the logging role and the log group name.
- Posix
Profile The full POSIX identity, including user ID (
Uid
), group ID (Gid
), and any secondary groups IDs (SecondaryGids
), that controls your users' access to your Amazon EFS file systems. The POSIX permissions that are set on files and directories in your file system determine the level of access your users get when transferring files into and out of your Amazon EFS file systems.- Protocol
Details The protocol settings that are configured for your server.
- S3File
Location Specifies the details for the file location for the file that's being used in the workflow. Only applicable if you are using S3 storage.
- S3Input
File Location Specifies the customer input Amazon S3 file location. If it is used inside
copyStepDetails.DestinationFileLocation
, it should be the S3 copy destination.You need to provide the bucket and key. The key can represent either a path or a file. This is determined by whether or not you end the key value with the forward slash (/) character. If the final character is "/", then your file is copied to the folder, and its name does not change. If, rather, the final character is alphanumeric, your uploaded file is renamed to the path value. In this case, if a file with that name already exists, it is overwritten.
For example, if your path is
shared-files/bob/
, your uploaded files are copied to theshared-files/bob/
, folder. If your path isshared-files/today
, each uploaded file is copied to theshared-files
folder and namedtoday
: each upload overwrites the previous version of the bob file.- S3Storage
Options The Amazon S3 storage options that are configured for your server.
- S3Tag
Specifies the key-value pair that are assigned to a file during the execution of a Tagging step.
- Service
Metadata A container object for the session details that are associated with a workflow.
- Sftp
Connector Config Contains the details for an SFTP connector object. The connector object is used for transferring files to and from a partner's SFTP server.
- Sftp
Connector Connection Details Contains the details for an SFTP connector connection.
- SshPublic
Key Provides information about the public Secure Shell (SSH) key that is associated with a Transfer Family user for the specific file transfer protocol-enabled server (as identified by
ServerId
). The information returned includes the date the key was imported, the public key contents, and the public key ID. A user can store more than one SSH public key associated with their user name on a specific server.- Tag
Creates a key-value pair for a specific resource. Tags are metadata that you can use to search for and group a resource for various purposes. You can apply tags to servers, users, and roles. A tag key can take more than one value. For example, to group servers for accounting purposes, you might create a tag called
Group
and assign the valuesResearch
andAccounting
to that group.- TagStep
Details Each step type has its own
StepDetails
structure.The key/value pairs used to tag a file during the execution of a workflow step.
- Update
WebApp Identity Center Config A structure that describes the values to use for the IAM Identity Center settings when you update a web app.
- User
Details Specifies the user name, server ID, and session ID for a workflow.
- Workflow
Detail Specifies the workflow ID for the workflow to assign and the execution role that's used for executing the workflow.
In addition to a workflow to execute when a file is uploaded completely,
WorkflowDetails
can also contain a workflow ID (and execution role) for a workflow to execute on partial upload. A partial upload occurs when the server session disconnects while the file is still being uploaded.- Workflow
Details Container for the
WorkflowDetail
data type. It is used by actions that trigger a workflow to begin execution.- Workflow
Step The basic building block of a workflow.
Enums§
- Agreement
Status Type - When writing a match expression against
AgreementStatusType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - As2Transport
- When writing a match expression against
As2Transport
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Certificate
Status Type - When writing a match expression against
CertificateStatusType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Certificate
Type - When writing a match expression against
CertificateType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Certificate
Usage Type - When writing a match expression against
CertificateUsageType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Compression
Enum - When writing a match expression against
CompressionEnum
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Custom
Step Status - When writing a match expression against
CustomStepStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Described
WebApp Identity Provider Details Returns a structure that contains the identity provider details for your web app.
- Directory
Listing Optimization - When writing a match expression against
DirectoryListingOptimization
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Domain
- When writing a match expression against
Domain
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Encryption
Alg - When writing a match expression against
EncryptionAlg
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Encryption
Type - When writing a match expression against
EncryptionType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Endpoint
Type - When writing a match expression against
EndpointType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Enforce
Message Signing Type - When writing a match expression against
EnforceMessageSigningType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Execution
Error Type - When writing a match expression against
ExecutionErrorType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Execution
Status - When writing a match expression against
ExecutionStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Home
Directory Type - When writing a match expression against
HomeDirectoryType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Identity
Provider Type - When writing a match expression against
IdentityProviderType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - IpAddress
Type - When writing a match expression against
IpAddressType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - MapType
- When writing a match expression against
MapType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - MdnResponse
- When writing a match expression against
MdnResponse
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - MdnSigning
Alg - When writing a match expression against
MdnSigningAlg
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Overwrite
Existing - When writing a match expression against
OverwriteExisting
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Preserve
Content Type - When writing a match expression against
PreserveContentType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Preserve
Filename Type - When writing a match expression against
PreserveFilenameType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Profile
Type - When writing a match expression against
ProfileType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Protocol
- When writing a match expression against
Protocol
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Security
Policy Protocol - When writing a match expression against
SecurityPolicyProtocol
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Security
Policy Resource Type - When writing a match expression against
SecurityPolicyResourceType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - SetStat
Option - When writing a match expression against
SetStatOption
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Sftp
Authentication Methods - When writing a match expression against
SftpAuthenticationMethods
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Signing
Alg - When writing a match expression against
SigningAlg
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - State
- When writing a match expression against
State
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - TlsSession
Resumption Mode - When writing a match expression against
TlsSessionResumptionMode
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Transfer
Table Status - When writing a match expression against
TransferTableStatus
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - Update
WebApp Identity Provider Details A union that contains the
UpdateWebAppIdentityCenterConfig
object.- WebApp
Endpoint Policy - When writing a match expression against
WebAppEndpointPolicy
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature. - WebApp
Identity Provider Details A union that contains the
IdentityCenterConfig
object.- WebApp
Units Contains an integer value that represents the value for number of concurrent connections or the user sessions on your web app.
- Workflow
Step Type - When writing a match expression against
WorkflowStepType
, it is important to ensure your code is forward-compatible. That is, if a match arm handles a case for a feature that is supported by the service but has not been represented as an enum variant in a current version of SDK, your code should continue to work when you upgrade SDK to a future version in which the enum does include a variant for that feature.