FTP Directory Modified
The FTP Directory Modified trigger monitors activity on an FTP server, and sends JSON messages about that activity, which can include adding, changing, and removing files.
Note: Messages about changed files are based on file size. Therefore, if the size of a file after it is overwritten is the same as the initial size, a message may not be sent.
Parameters
Note: See also Working with Parameters in Automations Workflows.
Tip: To test that your parameters work as expected, click Validate.
- Host: The FTP host name. For example,
ftpserver.com
. - Port: The FTP port number. The default for unencrypted connections is 21.
- Username: The FTP user name for authentication.
- Password: The FTP user password for authentication.
- Encryption: The encryption protocol, depending on the FTP server connection requirements. Options are None, FTPS and FTPES.
- Verify SSL Certificate: If Yes, the connection to the specified host is verified with a valid, signed SSL certificate. If No, the connection is not verified with an SSL certificate. This option is not secure and not recommended unless absolutely necessary, such as using a self-signed certificate.
- Connection Type: The FTP connection mode. Passive Mode requires your FTP server to create connections using port numbers greater than 1023. Active Mode uses only ports 20 and 21 on the FTP server.
- Path to Watch: Specify a location on the FTP server to watch for changes, using forward slashes. For example,
/this_directory
. - Watch Subdirectories: To watch activity in the specified Path to Watch and all subdirectories, select Yes. To watch activity only in the specified Path to Watch and not in its subdirectories, select No.
- Poll Interval: Specify how often to poll the FTP server, in minutes.
- Filter: By default, all actions on the specified directory are monitored, including adding (CREATE), changing (MODIFY), and deleting (DELETE) files (and folders, if applicable). To monitor only one or two of these actions, click the "x" beside the action you do not want to monitor to remove it. To add an action after removing it, click inside the dropbox and select it.
Note: Messages may be delayed if Watch Subdirectories is Yes, and includes a large number of subdirectories. The scale of the delay depends on the number of subdirectories, the FTP server type, and where the FTP connection originates.
Note: Changes to existing files require an additional poll interval, after the upload completes, before a message is sent.
Output Keys
See Also
Key | Description |
---|---|
file.event | File action (Create/Modify/Delete) |
file.path | File path |
ftp.user | User |
ftp.host | Host |
source | Event type |
time | Event time |