Writes the contents of a FlowFile to the local file system
put, local, copy, archive, files, filesystem
In the list below, the names of required properties appear in bold. Any other properties (not in bold) are considered optional. The table also indicates any default values, and whether a property supports the NiFi Expression Language.
| Display Name | API Name | Default Value | Allowable Values | Description |
|---|---|---|---|---|
| Directory | Directory | The directory to which files should be written. You may use expression language such as /aa/bb/${path} Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) | ||
| Conflict Resolution Strategy | Conflict Resolution Strategy | fail |
| Indicates what should happen when a file with the same name already exists in the output directory |
| Create Missing Directories | Create Missing Directories | true |
| If true, then missing destination directories will be created. If false, flowfiles are penalized and sent to failure. |
| Maximum File Count | Maximum File Count | Specifies the maximum number of files that can exist in the output directory | ||
| Last Modified Time | Last Modified Time | Sets the lastModifiedTime on the output file to the value of this attribute. Format must be yyyy-MM-dd'T'HH:mm:ssZ. You may also use expression language such as ${file.lastModifiedTime}. Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) | ||
| Permissions | Permissions | Sets the permissions on the output file to the value of this attribute. Format must be either UNIX rwxrwxrwx with a - in place of denied permissions (e.g. rw-r--r--) or an octal number (e.g. 644). You may also use expression language such as ${file.permissions}. Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) | ||
| Owner | Owner | Sets the owner on the output file to the value of this attribute. You may also use expression language such as ${file.owner}. Note on many operating systems Nifi must be running as a super-user to have the permissions to set the file owner. Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) | ||
| Group | Group | Sets the group on the output file to the value of this attribute. You may also use expression language such as ${file.group}. Supports Expression Language: true (will be evaluated using flow file attributes and variable registry) |
| Name | Description |
|---|---|
| success | Files that have been successfully written to the output directory are transferred to this relationship |
| failure | Files that could not be written to the output directory for some reason are transferred to this relationship |
| Name | Description |
|---|---|
| filename | The filename to use when writing the FlowFile to disk. |
| Required Permission | Explanation |
|---|---|
| write filesystem | Provides operator the ability to write to any file that NiFi has access to. |