file tierjobterminate

Initiates termination of an ongoing offload or recall operation.

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 tierjobterminate 
    -name <file_name>
    [ -job <jobID> ]
REST
Request Type POST
Request URL
http[s]://<host:port>/rest/file/tierjobterminate?<parameters>

Parameters

Parameter Description
name The name (including the path) of the file being offloaded/recalled.
job The ID of the job, which was specified with the offload or recall command, to terminate. This must be specified to ensure that the correct offload or recall task is terminated. If this is not specified, the command picks a job to terminate in the following order:
  1. Job that is in “already terminating progress” status.
  2. Job that is in “running jobs with latest jobid” status.
If there are no jobs in progress, the command returns “no active transfer in progress” error.

Examples

CLI
/opt/mapr/bin/maprcli file tierjobterminate -name /c1/file5G -json
{
  "timestamp":1557734728770,
  "timeofday":"2019-05-13 01:05:28.770 GMT-0700 AM",
   "status":"OK",
   "total":1,
    "data":[
             {
              "status":10,
              "message":"File transfer being terminated.",
              "gateway":"10.10.103.79:8660",
              "jobid":"0x140dea11228a3211.0x18565bc5d5e4e4fe.0x2"
              }
             ]
}       
REST
curl -X POST 'https://host:port/rest/file/tierjobterminate?name=/c1/file5G' --user <username>:<password>
{"timestamp":1557738947905,"timeofday":"2019-05-13 02:15:47.905 GMT-0700 AM","status":"OK","total":1,"data":[{"status":10,"message":"File transfer being terminated.","gateway":"host:port","jobid":"0x140dea11228a3211.0x18565bc5d5e4e4fe.0x3"}]}