file recall

Initiates recall of a file from a storage tier using a MAST Gateway.

Permissions Required

The user running the command must have (mode bit or Access Control Expression (ACE)) permissions to write to the file.

Syntax

CLI
/opt/mapr/bin/maprcli file recall 
     -name <file_name>
REST
Request Type GET
Request URL
http[s]://<host:port>/rest/file/recall?<parameters>

Parameters

Parameter Description
name The name (including the path) of the file to recall.

Example

Recall file named file1 in volume named vol1:

CLI
/opt/mapr/bin/maprcli file recall -name /vol1/test1 -json
{
  "timestamp":1516337242973,
  "timeofday":"2018-01-19 04:47:22.973 GMT+0000",
  "status":"OK",
  "total":1,
  "data":[{
       "status":12,
       "message":"File transfer request queued.",
       "gateway":"10.10.88.198:8660",
       "jobid":"0xb76f872c64fe4677.0x3673092f759a500d.0x1"
  }]
}
REST
curl -X GET 'https://abc.sj.us:8443/rest/file/recall?<parameters>' --user <username>:<password>
{"timestamp":1516337242973,"timeofday":"2018-01-19 04:47:22.973 GMT+0000","status":"OK","total":1,"data":[{"status":12,"message":"File transfer request queued.","gateway":"10.10.88.198:8660","jobid":"0xb76f872c64fe4677.0x3673092f759a500d.0x1"}]}