GLOBUS TIMER CREATE TRANSFER

NAME

globus timer create transfer - Create a recurring transfer timer.

SYNOPSIS

globus timer create transfer [OPTIONS] SOURCE_ENDPOINT_ID[:SOURCE_PATH] DEST_ENDPOINT_ID[:DEST_PATH]

DESCRIPTION

Create a timer which will run a transfer on a recurring schedule according to the parameters provided.

For example, to create a timer which runs a Transfer from /foo/ on one endpoint to /bar/ on another endpoint every day, with no end condition:

globus timer create transfer --interval 1d --recursive $ep1:/foo/ $ep2:/bar/

Batch Input

If you use SOURCE_PATH and DEST_PATH without the --batch flag, you will submit a single-file or single-directory timer.

Using --batch, globus timer create transfer can create a timer which transfers multiple specified files or directories. Each line of --batch input is treated as a separate file or directory transfer to include in the timer.

Lines are of the form [--recursive] [--external-checksum TEXT] SOURCE_PATH DEST_PATH

Each line of the batch input is parsed like it would be at the command line. This means that if SOURCE_PATH or DEST_PATH contain spaces, the path should be wrapped in quotes, or the spaces should be escaped using a backslash character ("\").

Similarly, empty lines are skipped, and comments beginning with "#" are allowed.

If you use --batch and supply a SOURCE_PATH and/or DEST_PATH via the commandline, these paths will be used as dir prefixes to any paths read from the --batch input.

OPTIONS

--batch FILENAME

Accept a batch of source/dest path pairs from a file. Use - to read from stdin.

Uses SOURCE_ENDPOINT_ID and DEST_ENDPOINT_ID as passed on the commandline.

See documentation on "Batch Input" for more information.

--sync-level [exists|size|mtime|checksum]

Specify that only new or modified files should be transferred, depending on which setting is provided.

-r, --recursive / --no-recursive

Use --recursive to flag that the paths are directories and should be transferred recursively. Use --no-recursive to flag that the paths are files that must not be transferred recursively. Omit these options to use path type auto-detection.

--encrypt-data

Encrypt data sent through the network.

--verify-checksum / --no-verify-checksum

Verify checksum after transfer. [default: verify-checksum]

--preserve-timestamp

Preserve file modification times. Directory modification times are not preserved.

--skip-source-errors

Skip over source paths that hit permission denied or file not found errors during the transfer.

--fail-on-quota-errors

Cause the task to fail if any quota exceeded errors are hit during the transfer.

--notify {on,off,succeeded,failed,inactive}

Comma separated list of task events which notify by email. 'on' and 'off' may be used to enable or disable notifications for all event types. Otherwise, use 'succeeded', 'failed', or 'inactive'.

--start [%Y-%m-%d|%Y-%m-%d %H:%M:%S|%Y-%m-%d %H:%M:%S%z|%Y-%m-%dT%H:%M:%S|%Y-%m-%dT%H:%M:%S%z|%Y-%m-%dT%H:%M:%S.%f%z]

Start time for the timer. Defaults to current time.

--interval TIMEDELTA

Interval at which the timer should run. Expressed in weeks, days, hours, minutes, and seconds. Use 'w', 'd', 'h', 'm', and 's' as suffixes to specify. e.g. '1h30m', '500s', '10d'

--name TEXT

A name for the timer.

--label TEXT

A label for the Transfer tasks submitted by the timer.

--stop-after-date [%Y-%m-%d|%Y-%m-%d %H:%M:%S|%Y-%m-%d %H:%M:%S%z|%Y-%m-%dT%H:%M:%S|%Y-%m-%dT%H:%M:%S%z|%Y-%m-%dT%H:%M:%S.%f%z]

Stop running the transfer after this date.

--stop-after-runs INTEGER RANGE

Stop running the transfer after this number of runs have happened. [x>=1]

--delete

Delete any files in the destination directory not contained in the source. This results in "directory mirroring." Only valid on recursive transfers.

-v, --verbose

Control level of output, make it more verbose.

--quiet

Suppress non-essential output. This is higher precedence than --verbose.

-h, --help

Show this message and exit.

-F, --format [unix|json|text]

Output format for stdout. Defaults to text.

--jmespath, --jq TEXT

A JMESPath expression to apply to json output. Forces the format to be json processed by this expression.

--map-http-status TEXT

Map HTTP statuses to any of these exit codes: 0,1,50-99. e.g. "404=50,403=51"

EXIT STATUS

0 on success.

1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.

2 if the command was used improperly.

3 if the command was used on the wrong type of object, e.g. a collection command used on an endpoint.

4 if the command has authentication or authorization requirements which were not met, as in ConsentRequired errors or missing logins.