Transfer API
  • Transfer API Documentation
  • API Overview
  • Task Submission
  • Task Management
  • File Operations
  • Endpoints and Collections
  • Globus Connect Personal Management
  • Endpoint and Collection Search
  • Roles
  • Collection Bookmarks
  • Guest Collection Permission Management
  • Advanced Collection Management
  • Transfer Action Providers
    • Migrating Transfer Action Providers
    • Transfer Action Provider: Transfer
    • Transfer Action Provider: Delete
    • Transfer Action Provider: Manage Permission
    • Transfer Action Provider: List Directory Contents
    • Transfer Action Provider: Stat File or Directory
    • Transfer Action Provider: Make Directory
    • Transfer Action Provider: Collection Info
    • Transfer Action Provider: Create GCP Guest Collection
    • Transfer Action Provider: Create GCSv5 Guest Collection
Skip to main content
Globus Docs
  • APIs
    Auth Flows Groups Search Timers Transfer Globus Connect Server Compute Helper Pages
  • Applications
    Globus Connect Personal Globus Connect Server Premium Storage Connectors Compute Command Line Interface Python SDK JavaScript SDK
  • Guides
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus Services
  3. Transfer API Documentation
  4. Transfer Action Providers
  5. Transfer Action Provider: Transfer

Transfer Action Provider: Transfer

URL: https://transfer.actions.globus.org/transfer

Synchronous / Asynchronous: Asynchronous

The Transfer action provider uses the Globus Transfer API’s task resources to submit an asynchronous transfer of data from one Globus Collection to another. The input includes both the source and destination collection ids and file paths within the collection where the source file or folder is located and the destination folder where the transfer should be placed.

{
  "DATA": [
    {
      "source_path": "/~/campus_source/dataset1/",
      "destination_path": "/~/dmz_temp/"
    }
  ],
  "source_endpoint": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
  "destination_endpoint": "31ce9ba0-176d-45a5-add3-f37d233ba47d"
}
{
  "action_id": "1STabcdefghi",
  "completion_time": "2023-06-28T15:53:41.997573+00:00",
  "creator_id": "urn:globus:auth:identity:12341234-abcd-abcd-abcd-123412341234",
  "details": {
    "DATA_TYPE": "task",
    "bytes_checksummed": 0,
    "bytes_transferred": 0,
    "canceled_by_admin": null,
    "canceled_by_admin_message": null,
    "command": "API 0.10",
    "completion_time": null,
    "deadline": "2023-06-29T15:53:43+00:00",
    "delete_destination_extra": false,
    "destination_endpoint": "u_eyljfjd6jfg67nm6zp6gly4qpu#e09c6728-80a0-11ee-bddb-c52a29481bea",
    "destination_endpoint_display_name": "Globus Tutorial Collection 1",
    "destination_endpoint_id": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
    "directories": 0,
    "effective_bytes_per_second": 0,
    "encrypt_data": false,
    "event_list": [],
    "fail_on_quota_errors": false,
    "fatal_error": null,
    "faults": 0,
    "files": 0,
    "files_skipped": 0,
    "files_transferred": 0,
    "filter_rules": null,
    "history_deleted": false,
    "is_ok": true,
    "is_paused": false,
    "label": "For Action id 1STabcdefghi",
    "nice_status": "OK",
    "nice_status_details": null,
    "nice_status_expires_in": -1,
    "nice_status_short_description": "OK",
    "owner_id": "12341234-abcd-abcd-abcd-123412341234",
    "preserve_timestamp": false,
    "recursive_symlinks": "ignore",
    "request_time": "2023-06-28T15:53:44+00:00",
    "skip_source_errors": false,
    "source_endpoint": "u_eyljfjd6jfg67nm6zp6gly4qpu#e09c6728-80a0-11ee-bddb-c52a29481bea",
    "source_endpoint_display_name": "Globus Tutorial Collection 1",
    "source_endpoint_id": "6c54cade-bde5-45c1-bdea-f4bd71dba2cc",
    "status": "ACTIVE",
    "subtasks_canceled": 0,
    "subtasks_expired": 0,
    "subtasks_failed": 0,
    "subtasks_pending": 1,
    "subtasks_retrying": 0,
    "subtasks_skipped_errors": 0,
    "subtasks_succeeded": 0,
    "subtasks_total": 1,
    "symlinks": 0,
    "sync_level": null,
    "task_id": "12341234-abcd-abcd-abcd-123412341234",
    "type": "TRANSFER",
    "username": "u_abcd",
    "verify_checksum": false
  },
  "display_status": "ACTIVE",
  "label": null,
  "manage_by": [],
  "monitor_by": [],
  "release_after": "P30D",
  "start_time": "2023-06-28 15:53:41.997556+00:00",
  "status": "ACTIVE"
}
{
  "__COMMENT": "The transfer task id will be `$.transfer_result.details.task_id`",
  "delete": {
    "Type": "Action",
    "ActionUrl": "https://transfer.actions.globus.org/transfer",
    "Parameters": {
      "source_endpoint.$": "$.endpoint_id",
      "destination_endpoint.$": "$.endpoint_id",
      "DATA": [
        {
          "source_path.$": "$.source_path",
          "destination_path.$": "$.destination_path"
        }
      ]
    },
    "ResultPath": "$.transfer_result"
  }
}
  • Transfer API Documentation
  • API Overview
  • Task Submission
  • Task Management
  • File Operations
  • Endpoints and Collections
  • Globus Connect Personal Management
  • Endpoint and Collection Search
  • Roles
  • Collection Bookmarks
  • Guest Collection Permission Management
  • Advanced Collection Management
  • Transfer Action Providers
    • Migrating Transfer Action Providers
    • Transfer Action Provider: Transfer
    • Transfer Action Provider: Delete
    • Transfer Action Provider: Manage Permission
    • Transfer Action Provider: List Directory Contents
    • Transfer Action Provider: Stat File or Directory
    • Transfer Action Provider: Make Directory
    • Transfer Action Provider: Collection Info
    • Transfer Action Provider: Create GCP Guest Collection
    • Transfer Action Provider: Create GCSv5 Guest Collection
© 2010- The University of Chicago Legal Privacy Accessibility