transfer
Submit an asynchronous file transfer task between Globus endpoints, with options for recursive directories, sync strategies, and checksum verification.
Instructions
Submit an asynchronous transfer task between Globus endpoints.
This submits a transfer task and returns immediately. The transfer runs server-side and can be monitored with task_show() or waited on with task_wait().
Args: source_endpoint: UUID of the source endpoint. source_path: Path to the file or directory on the source. dest_endpoint: UUID of the destination endpoint. dest_path: Path where data should be placed on destination. recursive: If True, transfer directories recursively. sync_level: Sync strategy for existing files: - None: Overwrite all files - 'exists': Skip if destination exists - 'size': Skip if same size - 'mtime': Skip if same size and modification time - 'checksum': Skip if same checksum label: Optional label for the transfer task. verify_checksum: If True, verify checksums after transfer. preserve_timestamp: If True, preserve modification times. encrypt_data: If True, encrypt data in transit.
Returns: Dict with 'task_id', 'submission_id', 'message', and other details. Use the 'task_id' with task_show() or task_wait().
Examples: # Transfer a single file result = transfer( source_endpoint="uuid1", source_path="/data/file.tar.gz", dest_endpoint="uuid2", dest_path="/scratch/file.tar.gz" ) task_id = result['task_id']
# Transfer a directory
transfer(
source_endpoint="uuid1",
source_path="/project/results/",
dest_endpoint="uuid2",
dest_path="/archive/results/",
recursive=True,
label="Archive project results"
)
# Sync with checksum verification
transfer(
source_endpoint="uuid1",
source_path="/data/",
dest_endpoint="uuid2",
dest_path="/backup/",
recursive=True,
sync_level="checksum",
verify_checksum=True
)Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source_endpoint | Yes | ||
| source_path | Yes | ||
| dest_endpoint | Yes | ||
| dest_path | Yes | ||
| recursive | No | ||
| sync_level | No | ||
| label | No | ||
| verify_checksum | No | ||
| preserve_timestamp | No | ||
| encrypt_data | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||