Get details of a move job

This call gets the details of an asynchronous bulk copy job. This information will be available for up to a month after the job has been completed.

Request

https://cavatica-api.sbgenomics.com/v2/async/files/move/{jobid}

Example request

GET /v2/async/files/move/70721895322947584
Host: cavatica-api.sbgenomics.com
X-SBG-Auth-Token: 3259c50e1ac5336ea8f1253259740f75
curl -X GET \
  https://cavatica-api.sbgenomics.com/v2/async/files/move/70796015691698176 \
  -H 'Content-Type: application/json' \
  -H 'X-SBG-Auth-Token: d32c2976ffc04d0eb90c6c4fb4c0a465' \

Header Fields

NameDescription
X-SBG-Auth-Token
required
Your CAVATICA authentication token.
Content-Type
required
application/json

Query parameters

KeyData typeDescription
ID
required
stringThe ID of the move job you are querying. This ID can be found within the API response for the call for moving files.
{
  "items": [
    {
      "file": "5c6d3f30e4b038563238932f",
      "parent": "",
      "project": "rfranklin/destination-project",
      "name": "my-new-file"
    },
    {
      "file": "5c6d3f30e4b038563238932b",
      "parent": "",
      "project": "rfranklin/destination-project",
      "name": ""
    },
    {
      "file": "5c6d3f30e4b0385632389331",
      "parent": "",
      "project": "rfranklin/destination-project",
      "name": ""
    }
  ]
}

Response

See a list of CAVATICA-specific response codes that may be contained in the body of the response.

Response body

KeyData typeDescription
idstringID of this move job
resultstringThe result of the move job.
typestringThe type of job which is MOVE.
statestringThe following states are available:

SUBMITTED
RESOLVING
RUNNING
FINISHED
failed_filesstringThe number of files that failed to move.
completed_filesstringThe number of files that were successfully moved.
total_filesstringThe total number of files that were processed during the job.
started_onstringThe time and date the move job started.
finished_onstringThe time and date the move job has finished.
{
    "href": "https://cavatica-api.sbgenomics.com/v2/async/files/move/70796015691698176",
    "id": "70796015691698176",
    "result": [
        {
            "resource": {
                "href": "https://cavatica-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30a",
                "id": "5c6e7e36e4b038560025d30a"
            }
        },
        {
            "resource": {
                "href": "https://cavatica-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d309",
                "id": "5c6e7e36e4b038560025d309"
            }
        },
        {
            "resource": {
                "href": "https://cavatica-api.sbgenomics.com/v2/files/5c6e7e36e4b038560025d30b",
                "id": "5c6e7e36e4b038560025d30b"
            }
        }
    ],
    "type": "MOVE",
    "state": "FINISHED",
    "failed_files": 0,
    "completed_files": 3,
    "total_files": 3,
    "started_on": "2019-02-21T10:32:21Z",
    "finished_on": "2019-02-21T10:32:22Z"
}