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"}]}