Current implementation of AMSC data movement API allows to transfer
datasets between globus end-points using globus access tokens. Having 
accounts on both globus end-points is currently prerequisite.

# AMSC data movement API

LBNL runs prototype implementation of AMSC data movement API server
at https://amsc-data-api.nersc.gov. There is swagger UI with RES APIs 
documenation https://amsc-data-api.nersc.gov/docs

## How to transfer data between FDP and Nersc globus end point using AMSC data movement API

First, one has to obtain account at Nersc. 

Then on the client machine / desktop:

* install python, e.g.:
  ```
  dnf install python3.13
  ```
* install `uv`
  ```
  pip install uv
  ```
* install a couple of modules
  ```
  uv pip install  typer
  uv pip install  globus_sdk
  ```
* download a handy client script that generates globus access token
  ```
  curl https://gist.githubusercontent.com/tylern4/924b19e58d75046e593e0db2d87f6c5c/raw/3e008fb6c0c9d21d429e5a779d2866c8f74e5072/generate_token.py \
     -o generate_token.py
  ```
* run the script like so:
  ```
  uv run generate_token.py login --mapped-collections <UUID1> --mapped-collections <UUID2> --domain nersc.gov
  ```
  Where UUIDs are UUIDs of globus source and collections. Specifically, using FDP and my account at Nersc:
  ```
  uv run generate_token.py login \
      --mapped-collections 73edb319-d876-4143-b5fc-5a47c61b0c02 \
      --mapped-collections 9d6d994a-6d04-11e5-ba46-22000b92c6ec \
      --domain nersc.gov
  ```
  `73edb319-d876-4143-b5fc-5a47c61b0c02` is UUID of FDP globus collection and `9d6d994a-6d04-11e5-ba46-22000b92c6ec`
  is UUID of Nersc globus collection. Invocaton of the script will result in something like:
  ```
  Please authenticate with Globus here:
  -------------------------------------
  https://auth.globus.org/v2/oauth2/authorize?client_id=57554043-6dd8-410b-8ece-cd54e9c003bb&redirect_uri=https%3A%2F%2Fauth.globus.org... 
  -------------------------------------

  Enter the resulting Authorization Code here: 
  ```
  Cut&paste the URL into your browser and perform authentication. Eventually you will be redirected to a page with the secret. Cut&paste the secret into:
  ```
  Enter the resulting Authorization Code here:
  ```
  prompt. You will get your globus access token in return. You can use environment
  variable, say GLOBUS_ACCESS_TOKEN, to store the access token.
  This globus access token can be used to initiate transfers.
  Example:
  ```
  export GLOBUS_ACCESS_TOKEN="Ag...." # (your globus access token)

  curl -L -X 'POST' \
  'https://amsc-data-api.nersc.gov/transfer/globus' \
  -H 'accept: application/json' \
  -H "Authorization: $GLOBUS_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{ 
  "source_url": "globus://73edb319-d876-4143-b5fc-5a47c61b0c02/amsc/public/treasure/aoj/", 
  "destination_url": "globus://9d6d994a-6d04-11e5-ba46-22000b92c6ec/pscratch/sd/d/dimlit/", 
  "label": "Test transfer of AOJ dataset." 
  }'
  ```
  It should return json containing `transfer_uuid`:
  ```
  [
  {
    "name": "Test transfer of AOJ dataset.",
    "source_url": "globus://73edb319-d876-4143-b5fc-5a47c61b0c02/amsc/public/treasure/aoj/",
    "destination_url": "globus://9d6d994a-6d04-11e5-ba46-22000b92c6ec/pscratch/sd/d/dimlit/",
    "transfer_uuid": "6ec65387-2322-11f1-927c-02ea150f82e1"
  }
  ]
  ```
  that can be used to query request status:
  ```
  curl  -s -L -H "Authorization: $GLOBUS_ACCESS_TOKEN" \
   -H 'Content-Type: application/json' \
   "https://amsc-data-api.nersc.gov/transfer/globus/6ec65387-2322-11f1-927c-02ea150f82e1"
  ```
  which would return something like:
  ```
  {
    "transfer_uuid": "6ec65387-2322-11f1-927c-02ea150f82e1",
    "status": "SUCCEEDED",
    "completion_time": "2026-03-18T23:33:25Z",
    "destination_url": "globus://9d6d994a-6d04-11e5-ba46-22000b92c6ecNone",
    "reason": "",
    "bytes_transferred": 207292621489,
    "effective_bytes_per_second": 1150306465
  }
  ```