Moves a file or files within an HDFS cluster.

Use Case

This action can be used when a file or files need to be moved to a new location in an HDFS cluster, often required when archiving files.


sourcePath: The full HDFS path of the file or directory that is to be moved. In the case of a directory, if fileRegex is set, then only files in the source directory matching the wildcard regex will be moved. Otherwise, all files in the directory will be moved. For example: hdfs://hostname/tmp.

destPath: The valid, full HDFS destination path in the same cluster where the file or files are to be moved. If a directory is specified with a file sourcePath, the file will be put into that directory. If sourcePath is a directory, it is assumed that destPath is also a directory. HDFSAction will not catch this inconsistency.

fileRegex: Wildcard regular expression to filter the files in the source directory that will be moved.

continueOnError: Indicates if the pipeline should continue if the move process fails. If all files are not successfully moved, the action will not return the files already moved to their original locations.


This example moves a file from /source/path to /dest/path:

    "name": "HDFSMove",
    "plugin": {
        "name": "HDFSMove",
        "type": "action",
        "artifact": {
            "name": "core-plugins",
            "version": "1.4.0-SNAPSHOT",
            "scope": "SYSTEM"
        "properties": {
            "sourcePath": "hdfs://example.com:8020/source/path",
            "destPath": "hdfs://example.com:8020/dest/path",
            "fileRegex": ".*\.txt",
            "continueOnError": "false"

  • CDAP Pipelines Plugin Type: action
  • CDAP Pipelines Version: 1.8.5