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 -k -X GET 'https://abc.sj.us:8443/rest/file/recall?<parameters>' --user mapr:mapr
{"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"}]}