download

This task downloads files from the device to the local file system.

The task downloads all files that matched the provided regexp pattern. Unless the flatten attribute is set to true, the task will recreate the remote directories containing the files locally. Empty directories will not be created.

Attributes/Options

Name

Description

Required

cleanToDir

If set to true, remove all files and subdirectories in toDir prior to downloading the files.

Defaults to false.

No

createHostDir

If set to true, create subdirectory under ‘toDir’ with the name matching DataPower host name. If the files are downloaded from the “default” domain, the domain subdirectories will be created automatically. This is convenient when download runs against multiple DataPower instances. Defaults to false.

No

downloadIfChanged

If set to true, download only the files that are newer on DataPower than the ones that exist locally.

Defaults to false.

No

dryRun

If set to true, print the files that will be downloaded without downloading anything.

Defaults to false.

No

flatten

If set to true, download all files into toDir instead of creating the directory tree replicating remote directory structure.

Defaults to false.

No

include

Regular expression pattern defining what files to download.

The match is done against the entire path of a file, including the filesystem (e.g., local:/.*). Note that the filesystem is separated by a single slash, i.e., the pattern local://.*xsd will not match anything.

Yes

matchRequired

If set to true, fail if no files matched the include pattern.

Defaults to true.

No

preserveTimestamp

If set to true, preserve the modified timestamp of the downloaded file.

Defaults to true.

No

toDir

Local directory where to save the files.

Yes

Examples

Download all “*.xsd” files from “local:/”:

dpbuddy download -include "local:/.*xsd" -toDir download
dpbuddy download -domain default -include "logtemp:/.*-log" -toDir logs -downloadIfChanged
<dp:download include="local:/.*xsd" toDir="download"/>

You can find more examples under samples in your distribution or online.